Partilhar via


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

AttributeMetadata.Description

Descrição de um atributo.

AttributeMetadata.DisplayName

Nome de exibição de um atributo.

EntityMetadata.Description

Descrição de uma entidade.

EntityMetadata.DisplayCollectionName

Nome de exibição plural de uma entidade.

EntityMetadata.DisplayName

Nome de exibição de uma entidade.

Label

Etiqueta usada para uma entidade em um relacionamento entre entidades.

OptionMetadata.Label

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

ExportTranslationRequest

Exporta todas as traduções de uma solução específica para um arquivo compactado.

ImportTranslationRequest

Importa todas as traduções de um arquivo compactado.

RetrieveFormattedImportJobResultsRequest

Recupera os resultados de um ImportJob como um documento XML criado para ser aberto usando Microsoft Office Excel.

RetrieveLocLabelsRequest

Recupera os rótulos localizados para o atributo especificado.

SetLocLabelsRequest

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

DeprovisionLanguageRequest

Contém os dados necessários para desprovisionar um idioma

ProvisionLanguageRequest

Contém os dados necessários para retirar a provisão do novo idioma.

RetrieveAvailableLanguagesRequest

Recupera a lista de idiomas disponíveis.

RetrieveDeprovisionedLanguagesRequest

Recupera a lista dos pacotes de idiomas instalados no servidor que foram desabilitados.

RetrieveInstalledLanguagePacksRequest

Contém os dados necessários para recuperar a lista de pacotes de idiomas instalados no servidor.

RetrieveInstalledLanguagePackVersionRequest

Contém os dados necessários para recuperar versão de um pacote de idiomas instalado no servidor.

RetrieveProvisionedLanguagesRequest

Recupera a lista dos pacotes de idiomas instalados no servidor que estão habilitados.

RetrieveProvisionedLanguagePackVersionRequest

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