Versões comparadas

Chave

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


...

Conteúdo

Índice

01.

...

Visão Geral

Este documento apresenta como efetuar a customização dos labels dos aplicativos Clock-In:

  • Clock-In Back Office

...

  • Clock-In Web

...

  • Clock-In Mobile

...

  • Clock-In Kiosk

...

A alteração de labels é necessária para tornar o produto mais aderente a um cenário específico. O caso mais comum é para permitir o registro de horário em cenários aonde não estão ligados ao registro de ponto eletrônico de funcionários.

02.

...

Configuração do Ambiente

O ambiente do Clock-In possui um Data Model chamado "Labels", esse Data Model possui as seguintes colunas:


NomeDescriçãoPossíveis Valores
appnameNome do aplicativo que terá o Label alterado.

clockin-backoffice

clockin-web

clockin-mobile

clockin-kiosk

mdmlocaleCódigo de localidade e idiomas. As localidades são provenientes do ISO 639 enquanto a lista de países é proveniente do ISO 3166.

ISO 639: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes

ISO 3166: https://en.wikipedia.org/wiki/ISO_3166-1


Referência: https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html

keyChave de internacionalização definido pelo aplicativo (cada aplicativo define sua lista).A lista de possíveis chaves está disponível abaixo, na parte de download dos arquivos de internacionalização (I18N).
valueNovo label que será atribuído pela aplicação.Os valores são abertos - podendo ser definido qualquer valor.


Essa configuração não deve substituir a tradução oficial. Ou seja, se houver a necessidade em compatibilizar o aplicativo TOTVS RH Clock-in com um novo idioma, por favor, efetue a abertura de um ticket para solicitação ao time responsável. Essa configuração permite a configuração especifica e isolada de labels para melhor aderência do Clock-In em ambientes mais específicos.

Uma vez os valores inseridos no Data Model Label, os aplicativos devem ser atualizados (aplicativos web) ou fechados e abertos novamente (aplicativos mobile/kiosk).

03. Exemplo configuração em ambiente Clock-In Back Office e Clock-In Web

Os seguintes valores foram adicionados no Data Model Label, na Carol:


Image Added


O resultado é o abaixo:


Clock-In Back Office, antes do label aplicado:

Image Added



Clock-In Back Office, depois do label aplicado:


Image Added


Clock-In Web, antes do label aplicado:

Image Added



Clock-In Web, depois do label aplicado:

Image Added


04. Exemplo configuração em ambiente Clock-In Mobile


Chaves possívels:

01 - common.clockIns
02 - clockInScene.clockInSuccessMessage
03 - clockInScene.geofence.error
04 - Components.DateTimeSnackBar.geofence.warn
05 - clockInScene.pendingSync.message
06 - clockInScene.resetClockins.title
07 - clockInScene.resetClockins.message
08 - clockInScene.loadingEmployeeImages
09 - clockInScene.employeeNotFoundMessage
10 - clockInScene.progressBar.employeeData
11 - clockInSceneCameraInput.livenessFaceInstruct
12 - clockInSceneCameraInput.livenessEyesInstruct
13 - clockInInitialSyncError.errorMessage
14 - clockInSceneCameraInput.captureClockIn
15 - clockInSceneFooter.lastClockIn
16 - hamburgerMenu.lastClockInSync
17 - hamburgerMenu.syncClockIns
18 - hamburgerMenu.clockIn
19 - hamburgerMenu.noClockInPending
20 - hamburgerMenu.displayScoreAlert.message
21 - hamburgerMenu.lastEmployeeListSync
22 - hamburgerMenu.totalEmployeesInDevice
23 - Core.Jobs.ClockIn.title
24 - Core.Jobs.ClockIn.messageSingular
25 - Core.Jobs.ClockIn.messagePlural
26 - Core.Jobs.Employees.title
27 - Core.Jobs.Employees.messageSingular
28 - Core.Jobs.Employees.messagePlural
29 - Core.Jobs.Employees.Snooze.message
30 - hamburgerMenu.syncOfflineDataSources

Exemplos:

Image Added


Image Added


Image Added


Image Added


Image Added


Image Added


Image Added


Image Added


Image Added


Image Added


Image Added


Image Added


Image Added


Image Added


Image Added


Image Added


Image Added





05. Exemplo configuração em ambiente Clock-In Kiosk

Chaves possívels:

