Partilhar via

Estruturar expressões de ER para chamar métodos de classe de aplicação

  • Artigo

Este tópico descreve como reutilizar a lógica de aplicação existente nas configurações de Relatórios Eletrónicos (ER) chamando os métodos necessários de classes de aplicação em expressões de ER. Os valores dos argumentos para chamar classes podem ser definidos dinamicamente em tempo de execução. Por exemplo, os valores podem ser baseados em informações do documento de análise, para garantir a sua correção.

Por exemplo, neste tópico irá estruturar um processo que analisa extratos bancários de entrada para uma atualização dos dados da aplicação. Irá receber os extratos bancários de entrada como ficheiros de texto (.txt) que contêm códigos de Número Internacional de Conta Bancária (IBAN). Como parte do processo de importação dos extratos bancários, tem de validar a correção do código IBAN utilizando a lógica que já está disponível.

Pré-requisitos

Os procedimentos descritos neste tópico destinam-se a utilizadores a quem tenha sido atribuída a função Administrador de sistema ou Programador de Relatórios eletrónicos.

Os procedimentos podem ser concluídos utilizando qualquer conjunto de dados.

Para os completar, tem de transferir e guardar o seguinte ficheiro: SampleIncomingMessage.txt.

Neste tópico, irá criar as configurações de ER necessárias para a empresa de exemplo Litware, Inc. Portanto, antes de completar os procedimentos descritos neste tópico, deve seguir estes passos.

  1. Vá para Administração da organização > Áreas de trabalho > Relatórios eletrónicos.
  2. Na página Configurações de localização, verifique se o fornecedor de configuração da empresa de exemplo Litware, Inc. está disponível e marcada como ativa. Se não vir este fornecedor de configuração, tem de concluir primeiro os passos indicados em Criar fornecedores de configuração e marcá-los como ativos.

Importar uma nova configuração do modelo de ER

  1. Na página Configurações de localização, na secção Fornecedores de configurações, selecione o mosaico do fornecedor de configuração Microsoft.

  2. Selecione Repositórios.

  3. Na página Repositórios de localização, selecione 'Mostrar filtros'.

  4. Para selecionar o registo do repositório Global, adicione um campo de filtro Nome.

  5. No campo Nome, introduza Global. Em seguida, selecione o operador de filtro contém.

  6. Selecione Aplicar.

  7. Selecione Abrir para rever a lista de configurações de ER no repositório selecionado.

  8. Na página Repositório de configurações, na árvore de configuração, selecione Modelo de pagamento.

  9. No Separador Rápido Versões, se o botão Importar estiver disponível, selecione-o e, em seguida, selecione Sim.

    Se o botão Importar não estiver disponível, já importou a versão selecionada da configuração de ER Modelo de pagamento.

  10. Feche a página do Repositório de configurações e, em seguida, feche a página Repositórios de localização.

Adicionar uma nova configuração de formato de ER

Adicione um novo formato de ER para analisar os extratos bancários de entrada em formato TXT.

  1. Na página Configurações de localização, selecione o mosaico Configurações de relatórios.

  2. Na página Configurações, na árvore de configuração no painel esquerdo, selecione Modelo de pagamento.

  3. Selecione Criar configuração.

  4. Na caixa de diálogo pendente, siga estes passos:

    1. No campo Novo, introduza Formato baseado no modelo de dados PaymentModel.
    2. No campo Nome, introduza Formato de importação de extrato bancário (amostra).
    3. No campo Suporta importação de dados, selecione Sim.
    4. Selecione Criar configuração para acabar de criar a configuração.

Estruturar a configuração de formato de ER - Formato

Estruture um formato de ER que represente a estrutura esperada do ficheiro externo em formato TXT.

  1. Para a configuração do formato Formato de importação de extrato bancário (amostra) que adicionou, selecione Estruturador.

  2. Na página Estruturador de formato, na árvore de estrutura de formatos no painel esquerdo, selecione Adicionar raiz.

  3. Na caixa de diálogo apresentada, siga estes passos:

    1. Na árvore, selecione Texto\Sequência para adicionar um componente de formato Sequência.
    2. No campo Nome, introduza Raiz.
    3. No campo Carateres especiais, selecione Nova linha - Windows (CR LF). Com base nesta definição, cada linha no ficheiro de análise será considerada como um registo separado.
    4. Selecione OK.

  4. Selecione Adicionar.

  5. Na caixa de diálogo apresentada, siga estes passos:

    1. Na árvore, selecione Texto\Sequência.
    2. No campo Nome, introduza Linhas.
    3. No campo Multiplicidade, selecione Muitos um. Com base nesta definição, será esperada a presença de pelo menos uma linha no ficheiro de análise.
    4. Selecione OK.

  6. Na árvore, selecione Raiz\Linhas e, em seguida, selecione Adicionar Sequência.

  7. Na caixa de diálogo apresentada, siga estes passos:

    1. No campo Nome, introduza Campos.
    2. No campo Multiplicidade, selecione Exatamente um.
    3. Selecione OK.

  8. Na árvore, selecione Raiz\Linhas\Campos e, em seguida, selecione Adicionar.

  9. Na caixa de diálogo apresentada, siga estes passos:

    1. Na árvore, selecione Texto\Cadeia.
    2. No campo Nome, introduza IBAN. 3.. Selecione OK.

  10. Selecione Guardar.

A configuração está agora configurada para que cada linha no ficheiro de análise contenha apenas o código IBAN.

Configuração do formato Formato de importação de extrato bancário (amostra) na página Estruturador de formato.

Estruturar a configuração do formato de ER – Mapear para um modelo de dados

