Customizações - Gestão de Departamento Pessoal

O Gestão de Departamento Pessoal usa os campos personalizados da XPlatform para viabilizar a customização de campos no sistema.

Quando há integração com os módulos do HCM XT, os campos personalizados podem ser vinculados aos campos de usuário que foram inseridos na base utilizando o CBDS.

Criar e configurar campos customizados

1. Se você tem campos customizados na base de dados do HCM XT e quer integrá-los com a XPlatform, certifique-se de que os campos já foram criados por meio do CBDS. Caso não queira integrar os campos customizados entre os dois sistemas, siga para o próximo passo.
2. Crie os campos customizados pela XPlatform, em: Tecnologia > Customização > Campos.
   

   Importante

   • Se houver integração com campos da base do HCM XT, os campos precisam ter os mesmos nomes. Além disso, eles precisam ser do mesmo tipo (numérico, alfanumérico, lista, etc.).

   Tipos de campos suportados na integração

   A XPlatform permite criar diversos tipos de campos customizados. No entanto, para o Gestão de Departamento Pessoal, somente os seguintes tipos de campos são suportados atualmente:

   • String
   • Boolean
   • Integer
   • Double
   • Date
   • DateTime
   • Time

   • Se um campo customizado for criado com o mesmo ID para o Gestão de Departamento Pessoal e para o sistema da Admissão Digital, as informações serão replicadas para ambos os módulos. Ou seja, ao preencher o campo no sistema da Admissão Digital, a informação será replicada para o mesmo campo no Gestão de Departamento Pessoal, e vice-versa.
3. Se você optou por integrar os campos entre as bases cloud e do HCM XT, faça o relacionamento entre eles. Para fazer isso, use como referência as tabelas listadas adiante.

Uso de caracteres maiúsculos e minúsculos

Para que os campos customizados funcionem corretamente na integração, existem as seguintes particularidades em relação ao uso de caracteres maiúsculos e minúsculos nos nomes dos campos:

• Nome do campo criado no CBDS (sistema on-premise): os campos customizados criados no sistema on-premise precisam sempre ser criados com todos os caracteres maiúsculos no nome, para que possam ser usados corretamente.
• Diferenças entre os bancos de dados utilizados: a maneira da qual as informações são gravadas na base dependem do banco de dados utilizado:
  • O Oracle grava os dados com todos os caracteres maiúsculos.
  • Já o SQL Server grava com todos os caracteres minúsculos.

  Essa diferença deve ser levada em consideração, pois o nome do campo criado na plataforma precisa ser idêntico ao nome que foi gravado na base de dados.

A tabela abaixo exemplifica a maneira correta de nomear os campos customizados:

Nome do campo de usuário criado no CBDS (todos os caracteres precisam ser maiúsculos)	Banco de dados utilizado	Nome que é gravado na base (de acordo com o banco utilizado)	Nome que deve ser informado na XPlatform
USU_DEP	Oracle	USU_DEP	USU_DEP
	SQL	usu_dep	usu_dep

Relação de tabelas do HCM senior X e HCM XT

Para criar os campos customizados, você precisa conhecer os nomes das tabelas do banco de dados que são usadas pelo Gestão de Departamento Pessoal na XPlatform. Caso queira integrar os campos customizados com os módulos do HCM XT, precisa também conhecer os nomes das tabelas nesta versão.

A documentação a seguir traz a relação entre as tabelas do banco de dados e as entidades que você precisa conhecer para criar os campos customizados.

Cadastros gerais

Domínio / Serviço: hcm / general_register

Descrição	Nomes das tabelas		Campo é exibido em tela?
	HCM XT	Gestão de Departamento Pessoal (senior X)	Menu: Gestão de Pessoas | HCM > Cadastros > Gerais
