Árvore de páginas

Movimentação de Contratos

Características do Requisito

Linha de Produto:

Microsiga Protheus

Segmento:

Agroindústria

Módulo:

SIGAAGR

Rotina:

Rotina

Nome Técnico

OGA440

Rotina de Movimentação de Contratos

Rotina(s) envolvida(s)

Nome Técnico

OGA441Rotina de Tipo de Movimentação
OGA450ARotina de Transferência de Múltiplas Origens 
OGA450BRotina de Transferência
AjustaNKLCompatibilizador Tabela NKL

Parâmetro(s):

MV_OGCTRMV

País(es):

Todos

Tabelas utilizadas:

NKL - NKM

Versões/Release:

11.80.15

Descrição

Foi implementada a funcionalidade de controle de movimentações para agrupar os romaneios. Esta nova funcionalidade pode ser utilizada como exemplo em transferências entre contratos, e na compra de produto depositado em terceiros, bem como qualquer outra movimentação que desejar relacionar mais de um romaneio. Os processos de Transferência Simples (OGA450B) e Transferência Múltipla (OGA450A) foram alterados para efetuar a geração automática da movimentação entre os romaneios. Para criar vínculos novos ou consultar os vínculos gerados automaticamente através das rotinas de Transferência Simples e Transferência Múltipla, foi criada a rotina Movimentações de Contratos (OGA440).

É opcional a geração automática do vínculo entre romaneio nas transferências. Para que seja gerado o vínculo automático nas transferências é necessário cadastrar um tipo de movimentação (OGA441), onde pode ser criado um tipo para cada opção de transferência, como exemplo 000001 para Transferência Simples, e 000002 para Transferência Múltipla. Caso necessário pode ser um único tipo, exemplo 000001 para as duas opções de transferência. O parâmetro MV_OGCTRMV controla esta atualização automática, informando no parâmetro os tipos de movimentação para cada caso, conforme exemplo abaixo:

  • TRFS|000001; = TRFS Indica que na Transferência Simples irá gerar o vínculo de movimentos entre os romaneios, e será usado o tipo de movimento '000001' (deve constar na tabela NKL/OGA441, e Ativo),  e na Transferência Múltipla não irá criar o vínculo de movimentos entre os romaneios.
  • TRFS|000001;TRFM|000002; = TRFS Indica que na Transferência Simples irá gerar o vínculo de movimentos entre os romaneios, e será usado o tipo de movimento '000001' (deve constar na tabela NKL/OGA441, e Ativo), e na Transferência Múltipla também irá gerar o vínculo de movimentos entre os romaneios, e será usado o tipo de movimento '000002' (deve constar na tabela NKL/OGA441, e Ativo).

Importante

Antes de executar o compatibilizador UPDARM, é imprescindível:

  • Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório PROTHEUS_DATA\DATA, se versão 10, ou \PROTHEUS11_DATA\DATA, se versão 11) e dos dicionários de dados SXs (diretório PROTHEUS_DATA_SYSTEM, se versão 10, ou \PROTHEUS11_DATA\SYSTEM, se versão  11).
  • 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 (se versão 10) ou ByYou Smart Client (se versão 11), informe UPDARM no campo Programa Inicial


  2. Clique em OK para continuar.

  3. Após a confirmação, é exibida uma tela para a seleção do compatibilizador. Clique em executar.  


  4. Após a confirmação para a execução, é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado. Clique em Atualizar.


  5. Ao clicar em Atualizar, é exibida uma tela para a seleção das tabelas a serem criadas.


  6. Ao confirmar a Atualização, é exibida uma tela informando o momento da atualização.


  7. Aguardar a finalização do compatibilizador. 

OBS:backup tem a necessidade de sua execução em modo exclusivo.

Atualizações do Compatibilizador

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

Chave

Nome

Modo

PYME

NKL

Tipos de Movimentações

C

N

Chave

Nome

Modo

PYME

NKM

Movimentações

C

N

 

          2. Criação de Campos no arquivo SX3 – Campos:

  • Tabela NKL - Tipos de Movimentações:

Campo

NKL_FILIAL

Tipo

Carácter

Tamanho

2

Decimal

0

Título

Filial

Descrição

Filial

Nível

0

Usado

Não

Obrigatório

Não

Browse

Não

Help

Código que identifica a filial da empresa usuária do sistema.

Campo

NKL_TIPOMV

Tipo

Carácter

Tamanho

6

Decimal

0

Formato

@!

Título

Tipo Movimen

Descrição

Tipo da Movimentação

Nível

0

Usado

Sim

Obrigatório

Sim

Browse

Sim

Val. Sistema

ExistChav('NKL',M->NKL_TIPOMV)

Help

Código que identifica o tipo da movimentação.

Campo

NKL_DESCRI

Tipo

Carácter

Tamanho

40

Decimal

0

Formato

@!

Título

Descrição

Descrição

Descrição do Tipo de Mov.

Nível

0

Usado

Sim

Obrigatório

Sim

Browse

Sim

Help

Descrição que identifica o tipo da movimentação.

Campo

NKL_ATIVO

Tipo

Carácter

Tamanho

1

Decimal

0

Formato

 

Título

Cad. Ativo?

Descrição

Cadastro Ativo?

Nível

0

Usado

Sim

Obrigatório

Sim

Browse

Sim

Opções

1=Ativo;2=Inativo

Val. Sistema

Pertence('12')

Help

Identifica se o tipo de movimentação está ativo.

 

  • Tabela NKM - Movimentações:

Campo

NKM_FILIAL

Tipo

Carácter

Tamanho

2

Decimal

0

Título

Filial

Descrição

Filial

Nível

0

Usado

Não

Obrigatório

Não

Browse

Não

Help

Código que identifica a filial da empresa usuária do sistema.

Campo

NKM_IDMOV

Tipo

Carácter

Tamanho

6

Decimal

0

Formato

@!

Título

Id Moviment.

Descrição

Id da Movimentação

Nível

0

Usado

Sim

Obrigatório

Sim

Browse

Sim

RelaçãoGetSXENum('NKM','NKM_IDMOV')

Val. Sistema

ExistChav('NKM',M->NKM_IDMOV)

Help

Código que identifica a id da movimentação.

Campo

NKM_TIPOMV

Tipo

Carácter

Tamanho

6

Decimal

0

Formato

@!

Título

Tipo Movimen

Descrição

Tipo da Movimentação

Nível

0

Usado

Sim

Obrigatório

Sim

Browse

Sim

F3NKL

Val. Sistema

ExistCpo('NKL',M->NKM_TIPOMV)

Help

Código que identifica o tipo da movimentação.

Campo

NKM_DESTIP

Tipo

Carácter

Tamanho

40

Decimal

0

Formato

@!

Título

Desc. Tipo

Descrição

Descricao do Tipo de Mov.

Nível

0

Usado

Sim

Obrigatório

Sim

Browse

Sim

RelaçãoIF(!INCLUI,POSICIONE('NKL',1,XFILIAL('NKL')+FWFLDGET('NKM_TIPOMV'),'NKL_DESCRI'),' ')
Ini. BrowsePOSICIONE('NKL',1,XFILIAL('NKL')+NKM->NKM_TIPOMV,'NKL_DESCRI')

Help

Descrição que identifica o tipo da movimentação.

Campo

NKM_DATA

Tipo

Data

Tamanho

8

Decimal

0

Título

Dt. Inclusao

Descrição

Data de Inclusão

Nível

0

Usado

Sim

Obrigatório

Sim

Browse

Sim

Relação

dDataBase

Help

Identifica a data de movimentação.

Campo

NKM_RESUMO

Tipo

Carácter

Tamanho

200

Decimal

0

Formato

@!

Título

Desc. Resum.

Descrição

Descrição Resumida da Mov

Nível

0

Usado

Sim

Obrigatório

Sim

Browse

Sim

Help

Descrição Resumida da movimentação.

Campo

NKM_STATUS

Tipo

Carácter

Tamanho

1

Decimal

0

Título

Status

Descrição

Status Movimentação

Nível

0

Usado

Sim

Obrigatório

Sim

Browse

Sim

Opções1=Aberta;2=Encerrada;3=Cancelada

Val. Sistema

Pertence('123')

Help

Identifica o status da movimentação.


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

Alias

NKL

Tipo

1

Sequência

01

Coluna

DB

Descrição

Tipos de Movimentações

Contém

NKL

Alias

NKL

Tipo

2

Sequência

01

Coluna

01

Descrição

Tipo Movimen

Contém

 

Alias

NKL

Tipo

3

Sequência

01

Coluna

01

Descrição

Cadastrar Novo

Contém

 01

Alias

NKL

Tipo

4

Sequência

01

Coluna

01

Descrição

Tipo Movimen

Contém

 NKL_TIPOMV

Alias

NKL

Tipo

4

Sequência

01

