ER Criar configurações necessárias para importar dados a partir de um ficheiro externo

Os passos seguintes explicam como um utilizador na função de Administrador de sistema ou de Programador de relatórios eletrónicos pode estruturar configurações de Relatórios eletrónicos (ER) para importar dados para a aplicação a partir de um ficheiro externo. Neste exemplo, irá criar as configurações de ER necessárias para a empresa de exemplo, Litware, Inc. Para concluir estes passos, tem primeiro de concluir os passos indicados no Guia de tarefas, "ER Criar um fornecedor de configuração e marcá-lo como ativo". Estes passos podem ser concluídos utilizando o conjunto de dados USMF. Também tem de transferir e guardar os seguintes ficheiros localmente:

Descrição do conteúdo	Nome do ficheiro
Configuração do modelo de dados de ER - 1099	1099model.xml
Configuração do formato de ER - 1099	1099format.xml
Amostra do documento de entrada em formato XML	1099entries.xml
Amostra do livro para gerir dados do documento de entrada	1099entries.xlsx

O ER oferece aos utilizadores de empresa a capacidade de configurar o processo de importação de ficheiros de dados externos para tabelas em formato XML ou TXT. Em primeiro lugar, um modelo de dados abstrato e uma configuração de modelo de dados de ER têm de ser estruturados para representar os dados que está a importar. Em seguida, tem de definir a estrutura do ficheiro que está a importar e o método que utilizará para migrar os dados do ficheiro para o modelo de dados abstratos. A configuração do formato de ER que é mapeada para o modelo de dados estruturado tem de ser criada para esse modelo de dados abstrato. Em seguida, a configuração do modelo de dados tem de ser expandida com um mapeamento que descreva como os dados importados são persistentes como dados do modelo de dados abstratos e como são utilizados para atualizar tabelas. A configuração do modelo de dados de ER tem de ser anexada a um novo mapeamento de modelo que descreva o vínculo do modelo de dados aos destinos da aplicação.

O cenário a seguir mostra as capacidades de importação de dados de ER. Isto inclui transações de fornecedor que são monitorizadas externamente e depois importadas para serem reportadas posteriormente na liquidação do fornecedor para 1099.

Adicionar uma nova configuração de modelo de ER

1. Vá para Administração da organização > Áreas de trabalho > Relatórios eletrónicos.

   Verifique se o fornecedor de configuração para a empresa de exemplo, "Litware, Inc.", está disponível e marcado como ativo. Caso não veja este fornecedor de configuração, primeiro tem de concluir os passos indicados no procedimento "Criar um fornecedor de configuração e marcá-lo como ativo".

2. Clique em Configurações de relatórios.

   Em vez de criar um novo modelo para suportar a importação de dados, carregue o ficheiro, 1099model.xml, que transferiu anteriormente. Este ficheiro contém o modelo de dados personalizado das transações dos fornecedores. Este modelo de dados está mapeado para os componentes de dados que estão na entidade de dados AOT.

3. Clique em Trocar.

4. Clique em Carregar a partir do ficheiro XML.

   Clique em Procurar e navegue para o ficheiro 1099model.xml que transferiu previamente.

5. Clique em OK.

6. Na árvore, selecione "Modelo de pagamentos 1099".

Rever as definições do modelo de dados

1. Clique em Estruturador.

   Este modelo foi estruturado para representar as transações dos fornecedores do ponto de vista empresarial e está separado da implementação.

2. Na árvore, expanda "1099-MISC".

3. Na árvore, selecione "1099-MISC\Transações".

4. Na árvore, expanda "1099-MISC\Transações".

   O elemento Transações deste modelo representa transações individuais. Os elementos subordinados são utilizados para especificar os detalhes necessários, como conta de fornecedor e data de transação, para cada transação.

5. Feche a página.

Adicionar uma nova configuração de formato de ER que suporte importação de dados

Os passos nesta subtarefa mostram como uma nova configuração de formato pode ser criada para gerir a importação de dados a partir de ficheiros externos.

1. Clique em Criar configuração para abrir a caixa de diálogo pendente.

2. No campo Novo, introduza "Formato baseado no modelo de dados Modelo de pagamentos 1099".

3. Selecione Sim no campo Suporta importação de dados.

4. Prima a tecla ESC para fechar esta página.

   Em vez de criar um novo formato de ER para suportar a importação de dados, carregue o ficheiro 1099format.xml que transferiu previamente. Este ficheiro contém a estrutura definida do ficheiro que está a importar e o mapeamento da estrutura para o modelo de dados personalizado das transações de fornecedores.

