Personalizar etiquetas para admitir varios idiomas

Artículo
05/09/2023

Cuando se crean personalizaciones en Microsoft Dataverse, se puede admitir varios idiomas con etiquetas.

Usar etiquetas

Microsoft.Xrm.Sdk.dll	API web
Clase de Label	Label ComplexType
Clase de LocalizedLabel	LocalizedLabel ComplexType

Las etiquetas son cadenas localizadas que se muestran a los usuarios en las aplicaciones cliente. Se implementan mediante Label (clase Label ComplexType o Label), que admite paquetes de idiomas. Las cadenas que se muestran a los usuarios, como nombres para mostrar u opciones, se pueden almacenar en varios idiomas. Los usuarios pueden seleccionar el idioma que desean mostrar en los formularios y vistas en Dataverse.

En la siguiente tabla se enumeran todos las definiciones de tabla que usan Label.

Propiedad Definiciones de tabla	Descripción
AttributeMetadata.Description	Descripción de una columna.
AttributeMetadata.DisplayName	Nombre para mostrar de una columna.
EntityMetadata.Description	Descripción de una tabla.
EntityMetadata.DisplayCollectionName	Nombre para mostrar en plural de una tabla.
EntityMetadata.DisplayName	Nombre para mostrar de una tabla.
AssociatedMenuConfiguration.Label	Etiqueta utilizada para una tabla en una relación de tabla.
OptionMetadata.Label	Etiqueta utilizada para un valor en una columna de opción o estado.

Label puede 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 más información, ver Importar una solución no administrada.

Publicación	Operación de API web	Ensamblado del SDK
`ExportTranslation` Exporta todas las traducciones para una solución específica a un archivo comprimido.	ExportTranslation Action	ExportTranslationRequest
`ImportTranslation` Importa todas las traducciones de un archivo comprimido.	ImportTranslation Action	ImportTranslationRequest
`RetrieveFormattedImportJobResults` Recupera los resultados de ImportJob como un documento XML diseñado para ser abierto mediante Office Excel.	RetrieveFormattedImportJobResults Function	RetrieveFormattedImportJobResultsRequest
`RetrieveLocLabels` Recupera las etiquetas localizadas para la columna especificado.	RetrieveLocLabels Function	RetrieveLocLabelsRequest
`SetLocLabels` Establece las etiquetas localizadas para la columna especificada.	SetLocLabels Action	SetLocLabelsRequest

Personalizar las etiquetas en el idioma base

Las herramientas de personalización proporcionan formas de editar nombres para mostrar y esas propiedades se pueden personalizar mediante programación. También se pueden editar los mensajes. 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, consulte Modificar mensajes de una tabla.

Traducir texto de tabla y de columna 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 ExportTranslation (clase ExportTranslation Action o ExportTranslationRequest).

El texto exportado se guarda como archivo comprimido que contiene un CrmTranslations.xml y que puede abrir con Office Excel. Puede enviar este archivo a un lingüista experto, a una agencia de traducción o a una empresa de localización.

Importar el texto traducido

Después de exportar el texto personalizado de la tabla o columna y de traducirlo, puede importar las cadenas de texto traducidas en la aplicación web con el mensaje ImportTranslation (clase ImportTranslation Action o ImportTranslationRequest). El archivo que se importa debe ser un archivo comprimido que contengan los archivos CrmTranslations.xml y [Content_Types].xml tal como se han exportado.

Una vez importadas las traducciones, el texto personalizado aparece para los usuarios que trabajan en los idiomas a los que tradujo el texto.

Nota

Dataverse 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 sólo se permite personalizar texto en el idioma base, puede trabajar en Dataverse 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 Dataverse. Para realizar tareas de personalización adicionales, debe volver a cambiar al idioma base.

Administrar idiomas para la organización

Dataverse 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 acerca de cómo instalar paquetes de idiomas, consulte Habilitar idiomas. 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 IOrganizationService.Execute Método.

Publicación	Operación de API web	Ensamblado del SDK
`DeprovisionLanguage` Contiene los datos necesarios para desaprovisionar un idioma.	DeprovisionLanguage Action	DeprovisionLanguageRequest
`ProvisionLanguage` Contiene los datos necesarios para aprovisionar un idioma nuevo.	ProvisionLanguage Action	ProvisionLanguageRequest
`RetrieveAvailableLanguages` Recupera la lista de los idiomas disponibles.	RetrieveAvailableLanguages Function	RetrieveAvailableLanguagesRequest
`RetrieveDeprovisionedLanguages` Recupera la lista de los paquetes de idiomas instalados en el servidor que se han deshabilitado.	RetrieveDeprovisionedLanguages Function	RetrieveDeprovisionedLanguagesRequest
`RetrieveInstalledLanguagePacks` Contiene los datos necesarios para recupera la lista de los paquetes de idiomas instalados en el servidor.	RetrieveInstalledLanguagePacks Function	RetrieveInstalledLanguagePacksRequest
`RetrieveInstalledLanguagePackVersion` Contiene los datos necesarios para recupera la versión de un paquete de idioma instalado.	RetrieveLicenseInfo Function	RetrieveInstalledLanguagePackVersionRequest
`RetrieveProvisionedLanguages` Recupera la lista de los paquetes de idiomas instalados en el servidor que están habilitados.	RetrieveProvisionedLanguages Function	RetrieveProvisionedLanguagesRequest
`RetrieveProvisionedLanguagePackVersion` Recupera la versión de los paquetes de idiomas instalados en el servidor.	RetrieveProvisionedLanguagePackVersion Function	RetrieveProvisionedLanguagePackVersionRequest

Consulte también

Personalizar definiciones de tablas
AttributeMetadata
EntityMetadata
OptionMetadata