Personalizar etiquetas para oferecer suporte a vários idiomas
Publicado: janeiro de 2017
Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Ao criar personalizações no Microsoft Dynamics 365, você poderá oferecer suporte a vários idiomas com etiquetas.
Neste tópico
Usando etiquetas
Mensagens a serem usados com etiquetas
Personalizar etiquetas no idioma base
Traduzir a entidade personalizada e o texto do atributo
Gerenciar idiomas da sua organização
Usando etiquetas
As etiquetas são cadeias de caracteres traduzidas exibidas para os usuários nos aplicativos cliente. São implementadas usando a classe Label, que oferece suporte aos pacotes de idiomas. As cadeias de caracteres exibidas para os usuários, como os nomes de exibição de entidades ou as opções de um conjunto de opções, podem ser armazenadas em vários idiomas. Os usuários podem selecionar o idioma no qual deseja exibir nos formulários e exibições no Microsoft Dynamics 365.
A tabela a seguir lista todos os metadados usando a classe Label.
Propriedade de metadados |
Descrição |
|---|---|
Descrição de um atributo. |
|
Nome de exibição de um atributo. |
|
Descrição de uma entidade. |
|
Nome de exibição plural de uma entidade. |
|
Nome de exibição de uma entidade. |
|
Etiqueta usada para uma entidade em um relacionamento entre entidades. |
|
Etiqueta usada para uma opção em um atributo lista de seleção, estado ou status. |
A classe Label pode armazenar uma cadeia de caracteres para cada idioma instalado. Esta matriz é a propriedade LocalizedLabels. Deve haver sempre uma etiqueta armazenada para o idioma base. Os rótulos para outros idiomas podem ser null. Se o usuário deseja exibir a interface do usuário em um idioma e uma etiqueta não tiver uma cadeia de caracteres para esse idioma, a etiqueta do idioma base é usada.
Você pode usar a propriedade UserLocalizedLabel para recuperar a etiqueta do idioma escolhido pelo usuário.
Mensagens a serem usados com etiquetas
A tabela a seguir lista as mensagens que você pode usar para trabalhar com etiquetas traduzidas para suportar vários idiomas. Quando você importar traduções, é possível gerar um relatório baseado a importação Jjob da mesma forma que você pode importar uma solução. Para obter mais informações, consulte Instalar ou atualizar uma solução.
Mensagem |
Descrição |
|---|---|
Exporta todas as traduções de uma solução específica para um arquivo compactado. |
|
Importa todas as traduções de um arquivo compactado. |
|
Recupera os resultados de um ImportJob como um documento XML criado para ser aberto usando Microsoft Office Excel. |
|
Recupera os rótulos localizados para o atributo especificado. |
|
Define os rótulos localizados para o atributo especificado. |
Personalizar etiquetas no idioma base
As ferramentas de personalização mostram formas de editar nomes de exibição de entidades e você pode personalizar essas propriedades de forma programática. Também é possível editar mensagens de entidade. Nem todas as mensagens são expostas. Outra maneira de encontrar e personalizar o texto usado no aplicativo é exportar as traduções, editar os valores do idioma base e importar as traduções novamente. Embora não seja a finalidade desse recurso, é apenas uma maneira com suporte de identificar e personalizar o texto usado no aplicativo. Para obter mais informações, consulte Modificar as mensagens para uma entidade.
Traduzir a entidade personalizada e o texto do atributo
Como você pode realizar apenas personalizações no aplicativo usando o idioma base, quando desejar fornecer etiquetas traduzidas para essas personalizações, será necessário exportar o texto das etiquetas, para que eles possam ser traduzidos em todos os outros idiomas habilitados para a organização.
Exportar texto personalizado para tradução
É possível exportar as traduções no aplicativo Web ou usando a mensagem ExportTranslationRequest.
O texto exportado é salvo como um arquivo compactado que contém um CrmTranslations.xml que você abre usando o Microsoft Office Excel. É possível enviar este arquivo para um especialista em idiomas, agência de tradução ou empresa de localização.
Para obter mais informações, consulte Esquemas de referência XML do Office 2003.
Importar texto traduzido
Depois de exportar e traduzir o texto personalizado da entidade ou do atributo, é possível importar as cadeias de texto traduzidas no aplicativo Web usando a mensagem ImportTranslationRequest. O arquivo importado deve ser um arquivo compactado que contenha os arquivos CrmTranslations.xml e [Content_Types].xml assim como foi exportado.
Após a importação das traduções concluídas, o texto personalizado será exibido para os usuários que trabalham nos idiomas para os quais você traduziu o texto.
Observação
O Microsoft Dynamics 365 não pode importar texto traduzido que possua mais de 500 caracteres. Se qualquer um dos itens do seu arquivo de tradução exceder 500 caracteres, o processo de importação apresentará falhas. Se isso acontecer, revise a linha do arquivo que causou a falha, reduza a quantidade de caracteres e tente importar novamente.
Como há suporte para a personalização somente no idioma base, talvez você esteja trabalhando no Microsoft Dynamics 365 com o idioma base definido como sua preferência de idioma. Para verificar se o texto traduzido é exibido, é necessário alterar sua preferência de idioma para a interface do usuário do Microsoft Dynamics 365. Para executar trabalho adicional de personalização, você deve retornar para o idioma base.
Gerenciar idiomas da sua organização
O Microsoft Dynamics 365 (online e local) permite instalar vários pacotes de idiomas em um servidor e permite que o usuário selecione um pacote de idiomas. Para obter mais informações sobre como instalar pacotes de idiomas, consulte Guia de Instalação, TechNet: Instalar e habilitar um pacote de idiomas. Esta seção contém informações sobre mensagens usadas para gerenciar idiomas instalados para sua organização.
A tabela a seguir lista as mensagens que podem ser usadas para trabalhar com pacotes de idioma. Use estas mensagens com o método Execute.
Mensagem |
Descrição |
|---|---|
Contém os dados necessários para desprovisionar um idioma |
|
Contém os dados necessários para retirar a provisão do novo idioma. |
|
Recupera a lista de idiomas disponíveis. |
|
Recupera a lista dos pacotes de idiomas instalados no servidor que foram desabilitados. |
|
Contém os dados necessários para recuperar a lista de pacotes de idiomas instalados no servidor. |
|
Contém os dados necessários para recuperar versão de um pacote de idiomas instalado no servidor. |
|
Recupera a lista dos pacotes de idiomas instalados no servidor que estão habilitados. |
|
Recupera a versão dos pacotes de idiomas instalados no servidor. |
Confira Também
Usar o serviço da Organização com metadados do Dynamics 365
Personalizar o aplicativo Microsoft Dynamics 365
Modificar as mensagens para uma entidade
Microsoft Dynamics 365
© 2017 Microsoft. Todos os direitos reservados. Direitos autorais