Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Procedimento para Importação e Exportação de Layouts

Versões11.80 e 12   1. Composição de Layout se dos nas         2. Geral aba Gerais Contêm dados gerais do layout;

Possui os campos:

  • Layout: Código do Layout;
  • Descrição: Descrição do layout;
  • 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;

  • MSExecAuto: Informa se o nome da função de automática;
  • 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;

  • Versão do Layout: Versão do layout. Campo livre para informar a versão do layout.
  • 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) ) 

    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/2012

      • 2=aaaammdd Ano, mês e dia
        Ex. 20120501

    • Separador Decimal: Tipo de separador de casas decimais dos dados numéricos:

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

    IMPORTANTE: Como não é possível identificar se uma rotina está ou não preparada para trabalhar como rotina automática (MSExecAuto), se for cadastrado um layout para uma rotina que não possua esta característica, será apresenta da a opção de IMPORTAR, porém, essa opção gerará erro ao ser executada
     

     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.

    Evidência de Teste

    FATA150 (Categorias de Produtos x Produtos

    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;



    Na

    rotina

    Observações:

    1. Esse tratamento é para qualquer modulo e não exclusivo do Faturamento.
    2. Conforme a regra padrão da tabela de preços, quando se trata de alteração via Mile ou rotina automática (OMSA010) , é necessário que todos os itens da tabela sejam enviados,  para que a rotina entenda que se refere a um registro novo, ou a atualização de uma informação já existente.

    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

    Importação via Mile (Modelo 1)

    Importação via Mile (Modelo 2

    Rotinas não contempladas pelo Mile no Faturamento

    )