Novo processo de importação de abastecimento.

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

Rotina(s) envolvida(s)	Nome Técnico
MNTA715	Layout de Importação
MNTA716	Importação de Abastecimento
MNTA635	Consistencia dos registros de abastecimento
MNTA700	Aná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

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:

No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opção Integridade/Verificação(APCFG60A).
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.
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;
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).
Nestes casos descritos nos itens “iii” ou “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).
Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instruções.
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!

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

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

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	TQ8_POSINI	TQ8_TAMARQ	TQ8_POSFIM	TQ8_CONTEU	TQ8_FUNCAO
Tipo	Caracter	Caracter	Numérico	Caracter	Numérico	Numérico	Numérico	Caracter	Caracter
Tamanho	8	6	3	10	4	3	3	20	80
Decimal	0	0	0	0	0	0	0	0	0
Formato			999		9999	999	999		Funcao
Título	Filial	Cod. Layout	Seq. Campo	Campo	Inicio	Tamanho	Fim	Conteúdo
Descrição	Filial	Código 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	Funcao de processamento
Nível	1	1	1	1	1	1	1	1	1
Usado	Não	Sim	Sim	Sim	Sim	Sim	Sim	Sim	Sim
Obrigatório	Não	Sim	Sim	Sim	Sim	Sim	Sim	Não	Não
Browse	Sim	Sim	Não	Sim	Sim	Não	Sim	Não	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.	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

id	Passo a Passo

Card

label	Layout 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

label	Importaçã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

label	Consistência Abastecimento (MNTA635)

	4. Acesse Atualizações/ Controle de Abastecimento / Abastecimento / Consistencia Abastecimento (MNTA635).

	5. Fazer a consistência dos abastecimentos importados.

Card

label	Analise 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.

Árvore de páginas

Versões comparadas

Versão antiga 10

Nova versão 11

Chave

Novo processo de importação de abastecimento.

Características do Requisito

Descrição

Resumo

Importante

Procedimento para Implantação

Atualizações do Compatibilizador

GETSXENUM

("TQ7","TQ7_CODLAY")

Procedimento para Utilização

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 10

Nova versão 11

Chave

Novo processo de importação de abastecimento.

Características do Requisito

Descrição

Resumo

Importante

Procedimento para Implantação

Atualizações do Compatibilizador

GETSXENUM

("TQ7","TQ7_CODLAY")

Procedimento para Utilização