Histórico da Página
...
Procedimento para Importação e Exportação de Layouts
Possui os campos:
Tipo de Adapter: Tipo de Adapter:
- 1= MSExecAuto: Tratamento por rotina automática;
2=MVC: Tratamento por rotina em MVC;
3=Função: Tratamento por função específica. Neste caso os dados serão lidos pela ferramenta e passados para função;
Adapter: Nome do Adapter;
MVC: Informa se nome do FONTE(.pr?) que contêm o modelo de dados (MODELDEF);
Função: Informa se o nome da função que irá receber os dados lidos;
Tabela principal: Alias da tabela principal utilizada na importação. A área corrente é apontada para este alias antes de se efetuar a importação;
Ordem: Ordem da tabela principal utilizada na importação. A ordem da tabela principal é pontada para esta ordem antes de se efetuar a importação;
ATENÇÃO: Não há controle de versionamento, este é apenas um campo livre para controle manual da versão.
3. Formatação do Arquivo
Contêm dados sobre o formato do arquivo texto;
Possui os campos:
ArquivoTXT: Formato do arquivo texto;
- 1=Fixo:Dados com largura fixa;
- 2=Separador:-Dados usam algum separador entre si;
- Separador: Se o formato do arquivo texto for por separador, informar o carácter separador utilizado. Os carácter aceitos são:
| Pipe
; Ponto
-
e
-
vírgula
, Vírgula
/ Barra
-
Traço
Tab Tabulação ( Chr(9) )
- Separador: Se o formato do arquivo texto for por separador, informar o carácter separador utilizado. Os carácter aceitos são:
ATENÇÃO: Se os dados contiverem algum dos símbolos dos separadores, os mesmo não serão importados corretamente.
- Separador Inicial: Quando o layout possui separadores, define se o layout possui um separador inicial em suas linhas;
Separador Final: Quando o layout possui separadores, define se o layout possui um separador final em suas linhas;
Origem do Canal: Posição de onde está a informação de canal do layout;
Quando o formato do TXT é largura fixa informa se a posição inicial e final separadas por um traço. Ex. 0001-0005;
Quando o formato do TXT é por separador informa se a posição da informação. Ex. 0001, isso significa que o canal é o 1º campo da linha;
Quando não há canais informar 0000-0000 ou 0000 conforme o formato;
Formato Data: Formato dos campos de data:
1=dd/mm/aa Dia, mês e ano
Ex. 01/05/12 ou 01/05/20122=aaaammdd Ano, mês e dia
Ex. 20120501
Separador Decimal: Tipo de separador de casas decimais dos dados numéricos:
1=Ponto
Ex. 12345.672=Vírgula
Ex. 12345,67
Entrada Multi Canal: Informa se o arquivo texto possui vários canais.
4. Tratamentos e Validações
Contêm os nomes de funções específicas que podem ser definidas para tratamentos pontuais dos dados lidos;
Possui os campos:
- Pré Execução: Nome da função que será executada antes da execução do adapter;
Pós Execução: Nome da função que será executada após da execução do adapter;
Trat. Dados: Nome da função que será executada para tratamento dos dados;
Valid. Operação:Nome da função para validação da operação.
5. Adapters de Rotina Automática
Contêm definições de características específicas para adapters que são uma rotina automática;
Possui os campos:
- Tipo MSExecAuto: Se o tipo de adapter for uma rotina automática, informar o modelo do rotina automática. São suportados 3 modelos:
- 1=Modelo 1(Tabela simples);
- 2=Modelo 2(1 Tabela com cabeçalho/ítens);
- 3=Modelo 3(2 Tabelas diferentes cabeçalho/ítens);
- Outros modelos não são suportados.
6. Adapters em MVC
Contêm definições de características específicas para adapters em MVC;
Possui os campos:
- Operações Importação: Para adapters em 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.
7. Canais
Faz a manutenção dos canais. Mesmo quando o arquivo texto (TXT) não possuir canais, deverá ser criado um canal fictício com qualquer código;
Botão Incluir: Inclui um novo canal;
Botão Alterar: Alterar o código de um canal;
Botão Excluir: Exclui um canal e todos os outros que estiverem abaixo dele.
7.1 Detalhes do Canal:
Possui os campos:
- Canal: Código do canal;
- Descrição: Descritivo do canal;
- ID Saída: Identifica o destino dos dados;
Se o tipo de adapter for rotina automática MSExecAuto, deve ser MASTER ou DETAIL conforme o modelo do rotina automática (Modelo 1 apenas MASTER, demais MASTER/DETAIL);
Se o tipo de adapter for MVC deve ser um dos IDs dos componentes do modelo de dados;
Se o tipo de adapter for Função deve ser MASTER ou DETAIL similarmente a rotina automática (MSExecAuto);
- Ocorrência: Ocorrência do canal no layout. Para uma unidade de informação (1 cadastro, 1 pedido, 1 nota, etc.) informa a ocorrência do canal:
1=Única: O canal ocorre apenas 1 vez para cada unidade de informação;
N=Várias: O canal ocorre várias vezes para cada unidade de informação;
- Pós Execução: Função executada após a leitura dos dados do canal.
8. Integração com o Browse
Existe uma integração da ferramenta com o Browse das rotinas do sistema que permite que ao ser cadastrado um layout para uma determinada rotina do sistema adapter automaticamente o Browse apresentará uma opção a mais em seu menu que permitirá fazer a importação ou exportação utilizando este layout.
Por exemplo, imaginemos a criação de um layout para a importação de produtos, no sistema a aplicação que faz isso é a MATA010 que possui o tratamento para rotina automática MSExecAuto.
- Faça a criação do layout;
Após a criação do layout ao entrarmos na tela da aplicação de Cadastro De Produtos, já estará disponibilizada uma opção para importação em Opções / Importar;
Ao clicar em Importar é apresentada uma tela com os Layouts disponíveis para aquela rotina adapter;
Nesta tela o usuário que possui acesso à aplicação de Cadastro de Produtos poderá fazer a importação de um arquivo texto utilizando o layout criado;
Nesta tela também poderá ser visualizado o layout, impressa a documentação ou visualizado os Logs gerados. Se a aplicação for em MVC aparecerão mais algumas opções;
- Serão apresentadas as opções de Visualizar, Incluir, Alterar, Excluir, Copiar, Documentação e Log;
Eventualmente o administrador do sistema poderá alterar essas permissões através do Cadastro de Privilégios do sistema.
9. Características das exportações
- As exportações serão realizadas somente para adapters em MVC e baseadas no modelo de dados do mesmo.
- Se o componente do modelo for um formulário FORMFIELD será gerada uma linha no arquivo de texto de exportação.
- Se o componente do modelo for um grid FORMGRID será gerada uma linha para cada linha do grid no arquivo de texto de exportação.
- O layout de exportação referencia o alias da tabela que será exportada, se houver um filtro aplicado a esta tabela, este filtro será respeitado.
Produto: | Microsiga Protheus | ||||||
Ambiente: | Faturamento (SIGAFAT) | ||||||
Ocorrência: | Orientação de layout para tratamento do Mile | ||||||
Ambiente: | SIGAFAT - Faturamento | ||||||
Passo a passo: | Layout é a configuração que permite que, ao | ler um arquivo texto, identificar os dados contidos naquele arquivo e fazer o seu relacionamento com as informações | dos adapters. Um 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; |
| rotina | |
Observações: |
| ||||||
de Layouts é possível realizar a importação e exportação dos Layouts. Para entender mais sobre esse processo veja nosso vídeo How To: How To | MP - SIGAFAT - Mile: Logs e Importação de Layouts | |||||||
Pode lhe interessar: | Configuração Mile para o Módulo Faturamento | Rotinas não contempladas pelo Mile no Faturamento |