Estruturar relatórios multilingues nos Relatórios eletrónicos
Descrição Geral
Como utilizador empresarial, pode utilizar a arquitetura de Relatórios eletrónicos (ER) para configurar formatos para os documentos de saída que têm de ser gerados de acordo com os requisitos legais de vários países ou regiões. Quando estes requisitos exigem que os documentos de saída sejam gerados em diferentes idiomas para diferentes países ou regiões, pode configurar um único formato de ER que contenha recursos dependentes de idiomas. Desta forma, pode reutilizar o formato para gerar os documentos de saída para vários países ou regiões. Também pode pretender utilizar um único formato de ER para gerar um documento de saída em diferentes idiomas para clientes, fornecedores, subsidiárias ou outros terceiros correspondentes.
Pode configurar modelos de dados de ER e mapeamentos de modelos como origens de dados de formatos de ER configurados para definir o fluxo de dados que especifica quais os dados da aplicação incluídos nos documentos gerados. Como fornecedor de configuração de ER, pode publicar modelos de dados configurados, mapeamentos de modelos e formatos como componentes de uma solução de ER para gerar documentos de saída específicos. Também pode permitir que os clientes carreguem a solução de ER publicada para que possa ser utilizada e personalizada. Se espera que os clientes possam falar outros idiomas, pode configurar os componentes de ER para que contenham recursos dependentes de idiomas. Desta forma, o conteúdo de um componente editável de ER pode ser apresentado no idioma preferencial do cliente durante a estruturação.
Pode configurar os recursos dependentes de idiomas como etiquetas de ER. Em seguida, pode utilizar essas etiquetas para configurar componentes de ER para as seguintes finalidades:
Durante a estruturação:
- Apresente o conteúdo dos componentes de ER configurados no idioma preferencial do utilizador.
Durante a execução:
- Gere conteúdo dependente de idiomas para os documentos de saída.
- Apresente mensagens de aviso e erro no idioma preferencial do utilizador.
- Apresente os campos obrigatórios no idioma preferencial do utilizador.
As etiquetas de ER podem ser configuradas em cada configuração de ER que contenha diferentes componentes. As etiquetas podem ser mantidas independentemente da lógica configurada de modelos de dados de ER, mapeamentos de modelos de ER e componentes de formato de ER.
Cada etiqueta de ER é identificada por um ID único no âmbito da configuração de ER que contém essa etiqueta. Cada etiqueta pode conter texto de etiqueta para cada idioma suportado na instância atual do Microsoft Dynamics 365 Finance. Esses idiomas suportados incluem os idiomas das personalizações implementadas.
Introdução
Quando estrutura um modelo de dados de ER, um mapeamento de modelos de ER ou um formato de ER, a opção 'Traduzir' é apresentada sempre que seleciona um campo que possa conter o contexto traduzível. Quando seleciona esta opção, pode associar o campo selecionado a uma etiqueta de ER no painel Tradução de texto. Pode selecionar uma etiqueta de ER existente ou pode adicionar uma nova etiqueta de ER se ainda não estiver disponível. Quando seleciona ou adiciona uma etiqueta de ER, pode adicionar texto relacionado para cada idioma suportado na instância atual do Finance.
A seguinte ilustração mostra como essa tradução é efetuada num modelo de dados de ER editável. Neste exemplo, o atributo Descrição do campo PurchaseOrder para o Modelo de fatura editável é traduzido para os idiomas alemão austríaco (DE-AT) e japonês (JA).
Apenas pode ser traduzido o texto de etiqueta para etiquetas que residam num componente editável de ER. Por exemplo, se selecionar Traduzir para o atributo de etiqueta de uma origem de dados de mapeamento de modelos de ER e, em seguida, selecionar uma etiqueta de ER que resida no modelo de dados de ER principal, verá o conteúdo da etiqueta, mas não poderá alterá-lo. Nestes casos, o campo Texto traduzido está indisponível, tal como mostrado na ilustração seguinte.
Nota
Não pode utilizar os estruturadores para eliminar uma etiqueta introduzida num componente editável de ER.
Âmbito
As etiquetas de ER podem ser referidas em vários atributos traduzíveis de componentes de ER.
Componente de modelo de dados
Quando configura um modelo de dados de ER, pode adicionar etiquetas de ER para o mesmo. Os atributos Etiqueta e Descrição do item de modelo, todos os campos do modelo e todos os valores de enumeração do modelo podem ser associados a uma etiqueta de ER adicionada ao modelo de dados de ER.
Quando um modelo de dados de ER é configurado desta forma, o respetivo conteúdo será apresentado aos utilizadores do estruturador de modelos de dados de ER no idioma preferencial de cada utilizador. Portanto, a manutenção do modelo é simplificada. As ilustrações seguintes mostram como funciona esta funcionalidade para os utilizadores com DE-AT e JA definidos como o idioma preferencial.
Componente de mapeamento de modelos
Como o mapeamento de modelos de ER baseia-se num modelo de dados de ER, as etiquetas dos elementos de modelo de dados referidos são apresentadas no idioma preferencial do utilizador no estruturador de mapeamento de modelos. A ilustração seguinte mostra como o significado do campo PurchaseOrder é explicado no mapeamento de modelos editáveis utilizando a etiqueta do atributo Descrição adicionado ao modelo de dados configurado. Tenha em atenção que esta etiqueta é apresentada no idioma preferencial do utilizador (DE-AT neste exemplo).
Quando o atributo Etiqueta da origem de dados do Parâmetro de entrada de utilizador é configurado como associado a uma etiqueta de ER, o campo de parâmetro correspondente a essa origem de dados é apresentado na caixa de diálogo de utilizador durante a execução aos utilizadores no respetivo idioma preferencial.
Componente de formato
Quando configura um formato de ER, pode adicionar etiquetas de ER para o mesmo. Os atributos Etiqueta e Texto de ajuda de cada origem de dados configurada podem ser associados a uma etiqueta de ER adicionada ao formato de ER. Os atributos Etiqueta e Descrição de todos os valores de enumeração de formato também podem ser associados a uma etiqueta de ER acessível a partir do formato editável de ER.
Nota
Também pode associar estes atributos a uma etiqueta de ER do modelo de dados de ER principal que reutiliza as etiquetas do modelo em todos os formatos de ER configurados para este modelo de dados de ER.
Quando um formato de ER é configurado desta forma, o conteúdo do formato será apresentado aos utilizadores do estruturador de operações de ER no idioma preferencial de cada utilizador. Portanto, a manutenção do formato e a análise da lógica configurada são simplificadas.
Como o formato de ER baseia-se num modelo de dados de ER, as etiquetas referidas nos elementos de modelo de dados são apresentadas no estruturador de formatos de ER no idioma preferencial do utilizador.
Quando o atributo Etiqueta da origem de dados do Parâmetro de entrada de utilizador está associado a uma etiqueta de ER, o campo correspondente ao parâmetro na caixa de diálogo de utilizador durante a execução é apresentado ao utilizador como uma mensagem de opções. As ilustrações seguintes mostram como pode associar o atributo Etiqueta da origem de dados do Parâmetro de entrada de utilizador durante a estruturação a uma etiqueta de ER, para que o parâmetro (apresentado para os idiomas inglês dos Estados Unidos (EN-US) e DE-AT) seja solicitado aos utilizadores em diferentes idiomas preferenciais do utilizador durante a execução.
Expressões
Para utilizar uma etiqueta numa expressão de ER, tem de utilizar a sintaxe @"GER_LABEL:X", em que o prefixo @ indica que o operando se refere a uma etiqueta, GER_LABEL indica que está envolvida uma etiqueta de ER e X corresponde ao ID da etiqueta de ER.
Para se referir a uma etiqueta de sistema (aplicação), utilize a sintaxe @"X", em que o prefixo @ indica que o operando se refere a uma etiqueta e X corresponde ao ID da etiqueta do sistema.
Mapeamento de modelos
Uma expressão de um mapeamento de modelos de ER pode ser configurada utilizando uma etiqueta. Quando este mapeamento é chamado por um formato de ER executado para gerar um documento de saída, o contexto da execução inclui um código de idioma. Uma etiqueta de expressão configurada será preenchida com o texto de etiqueta configurado para o idioma desse contexto.
Se uma etiqueta referenciada não tiver uma tradução para o idioma do contexto de execução de formato que chame o mapeamento de modelos, é utilizado o texto de etiqueta no idioma EN-US.
Formato
Uma expressão de ER de um formato de ER pode ser configurada utilizando etiquetas. Quando este formato é executado para gerar um documento de saída, o contexto da execução inclui um código de idioma. Uma etiqueta de expressão configurada será preenchida com o texto de etiqueta configurado para o idioma desse contexto.
Pode configurar o componente FICHEIRO de um formato de ER para gerar o relatório no idioma preferencial do utilizador.
Se configurar um formato de ER desta forma, o relatório é gerado utilizando o texto correspondente das etiquetas de ER. As ilustrações seguintes mostram exemplos de relatórios para os idiomas de utilizador EN-US e DE-AT.
Se uma etiqueta referenciada não tiver uma tradução para o idioma do contexto de execução de formato, é utilizado o texto de etiqueta no idioma EN-US.
Idioma
Os ER suportam diferentes formas de especificar um idioma para um relatório gerado. No campo Preferências de idioma no separador Formato, pode selecionar os seguintes valores:
Preferência da empresa – Gere um relatório num idioma especificado pela empresa.
Preferência de utilizador – Gere um relatório no idioma preferencial do utilizador.
Definido explicitamente – Gere um relatório num idioma especificado durante a estruturação.
Definido durante a execução – Gere um relatório num idioma especificado durante a execução. Se selecionar este valor, no campo Idioma, configure uma expressão de ER que devolva o código de idioma para o idioma, tal como o idioma do cliente correspondente.
Formatação específica da cultura
Os ER suportam diferentes formas de especificar uma cultura para um relatório gerado. Portanto, a formatação específica da cultura correta pode ser utilizada para a data, a hora e os valores numéricos. Quando estrutura um formato de ER, no separador Formato, no campo Preferências de cultura, pode selecionar um dos seguintes valores para cada componente de formato do tipo Ficheiro\Comum, Ficheiro\Excel, Ficheiro\PDF ou PDF\Merger:
Preferência de utilizador – Formate os valores de acordo com a cultura preferencial do utilizador. Esta cultura é definida no campo Formato de data, hora e número no separador Preferências da página Opções do utilizador.
Definido explicitamente – Formate os valores de acordo com a cultura especificada durante a estruturação.
Definido durante a execução – Formate os valores de acordo com a cultura especificada durante a execução. Se selecionar este valor, no separador Mapeamento, no campo Formato de data, hora e número, configure uma expressão de ER que devolva o código de cultura para a cultura, tal como a cultura do cliente correspondente.
Nota
Um componente de ER para o qual define uma cultura específica pode conter componentes de ER subordinados que foram configurados para preencher um valor de texto. Por predefinição, a cultura do componente principal é utilizada para formatar os valores desses componentes. Pode utilizar as seguintes funções de ER incorporadas para configurar os enlaces para esses componentes e aplicar uma cultura alternativa para a formatação de valor:
Na versão 10.0.20 e posterior, a região dos componentes de formato dos tipos Ficheiro\Comum e Ficheiro\Excel é utilizada para formatar os valores durante a conversão para PDF de um documento gerado.
Tradução
Pode adicionar as etiquetas de ER obrigatórias a um componente editável de ER. Quando uma etiqueta de ER é adicionada, pode ser traduzida de duas formas: manual e automaticamente.
Tradução manual
Quando adiciona uma etiqueta de ER no painel Tradução de texto, pode traduzi-la manualmente para todos os idiomas suportados na instância atual do Finance. Pode selecionar o idioma preferencial no campo Idioma na secção Idioma do sistema ou Idioma do utilizador, em seguida, introduza o texto apropriado no campo Texto traduzido correspondente e selecione Traduzir. Este processo tem de ser repetido para cada idioma obrigatório e todas as etiquetas que adicionar.
Tradução automática
A configuração de um componente de ER é efetuada na versão de rascunho da configuração de ER na qual reside o componente editável de ER.
Conforme descrito anteriormente neste tópico, pode adicionar as etiquetas de ER obrigatórias a um componente editável de ER. Desta forma, pode especificar o texto das etiquetas de ER no idioma EN-US. Em seguida, pode exportar as etiquetas do componente de ER utilizando a função de ER incorporada. Selecione a versão de rascunho de uma configuração de ER que contenha o componente editável de ER e, em seguida, selecione Trocar > Exportar etiquetas.
Pode exportar todas as etiquetas ou as etiquetas para um único idioma que especificou no início da exportação. As etiquetas são exportadas como um ficheiro comprimido que contém ficheiros XML. Cada ficheiro XML contém etiquetas para um único idioma.
Este formato é utilizado para a tradução automática de etiquetas por serviços de tradução externos, tais como o Dynamics 365 Translation Service. Quando recebe as etiquetas traduzidas, pode importá-las de volta para a versão de rascunho de uma configuração de ER que contém os componentes de ER proprietários dessas etiquetas. Selecione a versão de rascunho de uma configuração de ER que contenha o componente editável de ER e, em seguida, selecione Trocar > Carregar etiquetas.
As etiquetas traduzidas serão importadas para a configuração de ER selecionada. As etiquetas traduzidas que existem nesta configuração de ER são substituídas. Se qualquer etiqueta traduzida estiver em falta na configuração de ER, é acrescentada.
Ciclo de vida
As etiquetas de um componente de ER que podem ser editadas são mantidas, em conjunto com outros conteúdos para o componente, na versão apropriada de uma configuração de ER.
As etiquetas de um componente de ER de base podem ser referidas numa versão derivada do componente de ER que criou para introduzir as modificações.
O controlo de versões de ER controla a atribuição de etiquetas a qualquer atributo num componente de ER. As alterações à atribuição de etiquetas são registadas na lista de alterações (delta) de um componente editável de ER criado como uma versão derivada do componente de ER fornecido. Estas alterações serão validadas quando uma versão derivada for novamente baseada para uma nova versão da base.
Funções
A função de ER LISTOFFIELDS incorporada pode aceder às etiquetas de ER configuradas para alguns itens de componentes de ER.
Conforme descrito anteriormente neste tópico, os atributos Etiqueta e Descrição de todos os valores de enumeração de ER de modelo ou formato podem ser associados a uma etiqueta de ER acessível no componente de ER apropriado. Pode configurar uma expressão de ER em que chama a função LISTOFFIELDS utilizando a enumeração de ER como argumento. Esta expressão devolve uma lista que contém um registo para todos os valores de uma enumeração de ER definidos como argumento desta função. Todos os registos contêm o valor de uma etiqueta de ER associada a um valor de enumeração de ER:
- O valor de uma etiqueta de ER associada aos atributos Etiqueta está armazenado no campo Etiqueta do registo devolvido.
- O valor de uma etiqueta de ER associada aos atributos Descrição está armazenado no campo Descrição do registo devolvido.
Desempenho
Quando configura um componente de formato de ER para gerar um relatório no seu idioma preferencial, ou para importar um documento de entrada cujo conteúdo é analisado pelo seu idioma preferencial, recomendamos que ative a funcionalidade Colocar em cache o idioma preferencial do utilizador atual para execuções de ER na área de trabalho Gestão de funcionalidades. Esta funcionalidade ajuda a melhorar o desempenho, em especial, para componentes de formato de ER que contêm várias referências a etiquetas em fórmulas e enlaces de ER e muitas regras de validação para gerar mensagens de utilizador no seu idioma preferencial.
Quando altera o estado de uma versão de configuração de ER de Rascunho para Concluído, se a versão de configuração contiver etiquetas de ER, essas etiquetas são armazenadas na base de dados da aplicação. O esquema de armazenamento depende do estado da funcionalidade Acelerar o armazenamento de etiquetas de ER:
- Se a funcionalidade não estiver ativada, todas as etiquetas são armazenadas no campo LABELXML da tabela ERSOLUTIONVERSIONTABLE como um único fragmento XML.
- Se a funcionalidade estiver ativada, é criado um registo separado para cada idioma na tabela ERSOLUTIONVERSIONLABELSTABLE. O campo CONTEÚDOS desta tabela armazena as etiquetas por idioma como um fragmento XML comprimido.
Recomendamos que ative a funcionalidade Acelerar o armazenamento de etiquetas de ER na área de trabalho Gestão de funcionalidades. Esta funcionalidade ajuda a melhorar a utilização da largura de banda de rede e o desempenho geral do sistema, porque, na maioria dos casos, as etiquetas de ER de um único idioma são utilizadas quando trabalha com uma única configuração de ER.
Para aplicar o esquema de armazenamento selecionado para manter as etiquetas de todas as configurações de ER na instância atual do Finance, conclua os seguintes passos.
- Aceda a Administração da organização > Periódica > Aplicar as etiquetas selecionadas que armazenam o esquema para todas as configurações de ER.
- Selecione OK.