Traduzir valores de propriedade do produto

Os nomes de produtos podem ser localizados para diferentes regiões. Com o Dynamics 365 Sales, você pode fornecer rótulos localizados para determinados atributos de produto para que as pessoas possam ver os nomes localizados que correspondem às suas preferências de idioma. Este artigo é sobre como os desenvolvedores podem interagir com esse recurso. Para obter instruções passo a passo para usar esse recurso no aplicativo, consulte a documentação de versões anteriores sobre como traduzir nomes e propriedades de produtos em vários idiomas.

Atributos que dão suporte a valores de propriedade localizados

A lista a seguir contém os atributos que dão suporte a valores localizáveis:

• Product.Name

• DynamicProperty.Name

• DynamicPropertyOptionSetItem.DynamicPropertyOptionName

• DynamicPropertyOptionSetItem.DynamicPropertyOptionDescription

  As classes StringAttributeMetadata e MemoAttributeMetadata têm uma propriedade Booliana somente leitura IsLocalizable que é false para todos os atributos, exceto os quatro na tabela anterior.

Recuperar valores de propriedade específicos da localidade

Você não precisa fazer nada diferente para recuperar o valor localizado que corresponde à preferência de idioma do usuário. Se existir um valor localizado para o idioma preferencial do usuário, ele será retornado. Se um valor localizado não existir, o valor da linguagem base da organização será retornado. Esse comportamento mantém a compatibilidade com versões anteriores; qualquer código que atualmente usa o atributo de nome do produto continuará funcionando usando valores localizados. Se a tradução dos valores de propriedade estiver incompleta, os usuários poderão ver valores em idiomas misturados.

Para recuperar todos os rótulos localizados para um atributo localizável específico, use a mensagem RetrieveLocLabelsRequest.

Consulta usando valores localizados

Quando você consulta tabelas com condições usando valores para atributos localizados, as condições são avaliadas primeiro usando seu idioma preferido. Se não houver valores localizados para o atributo, a consulta será revertida para o idioma base. Os resultados da consulta para valores de atributo localizados serão retornados em seu idioma preferencial se eles existirem. Caso contrário, os resultados serão retornados em seu idioma base.

Criar ou atualizar registros com atributos localizáveis

Os registros com atributos localizados são somente leitura, a menos que seu idioma preferido seja o idioma base da organização. Você só pode criar registros com valores de propriedade localizados usando a linguagem base da organização. Se você atualizar o valor do idioma base para um atributo localizável, todos os valores localizados para esse atributo não serão alterados, exceto se você limpar o valor do idioma base. Se você definir o valor do idioma base como nulo ou uma cadeia de caracteres vazia, todos os valores localizados dessa propriedade também serão limpos.

Para adicionar ou atualizar rótulos localizados para qualquer atributo localizado específico, use a SetLocLabelsRequest mensagem ou importe valores traduzidos. Todas as alterações nos atributos localizáveis aparecem no histórico de auditoria do registro. O LCID (identificador de código de idioma) para o valor localizado aparece no histórico de auditoria.

Traduzir atributos localizáveis

O processo de localização de atributos localizáveis programaticamente é semelhante ao processo usado para traduzir rótulos de solução localizados. [!INCLUDE[proc_more_information]Traduzir texto de tabela e coluna personalizados

Ao contrário de traduzir valores de metadados, o usuário que exporta e importa valores de atributos localizados não precisa ter a função de segurança do administrador do sistema. A função de segurança do gerente de vendas tem os privilégios necessários para traduzir atributos localizáveis. A pessoa que traduz os valores de propriedade localizada só pode exportar os registros que tem acesso para exibir e atualizar aqueles nos quais tem privilégios para tal.

Para traduzir atributos localizáveis programaticamente, primeiro você deve exportar as definições de rótulo localizadas atuais usando ExportFieldTranslationRequest. O ExportFieldTranslationResponse. ExportTranslationFile A propriedade contém um byte[] arquivo compactado crmFieldTranslations.zip que contém um arquivo [Content_types].xml e um arquivo crmFieldTranslations.xml que pode ser aberto no Office Excel. A planilha Rótulos Localizados contém uma coluna com um valor LCID para cada idioma provisionado para a organização. A coluna com os valores do idioma base é preenchida e as colunas de cada idioma provisionado contêm quaisquer valores previamente localizados. Esse arquivo pode ser editado por um tradutor para fornecer rótulos localizados para as propriedades localizáveis.

Depois que o arquivo crmFieldTranslations.xml for editado para fornecer rótulos localizados, compacte-o junto com o arquivo [Content_types].xml e defina esse arquivo como a propriedade TranslationFile do ImportFieldTranslationRequest.

Modificar os valores incluídos ao exportar valores de propriedade traduzida

Os valores incluídos nas traduções exportadas são controlados por exibições personalizáveis associadas às tabelas que dão suporte a valores de propriedade localizáveis. Somente as tabelas de produtos exibem essa visão na interface do usuário de personalização. Estas exibições são denominadas Export Field Translations. A tabela a seguir fornece o SavedQueryId para essas visualizações.

Você pode editar a FetchXml propriedade dessas exibições para filtrar quaisquer valores de propriedade de atributo que você não deseja incluir. Por exemplo, talvez você queira excluir registros arquivados ou incluir apenas os registros atualizados após uma determinada data.

Monitorar o progresso dos trabalhos de importação da tradução em campo

As tabelas de trabalho do sistema contêm as seguintes exibições para monitorar o progresso dos trabalhos de importação de tradução de campo:

• Todos os Trabalhos de Importação de Tradução de Campo

• Tarefas de importação de tradução de campo concluídas

• Trabalhos de importação de tradução de campo em andamento

• Meus Trabalhos de Importação de Tradução de Campo

• Trabalhos de Importação de Tradução de Campo Não Iniciados

  As seguintes condições causam erros ao importar trabalhos de tradução:

Desinstalar um idioma

Todos os rótulos localizados fornecidos para um idioma desinstalado permanecem no sistema para que estejam em vigor se o idioma for reinstalado.

Informações relacionadas

Tabelas do catálogo de produtos
Traduzir texto personalizado de tabela e colunaTraduzir nomes e propriedades do produto em vários idiomas