Cadastro de religiões	R114RLR	religion	Sim
Tipo de anotação	R022NOT	annotation_type	Sim
Banco	R012BAN	bank	Sim
Agência	R012AGE	bank_branch	Não
Cidade	R074CID	city	Sim
Estado da cidade	R074EST	state	Sim
País do estado	R074PAI	country	Sim
Bairros	R074BAI	neighborhood	Sim
Castas	R114CAS	caste	Sim
Endereço	R033PES \ R034CPL	address	Não
Região Administrativa	R074RAD	administrativeregion	Sim
Vínculos do colaborador	R022VIN	employment_relationship	Sim
Pagamentos do vínculo do colaborador		payment_relationship	Sim
Quadro de vagas do vínculo do colaborador		benefit_relationship	Não
Moedas	R026MOE	currency	Não
Índices	R026IDM	financial_index	Sim
Valores dos índices	R026IDV	index_value	Sim
Índices de conversão	R026ICM	conversion_rates	Sim
Atendentes	R108TAT	attendant	Sim
Sigla conselho profissional	R022SIG	professional_board_acronym	Sim
Conselho profissional	R022PRF	professionalcouncil	Sim
Rateios	R020RAT	apportionment	Sim
Pareceres	R106PAR	opinion	Sim
Grau de instrução	R022GRA	educationdegree	Sim
Área de conhecimento	R171ACN	knowledgearea	Sim
Nacionalidade da pessoa	R023NAC	nationality	Sim
Estruturas	R000EST	structure	Sim
Códigos limite de isenção ISS Terceiro	R022LIM	issLimit	Sim
Estrutura de Organograma	R016ORE	organizational_chart_structure	Não
Datas dos feriados	R002FEC	holidayDates	Sim
Feriados	R002FEM	holiday	Sim
Horários	R004HOR	workSchedule	Não
Marcações do horário	R004MHR	clockingEventOfWorkSchedule	Não
Faixas de marcação de horário	R004FHR	clockingEventBands	Não
Cadastro de qualificações	R022QUA	qualification	Sim
Perfil do posto de trabalho e configurações de características de posto	R017PER	workstation_group_profile	Não
Cadastro de meios de transporte	R028MVT	means_of_transport	Não
Preços linhas	R028PRT	line_prices	Sim
Linhas de transportes	R028LVT	transport_line	Sim
CID por CNAE	R192CNA	cid_by_cnae	Sim
Deficiências da pessoa	R034CPL \ R033PES \ R022DEF	disability	Sim
Doenças (CID)	R192DOE	disease	Sim
Motivo de reajuste salarial	R076MOT	movimentationreason	Sim
Motivos demissão	R114RMD	resignationReason	Sim
Subgrupo de Doenças (CID)	R192SUB	subgroupDisease	Sim
Situação do afastamento	R010SIT	timetrackingsituation	Sim
Embarque vale transporte	R028BVT	pointEmbarkation	Sim
Cadastro de escala de vale-transporte	R028EVT	transportationVoucherScale	Sim
Quantidades da escala de vale-transporte	R028EVL	transportationVoucherScaleItem	Sim
Logradouros	R074RUA	publicPlace	Sim
Tipos de documentos	R022DOC	documentType	Sim
Tipos de endereço eletrônico	R022EEL	electronicAddress	Sim
Atividades de serviço	R022ISS	issActivity	Sim
Hierarquia dos locais do organograma	R016HIE	organizationalChartDepartmentHierarchy	Sim
Departamentos do Organograma	R016ORN	organizationalChartDepartment	Sim

Cadastros organizacionais

Domínio / Serviço: hcm / organization_register

Descrição	Nomes das tabelas		Campo é exibido em tela?
	HCM XT	Gestão de Departamento Pessoal (senior X)	Menu: Gestão de Pessoas | HCM > Cadastros > Empresas
Ramo de Atuação	R032ATU	activityfield	Sim
Regiões administrativas	R074RAD	administrativeregion	Sim
CBO	R024CBO	cbo	Sim
CBO 2002	R024CB2	cbo2002	Sim
Cidades	R074CID	city	Sim
Contratos	R032EMC	contract	Sim
Centro de Custo	R018CCU	costcenter	Sim
Países	R074PAI	country	Sim
Outras empresas - Dados no exterior	R032EXT	dataAbroadOtherCompany	Sim
Grau de instrução dos colaboradores	R022GRA	educationdegree	Sim
Natureza da despesa	R048NAT	expense_nature	Sim
Valores Gerais	R026VLR	general_value	Não
Valores Gerais - Empresa	R027VLG	general_value_company	Não
Hierarquia de Cargo	R024HIE	hierarchyoffice	Sim
Cargo	R024CAR	jobposition	Sim
Órgão público do cargo	R024CPU	jobposition_publicbody	Sim
Requisitos do Cargo	R024RQU	jobPositionRequirements	Sim
Informações salariais do cargo	R024HIS	jobpositionsalaryinfo	Sim
Adicionais do cargo (periculosidade, insalubridade)	R038LAG	jobPositionSalaryPremium	Sim
Estrutura de cargo	R024EST	jobpositionstructure	Sim
Nível de estrutura de cargo	R024NIV	jobpositionstructurelevel	Sim
Chefias	R080SUB	leadership	Sim
Exceção de chefia	R080EXC	leadershipException	Sim
Bairros	R074BAI	neighborhood	Sim
Área de Atuação	R024AAT	occupationarea	Sim
Locais do organograma	R016ORN	organizationalChartDepartment	Sim
Estruturas do organograma	R016ORE	organizationalChartStructure	Sim
Outras empresas	R032OEM	othercompany	Sim
Siglas dos conselhos profissionais	R022SIG	professionalBoardAcronym	Sim
Qualificações	R022QUA	qualification	Sim
Definições previdência social	R026DEF	social_security_setting	Sim
Estados	R074EST	state	Sim
Tabela salarial do cargo	R076DES	wagescale	Sim
Classe do salário do cargo	R076CLA	wageclass	Sim
Faixa do salário do cargo	R076NIV	wagelevel	Sim

