Árvore de páginas

Melhoria na Busca de Restrições por Área de Restrições

Características do Requisito

Linha de Produto:

Microsiga Protheus®

Segmento:

Distribuição e Logistica

Módulo:

Gestão de Transportes - SIGATMS

Rotina:

Rotina

Nome Técnico

TMSA023

Áreas de Restrição

TMSA024

Regras de Restrição

TMSA146

Programação de Carregamento

TMSXFUNCGenéricos
TMS11R170Update
OMSA090Cadastro de Pontos por Setor   

País:

Brasil

Banco de Dados:

Todos

Tabelas Utilizadas:

DIR - Área de Restrição

DIS - Itens Área Restri. CEP     

DIT - Itens Área Restri. Rota

DIU - Regras de Restrição

DIV -  Itens Regras Restr. Dia Sem. 

DIX - Itens Regras Restr. Outros

DIY - Restrições da Viagem  

DA7 - Pontos por Zona e Setor

Sistemas Operacionais:

Windows® / Linux®

Release:

11.80.13

Descrição

Implementada a melhoria na rotina de Restrições (TMSRESTRI),  que permite realizar a busca de restrições por área de 3 formas diferentes:

  • Por CEP's dos documentos da viagem.
  • Por faixas de CEP da rota da viagem .
  • Ambas.

Correção de inconsistência no sistema referente ao estouro de tamanho de Query ao utilizar uma rota com muitas faixas de CEP.

Melhoria dos Helps de campos do processo de Restrições.

 

Importante

Antes de executar o compatibilizador informe o TMSP11R1 é 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® ByYou Smart Client, digite TMSP11R1 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 ou é apresentada a janela para seleção do compatibilizador. Selecione o programa TMS11R170.
  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.

Atualizações do Compatibilizador

  1.  Criação de Campos no arquivo SX3 – Campos:
    • Tabela DA7Pontos por Zona e Setor:

 

Campo

DA7_PEROBR

Tipo

Caractere

Tamanho

1

Decimal

0

Formato

@!

Título

Perc. Obrig.

Descrição

Percurso Obrigatório 

Usado

Sim

Obrigatório

Não

Browse

Sim

Opções

0=Não;1=Sim

Relação

"0"

Val. Sistema

Pertence("01")    

Help

Define se o percurso será  definido como obrigatório para a analise de restrições da Viagem por Área.


Importante:

O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.

 

  1.  Alteração de Campos no arquivo SX3 – Campos:
    • Tabela DIR - Área de Restrição:

Campo

DIR_CODARE

Help

Código único referente a área de restrição, este campo possui gravação automática sequencial.

Campo

DIR_DESARE

Help

Recebe a descrição da área                                                                                                             

 

    • Tabela DIS - Itens Área Restri. CEP:
       

Campo

DIS_CODARE

Help

Código único referente a área de restrição, este campo possui gravação automática sequencial referente ao cabeçalho (DIR).  

Campo

DIS_ITEM

Help

Recebe o número de item referente as linhas de registro.                                                                

Campo

DIS_CEPINI

Help

Recebe o CEP inicial referente ao registro de faixa de CEP da área de restrição.                            

Campo

DIS_CEPFIM

Help

Recebe o CEP final referente ao registro de faixa de CEP da área de restrição.                               

Campo

DIS_OBSCEP

Help

Recebe a observação referente a faixa de CEP.                                                                                 

 

  • Tabela DITItens Área Restri. Rota:

Campo

DIT_CODARE

Help

Código único referente a área de restrição, este campo possui gravação automática sequencial referente ao cabeçalho (DIR).   

Campo

DIT_ITEM

Help

Recebe o número de item referente as linhas de registro.                                                                      

Campo

DIT_ROTA

Help

Recebe o Código da rota cadastrado na tabela Rotas (DA8).                                                                

Campo

DIT_PRACA

Help

Recebe a Descrição da rota cadastrado na tabela Rotas (DA8).                                                            

Campo

