Histórico da Página
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: |
| ||||||||||||||
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:
Contate o Help Desk Framework EM CASO DE DÚVIDAS! |
---|
- Em Microsiga Protheus® ByYou Smart Client, digite TMSP11R1 no campo Programa Inicial.
- Clique em OK para continuar.
- 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.
- Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
É apresentada uma mensagem explicativa na tela. - 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.
- Clique em Gravar para salvar o histórico (log) apresentado.
- Clique em OK para encerrar o processamento.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
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
- Criação de Campos no arquivo SX3 – Campos:
- Tabela DA7 - Pontos 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.
- 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:
- 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 DIT - Itens Á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 DIU - Regras 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 | DIU_LOJCLI |
Help | Recebe a loja do cliente que a restrição será aplicada. |
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
- 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:
- 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. - Na tela Área de Restrição, clique em Incluir.
- Cadastre uma nova Área de Restrição.
- 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:
- 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. - Na tela de Regras de Restrições, clique em Incluir.
- Cadastre uma nova regra.
- 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, T 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 obrigatório:
- Em Gestão de Transportes (SIGATMS) acesse Atualizações / Logística / Pontos por Setor (OMSA090).
- Selecione a Zona/Setor e clique em Alterar.
- Selecione a aba de Códigos de Endereçamento Postal.
- 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.
- Para guardar as informações, clique em Confirmar.
Obs. 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:
- Em Gestão de Transportes (SIGATMS) acesse Atualizações / S.A.C / Solicitação de Coleta (TMSA460).
- Inclua uma solicitação de coleta, respeitando o cliente do cadastro restrições.
- Acesse Atualizações / Viagens / Rodoviário Coleta / Viagem (TMSA141) ou Viagem (Mod.2) (TMSA144).
- Inclua uma viagem referenciando a solicitação incluída.
- 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:
- Em Gestão de Transportes (SIGATMS) acesse Atualizações / Recebimento / Entrada Dc. Cliente (TMSA050).
- Inclua o documento do Cliente e calcule o lote.
- Acesse Atualizações / Viagens / Rodoviário Transporte / Viagem (TMSA141) ou Viagem (Mod.2) (TMSA144).
- Inclua a viagem.
- 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:
- Em Gestão de Transportes (SIGATMS) acesse Atualizações / Recebimento / Entrada Dc. Cliente (TMSA050).
- Inclua o documento do Cliente respeitando o cliente do cadastro de restrições e calcule o lote.
- Acesse Atualizações / Viagens / Rodoviário Entrega / Viagem (TMSA141) ou Viagem (Mod.2) (TMSA144).
- Inclua a viagem referenciando o documento calculado.
- 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. - Confira os dados e confirme.
Observações :
- 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. - 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.
- As restrições encontradas são apresentadas em duas Telas:
Visualizar Itens da Viagem Bloqueada:
- Em Gestão de Transportes (SIGATMS) acesse Atualizações / Transporte / Liberação Viagem (TMSA400).
É possível observar Observe que a tela de Liberação da Viagem é apresentada. - Na tela de Liberação da Viagem, selecione uma viagem.
- Clique em Ações Relacionadas e selecione a opção Visualizar.
É possível observar 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.