Diseñar informes multilingües en informes electrónicos
Visión general
En calidad de usuario empresarial, puede usar usan el marco Informes electrónicos (ER) para configurar formatos para documentos de salida que se deben generar con arreglo a los requisitos legales de diversos países o regiones. Cuando estos requisitos exigen que los documentos salientes se generen en diferentes idiomas para diferentes países o regiones, puede configurar un único formato de ER que contenga recursos dependientes del idioma. De esa manera, puede reutilizar el formato para generar documentos salientes para varios países o regiones. También es posible que desee utilizar un único formato de ER para generar un documento saliente en diferentes idiomas para los clientes, proveedores, subsidiarias o cualquier otra parte correspondiente.
Puede configurar modelos de datos de ER y asignaciones de modelos como los orígenes de datos de los formatos de ER configurados para definir el flujo de datos que especifica qué datos de la aplicación se colocan en los documentos generados. Como proveedor de configuraciones de ER, usted puede publicar modelos de datos configurados, asignaciones de modelos y formatos como componentes de una solución ER para generar documentos salientes específicos. También puede permitir que los clientes carguen la solución ER publicada para que pueda usarse y personalizarse. Si espera que los clientes hablen otros idiomas, puede configurar los componentes de ER para que contengan recursos que dependen del idioma. De esa manera, el contenido de un componente ER editable se puede presentar en el lenguaje preferido por el usuario del cliente en el momento del diseño.
Puede configurar recursos dependientes del idioma como etiquetas ER. Luego puede usar esas etiquetas para configurar los componentes de ER para los siguientes propósitos:
En tiempo de diseño:
- Presente el contenido de los componentes de ER configurados en el idioma preferido por el usuario.
En tiempo de ejecución:
- Genere contenido dependiente del idioma para documentos salientes.
- Proporcione mensajes de advertencia y error en el idioma preferido por el usuario.
- Solicite los campos obligatorios en el idioma preferido por el usuario.
Las etiquetas de ER se pueden configurar en cada configuración de ER que contiene diferentes componentes. Las etiquetas se pueden mantener independientemente de la lógica configurada de los modelos de datos ER, las asignaciones de modelos ER y los componentes de formato ER.
Cada etiqueta ER se identifica mediante un identificador que es único en el alcance de la configuración ER que contiene esa etiqueta. Cada etiqueta puede contener texto de etiqueta para cada idioma admitido en la instancia actual de Microsoft Microsoft Dynamics 365 Finance. Estos idiomas admitidos incluyen los idiomas de las personalizaciones implementadas.
Entrada
Cuando diseña un modelo de datos ER, una asignación de modelo ER o un formato ER, la opción Traducir se muestra cada vez que selecciona un campo que puede contener el contexto traducible. Cuando selecciona esta opción, puede vincular el campo seleccionado a una etiqueta ER en el panelTraducción de textos. Puede seleccionar una etiqueta ER existente o puede agregar una nueva etiqueta ER si aún no está disponible. Cuando selecciona o agrega una etiqueta ER, puede agregar texto relacionado para cada idioma que sea compatible con la instancia actual de Finanzas.
La siguiente ilustración muestra cómo se realiza esta traducción en un modelo de datos ER editable. En este ejemplo, el atributo Descripción del campo Pedido de compra para el Modelo de factura editable se traduce al alemán de Austria (DE-AT) y al japonés (JA).
Solo se puede traducir el texto de las etiquetas que residen en un componente ER editable. Por ejemplo, si selecciona Traducir para el atributo de etiqueta de un origen de datos de asignación de modelo ER, y luego selecciona una etiqueta ER que reside en el modelo de datos ER primario, verá el contenido de la etiqueta, pero no podrá cambiarlo. En estos casos, el campo Texto traducido no está disponible, como se muestra en la siguiente ilustración.
Nota
No puede usar los diseñadores para eliminar la etiqueta que se ha especificado en un componente ER editable.
Ámbito
Se puede hacer referencia a las etiquetas ER en varios atributos traducibles de componentes ER.
Componente de modelo de datos
Cuando configura un modelo de datos ER, puede agregarle etiquetas ER. Los valores de los atributos Etiqueta y Descripción del elemento del modelo, el campo de cada modelo y cada enumeración del modelo se pueden vincular a una etiqueta ER que se agrega al modelo de datos ER.
Cuando un modelo de datos ER se configura de esta manera, su contenido se presentará a los usuarios del diseñador del modelo de datos ER en el idioma preferido de cada usuario. Por lo tanto, el mantenimiento del modelo se simplifica. Las siguientes ilustraciones muestran cómo funciona esta funcionalidad para los usuarios que tienen DE-AT y JA establecidos como su idioma preferido.
Componente de asignación de modelos
Dado que la asignación del modelo ER se basa en un modelo de datos ER, las etiquetas de los elementos del modelo de datos a los que se hace referencia aparecen en el idioma preferido del usuario en el diseñador de asignación del modelo. La siguiente ilustración muestra cómo el significado del campo Pedido de compra se explica en la asignación del modelo editable utilizando la etiqueta del atributo Descripción que se ha agregado al modelo de datos configurado. Observe que esta etiqueta se presenta en el idioma preferido del usuario (DE-AT en este ejemplo).
Cuando el atributo Etiqueta del origen de datos Parámetro de entrada del usuario se configura como vinculado a una etiqueta ER, el campo de parámetro que corresponde a este origen de datos se presenta en el cuadro de diálogo del usuario en tiempo de ejecución a los usuarios en su idioma preferido.
Componente de formato
Cuando configura un formato ER, puede agregarle etiquetas ER. Los atributos Etiqueta y Texto de ayuda de cada origen de datos configurado se pueden vincular a una etiqueta ER que se agrega al formato ER. Los atributos Etiqueta y Descripción de cada valor de enumeración de formato también se pueden vincular a una etiqueta ER que sea accesible desde el formato ER editable.
Nota
También puede vincular estos atributos a una etiqueta ER del modelo de datos ER primario que reutiliza las etiquetas del modelo en cada formato ER configurado para este modelo de datos ER.
Cuando un formato ER se configura de esta manera, el contenido del formato se presentará a los usuarios del diseñador de la operación ER en el idioma preferido de cada usuario. Por lo tanto, el mantenimiento del formato y el análisis de la lógica configurada se simplifican.
Dado que un formato ER se basa en un modelo de datos ER, las etiquetas de los elementos del modelo de datos a los que se hace referencia aparecen en el diseñador de formato ER en el idioma preferido del usuario.
Cuando el atributo Etiqueta del origen de datos Parámetro de entrada del usuario está vinculado a una etiqueta ER, el campo que corresponde al parámetro en el cuadro de diálogo del usuario en tiempo de ejecución se presenta al usuario como una solicitud. Las siguientes ilustraciones muestran cómo puede vincular el atributo Etiqueta del origen de datos Parámetro de entrada del usuario en tiempo de diseño a una etiqueta ER, de modo que se solicite a los usuarios el parámetro en diferentes idiomas preferidos del usuario (se muestran para inglés de Estados Unidos (EN-US) e idiomas DE-AT) en tiempo de ejecución.
Expresiones
Para usar una etiqueta en una expresión ER, debe usar la sintaxis @"GER_LABEL:X", donde el prefijo @ indica que el operando se refiere a una etiqueta, GER_LABEL indica que una etiqueta ER está presente, y X es el identificador de la etiqueta ER.
Para referirse a la etiqueta de un sistema (aplicación), use la sintaxis @"X", donde el prefijo @ indica que el operando se refiere a una etiqueta, y X es el identificador de la etiqueta del sistema.
Asignación de modelos
Se puede configurar una expresión de una asignación de modelos ER mediante el uso de una etiqueta. Cuando se llama a esta asignación mediante un formato ER que se ejecuta para generar un documento saliente, el contexto de la ejecución incluye un código de idioma. Una etiqueta de expresión configurada se completará con el texto de la etiqueta que se ha configurado para el idioma de ese contexto.
Si una etiqueta referenciada no tiene traducción para el idioma del contexto de ejecución del formato que llama a la asignación del modelo, se utiliza el texto de la etiqueta en el idioma EN-US.
Formato
Se puede configurar una expresión ER de un formato ER mediante el uso de etiquetas. Cuando ejecuta este formato para generar un documento saliente, el contexto de la ejecución incluye un código de idioma. Una etiqueta de expresión configurada se completará con el texto de la etiqueta que se ha configurado para el idioma de ese contexto.
Puede configurar el componente ARCHIVO de un formato ER para generar el informe en el idioma preferido del usuario.
Si configura un formato ER de esta manera, el informe se genera utilizando el texto correspondiente de las etiquetas ER. Las siguientes ilustraciones muestran ejemplos de informes para los idiomas de usuario EN-US y DE-AT.
Si una etiqueta referenciada no tiene traducción para el idioma del contexto de ejecución del formato, se utiliza el texto de la etiqueta en el idioma EN-US en su lugar.
Sugerencia
Puede usar FOLDER y los diferentes tipos de componentes de FILE en el formato de informes electrónicos editable para especificar cómo se genera un archivo saliente. Para poner nombre a un archivo generado, configure la expresión de ER para el parámetro Nombre del archivo del componente. También puede usar etiquetas en la expresión configurada. Como el parámetro Nombre del archivo no depende del idioma de forma predeterminada, el texto de todas las etiquetas a las que se refiera en esta expresión queda expuesto en el idioma predeterminado EN-US en el tiempo de ejecución. Sin embargo, en la versión 10.0.28 y posterior, puede habilitar la característica Aplicar el parámetro "Preferencia de idioma" a la expresión "Nombre del archivo". La expresión Nombre del archivo usa el parámetro Preferencia de idioma cuando se calcula.
Idioma
ER admite diferentes formas de especificar un idioma para un informe generado. En el campo Preferencias de idioma en la pestaña Formato, puede seleccionar los siguientes valores:
Preferencia de la empresa: genere un informe en un idioma especificado por la empresa.
Preferencia de usuario: genere un informe en el idioma preferido del usuario.
Definido explícitamente: genere un informe en un idioma que se especifica en tiempo de diseño.
Definido en tiempo de ejecución: genere un informe en un idioma que se especifica en tiempo de ejecución. Si selecciona este valor, en el campo Idioma, configure una expresión ER que devuelva el código de idioma para el idioma, como el idioma del cliente correspondiente.
Formato específico de cultura
ER admite diferentes formas de especificar la cultura para un informe generado. Por lo tanto, se puede utilizar el formato específico de la cultura correcta para la fecha, la hora y los valores numéricos. Cuando diseña un formato ER, en la pestaña Formato, en el campo Preferencias culturales, puede seleccionar uno de los siguientes valores para cada componente de formato del tipo Común\Archivo, Excel\Archivo, PDF\Archivo o PDF\Fusión:
Preferencia de usuario: formatee los valores de acuerdo con la cultura preferida del usuario. Esa cultura se define en el campo Formato de fecha, hora y número de la pestaña Preferencias de la página Opciones de usuario.
Definido explícitamente: formatee los valores de acuerdo con la cultura que se especifica en el momento del diseño.
Definido en tiempo de ejecución: formatee los valores de acuerdo con la cultura que se especifica en el tiempo de ejecución. Si selecciona este valor, en la pestaña Asignación, en el campo Formato de fecha, hora y número, configure una expresión de ER que devuelva el código de cultura para la cultura, como la cultura del cliente correspondiente.
Nota
Un componente de ER para el que define una cultura específica podría contener componentes de ER secundarios que se configuraron para completar un valor de texto. De forma predeterminada, la cultura del componente principal se utiliza para formatear los valores de esos componentes. Puede utilizar las siguientes funciones de ER integradas para configurar enlaces para esos componentes y aplicar una cultura alternativa para el formato de valor:
En la versión 10.0.20 y posteriores, la configuración regional de los componentes de formato de los tipos Común\Archivo y Excel\Archivo se utiliza para formatear valores durante la Conversión de PDF de un documento generado.
Traducción
Puede agregar las etiquetas ER necesarias para un componente ER editable. Cuando se agrega una etiqueta ER, se puede traducir de dos maneras: manual y automáticamente.
Traducción manual
Cuando agrega una etiqueta ER en el panelTraducción de textos, puede traducirla manualmente a todos los idiomas admitidos en la instancia actual de Finance. Puede seleccionar el idioma preferido en el campo Idioma en la sección Idioma del sistema o Idioma del usuario, escriba el texto apropiado en el campo Texto traducido correspondiente y luego seleccione Traducir. Este proceso debe repetirse para cada idioma requerido y cada etiqueta que agregue.
Traducción automática
La configuración de un componente ER se realiza en la versión borrador de la configuración ER en la que reside el componente ER editable.
Como se describió anteriormente en este artículo, puede agregar las etiquetas ER necesarias a un componente ER editable. De esta forma, puede especificar el texto de las etiquetas ER en el idioma EN-US. Luego puede exportar las etiquetas del componente ER utilizando la función ER incorporada. Seleccione la versión borrador de una configuración de ER que contenga el componente de ER editable y luego seleccione Intercambiar > Exportar etiquetas.
Puede exportar todas las etiquetas o las etiquetas para un solo idioma que especifique al comienzo de la exportación. Las etiquetas se exportan como un archivo zip que contiene archivos XML. Cada archivo XML contiene etiquetas para un solo idioma.
Este formato se utiliza para la traducción automática de etiquetas por servicios de traducción externos como Dynamics 365 Translation Service. Cuando reciba las etiquetas traducidas, puede volver a importarlas en la versión borrador de una configuración ER que contenga los componentes de ER que poseen esas etiquetas. Seleccione la versión borrador de una configuración de ER que contenga el componente de ER editable y luego seleccione Intercambiar > Cargar etiquetas.
Las etiquetas traducidas se importarán a la configuración de ER seleccionada. Las etiquetas traducidas que existen en esta configuración de ER se reemplazan. Si falta alguna etiqueta traducida en la configuración de ER, se adjunta.
Ciclo de vida
Las etiquetas de un componente ER que se pueden editar se guardan, junto con otro contenido para el componente, en la versión adecuada de una configuración ER.
Se puede hacer referencia a las etiquetas de un componente ER base en una versión derivada del componente ER que cree para introducir sus modificaciones.
Sugerencia
Cuando diseña una solución de ER, puede derivar su propio componente de ER modelo de datos del que se proporciona. En este modelo de datos derivado, puede introducir sus propias etiquetas de ER y usarlas en todos los formatos de ER que usarán el modelo de datos como origen de datos. A continuación, puede derivar su propio componente de ER formato del que se proporciona, seleccionando su modelo de datos de ER derivado en lugar del proporcionado. En la versión 10.0.28 y posteriores, puede habilitar la característica Acceso mejorado a etiquetas del modelo de datos de ER ascendentepara acceder a etiquetas de un modelo de datos ER ascendente en componentes de formato ER derivados, incluso si el modelo de datos de ER seleccionado para el componente ER derivado difiere del que se usó en el componente de ER base.
Cuando se usa el mismo nombre de etiqueta en su componente derivado y sus componentes ascendentes, su traducción de esa etiqueta se usa como la más relevante.
El control de versiones de ER controla la asignación de etiquetas a cualquier atributo en un componente de ER. Los cambios en la asignación de etiquetas se registran en la lista de cambios (delta) de un componente ER editable que se ha creado como una versión derivada del componente ER proporcionado. Estos cambios se validarán cuando una versión derivada se cambie a una nueva versión base.
Funciones
La función LISTOFFIELDS de ER incorporada puede acceder a las etiquetas ER que se han configurado para algunos elementos de los componentes ER.
Como se describió anteriormente en este artículo, los atributos Etiqueta y Descripción de cada valor de enumeración de ER de modelo o formato se pueden vincular a una etiqueta ER que sea accesible en el componente ER apropiado. Puede configurar una expresión ER donde llame a la función LISTOFFIELDS utilizando la enumeración ER como argumento. Esta expresión devuelve una lista que contiene un registro para cada valor de una enumeración ER que se ha definido como un argumento de esta función. Cada registro contiene el valor de una etiqueta ER que está vinculada a un valor de enumeración ER:
- El valor de una etiqueta ER que está vinculada a los atributos Etiqueta se almacena en el campo Etiqueta del registro devuelto.
- El valor de una etiqueta ER que está vinculada a los atributos Descripción se almacena en el campo Descripción del registro devuelto.
Rendimiento
Cuando configura un componente de formato ER para generar un informe en su preferencia de idioma, o para importar un documento entrante donde el contenido se analiza en su idioma preferido, le recomendamos que habilite la función Almacene en caché el idioma preferido del usuario actual para las ejecuciones de ER en el área de trabajo Gestión de funciones. Esta función ayuda a mejorar el rendimiento, especialmente para los componentes de formato ER que contienen múltiples referencias a etiquetas en fórmulas y enlaces ER y muchas reglas de validación para generar mensajes de usuario en su idioma preferido.
Cuando cambia el estado de una versión de configuración de ER de Borrador a Terminado, si la versión de configuración contiene etiquetas ER, esas etiquetas se almacenan en la base de datos de la aplicación. El esquema de almacenamiento depende del estado de la característica Acelerar el almacenamiento de etiquetas ER:
- Si la función no está habilitada, todas las etiquetas se almacenan en el campo LABELXML de la tabla ERSOLUTIONVERSIONTABLE como un único fragmento de código XML.
- Si la característica está habilitada, se crea un registro separado para cada idioma en la tabla ERSOLUTIONVERSIONLABELSTABLE. El campo CONTENIDO de esta tabla almacena etiquetas por idioma como un fragmento XML comprimido.
Le recomendamos que habilite la característica Acelerar el almacenamiento de etiquetas ER en el área de trabajo Gestión de características. Esta función ayuda a mejorar la utilización del ancho de banda de la red y el rendimiento general del sistema porque, en la mayoría de los casos, se utilizan etiquetas de ER de un solo idioma cuando se trabaja con una configuración de ER única.
Para aplicar el esquema de almacenamiento seleccionado para mantener las etiquetas de todas las configuraciones de ER en la instancia de Finance actual, complete los siguientes pasos.
- Ir Administración de la organización>Periódico>Aplicar el esquema de almacenamiento de etiquetas seleccionadas para todas las configuraciones de ER.
- Seleccione Aceptar.