HCM
CONTROLE DE FREQUÊNCIA
JUL 2025 HCMCONTFQ01V2
Conteúdo
1 Introdução…………………………….4
2 Símbolos e Convenções……………………….5
2.1 Acesso ao Sistema………………………..5
2.1.1 Tela de Login…………………………5
2.1.2 Tela Inicial – Painel de Controle…………………..5
2.1.3 Acesso às Telas………………………..6
2.1.4 Informações do Usuário……………………..7
2.1.5 Barra de Pesquisa……………………….7
2.1.6 Aplicação – Grupos de Funcionalidades……………….8
2.1.7 Ferramenta de Favoritos…………………….9
2.2 Configurações Básicas………………………. 11
2.2.1 Cadastros…………………………. 11
2.2.2 Edição………………………….. 13
2.2.3 Parâmetros………………………… 15
3 Parametrizações Iniciais………………………. 16
3.1 Cadastro de Tipo de Apuração por Frequência………………. 16
3.2 Cadastro do Período de Apuração………………….. 18
3.3 Detalhamento de Períodos…………………….. 22
4 Cadastro de Informações de Horário………………….. 24
4.1 Cadastro de Horários………………………. 24
4.2 Cadastro de Intervalos de Horário………………….. 26
4.3 Cadastro de Saídas……………………….. 29
4.4 Cadastro de Horário de Folga……………………. 31
5 Cadastro de Informações de Escala de Trabalho………………. 33
5.1 Parametrização………………………… 34
5.2 Associação de Turno/Horário……………………. 35
5.2.1 Manipulação de Horários Associados ao Turno:…………….. 37
6 Parametrização de Frequência…………………….. 40
6.1 Etapa 1: Tela de Apresentação……………………. 41
6.2 Etapa 2: Escopo de Vínculos……………………. 42
6.3 Etapa 3: Dados Iniciais………………………. 43
6.4 Etapa 4: Banco de Horas……………………… 44
6.5 Etapa 5: Detalhamento da Apuração…………………. 46
6.6 Etapa 6: Jornada de Trabalho……………………. 48
6.7 Etapa 7: Horas Extras………………………. 49
6.8 Etapa 8: Adicional Noturno…………………….. 50
7 Ciclo Mensal…………………………… 53
7.1 Passo 1: Importação de Marcações………………….. 55
7.1.1 Procedimento:……………………….. 56
2
7.2 Passos 2 a 7: Validações Prévias à Apuração . . . . . . . . . . . . . . . . . . . 58
7.2.1 Passo 2: Validação de Ocorrências de Abono . . . . . . . . . . . . . . . . . 58
7.2.2 Passo 3: Validação de Faltas e Atrasos . . . . . . . . . . . . . . . . . . . . 59
7.3 Passo 4: Validação de Batidas Ímpares . . . . . . . . . . . . . . . . . . . . . 60
7.4 Passos 5 e 6: Validação de Ausências . . . . . . . . . . . . . . . . . . . . . . 61
7.5 Passo 7: Validação de Tempos Extras Realizados . . . . . . . . . . . . . . . . . 64
7.6 Passo 8: Cálculo do Tempo Trabalhado . . . . . . . . . . . . . . . . . . . . . 64
7.7 Passo 9: Visualização dos Resultados . . . . . . . . . . . . . . . . . . . . . . 67
7.8 Passos 10 e 11: Geração e Validação do Lote para Folha de Pagamento . . . . . . . . . 70
7.8.1 Passo 10: Geração do Lote de Eventos . . . . . . . . . . . . . . . . . . . . 70
7.8.2 Passo 11: Validação e Importação do Lote . . . . . . . . . . . . . . . . . . 72
8 Integração Control iD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
8.1 Dependências . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
8.1.1 XAMPP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
8.1.2 Jenkins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
8.2 Instalação e Configuração das Dependências . . . . . . . . . . . . . . . . . . . 75
8.2.1 Instalação do XAMPP . . . . . . . . . . . . . . . . . . . . . . . . . . 75
8.2.2 Configurando o HCMCli . . . . . . . . . . . . . . . . . . . . . . . . . . 83
8.3 Instalação do Jenkins . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
8.3.1 Configuração interna do Jenkins . . . . . . . . . . . . . . . . . . . . . . 93
8.4 Novo Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
3
Introdução
O sistema HCM representa um conjunto completo de soluções voltadas para a gestão de RH e Departamento
Pessoal, com o objetivo de facilitar e otimizar processos, melhorando a experiência dos funcionários e
aumentando a eficiência organizacional.Através da solução, é possibilitada a gestão integrada de contratação, remuneração, conformidade com
regulamentações, políticas internas, desenvolvimento dos colaboradores e diversos outros aspectos
críticos, tornando a gestão de pessoas mais eficiente e alinhada aos objetivos estratégicos da organização.Este manual tem como objetivo apresentar o módulo de Controle de Frequência do sistema HCM. O
conteúdo descrito no presente documento abrange desde os cadastros iniciais, que são essenciais para o
funcionamento básico do sistema, até as rotinas periódicas:

• Parametrizações Iniciais;
• Cadastro de Informações de Horário;
• Cadastro de Informações de Escala de Trabalho;
• Parametrização de Frequência;
• Ciclo Mensal;
• Integração Control iD.Todas as telas e funcionalidades descritas nas rotinas estão localizadas no menu geral do sistema, dentro
  da aplicação Controle de Frequência.Cada seção contém descrições técnicas e orientações específicas para a execução das principais rotinas
  no sistema, garantindo precisão na configuração e utilização do módulo.Atenção: Este documento é um manual unificado que aborda as principais rotinas realizadas no
  Portal do Gestor, oferecendo uma visão geral sobre as funcionalidades essenciais do sistema. Para
  instruções detalhadas e específicas sobre as rotinas operacionais, é recomendada a procura de um
  consultor Teknisa.4
  Símbolos e Convenções
  Neste capítulo, serão apresentados os principais símbolos e convenções utilizados ao longo deste manual,
  necessários para o acesso às telas, realização de cadastros e execução de operações no sistema.O objetivo dessa introdução é simplificar a navegação e o entendimento das funcionalidades, permitindo
  que o usuário se familiarize com os elementos-chave. Com isso, o uso do sistema se tornará mais intuitivo,
  garantindo uma experiência mais eficiente e produtiva.2.1 ACESSO AO SISTEMA
  2.1.1 Tela de Login
  Ao acessar o sistema, você será direcionado à tela de login (Figura 1) do sistema HCM Teknisa.Figura 1: Login