DIT_OBSROT

Help

Recebe a observação referente a rota da área de restrição.                                                                   

 

  • Tabela DIURegras de Restrição:

Campo

DIU_CODREG

Help

Código único referente a regra de restrição, este campo possui gravação automática sequencial.       

Campo

DIU_TIPRES

Help

Recebe o tipo da restrição:

1 – Cliente: Restrições definidas para um cliente especifico.

2 – Área: Restrições definidas para uma área especifica.                                                                         

Campo

DIU_CODCLI

Help

Recebe o código do cliente que a restrição será aplicada.
Campo ativo somente quando o tipo da restrição for 1- Cliente.                                                                

Campo

DIU_LOJCLI

Help

Recebe a loja do cliente que a restrição será aplicada.
Campo ativo somente quando o tipo da restrição for 1- Cliente.                                                                

Campo

DIU_ABRANG 

Help

Recebe abrangência do cliente que a restrição será aplicada:

1- Cliente/Loja – Indica que se aplica para uma determinada loja do cliente.

2-  Cliente – Indica que se aplica a todas as lojas do cliente.

Campo ativo somente quando o tipo da restrição for 1- Cliente.                                                                 

Campo

DIU_CODARE

Help

Recebe o código da área da tabela Área de Restrição (DIR) para qual a restrição será aplicada.

Campo ativo somente quando o tipo da restrição for 2- Área.                                                                      

Campo

DIU_DESARE

Help

Recebe a descrição da área de restrição.                                                                                                     

Campo

DIU_INIVIG

Help

Recebe a Data Inicial de Vigência da Restrição.                                                                                           

Campo

DIU_FIMVIG

Help

Recebe a Data Final de Vigência da Restrição.                                                                                             

 

  • Tabela DIV - Itens Regras Restr. Dia Sem.:

Campo

DIV_CODREG

Help

Código único referente a regra de restrição, este campo possui gravação automática sequencial referente ao cabeçalho (DIU).

Campo

DIV_ITEM

Help

Recebe o número de item referente as linhas de registro.                                                                             

Campo

DIV_DESCRI

Help

Recebe a Descrição do Item da Regra de Restrição.                                                                                     

Campo

DIV_DIASEM

Help

Recebe qual o dia da semana em que a regra se aplica.                                                                               

Campo

DIV_SERTMS

Help

Selecione o Serviço de Transporte (Transporte/Entrega/Coleta), que será válido nesta Regra.

Este campo só estará ativo para o Tipo de Restrição (DIU_TIPRES) igual a 1 - Cliente.                               

Campo

DIV_DESSVT

Help

Ao selecionar o Serviço de Transporte, este campo será preenchido automaticamente com o Serviço de Transporte.

Campo

DIV_TIPVEI

Help

Recebe o tipo do veículo que será avaliado na regra de restrição.                                                                 

Campo

DIV_DESTIP

Help

Recebe a descrição do tipo de veículo.                                                                                                            

Campo

DIV_PLACA

Help

Recebe os números finais das placas dos veículos para que serão avaliados na regra de restrição.

Este campo só estará ativo para o Tipo de Restrição (DIU_TIPRES) igual a 2 - Área.                                   

Campo

DIV_HORINI

Help

Campo informativo, que recebe a hora inicial da Restrição.                                                                             

Campo

DIV_HORFIM

Help

Campo informativo, que recebe a hora final da Restrição.                                                                                

Campo

DIV_MOTIVO

Help

Campo informativo que recebe o motivo da regra de restrição.                                                                         

 

  • Tabela DIX - Itens Regras Restr. Outros:

Campo

DIX_CODREG

Help

Código único referente a regra de restrição, este campo possui gravação automática referente ao cabeçalho (DIU).

Campo

DIX_ITEM

Help

Recebe o número de item referente as linhas de registro.                                                                                    

Campo

DIX_DESCRI

Help

Recebe a Descrição do Item da Regra de Restrição.                                                                                            

Campo

DIX_TIPREG