Controle de ponto

Domínio / Serviço: hcm / clocking_event

Descrição	Nomes das tabelas		Campo é exibido em tela?
	HCM XT	Gestão de Departamento Pessoal (senior X)
Troca de local	R064LOC	department_change	Não

Gestão de colaboradores

Domínio / Serviço: hcm / payroll

Descrição	Nomes das tabelas		Campo é exibido em tela?
	HCM XT	Gestão de Departamento Pessoal (senior X)	Menu: Gestão de Pessoas | HCM > Administração de pessoal > Dados contratuais > Colaboradores
Pessoa	R033PES	person	Sim
Colaborador	R034FUN	employee	Sim
Diretor	R034FUN	director	Não
Terceiros	R034FUN	thirdparty	Não
Terceiros - Tipos de uso	R034USO	thirdPartyEmployee	Sim
Conta bancária	R034FUN \ R033PES	account	Sim
Documento do estrangeiro	R034EST	foreigner	Não
Registro geral (RG)	R034CPL \ R033PES	rg	Sim
Programa Integração Social (PIC)	R034FUN \ R033PES	nis	Não
Carteira de trabalho (CTPS)	R034FUN \ R033PES	ctps	Não
Endereços de e-mail da pessoa	R034CPL \ R033PES	email	Não
Telefones de contato	R034CPL \ R033PES	phone_contact	Não
Deficiências da pessoa	R034CPL \ R033PES \ R022DEF	disability	Não
Informações financeiras do colaborador	R034FUN	finance_information	Não
Informações de duração e prorrogação do contrato de trabalho	R034CPL	employeefixedtermcontract	Não
Agrupamento "Saúde e segurança" da guia Complementar	R034CPL	health_and_safety	Não
Dependente	R036DEP	dependent	Não
Escala	R006ESC	workshift	Não
Turma de escala	R006TMA	workshift_group	Não
Turmas de intervalo	R006TIN	interval_group	Não
Vínculos do colaborador	R022VIN	employment_relationship	Não
Cadastro do sindicato	R014SIN	syndicate	Não
Cadastro do sindicato Rescisão	R014HOM	syndicate_dismissal	Não
Siglas Conselhos Profissionais	R022SIG	professional_board_acronym	Não
Naturezas de Despesa	R048NAT	expense_nature	Não
Situação do afastamento	R010SIT	timetracking_situation	Não
Empresa	R030EMP	company	Não
Filial	R030FIL	company	Não
Estrutura do posto de trabalho	R017EST	workstationgroupstructure	Não
Posto de trabalho	R017POS	workstationgroup	Não
Relacionamento com posto de trabalho de deficiência	R017NEC	workstation_group_disability	Não
Relacionamento com posto de trabalho e cargo	R017CPC	workstation_group_jobposition	Não
Informação salarial da classe de posto	R017SAL	workstation_group_salaryinfo	Não
Empresa - Históricos de estruturas de postos	R030POS	historical_workstation_group_structure	Não
Local de trabalho	R016HIE	department	Não
Motivo de reajuste salarial	R076MOT	movimentationreason	Não
Cargo	R024CAR	jobposition	Não
Classe salarial	R076CLA	wageclass	Não
Nível salarial	R076NIV	wagelevel	Não
Estrutura salarial	R076DES	wagescale	Não
Revisão da escala salarial	R076EST	wagescalerevision	Não
Organograma	R016HIE	organizationalchart	Não
Item do organograma	R016ORN	organizationalchartitem	Não
Motivos demissão	R114RMD	resignation_reason	Não
Doenças (CID)	R192DOE	disease	Não
Subgrupo de Doenças (CID)	R192SUB	subgroup_disease	Não
Conselhos profissionais	R022PRF	professional_council	Não
Causas de demissão	R042CAU	dismissal_reason	Não
Aviso Prévio	R014AVP	prior_notice	Não
Aviso Prévio diferenciado	R014APD	differentiated_prior_notice	Não
Situações de exceções	R014ASI	exception_situation	Não
Anotações do colaborador	R038NOT	employeeannotation	Não
Cadastro de escala de vale-transporte	R028EVT	transportation_voucher_scale	Não
Quantidades da escala de vale-transporte	R028EVL	transportation_voucher_scale_item	Não
Meios de transporte da Gestão de escalas	R028MVT	means_of_transport	Não
Tipo de atuação	R017TAP	actingtype	Não
Equipes da Gestão de escalas	R031EQP	scale_team	Não
Cadastro de categorias da Gestão de escalas	R031CAT	scale_category	Não
Linhas de transporte	R028LVT	transport_line	Não
Quantidade das linhas de transporte	R028LVM	transport_line_item	Não
Outras empresas	R032OEM	othercompany	Não
Informações da admissão	R034ADM	admission_information	Não
Atividades de serviços	R022ISS	iss_active	Não
Modalidade PAT	R034PAT	employee_pat_modality	Não
Histórico de centro de custo	R038HCC	historical_cost_center	Sim
Histórico de local	R038HLO	historical_department	Sim
Histórico de cargo	R038HCA	historical_job_position	Sim
Histórico de posto de trabalho	R038HPO	historical_workstation	Sim
Histórico de vínculo	R038HVI	historical_employment_relationship	Sim
Histórico de sindicato	R038HSI	historical_syndicate	Não
Histórico de salário	R038HSA	historical_salary	Sim
Histórico de afastamento	R038AFA	historicalleave	Sim
Histórico de extensão de afastamento	R038PRO	historical_extension_leave	Não
Histórico de filial	R038HFI	historical_company_branch	Sim
Histórico de escala	R038HES	historical_workshift	Sim
Anotação do colaborador	R038NOT	employee_annotation	Não
Histórico de naturezas de despesa	R038HNA	historical_expense_nature	Sim
Histórico de categoria do eSocial	R038CAT	historical_esocial_category	Sim
Histórico de categoria da Sefip	R034FUN	historical_sefip_category	Sim
Embarque vale transporte	R028BVT	point_embarkation	Não
Histórico de Escala de Vale-transporte	R038EVT	historical_transportation_voucher_scale	Não
Aposentadoria	R034FUN	retirement	Não
Cálculo da folha de pagamento	R044CAL	payrollcalculation	Não
Tabelas de eventos de cálculo da folha de pagamento	R008EVM	wage_type_table	Não
Eventos (rubricas) de cálculo da folha de pagamento	R008EVC	wagetype	Não
Eventos - Tipos de cálculo válidos	R008CAL	valid_calculation_type	Não
Histórico atual do posto de trabalho do colaborador	R038HPO	workstation	Não
Histórico atual de salário do colaborador	R038HSA	salary	Não
Histórico de movimentações	---	movimentation	Não
Histórico de Contrato temporário	R034CPL	historical_temporary_contract	Não
Receita	R050REC	revenue	Não
Plano de Saúde	R034CPL/R034CTR	helth_plan	Não
Histórico de IRRF	R038HRE	historical_irrf	Não
Programação de desligamento	R042PRC	dismissalMovimentation	Não
Seguros do colaborador	R034SEG	employee_insurance	Não
Matrícula eSocial dos colaboradores	R34MAT	employee_esocial_registration	Não
Históricos de adicionais do salário	R038HAS	historicalSalaryPremium	Sim
Históricos de afastamento retroativo	R039AFA	retroactiveHistoricalLeave	Sim
Histórico de contribuição sindical	R038HCO	historicalSyndicateUnionContribution	Sim
Cadastros de aviso prévio de desligamento	R042AVI	noticeWorked	Sim

