Personalizar etiquetas para admitir varios idiomas
Publicado: enero de 2017
Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Cuando se crean personalizaciones en Microsoft Dynamics 365, se puede admitir varios idiomas con etiquetas.
En este tema
Usar etiquetas
Mensajes para usar con las etiquetas
Personalizar las etiquetas en el idioma base
Traducir texto de entidad y atributo personalizado
Administrar idiomas para la organización
Usar etiquetas
Las etiquetas son cadenas localizadas que se muestran a los usuarios en las aplicaciones cliente. Se implementan mediante la clase Label, que admite paquetes de idiomas. Las cadenas que se muestran a los usuarios, como nombres de entidades u opciones de un conjunto de opciones, se pueden almacenar en varios idiomas. Los usuarios pueden seleccionar el idioma que desean mostrar en los formularios y vistas en Microsoft Dynamics 365.
En la siguiente tabla se enumeran todos los metadatos que usa la clase Label.
Propiedad de metadatos |
Descripción |
|---|---|
Descripción de un atributo. |
|
Muestra el nombre de un atributo. |
|
Descripción de una entidad. |
|
Nombre plural de una entidad. |
|
Nombre de una entidad. |
|
Etiqueta usada para una entidad en una relación de entidad. |
|
Etiqueta usada para una opción en una lista desplegable, estado o atributo de estado. |
Las clases Label pueden almacenar una cadena para cada idioma instalado. Esta matriz es la propiedad LocalizedLabels. Siempre debe haber una etiqueta almacenada para el idioma base. Las etiquetas para otros idiomas pueden ser null. Si el usuario desea mostrar la interfaz de usuario en un idioma y la etiqueta no tiene una cadena para ese idioma, se usará la etiqueta del idioma base.
Puede usar la propiedad UserLocalizedLabel para recuperar la etiqueta del idioma seleccionado por el usuario.
Mensajes para usar con las etiquetas
En la siguiente tabla se enumeran los mensajes que se pueden usar para trabajar con etiquetas localizadas que admiten varios idiomas. Al importar traducciones se puede generar un informe basado en el trabajo de importación de la misma forma que se genera cuando se importa una solución. Para obtener más información, vea Instalar o actualizar una solución.
Mensaje |
Descripción |
|---|---|
Exporta todas las traducciones para una solución específica a un archivo comprimido. |
|
Importa todas las traducciones de un archivo comprimido. |
|
Recupera los resultados de ImportJob como un documento XML diseñado para ser abierto mediante Microsoft Office Excel. |
|
Recupera las etiquetas localizadas para el atributo especificado. |
|
Establece las etiquetas localizadas para el atributo especificado. |
Personalizar las etiquetas en el idioma base
Las herramientas de personalización proporcionan varias formas de editar nombres de la entidad y esas propiedades se pueden personalizar mediante programación. También se pueden editar los mensajes de la entidad. Pero no está expuesto cada mensaje. Otra forma de encontrar y de personalizar el texto usado en la aplicación es exportar las traducciones, modificar la configuración del idioma base e importar las traducciones de nuevo. Aunque éste no es el propósito de esta característica, es una forma compatible identificar y personalizar el texto usado en la aplicación. Para obtener más información, vea Modificar los mensajes de una entidad.
Traducir texto de entidad y atributo personalizado
Debido a que solo se pueden realizar personalizaciones en la aplicación utilizando el idioma base, cuando se desea proporcionar etiquetas localizadas para estas personalizaciones se debe exportar el texto de las etiquetas de modo que puedan ser localizas para otros idiomas habilitados para la organización.
Exportar el texto personalizado para traducción
Puede exportar las traducciones en la aplicación web o con el mensaje ExportTranslationRequest.
El texto exportado se guarda como un archivo comprimido que contiene CrmTranslations.xml que se abre con Microsoft Office Excel. Puede enviar este archivo a un lingüista experto, a una agencia de traducción o a una empresa de localización.
Para obtener más información, consulte Esquemas de referencia XML de Office 2003.
Importar el texto traducido
Después de exportar el texto personalizado de las entidades o atributos y traducirlo, puede importar las cadenas de texto traducidas en la aplicación web con el mensaje ImportTranslationRequest. El archivo que se importa debe ser un archivo comprimido que contiene los archivos CrmTranslations.xml y [Content_Types].xml tal y como se exportaron.
Una vez importadas las traducciones, el texto personalizado aparece para los usuarios que trabajan en los idiomas a los que tradujo el texto.
Nota
Microsoft Dynamics 365 no puede importar texto traducido que tenga más de 500 caracteres. Si alguno de los elementos del archivo de traducción tiene más de 500 caracteres, se producirá un error en el proceso de importación. Si esto sucede, revise la línea que provocó el error, reduzca el número de caracteres e intente de nuevo la importación.
Puesto que solo se permite personalizar texto en el idioma base, puede trabajar en Microsoft Dynamics 365 con el idioma base establecido como preferencia de idioma. Para comprobar que aparece el texto traducido, debe cambiar su preferencia de idioma para la interfaz de usuario de Microsoft Dynamics 365. Para realizar tareas de personalización adicionales, debe volver a cambiar al idioma base.
Administrar idiomas para la organización
Microsoft Dynamics 365 (en línea y local) permite instalar el paquete de varios idiomas en un servidor y permite al usuario seleccionar un paquete de idioma. Para obtener más información sobre cómo instalar paquetes de idioma, consulte Manual de instalación, TechNet: Instalación y habilitación de un paquete de idioma. Esta sección contiene información acerca de los mensajes que se usan para administrar los idiomas ya instalados para la organización.
En la siguiente tabla se enumeran los mensajes que se pueden usar para trabajar con los paquetes de idiomas. Use estos mensajes con el método Execute.
Mensaje |
Descripción |
|---|---|
Contiene los datos necesarios para desaprovisionar un idioma |
|
Contiene los datos necesarios para aprovisionar un idioma nuevo. |
|
Recupera la lista de los idiomas disponibles. |
|
Recupera la lista de los paquetes de idiomas instalados en el servidor que se han deshabilitado. |
|
Contiene los datos necesarios para recupera la lista de los paquetes de idiomas instalados en el servidor. |
|
Contiene los datos necesarios para recupera la versión de un paquete de idioma instalado. |
|
Recupera la lista de los paquetes de idiomas instalados en el servidor que están habilitados. |
|
Recupera la versión de los paquetes de idiomas instalados en el servidor. |
Ver también
Usar el servicio de la organización con metadatos de Dynamics 365
Personalizar aplicaciones de Microsoft Dynamics 365
Modificar los mensajes de una entidad
Microsoft Dynamics 365
© 2017 Microsoft. Todos los derechos reservados. Copyright