18114622 DRHJORNPRT-5888 DT Leitura Automática das Marcações Utilizando o Schedule

01. DADOS GERAIS

Produto:	TOTVS RH
Linha de Produto:	Linha Protheus
Segmento:	RH
Módulo:	SIGAPON
Função:	PONWORK PONM010
Ticket:	18114622
Requisito/Story/Issue (informe o requisito relacionado) :	DRHJORNPRT-5888

02. SITUAÇÃO/REQUISITO

Alterar o funcionamento da leitura e apontamento quando realizada via Schedule, utilizando a função PONScheduler, para se aproximar do comportamento apresentado quando a execução é realizada manualmente, chamando a função PONM010.

03. SOLUÇÃO

A função PONScheduler foi retrabalhada, alterado o comportamento para utilizar as perguntas (SX1) da rotina PONM010 e definir os períodos de apontamento que serão processados.

IMPORTANTE!

Por ser uma rotina customizável (RDMake) é necessário compilar o fonte PONWORK.PRX no ambiente, pois a rotina não está presente no repositório padrão.

Na release 12.1.2210, caso ocorra erro ao compilar arquivo PONWORK.PRX será necessário renomear o arquivo.
Após o fonte ser compilado a função U_PONSCHEDULER deve estar no RPO Custom, como na imagem abaixo.

No cadastro do Schedule deve ser chamada a função U_PONSCHEDULER informando os parâmetros desejados.
Exemplo: U_PONSCHEDULER("T1", "D MG 01", , .T., .T., .F., .T., .F., "3", "2",,, 1)

Lista dos parâmetros da função:

Índice	Descrição	Tipo	Obrigatório?	Conteúdo Padrão
01	Código da Empresa	C	Sim
02	Código da Filial	C	Sim
03	Compatibilidade - Não utilizado	-	-	-
04	Limitar a data final do apontamento a data base do sistema?	L	Não	.T.
05	Efetuar a leitura e apontamento por filial?	L	Não	.T.
06	Efetua o apontamento para relógios não lidos?	L	Não	.F.
07	Forçar o reapontamento das marcações?	L	Não	.T.
08	Processa apenas a filial passada como parâmetro?	L	Não	.F.
09	Se processa leitura, apontamento ou ambos "1" = Leitura , "2" = Apontamento , "3" = Ambos	C	Não	"3"
10	Se efetua a leitura a partir do cadastro de funcionários ou relógios "1" = Funcionário, "2" = Relógio	C	Não	"2"
11	Compatibilidade - Não utilizado	-	-	-
12	Compatibilidade - Não utilizado	-	-	-
13	Realiza a leitura e apontamento de 1 = Marcações, 2 = Refeições, 3 = Acesso, 4 = Marcações e Refeições 5 = Todos	N	Não	1

Detalhamento do funcionamento dos parâmetros

Efetuar a leitura e apontamento por filial?

Quando definido com .T. o sistema irá executar a função ponm010 para cada filial, preenchendo as perguntas Filial De? e Filial Até? com o mesmo conteúdo.
Quando definido com .F. o sistema irá executar a função ponm010 apenas uma vez sem filtrar as filiais, deixando a pergunta Filial De? em branco e a pergunta Filial Até? com "ZZZZZ"

Processa apenas a filial passada como parâmetro?

Quando definido com .T. o sistema irá executar a função ponm010 apenas para a filial enviada no parâmetro 02
Quando definido com .F. o sistema irá executar a função ponm010 para todas as filiais da empresa

Períodos de Apontamento

O sistema busca o período definido nos parâmetros MV_PONMES e MV_PAPONTA e com base nas datas, define os períodos que serão processados até o período atual, de acordo com a data de execução.

Exemplo 1:

Período definido nos parâmetros: 01/08/2023 - 31/08/2023
Data de execução do Schedule: 03/10/2023
Parâmetro Limitar a data final do apontamento a data base do sistema?: .T.
Períodos que serão processados:

01/08/2023 - 31/08/2023
01/09/2023 - 30/09/2023
01/10/2023 - 03/10/2023

Exemplo 2:

Período definido nos parâmetros: 16/08/2023 - 15/09/2023
Data de execução do Schedule: 14/10/2023
Parâmetro Limitar a data final do apontamento a data base do sistema?: .F.
Períodos que serão processados:

16/08/2023 - 15/09/2023
16/09/2023 - 15/10/2023

Caso queira implementar uma regra diferente para definir os períodos de apontamento que serão processados pela rotina, pode-se customizar a função Monta_Per presente na rotina PONWORK.

04. DEMAIS INFORMAÇÕES

Não se aplica

05. ASSUNTOS RELACIONADOS