Depurar fontes de dados de um formato de relatório eletrônico executado para analisar o fluxo de dados e a transformação
Importante
Algumas ou todas as funcionalidades observadas neste artigo estão disponíveis como parte de uma versão preliminar. O conteúdo e a funcionalidade estão sujeitos a alterações. Para obter informações sobre as versões prévias, consulte Disponibilidade das atualizações do serviço.
Ao configurar uma solução do relatório eletrônico (ER) para gerar documentos de saída, você define os métodos usados para obter os dados do aplicativo e inseri-los na saída gerada. Para tornar o suporte ao ciclo de vida da solução de ER mais eficiente, a sua solução deve consistir em um modelo de dados de ER e seus componentes de mapeamento, além de um formato de ER e seus componentes de mapeamento, para que o mapeamento do modelo seja específico para o aplicativo, enquanto outros componentes permanecem independentes do aplicativo. Portanto, vários componentes do ER podem afetar o processo de inserir dados na saída gerada.
Às vezes, os dados da saída gerada parecem diferentes dos mesmos dados no banco de dados do aplicativo. Nesses casos, será necessário determinar qual componente do ER é responsável pela transformação dos dados. O recurso do depurador da fonte de dados do ER reduz significativamente o tempo e o custo envolvidos nesta investigação. Você pode interromper a execução de um formato de ER e abrir a interface do depurador da fonte de dados. Nela, é possível procurar as fontes de dados disponíveis e selecionar uma fonte de dados individual para execução. Esta execução manual simula a execução da fonte de dados durante a execução real de um formato de ER. O resultado é apresentado em uma página na qual você pode analisar os dados recebidos.
Para ativar o recurso de depuração da fonte de dados, defina a opção Habilitar depuração de dados na execução do formato como Sim nos parâmetros de usuário do ER. Em seguida, você pode iniciar a depuração da fonte de dados enquanto executa o formato de ER para gerar documentos de saída. Você também pode usar a opção Iniciar depuração para iniciar a depuração da fonte de dados para um formato de ER configurado no Designer da operação do ER.
Este artigo fornece diretrizes para iniciar a depuração da fonte de dados para formatos de ER executados. Ele explica como as informações podem ajudar você a entender o fluxo e as transformações de dados. Os exemplos neste artigo usam o processo de negócios para o processamento de pagamentos de fornecedores.
Limitações
O depurador da fonte de dados pode ser usado para acessar os dados de fontes de dados usadas em formatos de ER executados para gerar documentos de saída. Ele não pode ser usado para depurar fontes de dados de formatos de ER criadas para analisar documentos de entrada.
As seguintes configurações de formatos de ER não estão acessíveis no momento para a depuração da fonte de dados:
- Transformações de formatos
- Regras de validação de mapeamento e formato
- Habilitar expressões
- Detalhes da coleta de dados na memória
Pré-requisitos
Para concluir os exemplos deste artigo, você deve ter acesso a uma das seguintes funções:
- Desenvolvedor de relatório eletrônico
- Consultor funcional de relatório eletrônico
- Administrador do sistema
A empresa deve ser definida como DEMF.
Siga as etapas no Apêndice 1 deste artigo para baixar os componentes da solução do Microsoft ER necessários para processar os pagamentos de fornecedores.
Siga as etapas no Apêndice 2 deste artigo para preparar o recurso Contas a pagar para o processamento de pagamentos de fornecedores usando a solução de ER que você obterá por download.
Processar um pagamento do fornecedor para obter um arquivo de pagamento
Siga as etapas no Apêndice 3 deste artigo para processar os pagamentos de fornecedores.
Baixe e salve o arquivo zip no computador local.
Extraia o arquivo de pagamento ISO20022 Credit transfer.xml do arquivo zip.
Abra o arquivo de pagamento extraído usando o visualizador de arquivos XML.
No arquivo de pagamento, o código do número da conta bancária internacional (IBAN) da conta bancária do fornecedor não contém espaços. Portanto, difere do valor inserido na página Contas bancárias.
Você pode usar o depurador da fonte de dados do ER para saber qual componente da solução de ER é usado para truncar espaços no código IBAN.
Ativar depuração da fonte de dados
Acesse Administração da organização>Relatório eletrônico>Configurações.
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.
Defina a opção Habilitar depuração de dados na execução do formato como Sim.
Observação
Esse parâmetro é específico do usuário e da empresa.
Processar um pagamento de fornecedor para depuração
Siga as etapas no Apêndice 3 deste artigo para processar os pagamentos de fornecedores.
Na caixa de mensagem, selecione Sim para confirmar que deseja interromper o processamento de pagamentos de fornecedores e iniciar a depuração da fonte de dados na página Depurar fontes de dados.
Depurar fontes de dados usadas no processamento de pagamentos
Depurar o mapeamento de modelos
Na página Depurar fontes de dados, no Painel de Ações, selecione Mapeamento de modelo para iniciar a depuração deste componente de ER.
No painel da fonte de dados à esquerda, selecione a fonte de dados $notSentTransactions e selecione Ler todos os registros.
Você pode selecionar Ler 1 registro, Ler 10 registros, Ler 100 registros ou Ler todos os registros para forçar o número apropriado de registros a serem lidos na fonte de dados selecionada. Dessa forma, você pode simular o acesso à fonte de dados do formato de ER em execução.
No painel de dados à direita, selecione Expandir tudo.
Você pode ver que a fonte de dados selecionada do tipo Lista de registros contém um único registro.
Expanda a fonte de dados $notSentTransactions e selecione o método vendBankAccountInTransactionCompany() aninhado.
Expanda o método vendBankAccountInTransactionCompany() e selecione o campo IBAN aninhado.
Selecione Obter valor.
Você pode selecionar Obter valor para forçar a leitura do valor de um campo selecionado da fonte de dados selecionada. Dessa forma, você pode simular o acesso a esse campo do formato de ER em execução.
Selecione Expandir tudo.
Como pode ver, o mapeamento de modelos não é responsável pelos espaços truncados, pois o código IBAN retornado para a conta bancária do fornecedor inclui espaços. Portanto, é necessário continuar a depuração da fonte de dados.
Depurar o mapeamento de formato
Na página Depurar fontes de dados, no Painel de Ações, selecione Mapeamento de formato para continuar a depuração deste componente de ER.
Selecione a fonte de dados $PaymentByDebtor e selecione Ler todos os registros.
Expanda $PaymentByDebtor.
Expanda $PaymentByDebtor.Lines e selecione Ler todos os registros.
Expanda $PaymentByDebtor.Lines.CreditorAccount.
Expanda $PaymentByDebtor.Lines.CreditorAccount.Identification e selecione $PaymentByDebtor.Lines.CreditorAccount.Identification.IBAN.
Selecione Obter valor.
Selecione Expandir tudo.
Como pode ver, as fontes de dados do mapeamento de formato não são responsáveis pelos espaços truncados, pois o código IBAN retornado para a conta bancária do fornecedor inclui espaços. Portanto, é necessário continuar a depuração da fonte de dados.
Depurar o formato
Na página Depurar fontes de dados, no Painel de Ações, selecione Formato para continuar a depuração deste componente de ER.
Expanda os elementos de formato para selecionar ISO20022CTReports>XMLHeader>Documento>CstmrCdtTrfInitn>PmtInf e, em seguida, selecionar Ler todos os registros.
Expanda os elementos de formato para selecionar ISO20022CTReports>XMLHeader>Documento>CstmrCdtTrfInitn>PmtInf>CdtTrfTxInf e, em seguida, selecionar Ler todos os registros.
Expanda os elementos de formato para selecionar ISO20022CTReports>XMLHeader>Documento>CstmrCdtTrfInitn>PmtInf>CdtTrfTxInf>CdtrAcct>Id>IBAN>BankIBAN e, em seguida, selecionar Obter valor.
Selecione Expandir tudo.
Como pode ver, a associação de formato não é responsável pelos espaços truncados, pois o código IBAN retornado para a conta bancária do fornecedor inclui espaços. Portanto, o elemento BankIBAN está configurado para usar uma transformação de formato que trunca os espaços.
Feche o depurador da fonte de dados.
Revise as transformações de formato
Acesse Administração da organização>Relatório eletrônico>Configurações.
Na página Configurações, selecione Modelo de pagamento>Transferência de crédito ISO20022.
Selecione Designer e expanda os elementos para selecionar Documento>CstmrCdtTrfInitn>PmtInf>CdtTrfTxInf>CdtrAcct>Id>IBAN>BankIBAN.
Como pode ver, o elemento BankIBAN está configurado para usar a transformação remover não alfanuméricos.
Selecione a guia Transformações.
Como pode ver, a transformação remover não alfanumérico está configurada para usar uma expressão que trunca os espaços da cadeia de texto fornecida.
Iniciar depuração no Designer da operação
Ao configurar uma versão de rascunho do formato de ER que pode ser executado diretamente do Designer da operação, você pode acessar o depurador da fonte de dados selecionando Iniciar Depuração no Painel de Ações.
Os componentes do mapeamento de formato e do formato de ER que estão sendo editados estão disponíveis para depuração.
Iniciar depuração no Designer do mapeamento de modelos
Ao configurar um mapeamento de modelos de ER que pode ser executado diretamente da página Mapeamento de modelos, você pode acessar o depurador da fonte de dados selecionando Iniciar Depuração no Painel de Ações.
O componente de mapeamento de modelos do mapeamento de ER que está sendo editado está disponível para depuração.
Apêndice 1: Obter uma solução de ER
Baixar uma solução de ER
Se deseja usar uma solução de ER para gerar um arquivo de pagamento eletrônico para um pagamento de fornecedor que já foi processado, você pode baixar o formato de pagamento de ER Transferência de crédito ISO20022 disponível na biblioteca de Ativos compartilhados no Microsoft Dynamics Lifecycle Services (LCS) ou no repositório Global.
Além do formato de ER selecionado, as configurações a seguir devem ser importadas automaticamente para a instância do Microsoft Dynamics 365 Finance como parte da solução de ER Transferência de crédito ISO20022:
- Configuração do modelo de dados de ER do Modelo de pagamento
- Configuração do formato de ER de Transferência de crédito ISO20022
- Mapeamento de modelo de pagamento 1611 Configuração de mapeamento de modelo de ER
- Configuração do mapeamento de modelos de ER Mapeamento de modelos de pagamento para o destino ISO20022
Você pode encontrar essas configurações na página Configurações da estrutura do ER (Administração da organização>Relatório eletrônico>Configurações).
Se qualquer uma das configurações listadas estiver ausente na árvore de configuração, será necessário baixá-la manualmente da biblioteca de Ativos compartilhados do LCS, da mesma forma como baixou o formato de pagamento de ER Transferência de crédito ISO20022.
Analisar a solução de ER baixada
Revisar o mapeamento de modelos
Acesse Administração da organização>Relatório eletrônico>Configurações.
Selecione Modelo de pagamento>Mapeamento de modelos de pagamento 1611.
Selecione Designer.
Selecione o registro de mapeamento Mapeamento de modelos de pagamento ISO20022 CT.
Selecione Designer e revise o mapeamento de modelos aberto.
Observe que o campo Pagamentos do modelo de dados está vinculado à fonte de dados $notSentTransactions que retorna a lista de linhas de pagamento de fornecedores que estão sendo processadas.
Revisar o mapeamento de formato
Acesse Administração da organização>Relatório eletrônico>Configurações.
Selecione Modelo de pagamento>Transferência de crédito ISO20022.
Selecione Designer.
Na guia Mapeamento, revise o mapeamento de formato exibido.
Observe que o elemento Documento>CstmrCdtTrfInitn>PmtInf do arquivo ISO20022CTReports>XMLHeader está associado à fonte de dados $PaymentByDebtor configurada para agrupar registros do campo Pagamentos do modelo de dados.
Revisar o formato
Acesse Administração da organização>Relatório eletrônico>Configurações.
Selecione Modelo de pagamento>Transferência de crédito ISO20022.
Selecione Designer e revise o formato de modelos aberto.
Observe que o elemento do formato em Documento>CstmrCdtTrfInitn>PmtInf>CdtTrfTxInf>CdtrAcct>Id>IBAN>BankIBAN está configurado para inserir o código IBAN da conta do fornecedor no arquivo de pagamento.
Apêndice 2: Configurar Contas a pagar
Modificar uma propriedade do fornecedor
- Vá para Contas a pagar>Fornecedores>Todos os fornecedores.
- Selecione um fornecedor DE-01002 e, no Painel de Ações, na guia Fornecedor, no grupo Configurar, selecione Contas bancárias.
- Na FastTab Identificação, no campo IBAN, insira GB33 BUKB 2020 1555 5555 55.
- Selecione Salvar.
Configurar um meio de pagamento
- Acesse Contas a pagar>Configuração de pagamento>Métodos de pagamento.
- Selecione o método de pagamento SEPA CT.
- Na FastTab Formatos de arquivo, na seção Formatos de arquivo, defina a opção Formato de exportação eletrônico genérico como Sim.
- No campo Exportar configuração de formato, selecione o formato de ER Transferência de crédito ISO20022.
- Selecione Salvar.
Adicionar um pagamento de fornecedor
- Acesse Contas a pagar>Pagamentos>Diário de pagamentos do fornecedor.
- Adicione um novo diário de pagamento.
- Selecione Linhas e adicione uma nova linha de pagamento.
- No campo Conta, selecione o fornecedor DE-01002.
- No campo Débito, insira um valor.
- No campo Método de pagamento, selecione SEPA CT.
- Selecione Salvar.
Apêndice 3: Processar pagamento do fornecedor
- Acesse Contas a pagar>Pagamentos>Diário de pagamentos do fornecedor.
- Na página Diário de pagamentos do fornecedor, selecione o diário de pagamento criado anteriormente e, em seguida, selecione Linhas.
- Selecione a linha de pagamento e, depois, Status do pagamento>Não.
- Selecione Gerar pagamentos.
- No campo Método de pagamento, selecione SEPA CT.
- No campo Conta bancária, selecione DEMF OPER.
- Na caixa de diálogo Gerar pagamentos, selecione OK.
- Na caixa de diálogo Parâmetros de relatório eletrônico, selecione OK.