Get localized document path

4D v20 R7


Get localized document path ( rutaRelativa ) -> Resultado

Parámetro	Tipo	Descripción
rutaRelativa	Texto	Ruta de acceso relativa del documento del cual obtener la versión localizada
Resultado	Texto	Ruta de acceso absoluta del documento localizado

Descripción

El comando Get localized document path devuelve la ruta completa (absoluta) de un documento designado por rutaRelativa y ubicado en la carpeta xxx.lproj.

Este comando debe usarse dentro de una arquitectura de aplicación multi-lenguaje basada en la presencia de una carpeta Resources y de las subcarpetas xxx.lproj (xxx representa un idioma). Con esta arquitectura, 4D soporta automáticamente archivos localizados de tipo XLIFF así como las imágenes, pero es posible que deba usar el mismo mecanismo para otros tipos de archivos.

Pase en rutaRelativa la ruta de acceso relativa del documento a buscar. La ruta especificada debe ser relativa al primer nivel de la carpeta "xxx.lproj" de la base de datos. El comando devolverá una ruta de acceso completa utilizando la carpeta "xxx.lproj" correspondiente al idioma actual de la base de datos.

Nota: el idioma actual es definido automáticamente por 4D en función del contenido de la carpeta Resources (vea el comando Get database localization), o vía el comando SET DATABASE LOCALIZATION.

Puede expresar el contenido del parámetro rutaRelativa utilizando una sintaxis POSIX o sistema. Por ejemplo:

xsl/log.xsl (sintaxis POSIX: utilizable bajo Mac OS o Windows)
xsllog.xsl (Windows únicamente)
xsl:log.xsl (Mac OS únicamente)

La ruta de acceso absoluta devuelta por el comando siempre se expresa en la sintaxis del sistema.

4D Server: en modo remoto, el comando devuelve la ruta de la carpeta Resources en la máquina cliente si el comando se llama desde un proceso cliente.

4D busca el archivo respetando una secuencia que permite tratar todos los casos de aplicaciones en varios idiomas. En cada paso, 4D comprueba la presencia de rutaRelativa en la carpeta correspondiente al idioma y devuelve la ruta completa cuando tiene éxito. Si rutaRelativa no se encuentra o si la carpeta no existe, 4D pasa al siguiente paso. Aquí están las carpetas para cada una de las diferentes etapas de búsqueda:

Lenguaje actual (por ejemplo: fr-ca)
    Lenguaje actual sin región (por ejemplo: fr)
        Lenguaje cargado por defecto al inicio (por ejemplo: en-ga)
            Lenguaje cargado por defecto al inicio sin región (es por ejemplo: es)
                Primera carpeta .lproj encontrada (por ejemplo: en.lproj)
                    Primer nivel de la carpeta Resources

Si rutaRelativa no se encuentra en ninguna de estas ubicaciones, el comando devuelve una cadena vacía.

Ejemplo

Para transformar un archivo XML en HTML, queremos utilizar un archivo de transformación "log.xsl". Este archivo difiere dependiendo del idioma actual. Usted quiere conocer la ruta del archivo "log.xsl" a utilizar.
Estos son los contenidos de la carpeta Resources:

Para utilizar un archivo .xsl adaptado al lenguaje actual, sólo debe pasar:

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

Si el lenguaje actual es, por ejemplo, francés canadiense (fr-ca), el comando devuelve:

bajo Windows: C:users……… resources_ca.lprojxsllog.xsl
bajo Mac OS: "HardDisk:users:…:…:…:resources:fr_ca.lproj:xsl:log.xsl"

Ver también

Get database localization