Histórico da Página
| Í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.
Neste momento, essa mudança no processamento de marcações foi realizada através de uma mudança de arquitetura de como as
marcações são lidas e gravadas no Clockin tendo como vantagem a melhoria de performance e resiliência dos processos de geração a seguir:
- 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
- geração de NSR's;
- geração de comprovantes;
- 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.
Como será daqui para frente?
Dentro de alguns dias, o O novo formato não utilizará mais regras de mapeamentos (como vimos atualmente),
e o processamento não será mais realizado na tenant (ambiente) do cliente, e sim em um ambiente externo.
Com esse novo modelo, não será mais possível customizar regras de processamento dos clientes.
utiliza conversão de de dados entre as camadas dos dados da Plataforma usando códigos SQL
em vez de regras de mapeamentosEssas mudanças são propositais visando uma maior escalabilidade e a diminuição de tempo de suporte/atendimento para atuação juntos a issues.
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 funcione será atualizada no ambiente faz-se necessário a realização de uma migração.
A migração será feita a partir do Update por parte dos próprios clientes, a mesma será finalizada com a execução de um script que irá alterar o processamento de informações dentro da Plataforma Carol.
- Caso apareça chamados de ambientes atualizados e que constem com mapeamentos (como temos hoje),
pode-se entender que houve problemas na atualização do ambiente.
- Caso ocorra uma falha na task, sugere-se a verificação nas logs das mesmas, e com essas informações poderemos detalhar melhor os tickets internos.
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.
Quais as principais vantagens?
Já existem 2 clientes que já usam o novo formato há 10 dias, sem qualquer tipo de retorno sobre problemas sobre o novo formato.
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
Depois em 'TOTVS RH Clock In Backoffice'
Na Aba 'Process', localize o processo 'generate_receipts'.
Na coluna 'Last Run', clique em 'Edit'
É possível agendar para uma execução Mensal / Semanal/ Diária e de Hora em Hora
Nessa caso agendamos para executar a cada 20 minutos.
Depois da configuração é necessário clicar em Save, para guardar os ajustes feitos.
Quais as principais vantagens?
Segue algumas vantagens na utilização desse novo processosUtilizando eles como base, entendemos que as vantagens foram as seguintes:
- 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 horas para 10 minutos na tempo de execução geração dos NSR's;
- segregação melhor divisão dos processos , para facilitando o entendimento maior de erros de execução;
- correção falhas de falhas travamento no envio de SMS's/E-mails :
...
- e
...
- reenvio do mesmo comprovante
...
Tópicos relevantes
...
- .
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 ?
Para acessar os Data Models, clicar no item no Menu lateral esquerdo.
Para avaliar é necessário visualizar a estrutura dos Data Models criados, e avaliar se há conteúdo na seção "Mapped Connectors".
Vide exemplos abaixo.
Obs.: Caso ainda existam mapeamento vinculados aos mesmos, faz-se necessário abertura de ticket.
...
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"
- Entrar com a informação de ''Connector'' e a coluna será visualizada no data Model
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
...
...
.
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 |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas