Histórico da Página

Informações Gerais

   Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos). 

Objetivo

Permitir que seja realizado o planejamento das escalas de cobertura através das rotas para almocistas e/ou jantistas nos postos de trabalho.

Definição da regra de negócio

Durante a realização da jornada de trabalho de um ou mais atendentes que foram alocados em um posto de trabalho para a prestação de serviço, pode ser concedido um intervalo para que eles almocem ou jantem. Porém, existem algumas situações, como por exemplo nos casos dos porteiros e vigilantes, onde é necessário que sempre haja algum outro prestador cobrindo esse tal horário do almoço ou da janta, de modo a não permitir que o local sempre esteja com alguém trabalhando, sem interrupções entre os turnos de trabalho. O controle dessas situações é tido como cobertura. E, como o mesmo prestador de serviço pode ser alocado para cobrir vários horários em locais diferentes num mesmo dia de trabalho, daremos o nome de “Rota de Cobertura”.

Sendo assim, será desenvolvida uma rotina para facilitar a manutenção desse controle da jornada de trabalho desses tais prestadores de serviço que irão participar da cobertura do horário de outros em vários locais e escalas de trabalho.

A utilização da nova rotina permitirá que seja realizada a configuração da alocação de um prestador de serviço, considerando que o mesmo irá atuar como almocista e/ou jantista em um ou mais locais de trabalho, desde que tais postos necessitem da tal cobertura na sua jornada de trabalho. Para tanto, a existência destes intervalos necessitarão estar previamente mencionados na rotina de Gestão de Escadas.

O usuário do módulo poderá cadastrar várias rotas de cobertura através da nova funcionalidade. Cada uma delas receberá um nome, e em sua composição poderão ser relacionados mais de uma configuração de escala / local de trabalho (Protótipo 02).

Na parte inferior da tela de manutenção de cada rota de cobertura, na forma de um grid, estarão relacionadas as seguintes informações:

• Código do recurso humano (Código RH)
• Configuração da escala de trabalho (Conf. Escala)
  
• Grupo de trabalho (Grupo)
  
• Horário de entrada da cobertura do local de trabalho (Entrada)
  
• Horário da saída da cobertura do local de trabalho (Saída)
  
• Código do local de trabalho (Local)
  
• Descrição do local de trabalho (Desc.Local)
  
• Código da escala (Cód.Escala)
• Descrição da escala (Descr.Escala)
• Código do supervisor (Supervisor)
• Nome do supervisor (Nome Sup.)

a) Quando for executada a opção “incluir” da rotina, apenas os campos “Código RH”, “Conf.Escala”, “Grupo”, “Entrada” e “Saída” estarão disponíveis para edição do usuário.

b) Se for acionada a opção de alteração da rota de cobertura e ela não possuir um atendente associado, então será permitida a inclusão de novos “Códigos RH” / “Conf.Escalas”, bem como a alteração dos horários de entrada e saída dos “Códigos RH” / “Conf.Escalas” já relacionados a ela.
c) Se a rota de cobertura possuir um atendente associado a ela, então não será permitida a inclusão de novos “Códigos RH” / “Conf.Escalas”. Porém, será permitida a alteração dos horários de entrada e saída dos “Códigos RH” / “Conf.Escalas” já existentes.

O campo do nome da rota de cobertura estará sempre disponível para edição / alteração por parte do usuário.

Para o preenchimento do campo “Código RH” será disponibilizada uma tela de seleção na forma de uma consulta específica (Protótipo 03) que apresentará os itens de RH que possuam a escala de almocista e/ou jantista configurada. Ao preencher o conteúdo do campo “Código RH”, a rotina irá exibir automaticamente as informações referentes ao local, à escala e ao supervisor associadas a ele.

O dado informado no campo “Conf.Escala” será validado de forma a garantir que tal código seja válido perante o “Código RH”. Esta informação deverá constar como sendo uma escala de almocista ou jantista.

Será realizada a validação do conteúdo do campo “Grupo” de modo que o mesmo seja válido na “Conf.Escala” do “Código RH”.

Dentro das opções a serem disponibilizadas em “Outras ações” da rotina de manutenção da rota de cobertura existirão as chamadas para as seguintes funcionalidades:
a) “Filtro por região” (Protótipo 04): Este filtro, se informado, será aplicado na consulta padrão do campo “Código RH”, de forma a apresentar apenas os locais de atendimento que estejam localizados numa determinada região configurada como filtro dessa funcionalidade (Protótipo 05).
b) “Visualização do posto x funcionário” (Protótipo 04): Se estiver preenchida a informação do campo “Código RH” e o usuário acionar esta ação, então a tela de visualização do cadastro de “Posto x Funcionário” a ele associado será exibida.

