Configuração Mile para o Módulo Compras
Produto: | Microsiga Protheus® |
Versões: | 12.1.25 e posteriores |
Ocorrência: | Configuração Mile para o Módulo Compras |
Ambiente: | SIGACOM - Compras |
Passo a passo: | O que é o MILE?O MILE é o 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 automáticas (MSExecAuto) e/ou rotinas desenvolvidas em MVC utilizando arquivos em formato texto (TXT). Conceito básico da ferramentaA 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- O que é um Canal?O canal pode ser utilizado para definir que informações estão sendo trabalhadas, 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.
Neste exemplo o canal "01", (no começo da linha) poderia ser o cabeçalho e o "02" os ítens. Um layout pode possuir um, vários ou nenhum canal. 2- O que é uma Unidade de Informação?Dentro de um arquivo texto iremos importar/exportar várias informações, mas cada layout se refere a um contexto (notas, pedidos, clientes, etc.). Dentro de cada contexto, cada conjunto de informações é uma unidade de informação. 3 - O que é um Adapter?Adapter é a aplicação responsável por processar as informações que foram obtidas a partir do arquivo texto. O que é um Layout?Layout é a configuração que permite, ao se ler um arquivo texto, identificar os dados contidos naquele arquivo e fazer o seu relacionamento com as informações dos adapters. 1- Composição do layoutUm layout pode ser configurado através da aplicação de manutenção de layouts (CFGA600) que se encontra no módulo do Configurador (SIGACFG) nas opções Ambiente / Aceleradores / MILE / Layouts
2- GeralContêm dados gerais do layout
Possui os campos: Layout: Código do Layout Descrição: Descrição do layout 1=MSExecAuto - Tratamento por rotina automática (MSExecAuto) (a rotina deve possuir esta característica)
Quando o tipo de adapter é:
Formatação do ArquivoContêm dados sobre o formato do arquivo texto.
Possui os campos: Arquivo TXT: Formato do arquivo texto 1=Fixo: Dados com largura fixa
| Pipe Atenção Se os dados contiverem algum dos símbolos dos separadores, os mesmo não serão importados corretamente.
1=Ponto Ex. 12345.67 2=Vírgula Ex. 12345,67 Atenção Se o tipo de separador de casas decimais não estiver correto, os dados não serão importados corretamente. Se os dados possuírem separadores de milhares, isto deve ser tratado no próprio layout utilizando o campo Execução. Entrada MultiCanal: Informa se o arquivo texto possui vários canais. Tratamentos e validaçõesContêm os nomes de funções específicas que podem ser definidas para tratamentos pontuais dos dados lidos.
Detalhes no link : MILE - Model Integrator Layout Engine Adapters de Rotina AutomáticaContêm definições de características específicas para adapters que são uma rotina automática (MSExecAuto).
Possui os campos:
1=Modelo 1 (Tabela simples) Outros modelos não são suportados. Detalhes Opcional: Quando o adapter é uma rotina 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ão. Importante A operação executada para adapters de rotina automática (MSExecAuto) sempre será apenas INCLUSÃO. Adapters em MVCContêm definições de características específicas para adapters em MVC.
Possui os campos:
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. Para configurar Canais sugerimos a leitura do link MILE - Model Integrator Layout Engine Exemplo do MATA020Criamos um exemplo de aplicação no MATA020 com os campos padrões do Cadastro de Fornecedores. Arquivos modelos: TXT de integração:
Exemplo layout:
1) Abra o arquivo XML do exemplo do layout acima pelo Módulo Configurador (Ambiente → Aceleradores → Mile → Layouts):
2) Após importe o arquivo TXT no configurador ou dentro do Cadastro de Fornecedores: Configurador:
Cadastro de Fornecedores:
Importante Substitua os Códigos do TXT com códigos existentes na base (código de fornecedor, loja, CNPJ, endereço, entre outros). Exemplo:
Exemplo de erro de recepção
Neste caso acima o CNPJ do fornecedor não era um código válido. Exemplo do MATA103Criamos um exemplo de aplicação no MATA103 com os campos padrões do Documento de Entrada. Arquivos modelos: TXT de integração: Exemplo layout:
1) Abra o arquivo XML do exemplo do layout acima pelo Módulo Configurador (Ambiente → Aceleradores → Mile → Layouts):
2) Após importe o arquivo TXT no configurador ou dentro do Documento de Entrada: Configurador:
Documento de Entrada:
Importante Substitua os Códigos do TXT com códigos existentes na base (código de fornecedor, número do documento, código do produto, centro de custo, entre outros). Exemplo:
Exemplo de erro de recepção
Neste caso acima o documento de entrada já havia sido cadastrado e o sistema não permite que haja duplicidade. Exemplo do MATA125Criamos um exemplo de aplicação no MATA125 com os campos padrões do Contrato de Parceria. Arquivos modelos: TXT de integração:
Exemplo layout:
1) Abra o arquivo XML do exemplo do layout acima pelo Módulo Configurador (Ambiente → Aceleradores → Mile → Layouts):
2) Após importe o arquivo TXT no configurador ou dentro do Contrato de Parceria: Configurador:
Contrato de Parceria:
Importante Substitua os Códigos do TXT com códigos existentes na base (número contrato de parceria, código do fornecedor, loja, condição de pagamento, entre outros). Exemplo:
Exemplo de erro de recepção
Neste caso acima a condição de pagamento inserida no TXT de integração é inválida (não consta cadastrada no Protheus). Exemplo do MATA121Criamos um exemplo de aplicação no MATA121 com os campos padrões do Pedido de Compra. Arquivos modelos: TXT de integração:
Exemplo layout:
1) Abra o arquivo XML do exemplo do layout acima pelo Módulo Configurador (Ambiente → Aceleradores → Mile → Layouts):
2) Após importe o arquivo TXT no configurador: Configurador:
Importante Substitua os Códigos do TXT com códigos existentes na base (número do pedido de compra, código do fornecedor, loja, condição de pagamento, entre outros). Exemplo:
Exemplo de erro de recepção
Neste caso acima a loja do forneceedor inserida no TXT de integração é inválida (não consta cadastrada em relação ao fornecedor informado). Exceções de uso do MileAlgumas rotinas do sistema que não possuem ExecAuto não estão preparadas para o uso da configuração Mile, exemplo disso é a rotina MATA161 - Análise de Cotação. |
Documentação complementar: |