Compartir a través de


Personalizar etiquetas para admitir varios idiomas

Al crear personalizaciones en Microsoft Dataverse, puede admitir varios idiomas mediante etiquetas.

Uso de etiquetas

Microsoft.Xrm.Sdk.dll API de la Web
clase Label Label ComplexType
clase LocalizedLabel LocalizedLabel ComplexType

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

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

Propiedad de definiciones de tabla Description
AttributeMetadata.Description Descripción de una columna.
AttributeMetadata.DisplayName Nombre visible de una columna.
EntityMetadata.Description Descripción de una tabla.
EntityMetadata.DisplayCollectionName Nombre para mostrar en plural de una tabla.
EntityMetadata.DisplayName Nombre de visualización para una tabla.
AssociatedMenuConfiguration.Label Etiqueta utilizada para una tabla en una relación entre tablas.
OptionMetadata.Label Etiqueta usada para un valor en una columna de elección, estado o condición.

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 de otros idiomas pueden ser null. Si el usuario quiere mostrar la interfaz de usuario en un idioma y una etiqueta no tiene una cadena para ese idioma, se usa la etiqueta del idioma base.

Puede usar la UserLocalizedLabel propiedad para recuperar la etiqueta del idioma elegido por el usuario.

Mensajes que se van a usar con etiquetas

En la tabla siguiente se enumeran los mensajes que puede usar para trabajar con etiquetas localizadas para admitir varios idiomas. Al importar traducciones, puede generar un informe basado en el trabajo de importación de la misma manera que puede importar una solución. Para obtener más información, consulte Importación de una solución no administrada.

Message Operación de API web Clase del SDK de .NET
ExportTranslation
Exporta todas las traducciones de una solución específica a un archivo comprimido.
ExportTranslation (acción) ExportTranslationRequest
ImportTranslation
Importa todas las traducciones desde un archivo comprimido.
Acción ImportTranslation ImportTranslationRequest
RetrieveFormattedImportJobResults
Recupera los resultados de importJob como un documento XML diseñado para abrirse mediante Office Excel.
Función RetrieveFormattedImportJobResults RetrieveFormattedImportJobResultsRequest
RetrieveLocLabels
Recupera las etiquetas localizadas para la columna especificada.
Función RetrieveLocLabels RetrieveLocLabelsRequest
SetLocLabels
Establece las etiquetas localizadas para la columna especificada.
Acción SetLocLabels SetLocLabelsRequest

Personalización de etiquetas en el idioma base

Las herramientas de personalización proporcionan formas de editar nombres para mostrar y puede personalizar estas propiedades mediante programación. También puede editar mensajes. Pero no todos los mensajes se exponen. Otra manera de localizar y personalizar el texto usado en la aplicación es exportar las traducciones, editar los valores del idioma base e importar las traducciones de nuevo. Aunque este no es el propósito previsto de esta característica, es una manera compatible de identificar y personalizar el texto usado en la aplicación. Para obtener más información, consulte Editar mensajes de tabla del sistema (versión preliminar).

Traducir texto de tabla y de columna personalizado

Dado que solo puede realizar personalizaciones en la aplicación mediante el idioma base, cuando quiera proporcionar etiquetas localizadas para estas personalizaciones, debe exportar el texto de las etiquetas para que se puedan localizar para cualquier otro idioma habilitado para la organización.

Exportación de texto personalizado para la traducción

Puede exportar las traducciones en la aplicación web o mediante el ExportTranslation mensaje (Acción ExportTranslationRequest).

El texto exportado se guarda como un archivo comprimido que contiene un CrmTranslations.xml objeto que se abre mediante Microsoft Excel. Puede enviar este archivo a un lingüista experto, a una agencia de traducción o a una empresa de localización.

Importación de texto traducido

Una vez que haya exportado el texto personalizado de la tabla o columna y lo haya traducido, puede importar las cadenas de texto traducidas en la aplicación web mediante el ImportTranslation mensaje (Acción ImportTranslationRequest). El archivo que importe debe ser un archivo comprimido que contenga el archivo CrmTranslations.xml y el archivo [Content_Types].xml tal como se exportó.

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.

Administración de idiomas para su organización

Dataverse permite instalar varios paquetes de idioma 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, vea Habilitar idiomas. Esta sección contiene información sobre los mensajes usados para administrar los idiomas instalados para su organización.

En la tabla siguiente se enumeran los mensajes que se usan para trabajar con paquetes de idioma. Usa estos mensajes con el método IOrganizationService.Execute

Message Operación de API web Clase del SDK de .NET
DeprovisionLanguage
Contiene los datos necesarios para desaprovisionar un idioma.
Acción DeprovisionLanguage DeprovisionLanguageRequest
ProvisionLanguage
Contiene los datos necesarios para aprovisionar un nuevo idioma.
Acción de ProvisionLanguage ProvisionLanguageRequest
RetrieveAvailableLanguages
Recupera la lista de idiomas disponibles.
Función RetrieveAvailableLanguages RetrieveAvailableLanguagesRequest
RetrieveDeprovisionedLanguages
Recupera la lista de paquetes de idioma instalados en el servidor que se han deshabilitado.
Función RetrieveDeprovisionedLanguages RetrieveDeprovisionedLanguagesRequest
RetrieveInstalledLanguagePacks
Contiene los datos necesarios para recuperar la lista de paquetes de idioma instalados en el servidor.
Función RetrieveInstalledLanguagePacks RetrieveInstalledLanguagePacksRequest
RetrieveInstalledLanguagePackVersion
Contiene los datos necesarios para recuperar la versión de un paquete de idioma instalado.
Función RetrieveLicenseInfo RetrieveInstalledLanguagePackVersionRequest
RetrieveProvisionedLanguages
Recupera la lista de paquetes de idioma instalados en el servidor habilitado.
Función RetrieveProvisionedLanguages RetrieveProvisionedLanguagesRequest
RetrieveProvisionedLanguagePackVersion
Recupera la versión de los paquetes de idioma instalados en el servidor.
Función RetrieveProvisionedLanguagePackVersion RetrieveProvisionedLanguagePackVersionRequest

Consulte también

Personalizar definiciones de tablas
AttributeMetadata
EntityMetadata
OptionMetadata