• Informe os Dados de Acesso:
  – Usuário: Informe seu e-mail;
  – Senha: Utilize a senha criada durante o processo de cadastro no sistema Teknisa.• Autenticação: Após inserir corretamente o usuário e a senha, clique no botão Enviar para acessar
  o sistema.2.1.2 Tela Inicial – Painel de Controle
  Ao realizar o login com sucesso, você será redirecionado ao Painel de Controle (Figura 2), a tela inicial do
  sistema. Nessa tela, você pode visualizar informações gerais, como métricas de desempenho e dados
  cadastrados no sistema.5
  Figura 2: Painel de Controle
  2.1.3 Acesso às Telas
  Para acessar as funcionalidades do sistema, clique no ícone de menu (Figura 3) localizado no canto
  superior esquerdo da tela.Figura 3: Menu
  6
  2.1.4 Informações do Usuário
  No menu de navegação, você encontrará informações básicas (Figura 4), como seu nome e a unidade de
  trabalho. Se precisar alterar a unidade de acesso, selecione a opção Alterar Parâmetros, localizada logo
  abaixo das informações do usuário.Figura 4: Informações
  2.1.5 Barra de Pesquisa
  Abaixo das informações do usuário, você encontrará a barra de pesquisa (Figura 5). Para localizar uma
  tela específica, basta digitar o nome da funcionalidade desejada. Por exemplo, para cadastrar um novo
  produto, digite “Produto”e selecione o resultado correspondente.7
  Figura 5: Barra de Pesquisa
  2.1.6 Aplicação – Grupos de Funcionalidades
  Na categoria Aplicação (Figura 6), são exibidos grupos de atalhos para diferentes telas do sistema. Clique
  nas setas ao lado das categorias para expandir as opções disponíveis.Figura 6: Aplicação
  Exemplo (Figura 7): Para acessar a tela de Banco de Horas, expanda a categoria Controle de Frequência,
  8
  depois clique em Banco de Horas e, em seguida, selecione novamente Banco de Horas na lista de
  opções.Figura 7: Exemplo
  Identificação Visual
  No menu, os grupos de funcionalidades são identificados por letras brancas. A funcionalidade
  selecionada, que leva à tela de acesso, é destacada na cor cinza.2.1.7 Ferramenta de Favoritos
  A ferramenta de Favoritos (Figura 8) no
  sistema Retail permite que você adicione telas
  e funcionalidades de uso frequente a um grupo de
  atalhos personalizados, facilitando o acesso rápido
  às operações do seu dia a dia.Figura 8: Favoritos
  Como Adicionar uma Tela aos Favoritos
• Acessar a Tela: Navegue até a tela que deseja adicionar aos favoritos.Figura 9: Acesso a Tela
• Adicionar aos Favoritos: No canto superior esquerdo da tela, você verá o ícone de uma estrela,
  que representa a opção de favoritos.9
  Figura 10: ícone Favoritos
• Clique no Ícone: Selecione a estrela e, em seguida, clique na opção Adicionar aos favoritos. Isso
  salvará a tela na sua lista personalizada.Figura 11: Adicionar aos Favoritos
  Como Acessar uma Tela Favoritada
• Menu de Favoritos: Para acessar as telas que foram adicionadas aos favoritos, clique na opção
  Favoritos no cabeçalho da página ou no menu de navegação lateral.Figura 12: Menu de Favoritos
• Selecionar a Tela: Uma lista com todas as telas favoritadas será exibida. Selecione o nome da tela
  que deseja acessar, e o sistema o redirecionará diretamente para a funcionalidade.Figura 13: Favoritos
  Gerenciamento de Favoritos
• Várias Telas: Você pode favoritar quantas telas forem necessárias. Todas as telas adicionadas
  aparecem organizadas em uma lista quando você clicar em Favoritos.• Personalização: Utilize essa ferramenta para manter as telas mais importantes sempre à mão,
  agilizando a execução de suas atividades diárias no sistema.Manter suas telas de uso frequente nos favoritos permite que você navegue pelo sistema de forma mais
  eficiente, economizando tempo ao evitar a busca manual ou navegação através de menus extensos.10
  2.2 CONFIGURAÇÕES BÁSICAS
  2.2.1 Cadastros
  O cadastro é um recurso importante para registrar informações essenciais e personalizar o uso do sistema
  conforme as necessidades operacionais da sua empresa.O sistema permite cadastrar diversos dados operacionais essenciais, e é crucial que cada registro seja
  feito com atenção, uma vez que essas informações serão utilizadas em processos subsequentes dentro do
  sistema.Passo a Passo para Realizar um Cadastro
• Adicionar Novo Registro: Para inserir um novo registro, clique no botão Adicionar (Figura 14). Isso
  abrirá um formulário onde você deverá preencher os dados necessários.Figura 14: Adicionar
• Preenchimento dos Campos (Figura 15): Complete todos os campos com as informações corretas
  para o cadastro que está sendo realizado. Informações obrigatórias serão indicadas com uma
  marcação azul ao lado do nome do campo.11
  Figura 15: Campos
  Observação: os campos de informações apresentarão variações de acordo com o cadastro que
  está sendo registrado.• Salvar o Cadastro: Após preencher os dados, revise as informações e clique em Salvar (Figura 16)
  para concluir o cadastro.12
  Figura 16: Salvar
• Verificação do Cadastro: Para confirmar que o cadastro foi realizado com sucesso, você pode
  acessar a tela correspondente ao registro e verificar os dados inseridos.2.2.2 Edição
  A função de edição permite que você atualize ou corrija informações previamente cadastradas no sistema.• Localizar o Cadastro: Primeiramente, acesse a tela referente ao tipo de cadastro que deseja editar.Utilize a barra de pesquisa, se necessário, para localizar o cadastro rapidamente. Selecione o item
  correspondente ao que deseja modificar na lista.• Após encontrar o cadastro, clique sobre ele para abrir as informações referentes ao cadastro.• Na janela de detalhes, clique no botão Editar (Figura 17). Isso permitirá que você modifique os
  campos disponíveis.13
  Figura 17: Editar
• Altere os campos necessários com as novas informações. Lembre-se de verificar os campos
  obrigatórios, que estarão marcados em azul ao lado do nome. Faça as atualizações com atenção
  para garantir que os dados estejam corretos.• Após realizar todas as modificações, clique em Salvar (Figura 18) para confirmar as alterações. O
  sistema atualizará o registro com as novas informações inseridas.Figura 18: Salvar
  14
• Para garantir que as alterações foram salvas corretamente, volte à tela do cadastro e verifique se os
  dados foram atualizados conforme esperado.2.2.3 Parâmetros
  A parametrização é uma funcionalidade que permite configurar o sistema conforme as necessidades e
  regras específicas da sua empresa. Ao ajustar esses parâmetros, você personaliza o comportamento do
  sistema para otimizar as operações e garantir que ele atenda às diretrizes operacionais e estratégicas.Passo a Passo para Realizar Parametrizações
• Acesse a tela correspondente às parametrizações que serão realizadas;
• Assim como nos cadastros, é necessário ativar as alterações através dos botões Editar (Figura 19)
  ou Adicionar (Figura 20) para realizar as modificações;
  Figura 19: Produto Figura 20: Produto
• Certifique-se de preencher os campos de informações para garantir o funcionamento do sistema
  conforme as especificações da empresa;
