Processo de integração dos adicionais salariais de função personalizados

Para visualizar os adicionais salariais de função, personalizados anteriormente nos módulos do HCM XT Cargos e Salários ou Administração de Pessoal, é necessário realizar um processo de integração com o módulo Gestão de Remuneração.

Ao finalizar do processo de integração entre os módulos, será possível verificar o valor total destes adicionais em Gestão de Remuneração > Informações salariais dos Postos com cargos > botão Ações > Detalhar os adicionais salariais. Os valores dos adicionais salariais de função, personalizados nos módulos on-premisse, são calculados em proporção ao salário base de cada colaborador.

Como ativar a integração

Após finalizar as configurações é necessário adicionar a propriedade com o seguinte valor workstation-group-job-premium-info, no campo activewokflows na tabela TenantInformation do esquema public do banco de dados do senior X.

Funcionamento da propriedade

Esse campo, permite informar o nome, sendo necessário separar por vírgula caso tenha que informar mais de um fluxo.

• Ao alterar o campo activeworkflows é necessário reiniciar o respectivo integrador para que receba e aplique a alteração. Importante fazer o alinhamento com o responsável do T.I do cliente.
• Em produção é possível enviar um comando remoto de reinicialização, para isso basta executar na base de dados o comando: SELECT sendtointegrator('RESTART'::text, array['id_do_tenant'], 0).

Existem duas opções para integrar os valores dos adicionais salariais de função personalizados ao módulo Gestão de Remuneração. Escolha entre a Opção 1 ou Opção 2, de acordo com as suas particularidades.

Opção 1 de integração

Para seguir os passos da opção 1, considere as seguintes particularidades da customização do usuário: 

• O campo do adicional salarial de função personalizado deve estar na tela de características de posto (tabela R017CAR) e ter o seguinte nome: USU_Adicional.
Veja as características do campo

Campo	Máscara	Tipo	Tamanho	Precisão	Permite Nulo
USU_Adicional	ZZZ9,9[5]	Number	9	5	S

• O adicional deve estar associado a um posto que contenha um ou mais cargos;
• O adicional deve estar associado a um cargo que esteja associado a um posto;
• O adicional deve ser revisionado, ou seja, ter data de início e data de fim;
• O campo do adicional deve ter as mesmas características que o adicional de função do cargo (tipo, tamanho e afins);
• A data de fim da revisão do adicional nunca poderá ser maior que a de início;
• A data de início do próxima revisão deve ser maior que a data final da última revisão adicionada.

Pré-requisitos da carga inicial

Nesta opção, não há nenhum pré-requisito para efetuar a carga inicial.

Pré-requisitos da sincronia

Antes de iniciar a sincronia dos dados dos módulos on-premise com o Gestão de Remuneração, é necessário criar uma tabela personalizada com o nome USU_TADICIONAL com os seguintes campos:

E por fim, adicionar o gatilho (trigger) na tabela R017CAR, conforme especificado abaixo.

Trigger na tabela R017CAR

Copiar

CREATE OR REPLACE TRIGGER R017CAR_ADICIONAL   AFTER INSERT OR UPDATE OR DELETE ON R017CAR FOR EACH ROW   DECLARE                        newvarcar R017CAR.VarCar%Type;                        newcodcar R017CAR.CodCar%Type;  BEGIN                         newvarcar := :new.VarCar;                         newcodcar := :new.CodCar;                  IF ( newvarcar = 'N' AND newcodcar IS NOT NULL ) THEN                                   INSERT INTO USU_TADICIONAL ( USU_EstPos, USU_PosTra, USU_EstCar, USU_CarPos, USU_DatIni, USU_DatRef )                                   VALUES ( :new.EstPos, :new.PosTra, :new.EstCar, :new.CodCar, :new.DatIni, SYSDATE );                    ELSIF ( newvarcar = 'S' ) THEN                                  FOR row_R017CPC IN (                                                         SELECT EstCar, CarPos FROM R017CPC                                                         WHERE EstPos = :new.EstPos AND                                                                                        PosTra = :new.PosTra AND                                                                                        DatIni = :new.DatIni                                                                                )                                                            LOOP                                                                                       INSERT INTO USU_TADICIONAL ( USU_EstPos, USU_PosTra, USU_EstCar, USU_CarPos, USU_DatIni, USU_DatRef )                                                                                         VALUES ( :new.EstPos, :new.PosTra, row_R017CPC.EstCar, row_R017CPC.CarPos, :new.DatIni, SYSDATE );                                                              END LOOP;                                            END IF;    END;

Opção 2 de integração

Já para esta opção de integração, o usuário deverá atender às seguintes particularidades:

• O campo de adicional salarial de função personalizado do cliente pode estar em qualquer tela e poderá ter qualquer nome;
• O adicional deve estar associado a um posto que contenha um ou mais cargos;
• O adicional deve estar associado a um cargo que esteja associado a um posto;
• O adicional deve ser revisionado, ou seja ter data de início e data de fim;
• O campo do Adicional deve ter as mesmas características que o adicional de função do cargo (tipo, tamanho e outros);
• A data de fim da revisão do adicional nunca poderá ser maior que a de início;
• A data de início do próxima revisão deve ser maior que a data final da última revisão adicionada.

Pré-requisitos da carga inicial

É necessário personalizar a Query g5-workstation-group-job-premium-info-query.sql para executar a carga inicial. Verifique o procedimento na documentação das Funcionalidades do Integrador - HCM > Customização dos fluxos.

Pré-requisitos da sincronia

Antes de iniciar a sincronia dos dados dos módulos on-premise com o Gestão de Remuneração, é necessário criar uma tabela personalizada com o nome USU_TAdicional e com os seguintes campos:

Após criar a tabela personalizada deve ser criado o trigger ou então uma Regra LSP (Linguagem Senior Programação) para fazer o insert, ao invés de criar a trigger.

Assim, existem 3 formas para fazer o insert na tabela USU_TADICIONAL. São eles:

• Acessar o banco de dados diretamente e rodar o comando de criação de trigger;
• Acessar o CBDS e rodar o comando de criação de trigger pelo editor de query;
• Fazer a inserção dos dados através de uma regra LSP, ao invés de criar a trigger.
  

Como criar o trigger em outra tabela

Na opção 2 de integração, quando o adicional salarial de função personalizado não está na tabela R017CAR, pode ser criado o trigger na tabela em que o usuário inseriu os dados sobre o adicional.

Sempre que houver uma atualização do adicional personalizado (independente de ser insert, update ou delete), deve-se fazer um insert na tabela USU_TAdicional com os valores da estrutura de posto, posto, estrutura de cargo, cargo, data de início da revisão do adicional e a data atual do sistema.

A trigger pode ser criada rodando um comando de criação de trigger via banco de dados ou via CBDS utilizando o editor sql.

E por fim, é necessário personalizar a Query g5-sync-workstation-group-job-premium-info-query.sql para executar a sincronia. Verifique o procedimento na documentação das Funcionalidades do Integrador - HCM > Customização dos fluxos.