RH - Linha Datasul - MPHCM - Como parametrizar o Portal HCM

  Tempo aproximado para leitura: 00:06:33 min

Dúvida
Como parametrizar o Portal HCM?

Ambiente
TOTVS RH - TOTVS RH (Linha Datasul) - Portal HCM – Versão 12

Solução
Para que seja possível utilizar os perfis Funcionário, Coordenador e RH do Portal HCM são pré-requisitos:

1. Parametrizar o servidor de aplicação JBoss e o AppServer:

O arquivo para configuração do servidor de aplicação encontra-se em: <instância JBoss>\deploy\conf\datasul\datasul_framework.properties. Neste arquivo, localize as tags abaixo:

job.java.naming.security.principal=
job.java.naming.security.credentials=

Nelas deverão ser informados usuário e senha para o login no AppServer para executar efetivamente a sincronização. Exemplo:

job.java.naming.security.principal=super
job.java.naming.security.credentials=super@123

Não é necessário que seja o mesmo usuário que agendou a sincronização. Porém, deve ser um usuário cadastrado no produto que está no programa Manutenção de Usuários - SEC000AA. Além disso, ele deve estar relacionado ao grupo de segurança HR. Se não estiver relacionado a este grupo, poderá ocorrer erro e as linhas abaixo estarão presentes no log do JBoss:

ERROR [org.jboss.ejb3.security.RoleBasedAuthorizationInterceptor] Insufficient permissions, principal=super, requiredRoles=[HR, JOB, COO, QSQ], principalRoles=[pri, *, sup]
INFO [com.datasul.hcm.payroll.employee.EmployeeServiceBean] DatasulQuartzScheduler_Worker-3 <<>> Liberando proxy com sucesso...
ERROR [STDERR] 30/09/2014 00:15:01 com.datasul.framework.progress.interceptor.ProgressMethodInterceptor intercept 
GRAVE: Authorization failure
javax.ejb.EJBAccessException: Authorization failure

Caso existam dúvidas na configuração desse arquivo, entrar em contato com a área de Tecnologia/Framework do produto TOTVS 11.

2. Possuir a folha de pagamento Datasul HCM:
É necessário ter implantada a folha de pagamento Datasul HCM.

3. Sincronizar as tabelas do banco payroll2:
O Portal HCM possui um banco próprio, que é o banco Payroll2. O banco Payroll2 é um resumo do banco HCM, contendo apenas as informações necessárias para os papéis de Funcionário, Coordenador e RH. Este banco precisa ser sincronizado diariamente para conter os dados mais atuais da folha de pagamento. Para isso, deve-se executar o programa Gerar Sincronização Portal HCM  - EP2014.

Até a versão 12.1.3 a sincronização do Portal HCM era feita através do programa Portal Agendar Sincronizações - descontinuado. Neste, a sincronização era programada tabela a tabela e devia-se seguir uma ordem para que houvesse integridade nos dados.

Já no novo programa de sincronizações EP2014, também é possível efetuar a sincronização das tabelas uma a uma, mas, por padrão e recomendável o programa vem com todas as tabelas selecionadas para sincronizar. Para executar o programa de forma automática deve-se programar a execução via RPW. Ao programar a sincronização, se todas as tabelas estiverem selecionadas, o programa automaticamente sincroniza as tabelas respeitando suas dependências. Ao final da execução, será aberto um arquivo de log para exibir os status das sincronizações. Para cada tabela sincronizada, emitirá as seguintes linhas iniciais e finais, exemplo:

Caso ocorra alguma mensagem, será demonstrada na coluna Descrição do log, exemplo:

Segue abaixo a ordem que as tabelas são sincronizadas:

Primeiro bloco:
Empresa - Tabela: COMPANY
Classes de Ponto – Tabela: TIMEATTENDCLASS
Países – Tabela: COUNTRY
Nível Hierárquico – Tabela: FUNCHIERARCHYLEVEL
Turno de Trabalho – Tabela: WORKTURN
Sindicato – Tabela: LABORUNION
Função - Tabela: EMPLOYMENTFUCTION
Benefícios – Tabela: BENEFIT
Unidade de Lotação – Tabela: ALLOCATIONUNIT
Plano de Lotação - Tabela: ALLOCATIONPLAN
Unidade de Negócio - Tabela: BUSINESSUNIT
Tipos de Mão de Obra – Tabela: LABORTYPE
Graus de Instrução – Tabela: EDUCATIONDEGREE
Situações Funcionário – Tabela: EMPLOYEESITUATION
Feriados – Tabela: HOLIDAY
Tipos de Banco de Horas – Tabela: TIMEACCOUNTTYPE
Vínculos Empregatícios - Tabela: EMPLOYMENTLINKTYPE

Segundo bloco:
Linhas de Transporte - Tabela: TRANSPORTLINE - referência: empresa;
Localidade - Tabela: LOCATION - referência: países;
Estados - Tabela: FEDERALUNIT - referência: países;
Cargo - Tabela: POSITIONEMPLOYEE - referência: nível hierárquico;
Turma - Tabela: WORKGROUP - referência: turno de trabalho;
Jornadas de Trabalho - Tabelas: HOURSWORK, HOURSWORKINTERVAL, INTERVALS_, WORKTURN_HOURSWORK - referência: turno de trabalho;
Estabelecimento - Tabela: SITE - referência: empresa;
Motivos - Tabela: MOTIVE - referência: empresa;
Centro de Custo - Tabela: COSTCENTER - referência: empresa.

Terceiro bloco:
Categoria de Ponto/Folha - Tabela: PAYMENTCATEGORY - referência: empresa, estabelecimento.
Funcionários - Tabelas: EMPLOYEE, EMPLOYEEDOC, EMPLOYEEUSER, EMPLOYEEIMAGE, EMPLOYEEDEPENDENT - referência: empresa, estabelecimento, pais, estado.

Quarto bloco:
Permissões Estabelecimento - Tabela: SITEPRIVILEGES - referência: empresa, funcionário;
Contratos Funcionários - Tabelas: EMPLOYMENTCONTRACT, EMPRESCISSION - referência: empresa, estabelecimento, funcionário;
Períodos Aquisitivos - Tabelas: ACQUIREDPERIOD, ACQUIREDPERIODPLAN - referência: empresa, estabelecimento, funcionário;
Estrutura Reporte Geral - Tabelas: EMPREPORTSTRUCTURE, EMPLOYEES_ - referência: empresa, estabelecimento, funcionário;
Estabilidades Funcionário - Tabela: EMPLOYEESTABILITY - referência: empresa, estabelecimento, funcionário.

Quinto bloco:
Lotações Funcionários - Tabela: EMPLOYEEALLOCATION - referência: empresa, estabelecimento, funcionário, tipo de mão de obra, unidade de negócio, plano de lotação, função, unidade de lotação, cargo, nível hierárquico funcional, categoria de folha, classe de ponto, jornada de trabalho, turno de trabalho, turma, sindicato, centro de custo, localidade. tipo de mão de obra, unidade de negócio, unidade de lotação, cargo.

4. Atribuir o grupo RH, COO ou QSQ a um usuário do Sistema:
Após todas as sincronizações terem sido efetuadas, para que um funcionário possua um perfil de RH - Recursos Humanos em seu cadastro no SEC000AA, devem ser atribuídos os grupos de segurança:

• RH: caso o usuário seja do tipo RH.

• COO: caso o usuário seja do tipo Coordenador.

• QSQ: caso o usuário seja do tipo funcionário.

Ainda no programa SEC000AA, em Complemento RH, deve ser atribuído o funcionário a que se refere este usuário do Sistema. Este funcionário deve ser um funcionário ativo.

Análise via suporte é efetuada por tabela sincronizada, assim, em caso de divergências neste processo, por gentileza, abrir um ticket para o módulo Portal HCM, enviando as seguintes informações:

• Se for uma divergência de sincronização: relatório do EP2014.

• Documento detalhando o processo efetuado passo-a-passo até a geração da inconsistência.

• Arquivo de configuração do JBoss: datasul_framework.properties.