Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

  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 utilizadas
  8. Rotinas envolvidas
  9. 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.

...

Informações
titleInformação Importante

O workflow limita-se a enviar um e-mail com uma listagem dos funcionários com férias em dobro vencidas e a vencer. dependendo , se encontrar funcionários na situação mencionada.

Além disso, sempre será enviado um e-mail com o log de processamento, indicando o início, a quantidade de registros processos e o término, para toda vez que o processo for executado e para cada filial que for executado.

Depende do usuário a interpretação das informações disponibilizadas e a realização da geração das férias dos funcionários listados.

...

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


Informações
titleInformação Importante

Para que não vença o segundo período, o funcionário precisa retornar das férias até o dia 14/12/2019. Em uma consulta executada meados do mês 10/2019 tal funcionário deve ser listado já que nos aproximamos da data limite de gozo do primeiro período.


b. Parâmetros (SX6):

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

ParâmetroDescrição do ParâmetroTipoExemplo de utilização
MV_WFFEREMEndereço de e-mail para envio do workflow de ferias em dobro.  Caractere[email protected]
MV_WFFERVEDetermina a quantidade de dias a ser usado como limite de range de busca de ferias em dobro a vencer.Numérico

65

MV_RHCONTAConta de e-mail utilizada para envio.Caractere[email protected]
MV_RHSERVServidor de e-mail utilizado para envio.Caractere[email protected]
MV_RHSENHASenha do e-mail utilizado para envio.Caractere123456
Informações
titleInformação Importante


O parâmetro MV_WFFEREM poderá ser preenchido com um ou mais destinatários de acordo com a necessidade. Para isso os e-mails devem ser separados por ponto e vírgula ( ; ).


Tem dúvidas Duvidas sobre a configuração de parâmetros? acesse a documentação:

Alterar Parâmetros (CFGX017 - SIGACFG)

...


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.

Informações
titleInformação Importante

Dúvidas nesse processo? acesse:

Configuração do Servidor de E-mail/Proxy (CFGSETMAIL - SIGACFG)

d. Configuração do Schedule

Ainda no configurador acesse Schedule(CFGA010).

...

Informações
titleInformação Importante

Não existem parâmetros na configuração do schedule da rotina GPEW030.

...

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


Informações
titleInformação Importante

Note que a data limite de gozo para o funcionário da matrícula 12823 está próxima 11/11/2019 mas ainda está no prazo. Por outro lado a data limite de gozo do funcionário 001025 já venceu.

07. TABELAS UTILIZADAS 

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

...


HTML
<!-- 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>