5. Clique em Trocar.

6. Clique em Carregar a partir do ficheiro XML. Clique em Procurar e navegue para o ficheiro 1099format.xml que transferiu previamente.

7. Clique em OK.

8. Na árvore, expanda "Modelo de pagamentos 1099".

9. Na árvore, selecione "Modelo de pagamentos 1099\Formato para importar transações de fornecedores".

Rever definições de formato

1. Clique em Estruturador.

2. Ative "Mostrar detalhes".

3. Clique em Expandir/fechar.

4. Clique em Expandir/fechar.

   O formato estruturado representa a estrutura esperada do ficheiro externo. Este ficheiro tem de estar em formato XML e ter o elemento raiz da liquidação. Cada transação de fornecedor é representada pelo elemento da transação que é definido como tendo uma multiplicidade de zero para muitos. Isto significa que o ficheiro recebido pode conter de zero a várias transações. Os elementos aninhados do elemento "transação" representam atributos de uma única transação. Tenha em atenção que todos os atributos, exceto o país/região, estão marcados como obrigatórios, o que significa que é necessário tê-los no ficheiro de importação.

Rever as definições do mapeamento de formato para o modelo de dados

1. Clique em Mapear formato para modelo.

   O mapeamento "Para importar transações de fornecedores" contém as regras de transferência de dados do ficheiro XML recebido para a parte selecionada do modelo de dados personalizado, que é definido selecionando a definição 1099-MISC.

2. Clique em Estruturador.

3. Ative "Mostrar detalhes".

4. Na árvore, expanda "formato: Registo".

5. Na árvore, selecione "formato: Registo".

   Tenha em atenção que o formato estruturado é apresentado aqui como componente de origem de dados.

6. Na árvore, expanda format: Record\*settlement: XML Element 1..1 (settlement): Record.

7. Na árvore, expanda format: Record\*settlement: XML Element 1..1 (settlement): Record\transaction: XML Element 0..* (transaction): Record list.

8. Na árvore, expanda format: Record\*settlement: XML Element 1..1 (settlement): Record\transaction: XML Element 0..* (transaction): Record list\*vendor: XML Element 1..1 (vendor): Record.

9. Na árvore, expanda format: Record\*settlement: XML Element 1..1 (settlement): Record\transaction: XML Element 0..* (transaction): Record list\country: XML Element 0..1 (country): Record.

10. Na árvore, selecione format: Record\*settlement: XML Element 1..1 (settlement): Record\transaction: XML Element 0..* (transaction): Record list\*vendor: XML Element 1..1 (vendor): Record.

    Tenha em atenção que a apresentação de elementos de formato obrigatórios e opcionais é diferente no componente da origem de dados do "formato" predefinido.

11. Na árvore, expanda "Transações: Record list= format.settlement.'$enumerated".

    Tenha em atenção que os elementos do formato que define a estrutura do ficheiro importado estão dependentes dos elementos do modelo de dados personalizado. Com base nestes vínculos, o conteúdo do ficheiro XML importado será armazenado durante o runtime no modelo de dados existente. Preste atenção ao vínculo do elemento de país/região. Para qualquer elemento de transação no ficheiro recebido que não tenha esse elemento, o código de país predefinido "EUA" será povoado no modelo de dados.

12. Clique no separador Validações.

    Este mapeamento de formato pode conter uma lógica definida pelo utilizador para validar a precisão dos dados importados do ponto de vista empresarial. Por exemplo, com base na definição, para qualquer transação no ficheiro de importação sem um código de país definido, uma mensagem de aviso será gerada no Registo de informações para informar o utilizador sobre o caso e indicar o número de sequência da transação.

13. Feche a página.

Executar o mapeamento de formato para o modelo de dados

Execute este mapeamento de formato para fins de teste. Utilize o ficheiro 1099entries.xml que transferiu anteriormente. Pode exportar este ficheiro a partir do livro 1099entries.xlsx que é utilizado para gerir transações de fornecedores. A saída gerada será importada a partir do ficheiro XML selecionado e povoará o modelo de dados personalizados na importação real.

1. Clique em Executar.

   Clique em Procurar e navegue para o ficheiro 1099entries.xml que transferiu anteriormente.

2. Clique em OK.

   Tenha em atenção a mensagem de aviso sobre um código de país em falta para uma transação no ficheiro importado.

   Reveja a saída em formato XML que representa os dados que foram importados do ficheiro selecionado e migrados para o modelo de dados.

3. Feche a página.

4. Feche a página.

Rever as definições do mapeamento de modelo para os destinos