Para associar ou remover a associação de um atendente a uma rota de cobertura, o usuário deverá acionar as funcionalidades de “Movimentar” (Protótipo 07) ou “Remover” (Protótipo 08) que estarão disponíveis através do acionamento do botão “Outras ações” da tela principal da rotina (Protótipo 06). Tais processamentos de movimentar ou remover um atendente de uma rota de cobertura serão também consumidos pelo requisito responsável pela “Alocação e Movimentação Ágil” (PCREQ-4484). Para tanto, será disponibilizada uma função que será responsável por realizar tais processos de associar e desassociar o atendente a uma rota de cobertura.

Os horários de entrada e saída informados na rota de cobertura para cada “Código RH”/”Conf.Escala” serão repassados aos itens de cobertura da rotina de Gestão de Escalas através da movimentação ágil, e consequentemente, a agenda do respectivo atendente ora associado à rota de cobertura será gerada.

Definição Técnica

Projeto e menu

Incluir no projeto SIGAWTEC.prj o fonte TECA581.PRW.
Criar o acesso à rotina no menu do módulo SIGATEC através do caminho Atualizações à Alocação à Rota de Cobertura, chamando a função TECA581.

TECA581 – Rota de cobertura

Ao acessar a rotina TECA581, as rotas de cobertura que já estiverem cadastradas (Tabela TW0) deverão ser apresentadas na forma de um browse (Protótipo 01).
Criar uma rotina em MVC que será responsável pelo cadastro das rotas de cobertura. O nome do programa fonte desta rotina será TECA581.PRW.
Para a construção / configuração do Model e da View da rotina deverão ser consideradas as tabelas TW0 e TW1 para cabeçalho e itens da rotina, respectivamente.
Deverá ser criado um botão que acionará tela de filtro por região. Para isso, deverá ser utilizado o mesmo conceito dos filtros existentes atualmente na rotina de mesa de operação (visão Contrato). Para que seja apresentada a tela do filtro por região, a rotina TECA670(<aParam>, lUseCombo) deverá ser chamada. A seguir, são apresentados os conteúdos esperados quando da sua chamada:

Na execução da opção “Incluir”, ao apresentar a tela de manutenção, na sua área superior destinada às informações de cabeçalho da rota de cobertura, apenas o campo do seu nome (TW0_DESC) deverá estar disponível para edição do usuário. Enquanto que na área inferior referente aos detalhes da rota, os campos a seguir serão editáveis: “Código RH” (TW1_CODTFF), “Conf.Escala” (TW1_CODTGX), “Grupo” (TW1_GRUPO), “Entrada” (TW1_HORINI) e “Saída” (TW1_HORFIM). Os demais campos apresentados na tela deverão estar com a sua edição bloqueada.
Na execução da opção “Alterar”
a) O campo do nome da rota de cobertura (TW0_DESC) estará sempre disponível para edição do usuário.
b) Se a rota de cobertura não possuir um atendente associado a ela (TW0_ATEND sem conteúdo):
    1. Será permitida a inclusão de novos “Códigos RH” (TW1_CODTFF) / “Conf.Escalas” (TW1_CODTGX).
    2. Será permitida a alteração dos horários de entrada (TW1_HORINI) e saída (TW1_HORFIM) referentes aos “Códigos RH” (TW1_CODTFF) / “Conf.Escalas” (TW1_CODTGX) já relacionados à respectiva rota de cobertura.
Para o campo “Código RH” (TW1_CODTFF) deverá ser criada uma consulta específica. Para construí-la, deve-se criar a função At581F3TFF. Ela será apresentada na forma de um browser com os registros da tabela TFF filtrados pela região caso este filtro esteja previamente ativo. Para recuperar a expressão com os dados do filtro da região, deverá ser utilizado a chamada para a função At670FilSql( __cUserId, .F., 'SX5', 'A2_' ). Além desse filtro da região, os “Códigos RH” apresentados neste browser da consulta específica também devem estar associados às configurações de escalas de almocistas ou jantistas. Para verificar se o “Código RH” está associado a uma configuração de escala de almocista ou jantista deverá ser verificado o campo TGX_TIPO igual a  2 ou 3, almocista ou jantista, respectivamente. Para encontrar o registro da tabela TGX correspondente ao “Código RH”, seguir os relacionamentos TFF_ESCALA == TDW_COD, e então TDW_COD == TGX_CODTDW. O retorno da informação do “Código RH” escolhido deverá ocorrer através da função At581GF3TFF, que também deverá ser construída. Os registros apresentados nesta tela da consulta específica deverão estar ordenados por local de atendimento (TFF_LOCAL). As informações a serem disponibilizadas no browser dessa consulta específica são as seguintes:

Quando ocorrer o preenchimento do campo “Código RH” (TW1_CODTFF), o mesmo deverá ser validado contra o seu cadastro, e se o mesmo for considerado válido, então os campos abaixo relacionados deverão ser automaticamente preenchidos conforme relacionamentos:

Criar um novo botão dentro de “Outras ações” da tela de manutenção da rota de cobertura, que deverá disponibilizar a view do Posto x Funcionário (TECA580E), caso o campo “Código RH” esteja preenchido.
No preenchimento do campo “Conf.Escala” (TW1_CODTGX), o seu conteúdo deverá ser validado de forma a não permitir que uma configuração de escala não esteja previamente cadastrada.
A informação digitada no campo “Grupo” (TW1_GRUPO) deverá ser validada, de forma a não permitir que seja informado um grupo não previsto para a escala daquele “Código RH”. Para construir tal validação, o conteúdo desse campo deverá ser consistido contra o campo “Quantidade de Venda” (TFF_QTDVEN) pertencente ao “Código RH” (TW1_CODTFF = TFF_COD). Caso o valor informado no campo do grupo seja superior ao conteúdo da quantidade de venda, o usuário deverá ser alertado, e a informação será considerada como inválida.
Para que o requisito que irá controlar a “Movimentação ágil” interaja com esta rotina (Rota de Cobertura), deverá ser criada a função At581Efet(<cTpOper>, <cRota>, <dData>, <cAtdMvRmv>). Esta função será responsável por realizar a efetivação (movimentação) ou a troca do atendente associado à rota de cobertura selecionada, e até mesmo a remoção da tal associação do seu atendente. Os parâmetros a serem passados a esta nova função são os seguintes:

a) Com base nestes parâmetros, a função realizará a leitura das informações da rota de cobertura em questão, e deverá atualizar a tabela responsável pelo relacionamento entre a escala e o funcionário de cobertura (Tabela TGZ) com as seus dados pertinentes.
b) Para cada item da rota de cobertura será criado um novo registro na tabela TGZ, tendo em vista os seguintes relacionamentos:

c) Para a manipulação dos dados a serem levados à tabela TGZ, deverá ser utilizada a rotina MVC TECA580E.
d) Regras para a gravação do registro na tabela TGZ quando da efetivação de um atendente a uma rota de cobertura:

• Se não existir um atendente anterior na cobertura do período/grupo/local de trabalho na tabela TGZ, um novo registro será criado com o código do atendente que está sendo efetivado, tendo como a data inicial do período igual à data da efetivação, enquanto que a data de final do período não será mencionada.
• Caso exista uma agenda do atendente anterior em um período superior à data de efetivação do novo atendente, então deverá ser realizada a troca do atendente, substituindo a informação do campo ABB_CODTEC dos registros pertencentes à agenda de atendimento.
• Se for identificado que o atendente anterior possua agendas posteriores à data de efetivação com manutenção (ABB_MANUT==’1’) ou atendidas (ABB_ATEND==’1’), o usuário deverá ser alertado através de uma mensagem, e tal efetivação da cobertura não deverá prosseguir para a referida configuração de rota, independentemente do tipo de processamento que estiver ocorrendo (movimentação ou remoção do atendente).
• Os parâmetros da função At581Efet são os seguintes:
  <cTpOper>: Informar o tipo de processamento que deverá ser realizado, onde “MV” = Movimentar (efetivar) o atendente na rota de cobertura, e “RE” = Remover a associação do atendente.
  <cRota>: Identificará a rota de cobertura em que se deseja realizar o procedimento de movimentar ou remover um atendente.
  <dData>: É esperado que seja passada a data a ser considerada como efetivação da associação do novo atendente à rota de cobertura. Caso esta data não seja informada, deverá ser assumida a data base do sistema.
  <cAtdMvRmv>: Deve conter o código do atendente que será associado à rota de cobertura ou removido da tal associação.
• Para realizar a remoção da associação entre um atendente e a rota de cobertura, a função deverá encerrar o período de atendimento do atendente anterior, gravando a sua data final do período (TGZ_DTFIM) com a informação da data de execução da efetivação da tal remoção – 1 dia, desde que este registro da tabela TGZ referente ao atendente anterior também tenha sido gerado a partir da associação com a rota de cobertura. Deverá ser utilizada a chamada da função At330GvDes para que seja realizada a exclusão da agenda (na tabela ABB) pertencente ao atendente anterior.
• Para verificar a existência ou não de um registro na tabela TGZ referente à associação de um atendente de cobertura deverão ser utilizados os campos TGZ_CODTFF, TGZ_ESCALA, TGZ_CODTGX, TGZ_GRUPO, e TGZ_ATEND.
• Caso o período compreendido pela TGZ_DTINI e TGZ_DTFIM esteja vigente, então se deve preencher a data final com o conteúdo passado como sendo a data de efetivação – 1 dia, e um novo registro deverá ser incluído na tabela TGZ para o novo atendente que passará a realizar a cobertura do local de trabalho, tendo como a sua data inicial do período, a própria data de efetivação.

O campo do código do atendente existente na tabela TW0 (TW0_ATEND) deverá sempre ser gravado com a informação do atendente cuja associação fora efetivada à respectiva rota de cobertura. O código do atendente que será gravado neste campo da tabela TW0 é o mesmo que a nova função recebeu através do seu parâmetro <cAtdMvRmv>.

Rota de cobertura – “Movimentar”:
a) Na tela inicial da rotina deverá ser criado um botão “Movimentar” (Protótipo 06). Ao acioná-lo, uma tela deverá ser apresentada ao usuário, solicitando que seja informado o código do atendente ao qual a rota de cobertura selecionada será associada (Protótipo 07). Portanto, ao confirmar esta informação, a ação deste botão será responsável por realizar a efetivação da associação do atendente a uma rota de cobertura, executando a nova função desenvolvida (At581Efet), passando os parâmetros necessários para tal processamento.
b) Caso já exista um atendente associado à rota de cobertura, o mesmo deverá ser exibido ao usuário, permitindo que o mesmo seja trocado por um novo código de atendente, que neste caso, estaria assumindo aquela rota de cobertura a partir da data base vigente do sistema.

Rota de cobertura – “Remover”:
a) Na tela inicial da rotina deverá ser criado um botão “Remover” (Protótipo 06). Ao acioná-lo, uma tela deverá ser apresentada ao usuário com a informação do atendente que naquele momento se encontra associado à rota de cobertura ora selecionada (Protótipo 08). Portanto, ao confirmar esta informação, a ação deste botão será responsável por realizar a efetivação da remoção do atendente àquela rota de cobertura, executando a nova função desenvolvida (At581Efet), passando os parâmetros necessários para tal processamento.

TECA580E – Escala x Funcionário

Alterar a rotina TECA580E para que seja permitida a gravação das datas de inicio e final da rota de cobertura em branco, respeitando sempre as regras já contidas e já validadas de grupos de atendentes.

TECA330A – Alocação por escala

Para que o horário que fora definido nas configurações de cobertura da tabela TGZ (TGZ_HORINI e TGZ_HORFIM) seja levado a alocação por escalas, a função At330AAgAt deverá sofrer uma alteração de modo a utilizar a configuração dos horários ora definidos nos campos citados para a geração da sua respectiva agenda de cobertura (Tabela TGW).

Tabelas utilizadas

·      AA1 – Atendentes
·      ABB - Agendas
·      ABS – Local de Atendimento
·      TDW – Escalas
·      TFF – Recursos humanos
·      TGS – Área de Supervisão
·      TGW – Alocação por escalas
·      TGZ – Escala x Funcionário Cobertura
·      TW0 – Grupo de Cobertura
·      TW1 – Itens do Grupo de Cobertura
·      SB1 – Produtos

Protótipos de tela

Protótipo 01 – Tela inicial da rota de cobertura

Protótipo 02 – Tela da manutenção da rota de cobertura

Protótipo 03 – Consulta específica dos “Códigos RH”

Protótipo 04 – Outras ações da tela de manutenção da rota de cobertura

Protótipo 05 – Tela de filtro da região

Protótipo 06 – Outras ações da tela inicial da rota de cobertura

Protótipo 07 – Tela de “Movimentar” atendente (Efetivando um atendente à rota de cobertura)

Protótipo 08 – Tela de “Remover” atendente da rota de cobertura

Fluxo do Processo

 1.       Diagrama – Casos de Uso

Especificação de caso de uso

Dicionário de dados

Arquivo ou Código do Script: TGZ – Escala x Funcionário Cobertura

Contexto

Opções (Combobox)

Picture Variável

Modo de edição (When)

Inicializador de browse

Condição SQL

Check SQL

Template

Consulta padrão

Grupo de Perguntas

Não se aplica 

Consulta Padrão

Consulta: TFFTGZ

Consulta: TGXTFF