Configurar a importação de dados do SharePoint

Para importar dados de um arquivo de entrada usando a estrutura de relatório eletrônico (ER), é necessário configurar um formato de ER que suporta a importação e, em seguida, executar um mapeamento de modelo para o tipo Para destino que usa esse formato como uma origem de dados. Para importar dados, você deve navegar para o arquivo que deseja importar. O arquivo de entrada pode ser selecionado manualmente pelo usuário. Com a nova capacidade de ER de dar suporte à importação de dados do Microsoft SharePoint, este processo pode ser configurado como autônomo. Você pode usar as configurações ER para executar a importação de dados de arquivos armazenados em pastas do Microsoft SharePoint. Este artigo explica como executar a importação do SharePoint. Os exemplos usam transações de fornecedor como dados comerciais.

Pré-requisitos

Para concluir os exemplos neste artigo, você deve ter o seguinte acesso:

• Acesso a uma das seguintes funções:

  • Desenvolvedor de relatório eletrônico
  • Consultor funcional de relatório eletrônico
  • Administrador do sistema

• Acesso à instância do Microsoft SharePoint Server configurado para uso com o aplicativo.

• Configurações de formato e modelo de ER para pagamentos de 1099.

Criar configurações ER necessárias

Executar os guias de tarefas ER Importar dados de um arquivo do Microsoft Excel, que fazem parte do processo de negócios 7.5.4.3 Adquirir/Desenvolver componentes de serviço/solução de TI (10677). Esses guias de tarefas contêm orientações para o processo de criação e uso de configurações ER para importar transações de fornecedores de maneira interativa a partir de arquivos do Microsoft Excel. Para obter mais informações, consulte Analisar documentos de entrada no formato do Excel. Depois de concluir as guias da tarefa, você terá a configuração a seguir.

Configurações ER

• Configuração de modelo de ER, Modelo de pagamento 1099
• Configuração de formato de ER, Formatar para importar transações de fornecedores do Excel

Amostra do arquivo de entrada para importação de dados

• Arquivo do Excel 1099import-data.xlsx com as transações do fornecedor que devem ser importadas.

Observação

O formato para importar transações do fornecedor é selecionado como o mapeamento de modelo padrão. Portanto, se você executar um mapeamento de modelo do Modelo de pagamentos 1099 e esse mapeamento de modelo for do tipo Para destino, o mapeamento de modelo executa este formato para importar dados dos arquivos externos. Em seguida, usa esses dados para atualizar tabelas do aplicativo.

Configurar o acesso ao SharePoint para armazenamento de arquivos

Para armazenar arquivos de relatórios eletrônicos em um local do SharePoint, você deve configurar o acesso à instância do SharePoint Server que será usada pela empresa atual. Neste exemplo, a empresa é USMF. Para obter instruções, consulte Configurar armazenamento do SharePoint.

1. Execute as etapas em Configurar armazenamento do SharePoint.

2. Abra o site configurado do SharePoint.

3. Criar estas pastas onde os arquivos de relatórios eletrônicos de entrada possam ser armazenados:

   • Origem da importação de arquivos (principal) (exemplo mostrado na captura de tela a seguir)
   • Origem da importação de arquivos (alternativa)

   

4. (Opcional) Criar estas pastas onde os arquivos possam ser armazenados após a importação:

   • Pasta do arquivo morto de arquivos - esta pasta seria para arquivos importados com êxito.
   • Pasta de avisos de arquivos - essa pasta seria para os arquivos que foram importados com um aviso.
   • Pasta de arquivos com erros - esta pasta seria para os arquivos que não foram importados.

5. Acesse Administração da organização > Gerenciamento de documentos > Tipos de documento.

6. Crie os tipos de documento a seguir que serão usados para acessar as pastas do SharePoint recém-criadas. Para obter instruções, consulte Configurar tipos de documento.

Tipo de documento	Agrupar	Localização	Pasta do SharePoint
SP principal	Arquivo	SharePoint	Origem da importação de arquivos (pai)
SP alternativa	Arquivo	SharePoint	Origem da importação de arquivos (alternativa)
Arquivo morto de SP	Arquivo	SharePoint	Pasta do arquivo morto de arquivos
Aviso do SP	Arquivo	SharePoint	Pasta de avisos de arquivos
Erro do SP	Arquivo	SharePoint	Pasta de arquivos com erros

Configurar fontes de ER para o formato de ER

1. Clique em Administração da organização>Relatório eletrônico>Origem do relatório eletrônico.

2. Na página Origem do relatório eletrônico, configure os arquivos de origem para a importação de dados usando o formato do ER configurado.