1. Na árvore, selecione "Modelo de pagamentos 1099".

2. Clique em Estruturador.

3. Clique em Mapear modelo para origem de dados.

   O mapeamento Para importação de transações manuais 1099 foi definido com o tipo Para direção de destino. Isto significa que foi introduzido para suportar a importação de dados e contém a definição de regras que definem a forma como o ficheiro externo importado e persistente como dados do modelo de dados é utilizado para atualizar tabelas na aplicação.

4. Clique em Estruturador.

5. Na árvore, expanda "modelo: Modelo de dados do Modelo de pagamentos 1099".

6. Na árvore, expanda "modelo: Modelo de dados do Modelo de pagamentos 1099\Transações: Lista de registos".

   Tenha em atenção que o modelo estruturado é apresentado aqui como elemento de origem de dados. Durante o runtime, conterá os dados que são importados a partir do ficheiro externo. Foram adicionadas várias tabelas como elementos de origem de dados para garantir que os dados importados estão em conformidade com os dados da aplicação atual, incluindo se a conta do fornecedor da transação de importação está disponível no sistema, se a combinação de códigos de país/região e estado de importação existe, etc.

7. Na árvore, selecione "modelo: Modelo de dados do Modelo de pagamentos 1099\Transações: Lista de registos$failed: Campo calculado = IF(OR(ISEMPTY(model.Transactions.'$refs'.vendor), ISEMPTY(model.Transactions.'$refs'.vendor1099), ISEMPTY(model.Transactions.'$refs'.box1099), ISEMPTY(model.Transactions.'$refs'.country), ISEMPTY(model.Transactions.'$refs'.state), ISEMPTY(model.Transactions.'$refs'.location)), true, false): Booleano".

8. Clique em Editar.

9. Clique em Editar fórmula.

   Quando pelo menos uma validação falha para uma única transação importada, esta transação será marcada como tendo falhado pelo atributo da origem de dados "$failed".

10. Feche a página.

11. Clique em Cancelar.

12. Na árvore, selecione "tax1099trans: Table 'VendSettlementTax1099' records= model.Validated".

13. Clique em Editar destino.

    Este destino de ER foi adicionado para especificar como os dados importados atualizarão as tabelas da aplicação. Neste caso, foi selecionada a tabela de dados VendSettlementTax1099. Como a ação de registo Inserir foi selecionada, as transações importadas serão inseridas na tabela VendSettlementTax1099. Tenha em atenção que um único mapeamento de modelo pode conter vários destinos. Isto significa que os dados importados podem ser utilizados para atualizar várias tabelas da aplicação em simultâneo. Tabelas, vistas e entidades de dados podem ser utilizadas como destinos de ER.

    Se o mapeamento for chamado a partir de um ponto na aplicação (como um botão ou item de menu) que foi especificamente estruturado para esta ação, o destino de ER deve ser marcado como o ponto de integração. Neste exemplo, é o ponto ERTableDestination#VendSettlementTax1099.

14. Clique em Cancelar.

15. Clique em Mostrar tudo.

16. Clique Mostrar apenas mapeados.

17. Na árvore, expanda "tax1099trans: Table 'VendSettlementTax1099' records= model.Validated'".

    Tenha em atenção que o elemento de origem de dados que contém as únicas transações validadas está dependente do destino criado. Pode filtrar as transações importadas para ignorar as que são incompatíveis com os dados das aplicações.

18. Na árvore, selecione "failed: Table 'VendSettlementTax1099Entity' records= model.Failed".

19. Clique no separador Validações.

    Este mapeamento de modelo pode conter uma lógica definida pelo utilizador para validar a exatidão dos dados importados a partir dos dados da aplicação existentes. Por exemplo, com base na definição atual, para qualquer transação no ficheiro importado com uma conta de fornecedor que não está no sistema, uma mensagem de aviso será gerada para informar o utilizador e indicar o código de conta do fornecedor incorreto.

    Tenha em atenção que a opção Ação pós-validação pode ser utilizada para cada validação, para especificar se o processo de importação tem de ser continuado ou parado, bem como se as inserções/atualizações já realizadas podem ser mantidas ou revertidas.

20. Clique Mostrar apenas mapeados.

21. Clique em Mostrar tudo.

22. Feche a página.

    Execute este mapeamento de modelo para testar o formato e os mapeamentos de modelos estruturados. Utilize o ficheiro 1099entries.xml. Os dados do ficheiro selecionado serão importados para o sistema.

