¿Qué es el

MILE?

O MILE é o acrônimo El MILE es el acrónimo para Model Integrator Layout Engine. O intuito desta ferramenta é facilitar a importação/exportação de dados para o sistema através do uso de rotinas 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) e/ou rotinas desenvolvidas em MVC utilizando arquivos em y/o rutinas desarrolladas en MVC utilizando archivos en formato texto (TXT).

Conceito básico da ferramenta

Concepto básico de la herramienta

 La 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  A ideia básica é mapear as informações que serão importadas ou exportadas em um layout . Esse layout trabalha no conceito de canais, é feita a leitura do arquivo texto e através do layout enviasse os dados para serem processados pelo adapter.      

1-

¿Qué es un canal?

O canal pode ser utilizado El canal se puede utilizar para definir que informações estão sendo trabalhadaslas informaciones que se están trabajando, por exemplo, em uma importação de pedido de vendas há informações de cabeçalho e de ítens, as informações que compõem o cabeçalho podem estar em um canal e as de ítens em outro canal.
Exemplo:

Image Removed

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.
Ejemplo:

Image Added

En este ejemplo el Neste exemplo o canal "01", (no começo da linha) poderia ser o cabeçalho e o al inicio de la línea) puede ser el encabezado y el "02" os ítenslos ítems.
O canal é uma informação que deve constar no arquivo texto e que define uma separação ou tipagem para os dados que estão sendo trabalhados.El canal es una información que debe constar en el archivo texto y que define una separación o tipificación para los datos que se están trabajando.

Un layout puede tener uno, varios o ningún Um layout pode possuir um, vários ou nenhum canal.

2-

¿Qué es una unidad de información?

Dentro de um arquivo texto iremos importar/exportar várias informações, mas un archivo texto importaremos/exportaremos varias informaciones, pero cada layout se refere refiere a um un contexto (notasfacturas, pedidos, clientes, etc.). Dentro de cada contexto, cada conjunto de informações é uma unidade de informaçãoinformaciones es una unidad de información.
Por exemplo, em um arquivo ejemplo, en un archivo de pedidos de venda podem venta pueden existir vários pedidos com vários canais, mas vamos varios pedidos con varios canales, pero vamos a importar/exportar 1 pedido a cada vez, nessa idéiaen esta idea, cada pedido é uma unidade de informação. Se vamos es una unidad de información. Si vamos a importar clientes, cada um dos uno de los clientes que será importado se importará (independente de quantos canais tenha o independiente de cuantos canales tenga el layout) será uma unidade de informação e assim por dianteuna unidad de información y así en adelante.

3-

¿Qué es un Adapter?

Adapter é a aplicação responsável por processar as informações que foram obtidas a partir do arquivo es la aplicación responsable por procesar las informaciones que se obtuvieron a partir del archivo texto.

2-

General

Contiene datos generales del

Contêm dados gerais do layout

Possui os Tiene los campos:

Layout: Código

del Layout

Descripción:

Descripción del layout
Tipo de Adapter: Tipo de Adapter.

Vea ítem 1.4 -

Qué es un Adapter

1=MSExecAuto -

Tratamiento por

rutina automática (MSExecAuto) (

la rutina debe tener esta característica)
2=MVC -

Tratamiento por

rutina en MVC
3=

Función -

Tratamiento por

función específica.

En este caso los datos serán leídos por la herramienta y pasados para función. Para más detalles vea el ítem 9 - Trabajando con una función específica.

Adapter:

Nombre del Adapter.

Cuando el tipo de adapter

es:
MSExecAuto:

Se informa si el nombre de la función de rutina automática (MSExecAuto).
MVC:

Se informa el nombre del FUENTE (.pr?) que

contiene el modelo de

datos (MODELDEF).

Función: Se informa el nombre de la función que recibirá los datos leídos

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.
Orden: Orden de la tabla principal utilizada en la importación. El orden de la tabla principal se orienta hacia esta orden antes de efectuar la importación.
Versión del Layout: Versión del layout. Campo libre para informar la versión del layout

