Importar datos usando Data Migration Framework en Microsoft Dynamics AX 2012

Creación de un grupo de proceso 

Un grupo de proceso es similar a grupo de definiciones de Exportar/Importar datos en Ax estándar. El grupo de Proceso puede estar compuesto por una o varias entidades que se van a migrar.

En los pasos siguientes vamos a crear un grupo de Proceso y añadir las entidades que se quiere importar: 

Data Migration Framework / Comun / Processing group 

Crear un nuevo registro 

• Asignar un nombre al conjunto, por ejemplo Clientes 
• Luego ingresar la descripción del conjunto, por ejemplo Migración de Clientes y guardar el registro (ctrl+s) para habilitar el botón Entidades

El siguiente paso es agregar entidades al grupo de procesamiento creado. Haga clic en el botón Entities para abrir una nueva ventana de Selección de entidades para el procesamiento.

• Agregar Nombre de entidad.- en esta opción puede elegir de la lista de entidades que aparecen como predeterminadas o personalizadas, se debe tener en cuenta la secuencia de carga de las tablas sobre todo en las tablas que tienen relación. Por ejemplo si cargamos los clientes y dirección de cliente, el orden correcto es p
• ión de cliente debido a que el sistema validara que exista el cliente para poder cargar las direcciones. 

• Agregar source data format.- Esto indica el formato de datos en el que se trabajarán los archivos de origen. En nuestro caso, vamos a elegir Estándar que creamos en la entrada de configuración de parámetros para DMF, adicional a esto marcamos Run business logic in inserto r update para aplicar la lógica del negocio en la inserción y run business validations in validate write method para validar los datos. 

• Generate source file.- Luego de tener creado el grupo de entidades que se quieren importar se debe seleccionar los campos que importaremos en cada entidad para eso marcamos la primera entidad y hacemos clic en el botón Generate source file esto nos mostrara un Wizard para generar la plantilla de datos de origen, dar clic en Siguiente

En la pantalla siguiente marcamos los campos que incluirá nuestra plantilla de datos de origen, la secuencia es el orden que deberá tener los campos en la plantilla.

Los datos mínimos que se deberán marcar son los de tipo obligatorio excepto ExecutionId y DefinitionGroup

Una vez marcado los campos necesarios, hacer clic en el botón Generate simple file, este nos genera una plantilla con los campos en el orden que se marcaron y de acuerdo a la configuración del formato en los parámetros de DMF.

En la siguiente imagen vemos la plantilla generada, ahí podemos ver el nombre de los campos marcados, también que las columnas están separadas por comas, esta plantilla se guarda en una carpeta compartida dentro del servidor desde la cual se importara la información.

Después de guardar el archivo dar clic en Finalizar

- Sample file path.- en este campo se deberá ingresar la ruta donde se guardó la plantilla generada en al paso anterior, esto se hace para cada entidad dentro del grupo

- Generate source mapping.- El siguiente paso es asignar la estructura del archivo plantilla a la tabla provisional. Para ello, tenemos que hacer clic en el botón Generate source mapping este leerá los nombres de columna del archivo y automáticamente los genera en la tabla provisional.

- Modify source mapping.- Si desea modificar la asignación o verificar las asignaciones de origen. Puede hacer clic en el botón Modify source Mapping. Se abrirá una nueva ventana. 

Esta es la representación gráfica del mapeo de la tabla. Aquí en el lado izquierdo, vemos los campos que queremos migrar de acuerdo a nuestra plantilla. Y en el lado derecho, representa la tabla intermedia dentro de Microsoft Dynamics AX2012. Las líneas nos indican en que campo se guardara cada origen de nuestra plantilla. 

- Preview source file.- Esto le mostrará la vista previa (sin llegar a mover datos desde un archivo de origen). Aquí podemos verificar si los datos están apareciendo como se espera.

Después de verificar la vista previa, cierre el formulario de grupos de proceso. 

Nota: El proceso de generar la plantilla y el mapeo de las mismas se repite para cada entidad que estemos considerando en el grupo de proceso en el ejemplo también debo hacerlo para la entidad de direcciones de cliente que esta en este mismo grupo de preceso de carga de clientes. 

Carga de los datos en las tablas intermedias 