23. Clique em Executar.

    Tenha em atenção que a caixa de diálogo não contém perguntas adicionais sobre o mapeamento de formato que tem de ser utilizado para analisar o ficheiro importado e, em seguida, migrar os dados para o modelo de dados. Isto ocorre porque atualmente só existe um formato que utiliza este modelo, que é marcado como estruturado para suportar a importação de dados.

    Defina o ID do voucher para diferenciar as transações importadas de outras transações que já possam ter sido introduzidas manualmente ou importadas.

24. No campo Introduzir id do voucher, escreva "IMPORT-001".

    Procure o ficheiro "1099entries.xml".

25. Clique em OK.

    A lista de avisos gerados fornece informações sobre contas de fornecedores incorretas, um código de caixa do imposto 1099 incorreto, códigos de país/região em falta, etc. Compare esta lista de avisos com o conteúdo incluído no ficheiro XML de execução.

26. Feche a página.

27. Feche a página.

28. Feche a página.

29. Feche a página.

30. Vá para Contas a pagar > Tarefas periódicas > Imposto 1099 > Liquidação do fornecedor para 1099s.

    Este formulário mostra as transações cumulativas na tabela Tax1099Summary que foram criadas com base em transações importadas.

31. No campo Data de início, defina a data como "01-01-2000".

32. Clique em Transações manuais 1099.

    Este formulário contém a lista de transações que foram adicionadas manualmente e as que acabamos de importar.

33. Abra o filtro da coluna Voucher.

34. Introduza um valor de filtro igual a "IMPORT-001" no campo "Voucher" utilizando o operador de filtro "começa por".

Rever a relação entre mapeamentos de modelo e de formato

1. Feche a página.

2. Feche a página.

3. Vá para Administração da organização > Áreas de trabalho > Relatórios eletrónicos.

4. Clique em Configurações de relatórios.

5. Na árvore, selecione "Modelo de pagamentos 1099".

   Vamos assumir que quer suportar a importação dos mesmos dados, mas a partir de um formato de ficheiro .TXT.

6. Clique em Criar configuração para abrir a caixa de diálogo.

7. No campo Novo, introduza "Formato baseado no modelo de dados Modelo de pagamentos 1099".

8. No campo Nome, escreva "Importar dados do ficheiro TXT".

9. Selecione Sim no campo Suporta importação de dados.

10. Clique em Criar configuração.

11. Clique em Estruturador.

12. Clique em Mapear formato para modelo.

13. Clique em Novo.

14. No campo Definição, introduza ou selecione um valor.

    Selecione a opção 1099-MISC.

15. No campo Nome, escreva "Importar dados do ficheiro TXT".

16. No campo Descrição, escreva "Importar dados do ficheiro TXT".

17. Clique em Guardar.

18. Feche a página.

19. Feche a página.

20. Clique em Editar.

    Se instalou a correção "BDC 4012871 Suporte de mapeamentos de modelos GER em configurações separadas com uma capacidade de especificar diferentes tipos de pré-requisitos para implementação em diferentes versões do Dynamics 365 Finance" (BDC 4012871), execute o passo seguinte "Ativar o sinalizador 'Predefinição para mapeamento de modelos' para a configuração de formato introduzida. Caso contrário, ignore o passo seguinte.

21. Selecione Sim no campo Predefinição para o mapeamento de modelo.

22. Na árvore, selecione "Modelo de pagamentos 1099".

23. Clique em Estruturador.

24. Clique em Mapear modelo para origem de dados.

25. Clique em Executar.

    Se instalou a correção, BDC 4012871 Suporte de mapeamentos de modelos GER em configurações separadas com uma capacidade de especificar diferentes tipos de pré-requisitos para implementação em diferentes versões (BDC 4012871), selecione o mapeamento de modelos preferencial no campo de procura. Se ainda não instalou a correção, avance para o passo seguinte, uma vez que o mapeamento já foi selecionado pela definição da configuração de formato predefinida.

    Se não instalou a correção, BDC 4012871, tenha em atenção que a caixa de diálogo contém uma pergunta adicional sobre mapeamento de modelos utilizada para analisar o ficheiro que está a importar. Os dados são migrados da caixa de diálogo para o modelo de dados. Atualmente, pode escolher o mapeamento de formato que tem de ser utilizado, dependendo do tipo de ficheiro que pretende importar.

    Se pretende chamar este mapeamento de modelos a partir de um ponto na aplicação que está especificamente estruturado para a ação, o destino de ER e o mapeamento de formato devem ser marcados como parte da integração.

26. Clique em Cancelar.

27. Feche a página.

28. Feche a página.