Histórico da Página

...

1. Objetivo
2. Visão Geral
3. Exemplo de Utilização
   1. Montagem do cenário
   2. Parâmetros (SX6)
   3. Configuração do Servidor de E-mail/ProxyParametrização
   4. Configuração do Schedule
4. Tela de Cadastro de Schedule
   
   
5. Arquivo de configuração
6. Exemplo de e-mail recebidoMensagens de Integração
7. Tabelas utilizadasRotinas envolvidas
8. Anexos

01. OBJETIVO

Permite configurar um workflow que enviará ao usuário configurado, um e-mail na data determinada, com uma listagem dos funcionários que possuem férias em dobro a vencer dentro de uma quantidade determinada de dias, possibilitando o planejamento das férias antes de seu vencimento. Caso haja férias em dobro já vencidas, estas também serão listadas.

...

...

Importante possuir funcionários com período de férias vencido ou próximo da data de vencimento.

a

...

. Montagem do cenário:

• Funcionário admitido em 15/12/2017:

Image Added

• Calculada e fechada a folha do mês 09/2019 para que o controle de dias de direito fosse atualizado. Veja que foram gerados os dois períodos aquisitivos:

Image Added

...

b. Parâmetros (SX6):

Acesse o módulo configurador e configure os parâmetros :do workflow.

...

c. Configuração do Servidor de E-mail/Proxy

Caso o Protheus não esteja configurado para envio de e-mails precisará fazê-lo agora.

Acesse o configurador no caminho Ambiente->E-mail/proxy e preencha os dados de acordo com o servidor de e-mail utilizado.

d. Configuração do Schedule

Ainda no configurador acesse Schedule(CFGA010).

...

1. Acessar o módulo SIGACFG - Configurador
2. Acessar o caminho do menu AMBIENTE/SCHEDULE/SCHEDULE
3. Clicar na opção Cadastro no calendário de agendamentos, conforme imagem1 da tela no Tópico 04.
4. O preenchimento é simples e intuitivo para o preenchimento correto do schedule(leia o item 5 abaixo antes de confirmar o cadastro)
5. Clique o ícone cinza ao lado do botão de confirmar, pois lá se encontra as informações de periodicidade de acionamento da rotina cadastrada (Imagem 2 do Tópico 04).
6. Após a confirmação do cadastramento, será necessário habilitar os agents(Imagem 3 do Tópico 04 ), onde você pode cadastrar manualmente ou pressionar o ícone de radar verde no canto superior direito e os agents serão incluídos automaticamente.
7. Com os agents devidamente cadastrados, o usuário deve pressionar o ícone de pasta do lado esquerdo e ligar Task Manager e Queue Manager (São os gerenciadores da fila de acionamento dos agents) 

04. TELA DE CADASTRO DE SCHEDULE  

...

Preenchimento da periodicidade dos acionamentos:

Interface de Agents.

05.

...

Para possibilitar o acompanhamento  da integração do Protheus com a Carol, será apresentado algumas mensagens em tela caso o acionamento seja manual pelo menu ou no console.log quando a rotina for acionada via Schedule.

• Caso o código NSR enviado por parâmetro e o mesmo seja abaixo de zero:
  • Verifique o Código NSR Informado, pois o mesmo somente aceita números positivos!
• Inconsistências nas datas:
  • Verifique as Datas informadas para acesso ao Clockin da Carol.
• Será apresentado a seguinte mensagem e a mensagem retornada da plataforma Carol.
  • Não foi possível acessar a API Clockin da Carol.
• Problemas com o preenchimento dos parâmetros:
  • Verifique o parâmetro MV_APICLO1 pois ele é responsável pelo cadastro da URL de EndPoint para a integração de Clockin da Carol.
  • Verifique o parâmetro MV_APICLO2 pois ele é responsável pelo cadastro do path da api Token para a integração de Clockin da Carol.
  • Verifique o parâmetro MV_APICLO3 pois ele é responsável pelo cadastro do Id Conector para a integração de Clockin da Carol.
  • Verifique o parâmetro MV_APICLO4 pois ele é responsável pelo cadastro do User Name para a integração de Clockin da Carol.
  • Verifique o parâmetro MV_APICLO5 pois ele é responsável pelo cadastro do Password para a integração de Clockin da Carol.
  • Verifique o parâmetro MV_APICLO6 pois ele é responsável pelo cadastro do Domain Name para a integração de Clockin da Carol.
  • Verifique o parâmetro MV_APICLO7 pois ele é responsável pelo cadastro do path da api DeviceList para a integração de Clockin da Carol.
  • Verifique o parâmetro MV_APICLO8 pois ele é responsável pelo cadastro do path da api clockinrecordsList para a integração de Clockin da Carol.
  • Não foi possível acessar a API Clockin da Carol. Verifique os parametros MV_APICLO0, MV_APICLO1, MV_APICLO2, MV_APICLO3, MV_APICLO4, MV_APICLO5, MV_APICLO6,MV_APICLO7, MV_APICLO8 com as informações fornecidas.
  • Não foi possível acessar a API Clockin da Carol. Verifique o parametro MV_APICLO8 pois ele é responsável pelo cadastro do path da api clockinrecordsList para a integração de Clockin da Carol.

06. TABELAS UTILIZADAS 

• SP0 -  Pré-Leitura\Relógio de Ponto  
• RFE -  Relógio de Ponto  
• SP8 - Movimento de Marcações  
• MSA_CONTROL_MARCAC - Tabela criada na primeira carga de dados com a Carol, esta tabela também é utilizada no modelo de integração com o TSA  e a partir deste momento será processado pelo sistema onde será gerado os registros na SP8.

07. Rotinas Envolvidas

• GPEA010 : Cadastro de Funcionários
• PONA030 : Cadastro de Relógios
• PONM010: Leitura e Apontamento

08. Anexos

...

1. https://tdn.totvs.com/x/kum2Hg

...

1. https://tdn.totvs.com/x/34W2Hg

ARQUIVO DE CONFIGURAÇÃO 

Após a configuração a sessão mail do appserver.ini deve estar da seguinte forma:

[MAIL]
Protocol=SMTP
authLogin=0
authNTLM=0
authPlain=0
ExtendSMTP=1
TLSVersion=3
SSLVersion=2

06. EXEMPLO DE E-MAIL RECEBIDO 

Veja abaixo um exemplo de e-mail recebido: 

Image Added

07. TABELAS UTILIZADAS 

• SRA -  Funcionários;  
• SRF -  Programação de férias.

...

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>