Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

Descrição

Essa documentação tem por objetivo descrever o novo

Novo processo de importação de abastecimento

do módulo de Manutenção de Ativos, que fará a integração dos antigos processos de importação, Importação Convênio CTF (MNTA130), Importação de Convênio Ticket (MNTA631), Importação Convênio GoodCar (MNTA986) e Importação GTFrota (MNTA131) em um processo unificado: Importação de Abastecimento (MNTA716). Também será descrito as melhorias feita no processo de Análise Consistência.

Resumo

Segue abaixo um breve resumo das implementações da Importação de Abastecimento

  • Desabilitado os convênios: 
    • MNTA130 - CTF; 
    • MNTA631 - Ticket; 
    • MNTA986 - GoodCar; 
    • MNTA131 - GTFrota; 
  • Criado o Cadastro padrão de Layout; 
  • Criado processo unificado de importação de abastecimento; 
  • Realizada melhorias no processo de análise consistência.
  • Rotinas Alteradas 
    • MNTA635 – Consistência 
    • MNTA700 – Análise Consistência
  • Rotinas Novas 
    • MNTA715 – Layout de Importação
    • MNTA716 – Importação de Abastecimentos
  •  

    Importante

    Antes de executar o compatibilizador UPDMNTC5 é imprescindível:

    • Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório \PROTHEUS11_DATA\DATA) e dos dicionários de dados SXs (diretório \PROTHEUS11_DATA\SYSTEM).
    • Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
    • Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
    • Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
    • O compatibilizador deve ser executado com a Integridade Referencial desativada*.

     

    Atenção

    O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de Banco de Dados (DBA) ou equivalente!

    A ativação indevida da Integridade Referencial pode alterar   drasticamente o relacionamento entre tabelas no banco de dados. Portanto,   antes de utilizá-la, observe atentamente os procedimentos a seguir:

    1. No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opção Integridade/Verificação(APCFG60A).
    2. Se não há Integridade Referencial ativa, são relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema e nenhuma delas estará selecionada. Neste caso, E SOMENTE NESTE, não é necessário qualquer outro procedimento de ativação ou desativação de integridade, basta finalizar a verificação e aplicar normalmente o compatibilizador, conforme instruções.
    3.  Se há Integridade Referencial ativa em todas as empresas e filiais, é exibida uma mensagem na janela Verificação de relacionamento entre tabelas. Confirme a mensagem para que a verificação seja concluída, ou;
    4.  Se há Integridade Referencial ativa em uma ou mais empresas, que não na sua totalidade, são relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema e, somente, a(s) que possui(em) integridade está(arão) selecionada(s). Anote qual(is) empresa(s) e/ou filial(is) possui(em) a integridade ativada e reserve esta anotação para posterior consulta na reativação (ou ainda, contate nosso Help Desk Framework para informações quanto a um arquivo que contém essa informação).
    5. Nestes casos descritos nos itens “iii” ou “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).
    6. Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instruções.
    7. Aplicado o compatibilizador, a Integridade Referencial deve ser reativada, SE E SOMENTE SE tiver sido desativada, através da opção Integridade/Ativar (APCFG60). Para isso, tenha em mãos as informações da(s) empresa(s) e/ou filial(is) que possuía(m) ativação da integridade, selecione-a(s) novamente e confirme a ativação.

     

    Contate o Help Desk Framework EM CASO DE DÚVIDAS!

     

    1. Em Microsiga Protheus TOTVS Smart Client, digite U_UPDMNTC5 no campo Programa Inicial.
    2. Clique em OK para continuar.
    3. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado.
    4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
      1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos. 
        É apresentada uma mensagem explicativa na tela.
      2. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
      3. Clique em Gravar para salvar o histórico (log) apresentado.
      4. Clique em OK para encerrar o processamento.

    Procedimento para Implantação

    O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.

    1. Aplique o patch do chamado e execute/acesse qualquer rotina através da entrada do módulo de Manutenção de Ativos para acionar a função de entrada de sistema para criar os layouts padrões de importação, bem como os novos nomes de campo e atualização de erros da SX5..

    .

    Características do Requisito

    Linha de Produto:

    Microsiga Protheus

    Segmento:

    Manufatura 

    Módulo:

    Manutenção de Ativos

    Rotina:

    Rotina

    Nome Técnico

    MNTA716
    Importação de Abastecimentos
    MNTA715
    Layout de Importação

    Rotina(s) envolvida(s)

    Nome Técnico

    MNTA635Consistencia dos registros de abastecimento
    MNTA700Análise da Consistência

    País(es):

    Todos

    Banco(s) de Dados:

    Todos

    Tabelas Utilizadas:

    TR6 - Abastecimentos Importados;
    TQ7 - Dados do Layout;
    TQ8 - Estrutura do Layout;
    TQQ - Abastecimentos Rejeitados;

    TQP - Inconsistencias Abastecimentos.

    Sistema(s) Operacional(is):

    Todos

    Descrição

    A presente documentação tem por objetivo descrever o novo processo de importação de abastecimento do módulo de Manutenção de Ativos. Esse fará a centralização dos antigos métodos de importação, Importação Convênio CTF (MNTA130), Importação de Convênio Ticket (MNTA631), Importação Convênio GoodCard (MNTA986) e Importação GTFrota (MNTA131) em uma única rotina: Importação de Abastecimento (MNTA716).

    Em consequência da implementação da nova rotina de importação, houve a necessidade de otimização no processo de Análise Consistência. As alterações realizadas serão discriminadas no decorrer da documentação.

    Resumo

    Segue abaixo um breve resumo das implementações da Importação de Abastecimento
    • Desabilitadas do menu as rotinas de:
      • MNTA130 - CTF;
      • MNTA631 - Ticket;
      • MNTA986 - GoodCard;
      • MNTA131 - GTFrota.
    • Criada rotina de cadastro de layouts, contendo como padrão os esquemas dos convênios mencionados acima. 
    • Criado processo centralizado de importação de abastecimento.
    • Realizada otimizações no processo de análise consistência.
    • Rotinas Alteradas:
      • MNTA635 – Consistência;
      • MNTA660 – Reprocessamento dos registros rejeitados;
      • MNTA700 – Análise Consistência;
      • mntutil       – Funções Genéricas;
      • mntutil_contador – Funções Genéricas de Contador.
    • Rotinas Novas:
      • MNTA715 – Layout de Importação;
      • MNTA716 – Importação de Abastecimentos.

    Importante

    Antes de executar o compatibilizador UPDMNTD1 é imprescindível:

    • Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório \PROTHEUS11_DATA\DATA) e dos dicionários de dados SXs (diretório \PROTHEUS11_DATA\SYSTEM).
    • Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
    • Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
    • Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
    • O compatibilizador deve ser executado com a Integridade Referencial desativada*.

     

    Atenção

    O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de Banco de Dados (DBA) ou equivalente!

    A ativação indevida da Integridade Referencial pode alterar   drasticamente o relacionamento entre tabelas no banco de dados. Portanto,   antes de utilizá-la, observe atentamente os procedimentos a seguir:

    1. No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opção Integridade/Verificação(APCFG60A).
    2. Se não há Integridade Referencial ativa, são relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema e nenhuma delas estará selecionada. Neste caso, E SOMENTE NESTE, não é necessário qualquer outro procedimento de ativação ou desativação de integridade, basta finalizar a verificação e aplicar normalmente o compatibilizador, conforme instruções.
    3.  Se há Integridade Referencial ativa em todas as empresas e filiais, é exibida uma mensagem na janela Verificação de relacionamento entre tabelas. Confirme a mensagem para que a verificação seja concluída, ou;
    4.  Se há Integridade Referencial ativa em uma ou mais empresas, que não na sua totalidade, são relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema e, somente, a(s) que possui(em) integridade está(arão) selecionada(s). Anote qual(is) empresa(s) e/ou filial(is) possui(em) a integridade ativada e reserve esta anotação para posterior consulta na reativação (ou ainda, contate nosso Help Desk Framework para informações quanto a um arquivo que contém essa informação).
    5. Nestes casos descritos nos itens “iii” ou “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).
    6. Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instruções.
    7. Aplicado o compatibilizador, a Integridade Referencial deve ser reativada, SE E SOMENTE SE tiver sido desativada, através da opção Integridade/Ativar (APCFG60). Para isso, tenha em mãos as informações da(s) empresa(s) e/ou filial(is) que possuía(m) ativação da integridade, selecione-a(s) novamente e confirme a ativação.

     

    Contate o Help Desk Framework EM CASO DE DÚVIDAS!

     

    1. Em Microsiga Protheus TOTVS Smart Client, digite U_UPDMNTD1 no campo Programa Inicial.
    2. Clique em OK para continuar.
    3. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado.
    4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
      1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos. 
        É apresentada uma mensagem explicativa na tela.
      2. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
      3. Clique em Gravar para salvar o histórico (log) apresentado.
      4. Clique em OK para encerrar o processamento.

    Procedimento para Implantação

    O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste ticket.

    1. Aplique o patch do ticket e execute/acesse qualquer rotina através da entrada do módulo de Manutenção de Ativos para acionar a função de entrada de sistema para criar os layouts padrões de importação, bem como os novos nomes de campo e atualização de erros da SX5..

    Atualizações do Compatibilizador

    1.    Criação de tabela no arquivo SX2– Tabelas:

    Chave

    Nome

    Modo

    PYME

    TQ7

    Dados do Layout

    Compartilhado

    N

    TQ8

    Estrutura do Layout

    Compartilhado

    N


    2. Criaçãode Campos no arquivo SX3 – Campos:

    • Tabela TQ7 - Dados do Layout:

    Campo

    TQ7_FILIAL

    TQ7_CODLAY

    TQ7_DESLAY

    TQ7_TABELA

    TQ7_DESTAB

    TQ7_TIPARQ

    TQ7_SEPARD

    TQ7_FORDTA

    TQ7_SEPDEC

    TQ7_INDCAB

    TQ7_INDROD

    TQ7_MSBLQL

    Tipo

    Carácter

    Carácter

    Carácter

    Carácter

    Carácter

    Carácter

    Carácter

    Carácter

    Carácter

    Carácter

    Carácter

    Carácter

    Tamanho

    8

    6

    150

    3

    150

    1

    1

    1

    1

    1

    1

    1

    Decimal

    0

    0

    0

    0

    Atualizações do Compatibilizador

    1.    Criação de tabela no arquivo SX2– Tabelas:

    Chave

    Nome

    Modo

    PYME

    TQ7

    Dados do Layout

    Compartilhado

    N

    TQ8

    Estrutura do Layout

    Compartilhado

    N

    2. Criaçãode Campos no arquivo SX3 – Campos:
    • Tabela TQ7 - Dados do Layout:

    Campo

    TQ7_FILIAL

    TQ7_CODLAY

    TQ7_DESLAY

    TQ7_TABELA

    TQ7_DESTAB

    TQ7_TIPARQ

    TQ7_SEPARD

    TQ7_FORDTA

    TQ7_SEPDEC

    TQ7_INDCAB

    TQ7_INDROD

    Tipo

    Caracter

    Caracter

    Caracter

    Caracter

    Caracter

    Caracter

    Caracter

    Caracter

    Caracter

    Caracter

    Caracter

    Tamanho

    8

    6

    150

    3

    150

    1

    1

    1

    1

    1

    1

    Decimal

    0

    0

    0

    0

    0

    0

    0

    0

    0

    0

    0

    Formato

     

     

    @!

    @!

    @!

    @!

    @!

    @!

    @!

    @!

    @!

    Título

     Filial

     Cod. Layout

    Desc. Layout

    Cód. Tabela

    Desc. Tabela

    Arquivo TXT

    Separador

    Formato Data

    Sep. Decimal

    Cabeçalho

    Ind. Rodape

    Descrição

    Filial

    Código do Layout

    Descrição do

    Layout

    Tabela Principal

    Descrição

    da Tabela

    Tipo de

    Arquivo TXT

    Tipo

    Separador

    Formato Data

    Separador

    Decimal

    Indica

    cabeçalho

    Indica Rodapé

    Nível

    1

    1

    1

    1

    1

    1

    1

    1

    1

    1

    1

    Usado

    Não

    Sim

    Sim

    Sim

    Sim

    Sim

    Sim

    Sim

    Sim

    Sim

    Sim

    Obrigatório

    Não

    Sim

    Sim

    Sim

    Sim

    Sim

    Não

    Sim

    Sim

    Sim

    Sim

    Browse

    Sim

    Sim

    Sim

    Não

    Não

    Não

    Não

    Não

    Não

    Não

    Não

    Opções

     

     

     

     

     

    1=Fixo;

    2=Separador

    1=Pipe;

    2=Ponto-e-

    Virgula;

    3=Traco;

    4=Tab

    1=dd/mm/aaaa;

    2=ddmmaaaa;

    3=aaaa/mm/dd;

    4=aaaammdd

    1=Ponto;

    2=Vírgula

    1=Sim;

    2=Não

    1=Sim;

    2=Não

    When

     

     

     

     

     

     

    lSeparador

     

     

     

     

    Relação

     

    GETSXENUM
    ("TQ7","TQ7_CODLAY")

     

     

     

     

     

     

     

     

     

    Val. Sistema

     

     

     

     

     

     

     

     

     

     

     

    Help

    Filial

    Código do Layout

    Descrição do

    Layout

    Código da Tabela

    Principal com os

    campos a serem

    utilizados na

    importação do

    abastecimento.

    Descrição da

    Tabela

    Principal.

    Tipo de Arquivo

    TXT.

    Tipo de

    separador

    dos registros

    do arquivo

    TXT.

    Formato da

    data dos

    registros

    importados

    Tipo de separador

    dos numeros

    decimais.

    Indica se o Layout

    possui cabeçalho,

    se tiver, o mesmo

    é ignorado na

    importação.

    Indica se o Layout

    possui rodapé(totalizador)

    ao final do arquivo,

    se tiver, o mesmo é

    ignorado

    na importação.

     

    • Tabela TQ8 - Estrutura do Layout:

     

    DecimalNívelSim

    Campo

    TQ8_FILIAL

    TQ8_CODLAY

    TQ8_SEQUEN

    TQ8_CPOTAB

    TQ8_POSINI

    TQ8_TAMARQ

    TQ8_POSFIM

    TQ8_CONTEU

    Tipo

    Caracter

    Caracter

    Numérico

    Caracter

    Numérico

    Numérico

    Numérico

    Caracter

    Tamanho

    8

    6

    3

    10

    4

    3

    3

    20

    0

    0

    0

    0

    0

    0

    0

    0

    Formato

     

     

    999

     

    9999

    999

    999

    @!

    @!

    @!

    @!

    @!

    @!

    @!

    @!

    @!

    @! 

    Título

    Filial

    Cod. Layout 

    Seq. Campo

    Campo

    Inicio

    Tamanho

    Fim

    Cód. Layout

    Desc. Layout

    Cód. Tabela

    Desc. Tabela

    Arquivo TXT

    Separador

    Formato Data

    Sep. Decimal

    Cabeçalho

    Ind. Rodapé

    Bloqueado? Conteúdo

    Descrição

    Filial

    Código do Layout

    Descrição do Layout

    Sequência do

    Campo

    Campos do

    layout

    Posicao Inicial

    na linha

    Tamanho do

    campo

    Posição Final

    da Linha

    Contéudo do

    registro

    Tabela principal

    Descrição da Tabela

    Tipo de Arquivo TXT

    Tipo Separador

    Formato Data

    Separador Decimal

    Indica cabeçalho

    Indica Rodapé

    Registro bloqueado

    Nível

    1

    1

    1

    1

    1

    1

    1

    1

    1

    1

    1

    1

    Usado

    Não

    Sim

    Sim

    Sim

    Sim

    Sim

    Sim

    Sim

    Obrigatório

    Não

    Sim

    Sim

    Sim

    Sim

    Sim

    Obrigatório

    Não

    Browse

    Sim

    Sim

    Não

    Sim

    Sim

    Não

    Sim

    Não

    Opções

     

     

     

     

     

     

     

     

    When

     

     

     

     

     

     

     

     

    Relação

     

     

     

     

     

     

     

     

    Val. Sistema

     

     

     

     

     

     

     

     

    Help

    Filial

    Código do

    Layout

    Sequência do campo

    na importação do

    layout

    Campos da tabela

    principal que fazem

    parte da configuração

    do layout

    Posicao Inicial

    do registro na

    linha do arquivo

    TXT que esta

    sendo lido.

    Tamanho do

    campo no

    arquivo TXT.

    Posicao final

    do registro na

    linha do arquivo

    TXT que esta

    sendo lido.

    Conteúdo de

    exemplo do

    registro a ser

    importado.

    Importante:

    O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.

     

    5.  Criação ou Alteração de Consulta Padrão no arquivo SXB – Consulta Padrão:

    • Pesquisa B05PLS:

    Alias

    (XB_ALIAS)

    Tipo

    (XB_TIPO)

    Sequência

    (XB_SEQ)

    Coluna

    (XB_COLUNA)

    Descrição

    (XB_DESCRI)

    Contém

    (XB_CONTEM)

     

    6.  Criação ou Alteração de Índices no arquivo SIX – Índices:

    Índice

    AA1

    Ordem

    6

    Chave

    AA1_FILIAL+AA1_CODVEN

    Descrição

    Cod. Vendedor

    Proprietário

    S

     

    7.  Criação ou Alteração de Parâmetros no arquivo SX6 – Parâmetros:

    Nome da Variável

    (X6_VAR)

    Tipo

    (X6_TIPO)

    Descrição

    (X6_DESCRIC + X6_DESC1 + X6_DESC2)

    Valor Padrão

    (X6_CONTEUD)

     

    8.  Criação ou Alteração (mantenha somente a instrução correspondente) de Gatilhos no arquivo SX7 – Gatilhos:

    • Tabela BD5 – Contas Médicas:

    Campo

    Informe o conteúdo do (X7_CAMPO)

    Sequência

    Informe o conteúdo do (X7_SEQUENC)

    Campo Domínio

    Informe o conteúdo do (X7_CDOMIN)

    Tipo

    Informe o conteúdo do (X7_TIPO)

    Regra

    Informe o conteúdo do (X7_REGRA)

    Posiciona?

    Informe o conteúdo do (X7_SEEK)

    Chave

    Informe o conteúdo do (X7_CHAVE)

    Condição

    Informe o conteúdo do (X7_CONDIC)

    Proprietário

    Informe o conteúdo do (X7_PROPRI)

     

    Campo

    TQ7_FILIAL

    TQ7_CODLAY

    TQ7_DESLAY

    TQ7_TABELA

    TQ7_DESTAB

    TQ7_TIPARQ

    TQ7_SEPARD

    TQ7_FORDTA

    TQ7_SEPDEC

    TQ7_INDCAB

    TQ7_INDROD

    Tipo

    Caracter

    Caracter

    Caracter

    Caracter

    Caracter

    Caracter

    Caracter

    Caracter

    Caracter

    Caracter

    Caracter

    Tamanho

    8

    6

    150

    3

    150

    1

    1

    1

    1

    1

    Sim

    Sim

    Sim

    Não

    Sim

    Sim

    Sim

    Sim

    Não

    Browse

    Sim

    Sim

    Sim

    Não

    Não

    Não

    Não

    Não

    Não

    Não

    Não

    Não

    Opções

     

     

     

     

     

    1=Fixo; 2=Separador

    1=Pipe; 2=Ponto-e-Virgula; 3=Traco; 4=Tab

    1=dd/mm/aaaa; 2=ddmmaaaa; 3=aaaa/mm/dd; 4=aaaammdd

    1=Ponto; 2=Vírgula

    1=Sim; 2=Não

    1=Sim; 2=Não

    1=Sim; 2=Não

    When

     

     

     

     

     

     

    lSeparador

     

     

     

     

     

    Relação

     

    GETSXENUM
    ("TQ7","TQ7_CODLAY")

     

     

     

     

     

     

     

     

     

     

    Val. Sistema

     

     

     

     

     

     

     

     

     

     

     

     

    Help

    Filial

    Código do Layout

    Descrição do Layout

    Código da Tabela Principal com os campos a serem utilizados na importação do abastecimento.

    Descrição da Tabela Principal.

    Tipo de Arquivo TXT.

    1-Fixo: A posição dos registros é definida pelo tamanho.

    2-Separador: A posição é definida por um separador específico.

    Tipo do separador específico que delimitará a posição inicial/final de cada registros do arquivo TXT.

    1=Pipe; 2=Ponto-e-Vírgula; 3=Traço; 4=Tab

    Formato da data dos registros importados.

    1=dd/mm/aaaa; 2=ddmmaaaa; 3=aaaa/mm/dd; 4=aaaammdd

    Tipo de separador dos números decimais.

    1=Ponto: os valores decimais são separados por ponto.

    2=Vírgula: os valores decimais são separados por vírgula.

    Indica se o Layout possui cabeçalho, se tiver, o mesmo é ignorado na importação.

    1=Sim; 2=Não

    Indica se o Layout possui rodapé (totalizador) ao final do arquivo, se tiver, o mesmo é ignorado na importação.

    1=Sim; 2=Não

    Indica bloqueio do registro para uso, sendo:

    1: Sim, registro bloqueado; 2: Não, registro não bloqueado.

     

    • Tabela TQ8 - Estrutura do Layout:

    Campo

    TQ8_FILIAL

    TQ8_CODLAY

    TQ8_SEQUEN

    TQ8_CPOTAB

    TQ8_TIPO

    TQ8_POSINI

    TQ8_TAMARQ

    TQ8_POSFIM

    TQ8_CONTEU

    TQ8_FUNCAO

    Tipo

    Carácter

    Carácter

    Numérico

    Carácter

    Carácter

    Numérico

    Numérico

    Numérico

    Carácter

    Carácter

    Tamanho

    8

    6

    3

    10

    1

    4

    3

    3

    20

    80

    1

    Decimal

    0

    0

    0

    0

    0

    0

    0

    0

    0

    0

    0

    Formato

     

     

    @!

    999

    @!

     

    @!
     
    @!

    9999

    @!

    999

    @!

    999

    @!

     

    @!

     

    @!

    Título

     Filial

     Cod. Layout

    Título

    Filial

    Cód

    Desc

    . Layout 

    Cód

    Seq.

    Tabela

    Campo

    Desc. Tabela

    Arquivo TXT

    Separador

    Formato Data

    Sep. Decimal

    Cabeçalho

    Campo

    Tipo

    Início

    Tamanho

    Fim

     Conteúdo

    Função

    Ind. Rodape

    Descrição

    Filial

    Código do Layout

    Descrição

    Sequência do

    Layout

    Tabela Principal

    Descrição

    da Tabela

    Tipo de

    Arquivo TXT

    Tipo

    Separador

    Formato Data

    Separador

    Decimal

    Indica

    cabeçalho

    Indica Rodapé

    Nível

    Campo

    Campos do layout

    Tipo do Campo

    Posição Inicial na linha

    Tamanho do campo

    Posição Final da Linha

    Conteúdo do registro

    Função de processamento

    Nível

    1

    1

    1

    1

    1

    1

    1

    1

    1

    1

    1

    Usado

    Não

    Sim

    Sim

    Sim

    Sim

    Sim

    Sim

    Sim

    Sim

    Sim

    Obrigatório

    Não

    Sim

    Sim

    Sim

    Sim

    Sim

    Sim

    Sim

    Não

    Não

    Browse

    Sim

    Obrigatório

    Sim

    Não

    Sim

    Não

    Sim

    Sim

    Sim

    Sim

    Não

    Sim

    Sim

    Sim

    Sim

    Browse

    Sim

    Sim

    Sim

    Não

    Não

    Não

    Não

    Não

    Não

    Não

    Não

    Não

    Sim

    Não

    Não

    Opções

     

     

     

     

     

     

     

     

     

     

    When

     

     

     

     

     

     

     

     

     

     

    Relação

     

     

     

     

     

     

    Opções

     

     

     

     

    Val. Sistema

     

    1=Fixo;

    2=Separador

    1=Pipe;

    2=Ponto-e-

    Virgula;

    3=Traco;

    4=Tab

    1=dd/mm/aaaa;

    2=ddmmaaaa;

    3=aaaa/mm/dd;

    4=aaaammdd

    1=Ponto;

    2=Vírgula

    1=Sim;

    2=Não

    1=Sim;

    2=Não

    When

     

     

     

     

     

     

    lSeparador

     

     

     

     

    Relação

     

    GETSXENUM
    ("TQ7","TQ7_CODLAY")

     

     

     

     

     

     

     

     

     

    Val. Sistema

     

     

     

     

     

     

     

     

     

     

     

    Help

    Filial

    Código do Layout

    Descrição do

    Layout

    Código da Tabela

    Principal com os

    campos a serem

    utilizados na

    importação do

    abastecimento.

    Descrição da

    Tabela

    Principal.

    Tipo de Arquivo

    TXT.

    Tipo de

    separador

    dos registros

    do arquivo

    TXT.

    Formato da

    data dos

    registros

    importados

    Tipo de separador

    dos numeros

    decimais.

    Indica se o Layout

    possui cabeçalho,

    se tiver, o mesmo

    é ignorado na

    importação.

    Indica se o Layout

    possui rodapé(totalizador)

    ao final do arquivo,

    se tiver, o mesmo é

    ignorado

     

     

     

     

     

     

     

     

     

    Help

    Filial

    Código do Layout

    Sequência do campo na importação do layout

    Campos da tabela principal que fazem parte da configuração do layout

    Tipo de campo.

    1=Caracter; 2=Numérico; 3=Data

    Posição Inicial do registro na linha do arquivo TXT que está sendo lido.

    Tamanho do campo no arquivo TXT.

    Posição final do registro na linha do arquivo TXT que está sendo lido.

    Conteúdo de exemplo do registro a ser importado.

    Função para validação do registro a ser lido.


    Importante:

    O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.

    3.  Criação de Consulta Padrão no arquivo SXB – Consulta Padrão:
    • Pesquisa TQ7 - Layout Abastecimento:

    Alias

    TQ7  

    TQ7  

    TQ7  

    TQ7  

    TQ7  

    Tipo

    1

    2

    4

    4

    5

    Sequência

    01

    01

    01

    01

    01

    Coluna

    DB

    01

    01

    02

     

    Descrição

    Layout Abastecimento

    Código do Layout

    Cód. Layout

    Desc. Campo

     

    Contém

    TQ7

     

    TQ7_CODLAY

    TQ7_DESLAY

    TQ7->TQ7_CODLAY

     

    4.  Criação de Índices no arquivo SIX – Índices:

    • Tabela TQ7 - Dados do Layout

    Índice

    TQ7

    Ordem

    1

    Chave

    TQ7_FILIAL + TQ7_CODLAY

    Descrição

    Código do Layout

    Proprietário

    S

     

    • Tabela TQ8 - Estrutura do Layout

    Índice

    TQ8

    Ordem

    1

    Chave

    TQ8_FILIAL + TQ8_CODLAY + STR(TQ8_SEQUEN)

    Descrição

    Código do Layout + Sequência de Campo

    Proprietário

    S

    na importação.

    Procedimento para Utilização

    Deck of Cards
    idPasso a Passo
    Card
    labelLayout de Importação (MNTA715)

    1.

    Acesse Atualizações / Controle de Abastecimento / Abastecimento / Layout de Importação

    Acesse a rotina de Layout de Importação em Atualizações / Controle de Abastecimento / Abastecimento / Layout de Importação (MNTA715). 

    *

    Esse

    processo

    não

    é

    obrigatório,

    visto

    que a base já possui os layouts padrões já cadastrados. Mas será possível alterá-los ou criar novos layouts. 

    que a base já possui os layouts padrões cadastrados. Porém é possível efetuar alterações nos layouts padrões quando necessário e realizar a inclusão de novos layouts 

    O programa apresenta os layouts de importação cadastrados.

    2. Na inclusão de um layout, faz-se necessário o preenchimento dos campos obrigatórios que definem as características de como serão importados os registros de abastecimento. Abaixo está descrito como preenche-los:

                   a. Cód. Layout (TQ7_CODLAY) – Gerado automaticamente de maneira sequencial;

                   b. Desc. Layout (TQ7_DESLAY) – Deve ser informada uma descrição para o layout;

                   c. Cód. Tabela (TQ7_TABELA) – Exibe o código referente a tabela de abastecimentos importados (TR6);

                   d. Desc. Tabela (TQ7_DESTAB) – Exibe a descrição da tabela TR6.

                   e. Arquivo TXT (TQ7_TIPARQ) – Deve ser informado qual o tipo de arquivo que estará sendo importado. Sendo que o mesmo pode ser “1 = Fixo” ou “2 = Separador”:

                                  * 1 = Fixo: As posições dos campos são definidas por um tamanho fixo;

                                  * 2 = Separador: As posições dos campos são definidas por um caractere de separação definido através do campo Separador (TQ7_SEPARD).

                   f. Separador (TQ7_SEPARD) – Deve ser informado qual o tipo de separador utilizado para definir o término e início dos campos do layout. Esse campo apenas será habilitado quando o campo Arquivo TXT (TQ7_TIPARQ)  estiver com o conteúdo “2 = Separador”. Os tipos disponíveis são:

                                   * Pipe ( | );

                                   * Ponto e vírgula ( ; );

                                   * Traço ( - );

                                   * Tab.

                   g. Formato Data (TQ7_FORDTA) – Deve ser informado o tipo do formato dos campos data utilizados no layout de importação. Os tipos disponíveis são:

                                   * 1 = dd/mm/aaaa;

                                   * 2 = ddmmaaaa;

                                   * 3 = aaaa/mm/dd;

                                   * 4 = aaaammdd.

                   h. Sep. Decimal (TQ7_SEPDEC) – Deve ser informado o tipo de separador utilizado nos campos que possuam casas decimais.Os tipos disponíveis são:

                                   * 1 = Ponto (.);

                                   * 2 = Vírgula (,).

                   i. Cabeçalho (TQ7_INDCAB) – Deve ser informado se o layout possui cabeçalho. Caso possua a primeira linha do arquivo TXT será ignorada na impressão.

                                   * 1 = Sim;

                                   * 2 = Não.

                   j. Ind. Rodapé (TQ7_INDROD) – Deve ser informado se o layout possui rodapé. Caso possua a última linha do arquivo TXT será ignorada na impressão.

                                   * 1 = Sim;

                                   * 2 = Não.

                   kBloqueado? (TQ7_MSBLQL) – Indica bloqueio do registro para uso.

                                   * 1 = Sim;

                                   * 2 = Não.

    O grid da esquerda apresenta todos os campos reais da tabela de Abastecimentos Importados (TR6).

    * Ao abrir um registro em alteração ou visualização só serão apresentados os campos que não foram adicionados a configuração do layout.

    Image Added
    A grid da
    				O programa apresenta os layouts de importação cadastrados. 
    			2. Clique em Incluir. 
    				O sistema apresenta a janela de Inclusão. 
    				Informe os dados conforme orientação do help e as informações a seguir. 
    				
    				a. TQ7_CODLAY – Código do Layout, sequencial gerado automaticamente; 
    				b. TQ7_DESLAY – Descrição do Layout; 
    				c. TQ7_TABELA – Tabela Principal utilizada para a importação. Fixo TR6; 
    				d. TQ7_DESTAB – Nome da tabela principal; 
    				e. TQ7_TIPARQ – Tipo de Arquivo: 
    					*	Fixo: As posições dos campos no layout são definidas por um tamanho fixo; 
    					*	Separador: Indica que existe um separador a cada campo. 
    				f. TQ7_SEPARD – Tipo do separador dos campos. Só obrigatório caso o TQ7_TIPARQ = 2; 
    				g. TQ7_FORDTA – Indica o formato dos campos data; 
    				h. TQ7_SEPDEC – Indica o caractere separador de decimal; 
    				i. TQ7_INDCAB – Indica se o layout possui cabeçalho, caso 1 = Sim a primeira linha não será importada; 
    				j. TQ7_INDROD – Indica se o layout possui rodapé, caso 1 = Sim a última linha não será importada.  
    			
    			A tabela da esquerda apresenta todos os campos reais da tabela principal (TQ7_TABELA). 
    				*	Ao abrir um registro em alteração ou visualização só serão apresentados os campos que não foram adicionados a configuração do layout.
    Image Removed
    			A tabela a direita indica os campos a serem lidos na importação.
    Image RemovedImage Added

    As

    colunas

    da

    tabela

    são.

                   *

    Campo:

    Nome

    do

    Campo

    adicionado;
    				*	Início: Indica em qual posição inicia o campo. Caso o layout possua separador esse campo será preenchido com “-“ visto que a mudança de campo é definida pelo 
    separador; 
    				*	Tamanho: Indica o tamanho máximo do campo. Esse campo será preenchido com o tamanho máximo da coluna da tabela. Podendo ser alterado para um tamanho 
    menor, exceto para campos datas, que seu tamanho é definido conforme o formato da data

    adicionado;

                   * Tipo: Tipo do campo a ser lido. Sendo, 1-Caracter, 2-Numérico e 3-Data;

                   * Início: Indica em qual posição inicia o campo. Caso o layout possua separador esse campo será preenchido com um traço “-“ visto que a mudança de campo é definida pelo separador;

                   * Tamanho: Indica a quantidade máxima de caracteres que o campo suporta. Essa capacidade é definida conforme o tamanho do campo em base máximo da coluna da tabela. Essa capacidade pode ser alterada para um tamanho menor, exceto para campos datas, que seu tamanho é definido conforme o formato da data (TQ7_FORDTA);

                   *

    Fim:

    Indica

    em

    qual

    posição termina o

    posição em que se encerra o campo.

    Caso

    o

    layout

    possua

    separador

    esse

    campo

    será

    preenchido

    com

    um traço “-“

    visto

    que

    a

    mudança

    de

    campo

    é

    definida

    pelo

    separador;

                   *

    Conteúdo:

    Mostra um

    Exibe um exemplo

    de

    como

    o

    campo

    deve

    ser

    preenchido;

                   *

    Função:

    Indica uma função de usuário que será executada após a leitura do campo para que possa ser feita validações especificas. Para saber como configurar essa

    Permite a inclusão de uma função de usuário que será executada após a leitura do campo para que possam serem realizadas validações especificas. Para saber como configurar essas funções deve ser verificado a FAQ MNT0026 

    Entre as grids, existem os botões de controle de campos:

    Image AddedBotão "Adicionar o campo selecionado para o layout" Insere 

    funções deve ser verificado a FAQ MNT0026
     
    			Entre as tabelas, possuem os botões de controle de campos:
    Image RemovedAdiciona

    o campo selecionado para o layout – Adiciona o campo selecionado da tabela

    principal para o campo de configuração de

    TR6 – Abastecimentos Importados para compor a estrutura do Layout. O registro é

    excluído

    retirado da lista de campos disponíveis;

    Image RemovedRetira

    Image AddedBotão "Retirar do layout o campo selecionado"

    Retira o

    Remove o campo selecionado

    da configuração de

    na estrutura do Layout, e devolve para lista de campos disponíveis. Se o campo selecionado para a remoção for um campo que não existe na tabela

    principal

    principal (TR6) ele ficará temporariamente na lista de campos disponíveis para auxiliar na configuração. Ao sair do programa o mesmo é apagado;

    Image RemovedSobe o campo da configuração do layout um campo acima;
    Image RemovedDesce o campo da configuração do layout um campo abaixo;
    Image RemovedAdiciona

    Image AddedBotão "Sobe o campo" – Movimenta verticalmente o campo selecionado na estrutura do layout para acima;

    Image AddedBotão "Desce o campo" – Movimenta verticalmente o campo selecionado na estrutura para baixo;

    Image AddedBotão "Adicionar campo que não existe na tabela principal

    " – A utilização dessa funcionalidade tem dois objetivos, primeiro manter a compatibilidade do sistema com os layouts antigos. Dessa forma, os campos que não são lidos pelo Protheus na importação ou não são salvos diretamente na tabela, podem ser mantidos no layout, para os campos que não são salvos diretamente, podem

    serem

    ser tratados por meio de uma função de usuário informada no campo função. O outro objetivo é fazer com que os campos do layout que possuam um tamanho maior que o do campo da tabela, possam ser utilizados com o tamanho correto. Para melhor entendimento do funcionamento dessa validação deve ser lido aFAQ MNT0026

     

    Exemplo

    de

    importação:

    Esta

    seção

    traz

    o

    campo

    de

    pré-visualização

    referente

    a

    formatação

    do

    arquivo

    que

    está

    sendo

    criado.

    Card
    labelImportação de Abastecimento (MNTA716)

    3.

    Acesse Atualizações / Controle de Abastecimento / Abastecimento / Importação de Abastecimento

    Acesse a rotina de Importação de Abastecimentos em Atualizações / Controle de Abastecimento / Abastecimento / Importação de Abastecimento (MNTA716).

    Será

    apresentada

    a

    tela

    de

    instruções

    para

    a

    importação,

    após

    ler

    as

    instruções

    deve-se

    clicar

    em

    Avançar.

    		Na tela seguinte informar o código do layout a ser importado (possui um botão para consulta padrão para visualizar os layouts cadastrados) após a seleção do layout 
    deve-se clicar em Avançar.
    		É apresentado uma tela de seleção de arquivo. (O arquivo deve estar salvo na pasta raiz do dicionário.)
    		Ao confirmar o arquivo será feito o processo de importação. 
    			*	Caso ocorra algum erro no processamento, nenhum registro será importado e será apresentado um relatório de erro. Do contrário será apresentado uma mensagem 
    indicado o sucesso da

    A próxima tela apresentará um campo para informar o código do layout a ser importado, através da consulta padrão do campo podem ser visualizados os layouts cadastrados, após a seleção do layout deve-se clicar em Avançar, onde será apresentado uma tela de seleção de arquivo. Ao confirmar o arquivo será feito o processo de importação. Caso ocorra algum erro no processamento, nenhum registro será importado e será apresentado um relatório de erro. Do contrário será apresentado uma mensagem indicado o sucesso da importação.

    Card
    labelConsistência Abastecimento (MNTA635)

    4.

    Acesse

    Acesse a rotina de consistência de abastecimentos em Atualizações /

    Controle

    de

    Abastecimento

    /

    Abastecimento

    /

    Consistencia

    Abastecimento

    (MNTA635)

    .

    5.

    Fazer

    Realizar a

    consistência

    dos

    abastecimentos

    importados.

    Card
    labelAnalise Consistência (MNTA700)

    6.

    Acesse Atualizações / Controle de Abastecimento / Abastecimento / Analise Consistencia (MNTA700)
    		Será apresentada a tela para análise das inconsistências. 
    		A tela deverá aproveitar o espaço completo da mesma, não ficando mais centralizada no meio.
    		

    Acesse a rotina de análise da consistência em Atualizações / Controle de Abastecimento / Abastecimento / Analise Consistencia (MNTA700).

    7. Verificar que a rotina possui sua tela maximizada, permitindo assim um maior aproveitamento dos espaços do programa.

    8. Na ocorrência de importação de abastecimentos que não possuam os campos data do abastecimento

    Caso algum abastecimento ocorra sem informar a data do abastecimento

    (TR6_DTABAS)

    e/ou

    sem

    hora

    do abastecimento (TR6_HRABAS)

    preenchidos, a

    consistência de abastecimento irá

    rotina de consistência exibirá os novos erros a seguir:

    	* 
    gerar dois novos erros:
    			*	51 - Não foi informada data para o abastecimento.
    			*	 52 - Não foi informada hora para o abastecimento.
    		Dessa forma, será permitido alterar a data e/ou hora do abastecimento. Após a alteração do campo não será mais permitido alterar as referidas informações.
    		O campo que indica o combustível foi alterado para respeitar o parâmetro MV_NGIMPOR, onde se o mesmo for 1, o campo será apresentado como convenio. 
    Se for 2,
     abastecimento.
    	* 53 - Data/Hora de abastecimento maior que a data atual.

    9. Dessa forma, será permitido alterar a data e/ou hora do abastecimento. Após a alteração do campo não será mais permitido modificar as respectivas informações.

    10. Caso na importação o tipo de convênio do posto (TQM_CONVEN) seja diferente do tipo de convênio do combustível (TQF_CONVEN) irá gerar o novo erro:

    	* 54 - Convênio do comb. incompatível com o convênio do posto.
     
    11. Também foram criados novos erros para caso não seja informado combustível ou o mesmo não exista:
    	* 55 - Combustível não informado.
    	* 56 - Combustível não cadastrado.

    12. O campo de combustível foi alterado para respeitar o parâmetro que indica se na importação de arquivos relacionados a abastecimento, considera: 1 - Cód. Convênio ou 2 - Cód. Combustível(MV_NGIMPOR)

    será combustível

    .