3. Defina uma máscara de nome de arquivo, para que somente os arquivos com a extensão .xlsx sejam importados. A máscara do nome de arquivo é opcional e é usada somente quando for definida. Você pode definir somente uma máscara para cada formato de ER.

4. Altere Classificar arquivos antes de importar para Não classificar se houver muitos arquivos para importação e a ordem de importação não for importante

5. Selecione todas as pastas do SharePoint que você criou anteriormente.

   

Observação

• A origem do ER é definida para cada empresa do aplicativo individualmente. Por outro lado, as configurações do ER são compartilhadas entre as empresas.
• Quando você exclui uma configuração de origem de ER para um formato de ER, todos os estados de arquivos conectados (veja abaixo) também são excluídos por confirmação.

Examinar os estados dos arquivos para o formato de ER

1. Na página Origem do relatório eletrônico, selecione Estados dos arquivos das origens para examinar o conteúdo de origens do arquivo configurado para o formato de ER atual.

2. Na seção Arquivos, examine a lista de arquivos. Esta lista apresentará o seguinte:

   • Arquivos de origem que são aplicáveis, com base na máscara de nome de arquivo (se uma máscara de nome de arquivo for definida) e que estão prontas para a importação de dados. Para esses arquivos, a seção Logs de origem do formato de importação estará vazia.
   • Arquivos importados anteriormente. Para cada um desses arquivos, na seção Logs de origem do formato de importação, você pode revisar o histórico de importação deste arquivo.

Você também pode abrir a página Estados dos arquivos das origens selecionando Administração da organização>Relatório eletrônico>Estados dos arquivos das origens. Nesse caso, a página fornece informações sobre fontes de arquivo para todos os formatos de ER nos quais as origens do arquivo foram configuradas na empresa na qual você está conectado.

Importar dados de arquivos do Excel que estão em uma pasta do SharePoint

1. No SharePoint, carregue o arquivo do Microsoft Excel 1099import-data.xlsx que contém transações do fornecedor para a pasta do SharePoint Origem de importação dos arquivos (principal) criada anteriormente.

   

2. Na página Estados dos arquivos das origens, selecione Atualizar para atualizar a página. O arquivo do Excel que foi carregado no SharePoint apareceu nesta página com o status Pronto. Os seguintes status são suportados atualmente:

   • Pronto – atribuído automaticamente para cada novo arquivo em uma pasta do SharePoint. Este status indica que o arquivo está pronto para a importação.
   • Importando – Atribuído automaticamente para um relatório de ER quando o arquivo for bloqueado pelo processo de importação para impedir seu uso por outros processos (se vários deles forem executados simultaneamente.)
   • Importado – atribuído automaticamente por um relatório de ER quando a importação do arquivo for concluída com sucesso. Este status indica que o arquivo importado foi excluído da origem de arquivos configurada (pasta do SharePoint).
   • Com falha – atribuído automaticamente por um relatório de ER quando a importação do arquivo for concluída com sucesso com erros ou exceções.
   • Em espera – Atribuído manualmente pelo usuário nesta página. Este status indica que o arquivo não será importado por enquanto. Este status pode ser usado para adiar a importação de alguns arquivos.

   

Importar dados de arquivos do SharePoint

1. Abra a árvore das configurações ER, selecione Modelo de pagamento 1099 e expanda a lista de componentes do modelo de ER.

2. Selecione o nome do mapeamento do modelo para abrir a lista de mapeamentos do modelo da configuração do modelo de ER selecionada.

   

3. Selecione Executar para executar o mapeamento de modelo selecionado. Como você configurou as origens no formato ER, poderá alterar a configuração da opção Origem do arquivo se necessário. Se você mantém a configuração desta opção, os arquivos .xslx são importados das origens configuradas (as pastas do SharePoint, neste exemplo).

   Neste exemplo, você está importando somente um arquivo. Porém, se houver vários arquivos, eles serão selecionados para importação na ordem em que foram adicionados à pasta do SharePoint. Cada execução de um formato de ER importa um único arquivo selecionado.

   

4. O mapeamento do modelo pode ser executado no modo autônomo em lote. Nesse caso, sempre que um lote executar esse formato de ER, um arquivo único é importado de origens do arquivo configurado.

   Quando um arquivo é importado com êxito da pasta do SharePoint, ele é excluído dessa pasta e movido para uma pasta de arquivos importados com êxito ou para a pasta de arquivos importados com avisos. Caso contrário, ele será movido para a pasta de arquivos com falhas ou ficará nessa pasta se a pasta de arquivos com falhas não estiver configurada.

5. Insira a ID de comprovante, como V-00001 e depois selecione OK.

   

6. Na página Estados dos arquivos das origens, selecione Atualizar para atualizar a página.

   