• Após definir os parâmetros desejados, clique em Salvar (Figura 21) para aplicar as alterações.Figura 21: Salvar
  Considerações Importantes
• Consistência: As parametrizações afetam diretamente o funcionamento do sistema, por isso, é
  crucial garantir que os ajustes estejam alinhados com os objetivos operacionais;
• Alterações Cautelosas: Modifique os parâmetros com cautela, especialmente aqueles que
  impactam processos críticos;
• Revisão Periódica: Recomenda-se revisar as parametrizações regularmente para garantir que
  elas continuam adequadas ao contexto da empresa.15
  Parametrizações Iniciais
  Neste módulo, serão abordadas as parametrizações iniciais necessárias para o controle de frequência. As
  configurações descritas a seguir são primárias e devem ser realizadas antes da utilização das rotinas do
  módulo.A maioria dos cadastros executados nesta etapa é feita apenas no início do processo, porém, podem ser
  alteradas posteriormente conforme a necessidade do usuário.3.1 CADASTRO DE TIPO DE APURAÇÃO POR FREQUÊNCIA
  O cadastro do tipo de apuração de frequência tem como objetivo estabelecer diferentes critérios de
  apuração que deverão ser tratados de forma independente.Na maioria dos casos, será necessário apenas um tipo de apuração por frequência.Procedimento para cadastro:

1. Acesse a tela Tipo de Apuração de Frequência (Figura 22).Para verificar o processo de acesso às telas no sistema, consulte o item 2.1.3 às Telas no
   capítulo Símbolos e Convenções.Figura 22: Tipo de Apuração de Frequência
2. Clique em Adicionar (Figura 23).16
   Figura 23: Adicionar
3. Preencha o campo Descrição (Figura 24) com uma identificação para o tipo de apuração.Figura 24: Descrição
   17
4. Clique em Salvar (Figura 25) para finalizar o cadastro.Figura 25: Salvar
   3.2 CADASTRO DO PERÍODO DE APURAÇÃO
   A próxima etapa consiste no cadastro do período de apuração, que define os dias contemplados em cada
   ciclo de tempo.Esse cadastro é utilizado para distinguir possíveis diferenças entre períodos de apuração.Exemplos comuns de períodos:

• De 21 a 20 do mês;
• De 16 a 15 do mês.Os períodos podem variar conforme as diretrizes da organização.Procedimento para cadastro:

1. Acesse a tela Período de Apuração (Figura 26).Para verificar o processo de acesso às telas no sistema, consulte o item 2.1.3 às Telas no
   capítulo Símbolos e Convenções.18
   Figura 26: Período de Apuração
2. Os cadastros são organizados por tipo de vínculo e tipo de período.3. Selecione um tipo de vínculo (Figura 27).Figura 27: tipo de vínculo
   19
3. Acesse a aba Período de Apuração (Figura 28) para identificar o tipo de período relacionado ao
   vínculo selecionado.Figura 28: Período de Apuração
4. Clique em Adicionar (Figura 29) para realizar o cadastro manual do período.Figura 29: Adicionar
   20
   Atenção com os Campos (Figura 30) a serem preenchidos:

• Tipo de Apuração;
• Descrição.Figura 30: Campos
  Ao selecionar o período de apuração cadastrado, será exibida uma janela com informações detalhadas
  sobre o registro selecionado.7. Clique em Salvar (Figura 31) para finalizar o cadastro.Figura 31: Salvar
  21
  3.3 DETALHAMENTO DE PERÍODOS
  Na aba Período (Figura 32), serão registrados todos os períodos vinculados ao tipo de vínculo e tipo de
  período cadastrados. O cadastro deve ser feito manualmente para cada período.Figura 32: Período

1. Clique em Adicionar (Figura 33) para realizar o cadastro manual do período.Figura 33: Adicionar
   22
   Atenção com os Campos (Figura 34) a serem preenchidos:

• Início da Apuração:
• Fim da Apuração:
• Situação: Aberto ou Fechado. Os períodos devem ser inicialmente cadastrados como “Abertos”e,
  posteriormente, fechados conforme a necessidade.Figura 34: Campos
  Clique em Salvar (Figura 35) para finalizar o cadastro.Figura 35: Salvar
  Observação:
  É recomendada a criação anual de todos os períodos de apuração previstos para o ano vigente.23
  Cadastro de Informações de Horário
  Neste módulo, serão realizadas as configurações de horários, que posteriormente serão associadas às
  escalas de trabalho.A seguir, são descritos os passos para cadastrar horários de folga e demais horários, assim como os
  intervalos previstos.4.1 CADASTRO DE HORÁRIOS
  Para horários que envolvem batidas de ponto, deve-se cadastrar os intervalos de horário. A seguir, será
  demonstrado o procedimento para o cadastro de um horário convencional, como por exemplo, das 9h às
  18h.Procedimento para cadastro:

1. Acesse a tela Horário (Figura 36).Para verificar o processo de acesso às telas no sistema, consulte o item 2.1.3 às Telas no
   capítulo Símbolos e Convenções.Figura 36: Horário
   24
2. Clique em Adicionar (Figura 37).Figura 37: Adicionar
3. Realize o processo de cadastro manual preenchendo os campos (Figura 38):

• Início de Vigência.• Fim de Vigência.• Tipo de Horário.• Início de Coleta de Marcação: Indique o horário a partir do qual as marcações de ponto serão
  consideradas.• Descrição: Insira a identificação do horário.Figura 38: Campos
  25

1. Clique em Salvar (Figura 39).Figura 39: Salvar
   4.2 CADASTRO DE INTERVALOS DE HORÁRIO
   Após o cadastro do horário, acesse a aba Intervalo de Horário. Nesta aba, serão definidas as batidas de
   ponto previstas para o dia. O cadastro dos intervalos deve ser feito manualmente.Procedimento para cadastro de intervalos:
2. Acesse a tela Intervalo de Horário (Figura 40).Figura 40: Intervalo de Horário
   26
3. Clique em Adicionar (Figura 41).Figura 41: Adicionar
4. Defina as informações nos seguintes campos (Figura 42):

• Entrada:
  – Entrada.– Tolerância Anterior.– Tolerância Posterior.– Dia de Ocorrência.– Controle de Marcação.– Ajuste de Marcação.• Saída:
  – Saída.– Tolerância Anterior.– Tolerância Posterior.– Dia de Ocorrência.– Controle de Marcação.– Ajuste de Marcação.• Intervalo Núcleo:
  – Início Núcleo: Batida inicial do intervalo.27
  – Fim Núcleo: Batida final do intervalo.Figura 42: campos

1. Após preencher todas as informações, clique em Salvar (Figura 43).Figura 43: Salvar
   Realize o procedimento para todos os intervalos de horário necessários.28
   4.3 CADASTRO DE SAÍDAS
   Em seguida, acesse a aba Saídas para informar as horas de descanso previstas e horas projetadas.Procedimento para cadastro:
