Gerenciar o ciclo de vida da configuração de Relatório eletrônico (ER)

Este artigo descreve como gerenciar o ciclo de vida de configurações do Relatório eletrônico (ER) para o Dynamics 365 Finance.

Visão geral

O relatório eletrônico (ER) é um mecanismo que oferece suporte a documentos eletrônicos específicos do país/região e exigidos pela regulamentação. Geralmente, o ER considera uma capacidade de executar as seguintes tarefas para um único documento eletrônico. Para obter mais detalhes, consulte Visão geral de ER (Relatórios eletrônicos).

• Projete um modelo para um documento eletrônico:

  • Identifique as fontes de dados necessárias que podem ser apresentadas no documento:

    • Os dados subjacentes, como tabelas de dados, entidades de dados e classes.
    • Propriedades específicas do processo, como data e hora da execução e fuso horário.
    • Parâmetros de entrada do usuário, especificados pelo usuário final em tempo de execução.

  • Defina os elementos do documento necessários e a topologia deles para especificar o formato de um documento final.

  • Configure o fluxo de dados desejado das fontes de dados selecionadas para elementos do documento definido via associações da fonte de dados aos componentes de formato do documento e especifique a lógica de controle de processos.

• Crie um modelo disponível de forma que ele possa ser usado em outras instâncias:

  • Transforme um modelo de documento criado em uma configuração de ER e exporte a configuração da instância atual do aplicativo como um pacote XML que possa ser armazenado localmente ou no Lifecycle Services (LCS).
  • Transforme uma configuração de ER em um modelo de documento do aplicativo.
  • Importe um pacote XML armazenado localmente ou em LCS para a instância atual.

• Personalize o modelo de um documento eletrônico:

  • Traga um modelo de LCS para a instância atual como uma configuração de ER.
  • Crie uma versão personalizada de uma configuração do ER e mantenha uma referência à versão base.

• Integre um modelo a um processo comercial específico, para que ele fique disponível no aplicativo:

  • Defina as configurações para que o aplicativo comece a usar uma configuração de ER ao fazer referência a essa configuração em um parâmetro relacionado ao processo Por exemplo, mencione a configuração de ER em um método Pagamento de contas a pagar específico para gerar uma mensagem de pagamento eletrônico para o processamento de faturas.

• Use um modelo em um processo de negócios específico:

  • Executar uma configuração de ER em um processo comercial específico. Por exemplo, para gerar uma mensagem de pagamento eletrônico para o processamento de faturas quando um método de pagamento que faz referência à configuração de ER é selecionado.

Conceitos

As funções e as atividades relacionadas a seguir estão associadas ao ciclo de vida de configuração de ER.

Ciclo de vida de desenvolvimento de configuração de ER

Pelos seguintes motivos relacionados a ER, é recomendável projetar configurações de ER no ambiente de desenvolvimento como uma instância separada de finanças e operações:

• Os usuários nas funções Desenvolvedor de relatório eletrônico ou Consultor funcional de relatório eletrônico podem editar configurações e executá-las para fins de teste. Este cenário pode ocasionar chamadas de métodos de classes e de tabelas que podem prejudicar os dados de negócios e o desempenho do uso da instância.
• As chamadas de métodos de classes e de tabelas como fontes de dados de ER das configurações do ER não serão restringidas por pontos de entrada e pelo conteúdo registrado da empresa. Portanto, os dados de negócios confidenciais podem ser acessados pelos usuários que desempenham a função Desenvolvedor de relatório eletrônico ou Consultor funcional de relatório eletrônico.

As configurações de ER criadas no ambiente de desenvolvimento podem ser carregadas no ambiente de teste da avaliação da configuração (integração adequada do processo, exatidão de resultados e desempenho) e do controle de qualidade, como exatidão dos direitos de acesso orientados a funções e diferenciação de direitos. Os recursos que permitem a troca de configuração de ER podem ser usados com essa finalidade. As configurações de ER comprovadas podem ser carregadas no LCS para compartilhá-las com assinantes de serviço ou podem ser importadas para o ambiente de produção para uso interno.

Consideração de persistência de dados

Você pode importar individualmente versões diferentes de uma configuração ER para sua instância do Finance. Quando uma nova versão de uma configuração ER é importada, o sistema controla o conteúdo da versão de rascunho dessa configuração:

• Quando a versão importada for anterior à versão mais atual dessa configuração na instância atual do Finance, o conteúdo da versão de rascunho dessa configuração permanecerá inalterado.
• Quando a versão importada for mais atual do que outras versões dessa configuração na instância atual do Finance, o conteúdo da versão importada será copiado para a versão de rascunho dessa configuração para que você continue editando a última versão concluída.