Gestão de dependentes

Domínio / Serviço: hcm / dependent

Descrição	Nomes das tabelas		Campo é exibido em tela?
	HCM XT	Gestão de Departamento Pessoal (senior X)	Menu: Gestão de Pessoas | HCM > Administração de pessoal > Dados contratuais > Colaboradores > Opções > Dependentes
Pensão judicial	R036PJU \ R036PJH	judicialPension	Sim
Pagamentos da pensão judicial	R036PJP	judicialPayment	Não
Ajustes da pensão judicial	R036PJA	judicialAdjustment	Não
Bases da pensão judicial onde a propriedade judicialBaseType define o tipo da base	R036PJN \ R036PJF \ R036PJL \ R036PJD	judicialBase	Não
Beneficiários (Alimentandos) da pensão judicial	R036PPD	judicialPayee	Não

Integração com o Quadro de Vagas

Domínio / Serviço: hcm / headcount

Descrição	Nomes das tabelas		Campo é exibido em tela?
	HCM XT	Gestão de Departamento Pessoal (senior X)
Tipos de requisição	R114RRQ	staffRequisitionType	Não
Situações de afastamento - Considera Quadro	R010SIT	timetrackingsituation	Não
Plano de vagas	R017PLV	jobVacancyPlan	Não
Plano de vagas por empresa	R017PLE	jobVacancyPlanCompany	Não
Tipos de atuação	R017TAP	actingType	Não
Controle de vagas por posto	R017HCV	workstationGroupJobVacancyPlan	Não
Quadro efetivo Normalização do quadro efetivo	R092EFE	effectiveHeadCount	Não
Quadro previsto Normalização do quadro previsto	R092QPO	providedHeadCount	Não