Coluna

02

Descrição

Descrição

Contém

NKL_DESCRI

Alias

NKL

Tipo

5

Sequência

01

Coluna

01

Descrição

Tipo Movimen

Contém

NKL->NKL_TIPOMV

Alias

NKL

Tipo

5

Sequência

01

Coluna

02

Descrição

Descrição

Contém

NKL->NKL_DESCRI

Alias

NKL

Tipo

6

Sequência

01

Contém

NKL->(NKL_ATIVO)=='1'

 

  • Pesquisa NKM:

Alias

NKM

Tipo

1

Sequência

01

Coluna

DB

Descrição

Movimentações

Contém

NKM

Alias

NKM

Tipo

2

Sequência

01

Coluna

01

Descrição

Id Moviment.

Contém

 

Alias

NKM

Tipo

3

Sequência

01

Coluna

01

Descrição

Cadastrar Novo

Contém

 01

Alias

NKM

Tipo

4

Sequência

01

Coluna

01

Descrição

Id Moviment.

Contém

NKM_IDMOV

Alias

NKM

Tipo

4

Sequência

01

Coluna

02

Descrição

Tipo Movimen

Contém

NKM_TIPOMV

Alias

NKM

Tipo

4

Sequência

01

Coluna

03

Descrição

Desc. Tipo

Contém

NKM_DESTIP

Alias

NKM

Tipo

4

Sequência

01

Coluna

04

Descrição

Resumo

Contém

NKM_RESUMO

Alias

NKM

Tipo

4

Sequência

01

Coluna05
DescriçãoDt. Inclusao

Contém

NKM_DATA

Alias

NKM

Tipo

5

Sequência

01

Coluna01
DescriçãoTipo Movimen

Contém

NKM->NKM_IDMOV

 

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

  • Tabela NKL – Tipo de Movimentações:

Índice

NKL

Ordem

1

Chave

NKL_FILIAL+NKL_TIPOMV

Descrição

Tipo Movim.

Proprietário

S

Índice

NKL

Ordem

2

Chave

NKL_FILIAL+NKL_DESCRI

Descrição

Descrição

Proprietário

S

 

  • Tabela NKM – Movimentações:

Índice

NKM

Ordem

1

Chave

NKM_FILIAL+NKM_IDMOV

Descrição

Id Moviment.

Proprietário

S

Índice

NKM

Ordem

2

Chave

NKM_FILIAL+NKM_TIPOMV+NKM_IDMOV

Descrição

Tipo Movim.+ID Moviment.

Proprietário

S

 

5. Criação de Parâmetros no arquivo SX6 – Parâmetros:

Nome da Variável

MV_OGCTRMV

Tipo

Carácter

Descrição

Tp.Movtos nos Processos: Transf.Simples(TRFS),Transf.Multipla(TRFM)

Valor Padrão

TRFS|000001

 

6. Criação de Gatilhos no arquivo SX7 – Gatilhos:

  • Tabela NKM – Movimentações:

Campo

NKM_TIPOMV

Sequência

001

Campo Domínio

NKM_DESTIP

Tipo

Posicione

Regra

NKL->NKL_DESCRI

Posiciona?

Sim

AliasNKL

Chave

xFilial('NKL')+M->NKM_TIPOMV

Proprietário

S

Procedimento para Utilização

  1. No Gestão Agroindústria (SIGAAGR), acessar Atualizações/ Originação/ Cadastros Básicos/ Tipos de Movimentações (OGA441).
    O sistema apresenta a janela de tabelas de tipos de movimentações.
  2. Na opção "Incluir", clique para cadastrar um tipo de movimentação.
  3. No Configurador (SIGACFG), acesse Ambiente/ Cadastros/ Parâmetros. Pesquise pelo parâmetro MV_OGCTRMV. 
  4. Na opção "Alterar", clique e informe o tipo de transferência e o código do tipo de movimentação cadastrado. 
    Exemplo: TRFS|TM0001 (Transferência Simples/ Código do Tipo de Movimentação Simples)
                     TRFM|TM0002 (Transferência Múltipla/ Código do Tipo de Movimentação Múltipla)
  5. Na rotina Gestor de Entidades (OGA450), gerar uma transferência Simples e/ou Múltipla. Verificar se foi preenchido o campo de "Tip. Moviment." conforme informado no parâmetro. Prosseguir com a operação. 
  6. Verificar na rotina Movimentações (OGA440), a movimentação gerada através da rotina Gestor de Entidades (OGA450).