Se essa configuração pertencer ao provedor de configuração ativado no momento, a versão de rascunho dessa configuração ficará visível na FastTab Versões da página Configurações (Administração organizacional>Relatório eletrônico>Configurações). Você pode selecionar a versão de rascunho da configuração e modificar o conteúdo usando o designer de ER relevante. Após você editar a versão de rascunho de uma configuração ER, o conteúdo não coincidirá mais ao conteúdo da versão mais atual dessa configuração na instância atual do Finance. Para evitar a perda de alterações, o sistema exibe um erro informando que a importação não pode continuar porque a versão dessa configuração é posterior à versão mais atual dessa configuração na instância atual do Finance. Quando isso ocorre, por exemplo, com a configuração de formato X, o erro A versão de formato 'X' não foi concluída é exibido.

Para desfazer as alterações apresentadas na versão de rascunho, selecione a versão concluída mais atual ou compartilhada da configuração ER no Finance na FastTab Versões e, depois, selecione a opção Obter esta versão. O conteúdo da versão selecionada é copiado na versão de rascunho.

Consideração de aplicabilidade

Ao criar uma versão de uma configuração ER, você pode definir sua dependência em outros componentes de software. Essa etapa é considerada um pré-requisito para controlar o download desta versão da configuração de um repositório de ER ou um arquivo XML externo, e para qualquer outro uso da versão. Ao tentar importar uma nova versão de uma configuração ER, o sistema usa os pré-requisitos configurados para controlar se a versão pode ser importada.

Em alguns casos, você pode exigir que o sistema ignore os pré-requisitos configurados ao importar novas versões das configurações ER. Para que o sistema ignore os pré-requisitos durante a importação, siga as etapas a seguir.

1. Acesse Administração da organização>Relatório eletrônico>Configurações.

2. Na página Configurações, no Painel Ação, na guia Configurações, no grupo Configurações avançadas, selecione Parâmetros de usuário.

3. Defina a opção Ignorar atualizações de produto e verificação de pré-requisitos de versão durante importação como Sim.

   Observação

   Esse parâmetro é específico do usuário e da empresa.

Dependências de outros componentes

As configurações de ER podem ser definidas como dependentes de outras configurações. Por exemplo, você pode importar uma configuração do modelo de dados ER do repositório global para sua instância do Microsoft Regulatory Configuration Services (RCS) ou do Dynamics 365 Finance e criar uma nova configuração de formato para ER que é derivada da configuração do modelo de dados ER importada. A configuração do formato ER derivado dependerá da configuração do modelo de dados de base ER.

Quando terminar de criar o formato, você poderá alterar o status da versão inicial da configuração do formato ER de Rascunho para Concluído. Em seguida, você pode compartilhar a versão concluída da configuração do formato ER com sua publicação no repositório global. Em seguida, você pode acessar o repositório global de qualquer instância de nuvem do RCS ou Finance. Em seguida, você pode importar qualquer versão de configuração do ER aplicável ao aplicativo do repositório global para o aplicativo.

Com base na dependência de configuração, quando você seleciona a configuração do formato ER no repositório global para importá-la para uma instância do RCS ou Finance recentemente instalada, a configuração do modelo de dados de base ER é automaticamente encontrada no repositório global e importada com a configuração de formato ER selecionada como a configuração básica.

Você também pode exportar sua versão de configuração de formato ER da sua instância RCS ou Finance atual e armazená-la localmente como um arquivo XML.

Nas versões do Finance antes da versão 10.0.29, ao tentar importar a versão de configuração do formato ER desse arquivo XML ou de qualquer outro repositório que não seja o repositório global em uma instância do RCS ou Finance recentemente implantada que ainda não tenha nenhuma configuração de ER, a seguinte exceção será lançada para informá-lo de que não é possível obter uma definição básica:

Referências não resolvidas mantidas
A referência do objeto "<nome da configuração importada>" para o objeto "Base" (<identificador global exclusivo da configuração base ausente><versão da configuração base ausente>) não pode ser estabelecida

Na versão 10.0.29 e mais recente, quando você tenta fazer a mesma importação de configuração, se uma configuração básica não puder ser encontrada na instância do aplicativo atual ou no repositório da fonte que você está usando no momento (se aplicável), a estrutura ER tentará automaticamente encontrar o nome da configuração básica ausente no cache do repositório global. Em seguida, ele apresentará o nome e o identificador global exclusivo (GUID) da configuração básica ausente no texto da exceção que é lançada.

Referências não resolvidas mantidas
A referência do objeto ''<nome da configuração importada>" para o objeto "Base'' (<nome da configuração base ausente><identificador global exclusivo do nome da configuração base ausente>,<versão da configuração base ausente>) não pode ser estabelecida

Você pode usar o nome fornecido para encontrar a configuração básica e, depois, importá-la manualmente.

Recursos adicionais

Visão geral de Relatório Eletrônico (ER)

Definir a dependência de configurações ER em outros componentes