Crear y usar archivos de traducción

Completado

Para agregar un nuevo idioma a la extensión que ha creado, primero debe habilitar la generación de archivos de formato de archivo de intercambio de localización XML (XLIFF).

Los archivos XLIFF son archivos basados en XML que puede usar para definir la traducción. Deberá crear un archivo XLIFF para cada idioma que desee admitir. Existen diferentes propiedades de ML en una tabla o campo de tabla, como CaptionML y TooltipML. Sin embargo, estas propiedades de ML están en desuso; por lo tanto, si desea refactorizar la extensión, le recomendamos que use la propiedad correspondiente, como Caption o Tooltip, que se está recopilando en el archivo XLIFF. La extensión de archivo XLIFF es .xlf.

Para habilitar la generación de archivos XLIFF, debe habilitar una configuración en el archivo app.json. Se trata de la configuración Características, que es un conjunto de características posibles. La característica que necesita activar es la característica TranslationFile. Al ejecutar el comando de compilación (Ctrl + Mayús + B) en Visual Studio Code, se generará una carpeta Traducciones y los archivos .xlf se crearán en función de las propiedades de etiquetas, subtítulo e información sobre herramientas.

Ejemplo de una característica TranslationFile en app.json.

Visual Studio Code generará un archivo .g.xlf, que se vuelve a crear con cada comando de compilación. Asegúrese de cambiar el nombre de este archivo antes de comenzar a traducir; de lo contrario, el archivo se sobrescribirá. Solo puede existir un archivo .xlf para cada idioma. La nomenclatura forzada no se usa en el archivo, pero recomendamos asignarle un nombre mediante el siguiente formato: extensionname.language.xlf. Por ejemplo, si la extensión se denomina Car Management, en francés, asigne al archivo el nombre de Car_Management.fr.xlf.

Junto con la característica TranslationFile, también puede activar la característica GenerateCaptions. Luego, se generarán automáticamente subtítulos basados en los nombres de objetos de tablas, páginas, campos, etc. Si proporcionó una propiedad Caption, se usará esta propiedad.

Crear archivos de idioma en Visual Studio Code con AL

Vea el siguiente vídeo para descubrir cómo crear archivos de idioma en Visual Studio Code para las extensiones.