7. Na seção Arquivos, examine a lista de arquivos. A seção Logs de origem do formato de importação fornece o histórico de importação de arquivo Excel. Como esse arquivo foi importado com êxito, ele é marcado como Excluído na pasta do SharePoint.

8. Revise a pasta do SharePoint Origem de importação dos arquivos (principal). Os arquivos do Excel que foram importados com sucesso foram excluídos desta pasta.

9. Selecione Contas a pagar>Tarefas periódicas>Imposto 1099>Liquidação de fornecedor para impostos 1099.

10. Nos campos De e Até, informe os valores apropriados. Em seguida, selecione Transações 1099 manuais.

    As transações do fornecedor importadas dos arquivos do Excel no SharePoint para o comprovante V-00001 são apresentadas na página.

    

Preparar um arquivo do Excel para importação

1. Abra o arquivo do Excel usado anteriormente. Na linha 3, coluna 1 adicione um código do fornecedor que não existe no aplicativo. Inclua informações adicionais falsas de fornecedor na linha.

   

2. Carregue o arquivo do Excel atualizado que contém as transações dos fornecedores para a pasta do SharePoint Origem de importação dos arquivos (principal).

3. Abra a árvore das configurações ER, selecione Modelo de pagamento 1099 e expanda a lista de componentes do modelo de ER.

4. Selecione o nome do mapeamento de modelo para atualizar o mapeamento de modelo, de forma que o código incorreto do fornecedor seja considerado um erro durante o processo de importação de dados.

5. Selecione Designer.

6. Na guia Validações, você deverá alterar a ação de pós-validação para a regra de validação que foi configurada para avaliar se a conta de fornecedor importada existe no aplicativo. Atualize o valor do campo Ação pós-validação para Parar execução, salve suas alterações e feche a página.

   

7. Salvar suas alterações e feche o designer de mapeamento de modelo do ER.

8. Selecione Executar para executar o mapeamento de modelo de ER modificado.

9. Insira a ID de comprovante, como V-00002 e depois selecione OK.

   O log de informações contém um aviso de que há um arquivo na pasta do SharePoint com uma conta de fornecedor incorreta e que, portanto, ele não pode ser importado.

   

10. Na página Estados dos arquivos das origens, selecione Atualizar e, em seguida, na seção Arquivos, revise a lista de arquivos.

    

A seção Logs de origem do formato de importação indica que o processo de importação falhou e que o arquivo está na pasta de arquivos com erros do SharePoint (a caixa de seleção Excluído não está marcada). Se você corrigir esse arquivo no SharePoint adicionando o código de fornecedor apropriado e movendo-o para a pasta Origem de importação dos arquivos (principal) do SharePoint, poderá importá-lo novamente.

11. Selecione Contas a pagar>Tarefas periódicas>Imposto 1099>Liquidação de fornecedor para impostos 1099, insira os valores apropriados nos campos De e Até e selecione Transações 1099 manuais.

    Somente as transações para o comprovante V-00001 estão disponíveis. Nenhuma transação para o comprovante V-00002 estará disponível, mesmo que o erro da última transação importada seja encontrado no arquivo do Excel.

Limitações

Em versões do Dynamics 365 Finance antes da versão 10.0.25, a interface do usuário (IU) da estrutura ER não permitia iniciar um novo trabalho em lote que executasse um mapeamento de modelo para importação de dados em modo autônomo. Em vez disso, você deve desenvolver uma nova lógica de forma que o mapeamento de modelo ER configurado possa ser chamado na IU do aplicativo para importar dados de arquivos de entrada. Para desenvolver essa lógica, é necessário um trabalho de engenharia.

Para obter mais informações sobre a API de ER relevante, consulte a seção Código para executar mapeamento de formato para importação de dados no tópico Alterações na API da estrutura ER para Atualização de aplicativo 7.3. Analise o código na classe BankImport_RU do modelo Application Suite para ver como a lógica personalizada pode ser implementada. A classe BankImport_RU estende a classe RunBaseBatch. Em particular, analise o método runER(), em que o objeto ERIModelMappingDestinationRun é criado como o executor de um mapeamento de modelo de ER.

No Finance versão 10.0.25 e posterior, a estrutura de IU de ER permite iniciar um novo trabalho em lote que executará um mapeamento de modelo para importação de dados em modo autônomo. Para obter mais informações sobre esse processo, consulte Importar dados no modo de lotes de arquivos selecionados manualmente.

Recursos adicionais

Visão geral do Relatório Eletrônico

Alterações na API da estrutura de ER para Application update 7.3

Alterações na API da estrutura de ER para Application update 10.0.23

Alterações na API da estrutura de ER para Application update 10.0.25