Árvore de páginas

Versões comparadas

Chave

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

Descrição

Essa documentação tem por objetivo descrever o 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..

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:

 

Campo

 

  

TQ8_FILIAL

TQ8_CODLAY

TQ8_SEQUEN

TQ8_CPOTAB

 

       

Tipo

 Caracter

 

Caracter

 

Numérico

 

Caracter

       

Tamanho

 8

 

6

 

3

 

10

       

Decimal

 0

 

0

 

0

 

0

       

Formato

 

 

 

999

 

       

Título

 Filial

Cod. Layout 

 

Seq. Campo

 Campo

       

Descrição

 

  

Filial

Código do

Layout

Sequência do

Campo

Campos do

layout

 

       

Nível

 1

 

1

 

1

 

1

       

Usado

 Não

 

Sim

 

Sim

 

Sim

       

Obrigatório

 Não

 

Sim

 

Sim

 

Sim

       

Browse

 Sim

 

Sim

 

Não

 

Sim

       

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

 

       


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

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.

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 (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.  
				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.
			A tabela a direita indica os campos a serem lidos na importação.
			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 (TQ7_FORDTA); 
				*	Fim: Indica em qual posição termina o campo. Caso o layout possua separador esse campo será preenchido com “-“ visto que a mudança de campo é definida pelo 
separador; 
				*	Conteúdo: Mostra 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
funções deve ser verificado a FAQ MNT0026
 
			Entre as tabelas, possuem os botões de controle de campos:
Adiciona o campo selecionado para o layout – Adiciona o campo selecionado da tabela principal para o campo de configuração de Layout. O registro é excluído da lista de campos disponíveis;
Retira do layout o campo selecionado – Retira o campo selecionado da configuração de 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 ele ficará temporariamente na lista de campos disponíveis para auxiliar na configuração. Ao sair do programa o mesmo é apagado;
Sobe o campo da configuração do layout um campo acima;
Desce o campo da configuração do layout um campo abaixo;
Adiciona 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 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 a FAQ 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 (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 importação.
Card
labelConsistência Abastecimento (MNTA635)
	4. Acesse Atualizações/ Controle de Abastecimento / Abastecimento / Consistencia Abastecimento (MNTA635).
	5. Fazer 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.
		
		Caso algum abastecimento ocorra sem informar a data do abastecimento (TR6_DTABAS) e/ou sem hora (TR6_HRABAS) a consistência de abastecimento irá 
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, será combustível.