Modificação de horário planejado

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.

Procedimento para Implantação

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

1. Aplique o patch do chamado e execute uma vez a rotina Informe o nome da rotina.
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:

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.

Descrição

Essa implementação tem por objetivo adicionar novas funcionalidades ao TOTVS Automação de Ponto, para garantir que toda semana tenha somente um dia de descanso.

Abaixo exemplo do resultado esperado:

Cadastro Modificação de Horário Planejado

Foi disponibilizado o Cadastro de Modificação de Horário Planejado através do menu "Cadastros | Horários planejados | Modificação de horário" com as seguintes informações:

1. Código: Código da modificação.
2. Descrição: Descrição da modificação.
3. Início da definição: Se a definição da modificação será realizada a partir do início da semana ou fim da semana.
4. Horas na semana: O total de horas para o tipo de ocorrência a considerar dentro da semana.
5. Tipo de ocorrência a considerar: Tipo de ocorrência de presença que será definido. Exemplo: Descanso
6. Tipo de ocorrência para substituição:  Tipo de ocorrência de presença que será trocado. Exemplo: Compensado
   Explicação referente ao comportamento dos três itens anteriores.
   1. Caso o número de horas na montagem do horário do Tipo de ocorrência a considerar seja menor que as horas na semana:
      Será verificado se existe o tipo de ocorrência a considerar na montagem de horário, dentro de cada semana.
      Caso exista, irá aumentar as horas até atingir o total configurado. 
      Caso não exista, o tipo de ocorrência a considerar irá substituir o tipo de ocorrência para substituição até atingir as horas na semana. Caso o tipo de ocorrência para substituição não exista, nada será feito.
   2. Caso o número de horas na montagem do horário do Tipo de ocorrência a considerar seja igual as horas na semana:
      Nada será feito.
   3. Caso o número de horas na montagem do horário do Tipo de ocorrência a considerar seja maior que as horas na semana:
      O tipo de ocorrência a considerar será substituído pelo tipo de ocorrência para substituição até atingir as horas na semana.
7. Considera intervalos programados: Se deve considerar os intervalos programados para a modificação. Os intervalos considerados são de abono, sem ponto, afastamento, férias e descanso (grupo descanso). Caso o parâmetro esteja desmarcado, a modificação será realizada antes de aplicar os intervalos programados. Caso contrário, a modificação será aplicada após aplicar os intervalos programados, dando prioridade a eles. (Ver exemplo 5 no final do deste documento)
   

Image Added

Validações:

• Os campos "Código", "Início para definição", "Tipo de ocorrência a considerar" e "Horas na semana" são de preenchimento obrigatório.
  
  
• O campo "Horas na semana" não aceitará um valor superior a 168:00
  Image Added
  
  
• Os tipos de ocorrência não podem ser iguais.
   Image Added
  
  

Associar modificação de horário planejado ao Cadastro de Horário por Intervalo e por Jornada

Foi disponibilizado um lookup dentro do cadastro de horário por intervalo e horário por Jornada par avincular o cadastro de modificação de horário planejado. 

• Horário por intervalo:

Image Added

• Horário por Jornada:

Image Added

Validações:

• Caso seja vinculadas modificações que possuam o mesmo tipo de ocorrência a considerar o cadastro de horário não será salvo.z'
  Image Added

Evolução do cálculo do Ponto

A leitura do horário no cálculo foi evoluída para aplicar as configurações da modificação de horário. A modificação terá os seguintes comportamentos:

1. Será aplicada com uma periodicidade semanal.  

2. A modificação também deverá respeitar as horas de interjornada. Caso não respeite, será gerado aviso calculado.
3. A modificação será realizada somente para presença no horário, não sendo aplicada nos casos de ausência.
4. A memória de cálculo será evoluída para contemplar essa aplicação. 
5. A aplicação da modificação deverá respeitar o comportamento do horário: contíguo/quebra por dia.
6. A semana será definida conforme configuração de DSR no sindicato. Caso a jornada comece em um dia e termine em outro, ela será computada conforme o tipo do horário: 
   Semana 1: 01/01 a 07/01 
   Horário Contíguo: 07/01 22:00 a 08/01 05:00. Nesse caso serão consideradas as 07:00 para a semana 1.
   Horário de quebra: 07/01 22:00 a 08/01 05:00. Nesse caso serão consideradas as 02:00 para a semana 1 e 05:00 para a semana 2.