Antes de poder cargar los datos, estos deberán ser preparados y guardados previamente en las plantillas de texto generadas en el paso anterior con el formato correcto, para ello puede usar los archivos demostrativos que le pueden servir como ejemplos y se encuentran en: ( Archivos de programa / Microsoft Dynamics AX 2012 Data Migration Framework Client Components (Beta) / DemoFiles) . 

Inicio de la carga

Para cargar los datos del archivo en la tabla intermedia, marque el grupo de procesamiento y haga clic en el botón Get staging data

Esto hará que aparezca un cuadro de diálogo de Microsoft Dynamics AX donde no muestra un id de la tarea que nos sirve para poder programar un trabajo por lote. Introduzca una descripción para la tarea, como se muestra en la imagen siguiente y haga clic en Aceptar.

En la siguiente pantalla nos muestra los detalles como, el nombre de la entidad y la ruta del archivo de origen configurado en el grupo de proceso. En esta ventana se puede cambiar la ruta del archivo, en caso de que cambie la ruta del archivo, tiene la opción de vista previa de los datos de la tabla, esto se consigue haciendo clic en el botón Vista previa. 

Una vez que todo está verificado y está listo para iniciar la migración de datos desde los archivos de origen, haga clic en el botón Ejecutar

Se le mostrará un cuadro de diálogo, que le proporciona la opción de seleccionar si es que para la carga se debe hacer uso de trabajos por lotes o sin lotes. Vamos a considerar sin lotes con el propósito de demostración. Entonces haga clic en el botón Aceptar.

Si no hay errores y los registros se han cargado satisfactoriamente. Recibirás un mensaje con detalles sobre los registros insertados o actualizados.

Verifique los datos antes de cargar en la tabla definitiva de Microsoft Dynamics AX

Una vez cargada las tablas intermedias, los demás botones del grupo de procesamiento se activarán automáticamente. Por ejemplo, haciendo clic en el botón Execution History podemos ver todos los detalles relacionados con un ID de trabajo ejecutado. 

Observar la imagen de arriba, en la ventana de Execution History hay tres botones habilitados, view staging data, Copy data to target y Registro respectivamente. Estas juegan el papel importante en la verificación de los datos de antes de cargarlo en la tabla definitiva. 

- Haga clic en el botón view staging data para abrir una nueva ventana con el nombre de la entidad como el título .El formulario enumera todas los registros introducidos en la tabla intermedia.

El usuario puede validar los datos de la tabla provisional o intermedia para asegurarse de que los datos son correctos, podemos hacer clic en Validar, esto es para validar el registro actual o los registros seleccionados 

Si quiere validar todos los registros en al mismo tiempo, presione el botón Validate all esto verificará si todas las referencias de los datos son correctos, si no es así, el sistema le avisará sobre los mismos con los detalles, en caso de alerta corregir el origen antes de continuar. 

Carga de los datos en las tablas definitivas

A continuación, tenemos que copiar los datos de la tabla intermedia a las tablas finales. Para ello hacer clic en el botón Copy data to target. 

Se abre una nueva ventana de dialogo con opciones para seleccionar ID de trabajo, Run for, Criterios. A los efectos de demostración y también como tenemos que migrar todos los registros, elegiremos Run for = Todo. 

Después haga clic en Aceptar, para abrir un formulario que mostrará los detalles de la entidad para la ejecución final.

Ahora haga clic en el botón Ejecutar nos mostrara una ventana de diálogo que nos permite elegir el procesamiento por lotes o sin lotes. Para la demostración, vamos a considerar sin lotes.

Simplemente haga clic en el botón Aceptar. 

Si la carga se ejecuta sin ningún error, saldrá un mensaje con el número de filas creado / modificado.

Verifique los datos importados

Para comprobar los datos en el destino, ingresamos a Execution History, haga clic en el botón view staging data para abrir un formulario que muestra el total de registros migrados

Seleccione un registro y haga clic en Objetivo, se abrirá el formulario del cliente seleccionado. De esta manera podemos realmente validar si los datos de la tabla se insertaron correctamente en las tablas de destino.

Limpieza de las tablas intermedias 

Una vez cargados los datos a las tablas definitivas se debe limpiar las tablas intermedia para ellos siga los siguientes pasos 

Ir a: Data Migration Framework / Periódico / Staging cleanup

En esta ventana se ingresan los datos de la entidad, el grupo de procesos y el Id de tarea que queremos limpiar. Después de introducir los valores válidos, haga clic en el botón Aceptar.