Help

Recebe o tipo da regra de usuário.

1 - Bloqueio: Será utilizada para realizar os bloqueios de viagem, conforme o campo Ação (DIX_ACAO).

2 - Informativa: Será utilizada apenas para exibir a mensagem informada no campo Ação (DIX_ACAO).          

Campo

DIX_ACAO

Help

Se o campo Tipo da Regra (DIX_TIPREG) for:

1 - Bloqueio: O campo Ação deve receber uma função para validar a restrição e caso a restrição deva ocorrer para a regra avaliada, o retorno da mesma deverá ser o valor lógico true (.T.), caso contrário o retorno deverá ser o valor lógico false (.F.).

2- Informativa: O campo Ação deve receber um texto informativo, que será apresentado nas restrições informativas, neste caso a mesma não realizará bloqueio na viagem.   

 

  • Tabela DIY - Restrições da Viagem:

Campo

DIY_FILORI

Help

Recebe a filial de origem da viagem que sofreu bloqueio de restrição.                                                               

Campo

DIY_VIAGEM

Help

Recebe o código da viagem que sofreu bloqueio de restrição.                                                                            

Campo

DIY_CODBLQ

Help

Recebe o código de bloqueio referente a Restrições, existente na tabela SX5.                                                   

Campo

DIY_COREG

Help

Recebe o código da regra de restrição, referente à tabela Regras de Restrição (DIU), que restringiu a viagem.

Campo

DIY_CATEGO

Help

Recebe a categoria do bloqueio gerado:
1 – Restrições: Restrição realizada no cadastro sistêmico.

2- Restrições de usuário: Restrição realizada através de função de usuário.                                                       

Campo

DIY_ITEM

Help

Recebe o número de item referente as linhas de registro de bloqueio.                                                                  

Campo

DIY_DESCRI

Help

Recebe a descrição da regra que causou o bloqueio.                                                                                             

Campo

DIY_CODCLI

Help

Recebe o Código do cliente, caso a campo Tipo de Restrição (DIU_TIPRES) for igual a:  1- Cliente.                    

Campo

DIY_LOJCLI

Help

Recebe a loja do cliente, caso a campo Tipo de Restrição (DIU_TIPRES) for igual a:  1- Cliente.                          

Campo

DIY_NOMCLI

Help

Recebe o nome do cliente, caso a campo Tipo de Restrição (DIU_TIPRES) for igual a:  1- Cliente.                       

Campo

DIY_CODARE

Help

Recebe o código da área de restrição, caso a campo Tipo de Restrição (DIU_TIPRES) for igual a:  2- Área.         

Campo

DIY_DESARE

Help

Recebe a descrição da área de restrição, caso a campo Tipo de Restrição (DIU_TIPRES) for igual a:  2- Área.     

 

Importante:

O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.

 

CONFIGURAÇÃO DE PARÂMETROS

 

  1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). configure o parâmetro a seguir:

Itens/Pastas

Descrição

Nome:

MV_TMSRLC

Tipo:

Caractere

Cont. Por.:

0

Descrição:

Habilita a Restrição de Localização e Cliente     

0=Não Utiliza;1=CEPs do Documento;2=Faixas de CEP da Rota; 3=Ambos

 

Procedimento para Utilização

Pré-requisitos:

Importante

Para atender o processo de Restrições é necessário que:

  • A Configuração básica do TMS seja efetuada.
  • O requisito de restrições esteja configurado no ambiente (Para maiores informações, consultar o chamado TRJHW0).  
  • O processo para geração da viagem (Coleta, Transporte e Entrega), deverá conter informações relacionadas ao cadastro de Regra de Restrições, possibilitando a evidência das restrições. 
  • Para a visualização de Outras Restrições do tipo Informativas que não geram bloqueio, é necessário configurar o parâmetro de tela: Exibir Outras Restrições? com a opção SIM.
    A configuração deste parâmetro poderá ser realizada através da tecla F12 na tela de Viagens em Gestão de Transportes (SIGATMS) Atualizações / Viagens / Rodoviário (Coleta, Transporte ou Entrega) / Viagem (TMSA141).

 

