Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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