2. Acesse a tela Saídas (Figura 44).Figura 44: Saídas
3. Clique na saída cadastrada com base nos intervalos informados anteriormente.3. Clique em Editar (Figura 45).Figura 45: Editar
   29
4. Preencha os seguintes campos (Figura 46):

• Horas a Projetar.• Descrição: Descrição do intervalo de saída.• Tipo de Intervalo: Selecione o tipo de intervalo para o descanso.Figura 46: campos

1. Após preencher todas as informações, clique em Salvar (Figura 47).Figura 47: Salvar
   30
   4.4 CADASTRO DE HORÁRIO DE FOLGA
   Para cadastrar um horário de folga, siga as instruções abaixo:
   Procedimento para cadastro:
2. Acesse a tela Horário (Figura 48).Para verificar o processo de acesso às telas no sistema, consulte o item 2.1.3
   Acesso às Telas no capítulo Símbolos e Convenções.Figura 48: Horário
3. Clique em Adicionar (Figura 49).Figura 49: Adicionar
4. Preencha os seguintes campos (Figura 50):

• Início de Vigência.• Fim de Vigência.• Tipo de Horário: Selecione a opção Folga.• Início de Coleta de Marcação: Defina como 00:00.• Descrição: Insira uma descrição para identificação do horário.31
  Figura 50: campos

1. Após preencher as informações, clique em Salvar (Figura 51).Figura 51: Salvar
   32
   Cadastro de Informações de Escala de
   Trabalho
   Neste módulo, serão abordadas as etapas para o cadastro das informações de escala de trabalho. A seguir,
   será detalhado o procedimento de parametrização e associação de turnos, que impacta diretamente o
   módulo de controle de frequência.Para configurar as escalas e turnos, acesse a tela Escala de Trabalho (Figura 52).Para verificar o processo de acesso às telas no sistema, consulte o item 2.1.3 às Telas no capítulo
   Símbolos e Convenções.Figura 52: Escala de Trabalho
   Nas abas de Parametrizações e Associação (Figura 53), serão realizados os cadastros e ajustes
   necessários para garantir a correta configuração das escalas.Figura 53: Abas
   33
   Para acessar as abas, clique na Escala de Trabalho cadastrada na tela de listagem. As abas estarão
   dispostas na janela de informações para o cadastro.Figura 54: Escala de Trabalho Cadastrada
   5.1 PARAMETRIZAÇÃO
   Na aba Parametrizações (Figura 55), é possível alterar as configurações conforme as regras específicas
   de cada organização. Os campos mais comuns que podem ser ajustados incluem:

• Compensa Atraso: Deve ser configurado como “Sim”caso a compensação de atrasos seja feita
  através do Banco de Horas.• Exige Autorização para Hora Extra: Define se será necessária a aprovação para a realização de
  horas extras.• Quantidade de Horas para Separação de Hora Extra: Informa a partir de quanto tempo de trabalho
  deverão ser geradas horas extras. Caso todas as horas trabalhadas sejam consideradas para esse
  cálculo, o campo deve ser preenchido com “0”. Se for utilizado o Banco de Horas, o valor máximo
  permitido será 23:59.• Início e Fim do Período Noturno: Determina o intervalo de tempo no qual serão calculadas as
  horas noturnas e, por consequência, o adicional noturno.• Valor Acréscimo Adicional Noturno: Valor que será multiplicado pelo tempo trabalhado no período
  noturno para o cálculo do adicional. Se o campo estiver vazio, o cálculo seguirá as regras da CLT,
  que estabelece que uma hora no período noturno equivale a 52 minutos e 30 segundos.• Projeto Intervalo: Define se o intervalo realizado pelo colaborador será considerado integralmente,
  de acordo com o tempo efetivamente trabalhado.34
  Figura 55: Parametrizações
  Para realizar ajustes, realize a edição de cadastros conforme indicado no capítulo Símbolos e Convenções
  (conferir item).Após a validação e ajuste das parametrizações, prossiga para a aba de Associação de Turno/Horário.5.2 ASSOCIAÇÃO DE TURNO/HORÁRIO
  Na aba Associação de Turno/Horário (Figura 56), serão listados todos os turnos relacionados à escala
  selecionada. Um turno é composto por um conjunto de horários que determina o período de trabalho para
  cada dia da semana.Figura 56: Associação de Turno/Horário
  35
  Procedimento para criação de um novo turno:

1. Clique em Adicionar (Figura 57).Figura 57: Adicionar
2. Preencha o campo Descrição (Figura 58) com a identificação do turno
   Figura 58: Descrição
   36
3. Clique em Salvar (Figura 59).Figura 59: Salvar
   5.2.1 Manipulação de Horários Associados ao Turno:
4. Acesse a aba Horário (Figura 60).Figura 60: Horário
   37
5. Serão exibidas as associações de horários para cada dia da semana.3. Para cada dia, os horários devem ser relacionados aos turnos. Isso pode ser feito manualmente
   através do botão Adicionar (Figura 61), mas a maneira mais simples é através da Ação de Cadastro
   Automático (Figura 62), que associa o mesmo horário a todos os dias da semana.Figura 61: Adicionar
   Figura 62: Ação de Cadastro Automático
   Cadastro automático
   Para acessar a opção de cadastro automático, selecione o ícone Ações (Figura 63) na aba Horário para
   acessar as opções (Figura 64) de Cadastro Automático e Cadastro Automático por Ciclo.38
   Figura 63: Ações
   Figura 64: Opções
   Ciclos de Turnos
   Os turnos devem ser cadastrados em ciclos de 7 dias, que vão de sábado a sexta-feira. É possível
   configurar mais de um ciclo de 7 dias por turno, o que permite a criação de escalas mais complexas,
   como turnos 12×36, por exemplo.Exemplo de Ciclos:

• Se houver um turno com apenas um tipo de horário para toda a semana, será necessário apenas
  um ciclo.• Para escalas complexas como 12×36, será necessário cadastrar dois ciclos de 7 dias para
  contemplar todas as variações de dias e horários.39
  Parametrização de Frequência
  Neste módulo será descrito o processo de parametrização de frequência no sistema HCM.O objetivo é orientar os operadores sobre a criação dos cadastros iniciais e a configuração das regras
  de apuração que impactam diretamente nos cálculos de frequência.Para iniciar o processo, acesse a tela Roteiro de Parametrização de Frequência (Figura 65).Figura 65: Roteiro de Parametrização de Frequência
  A rotina é dividida em etapas sequenciais, através de cada etapa serão criadas regras de apuração que
  impactarão diretamente os cálculos de frequência.Para navegar entre as etapas de parametrização, clique nos ícones de navegação (Figura 66) no canto
  inferior direito da tela.Figura 66: ícones de navegação
  Para cancelar o roteiro em qualquer etapa, utilize o ícone Cancelar (Figura 67) no canto inferior esquerdo
  da tela.40
  Figura 67: Cancelar
  Ao final do roteiro, será criado um banco de horas que, no sistema, representa um agrupamento de
  vínculos associados a regras específicas, baseadas nas informações preenchidas.6.1 ETAPA 1: TELA DE APRESENTAÇÃO
  A tela de apresentação (Figura 68) é a etapa inicial do processo de parametrização no módulo Controle
  de Frequência.Figura 68: Tela de Apresentação
  Nesta tela, são fornecidas informações introdutórias sobre o objetivo do roteiro, bem como instruções
  gerais para o uso da funcionalidade.Selecione o ícone de navegação (Figura 69) para prosseguir com o roteiro.Figura 69: Ícone de Navegação
  41
  6.2 ETAPA 2: ESCOPO DE VÍNCULOS
  A etapa seguinte é denominada Escopo de Vínculo (Figura 70), nela será definido o escopo de vínculos
  que estará contido na parametrização.Figura 70: Escopo de Vínculo
  Neste momento, devem ser selecionados os vínculos que serão manipulados durante o processo de
  parametrização.Preencha os campos:
• Tipo de Vínculo;
• Vínculos;
• Estrutura Legal;
• Estrutura Gerencial;
• Estrutura Sindical.Selecione o ícone de navegação (Figura 71) para prosseguir com o roteiro.Figura 71: Ícone de Navegação
  42
  6.3 ETAPA 3: DADOS INICIAIS
  Na etapa seguinte, os dados iniciais (Figura 72) serão transferidos para o banco de horas.Figura 72: Dados Iniciais
  Estes dados incluem informações básicas do banco que será criado, sendo uma breve descrição
  suficiente para completar esta fase.Preencha os campos:
• Descrição: uma breve descrição do banco;
• Início Vigência;
• Fim Vigência.Selecione o ícone de navegação (Figura 73) para prosseguir com o roteiro.Figura 73: Ícone de Navegação
  43
  6.4 ETAPA 4: BANCO DE HORAS
  Na quarta etapa, serão preenchidas as informações sobre o banco de horas (Figura 74).Figura 74: Banco de Horas
  Caso exista algum tipo de fechamento periódico de banco de horas na organização, selecione a opção
  Trabalho com banco de horas com fechamento periódico e cadastre os períodos de fechamento (Figura
  75):
  Figura 75: Períodos de Fechamento
• Data Início;
• Data Fim.Selecione Inserir Período (Figura 76) para concluir o cadastro.44
  Figura 76: Inserir Período
  Após o preenchimento dos períodos, prossiga para a próxima etapa (Figura 77).Figura 77: Ícone de Navegação
  45
  6.5 ETAPA 5: DETALHAMENTO DA APURAÇÃO
  Na etapa Detalhamento da Apuração (Figura 78), são feitas perguntas mais específicas sobre a apuração
  dos colaboradores.Figura 78: Detalhamento da Apuração
  As informações preenchidas nessa tela serão utilizadas nos cálculos de frequência dos colaboradores
  escolhidos no escopo da etapa inicial.A organização acumula horas em banco? (Figura 79)
  Figura 79
  – Caso a organização acumule horas no banco, selecione a opção Sim.– Caso contrário, os demais campos podem ser ignorados.Acréscimos (Figura 80)
  Figura 80
• Se a opção for marcada como Sim, você pode definir se haverá um acréscimo no saldo acumulado
  no banco de horas.46
• Caso haja, insira o valor percentual que será acrescido; se não, deixe o campo desabilitado.Compensação (Figura 81)
  Figura 81
• Para compensações, caso a organização permita compensações de atrasos e faltas, marque a opção
  Sim.• Defina então as condições desejadas:
  – Descontar atrasos e faltas somente se houver crédito;
  – Descontar atrasos e faltas mesmo sem crédito, permitindo saldo negativo;
  – Descontar apenas atrasos, sem compensar faltas.Quitação Banco de Horas (Figura 82)
  Figura 82
• Nesta etapa, será configurada a quitação do banco de horas. Defina se, ao final do período do
  banco de horas, o saldo positivo será pago ou o saldo negativo será descontado do colaborador.– Marque a opção Sim para indicar que o saldo positivo será pago e o saldo negativo descontado.– Selecione os eventos para quitação do saldo, tanto para saldo positivo quanto negativo.– Se não houver necessidade de quitação, deixe os campos desabilitados.Selecione o ícone de navegação (Figura 83) para prosseguir com o roteiro.Figura 83: Ícone de Navegação
  47
  6.6 ETAPA 6: JORNADA DE TRABALHO
  Na etapa seguinte serão cadastrados os dados referentes à jornada de trabalho (Figura 84) dos
  colaboradores. Estas informações podem impactar diretamente as escalas de trabalho configuradas
  anteriormente.Figura 84: Jornada de Trabalho
• Indique se a jornada de trabalho é flexível, permitindo que o colaborador cumpra o total de horas da
  escala em outros horários não previstos.• Defina se será exigido um intervalo obrigatório para descanso.• Especifique se a organização adota algum tipo de tolerância para atrasos, considerando esse
  tempo para a geração de horas em banco ou horas extras.Selecione o ícone de navegação (Figura 85) para prosseguir com o roteiro.Figura 85: Ícone de Navegação
  48
  6.7 ETAPA 7: HORAS EXTRAS
  Na etapa seguinte, configure as regras para o cálculo de horas extras (Figura 86). As informações
  cadastradas aqui também impactarão as escalas de trabalho dos vínculos selecionados.Figura 86: Horas Extras
• Indique se haverá a geração de horas extras em dias úteis.• Se sim, defina a partir de quantas horas trabalhadas serão geradas horas extras.• Especifique se o sistema deve calcular horas extras em situações onde o colaborador trabalhe além
  do previsto para o respectivo dia.• Insira o evento correspondente para o cálculo das horas extras.Selecione o ícone de navegação (Figura 87) para prosseguir com o roteiro.Figura 87: Ícone de Navegação
  49
  6.8 ETAPA 8: ADICIONAL NOTURNO
  Na última etapa serão cadastradas as informações para o cálculo do adicional noturno (Figura 88).Figura 88: Adicional Noturno
• Preencha os campos com o início e fim do período noturno e selecione o evento que será
  associado ao cálculo do adicional, conforme a porcentagem aplicável.• Após concluir todas as etapas do roteiro de parametrização, clique na opção Finalizar (Figura 89).Figura 89: Finalizar
  Caso ocorra alguma mensagem de erro informando que a parametrização não foi concluída devido
  à existência de alterações no banco de horas, siga os seguintes passos:

1. Acesse a tela Alteração de Banco de Horas (Figura 90).50
   Figura 90: Alteração de Banco de Horas
2. Filtre pelos vínculos do escopo (Figura 91).Figura 91: Vínculos do Escopo
3. Clique no registro para o vínculo selecionado para abrir uma janela de detalhamento.4. Em seguida, remova as alterações existentes no banco de horas para os vínculos selecionados
   através do ícone Excluir (Figura 92) inferior da tela.51
   Figura 92: Excluir
