4D v14.3

Get localized document path

Página Inicial

 
4D v14.3
Get localized document path

Get localized document path 


 

Get localized document path ( rotaRelativa ) -> Resultado 
Parâmetro Tipo   Descrição
rotaRelativa  Texto in Rota relativa do documento para qual quer obter a versão localizada
Resultado  Texto in Rota de acesso absoluta ao documento localizado

O comando Get localized document path retorna a rota completa (absoluta) de um documento designado por rotaRelativa e localizado na pasta xxx.lproj.

Este comando deve ser usado dentro de uma arquitetura de aplicação multi-linguagem baseada na presença de uma pasta Resources e das subpastas xxx.lproj (xxx representa um idioma). Com esta arquitetura, 4D é automaticamente compatível arquivos localizados de tipo .xliff assim como as imagens, mas é possível que deva usar o mesmo mecanismo para outros tipos de arquivos.

Passe em rotaRelativa a rota de acesso relativa do documento a buscar. A rota especificada deve ser relativa ao primeiro nível da pasta "xxx.lproj"  da banco de dados. O comando devolverá uma rota de acesso completa utilizando a pasta "xxx.lproj" correspondente ao idioma atual do banco de dados.

Nota: o idioma atual é definido automáticamente por 4D em função do conteúdo da pasta Resources (vea o comando Get current database localization ), ou através do comando SET DATABASE LOCALIZATION.

Pode expressar o conteúdo do parâmetro rotaRelativa utilizando uma sintaxe POSIX ou sistema. Por exemplo:
  • xsl/log.xsl (sintaxe POSIX: utilizável em Mac OS ou Windows)
  • xsllog.xsl (Windows unicamente)
  • xsl:log.xsl (Mac OS unicamente)

A rota de acesso absoluta retornada pelo comando é sempre expressa na sintaxe do sistema.

4D Server: em modo remoto, o comando retorna a rota da pasta Resources na máquina cliente se o comando for chamado desde um processo cliente.

4D busca o arquivo respeitando uma sequência que permite tratar todos os casos de aplicações em vários idiomas. A cada passo, 4D comprova a presença de rotaRelativa na pasta correspondente ao idioma e retorna a rota completa quando tem êxito. Se rotaRelativa não for encontrada ou se a pasta não existir, 4D passa ao seguinte passo. Aqui estão as pastas para cada uma das diferentes etapas de pesquisa:

Linguagem atual (por exemplo: fr-ca)
   
Linguagem atual sem região (por exemplo.: fr)
        Linguagem carregada automaticamente no startup (
por exemplo.: es-ga)
           
Linguagem carregada automaticamente no startup sem região (por exemplo.: es)
                Primeira pasta .lproj encontrada (
por exemplo.: en.lproj)
                    Primeiro nível de pasta Resources

Se rotaRelativa não for encontrada em nenhuma destas localizações, o comando retorna uma string vazia.

Exemplo  

Para transformar um arquivo XML em HTML, queremos utilizar um arquivo de transformação "log.xsl". Este arquivo difere dependendo do idioma atual. Você deseja conhecer a rota do arquivo "log.xsl" a utilizar.
Estes são os conteúdos da pasta Resources:

Para utilizar um arquivo .xsl adaptado a linguagem atual, apenas deve passar:

 $myxsl:=Get localized document path("xsl/log.xsl")

Se a linguagem atuarl for, por exemplo, francês canadense (fr-ca), o comando devolve:

  • em Windows: C:users……… resources _ca.lprojxsllog.xsl
  • em Mac OS: "HardDisk:users:…:…:…:resources:fr_ca.lproj:xsl:log.xsl"

 
PROPRIEDADES 

Produto: 4D
Tema: Documentos de Sistema
Número 1105

 
HISTÓRIA 

Criado por: 4D v12

 
VER TAMBÉM 

Get current database localization

 
PALAVRAS CHAVES 

xliff, localisation, traduction, Resources folder

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)