Elaborar Programação de Entrega

Características do Requisito

Descrição

Escreva aqui a descrição da nova implementação ou melhoria.

Importante

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

Antes de executar o compatibilizador informe o nome do compatibilizador é 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*.

1. Em Microsiga Protheus TOTVS Smart Client (se versão 10), digite o nome do compatibilizador no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a ___/___/____.
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 ou é apresentada a janela para seleção do compatibilizador. Selecione o programa xxxx().
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.

Descreva se há algum procedimento necessário após a aplicação do compatibilizador.

Realizar a programação de Entrega conforme as regras e políticas adotadas pela empresa.

Importante

Cadastrar as Políticas, 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, podem haver várias regras com o mesmo parâmetro, que serão executadas conforme sequência de validação indicada no atributo Ordem. Na Instrução, informar fórmula 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á exibida uma lista com informações sobre a situação do pedido, da liberação e/ou da carga montada.

No momento da confirmação do agendamento, o programa deverá executar as regras de validação.

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 Agd. Aprovação. 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 somente serão gravadas na SC9 quando houver a aprovação automática, ou por meio da aprovação manual.

Para validação da programação de entrega, clicar sobre o botão “Executar” e ele 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 por meio da opção Histórico.

Procedimento para Implantação

O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste atualizações UPDNJX deste chamado.

1. Aplique o patch do chamado e execute uma vez a rotina Informe o nome da rotina Programação de Entrega.
2. No módulo informe o nome do módulo acesse informe o caminho e verifique que o parâmetro informe o nome do parâmetro é criado conforme especificações abaixo:

1. módulo UBS, acesse Atualizações > Expedição  e verifique se as rotinas citadas acima foram criadas conforme especificado.
   
   

Atualizações do Compatibilizador

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

1. Criação ou Alteração de Perguntas no arquivo SX1 – Cadastro de Perguntes:

2.    Criação ou Alteração de tabela no arquivo SX2– Tabelas:

3.  Criação ou Alteração de Tabelas Genéricas no arquivo SX5 – Tabelas Genéricas:

4.  Criação ou Alteração (mantenha somente a instrução correspondente) de Campos no arquivo SX3 – Campos:

• Tabela BGD - Prod x Cob x Proc x Co-Part:

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:

6.  Criação ou Alteração de Índices no arquivo SIX – Índices:

7.  Criação ou Alteração de Parâmetros no arquivo SX6 – Parâmetros:

8.  Criação ou Alteração (mantenha somente a instrução correspondente) de Gatilhos no arquivo SX7 – Gatilhos:

• Tabela BD5 – Contas Médicas:

Procedimento para Configuração

(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou  rotinas no menu).

CONFIGURAÇÃO DE PARÂMETROS

1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
   (É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)

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:

Procedimento para Utilização

• Descreva os procedimentos, passo a passo (caso de uso), que serão realizados pelos usuários para que a melhoria seja visualizada identificando as seguintes informações:
• Localização da rotina no menu;
• Localização dos novos campos e/ou perguntas e respectivas pastas de cadastro que são visualizadas pelo usuário;
• Caso seja necessário ter algum cadastro feito previamente, faça uma observação.

Exemplo:

       1.            No Plano de Saúde (SIGAPLS), acesse Atualizações / Produto Saúde / Produto Saúde (PLSA800).

O sistema apresenta a janela de produtos cadastrados.

       2.            Posicione o cursor em um produto e clique em Alterar.

       3.            Na pasta Cobertura/Carências selecione a subpasta Tipo de Prestador.

       4.            Dê duplo clique no campo TP Prestador (BCW_TIPPRE).

O sistema apresenta a janela Tipo de Prestador – Coparticipação – Alterar.

       5.            Informe os dados conforme orientação do help de campo e observe o preenchimento do novo campo:

                      Som. p/Compra (BCW_SOMCOM): selecione Sim para indicar se a coparticipação cadastrada será válida somente para efeito de compra de procedimentos ou Não, caso contrário.

       6.            Confira os dados e confirme.

Vídeo

• Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.

** Canal do youtube e software de vídeoem definição.

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 sequência 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, que será executado para validar a regra. A instruçã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 regra para identificar o problema.

Tabela NJ4 - Política Programação de Entrega

Í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 Política 

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 referência à Política, podendo haver várias com o 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 Política de negócio 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 à Política.   

Campo

DTINI

Tipo

D

Tamanho

8

Mandatório

Sim ( ) Não (X)

Descrição

Data Início da Vigência

Título

Data Início

Help de Campo

Período inicial para vigência da política. 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 política. Caso não seja informado, ficará compreendido todo o período, sem restrição.

Tabela NJ5 - Programação de Entrega

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

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

Campo

PRODUT

Tipo

C

Tamanho

15

Visual

Visualizar

Mandatório

Sim (X) Não (  )

Descrição

Produto

Título

Produto do Pedido de Venda

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

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

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

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

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

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.

Procedimento para Utilização

• Definir e cadastrar Políticas de Entrega;
• Definir as regras para cada Política;
• Realizar a Programação de Entrega, informando a data prevista de Agendamento.

Ponto de Entrada

Exemplo:

#Include 'Protheus.ch'

User Function CN120ALT()

Local aCab:= PARAMIXB[1]

Local cTipo:= PARAMIXB[2]

If cTipo == '1'

    aCab[4][2]:= 'NF' //Validações do usuário

EndIf