.

Formateo del archivo

Contiene datos sobre el formato del archivo

Formatação do Arquivo

Contêm dados sobre o formato do arquivo texto.

Possui os Tiene los campos:

Arquivo TXTArchivo TXT: Formato do arquivo del archivo texto

1=Fixo: Dados com largura fixaFijo: Datos con ancho fijo
2=Separador:- Dados usam algum Datos utilizan algún separador entre sisí

Separador: Se o formato do arquivo texto for Si el formato del archivo texto es por separador, informar o caracter informe el carácter separador utilizado. Os caracter aceitos sãoLos caracteres aceptados son::

| Pipe
 ; Ponto-e-vírgula Punto y coma
 , VírgulaComa
 / Barra

- Traço Guión

 Tab Tab TabulaçãoTabulación ( Chr(9) )

Separador decimalSeparador Decimal: Tipo de separador de casas decimais dos dados de decimales de los datos numéricos.

1=Ponto              ExPunto              Ej. 12345.67

2=Vírgula            ExComa            Ej. 12345,67 

 Entrada MultiCanal: Informa se o arquivo texto possui vários canaissi el archivo texto tiene varios canales.

Tratamientos y validaciones

Contiene los nombres de funciones específicas que se pueden definir para tratamientos puntuales de los datos leídos.

Image Added

Detalles en el enlace

Tratamentos e validações

Contêm os nomes de funções específicas que podem ser definidas para tratamentos pontuais dos dados lidos.

Image Removed

Detalhes no link : MILE - Model Integrator Layout Engine

Adapters de

la rutina automática

Contiene definiciones

Contêm definições de características específicas para adapters que são uma rotina Adapters que son una rutina automática (MSExecAuto).

Possui os Tiene los campos:

Tipo MSExecAuto: Se o Si el tipo de adapter for uma rotina Adapter es una rutina automática (MSExecAuto), informar o modelo do rotina automática. São suportados informe el modelo de la rutina automática. Se compatibilizan 3 modelos:

1=Modelo 1 (Tabela simplesTabla simple)
2=Modelo 2 (1 Tabela com cabeçalho/ítensTabla con encabezado/ítems)
3=Modelo 3 (2 Tabelas Tablas diferentes cabeçalhoencabezado/ítensítems)

Outros modelos não são suportadosOtros modelos no compatibilizan.

Detalhes OpcionalDetalles Opcional: Quando o adapter é uma rotina Cuando el adapter es una rutina automática (MSExecAuto), define se os detalhes dessa rotina automática são opcionais. Este campo deve ser preenchido conforme cada rotina automática, pois algumas aceitam esta característica e outras nãosi 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.

Adapters

en MVC

Contiene definiciones de características específicas para

Adapters en MVC.

Possui os Tiene los campos:

Operações ImportaçãoOperaciones Importación: Para adapters em Adapters en MVC, define quais operações serão consideradas na importação.Apenas Inclusão: Todos dados sempre serão tratados como uma nova inclusão.
Inclusão/Alteração: Será verificada a chave única do modelo e determinado se o dado é uma inclusão ou alteração, se a chave não for encontrada será uma inclusão, se for encontrada, será uma alteração.

Método de Alteração: Define o método para efetuar as alterações.

Alteração Direta: Os dados serão alterados diretamente no modelo.
Excluir/Incluir: É feita a exclusão dos dados pelo adapter em MVC e em seguida uma nova inclusão.

las operaciones que se considerarán en la importación.

Solamente Inclusión: Todos los datos siempre se tratarán como una nueva inclusión.
Inclusión/Modificación: Se verificará la clave única del modelo y se determinará si el dato es una inclusión o modificación, si la clave no se encuentra, será una inclusión, si se encuentra, será una modificación.

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.
Eliminar/Incluir: Se hace la eliminación de datos por medio del Adapter en MVC y luego se hace una nueva inclusión.