Estruture um mapeamento de formato de ER que utilize informações do ficheiro de análise para preencher um modelo de dados.

  1. Na página Estruturador de formato, no Painel de Ações, selecione Mapear formato para modelo.

  2. Na página Mapeamento de modelo para origem de dados, no Painel de Ações, selecione Novo.

  3. No campo Definição, selecione BankToCustomerDebitCreditNotificationInitiation.

  4. No campo Nome, introduza Mapear para modelo de dados.

  5. Selecione Guardar.

  6. Selecione Estruturador.

  7. Na página Estruturador de mapeamento de modelos, na árvore Tipos de origem de dados, selecione Dynamics 365 for Operations\Classe.

  8. Na secção Origens de dados, selecione Adicionar raiz para adicionar uma origem de dados que chame a lógica de aplicação existente para validação de códigos IBAN.

  9. Na caixa de diálogo apresentada, siga estes passos:

    1. No campo Nome, introduza Verificar_códigos.
    2. No campo Classe , introduza ou selecione ISO7064.
    3. Selecione OK.

  10. Na árvore Tipos de origens de dados, siga estes passos:

    1. Expanda a origem de dados formato.
    2. Expanda formato\Raiz: Sequência (Raiz).
    3. Expanda formato\Raiz: Sequência (Raiz)\Linhas: Sequência 1..* (Linhas).
    4. Expanda formato\Raiz: Sequência(Raiz)\Linhas: Sequência 1..* (Linhas)\Campos: Sequência 1..1 (Campos).

  11. Na árvore Modelo de dados, siga estes passos:

    1. Expanda o campo Pagamentos do modelo de dados.
    2. Expanda Pagamentos\Conta de Credor (CreditorAccount).
    3. Expanda Pagamentos\Conta de Credor (CreditorAccount)\Identificação.
    4. Expanda Pagamentos\Conta de Credor (CreditorAccount)\Identificação\IBAN.

  12. Siga estes passos para vincular os componentes do formato configurado aos campos do modelo de dados:

    1. Selecione formato\Raiz: Sequência (Raiz)\Linhas: Sequência 1..* (Linhas).
    2. Selecione Pagamentos.
    3. Selecione Vincular. Com base nesta definição, cada linha no ficheiro de análise será considerada como um pagamento único.
    4. Selecione formato\Raiz: Sequência(Raiz)\Linhas: Sequência 1..* (Linhas)\Campos: Sequência 1..1 (Campos)\IBAN: Cadeia(IBAN).
    5. Selecione Pagamentos\Conta de Credor (CreditorAccount)\Identificação\IBAN.
    6. Selecione Vincular. Com base nesta definição, o campo IBAN do modelo de dados será preenchido com o valor do ficheiro de análise.

    Enlace dos componentes de formato aos campos do modelo de dados na página do Estruturador de mapeamento de modelos.

  13. No separador Validações, siga estes passos para adicionar uma regra de validação que mostre uma mensagem de erro para qualquer linha no ficheiro de análise que contenha um código IBAN inválido:

    1. Selecione Novo e, em seguida, selecione Editar condição.
    2. Na página Estruturador de fórmulas, na árvore Origem de dados, expanda a origem de dados Verificar_códigos que representa a classe de aplicação ISO7064 para visualizar os métodos disponíveis desta classe.
    3. Selecione Verificar_códigos\MOD1271_36.
    4. Selecione Adicionar origem de dados.
    5. No campo Fórmula, introduza a seguinte expressão: Check_codes.verifyMOD1271_36(format.Root.Rows.Fields.IBAN).
    6. Selecione Guardar e, em seguida, feche a página.
    7. Selecione Editar mensagem.
    8. Na página do Estruturador de fórmulas, no campo Fórmula , introduza CONCATENATAR ("Foi encontrado código IBAN inválido: ", format.Root.Rows.Fields.IBAN).
    9. Selecione Guardar e, em seguida, feche a página.

    Com base nestas definições, a condição de validação devolverá FALSO para qualquer código IBAN inválido, chamando o método verifyMOD1271_36 existente da classe de aplicação ISO7064. Note que o valor do código IBAN é definido dinamicamente em tempo de execução como o argumento do método de chamada, com base no conteúdo do ficheiro de texto de análise.

    Regra de validação na página do Estruturador de mapeamento de modelos.

  14. Selecione Guardar.

  15. Feche a página do Estruturador de mapeamento de modelos e, em seguida, feche a página Mapeamento de modelo para origem de dados.

Executar o mapeamento de formato

Para efeitos de teste, execute o mapeamento de formato utilizando o ficheiro SampleIncomingMessage.txt que transferiu anteriormente. A saída gerada incluirá dados que são importados do ficheiro de texto selecionado e transportados para o modelo de dados personalizados durante a importação real.

  1. Na página Mapeamento de modelo para origem de dados, selecione Executar.

  2. Na página Parâmetros de relatórios eletrónicos, selecione Procurar, navegue para o ficheiro SampleIncomingMessage.txt que transferiu e selecione-o.

  3. Selecione OK.

  4. Note que a página Mapeamento de modelo para origem de dados mostra uma mensagem de erro sobre um código IBAN inválido.

    Resultado da execução do mapeamento de formato na página Mapeamento de modelo para origem de dados.

  5. Reveja a saída em formato XML que representa os dados que foram importados do ficheiro selecionado e transportados para o modelo de dados. Note que apenas três linhas do ficheiro de texto importado foram processadas sem erros. O código IBAN da linha 4 não é válido e foi ignorado.

    Saída em XML.