Ejecutar importación de datos
Publicado: enero de 2017
Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
La importación de datos se ejecuta directamente en el servidor de Microsoft Dynamics 365. Para ejecutar la importación de datos, configure trabajos asincrónicos para ejecutarse en segundo plano que realicen lo siguiente, en este orden:
Analizar datos de origen incluidos en el archivo de importación.
Transformar datos analizados mediante la asignación de datos.
Cargar datos transformados en Microsoft Dynamics 365.
Todos los usuarios de Microsoft Dynamics 365 que dispongan de los permisos adecuados podrán ejecutar la importación de datos.
En este tema
Analizar datos de origen
Datos de análisis de transformación
Cargar datos transformados al servidor de destino
Errores de registro
Importación de datos de auditoría
Analizar datos de origen
El análisis de los datos de origen incluye el análisis de todos los archivos de importación asociados con una importación determinada (importación de datos).
Los datos analizados se almacena en las tablas de análisis temporales creadas para cada archivo importado. El nombre de la tabla de análisis se almacenan en el atributo ImportFile.ParsedTableName. Los encabezados de la columna del archivo de origen se especifican en el atributo ImportFile.HeaderRow. Si el archivo de origen no incluye una primera fila que contenga los encabezados de columna, este atributo especifica los encabezados de columna predeterminados generados por el sistema.
Guarde los datos analizados en la tabla de análisis con el mensaje ParseImportRequest. Recupere datos de la tabla de análisis con el mensaje GetDistinctValuesImportFileRequest y el mensaje RetrieveParsedDataImportFileRequest.
En la siguiente tabla se enumeran los mensajes que puede usar para analizar los archivos de importación y para recuperar los datos analizados de las tablas de análisis.
Mensaje |
Descripción |
|---|---|
Envía un trabajo asincrónico que analiza todos los archivos de importación asociados con la importación especificada (importación de datos). Pase el Id. de importación asociado (importación de datos) en la propiedad de ImportId de esta solicitud. El identificador del trabajo asincrónico que se ejecuta en segundo plano y realiza el análisis de datos se devuelve en la propiedad de AsyncOperationId de respuesta de los mensajes. |
|
Devuelve los valores distintos para una columna en el archivo de origen que contiene valores de lista. Pase el identificador del archivo de importación asociado en la propiedad de ImportFileId de esta solicitud. Los valores distintos se devuelven en una matriz de cadenas, en la propiedad de Values de respuesta de los mensajes. Use este mensaje después de crear una tabla de análisis con el mensaje de ParseImportRequest. Importante No use este mensaje después de utilizar el mensaje de ImportRecordsImportRequest . No se puede obtener acceso a la tabla de análisis después de que el trabajo de importación enviado por el mensaje de ImportRecordsImportRequest haya finalizado de ejecutarse. |
|
Recupera los datos de la tabla de análisis. Pase el identificador del archivo de importación asociado en la propiedad de ImportFileId de esta solicitud. Los datos analizados se devuelven en una matriz bidimensional de cadenas en la propiedad de Values de respuesta de los mensajes. Los datos se devuelven con el mismo orden de columnas que el del archivo de origen. Use este mensaje después de crear una tabla de análisis con el mensaje de ParseImportRequest. Importante No use este mensaje después de utilizar el mensaje de ImportRecordsImportRequest . No se puede obtener acceso a la tabla de análisis después de que el trabajo de importación enviado por el mensaje de ImportRecordsMessage haya finalizado de ejecutarse. |
Datos de análisis de transformación
Durante la transformación, cambia datos analizados aplicando todas las asignaciones y transformaciones de datos disponibles asociadas con una importación determinada (importación de datos) a los datos.
Utilice el mensaje TransformImportRequest para enviar un trabajo asincrónico para transformar los datos analizados. Pase un identificador único de la importación asociada (importación de datos) en el atributo de Import.ImportId de la solicitud. Un identificador único del trabajo asincrónico que se ejecuta en segundo plano y realiza la transformación se devuelve en la propiedad de AsyncOperationId de respuesta del mensaje.
Cargar datos transformados al servidor de destino
Tras completar correctamente la transformación, los datos están listos para cargarse en el servidor de Microsoft Dynamics 365.
Utilice el mensaje ImportRecordsImportRequest para enviar un trabajo asincrónico para cargar los datos transformados en Microsoft Dynamics 365. El identificador único de la importación asociada (importación de datos) debe especificarse en la propiedad de ImportId de la solicitud. Un identificador único del trabajo asincrónico que se ejecuta en segundo plano y carga los datos en Microsoft Dynamics 365 se devuelve en la propiedad de AsyncOperationId de respuesta del mensaje. Todos los archivos de importación asociados con la importación especificada (importación de datos) se importan.
Cada trabajo de importación tiene un número de secuencia único que almacena en el atributo de ImportSequenceNumber de registros que crea. El atributo de Organization.CurrentImportSequenceNumber contiene un número de secuencia único del pasado trabajo de importación que se ejecutó en el sistema. Puede usar estos números de secuencia únicos para efectuar un seguimiento de los registros que pertenecen a un trabajo de importación.
Errores de registro
Se puede producir un error de importación de un registro durante el análisis, la transformación o la carga de datos. Los motivos del error y otra información detallada sobre los registros que no se importaron se capturan en la entidad del registro de importación (ImportLog).
Para averiguar cuántos registros no se importaron correctamente, recupere el atributo de ImportFile.FailureCount del registro. Para comprobar cuántos registros tenían errores parciales durante la importación, recupere el atributo de ImportData.HasError. Si el atributo de HasError es true, se ha producido un error parcial, si es false, el registro se ha importado correctamente.
Importación de datos de auditoría
Las entidades de Microsoft Dynamics 365 disponen de cuatro atributos predeterminados que se usan para el seguimiento de la fecha y hora en que se ha creado y modificado un registro por última vez, así como la persona que lo ha creado y modificado.
El atributo de createdon especifica la fecha y la hora en que se creó el registro. Para importar datos en el atributo de createdon, asigne la columna de origen que incluye estos datos al atributo de overriddencreatedon. Durante la importación, el atributo de createdon del registro se actualiza con el valor que se asignó al atributo de overriddencreatedon y el atributo de overriddencreatedon se establece en la fecha y hora en que se importaron los datos. Si no se asigna ningún valor de origen al atributo de overriddencreatedon, el atributo de createdon se establece en la fecha y hora de importación de los datos y el atributo de overriddencreatedon no se establece en ningún valor.
Nota
Para reemplazar el valor del atributo de createdon durante la importación, necesita disponer del privilegio de prvOverrideCreatedOnCreatedBy. Tenga en cuenta que el nombre del privilegio implica que también puede reemplazar el atributo de createdby durante la importación. Sin embargo, actualmente esta función no es compatible.
No puede importar datos en los atributos de modifiedon, createdby y modifiedby. Si tiene que almacenar datos relacionados con la persona que creó y modificó los datos y cuándo se han modificado los datos, puede crear atributos personalizados en Microsoft Dynamics 365 y asignar las columnas de origen a los nuevos atributos personalizados.
Ver también
Importar datos
Configurar la importación de datos
Entrada de blog: Cómo importar los datos adjuntos mediante programación
Entidades de importación de datos
Microsoft Dynamics 365
© 2017 Microsoft. Todos los derechos reservados. Copyright