Configuração Mile para o Módulo Prestadores de Serviços
Produto: | Microsiga Protheus® |
Versões: | 12.1.25 e posteriores |
Ocorrência: | Configuração Mile para o Prestadores de Serviços |
Ambiente: | SIGATEC - Prestadores de Serviços |
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 TECA040Criamos um exemplo de aplicação no TECA040 (arquivos no link abaixo) com os campos padrões do Pedido de Vendas. Para importar : 1) Abra o arquivo XML do link pelo Modulo Configurador
2) Importe o arquivo TXT dentro do Pedido de Vendas
Importante Substitua os Códigos do TXT com códigos existentes na base (código de cliente, código de produto, entre outros) Exemplo:
É possível validar o recebimento do registro no Modulo Configurador
Exemplo de erro de recepção
Neste caso acima data no arquivo txt estava sem // para separar.
Acesso o Modulo Configurador, entra no Mile posiciona encima do layout e Outras Ações >> LOG.
Consulta o LOG da Ultima Operação. Exemplo do TECA040Download do exemplo: |
Documentação complementar: |