4. Volte ao roteiro e clique em Finalizar.Se o processo for concluído com sucesso, o banco de horas será criado e associado aos vínculos
   definidos no escopo.Após a finalização, o operador estará habilitado para prosseguir com as rotinas de ciclo mensal, que
   serão abordadas no Ciclo Mensal (conferir item 7).52
   Ciclo Mensal
   Este documento tem como objetivo descrever o processo de Ciclo Mensal no módulo de controle
   de frequência do sistema HCM. Nesta etapa, são abordadas as rotinas que devem ser executadas
   periodicamente para o fechamento dos períodos de apuração de frequência.Acesso ao Roteiro de Uso de Frequência
   O ciclo mensal é acessado através da tela Roteiro de Uso – Frequência (Figura 93).Figura 93: Roteiro de Uso – Frequência
   Nesta tela, encontram-se todos os passos necessários para a realização do fechamento dos períodos, e
   cada período existente será listado juntamente com seu respectivo roteiro.Procedimento:
5. Acesse a tela Roteiro de Uso de Frequência.2. Selecione o período criado anteriormente e registrado na tabela exibida (Figura 95).53
   Figura 94: Período Registrado
6. Clique na aba Roteiro (Figura 96) para visualizar os passos da rotina.Figura 95: Roteiro
   Ao clicar na linha de cada processo, o sistema apresentará uma janela informativa (Figura 97) com uma
   breve descrição da rotina e detalhamento da última operação registrada.54
   Figura 96: Janela Informativa
   O redirecionamento automático para a tela do processo correspondente pode ser realizado através do
   ícone Visualizar (Figura 98).Figura 97: Visualizar
   7.1 PASSO 1: IMPORTAÇÃO DE MARCAÇÕES
   O Passo 1 consiste na importação de batidas através de um arquivo .txt (formato aceito pelo sistema).Figura 98: Passo 1
   55
   7.1.1 Procedimento:
   Ao clicar no Passo 1, o operador será redirecionado para a tela Marcação de Ponto (Figura 99).Figura 99: Marcação de Ponto
   Acesse a aba Geral (Figura 100) para manipulação de marcações (cadastro, edição ou remoção).Figura 100: Geral
   Para importar novas batidas:

• Clique no menu Ações (Figura 101);
  Figura 101: Ações
  56
• Acesse a opção Importação REP (Figura 102);
  Figura 102: mportação REP
• Selecione o período e o arquivo (Figura 103) no formato .TXT;
  Figura 103: Campos
• Clique em Importar (Figura 104) para proceder com a importação.Figura 104: Importar
  Após a importação, as batidas estarão disponíveis no sistema, permitindo a continuidade dos próximos
  passos.57
  7.2 PASSOS 2 A 7: VALIDAÇÕES PRÉVIAS À APURAÇÃO
  Os Passos 2 a 7 correspondem a validações prévias à apuração, que podem resultar em ajustes nas
  batidas ou no cadastro de ocorrências. Cada um desses passos redireciona o operador para a mesma tela
  e aba, aplicando filtros específicos de acordo com a finalidade de cada passo.7.2.1 Passo 2: Validação de Ocorrências de Abono
  Figura 105: Passo 2
  Serão exibidas as ocorrências de abono (Figura 106) cadastradas para o período.Figura 106: Ocorrências de Abono
  Caso as validações estejam corretas, prossiga para o próximo passo.58
  7.2.2 Passo 3: Validação de Faltas e Atrasos
  Figura 107: Passo 3
  Serão mostrados atrasos e faltas (Figura 108) encontrados com base nas batidas e escalas associadas
  aos colaboradores.Figura 108: Atrasos e Faltas
  Para abonar faltas ou atrasos:
• Selecione os dias que devem ser abonados através da caixa de seleção e utilize a ação Lançamento
  de Ocorrências (Figura 109).59
  Figura 109: Lançamento de Ocorrências
• Preencha os campos Identificador e Motivo de Ocorrência no formulário (Figura 110) e clique em
  Confirmar para finalizar a operação.Figura 110: Formulário
  Observação: Abonos do mesmo tipo podem ser realizados simultaneamente.7.3 PASSO 4: VALIDAÇÃO DE BATIDAS ÍMPARES
  Figura 111: Passo 4
  Identifica dias com batidas ímpares (Figura 112), sugerindo possíveis esquecimentos de marcação.60
  Figura 112: Batidas Ímpares
  A correção pode ser feita na aba Geral (Figura 113), ajustando as batidas.Figura 113: Geral
  7.4 PASSOS 5 E 6: VALIDAÇÃO DE AUSÊNCIAS
  Passo 5: Valida ausências intrajornada (ausências entre jornadas) (Figura 115).61
  Figura 114: Passo 5
  Figura 115: Ausências Intrajornada
  Passo 6: Valida ausências interjornada (ausências dentro da jornada) (Figura 117).62
  Figura 116: Passo 6
  Figura 117: Ausências Interjornada
  63
  7.5 PASSO 7: VALIDAÇÃO DE TEMPOS EXTRAS REALIZADOS
  Figura 118: Passo 7
  Exibe as horas extras (Figura 119) realizadas além da jornada, sem ainda indicar se será direcionado para
  banco de horas ou pagamento de horas extras.Figura 119: Horas Extras
  7.6 PASSO 8: CÁLCULO DO TEMPO TRABALHADO
  Após as validações dos passos anteriores, o Passo 8 consiste no cálculo do tempo trabalhado, de acordo
  com as parametrizações feitas anteriormente.64
  Figura 120: Passo 8
  Procedimento:
  O operador será redirecionado para a tela Apuração de Frequência (Figura 121).Figura 121: Apuração de Frequência
• Selecione a ação Adicionar (Figura 122).Figura 122: Adicionar
  65
• Preencha o formulário (Figura 123) com as informações solicitadas:
  – Vínculos a serem apurados.– Período de apuração.– Ordem de Apuração (por estruturas, por exemplo).Figura 123: Formulário
• Clique no formulário cadastrado (Figura 124) na listagem da tela principal.Figura 124: Cadastro
• Clique em ações (Figura 125) no canto inferior direito da tela.66
  Figura 125: Ações
  O sistema disponibiliza três operações (Figura 126):
• Simulação: Realiza o cálculo sem gravar os resultados, apenas para validação;
• Retrocesso: Remove cálculos realizados anteriormente;
• Efetivação: Calcula e grava os resultados da apuração.Figura 126: Operações
  7.7 PASSO 9: VISUALIZAÇÃO DOS RESULTADOS
  No Passo 9, os resultados da apuração serão visualizados através da tela Resumos Apuração – Situações
  de Frequência.67
  Figura 127: Passo 9
• A aba Período (Figura 128) totaliza os cálculos para todo o período.Figura 128: Período
• Os totalizadores (Figura 129) exibem o saldo com e sem acréscimo, horas extras, faltas e adicional
  noturno.68
  Figura 129: Totalizadores