Incluir Área de Restrição: 

  1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Logística / Área de Restrição (TMSA023).
    Observe que o sistema apresenta a tela de cadastro de Área de Restrições, onde deve ser informado um intervalo de Cep, Rota ou Ambos.
  2. Na tela Área de Restrição, clique em Incluir.
  3. Cadastre uma nova Área de Restrição.
  4. Preencha os campos das pastas CEP / Rota, conforme orientação dos helps de campo.
    Observe que há a possibilidade de adicionar todos os ceps de uma determinada rota por meio da opção Adicionar.

 

Incluir Regras de Restrições: 

  1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Logística / Regras de Restrições (TMSA024).
    Observe que o sistema apresenta a tela de cadastro de Regras de Restrições, onde deve ser definida todas as regras para uma determinada Área ou Cliente, ou seja, toda regra de bloqueio de uma viagem é realizada por meio deste cadastro.
  2. Na tela de Regras de Restrições, clique em Incluir.
  3. Cadastre uma nova regra.
  4. Preencha os principais campos conforme orientação dos helps de campo.
    - Cabeçalho: Define se a regra será aplicável a uma Área ou Cliente, seguido da data de vigência (Período de atividade da regra).
    - Pasta Restrições: São definidas as restrições para o dia da semana, como informar o rodizio de veículos de acordo com o final da placa ou tipo de transporte (Coleta, Transporte, Entrega), ou do tipo de veículo.
     
    Dica: Quando o tipo de restrição for por Cliente, não será permitido escolhermos o tipo de serviço “2- Transporte”. A Restrição para Cliente, ocorrerá para viagens de Coleta e Entrega.
    Pasta Restrições de Usuário: São definidas as restrições que podem ser configuradas pelo usuário por meio do campo Ação (DIX_ACAO).           
    • Campo Tipo de Restrições (DIX_TIPREG) = Bloqueio: Indica que o sistema deverá executar a ação definida pelo usuário (DIX_ACAO).
    • Campo Tipo de Restrições (DIX_TIPREG) = Informativa: Indica que a restrição é apenas informativa. Neste caso, o usuário deverá digitar a informação no campo Ação, o mesmo será tratado apenas como mensagem.
    • Campo Ação (DIX_ACAO): Deverá receber uma formula ou função sempre retornando uma variável logica, ou F, a qual irá gerar um bloqueio (Restrição) no caso do Campo Tipo de Restrições (DIX_TIPREG) = Bloqueio, caso contrario o campo deverá receber uma mensagem informativa.

Configurar os Pontos por Setor que possuam faixas de CEP com percurso obrigatório:          

  1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Logística / Pontos por Setor (OMSA090).
  2. Selecione a Zona/Setor e clique em Alterar.
  3. Selecione a aba de Códigos de Endereçamento Postal.
  4. Altere o campo Perc. Obrig. (DA7_PEROBR) na Grid de dados para o valor 1- Sim, caso o mesmo tenha o percurso obrigatório na rota, caso contrario selecione o valor 0- Não.
  5. Para guardar as informações, clique em Confirmar.

   Atenção: Esta configuração só será utilizada na restrição caso o parâmetro MV_TMSRLC, esteja com valores iguais a: 2=Faixas de CEP da Rota ou 3=Ambos.


Incluir Viagem (Coleta, Transporte, Entrega):                               

O processo para geração da viagem segue o mesmo padrão do sistema.

Viagem de Coleta:

  1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / S.A.C / Solicitação de Coleta (TMSA460).
  2. Inclua uma solicitação de coleta, respeitando o cliente do cadastro restrições.
  3. Acesse Atualizações / Viagens / Rodoviário Coleta / Viagem (TMSA141) ou Viagem (Mod.2) (TMSA144).
  4. Inclua uma viagem referenciando a solicitação incluída.
  5. Antes de confirmar a viagem é necessário incluir o Complemento da Viagem, definindo Rota, Veículo, Data e Hora de Inicio da Viagem.
    Dados que devem corresponder ao Cadastro de Restrições.                                                


