Crear soluciones que admitan varios idiomas
Publicado: enero de 2017
Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Microsoft Dynamics 365 (en línea y local) admite varios idiomas. Si desea que su solución se instale para organizaciones que incluyen distintos idiomas base o que disponen de varios idiomas aprovisionados, tenga esto en cuenta al planear su solución. En la siguiente tabla se enumeran tácticas para usar junto con los componentes de la solución para incluir en una solución que admita varios idiomas.
Táctica |
Tipo de componente de la solución |
|---|---|
Opción de desarrollador |
Recursos web |
Etiquetas insertadas |
Cintas de opciones de navegación |
Desplazamientos de exportación e importación |
Atributos |
Localización en cadenas del idioma base |
Plantillas de contrato |
No se requiere localización |
Extremos de servicio de los pasos de procesamiento de |
Componente independiente para cada idioma |
Plantillas de artículos |
Utilice recursos web XML como recursos de idioma |
Ensamblados de complementos |
En las siguientes secciones se proporcionan detalles adicionales para cada táctica.
Opción de desarrollador
Los recursos web tienen un atributo de LanguageCode que se puede establecer en la interfaz de usuario, pero este valor no es utilizado por la aplicación. Debido a que los recursos web no son direccionables a URL, normalmente accederá a un recurso web por nombre en lugar de mediante la consulta de recursos web disponibles con LanguageCode como criterio. Por lo tanto, LanguageCode presenta un valor limitado. El escenario más común es que tendrá que detectar el idioma adecuado en función del contexto en el que se mostrará el recurso web. Para los recursos web, el objeto de contexto proporciona acceso a las funciones getOrgLcid y getUserLcid. Ambas funciones devuelven un valor entero que se corresponde con los valores del identificador de la configuración regional (LCID).Los valores de identificadores de configuración regional válidos pueden encontrarse en la tabla de identificadores de configuración regional (LCID).
Para los recursos web que exponen texto en la interfaz de usuario, puede usar los métodos que desee para administrar la forma en que el texto y el diseño admitirán las preferencias de idioma del usuario. La implementación específica depende del tipo de recurso web.
Recursos web HTML
Una opción es crear recursos web localizados independientes que varían en función del nombre aplicado. Por ejemplo, puede tener un recurso web denominado new_/my_solution/1033/content.htm para admitir el inglés y uno denominado new_/my_solution/1041/content.htm para admitir el japonés. Para los idiomas que requieren dirección de derecha a izquierda, consulte Cómo: mostrar texto de derecha a izquierda mediante etiquetas HTML para la globalización.
Si desea poder establecer dinámicamente el texto de la interfaz de usuario en función del idioma de un usuario, puede almacenar todos los valores de cadenas localizados que se encuentran en un objeto definido en un archivo de recursos web de script. Según la preferencia de idioma del usuario, puede establecer los elementos de texto de la interfaz de usuario mediante las cadenas almacenadas en el objeto cuando se carga la página. El siguiente código de JavaScript de ejemplo muestra un método para establecer cadenas localizadas.
var userLcid = 1033;
var localizedStrings = {
ErrorMessage: {
_1033: "There was an error completing this action. Please try again.",
_1041: "このアクションを完了、エラーが発生しました。もう一度実行してください。",
_1031: "Es ist ein Fehler aufgetreten, der Abschluss dieser Aktion. Bitte versuchen Sie es erneut.",
_1036: "Il y avait une erreur complétant cette action. Veuillez essayer à nouveau.",
_1034: "Hubo un error al completar esta acción. Vuelva a intentarlo.",
_1049: "Произошла ошибка, выполнение этого действия. Пожалуйста, попробуйте снова."
},
Welcome: {
_1033: "Welcome",
_1041: "ようこそ",
_1031: "Willkommen",
_1036: "Bienvenue",
_1034: "Bienvenido",
_1049: "Добро пожаловать"
}
};
var LocalizedErrorMessage = localizedStrings.ErrorMessage["_" + userLcid];
var LocalizedWelcomeMessage = localizedStrings.Welcome["_" + userLcid];
Recursos web de Silverlight
Las aplicaciones Silverlight se pueden escribir para admitir recursos de idiomas localizados.Más información:Localización de aplicaciones basadas en Silverlight.
La siguiente clase proporciona acceso a la preferencia de idioma del usuario en función del contexto en el que se presenta el recurso web de Silverlight. Esta clase admite inglés de Estados Unidos, árabe, alemán, hebreo y japonés. Debe modificarse para idiomas específicos compatibles con el recurso web de Silverlight.
public static class Localization
{
// The locale ID.
public static int LCID { get; set; }
// Create a dictionary of right-to-left language codes (Hebrew and Arabic).
private static Dictionary<int, bool> _rightToLeftLanguages =
new Dictionary<int, bool>
{
{ 1025, true },
{ 1037, true },
};
private static Dictionary<int, String> _lcidToCultureNameMap =
new Dictionary<int, String>
{
{ 1025, "ar-SA" },
{ 1031, "de-DE" },
{ 1033, "en-US" },
{ 1037, "he-IL" },
{ 1041, "ja-JP" }
};
public static void InitializeCulture()
{
// Get the user's LCID from the page's context to determine what language to
// display.
dynamic window = HtmlPage.Window;
//Get the user's language code from the context.
try
{
//If the containing window is a CRM form
LCID = Convert.ToInt32(window.Xrm.Page.context.getUserLcid());
// For testing, comment the line above and uncomment one of the lines below
//representing a user language.
//LCID = 1033; //English
//LCID = 1041; //Japanese
//LCID = 1031; //German
//LCID = 1037; //Hebrew - a right-to-left language.
//LCID = 1025; //Arabic - a right-to-left language.
}
catch (Microsoft.CSharp.RuntimeBinder.RuntimeBinderException)
{
try
{
//If the containing window is a CRM web resource with
//the WebResources/ClientGlobalContext.js.aspx page linked
LCID = Convert.ToInt32(window.GetGlobalContext().getUserLcid());
}
catch (Microsoft.CSharp.RuntimeBinder.RuntimeBinderException)
{
LCID = 1033; //Setting a default for design time when the context
//object is not present and one of the sample languages are not set.
}
}
// Sets the culture of the thread to the appropriate culture, based on what
// LCID was retrieved.
if (_lcidToCultureNameMap.ContainsKey(LCID))
{
var culture = new CultureInfo(_lcidToCultureNameMap[LCID]);
Thread.CurrentThread.CurrentCulture = culture;
Thread.CurrentThread.CurrentUICulture = culture;
}
}
public static FlowDirection GetFlowDirection()
{
if (_rightToLeftLanguages.ContainsKey(LCID))
{
return FlowDirection.RightToLeft;
}
return FlowDirection.LeftToRight;
}
}
Para obtener información acerca de los idiomas que requieren la dirección de derecha a izquierda, consulte FrameworkElement.FlowDirection Property.
Recursos web XML
Aunque los recursos web XML no se suelen mostrar a los usuarios, pueden resultar útiles para almacenar cadenas localizadas como recursos para otros componentes de la solución tal y como se describe en Utilice recursos web XML como recursos de idioma.
Etiquetas insertadas
Cada uno de los componentes de la solución que usan esta táctica requieren que el texto localizado se incluya en el componente de la solución.
Cintas
Cuando se instala un paquete de idioma, la cinta de aplicaciones muestra automáticamente texto localizado para todo el texto predeterminado en la cinta. Las etiquetas del sistema se definen en un valor de atributo de ResourceId que es solo para uso interno. Cuando agregue su propio texto deberá usar el elemento de <LocLabels> (RibbonDiffXml) para proporcionar texto localizado para los idiomas que admite.Más información:Usar etiquetas localizadas con cintas de opciones
Mapa del sitio
Cuando se instala un paquete de idioma, el texto predeterminado de la barra de navegación de la aplicación muestra automáticamente texto localizado. Para reemplazar el texto predeterminado o para proporcionar su propio texto, use el elemento de <Titles> (SiteMap). El elemento de Titles debe contener un elemento de <Title> (SiteMap) que contenga texto localizado para cualquier idioma que admita su solución. Si un elemento de Title no está disponible para el idioma preferido del usuario, se mostrará el título que corresponda al idioma base de la organización.
El elemento de <SubArea> (SiteMap) permite pasar la preferencia de idioma del usuario mediante el parámetro userlcid de modo que el contenido que es el destino del atributo SubArea.Url pueda conocer de la preferencia de idioma del usuario y ajustarse en consecuencia.Más información:Pasar parámetros a una dirección URL con el mapa del sitio
Desplazamientos de exportación e importación
Las etiquetas localizables para los componentes de la solución de la siguiente tabla se pueden exportar para la localización.
Entidades |
Atributos |
Relaciones |
Conjuntos de opciones globales |
Mensajes de la entidad |
Formularios de entidad |
Vistas de entidad (SavedQuery) |
Gráficos |
Paneles |
Desplazamiento de etiquetas y mostrar cadenas
Solo puede realizar personalizaciones en la aplicación mediante el idioma base. Por lo tanto, cuando se desea proporcionar etiquetas localizadas y mostrar cadenas 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. Lleve a cabo los pasos siguientes:
Asegúrese de que la organización en la que está trabajando disponga de todos los paquetes MUI instalados y los idiomas aprovisionados para los idiomas para los que desee proporcionar traducciones.
Cree su solución y modifique los componentes.
Una vez que haya terminado de desarrollar su solución, utilice la funcionalidad de "Exportar traducciones". Esto genera una hoja de cálculo de Microsoft Office Excel (CrmTranslations.xml) que contiene todas las etiquetas que necesitan traducción.
En la hoja de cálculo, proporcione las traducciones correspondientes.
Vuelva a importar traducciones a la misma organización de Microsoft Dynamics 365 con la funcionalidad de "Importar traducciones" y publique sus cambios.
La próxima vez que exporte la solución, contendrá todas las traducciones que haya proporcionado.
Cuando se importa una solución, las etiquetas para idiomas que no están disponibles en el sistema de destino de descartan y se registra una advertencia.
Si las etiquetas del idioma base del sistema de destino no se incluyen en el paquete de solución, las etiquetas del idioma base del origen se usan en su lugar. Por ejemplo, si importa una solución que contenga etiquetas para inglés y francés con el inglés como idioma base, pero el sistema de destino tiene el japonés y el francés con el japonés como idioma base, se utilizarán las etiquetas en inglés en lugar de las etiquetas en japonés. Las etiquetas de los idiomas base no pueden ser null o estar vacías.
Exportación de traducciones
Antes de exportar traducciones primero debe instalar los paquetes de idiomas y aprovisionar todos los idiomas que desee localizar. Puede exportar las traducciones en la aplicación web o con el mensaje ExportTranslationRequest. Para obtener más información, consulte Ayuda y entrenamiento: Exportación de texto personalizado de entidades y campos para su traducción .
Traducción de texto
Cuando abra el archivo CrmTranslations.xml en Excel verá las tres hojas de cálculo que aparecen en la siguiente tabla.
Hoja de cálculo |
Descripción |
|---|---|
Información |
Muestra información acerca de la organización y solución desde la que se exportaron las etiquetas y cadenas. |
Cadenas para mostrar |
Muestre las cadenas que representen el texto de los mensajes asociados con un componente de metadatos. Esta tabla incluye los mensajes de error y cadenas usados para los elementos de la cinta del sistema. |
Etiquetas localizadas |
Muestra todo el texto de cualquier etiqueta de componente de metadatos. |
Puede enviar este archivo a un lingüista experto, a una agencia de traducción o a una empresa de localización. Estos deberán proporcionar las cadenas localizadas de las celdas vacías.
Nota
Para las entidades personalizadas hay algunas etiquetas comunes que se comparten con entidades del sistema, como Fecha de creación o Autor. Debido a que tiene instalados y aprovisionados los idiomas, si exporta idiomas para la solución predeterminada podrá hacer que coincidan algunas etiquetas de sus entidades personalizadas con texto localizado para las etiquetas idénticas usadas por otras entidades. Esto puede ralentizar los costes de localización y mejorar la coherencia.
Una vez localizado el texto de las hojas de cálculo, agregue los archivos CrmTranslations.xml y [Content_Types].xml a un único archivo .zip comprimido. Ahora podrá importar este archivo.
Si prefiere trabajar con los archivos exportados mediante programación como un documento XML, consulte Esquemas de referencia XML de Office 2003 para obtener más información acerca de los esquemas que utilizan estos archivos.
Importación de texto traducido
Importante
Solo se puede importar texto traducido nuevamente a la misma organización desde la que se exportó.
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 en la raíz. Para obtener más información, consulte Ayuda y entrenamiento: Importar texto traducido de entidades y campos.
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.
Localización en cadenas del idioma base
Algunos componentes de la solución no admiten varios idiomas. Estos nombres incluyen nombres o texto que solamente pueden tener significado en un idioma específico. Si crea una solución para un idioma específico, defina estos componentes de la solución en el idioma base de la organización planteada.
Si necesita admitir varios idiomas, una táctica es incluir la solución en las cadenas de idioma base. Por ejemplo, si tiene un rol de conexión con el nombre "Amigo" y necesita admitir inglés, español y alemán, puede utilizar el texto "Amigo (Amigo/Freund)" como nombre del rol de conexión. Debido a problemas de longitud de texto, existen limitaciones sobre el número de idiomas que se pueden admitir utilizando esta táctica.
Algunos componentes de la solución de este grupo solo son visibles para los administradores. Debido a que la personalización del sistema solamente puede efectuarse en el idioma base de la organización no es necesario proporcionar versiones en varios idiomas. Los componentes Roles de seguridad y Perfil de seguridad de campo pertenecen a este grupo.
Plantillas de contrato proporcionan una descripción de un tipo de contrato de servicio. Estas requieren texto para los campos Nombre y Abreviatura. Deberá considerar la posibilidad de usar nombres y abreviaturas que sean únicos y adecuados para todos los usuarios de la organización.
Roles de conexión dependen de una persona que selecciona categorías y nombres de roles de conexión descriptivos. Debido a que estos pueden ser relativamente cortos, es recomendable incluir la localización en cadenas de idioma base.
Los procesos (flujos de trabajo) que se inician para eventos pueden funcionar correctamente mientras no necesiten actualizar registros con texto que se deba localizar. Es posible usar un ensamblado de flujo de trabajo de modo que la lógica que se aplique al texto localizado pueda usar la misma estrategia que ensamblados de complementos (Utilice recursos web XML como recursos de idioma).
Los flujos de trabajo a petición requieren un nombre para que la gente pueda elegirlos. Además de incluir la localización con el nombre del flujo de trabajo a petición, otra táctica es crear varios flujos de trabajo con nombres localizados que cada uno recupere el mismo proceso secundario. Sin embargo, todos los usuarios verán la lista completa de los flujos de trabajo a petición, no solo los que se encuentran en el idioma de la interfaz de usuario preferido.
No se requiere localización
El paso de procesamiento del mensaje del SDK y los componentes de la solución del Extremo de servicio no exponen el texto localizable a los usuarios. Si es importante que estos componentes tengan nombres y descripciones que se correspondan al idioma base de la organización, puede crear y exportar una solución administrada con nombres y descripciones en ese idioma.
Componente independiente para cada idioma
Los siguientes componentes de la solución pueden contener cada uno una cantidad considerable de texto para localizar:
Plantillas de artículo
Plantillas de correo electrónico
Plantillas de combinación de correspondencia
Informes
Diálogos
Para estos tipos de componentes de la solución, la táctica recomendada es crear componentes independientes para cada idioma. Esto significa que generalmente crea una solución administrada base que contiene los componentes de la solución centrales y luego una solución administrada independiente que contiene esos componentes de la solución para cada idioma. Una vez que los clientes instalan la solución base, pueden instalar las soluciones administradas para los idiomas que han aprovisionado para la organización.
A diferencia de los Procesos (flujos de trabajo), puede crear Diálogos que reflejarán los valores actuales de preferencia de idioma del usuario y mostrarán los diálogos solo a los usuarios de ese idioma.
Crear un cuadro de diálogo localizado
Instale el paquete de idioma correcto y proporcione el idioma.
Para obtener más información, consulte TechNet: Instrucciones de instalación de paquetes de idioma.
Cambiar sus opciones personales para especificar Idioma de interfaz de usuario del idioma que desee para el diálogo.
Vaya a Configuración y, en el grupo Centro de procesos , seleccione Procesos.
Haga clic en Nueva y crea el diálogo en el idioma especificado.
Una vez creado el diálogo, cambie sus opciones personales para especificar el idioma base de la organización.
Mientras usa el idioma base de la organización se puede navegar al área Soluciones en Configuración y agregar el diálogo localizado como parte de una solución.
El diálogo creado en el otro idioma se mostrará solo a los usuarios que ven Microsoft Dynamics 365 con ese idioma.
Utilice recursos web XML como recursos de idioma
Los componentes de la solución del ensamblado del complemento pueden enviar mensajes a un usuario final lanzando un InvalidPluginExecutionException y creando y actualizando los registros. A diferencia de los recursos web de Silverlight, los complementos no pueden usar los archivos de recursos.
Cuando un complemento requiere texto localizado, puede usar un recurso web XML para almacenar las cadenas localizadas para que el complemento pueda acceder a ellas cuando sea necesario. La estructura del XML depende de usted, pero es posible que desee seguir la estructura usada por los archivos del recurso ASP.NET (.resx) para crear recursos web XML independientes para cada idioma. Por ejemplo, a continuación se facilita un recurso web XML llamado localizedString.en_US que sigue el patrón usado por los archivos.resx.
<root>
<data name="ErrorMessage">
<value>There was an error completing this action. Please try again.</value>
</data>
<data name="Welcome">
<value>Welcome</value>
</data>
</root>
El siguiente código muestra cómo se puede pasar un mensaje localizado en un complemento para mostrar un mensaje a un usuario. Es para la fase de validación previa de un evento de Delete de la entidad de Account:
protected void ExecutePreValidateAccountDelete(LocalPluginContext localContext)
{
if (localContext == null)
{
throw new ArgumentNullException("localContext");
}
int OrgLanguage = RetrieveOrganizationBaseLanguageCode(localContext.OrganizationService);
int UserLanguage = RetrieveUserUILanguageCode(localContext.OrganizationService,
localContext.PluginExecutionContext.InitiatingUserId);
String fallBackResourceFile = "";
switch (OrgLanguage)
{
case 1033:
fallBackResourceFile = "new_localizedStrings.en_US";
break;
case 1041:
fallBackResourceFile = "new_localizedStrings.ja_JP";
break;
case 1031:
fallBackResourceFile = "new_localizedStrings.de_DE";
break;
case 1036:
fallBackResourceFile = "new_localizedStrings.fr_FR";
break;
case 1034:
fallBackResourceFile = "new_localizedStrings.es_ES";
break;
case 1049:
fallBackResourceFile = "new_localizedStrings.ru_RU";
break;
default:
fallBackResourceFile = "new_localizedStrings.en_US";
break;
}
String ResourceFile = "";
switch (UserLanguage)
{
case 1033:
ResourceFile = "new_localizedStrings.en_US";
break;
case 1041:
ResourceFile = "new_localizedStrings.ja_JP";
break;
case 1031:
ResourceFile = "new_localizedStrings.de_DE";
break;
case 1036:
ResourceFile = "new_localizedStrings.fr_FR";
break;
case 1034:
ResourceFile = "new_localizedStrings.es_ES";
break;
case 1049:
ResourceFile = "new_localizedStrings.ru_RU";
break;
default:
ResourceFile = fallBackResourceFile;
break;
}
XmlDocument messages = RetrieveXmlWebResourceByName(localContext, ResourceFile);
String message = RetrieveLocalizedStringFromWebResource(localContext, messages, "ErrorMessage");
throw new InvalidPluginExecutionException(message);
}
protected static int RetrieveOrganizationBaseLanguageCode(IOrganizationService service)
{
QueryExpression organizationEntityQuery = new QueryExpression("organization");
organizationEntityQuery.ColumnSet.AddColumn("languagecode");
EntityCollection organizationEntities = service.RetrieveMultiple(organizationEntityQuery);
return (int)organizationEntities[0].Attributes["languagecode"];
}
protected static int RetrieveUserUILanguageCode(IOrganizationService service, Guid userId)
{
QueryExpression userSettingsQuery = new QueryExpression("usersettings");
userSettingsQuery.ColumnSet.AddColumns("uilanguageid", "systemuserid");
userSettingsQuery.Criteria.AddCondition("systemuserid", ConditionOperator.Equal, userId);
EntityCollection userSettings = service.RetrieveMultiple(userSettingsQuery);
if (userSettings.Entities.Count > 0)
{
return (int)userSettings.Entities[0]["uilanguageid"];
}
return 0;
}
protected static XmlDocument RetrieveXmlWebResourceByName(LocalPluginContext context, string webresourceSchemaName)
{
context.TracingService.Trace("Begin:RetrieveXmlWebResourceByName, webresourceSchemaName={0}", webresourceSchemaName);
QueryExpression webresourceQuery = new QueryExpression("webresource");
webresourceQuery.ColumnSet.AddColumn("content");
webresourceQuery.Criteria.AddCondition("name", ConditionOperator.Equal, webresourceSchemaName);
EntityCollection webresources = context.OrganizationService.RetrieveMultiple(webresourceQuery);
context.TracingService.Trace("Webresources Returned from server. Count={0}", webresources.Entities.Count);
if (webresources.Entities.Count > 0)
{
byte[] bytes = Convert.FromBase64String((string)webresources.Entities[0]["content"]);
// The bytes would contain the ByteOrderMask. Encoding.UTF8.GetString() does not remove the BOM.
// Stream Reader auto detects the BOM and removes it on the text
XmlDocument document = new XmlDocument();
document.XmlResolver = null;
using (MemoryStream ms = new MemoryStream(bytes))
{
using (StreamReader sr = new StreamReader(ms))
{
document.Load(sr);
}
}
context.TracingService.Trace("End:RetrieveXmlWebResourceByName , webresourceSchemaName={0}", webresourceSchemaName);
return document;
}
else
{
context.TracingService.Trace("{0} Webresource missing. Reinstall the solution", webresourceSchemaName);
throw new InvalidPluginExecutionException(String.Format("Unable to locate the web resource {0}.", webresourceSchemaName));
return null;
// This line never reached
}
}
protected static string RetrieveLocalizedStringFromWebResource(LocalPluginContext context, XmlDocument resource, string resourceId)
{
XmlNode valueNode = resource.SelectSingleNode(string.Format(CultureInfo.InvariantCulture, "./root/data[@name='{0}']/value", resourceId));
if (valueNode != null)
{
return valueNode.InnerText;
}
else
{
context.TracingService.Trace("No Node Found for {0} ", resourceId);
throw new InvalidPluginExecutionException(String.Format("ResourceID {0} was not found.", resourceId));
}
}
Ver también
Empaquetar y distribuir las extensiones con soluciones
Introducción a soluciones
Planear el desarrollo de la solución
Seguimiento de las dependencias de los componentes de la solución
Crear, exportar o importar una solución no administrada
Crear, instalar y actualizar una solución administrada
Desinstalar o eliminar una solución
Entidades de solución
Localizar los valores de propiedad del producto
Microsoft Dynamics 365
© 2017 Microsoft. Todos los derechos reservados. Copyright