RH - Linha Protheus - PON - Como configurar o Schedule de Leitura/Apontamento

Dúvida
Como configurar o Schedule de Leitura/Apontamento?

Ambiente
TOTVS RH - TOTVS RH (Linha Protheus) - Ponto Eletrônico - Todas as versões

Solução
1. Por ser uma rotina customizável (RDMake) é necessário compilar o fonte PONWORK.PRX e os arquivos de tradução .TRES como o PONWORK_PT-BR.TRES no ambiente, pois a rotina não está presente no repositório padrão. Para isto, baixe a expedição do RH e na pasta RDMAKEs baixe os arquivos correspondentes em seu projeto da ferramenta de compilação(VS CODE). 
Pacote da expedição RH

Em caso de dúvidas sobre processo de compilação via VS CODE entre na comunidade do GITHUB.

Antes de executar a rotina verifique no inspetor de objetos se estão compilados os arquivos de tradução dos idiomas utilizados executar a rotina sem esses arquivos pode ocasionar erros.


2. Configurar os serviços no Appserver.ini conforme exemplo abaixo:

[OnStart]
jobs=FWSCHDMANAG,FWSCHDQUEUE  
RefreshRate=180

[FWSCHDMANAG]
Main=FWSCHDMANAG
Environment=P1225(inserir o nome do seu ambiente)                                                                           

[FWSCHDQUEUE]
Main=FWSCHDQUEUE
Environment=P1225(inserir o nome do seu ambiente)
     
3. Configurar inicialmente os processadores de Agendamento/Agents. Para isso, siga os passos abaixo:
- Acessar o Configurador na rotina Ambiente>Schedule>Schedule;
- Acesse na aba lateral esquerda a opção Agents:


- No menu superior, clique na opção outras ações>Adicionar Agentes padrão. 
**Estes agents serão os responsáveis por executar os processos agendados.


4. Iniciar os Agents:


5. Após isso, será necessário configurar o Agendamento e sua recorrência (quantidade de vezes em que o job será executado durante o dia):
- Acesse na aba lateral esquerda a opção Agend.:


- Clicar em Novo para incluir um novo agendamento:


- Na tela inclusão de agendamento, será necessário preencher com a função U_PONSCHEDULER e os parâmetros desejados e após isso, clicar em avançar e cofigurar a recorrência. Segue um exemplo abaixo:



Incluir as informações conforme seu ambiente e avançar para concluir a inclusão do agendamento:
Importante: Não é possível editar parâmetros no botão abaixo, pois os parâmetros são incluídos na inclusão da rotina de agendmamento:

6. Sobre os parâmetros a serem utilizados, exemplo:
U_PONSCHEDULER("T1", "D MG 01", , .T., .T., .F., .T., .F., "3", "2",,, 1):

Se os parâmetros que não são obrigatórios não forem preenchidos, o agendamento será executado da mesma forma, ou seja, é necessário apenas que sejam informados os códigos do Grupo de Empresas e da Filial.

Abaixo, um 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.

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. Exemplos:

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
 

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