7. A alteração é possível a qualquer dia da semana, porém respeita o horário cadastrado no histórico do primeiro dia da semana. Como a periodicidade é semanal, devemos garantir a integridade da aplicação da modificação. Caso a modificação do próximo horário tenha o Tipo de Ocorrência a considerar igual ao primeiro, esta será desconsiderada.
   Ex.:

   Semana	Índice	Descrição
   Segunda-feira	4	Troca de Horário 2 x 2 Índice 4
   Terça-feira	1	T
   Quarta-feira	2	T
   Quinta-feira	4	Troca de Horário 6 x 1 e 4 x 1 Índice 4
   Sexta-feira	4	Compensa
   Sábado	1	T
   Domingo	2	T

   No exemplo acima, temos duas trocas de horário dentro da semana.

   Horário 2 x 2 (Segunda-feira)
   Horário 6 x 1 e 4 x 1 (Segunda-feira)

   Considerando que tenha modificação de horário para os dois planejados:

   Horário 2 x 2: Modificação MOD1 - Tipo Ocorrência a considerar: EDN
   Horário 6 x 1 e 4 x 1: Modificação MOD2 - Tipo Ocorrência a considerar: EDN

   Apenas o primeiro (MOD1) será aplicado, pois a troca foi realizada no começo da semana. O segundo (MOD2) será desconsiderado, pois a troca foi no meio da semana (quinta-feira):
   Horário 2 x 2: Modificação MOD1 (CONSIDERADO)
   Horário 6 x 1 e 4 x 1: Modificação MOD2 (DESCONSIDERADO)

8. A modificação será realizada da seguinte maneira:
   

   i. Caso o número de horas na montagem do horário do Tipo de ocorrência a considerar seja menor que as horas na semana:

   Será verificado se existe o tipo de ocorrência a considerar na montagem de horário, dentro de cada semana.

   Caso exista, irá aumentar as horas até atingir o total configurado. Caso não exista, o tipo de ocorrência a considerar irá substituir o tipo de ocorrência para substituição até atingir as horas na semana. Caso o tipo de ocorrência para substituição não exista, nada será feito.

   ii. Caso o número de horas na montagem do horário do Tipo de ocorrência a considerar seja igual as horas na semana:

   Nada será feito.

   iii. Caso o número de horas na montagem do horário do Tipo de ocorrência a considerar seja maior que as horas na semana:

   O tipo de ocorrência a considerar será substituído pelo tipo de ocorrência para substituição até atingir as horas na semana. Caso o tipo de ocorrência para substituição não exista, as horas a mais serão apenar retiradas, sem substituição.

9. A modificação será realizada somente para presença no horário, não sendo aplicada nos casos de ausência.
10. Deverá considerar o parâmetro "Considera intervalos programados", e definir qual terá prioridade.
11. Os intervalos programados considerados são os descansos vinculados ao grupo de descanso. Caso o parâmetro esteja desmarcado, a modificação será realizada antes de aplicar os intervalos programados. Caso contrário, a modificação será aplicada após aplicar os intervalos programados, dando prioridade a eles.
    Ex.:
    

    Horário planejado:
    2x2
    1 – TRAB (08:00)
    2 – TRAB (08:00)
    3 – COMP (24:00)
    4 – DESC (24:00)

    Horário da semana:
    SEG - 3 
    TER – 4 DESCANSO (GRUPO DESCANSO)
    QUA - 1 
    QUI - 2
    SEX - 3
    SAB – 4 DESCANSO
    DOM - 1

    a. Cadastro Modificação de horário planejado:
    Periodicidade: Semanal
    Início da definição: Fim do período
    Tipo de ocorrência a considerar: DESCANSO
    Total de horas: 24:00
    Tipo de ocorrência para substituição: COMPENSADO
    Considera intervalos programados marcado

    Horário após aplicação do cadastro:

    SEG - 3 
    TER – 4 DESCANSO (GRUPO DESCANSO)
    QUA - 1 
    QUI - 2
    SEX - 3
    SAB – 4 COMPENSADO
    DOM - 1

    
    
    

Obs: A modificação não irá ser considerada no caso de tolerâncias de presença antes/após intervalos de trabalho. Não será possível portanto entender intervalos de trabalho que possuam tolerância de presença.

Exemplos de Aplicação

1) Horário sem descanso na semana

Horário planejado:

2x2

1 – TRAB (08:00)

2 – TRAB (08:00)

3 – DESC (24:00)

4 – COMP (24:00)

Horário no período:

Cadastro modificação de horário planejado:

Periodicidade: Semanal
Início da definição: Início do período
Tipo de ocorrência a considerar: DESCANSO
Total de horas: 24:00
Tipo de ocorrência para substituição: COMPENSADO
Considera intervalos programados: Desmarcado

Horário após aplicação do cadastro:

2) Horário com descanso de menos de 24:00 na semana

Horário planejado:

6x1 e 4x1

1 – TRAB (08:00)

2 – TRAB (08:00)

3 – TRAB (08:00)

4 – TRAB (08:00)

5 – TRAB (08:00)

6 – TRAB (08:00)

7 – DESC (04:00 a +02:00)

8 – TRAB (08:00)

9 – TRAB (08:00)

10 – TRAB (08:00)

11 – TRAB (08:00)

12 – DESC (22:00)

13 - DESC (02:00)

Horário da semana:

Cadastro Tabela de horário:

Periodicidade: Semanal
Início da definição: Início do período
Tipo de ocorrência a considerar: DESCANSO
Total de horas: 24:00
Tipo de ocorrência para substituição: COMPENSADO
Considera intervalos programados: Desmarcado

Horário após aplicação do cadastro:

3) Horário com descanso de 24:00 na semana

Horário planejado:

2x2

1 – TRAB (08:00)

2 – TRAB (08:00)

3 – COMP (24:00)

4 – DESC (24:00)

Horário da semana:

Cadastro Tabela de horário:

Periodicidade: Semanal
Início da definição: Início do período
Tipo de ocorrência a considerar: DESCANSO
Total de horas: 24:00
Tipo de ocorrência para substituição: COMPENSADO
Considera intervalos programados: Desmarcado

Horário após aplicação do cadastro, continuará o mesmo:

4) Horário com descanso maior que 24:00

Horário planejado:

2x2

1 – TRAB (08:00)

2 – TRAB (08:00)

3 – COMP (24:00)

4 – DESC (24:00)

Horário da semana:

Cadastro Tabela de horário:

Periodicidade: Semanal
Início da definição: Início do período
Tipo de ocorrência a considerar: DESCANSO
Total de horas: 24:00
Tipo de ocorrência para substituição: COMPENSADO
Considera intervalos programados: Desmarcado

Horário após aplicação do cadastro:

Cadastro Tabela de horário:

Periodicidade: Semanal
Início da definição: Fim do período
Tipo de ocorrência a considerar: DESCANSO
Total de horas: 24:00
Tipo de ocorrência para substituição: COMPENSADO
Considera intervalos programados: Desmarcado

Horário após aplicação do cadastro:

5) Considerando intervalo programado

Horário planejado:

2x2

1 – TRAB (08:00)

2 – TRAB (08:00)

3 – COMP (24:00)

4 – DESC (24:00)

Horário da semana:

Cadastro Tabela de horário:

Periodicidade: Semanal
Início da definição: Fim do período
Tipo de ocorrência a considerar: DESCANSO
Total de horas: 24:00
Tipo de ocorrência para substituição: COMPENSADO
Considera intervalos programados: Marcado

Horário após aplicação do cadastro:

Aviso calculado para menos de 24 horas contínuas de descanso na semana

Foi disponibilizado uma evolução no cálculo do ponto para gerar aviso calculado quando o funcionário tiver menos de 24 horas contínuas de descanso na semana.

Como parte da solução, foi adicionado um novo registro no cadastro "Tipo de Aviso Calculado" e a janela de informações do Aviso recebeu duas novas colunas indicando a data início e fim da semana.

Image Added

Image Added

Observação: Os demais avisos, não sofreram alterações e continuam sendo calculados e apresentados diariamente. 

Possíveis condições em que serão gerados os avisos calculados:

• Caso o horário planejado possua menos de 24 horas de descanso na semana
• Caso o horário planejado possua 24 horas não continuas de descanso na semana
• Caso o horário planejado possua mais de 24 horas não continuas de descanso na semana

Possíveis condições em que NÃO serão gerados os avisos calculados:

• Caso o horário planejado possua 24 horas continuas de descanso na semana
• Caso o horário planejado possua mais de 24 horas continuas de descanso na semana

Aviso calculado no Portal

Foi disponibilizado no Portal, dois novos menus contendo uma visão com os avisos calculados dos subordinados.

• Menu interno da equipe:
  Image Added
  
  
• Anexo do espelho na visão de subordinados:
  Image Added

Essa visão possui a opção de filtro para subordinados diretos além dos mesmos filtros disponíveis no winforms.

Image Added

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