• A aba Diário (Figura 130) exibe os cálculos detalhados para cada dia do período.Figura 130: Diário
  69
  7.8 PASSOS 10 E 11: GERAÇÃO E VALIDAÇÃO DO LOTE PARA FOLHA DE PAGAMENTO
  Os Passos 10 e 11 são etapas finais do ciclo mensal e devem ser realizadas após a conclusão dos cálculos
  para todos os dias do período.Observação: Antes de prosseguir para os passos 10 e 11, realize a verificação dos relatórios de
  controle de frequência.7.8.1 Passo 10: Geração do Lote de Eventos
  Figura 131: Passo 10
• Crie um formulário para gerar o lote de eventos, semelhante ao cadastro feito no Passo 8.• Clique em Adicionar (Figura 132).Figura 132: Adicionar
  70
• Preencha os campos solicitados no formulário (Figura 133).Figura 133: Formulário
• Clique em Salvar (Figura 134).Figura 134: Salvar
  71
• Após a criação do formulário, clique no registro cadastrado e selecione a ação Gerar Lote (Figura
  135).Figura 135: Gerar Lote
  O lote será gerado com os eventos de folha de pagamento associados aos cálculos realizados.7.8.2 Passo 11: Validação e Importação do Lote
  Figura 136: Passo 11
• Ao se direcionar para a tela referente ao Passo 11, o lote gerado no passo anterior será exibido.72
• Clique no registro (Figura 137) referente ao cadastro.Figura 137: Registro
• Valide os itens do lote através da aba Itens (Figura 138).Figura 138: Itens
  73
• Após a validação, selecione a ação Exportar para a Folha (Figura 139) na aba Lote.Figura 139: Exportar para a Folha
  A partir dessa ação, os eventos do lote serão transferidos para a folha de pagamento.Com a realização de todos os passos, o ciclo mensal estará concluído, restando apenas os cálculos da
  folha de pagamento e o fechamento da folha.74
  Integração Control iD
  8.1 DEPENDÊNCIAS
  Necessário instalar as seguintes dependências para pleno funcionamento:
  8.1.1 XAMPP
  É um ambiente de desenvolvimento PHP e possui o servidor web Apache que irá executar a aplicação do
  HCMCli.Considerado a versão PHP 8.2.12.Links para instalação:
• https://www.apachefriends.org/pt_br/download.html
  8.1.2 Jenkins
  É um servidor de automação que irá executar o HCMCli em tempo pré-determinado realizando a integração
  automática.É necessário ter instalado o Java JDK 21 devido ao Jenkins ser executado nesta linguagem.Considerado as versões Jenkins 2.492.1 LTS.e JDK 21.0.5.Links para instalação:
• https://www.jenkins.io/download/
• https://get.jenkins.io/windows-stable/2.492.1/jenkins.msi
• https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html
• https://download.oracle.com/java/21/latest/jdk-21_windows-x64_bin.exe
  8.2 INSTALAÇÃO E CONFIGURAÇÃO DAS DEPENDÊNCIAS
  8.2.1 Instalação do XAMPP

1. Execute o instalador até a sua finalização.75
   Figura 140
   Figura 141
   76
   Figura 142
   Figura 143
   77
2. Após a instalação, localize a aplicação XAMPP Control Panel no menu iniciar e clique com o botão
   direito no ícone.3. Selecione a opção de execução Executar como administrador.4. Clique no primeiro botão Start para inicializar o módulo Apache.5. Confira se a cor verde aparece no nome do módulo.Figura 144
   Figura 145
3. Por padrão, a porta utilizada pelo Apache é a 80. Caso ocorra algum conflito e esta porta não possa
   ser utilizada:

• Clique na opção Config e selecione Apache (httpd.conf).78
• No arquivo de configuração, edite as duas linhas substituindo a porta 80 por outra disponível:
  – Listen 80
  – ServerName localhost:80
  Figura 146
  Figura 147
• Salve o arquivo e reinicie o módulo.79
  Dica: A opção Netstat lista as portas que estão em uso no momento.Figura 148

1. Ao acessar a opção Admin do módulo Apache, deve-se visualizar a tela de dashboard.Figura 149
   80
   Observação: Se a porta do Apache foi alterada, é necessário informá-la na URL do navegador.Por exemplo, utilizando a porta 8181, a URL correta será http://localhost:8181/dashboard/
2. Será necessário configurar o início automático do módulo Apache:

• Acesse a opção Config e no campo Autostart of modules marque a caixa Apache.• Logo abaixo, selecione a opção Start Control Panel Minimized.Figura 150

1. Também é preciso realizar a inicialização automática do XAMPP Control Panel junto ao Windows:

• Acesse o diretório de instalação do XAMPP em C:\xampp e clique com o botão direito no
  arquivo xampp-control.exe e selecione Criar atalho.81
  Figura 151
• No atalho criado, selecione a opção Recortar e acesse o diretório:
  C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp
• Cole o atalho dentro da pasta.Figura 152

1. A partir dessas etapas realizadas, a aplicação XAMPP estará devidamente configurada.82
   8.2.2 Configurando o HCMCli
   O repositório do projeto está localizado no endereço: http://gitlab.teknisa.com/pebbian/teknisa-hcmcli/
   Acesse o diretório C:\xampp\htdocs e insira a pasta completa do projeto teknisa-hcmcli.Dentro da pasta, acesse o único arquivo de configuração localizado em: .\configReps\dataReps.json
   Figura 153
   Figura 154
   83
   Explicação dos Atributos

• “NRORG”: Indica o número da organização do cliente (obrigatório).• “CLIENT_SECRET”: Indica a chave criptografada para conexão ao endpoint HCM Services.Seu valor está informado na tela Parâmetro da Organização e grupo Parametrização Geral
  (obrigatório).• “ACCESS_ENVIRONMENT”: Indica qual link de conexão ao endpoint HCM Services será utilizado.Os valores aceitos são: “LOCAL”, “CLOUD9”, “TESTE” ou “PRODUCAO”.Para a instalação no cliente, deve-se utilizar o último valor: “PRODUCAO” (obrigatório).• “DTINIFILTRO”: Indica a data inicial de busca das marcações de ponto no REP. As marcações serão
  pesquisadas a partir desta data. Considerar o formato “DD/MM/AAAA”.Útil para buscar as marcações antigas dentro do mês corrente. Caso não seja informado, será
  considerado o dia atual (sysdate).• “NRESTRUTURAM”: Indica o número das estruturas legais que serão consideradas para retorno
  dos dados de integração. Considera as estruturas da tela Pontos de Acesso. É possível informar
  mais de uma estrutura separando por vírgula. Exemplo: “10,20,30”.Caso não seja informado, serão consideradas todas as estruturas que possuem dados de integração.• “NRPONTOACESSO”: Indica o número de cada ponto de acesso que deve ser considerado para
  retorno dos dados de integração. É possível informar mais de um ponto de acesso separando por
  vírgula. Exemplo: “1,2,3”.Caso não seja informado, serão considerados todos os pontos de acesso que possuem dados de
  integração.Insira os dados corretos e salve as modificações no arquivo dataReps.json.Observação:
  Caso os campos NRESTRUTURAM e NRPONTOACESSO sejam informados simultaneamente, os
  números dos pontos de acesso devem estar inseridos dentro das mesmas estruturas informadas.Caso ambos os campos não sejam informados, serão consultados todos os REPs que possuem dados
  de integração cadastrados na organização.Os outros arquivos dentro desta pasta indicam exemplos de configuração aceitos:
• template_dataReps_especifico.json
• template_dataReps_geral.json
  84
  Figura 155
  Figura 156
  85
  Na tela Pontos de Acesso, devem ser inseridos os dados de cada REP. O campo Endereço Web
  representa o endereço IP de acesso ao REP. Deve-se informar apenas os números.Figura 157
  Observação:
  Se um REP realiza as marcações de ponto para mais de uma estrutura, o mesmo deve ter os dados
  de integração informados apenas uma vez nesta tela, evitando sincronização repetida. Neste caso,
  considere informar os dados na estrutura principal que for mais importante.Através dessas etapas, a aplicação do HCMCli estará devidamente configurada e pronta para uso.86
  8.3 INSTALAÇÃO DO JENKINS
• Execute o instalador até a finalização.Figura 158
  Figura 159
  87
• Por default, a porta utilizada pelo Jenkins é a 8080. Caso esta porta não possa ser utilizada, informe
  outra porta no momento da instalação.Figura 160
  Figura 161
  88
  Figura 162
• Acesse o navegador no endereço http://localhost:8080/ e siga as instruções para a finalização
  da configuração. trim
  Figura 163
  89
  Figura 164
  Figura 165
  90
  Criação de Usuário
  Crie um usuário para acesso e controle das configurações internas.Figura 166
  Figura 167
  91
  Figura 168
  Figura 169
  Posteriormente, siga com alguns ajustes internos para finalizar a configuração.92
  8.3.1 Configuração interna do Jenkins

1. Selecione a opção Gerenciar Jenkins no menu lateral.2. No grupo Configuração de sistema, selecione a opção System.Figura 170
   Figura 171
2. Configure o servidor de e-mails para envio automático em caso de falha da construção do job do
   Jenkins.• Em Jenkins Location, no campo Endereço de e-mail do administrador do sistema, altere o
   valor atual para: HCMCli – Servidor Jenkins xxx@yyy.com.br.• Substitua o e-mail pelo mesmo informado na tela Parâmetro da Organização, grupo Dados
   para Envio de E-Mail.93
3. No final da página, em Notificação de E-mail, clique em Avançado e configure os seguintes campos
   conforme os dados do grupo Dados para Envio de E-Mail:

• Servidor SMTP
• Marque Use SMTP Authentication
• Nome do Usuário
• Senha
• Marque Usar SSL ou Use TLS
• Porta SMTP

1. Faça uma simulação de envio de e-mail para validar a configuração:

• Marque a caixa Configuração de teste para enviar e-mail, insira um e-mail de remetente
  válido e clique em Test configuration.• Deve ser retornada a mensagem: Email was successfully sent.• Confira se o e-mail chegou ao remetente.Figura 172

1. Clique em Save para finalizar esta configuração.7. Retorne à opção Gerenciar Jenkins.8. Em Configuração de sistema, selecione Plugins.9. Clique em Extensões disponíveis.10. No campo de busca, digite: http request.11. No primeiro item exibido, clique na caixa da primeira coluna para marcar este plugin.94
2. Clique na opção Instalar.13. Aguarde o fim da instalação exibido no final da página.14. Clique em Voltar para a página principal.Figura 173
   Figura 174
   A configuração de gerenciamento do Jenkins estará pronta, restando apenas a criação do job.95
   8.4 NOVO JOB
3. Na tela inicial Comece a construir seu projeto de software, selecione a opção Criar um trabalho.Figura 175
4. Insira o nome da tarefa: HCMCli.3. Clique na primeira opção: Construir um projeto de software de estilo livre.4. Prossiga com Tudo certo.Figura 176
5. No menu de configuração, clique em Triggers.6. Marque a opção Construir periodicamente.7. No campo Agenda, informe: H */8 * * *.96
   Figura 177
   Este campo define de quanto em quanto tempo será executado a integração e aceita várias
   configurações de horários e dias da semana.Na configuração exemplificada, a execução do job será feita de 8 em 8 horas em todos os dias.Formatos de Programação aceitos:

• De hora em hora: 00 * * * ou H * * *
• De cinco em cinco minutos: 00-59/5 * * *
• Horários definidos (15min às 10,12,16,18,22h): 15 10,12,16,18,22 * *
• 1º ao 5º dia do mês às 19:25: 25 19 01-05 *
• Segunda a sexta ao meio-dia e meia-noite: 00 00,12 * * 1-5
• Seg, Qua, Sex às 2h: 0 2 * * mon,wed,fri
• Ter, Qui às 3h: 0 3 * * tue,thu
• Minuto a minuto: */1 * * *

1. Selecione Passos de construção no menu.9. Clique em Adicionar passo na construção e selecione HTTP Request.10. No campo URL, informe o ambiente do Apache com o caminho final teknisa-hcmcli.Exemplo: http://localhost/teknisa-hcmcli/
2. Altere o campo HTTP mode para POST.97
   Figura 178
3. Expanda Avançado e marque Response body in console como Sim.13. Clique em Adicionar ação de pós-construção e selecione Notificação de E-mail.Figura 179
4. No campo Destinatários, insira os e-mails que devem receber notificações de falha.15. Marque as opções:

• Enviar e-mail para todas as construções instáveis
• Enviar e-mails separados para os indivíduos que danificaram a construção

1. Clique em Salvar para finalizar a configuração.17. Em seguida, realize uma construção manual do job para verificar o funcionamento.• No menu, clique em Construir agora.98

• Em Build, visualize a nova construção gerada.• Clique na seta de opções e selecione Saída do console.Figura 180
• O ícone de seta verde ao lado de Saída do Console indica sucesso na sincronização.• O resultado da sincronização que foi realizada será exibido dentro do texto Response.Figura 181
  99

Visualize o histórico de construções em HCMCli no Jenkins.Construções automáticas aparecem como Iniciado pelo temporizador na saída do console.Figura 185
101
Figura 186
102

Confira os novos dados na tela Marcação de Ponto do HCM.Figura 182

Utilize um filtro de apuração dentro da data atual do sistema (sysdate).20. Caso a cor do ícone fique vermelha indica que ocorreu algum erro na sincronização. Verifique o
problema informado no corpo do texto Response.Figura 183
100

Um e-mail será disparado automaticamente para a lista de contatos, que foi configurada anteriormente,
com o mesmo conteúdo do response, alertando a falha para devida análise e correção.Figura 184