Linha de Produto: | Microsiga Protheus | ||||||||
Segmento: | Agroindustria | ||||||||
Módulo: | SIGAGR | ||||||||
Rotina: |
| ||||||||
| Requisito (ISSUE): | AGROG01-500 | ||||||||
País(es): | Brasil | ||||||||
Banco(s) de Dados: | Todos | ||||||||
Tabelas Utilizadas: | NJ3, NJ4,NJ5 | ||||||||
Sistema(s) Operacional(is): | Windows®/Linux® |
Realizar a programação de Entrega conforme regras e politicas adotadas pela empresa.
Cadastrar as Politicas sendo que a criação do parâmetro não exerce qualquer influência sobre a validação do agendamento até que este seja empregado em uma regra de negócio.
Cadastrar as Regras podendo haver varias regras com o mesmo parâmetro que serão executadas conforme sequencia de validação indicada no atributo Ordem. Na Instrução informar formula na forma de texto que pode ser convertida em um codeblock do Protheus.
Um codeblock pode aceitar a passagem de parâmetros para funções, sendo que esses parâmetros serão determinados por um conjunto pré-determinado de variáveis. As variáveis são nomes de campos que estão delimitadas por [] (colchetes) e que durante a execução da regra serão substituídas por valores reconhecidos no programa.
Na programação de Entrega serão listadas todas as Liberações de pedidos que estiverem pendentes de agendamento e os registros de agendamento estiverem com data de agendamento em branco ou com a situação reprovado (R).
No momento da confirmação do agendamento o programa deverá executar as regras de validação para cada linha que foi atualizado o campo de data.
Quando o resultado da regra aplicada for falso (.F.), então será gravado na tabela NK9 (histórico) um LOG indicando a ocorrência. A chave do log deverá ser composta pela chave da tabela NJ5 juntamente com o identificador "VALIDACAO" e o código da regra que está sendo executada. A mensagem do log deverá ser formada com as seguintes informações:
Todas as regras ativas deverão ser executadas. Ao final do processo, caso uma ou mais regras tenha retornado valor falso (.f.), então o agendamento do item específico será gravado, contudo a situação será registrada como Reprovado (R). Para os demais itens, cujo retorno da regra tenha sido verdadeiro (.T.) terão o campo situação alterado para Aprovado (A). As informações da tabela NJ5 somene serão gravadas na SC9 quando houver a aprovação automática ou através da aprovação manual.
Para validação da programação de entrega, clicar sobre o botão “Executar” e este irá processar as regras cadastradas e caso alguma regra retornar o valor .f. o programa irá gravar o log da regra que pode ser consultado na tabela NK9 através da opção Histórico.
O sistema é atualizado logo após a aplicação do pacote de atualizações UPDNJX deste chamado.
(Apenas para Microsiga Protheus, versões anteriores à versão 12)
Tabela NJ3 - Regra Programação de Entrega
Índice | Chave |
01 | NJ3_FILIAL+NJ3_CODIGO |
02 | NJ3_FILIAL+STR(NJ3_SEQ) |
Campo | CODIGO |
Tipo | C |
Tamanho | 5 |
Valor Inicial | SEQUENCIAL |
Mandatório | Sim (X ) Não ( ) |
Descrição | Regra |
Título | Regra |
Picture | @! |
Help de Campo | Informar o código identificador da regra |
Campo | DESCRICAO |
Tipo | C |
Tamanho | 100 |
Mandatório | Sim (X ) Não ( ) |
Descrição | Descrição da Regra |
Título | Descrição |
Picture | @! |
Help de Campo | Informar texto descritivo para a regra |
Campo | SIT |
Tipo | C |
Tamanho | 1 |
Valor Inicial | 1-Sim |
Mandatório | Sim (X ) Não ( ) |
Descrição | Ativo (1-SIm, 2-Não) |
Título | Ativo |
Picture | @! |
Help de Campo | Informar se a regra encontra-se ativa |
Campo | SEQ |
Tipo | N |
Tamanho | 3 |
Mandatório | Sim (X ) Não () |
Descrição | Ordem |
Título | Ordem |
Picture | 999 |
Help de Campo | Ordem da sequencia de execução da regra. |
Campo | INSTR |
Tipo | C |
Tamanho | 254 |
Mandatório | Sim (x) Não ( ) |
Descrição | Instrução |
Título | Instrução |
Picture | @! |
Help de Campo | Instrução na forma de codeblock queseráexecutado para validar a regra. Ainstrução deve retornar um valor .T.ou .F. Se retornar NIL será considerado como .F. |
Campo | MSG |
Tipo | C |
Tamanho | 254 |
Mandatório | Sim (X ) Não ( ) |
Descrição | Mensagem |
Título | Mensagem |
Picture | @! |
Help de Campo | Texto que será gravado no Log da regrapara identificar o problema. |
Índice | Chave |
01 | NJ4_FILIAL+NJ4_CODIGO |
Campo | CODIGO |
Tipo | C |
Tamanho | 5 |
Valor Inicial | SEQUENCIAL |
Mandatório | Sim (X ) Não ( ) |
Descrição | Política |
Título | Política |
Picture | @! |
Help de Campo | Informar o código identificador da Politica |
Campo | CHAVE |
Tipo | C |
Tamanho | 50 |
Mandatório | Sim (X ) Não ( ) |
Descrição | Parâmetro |
Título | Parâmetro |
Picture | @! |
Help Campo | Identificador da Politica. Fazem referencia a Politica podendo haver varias com mesmo Parâmetro. Exemplo: PERCENTUAL_CARGA_FRETE |
Campo | DESCRICAO |
Tipo | C |
Tamanho | 100 |
Mandatório | Sim (X ) Não ( ) |
Descrição | Descrição da política |
Título | Descrição |
Picture | @! |
Help de Campo | Descrição da Politica de negocio da programação de entrega |
Campo | SIT |
Tipo | C |
Tamanho | 1 |
Valor Inicial | 1-Sim |
Mandatório | Sim (X ) Não ( ) |
Descrição | Ativo (1-SIm, 2-Não) |
Título | Ativo |
Picture | @! |
Help de Campo | Informar se a regra encontra-se ativa |
Campo | VALOR |
Tipo | C |
Tamanho | 254 |
Mandatório | Sim (X ) Não () |
Descrição | Valor |
Título | Valor |
Picture | @! |
Help de Campo | Valor estipulado para atender a Politica |
Campo | DTINI |
Tipo | D |
Tamanho | 8 |
Mandatório | Sim ( ) Não (X) |
Descrição | Data Inicio da Vigência |
Título | Data Inicio |
Help de Campo | Período inicial para vigência da politica. Caso não seja informado ficará compreendido todo o período sem restrição. |
Campo | DTFIM |
Tipo | D |
Tamanho | 8 |
Mandatório | Sim ( ) Não (X) |
Descrição | Data Final de vigência |
Título | Data Fim |
Help de Campo | Período final para vigência da politica. Caso não seja informado ficará compreendido todo o período sem restrição. |
Índice | Chave |
01 | NJ5_FILIAL+NJ5_NUMPV+NJ5_ITEM+NJ5_SEQUEN+NJ5_PRODUT |
Campo | CODCAR |
Tipo | C |
Tamanho | 6 |
Visual | Visualizar |
Mandatório | Sim () Não (x) |
Descrição | Código Carregamento |
Título | Carregamento |
Picture | @! |
Help de Campo | Código do carregamento |
Campo | NUMPV |
Tipo | C |
Tamanho | 6 |
Visual | Visualizar |
Mandatório | Sim (x) Não ( ) |
Descrição | Número Pedido de Venda |
Título | Num. Ped Venda |
Picture | @! |
Help de Campo | Número do Pedido Venda |
Campo | ITEM |
Tipo | C |
Tamanho | 2 |
Visual | Visualizar |
Mandatório | Sim (x) Não ( ) |
Descrição | Item |
Título | Item |
Picture | @! |
Help de Campo | Item do pedido de vendas. |
Campo | SEQUEN |
Tipo | C |
Tamanho | 2 |
Visual | Visualizar |
Mandatório | Sim (x) Não ( ) |
Descrição | Seq |
Título | Sequência |
Picture | @! |
Help de Campo | Sequência do Item do pedido de vendas. |
Campo | PRODUT |
Tipo | C |
Tamanho | 15 |
Visual | Visualizar |
Mandatório | Sim (x) Não ( ) |
Descrição | Produto |
Título | Produto do Pedido de Vendas |
Picture | @! |
Help de Campo | Produto do Pedido de Vendas |
Campo | DESCR |
Tipo | C |
Tamanho | 30 |
Visual | Visualizar |
Mandatório | Sim () Não (X ) |
Descrição | Descrição do Produto |
Título | Descrição |
Picture | @! |
Help de Campo | Descrição do Produto do Pedido de Vendas |
| Valor Inicial | IF(!INCLUI,POSICIONE('SB1',1,XFILIAL('SB1')+NJ5->NJ5_PRODUT,'B1_DESC'),' ') |
Campo | QTDE |
Tipo | N |
Tamanho | 9 |
Visual | Visualizar |
Mandatório | Sim () Não (X ) |
Descrição | Quantidade do Produto |
Título | Quantidade |
Picture | @E 999,999.99 |
Help de Campo | Quantidade do Produto do Pedido de Vendas |
Campo | UM |
Tipo | C |
Tamanho | 2 |
Visual | Visualizar |
Mandatório | Sim () Não (X ) |
Descrição | Unidade de Medida |
Título | Un.Medida |
Picture | @! |
Help de Campo | Unidade de Medida do Produto do Pedido de Vendas |
Campo | QTDUM2 |
Tipo | N |
Tamanho | 9 |
Visual | Visualizar |
Mandatório | Sim () Não (X ) |
Descrição | |
Título | Qtd. 2ª. UM |
Picture | @E 999,999.99 |
Help de Campo | Quantidade do Produto do Pedido de Vendas |
Campo | UM2 |
Tipo | C |
Tamanho | 2 |
Visual | Visualizar |
Mandatório | Sim () Não (X ) |
Descrição | Unidade de Medida |
Título | Un.Medida |
Picture | @! |
Help de Campo | Unidade de Medida do Produto do Pedido de Vendas |
Campo | QTDUM2 |
Tipo | C |
Tamanho | 2 |
Visual | Visualizar |
Mandatório | Sim () Não (X ) |
Descrição | Unidade de Medida |
Título | Un.Medida |
Picture | @! |
Help de Campo | Unidade de Medida do Produto do Pedido |
Campo | LOCAL |
Tipo | C |
Tamanho | 12 |
Visual | Visualizar |
Mandatório | Sim () Não (X ) |
Descrição | local de Estoque |
Título | Local |
Picture | @! |
Help de Campo | Local de Estoque |
Campo | CULTRA |
Tipo | C |
Tamanho | 10 |
Valor Inicial | |
Mandatório | Sim ( ) Não (X) |
Descrição | Cultura |
Título | Cultura |
Picture | @! |
Help de Campo | Código identificador da cultura no sistema. |
Campo | CTVAR |
Tipo | C |
Tamanho | 10 |
Valor Inicial | |
Mandatório | Sim ( ) Não (X) |
Descrição | Cultivar |
Título | Cultivar |
Picture | @! |
Help de Campo | Código identificador da cultivar no sistema. |
Campo | CATEG |
Tipo | C |
Tamanho | 2 |
Valor Inicial | |
Mandatório | Sim ( ) Não (X) |
Descrição | Categoria |
Título | Categoria |
Picture | @! |
Help de Campo | Código identificador da categoria no sistema. |
Campo | PENE |
Tipo | C |
Tamanho | 4 |
Valor Inicial | |
Mandatório | Sim ( ) Não (X) |
Descrição | Peneira |
Título | Peneira |
Picture | @! |
Help de Campo | Código identificador da peneira no sistema. |
Campo | TPFRET |
Tipo | C |
Tamanho | 1 |
Valor Inicial | |
Mandatório | Sim ( ) Não (X) |
Descrição | Tipo de Frete |
Título | Tipo de Frete utilizado. |
Picture | @! |
Help de Campo | Tipo do Frete: C=CIF;F=FOB;T=Por conta terceiros;S=Sem frete |
Campo | STATUS |
Tipo | C |
Tamanho | 1 |
Valor Inicial | |
Mandatório | Sim ( ) Não (X) |
Descrição | Status |
Título | Status |
Picture | @! |
Help de Campo | Status: 1=Agd. Aprovacao;2=Aprovado;3=Aprovado manualmente |
Campo | CODSAF |
Tipo | C |
Tamanho | 15 |
Valor Inicial | |
Mandatório | Sim ( ) Não (X) |
Descrição | Codido da Safra |
Título | Cod.Safra |
Picture | @! |
Help de Campo | Informar a Safra |
Campo | DTPROG
|
Tipo | D |
Tamanho | 8 |
Valor Inicial | |
Mandatório | Sim ( ) Não (X) |
Descrição | Data emissao programação |
Título | Dt Prog |
Picture | @! |
Help de Campo | Data de Emissão da Programação |
Campo | DTPREV |
Tipo | D |
Tamanho | 8 |
Valor Inicial | |
Mandatório | Sim ( ) Não (X) |
Descrição | Data Prevista Programação |
Título | Dt Prev |
Picture | @! |
Help de Campo | Data Prevista da Programação de Entrega |
Campo | HRPREV |
Tipo | C |
Tamanho | 5 |
Valor Inicial | |
Mandatório | Sim ( ) Não (X) |
Descrição | Hora Prevista Programação |
Título | Hr Prev |
Picture | @r 99:99 |
Help de Campo | Hora Prevista da Programação de Entrega |
(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou rotinas no menu).
CONFIGURAÇÃO DE MENUS
2. No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:
Menu | Informe o Menu em que estará localizada a rotina |
Submenu | Informe o Submenu em que estará localizada a rotina |
Nome da Rotina | Informe o Título da rotina |
Programa | Informe o Fonte da rotina |
Módulo | Informe o Nome do(s) produto(s) a ser utilizado ou “Todos” |
Tipo | Informe a Função |