Executar importação de dados
Publicado: janeiro de 2017
Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
A importação de dados é executada diretamente no servidor do Microsoft Dynamics 365. Para executar a importação de dados, configure a execução de trabalhos assíncronos em segundo plano que realizam o seguinte, nesta ordem:
Análise dos dados de origem que estão contidos no arquivo de importação.
Transformação dos dados analisados usando o mapa de dados.
Carregamento dos dados transformados no Microsoft Dynamics 365.
Todos os usuários do Microsoft Dynamics 365 com permissões adequadas podem importar dados.
Neste tópico
Análise dos dados de origem
Transformação dos dados analisados
Carregamento dos dados transformados ao servidor de destino
Falhas de log
Importação de dados de auditoria
Análise dos dados de origem
A análise dos dados de origem inclui a análise de todos os arquivos de importação associados a uma importação específica (importação de dados).
Os dados analisados são armazenados nas tabelas de análise temporárias criadas para cada arquivo importado. O nome da tabela de análise é armazenado no atributo ImportFile.ParsedTableName. Os títulos das colunas do arquivo de origem são especificados no atributo ImportFile.HeaderRow. Se o arquivo de origem não incluir a primeira linha que contém os títulos da coluna, este atributo especificará os títulos de colunas padrão gerados pelo sistema.
Salve os dados analisados na tabela de análise usando a mensagem ParseImportRequest. Recupere os dados da tabela de análise usando a mensagem GetDistinctValuesImportFileRequest e a mensagem RetrieveParsedDataImportFileRequest.
A tabela a seguir lista as mensagens que podem ser usadas para analisar os arquivos de importação e recuperar os dados analisados das tabelas de análise.
Mensagem |
Descrição |
|---|---|
Envia um trabalho assíncrono que analisa todos os arquivos de importação associados à importação especificado (importação de dados). Transmitir a ID da importação associada (importação de dados) na propriedade ImportId desta solicitação. O ID do trabalho assíncrono que é executado em segundo plano e que executa a análise dos dados é retornado na propriedade AsyncOperationId da resposta da mensagem. |
|
Retorna valores distintos de uma coluna no arquivo de origem que contém os valores da lista. Transmita o ID do arquivo de importação associado na propriedade ImportFileId desta solicitação. Os valores distintos são retornados em uma matriz de cadeias de caracteres na propriedade Values da resposta da mensagem. Use esta mensagem somente após criar uma tabela de análise usando a mensagem ParseImportRequest. Importante Não use esta mensagem depois de usar a mensagem ImportRecordsImportRequest. Não é possível acessar a tabela de análise após o trabalho de importação enviado pela mensagem ImportRecordsImportRequest ter finalizado a execução. |
|
Recupera os dados da tabela de análise. Transmita o ID do arquivo de importação associado na propriedade ImportFileId desta solicitação. Os dados analisados são retornados em uma matriz bidimensional de cadeias de caracteres na propriedade Values da resposta da mensagem. Os dados são retornados na mesma ordem de colunas que a ordem de colunas do arquivo de origem. Use esta mensagem somente após criar uma tabela de análise usando a mensagem ParseImportRequest. Importante Não use esta mensagem depois de usar a mensagem ImportRecordsImportRequest. Não é possível acessar a tabela de análise após o trabalho de importação enviado pela mensagem ImportRecordsMessage ter finalizado a execução. |
Transformação dos dados analisados
Durante a transformação, altere os dados analisados aplicando aos dados todos os mapeamentos de dados e transformações disponíveis associados a uma importação específica (importação de dados).
Use a mensagem TransformImportRequest para enviar um trabalho assíncrono para transformar os dados analisados. Transmita um identificador exclusivo da importação associada (importação de dados) no atributo Import.ImportId da solicitação. Um identificador exclusivo do trabalho assíncrono que é executado em segundo plano e que executa a transformação é retornado na propriedade AsyncOperationId da resposta da mensagem.
Carregamento dos dados transformados ao servidor de destino
Após a conclusão bem-sucedida da transformação, os dados estão prontos para serem carregados no servidor do Microsoft Dynamics 365.
Use a mensagem ImportRecordsImportRequest para enviar um trabalho assíncrono para carregar os dados transformados no Microsoft Dynamics 365. O identificador exclusivo da importação associada (importação de dados) deve ser especificado na propriedade ImportId da solicitação. Um identificador exclusivo do trabalho assíncrono que é executado em segundo plano e que carrega os dados no Microsoft Dynamics 365 é retornado na propriedade AsyncOperationId da resposta da mensagem. Todos os arquivos de importação associados à importação específica (importação de dados) são importados.
Cada trabalho de importação tem um número de sequência que ele armazena no atributo ImportSequenceNumber de registros criado por ele. O atributo Organization.CurrentImportSequenceNumber contém um número de sequência exclusivo do último trabalho de importação que foi executado no sistema. É possível usar esses números de sequência exclusivos para controlar os registros que pertencem a um trabalho de importação.
Falhas de log
Uma falha na importação de um registro pode ocorrer durante a análise, transformação ou carregamento de dados. Os motivos de falhas e outras informações detalhadas sobre falhas de registros que não foram importados são capturados na entidade do log da importação (ImportLog).
Para descobrir o número de falhas de registros que não foram importados, recupere o atributo ImportFile.FailureCount do registro. Para verificar quantos registros tiveram falhas parciais durante a importação, recupere o atributo ImportData.HasError. Se o atributo HasError for true, uma falha parcial ocorreu; se for false, o registro executou a importação com êxito.
Importação de dados de auditoria
A entidade Microsoft Dynamics 365 tem quatro atributos padrão, que são usados para controlar a data e a hora da criação e da última modificação de um registro, além dos nomes dos usuários que criaram e fizeram a última modificação do registro.
O atributo createdon especifica a data e a hora em que o registro foi criado. Para importar dados para o atributo createdon, mapeie a coluna de origem que contém esses dados para o atributo overriddencreatedon. Durante a importação, o atributo createdon do registro é atualizado com o valor que foi mapeado para o atributo overriddencreatedon e o atributo overriddencreatedon é definido para a data e a hora em que os dados foram importados. Se nenhum valor de origem for mapeado para o atributo overriddencreatedon, o atributo createdon é definido para a data e a hora em que os dados foram importados e o atributo overriddencreatedon não é definido para nenhum valor.
Observação
Para substituir o valor do atributo createdon durante a importação, você precisará do privilégio prvOverrideCreatedOnCreatedBy. Observe que o nome do privilégio implica que você também substitua o atributo createdby durante a importação. Entretanto, este recurso não tem suporte no momento.
Não é possível importar dados para os atributos modifiedon, createdby e modifiedby. Se você precisar armazenar os dados relacionados ao usuário que criou e modificou os dados quando eles foram alterados, é possível criar atributos personalizados no Microsoft Dynamics 365 e mapear as colunas de origem para os novos atributos personalizados.
Confira Também
Importar dados
Configurar importação de dados
Postagem de blog: Como importar anexos de forma programática
Entidades de importação de dados
Microsoft Dynamics 365
© 2017 Microsoft. Todos os direitos reservados. Direitos autorais