Histórico da Página
TYKZ0_DT_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: | SIGATMS | ||||||||||||||
Rotina: |
| ||||||||||||||
País(es): | Brasil | ||||||||||||||
Banco(s) 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 | ||||||||||||||
Sistema(s) Operacional(is): | Windows / Linux | ||||||||||||||
Versões/Release: | 11.80 |
Descrição
Esta melhoria contempla:
- A alteração da rotina que as avaliação restrições (TMSRESTRI) para que a mesma realize 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 problema de estouro de tamanho de Query ao utilizar uma rota com muitas faixas de CEP.
- Melhoria dos Help's 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 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:
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. |
CONFIGURAÇÃO DE PARÂMETROS
- No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). configure o(s) parâmetro(s) 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 (maiores informações no 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? como SIM. A configuração deste parâmetro poderá ser realizada através da tecla F12 na tela de viagens em Gestão de Transporte (SIGATMS) Atualizações / Viagens / Rodoviário (Coleta, Transporte ou Entrega) / Viagem (TMSA141).
Incluir Área de Restrição
- Em Gestão de Transporte (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 Transporte (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 help's 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 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
- Em Gestão de Transporte (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) no 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.
- Clique em confirmar para guardar as informações.
Obs.: 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 Transporte (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 Transporte (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 Transporte (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 configurado como 0- Não utiliza: as restrição não serão avaliadas para a geração de bloqueio.
- Caso 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 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 configurado como 3- Ambos: 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 Transporte (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, 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 codigo 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 parâmetro MV_TMSRLC configurado como 0- Não utiliza: as restrição não serão avaliadas para a geração de bloqueio.
- Caso parâmetro MV_TMSRLC 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 parâmetro MV_TMSRLC 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 parâmetro MV_TMSRLC configurado como 3- Ambos: ambos os casos 1 e 2 serão utilizados para avaliar as restrições por área.