Linha Microsiga Protheus

Árvore de páginas

Versões comparadas

Versão antiga 1

changes.mady.by.user Maicon Pinheiro

Gravado em

comparado com

Nova versão 2

changes.mady.by.user Maicon Pinheiro

Gravado em

Chave

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

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

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 BGD - Prod x Cob x Proc x Co-Part:

 

Campo

(X3_CAMPO)

Tipo

(X3_TIPO)

Tamanho

(X3_TAMANHO)

Decimal

(X3_DECIMAL)

Formato

(X3_PICTURE)

Título

(X3_TITULO)

Descrição

(X3_DESCRIC)

Nível

(X3_NÍVEL)

Usado

(X3_USADO) Informe Sim ou Não

Obrigatório

(X3_OBRIGAT) Informe Sim ou Não

Browse

(X3_BROWSE) Informe Sim ou Não

Opções

(X3_CBOX)

When

(X3_WHEN)

Relação

(X3_RELACAO)

Val. Sistema

(X3_VALID)

Help

Descreva o conteúdo informado para Help de Campo no ATUSX

 

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)

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.