Configurar inicial da regra - Gestão do Ponto X

Após habilitar o ponto de regra no ambiente de customização, é preciso configurar a função Lambda que irá executar a regra. Essa configuração é feita no AWS Cloud9, por meio da edição de arquivos JavaScript presentes na estrutura da Lambda gerada.

Adicionar a dependência da biblioteca

Para utilizar a biblioteca responsável por interpretar o contexto da apuração, é necessário adicioná-la como dependência no projeto da Lambda.

1. Abra o arquivo package.json da função Lambda.
2. No bloco "dependencies", inclua a biblioteca hcm-clocking-event-rule-nodejs. Veja abaixo um exemplo de estrutura completa do arquivo com a dependência adicionada:

{   
  "name": "SeuNomeDeRegra",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": ""
  },
  // [!code highlight]
  "dependencies": {     
    "hcm-clocking-event-rule-nodejs": "1.0.0"
  },
  "author": "",
  "license": ""
}

1. Utilize sempre a última versão disponível, que pode ser consultada no npm.

1. Após atualizar a versão no arquivo package.json, acesse o terminal do AWS Cloud9 e realize a instalação do pacote. O comando pode ser consultado no tópico de instalação da página do npm.
2. Após a instalação, o pacote hcm-clocking-event-rule-nodejs será incluído automaticamente na pasta node_modules.

Consultar a documentação da biblioteca

Com o pacote instalado, é possível acessar a documentação técnica da biblioteca diretamente no ambiente. Isso permite entender como a estrutura da regra funciona e quais dados estão disponíveis para customização.

1. Dentro da pasta hcm-clocking-event-rule-nodejs, localize o arquivo docs.zip, que pode ser baixado e descompactado.
2. Abra o conteúdo descompactado e acesse a página inicial da documentação.
3. Consulte a documentação para entender:
   • Como acessar os dados do contexto.
   • As possibilidades de modificação de apuração.
   • As saídas da regra: invalidação, customização, log etc.

Configurar a regra da lambda

Após adicionar a dependência no package.json e concluir a instalação do pacote, o próximo passo é configurar a função Lambda para que ela execute corretamente a lógica da regra de apuração.

1. Localize o arquivo index.js na raiz da Lambda.
2. Substitua o conteúdo do index.js utilizando o exemplo disponível na documentação técnica da biblioteca, localizada no arquivo docs.zip.
3. Implemente a chamada do contexto e a execução da classe de regra.
4. Crie uma nova pasta chamada rule.
5. Dentro da pasta rule, crie o arquivo timeEvaluationRule.js.
6. No novo arquivo, crie a estrutura da classe TimeEvaluationRule com o método execute. É dentro desse método que a lógica da regra de apuração deve ser implementada. Utilize como base o template de exemplo disponível na documentação técnica da biblioteca, localizada no arquivo docs.zip.
7. Adicione a lógica da regra de customização dentro do método execute.
8. Adicione tratamentos de erro, logs e comandos conforme a necessidade da sua regra.
9. Mesmo que a regra ainda não execute nenhuma alteração, essa estrutura básica já estará funcional e pronta para ser publicada.

Publicar e habilitar a lambda

1. No AWS Cloud9, clique com o botão direito sobre a pasta da função Lambda.
2. Selecione a opção Upload Lambda.
3. Confirme o envio para a região apropriada (ex: us-east-1 / Virgínia).
4. Ao finalizar, o sistema exibirá a mensagem de que a lambda foi atualizada com sucesso.
5. Com a lambda publicada e habilitada, acesse HCM > Gestão do Ponto X > Ponto da minha equipe > Acertos do colaborador.
6. No botão Ações, selecione a opção Reapurar para realizar uma nova apuração e validar a execução da regra.

Após esses passos, a estrutura da sua regra de customização estará ativa e pronta para modificações conforme a necessidade do cliente.