Producto: | Microsiga Protheus® |
Versiones: | 12.1.25 y posteriores |
Ocurrencia: | Configuración Mile para el Módulo Compras |
Entorno: | SIGACOM - Compras |
Paso a paso: | ¿Qué es el MILE?El MILE es el acrónimo para Model Integrator Layout Engine. El objetivo de esta herramienta es facilitar la importación/exportación de datos para el sistema por medio del uso de rutinas automáticas (MSExecAuto) y/o rutinas desarrolladas en MVC utilizando archivos en formato texto (TXT). Concepto básico de la herramientaLa idea básica es mapear las informaciones que se importarán o exportarán en el layout . Este layout trabaja en el concepto de canales, se hace la lectura del archivo texto y por medio del Layout se envían los datos para que sean procesados por el adapter. 1- ¿Qué es un canal?El canal se puede utilizar para definir las informaciones que se están trabajando, por ejemplo, en una importación del pedido de ventas existen informaciones del encabezado y de los ítems, las informaciones que componen el encabezado pueden estar en un canal y las de ítems en otro canal.
En este ejemplo el canal "01", (al inicio de la línea) puede ser el encabezado y el "02" los ítems. Un layout puede tener uno, varios o ningún canal. 2- ¿Qué es una unidad de información?Dentro de un archivo texto importaremos/exportaremos varias informaciones, pero cada layout se refiere a un contexto (facturas, pedidos, clientes, etc.). Dentro de cada contexto, cada conjunto de informaciones es una unidad de información. 3- ¿Qué es un Adapter?Adapter es la aplicación responsable por procesar las informaciones que se obtuvieron a partir del archivo texto. ¿Qué es un Layout?Layout es la configuración que permite, al leer un archivo texto, identificar los datos contenidos en dicho archivo y hacer su relación con las informaciones de los adapters. 1- Composición del layoutUn Layout se puede configurar a través de la aplicación de mantenimiento de los Layout (CFGA600) que se encuentra en el módulo de Configuración (SIGACFG) en las opciones Entorno / Aceleradores / MILE / Layout
2- GeneralContiene datos generales del layout
Tiene los campos: Layout: Código del Layout Descripción: Descripción del layout 1=MSExecAuto - Tratamiento por rutina automática (MSExecAuto) (la rutina debe tener esta característica)
Cuando el tipo de adapter es: Tabla principal: Alias de la tabla principal utilizada en la importación. El área corriente se orienta hacia este alias antes de efectuar la importación. Formateo del archivoContiene datos sobre el formato del archivo texto.
Tiene los campos: Archivo TXT: Formato del archivo texto 1=Fijo: Datos con ancho fijo Separador: Si el formato del archivo texto es por separador, informe el carácter separador utilizado. Los caracteres aceptados son:: | Pipe Atención Si los datos contienen alguno de los símbolos de los separadores, estos no se importarán correctamente. Separador decimal: Tipo de separador de decimales de los datos numéricos. 1=Punto Ej. 12345.67 2=Coma Ej. 12345,67 Atención Si el tipo de separador de decimales no estuviera correcto, los datos no se importarán correctamente. Si los datos tuvieran separadores de millares, esto debe ser tratado en el propio Layout utilizando el campo Ejecución. Entrada MultiCanal: Informa si el archivo texto tiene varios canales. Tratamientos y validacionesContiene los nombres de funciones específicas que se pueden definir para tratamientos puntuales de los datos leídos.
Detalles en el enlace MILE - Model Integrator Layout Engine Adapters de la rutina automáticaContiene definiciones de características específicas para Adapters que son una rutina automática (MSExecAuto).
Tiene los campos:
1=Modelo 1 (Tabla simple) Otros modelos no compatibilizan. Detalles Opcional: Cuando el adapter es una rutina automática (MSExecAuto), define si los detalles de dicha rutina automática son opcionales. Este campo se debe informar según cada rutina automática, porque algunas aceptan esta característica y otras no. Importante La operación ejecutada para Adapters de la rutina automática (MSExecAuto) siempre será tan solo INCLUSIÓN. Adapters en MVCContiene definiciones de características específicas para Adapters en MVC.
Tiene los campos:
Método de modificación: Define el método para efectuar las modificaciones. Modificación directa: Los datos se modificarán directamente en el modelo. Para configurar Canales, sugerimos leer el enlace MILE - Model Integrator Layout Engine Ejemplo del MATA020Creamos un ejemplo de aplicación en el MATA020 con los campos estándar del registro de proveedores. Archivos modelos: TXT de integración:
Ejemplo layout:
1) Abra el archivo XML del ejemplo del mencionado Layout por el Módulo de Configuración (Entorno → Aceleradores → Mile → Layouts):
2) Después importe el archivo TXT en la configuración o dentro del Registro de Proveedores: Configuración:
Archivo de proveedores:
Importante Sustituya los códigos del TXT con códigos que existen en la base (código del proveedor, tienda, RCPJ, dirección, entre otros). Ejemplo:
Ejemplo de error de recepción
En el caso anterior, el RCPJ del proveedor no era un código válido. Ejemplo del MATA103Creamos un ejemplo de aplicación en el MATA103 con los campos estándar del documento de entrada. Archivos modelos: TXT de integración: Ejemplo layout:
1) Abra el archivo XML del ejemplo del mencionado Layout por el Módulo de Configuración (Entorno → Aceleradores → Mile → Layouts):
2) Después importe el archivo TXT en la configuración o dentro del documento de entrada: Configuración:
Documento de entrada:
Importante Sustituya los códigos del TXT con códigos que existen en la base (código del proveedor, número del documento, código del producto, centro de costo, entre otros). Ejemplo:
Ejemplo de error de recepción
Neste caso acima o documento de entrada já havia sido cadastrado e o sistema não permite que haja duplicidade. Ejemplo del MATA125Creamos un ejemplo de aplicación en el MATA125 con los campos estándar del Contrato de Asociación. Archivos modelos: TXT de integración:
Ejemplo layout:
1) Abra el archivo XML del ejemplo del mencionado Layout por el Módulo de Configuración (Entorno → Aceleradores → Mile → Layouts):
2) Después importe el archivo TXT en la configuración o dentro del Contrato de Asociación: Configuración:
Contrato de asociación:
Importante Sustituya los códigos del TXT con códigos que existen en la base (número contrato de asociación, código del proveedor, tienda, condición de pago, entre otros). Ejemplo:
Ejemplo de error de recepción
En el caso anterior, la condición de pago incluida en el TXT de integración no es válida (no consta registro en el Protheus). Ejemplo del MATA121Creamos un ejemplo de aplicación en el MATA121 con los campos estándar del pedido de compra. Archivos modelos: TXT de integración:
Ejemplo layout:
1) Abra el archivo XML del ejemplo del mencionado Layout por el Módulo de Configuración (Entorno → Aceleradores → Mile → Layouts):
2) Después importe el archivo TXT en la configuración: Configuración:
Importante Sustituya los códigos del TXT con códigos que existen en la base (número del pedido de compra, código del proveedor, tienda, condición de pago, entre otros). Ejemplo:
Ejemplo de error de recepción
En el caso anterior, la tienda del proveedor incluida en el TXT de integración no es válida (no consta registro con relación al proveedor informado). Excepciones de uso del MileAlgunas rutinas del sistema que no tienen ExecAuto no están preparadas para el uso de la configuración Mile, ejemplo de esto es la rutina MATA161 - Análisis de cotización. |
Documentación complementaria: |