Para configurar Canales, sugerimos leer el enlace Para configurar Canais sugerimos a leitura do link MILE - Model Integrator Layout Engine

Ejemplo del MATA020

Criamos um exemplo de aplicação no MATA020 com os campos padrões do Cadastro de Fornecedores.

Creamos un ejemplo de aplicación en el MATA020 con los campos estándar del registro de proveedores.

Archivos modelos:

TXT de

integración:

Exemplo Ejemplo layout:

1) Abra o arquivo XML do exemplo do layout acima pelo Módulo Configurador (Ambiente el archivo XML del ejemplo del mencionado Layout  por el Módulo de Configuración (Entorno → Aceleradores → Mile → Layouts):

2) Após importe o arquivo TXT no configurador ou dentro do Cadastro de Fornecedores:Después importe el archivo TXT en la configuración o dentro del Registro de Proveedores:

ConfiguraciónConfigurador:

Cadastro Archivo de Fornecedoresproveedores:

ExemploEjemplo:

Ejemplo de

error de

recepción

Neste caso acima o CNPJ do fornecedor não era um En el caso anterior, el RCPJ del proveedor no era un código válido.

Ejemplo del MATA103

Criamos um exemplo de aplicação no MATA103 com os campos padrões do Documento de Entrada.

Creamos un ejemplo de aplicación en el MATA103 con los campos estándar del documento de entrada.

Archivos modelos:

TXT de integraçãointegración:

Exemplo Ejemplo layout:

1) Abra o arquivo XML do exemplo do layout acima pelo Módulo Configurador (Ambiente el archivo XML del ejemplo del mencionado Layout  por el Módulo de Configuración (Entorno → Aceleradores → Mile → Mile → Layouts):

2) Após importe o arquivo TXT no configurador ou dentro do Documento de Entrada:Después importe el archivo TXT en la configuración o dentro del documento de entrada:

ConfiguraciónConfigurador:

Documento de Entradaentrada:

ExemploEjemplo:

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 MATA125

Criamos um exemplo de aplicação no MATA125 com os campos padrões do Contrato de Parceria.

Creamos un ejemplo de aplicación en el MATA125 con los campos estándar del Contrato de Asociación.

Archivos modelos:

TXT de

integración:

Exemplo Ejemplo layout:

1) Abra o arquivo XML do exemplo do layout acima pelo Módulo Configurador (Ambiente el archivo XML del ejemplo del mencionado Layout  por el Módulo de Configuración (Entorno → Aceleradores → Mile → Layouts):

2)Após importe o arquivo TXT no configurador ou dentro do Contrato de Parceria: Después importe el archivo TXT en la configuración o dentro del Contrato de Asociación:

ConfiguraciónConfigurador:

Contrato de Parceriaasociación:

ExemploEjemplo:

Ejemplo de

error de

recepción

Neste caso acima a condição de pagamento inserida no TXT de integração é inválida (não consta cadastrada no 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 MATA121

Criamos um exemplo de aplicação no MATA121 com os campos padrões do Pedido de Compra.

Creamos un ejemplo de aplicación en el MATA121 con los campos estándar del pedido de compra.

Archivos modelos:

TXT de

integración:

Exemplo Ejemplo layout:

1) Abra o arquivo XML do exemplo do layout acima pelo Módulo Configurador (Ambiente el archivo XML del ejemplo del mencionado Layout  por el Módulo de Configuración (Entorno → Aceleradores → Mile → Layouts):

2)Após importe o arquivo TXT no configurador: Después importe el archivo TXT en la configuración:

ConfiguraciónConfigurador:

ExemploEjemplo:

Ejemplo de

error de

recepción

Neste caso acima a loja do forneceedor inserida no TXT de integração é inválida (não consta cadastrada em relação ao fornecedor 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 Mile

Algunas 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.