Lançamentos da folha de pagamento

Domínio / Serviço: hcm / entry

Descrição	Nomes das tabelas		Campo é exibido em tela?
	HCM XT	Gestão de Departamento Pessoal (senior X)
Lançamentos da folha de pagamento (Fixo)	R044FIX	entry	Não
Lançamentos da folha de pagamento (Variável)	R044MOV	entry	Não
Item dos lançamentos da folha de pagamento (Fixo)	R044FIX	entry_item	Não
Item dos lançamentos da folha de pagamento (Variável)	R044MOV	entry_item	Não
Dados da importação de lançamentos	---	entry_importation	Não
Múltiplos vínculos (lançamento de bases de cálculo)	R044BAS	employeeCalculationBasis	Não

Gerar relatórios personalizados usando as Visões Dinâmicas

As visões dinâmicas são recursos da XPlatform que permitem consultar e exportar dados em forma de relatórios.

Você pode selecionar diferentes tipos de informações para montar uma visão personalizada e exportar em forma de relatório.

Clique aqui para saber quais visões dinâmicas estão disponíveis para o Gestão de Departamento Pessoal.

Criar regra customizada para importar um arquivo de lançamentos

O Gestão de Departamento Pessoal permite importar arquivos com os lançamentos financeiros do colaborador.

É possível definir uma regra de validação nesse procedimento. Esta regra será aplicada em cada registro do arquivo de importação dos lançamentos.

A regra é definida na tela de Customização de Lançamentos (Gestão de Departamento Pessoal > Lançamentos > Customização) e precisa ser escrita em JavaScript.

Exemplo:

Copiar

1 2 3 4

if (isfired)      {'Colaborador demitido!'} else      {''}

Depois de escrever a regra, clique em Testar validação para verificar se existem erros no script informado. Se estiver tudo certo, clique em Salvar para gravar as informações e finalizar.

Relação de campos que podem ser usados na regra de validação

Ao escrever uma regra de validação para a importação de lançamentos, você pode usar os seguintes campos:

Campos disponíveis para a regra	Descrição dos campos
controlpoint	Controle do ponto
holidaysdates	Datas de feriados
wagevaluetype	Tipo do valor do evento
roles	Papéis associados ao usuário que realizou a importação
type	Tipo do evento
characteristic	Característica do evento
expirationdate	Data de expiração do evento
referencevalue	Valor da referência
value	Valor do evento
fired	Identifica se colaborador é demitido
calculationstart	Data inicial do cálculo
calculationend	Data final do cálculo
periodend	Data de fim do período
periodstart	Data de início do período
referencedate	Data de referência
paymentdate	Data do pagamento
calculationtype	Tipo do cálculo