Histórico da Página
Descrição
Essa documentação tem por objetivo descrever o novoNovo 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
- MNTA130 - CTF;
- MNTA631 - Ticket;
- MNTA986 - GoodCar;
- MNTA131 - GTFrota;
- MNTA635 – Consistência
- MNTA700 – Análise Consistência
- 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:
Contate o Help Desk Framework EM CASO DE DÚVIDAS! |
---|
- Em Microsiga Protheus TOTVS Smart Client, digite U_UPDMNTC5 no campo Programa Inicial.
- Clique em OK para continuar.
- Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado.
- Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
É apresentada uma mensagem explicativa na tela. - 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.
- Clique em Gravar para salvar o histórico (log) apresentado.
- Clique em OK para encerrar o processamento.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
Procedimento para Implantação
O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.
- 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: |
| ||||||||||||
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:
Contate o Help Desk Framework EM CASO DE DÚVIDAS! |
---|
- Em Microsiga Protheus TOTVS Smart Client, digite U_UPDMNTD1 no campo Programa Inicial.
- Clique em OK para continuar.
- Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado.
- Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
É apresentada uma mensagem explicativa na tela. - 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.
- Clique em Gravar para salvar o histórico (log) apresentado.
- Clique em OK para encerrar o processamento.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
Procedimento para Implantação
O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste ticket.
- 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
- 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
- Criação de tabela no arquivo SX2– Tabelas:
Chave | Nome | Modo | PYME |
TQ7 | Dados do Layout | Compartilhado | N |
TQ8 | Estrutura do Layout | Compartilhado | N |
- 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:
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 | Nível1 | 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. |
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 |
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 |
. Layout |
Seq. |
Campo |
Desc. Tabela
Arquivo TXT
Separador
Formato Data
Sep. Decimal
Cabeçalho
Campo | Tipo | Início | Tamanho | Fim | Conteúdo | Função |
Descrição | Filial | Código do Layout |
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 | |
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 |
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 |
|
|
|
|
|
|
|
|
| |
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 |
Procedimento para Utilização
Deck of Cards | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||
|