Viagem de Transporte: 

  1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Recebimento / Entrada Dc. Cliente (TMSA050).
  2. Inclua o documento do Cliente e calcule o lote.
  3. Acesse Atualizações / Viagens / Rodoviário Transporte / Viagem (TMSA141) ou Viagem (Mod.2) (TMSA144).
  4. Inclua a viagem.
  5. Antes de confirmar a viagem é necessário incluir o Complemento da Viagem, definindo Rota, Veículo, Data e Hora de Inicio da Viagem.
    Dados que devem corresponder ao Cadastro de Restrições por Área.


Viagem de Entrega: 

  1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Recebimento / Entrada Dc. Cliente (TMSA050).
  2. Inclua o documento do Cliente respeitando o cliente do cadastro de restrições e calcule o lote.
  3. Acesse Atualizações / Viagens / Rodoviário Entrega / Viagem (TMSA141) ou Viagem (Mod.2) (TMSA144).
  4. Inclua a viagem referenciando o documento calculado.
  5. Antes de confirmar a viagem é necessário incluir o Complemento da Viagem, definindo Rota, Veiculo, Data e Hora de Início da Viagem.
    Dados que devem corresponder ao cadastro de restrições.
  6. Confira os dados e confirme.

 

Observações :

    1. As restrições encontradas são apresentadas em duas Telas:
      A primeira com as Restrições do tipo Informativa, que possibilitam a consulta em seu cadastro por meio da opção Visualizar.
      A segunda com todas as Restrições que irão gerar o bloqueio da viagem.
    2. Ações do  parâmetro  MV_TMSRLC:
      • Caso esteja configurado como 0 - Não utiliza: As restrições não serão avaliadas para a geração de bloqueio.
      • Caso esteja configurado como 1 - CEP's do Documento: As restrições por área serão avaliadas a partir dos CEP's dos clientes dos documentos da viagem.
      • Caso esteja configurado como 2 - Faixas de CEP da Rota: As restrições por área serão avaliadas a partir das faixas de CEP's com percurso obrigatório da rota selecionada na viagem.
      • Caso esteja configurado como 3 - Ambos: Em Ambos os casos (1 e 2), serão utilizados para avaliar as restrições por área.

 

Visualizar Itens da Viagem Bloqueada:

  1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Transporte / Liberação Viagem (TMSA400).
    Observe que a tela de Liberação da Viagem é apresentada.
  2. Na tela de Liberação da Viagem, selecione uma viagem.
  3. Clique em Ações Relacionadas e selecione a opção Visualizar.
    Observe que no segundo grid será apresentado todos os itens que irão gerar o bloqueio da viagem por Restrições.

   Dica: Caso esteja utilizando a nova Rotina x Bloqueios (TMSA025), o código R1 identifica o tipo de bloqueio para a Restrição.

 

Programação de Carregamento:

O Processo de utilização da rotina continua o mesmo.

As buscas de restrição seguirão os seguintes métodos de avaliação: 

    • Caso o parâmetro MV_TMSRLC esteja configurado como 0 - Não utiliza: As restrições não serão avaliadas para a geração de bloqueio.
    • Caso o parâmetro MV_TMSRLC esteja configurado como 1 - CEP's do Documento: As restrições por área serão avaliadas a partir dos CEP's dos clientes dos documentos selecionados.
    • Caso o parâmetro MV_TMSRLC esteja configurado como 2 - Faixas de CEP da Rota: As restrições por área serão avaliadas a partir das faixas de CEP's com percurso obrigatório da rota selecionada para a programação.
    • Caso o parâmetro MV_TMSRLC esteja configurado como 3 - Ambos: Em Ambos os casos (1 e 2), serão utilizados para avaliar as restrições por área.