01 - Scenes.ClockIn.geofence.error
02 - Scenes.ClockIn.geofence.warn
03 - Scenes.Results.readyToClockIn
04 - Scenes.Results.clockInSuccess
05 - Scenes.Results.clockInApprovalRequired
06 - Scenes.SettingsPanel.lastClockInsSynced
07 - Scenes.SettingsPanel.syncClockIns
08 - Scenes.SettingsPanel.clockIn
09 - Scenes.SettingsPanel.clockInPlural
10 - Scenes.SettingsPanel.lastEmployeeSynced
11 - Scenes.SettingsPanel.totalNumberOfEmployees
12 - Scenes.SettingsPanel.resetClockins.title
13 - Scenes.SettingsPanel.resetClockins.message
14 - Scenes.SettingsPanel.pendingSync.message
15 - Scenes.SettingsPanel.displayScoreAlert.message
16 - Scenes.SettingsClockInHistory.clockInCountLabel
17 - Scenes.SettingsClockInHistory.clockInHeader
18 - Scenes.ClockIn.employeesErrorModal.title
19 - Scenes.ClockIn.employeesErrorModal.subtitle
20 - Scenes.ClockIn.employeesErrorModal.description
21 - Scenes.ClockIn.datFilesErrorModal.title
22 - Scenes.ClockIn.datFilesErrorModal.subtitle
23 - Scenes.InitialSetup.progressBar.employeeData
24 - Scenes.CpfInput.noEmployeesFound
25 - Core.Jobs.ClockIn.title
26 - Core.Jobs.ClockIn.messageSingular
27 - Core.Jobs.ClockIn.messagePlural
28 - Core.Jobs.Employees.title
29 - Core.Jobs.Employees.messageSingular
30 - Core.Jobs.Employees.messagePlural
31 - Core.Jobs.Employees.Snooze.message


Exemplos:

Image Added


Image Added


Image Added


Image Added


Image Added


Image Added


Image Added


Image Added


Image Added


Image Added


Image Added


Image Added


Image Added


Image Added


Image Added


Image Added


06. Arquivos de internacionalização (I18N) para definir Keys

Os arquivos abaixo estão disponíveis para defiinr qual o valor de "key" para a alteração de label necessário. A forma mais fácil é verificar qual o label original, buscar no arquivo para encontrar qual a Key do valor, e informar na Carol conforme mencionado acima.


Clock-In Web

View file
nameclock-in-web-general-pt.txt
height250
 


Clock-In Back Office:

View file
nameclock-in-backoffice-general-pt.txt
height250

...

Há duas formas de efetuar o download do arquivo AFD:

TOTVS RH Clock-In Backoffice:

Acesse o aplicativo do Backoffice do TOTVS RH Clock-In:

Image Removed

Uma vez que o aplicativo está aberto, acesso no menu lateral a opção "Device List":

Image Removed

O aplicativo estará disponível no painel da direita. Neste aplicativo podemos efetuar o download de arquivos para dispositivos de forma individual, conforme abaixo destacado (link Download):

Image Removed

Ou o usuário pode efetuar o download dos arquivos AFD para todos os dispositivos disponíveis na página atual (filtro aplicado), através do botão "Export all AFD Files":

Image Removed

Após os procedimentos acima o download irá iniciar, os passos para importação dos arquivos AFD devem ser executados no produto de RH.

Carol App:

Uma outra forma de efetuar o download do arquivo AFD é através do Carol App "TOTVS RH Clock-In".

Informações
titlePapel do Usuário

Apenas os usuários com o papel (role) "Environment Admin" ou "Application Admin" possuem acesso ao módulo Carol App. Usuários "Business User" não possuem acesso a está funcionalidade.

Image Removed

Abrindo o aplicativo, você deverá clicar na aba "Storage" (passo 1) e logo em seguida filtrar os arquivos por "zip" (passo 2). Após clicar em "Search", você verá o arquivo "all_afd_files.zip" (passo 3). Este arquivo possui os arquivos AFD para todos os dispositivos.

Image Removed

03. Informações importantes

...

Para que os arquivos AFD sejam gerados é necessário agendar a execução do exportador ou executar este processo manualmente. Para isso, você deve acessar o Carol App TOTVS RH Clock-In pelo menu lateral esquerdo.

Dentro do aplicativo, na aba "Overview" você deverá localizar o processo "clockin_export_data" na aba "Batch Process Management". Você pode iniciar a execução agora pelo botão "Run" ou você pode agendar a execução pela opção "Edit".

Image Removed

O agendamento pode ocorrer toda hora, de forma diária, semanal ou mensal:

Image Removed

Ao término desta execução os arquivos estarão disponíveis conforme demonstrado no capítulo "02. Exemplo de Utilização". Recomenda-se execução diária deste processo através do agendamento.



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>