Árvore de páginas

Versões comparadas

Chave

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

Índice


Visão Geral

Essa documentação tem como objetivo orientar sobre um novo formato de processamento que está sendo implantado parcialmente no Clock In.

No 1º momento, esse novo processamento impactará os seguintes processos:

  • geração de NSR's;
  • geração de comprovantes;
  • envio de comprovantes;
  • detecção de fraude.

Como era Antes?

Neste momento, essa mudança no processamento de marcações foi realizada através de uma mudança de arquitetura de como as

...

  • Integração das marcações do dispositivo com o Clockin
  • Geração de NSR's 
  • Geração de comprovantes (Processo novo criado)
  • Envio de comprovantes;
  • Detecção de fraude.

Como era Antes?

No modelo atual todo o processamento segue os seguintes passos:

  • Passo1:    o app mobile envia um marcação para a Carol
  • Passo2:    dado chega na Staging Table, dado bruto sem tratamento algum.
  • Passo3:    por meio de regras de mapeamento esse dado é tratado e transformado em uma informação pronta a ser consumida através de consultas nos Data Models.

Exemplo:

Ao processar um registro, o dado volta para a Staging Table, passando novamente por um regra de tratamento alterada e chegando ao Data Model novamente.

...

em vez de regras de mapeamentos e o processamento não será mais realizado na tenant (ambiente) do cliente, e sim em umambiente externo na Plataforma Carol.


Apenas 3 Data Models apresentam o novo processamento: Clock In Records, Fraud Analysis e Clock In Event Type.

...

Para maiores detalhes sobre o novo processamento, consulte o link.

Como realizar a atualização desse novo modelo?

Para que as novas configurações de processamento será atualizada no ambiente faz-se necessário a realização de

uma atualização da versão do Backoffice para a  12.1.22080007 através do  processo de atualização de versão do Backoffice

Novo processo de geração de Comprovante

As tasks que sofreram alteração foram:

...

Apenas a geração de comprovantes foi separada da geração de NSR's. 

A geração de comprovante por se tratar de uma nova Task, ela precisará ser agendada.

Como fazer o agendamento?

Clica-se em Carol Apps

Image Added

Depois em 'TOTVS RH Clock In Backoffice'

Image Added

Na Aba 'Process', localize o processo 'generate_receipts'.

Na coluna 'Last Run', clique em 'Edit'

Image Added

É possível agendar para uma execução Mensal / Semanal/ Diária e de Hora em Hora

Image Added


Nessa caso agendamos para executar a cada 20 minutos.

Depois da configuração é necessário clicar em Save, para guardar os ajustes feitos.

Image Added

Quais as principais vantagens?

Segue algumas vantagens na utilização desse novo processos:

  •  correção de falhas no processo de geração dos NSR's como falha no sequenciamento e duplicação de NSR e travamento da execução;
  • redução de tempo de execução geração dos NSR's;
  • divisão dos processos para facilitando o entendimento de erros de execução;
  • falhas de travamento no envio de SMS's/E-mails e reenvio do mesmo comprovante.

Problemas e Soluções

...


Pontos a serem checados para confirmar se o ambiente está realmente apto para o novo formato:


Problema 1: há mapeamento vinculados aos Data Models Clock IN Records, Clock In Event Type e Fraud Analysis ? 

...

Obs.: Caso ainda existam mapeamento vinculados aos mesmos, faz-se necessário abertura de ticket.

Image Removed

    Image Removed

Image Removed


Problema 2: Os registros dos Data Models citados acima devem ser oriundos do novo formato, para verificar, basta visualizar a coluna “Conector”.

A mesma deverá constar o conteúdo “Carol Explore” ou o conteúdo vir em branco. Caso não ocorra, como proceder?


No exemplo abaixo trazemos o Data Model "Fraud Analisys" (para os outros 2, o passo a passo é o mesmo).

    • Acessar o Data Model
    • clicar em "Colunms and Views Options"

Image Removed

    • Entrar com a informação de ''Connector'' e a coluna será visualizada no data Model

Image Removed



Obs.: Caso a coluna citada possua um outro conteúdo, faz-se necessário a abertura de ticket.


Problema 3: Como acessar os registros dos data Models ?

Por enquanto não é possível visualizar os registros na camada RT, isso será liberado em breve e isso não traz impacto algum aos clientes.

O correto, a visualização se fará pelo BQ.

Atenção é necessário consolidar os dados antes de visualizá-los

...

Image Removed

Image Removed

...

.


Problema 4: Com relação a esses processos citados, caso apareça algum erro, sugere-se a verificação dos logs criados das tasks, havendo necessidade é sugerido a criação de um ticket.

Para acessar os logs das tarefas na Plataforma Carol, é necessário acessar a Activity Management.

Clica-se no Sino e depois em View All.


No exemplo que trazemos, a task é a de Geração de NSR's.

Visualizamos que a mesma possui Status ''Failed'', ao clicamos na mesma um menu lateral direito será aberto.

Ao descermos pelo mesmo, é possível visualizar a mensagem de erro.

Nesse caso, faz-se necessário a abertura de ticket.


Temos ainda as task's de : AI Process: generate_receipts, e AI Process: fraud_detection.


Problema 5:. A partir de agora não é indicado realizar a alteração de registros diretamente pela Plataforma Carol, isso deve-se pois ao novo processamento não abrange os dados alterados nessa forma.

Logo o que for alterado na plataforma não será considerado.



Aviso

Não recomendamos a alteração da informação pela opção do "New Record" ou  "Edit" no Explore dos "Data Model" referente ao Cockin na Plataforma Carol, exceto o "Data Model" "User". Caso seja feita a alteração a informação não será replicada dentro das camadas da Plataforma Carol e desta forma não será possível visualizar a informação no Backoffice e também os processos que precisam da informação não terão ela atualizada nas camadas