Campos Customizados - Admissão Digital

1. Para criar campos customizados na solução de Admissão Digital Senior, é necessário realizar o login na XPlatform usando uma conta que tenha permissões de administrador.
2. Acesse o menu: Tecnologia > Customização > Campos.
3. Na tela aberta, utilize o box Filtrar domínios para buscar pelo domínio hcm.
4. Ao encontrar o domínio, clique para expandi-lo.
5. Na lista de serviços aberta, localize e clique para expandir o serviço onboarding.
6. Busque a entidade que receberá o campo customizado e em seguida, clique no botão Entidade.
7. Através do botão Novo, você irá adicionar e configurar o campo customizado.
8. Informe o ID do Campo, Rótulo do Campo e selecione o Tipo do Campo.
9. Tipos de campo que podem ser utilizados:
   
   • String — campo para texto livre (caracteres alfanuméricos).
     
   • Boolean — campo para seleção entre as opções Sim e Não.
     
   • Integer — campo para valores numéricos (inteiros).
     
   • Double — campo para valores numéricos (decimais).
     
   • Date — campo para informar uma data.
     
   • DateTime — campo para informar uma data acompanhada de um horário.
     
   • Time — campo para informar um horário.
     
   • Money — campo para informar um valor monetário em reais.
     
   • Blob — campo para anexar arquivos, como um documento em PDF ou imagens, por exemplo.
     
   • Enumeration — campo para apresentar uma lista de opções a serem selecionadas.
     
10. Em seguida, clique em Salvar.
11. Uma mensagem de confirmação será apresentada, clique no botão Confirmar para salvar as configurações do campo;
12. Na tela de Entidades, repita o processo: clique em Salvar e, em seguida, Confirmar para finalizar.
13. Pronto! Você será redirecionado para a tela de Domínios e Serviços e verá uma mensagem de sucesso no canto superior.

1. Acesse a XPlatform usando uma conta que tenha permissões de administrador.
2. Acesse o menu: Tecnologia > Customização > Campos.
3. Procure pelo domínio hcm na lista ou use o campo de pesquisa para encontrá-lo.
4. No domínio hcm, procure pelo serviço onboarding. Com esse serviço é possível gerenciar os campos customizados do sistema da Admissão Digital, agrupados por entidade.
5. Procure pelas três entidades especiais customEntityOne, customEntityTwo e customEntityThree:
   
   
   
   Estas três entidades representam agrupadores, que aparecerão nas configurações do modelo de convite, na guia Outros:
   
   
6. Para cada entidade especial — customEntityOne, customEntityTwo e customEntityThree — clique no botão Entidade. Será apresentada a tela para incluir novos campos na entidade selecionada, bastando clicar em Novo e adicionar os campos que quiser:
   
   
   
   Assim, os campos adicionados na entidade serão exibidos no agrupador correspondente da guia Outros, no modelo de convite.

---

Exemplo — passo a passo

Neste tutorial, vamos explicar como criar campos customizados para permitir que o colaborador informe cursos adicionais que ele concluiu e anexe o certificado desses cursos.

1. Acesse o serviço onboarding na tela de campos customizados

Na plataforma senior X, acesse o menu: Tecnologia > Customização > Campos. Lembre-se que esse menu fica habilitado somente para o administrador do sistema ou alguém com permissões equivalentes.

Na tela de customização de campos, procure pelo domínio hcm e expanda o agrupador do serviço onboarding:

2. Escolha a entidade onde quer adicionar os campos

Cada entidade representa um grupo de informações da tela de pré-admissão.

Neste tutorial, vamos adicionar os campos no grupo de informações complementares do colaborador.

Este grupo é representado pela entidade personalComplementary. Então, procure-a na lista e clique em Entidade:

3. Adicione os novos campos na entidade

Ao acessar a tela de alguma entidade, você pode notar que ela já apresenta alguns campos. Esses são campos padrão do sistema, que ficam protegidos contra qualquer tipo de edição e são identificados por um cadeado ().

Para criar o primeiro campo customizado, clique em Novo:

Será apresentada a tela onde você pode fazer todas as definições do campo.

Vamos configurar apenas os seguintes dados, que são essenciais para este tutorial:

• ID do campo — identificador usado internamente pelo sistema. Deve ser um identificador único e são permitidas apenas letras e números. Ou seja: não pode ser igual ao identificador de outro campo e não são permitidos caracteres especiais, acentuação ou espaços.
  • Se você estiver configurando campos customizados para integrar com o Administração de Pessoal, o ID do campo precisa ser igual ao nome que foi criado nesse sistema. Para saber mais, consulte a documentação de integração de campos customizados do Administração de Pessoal.
• Rótulo do campo — nome do campo, que será exibido em tela para o colaborador preencher.
• Tipo do campo — define qual é o tipo de informação que o campo espera (texto livre, data, hora, etc.).
  
  Tipos de campo mais utilizados

  • String — campo para texto livre (caracteres alfanuméricos).
  • Boolean — campo para seleção entre as opções Sim e Não.
  • Integer — campo para valores numéricos (inteiros).
  • Double — campo para valores numéricos (decimais).
  • Date — campo para informar uma data.
  • DateTime — campo para informar uma data acompanhada de um horário.
  • Time — campo para informar um horário.
  • Money — campo para informar um valor monetário em reais.
  • Blob — campo para anexar arquivos, como um documento em PDF ou imagens, por exemplo.
  • Enumeration — campo para apresentar uma lista de opções a serem selecionadas.

Crie três campos, conforme os exemplos a seguir:

Campo 1 - Campo para o colaborador dizer se possui algum curso complementar

Campo 2 - Campo para o colaborador informar o nome do curso

Campo 3 - Campo para o colaborador anexar o certificado ou diploma do curso

4. Tudo pronto! Veja os campos que você criou

Se você seguiu os passos corretamente até aqui, já poderá ver os três campos que foram criados.

Para isso, acesse os detalhes de uma pré-admissão qualquer. Em Dados pessoais, expanda o agrupador Complementares:

Dentro do agrupador, os novos campos estarão identificados como campos customizados:

Dessa forma, sempre que você enviar um convite de pré-admissão, o novo colaborador terá a opção de informar um curso complementar e anexar o certificado de conclusão.

É possível customizar até três entidades dentro da solução de Admissão Digital, entretanto somente dentro das entidades customizáveis que constam na guia Outros.

Para isso, será necessário acessar o menu: XPlatform >  Gestão de Pessoas | HCM > Admissão Digital > Modelos de convite e seguir o passo a passo:

1. No modelo de convite que será customizada a entidade, clique no botão Ações e, em seguida, no botão Editar;
2. Na guia Outros, clique no ícone lápis de edição;
3. Insira o nome da entidade e depois, clique no ícone de confirmação;
4. Para finalizar, clique no botão Salvar.

As entidades customizadas estão disponíveis para que seja possível agrupar vários campos customizados dentro de uma única entidade que possua o nome correspondente aos campos criados.

Para integrar os campos customizados entre os dois sistemas, é preciso criá-los com o mesmo ID (identificador), dentro das entidades que são equivalentes entre eles.

Veja os passos:

1. Acesse a XPlatform usando uma conta que tenha permissões de administrador.
2. Acesse o menu: Tecnologia > Customização > Campos.
3. Procure pelo domínio hcm na lista ou use o campo de pesquisa para encontrá-lo.
4. No domínio hcm, procure pelo serviço onboarding (que é da Admissão Digital) e pelo serviço payroll (do Gestão de Departamento Pessoal).
   
   Com esses serviços é possível gerenciar os campos customizados dos dois sistemas, agrupados por entidades.
5. Para que o campo seja integrado entre os dois sistemas, faça o seguinte:
   • Crie o campo nos dois serviços, usando a entidades que são equivalentes entre eles (veja a tabela de equivalência a seguir).
   • Preencha o mesmo ID do campo em ambas as entidades.
     
     Tabela de entidades equivalentes entre a Admissão Digital e o GDP

     Entidades na Admissão Digital (onboarding)	Entidades equivalentes no GDP (payroll)
     personalBasic personalComplementary personalBirthPlace personalAddressBra personalTelephone personalEmail	person
     cpf pis ctps rg voter cnh passport reservist civilCertificate ric cns dnv	rg
     bankAccount	financeInformation

Os tipos de campos customizados permitidos são:

String: permite que o candidato utilize Letras (abcde) ou números (123456) nas respostas.

Boolean: restringe a resposta em Sim ou Não quando o campo for obrigatório, e também a adiciona a opção Nenhum se o campo não for obrigatório.

Integer: permite que o candidato utilize números separados por milhar nas respostas.

Double: permite que o candidato utilize decimais com duas casas após a vírgula nas respostas.

Date: permite que o candidato utilize Data nas respostas.

DateTime: permite que o candidato utilize Data e Horário nas respostas.

Time: permite que o candidato utilize Horário nas respostas.

Money: permite que o candidato utilize números representando um valor monetário nas respostas.

Enumeration: restringe a resposta a uma lista de opções pré-definida pelo RH.

Blob: permite que o candidato efetue o download e/ou upload de arquivos nas respostas.

Para alterar a nomenclatura de um campo customizado, é necessário estar logado com um usuário admistrador. Realizado o login, siga os passos abaixo:

1. Acesse XPlatform > Tecnologia > Customização > Campos, filtre pelo domínio HCM e clique para expandir o domínio.
2. Localize e expanda o serviço onboarding;
3. Na entidade que receberá o campo customizado, clique no botão Entidade;
4. Selecione o campo que terá a sua nomenclatura alterada e clique no botão Editar;
5. Efetue a alteração no campo Rótulo do campo;
6. Clique no botão Salvar e, em seguida, em Confirmar;
7. Para finalizar, é necessário Salvar e Confirmar na página de Entidades também.

Após salvar, a nomenclatura do campo customizado será alterada em todos os modelos de convite que tenham esse campo habilitado. Consequentemente, a alteração será refletida para o candidato.

ID da entidade	Nome da entidade	Tela onde aparecem os campos criados nesta entidade
area	Área	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Área
bank	Bancos	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Bancos
bankAccount	Dados bancários	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Documentos > Dados bancários
branchOffice	Filiais	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Filiais
civilCertificate	Certidão civil	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Documentos > Certidão civil
cnh	Carteira Nacional de Habilitação (CNH)	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Documentos > Carteira Nacional de Habilitação (CNH)
cns	Cartão Nacional de Saúde (CNS)	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Documentos > Cartão Nacional de Saúde (CNS)
company	Empresa	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Empresa
cpf	Cadastro de Pessoa Física (CPF)	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Documentos > Cadastro de Pessoa Física (CPF)
ctps	Carteira de Trabalho e Previdência Social (CTPS)	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Documentos > Carteira de Trabalho e Previdência Social (CTPS)
degreeOfEducation	Graus de Instrução	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > guia Dados pessoais > Complementares
dependentBasic	Dados básicos do dependente	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Ficha Familiar > Básicos
dnv	Declaração de Nascido Vivo (DNV)	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Documentos > Declaração de Nascido Vivo (DNV)
hiringMedicalExam	Exame admissional	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Documentos > Exame admissional
inviteModelContract	Contrato de trabalho	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Contrato > Geral
hiringMedicalExam	Exame Admissional	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Documentos > Exame Admissional
inviteModelContract	Tela de Contrato	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Contrato
jobPosition	Cargos	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões >  guia Contrato
nationality	Nacionalidade	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões >  guia Dados pessoais > Nacionalidade
passport	Passaporte	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Documentos > Passaporte
personalAddressBRA	Endereço	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Dados pessoais > Endereço
personalBasic	Dados básicos	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Dados pessoais > Básicos
personalBirthPlace	Local de nascimento	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Dados pessoais > Local de nascimento
personalComplementary	Dados complementares	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Dados pessoais > Complementares
personalEmail	Endereços de e-mail	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Dados pessoais > E-mails
personalTelephone	Telefones de contato	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Dados pessoais > Telefones
pis	Número de Identificação do Segurado (NIS)	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Documentos > Número de Identificação do Segurado (NIS: PIS, PASEP, NIT)
professionalAdvice	Conselhos Profissionais	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > guia Documentos > Registro profissional > Conselhos Profissional
professionalRecord	Registro profissional	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Documentos > Registro profissional
proofOfEnrollment	Comprovante de matrícula	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Ficha Familiar > Comprovante de matrícula
religion	Religião	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > guia Dados pessoais > Religião
reservist	Certificado de reservista	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Documentos > Certificado de reservista
rg	Carteira de identidade (RG)	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Documentos > Carteira de identidade
ric	Registro de Identidade Civil (RIC)	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Documentos > Registro de identidade civil (RIC)
sus	Cartão SUS	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Ficha Familiar > Cartão do SUS
vaccinationBooklet	Tela da caderneta de vacinação	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Ficha Familiar > Caderneta de vacinação
voter	Título de eleitor	XPlatform > Gestão de Pessoas | HCM > Admissão Digital > Pré-admissões > Detalhes da pré-admissão > guia Documentos > Título de eleitor

Para criar campos customizados na solução de Admissão Digital Senior, é necessário realizar o login na XPlatform usando uma conta que tenha permissões de administrador.

1. Acesse o menu: Tecnologia > Customização > Campos.
2. Na tela aberta, utilize o box Filtrar domínios para buscar pelo domínio hcm.
3. Ao encontrar o domínio, clique para expandi-lo.
4. Na lista de serviços aberta, localize e clique para expandir o serviço onboarding.
5. Busque a entidade que receberá o campo customizado e em seguida, clique no botão Entidade.
6. Através do botão Novo, você irá adicionar e configurar o campo customizado.
7. Informe o ID do Campo e o Rótulo do Campo.
8. Em Tipo do campo, selecione a opção Blob.
9. Em seguida, clique em Salvar.
10. Uma mensagem de confirmação será apresentada, clique no botão Confirmar para salvar as configurações do campo;
11. Na tela de Entidades, repita o processo: clique em Salvar e, em seguida, Confirmar para finalizar.

Se algum usuário do RH não conseguir anexar arquivos nos campos customizados do tipo Blob, esse comportamento pode estar ocorrendo devido à falta de permissões de visualização e edição nos papéis e permissões do usuário.

1. Para habilitar as permissões aos campos customizados, acesse: Tecnologia > Administração > Autorização > Gestão dos Papéis.
2. Selecione o papel dos usuários que não conseguem anexar os arquivos e clique no botão Editar;
3. Clique em Permissões e filtre pelo serviço field_customization.
4. Clique na seta para expandir o serviço e em seguida, habilite as opções necessárias para os campos customizados.
5. Após, filtre pelo domínio custom / entity e clique para expandir o serviço.
6. Habilite os campos customizados tipo Blob criados.
7. Para finalizar, clique no botão Salvar.

Após esse procedimento, os campos customizados tipo Blob estarão disponíveis para edição dos usuários do papel editado.

Para adicionar ou alterar opções em campos tipo enumeration, é necessário realizar o login na XPlatform usando uma conta que tenha permissões de administrador.

1. Acesse o menu: Tecnologia > Customização > Campos.
2. Na tela aberta, utilize o box Filtrar domínios para buscar pelo domínio hcm.
3. Ao encontrar o domínio, clique para expandi-lo.
4. Na lista de serviços aberta, localize e clique para expandir o serviço onboarding.
5. Busque a entidade onde foi criado o campo customizado do tipo enumeration e em seguida, clique no botão Entidade.
6. Selecione o campo que você deseja inserir novas opções e clique em Editar.
7. Clique em Adicionar e, em seguida, no ícone + para incluir novas opções.
8. Preencha os campos Chave e Valor e clique em Concluir.
9. Em seguida, clique em Salvar.
10. Uma mensagem de confirmação será apresentada, clique no botão Confirmar para salvar as configurações do campo;
11. Na tela de Entidades, repita o processo: clique em Salvar e, em seguida, Confirmar para finalizar.

Para criar campos customizados com acesso restrito ao RH, o campo precisa ser criado na tela de contrato, a qual somente o RH tem acesso.

1. Realize o login na XPlatform usando uma conta que tenha permissões de administrador.
2. Acesse o menu: Tecnologia > Customização > Campos.
3. Na tela aberta, utilize o box Filtrar domínios para buscar pelo domínio hcm.
4. Ao encontrar o domínio, clique para expandi-lo.
5. Na lista de serviços aberta, localize e clique para expandir o serviço onboarding.
6. Busque a entidade inviteModelContract e clique no botão Entidade.
7. Clique em Adicionar e, em seguida, informe os campos ID do Campo e Rótulo do Campo.
8. Selecione o Tipo do campo.
9. Em seguida, clique em Salvar.
10. Uma mensagem de confirmação será apresentada, clique no botão Confirmar para salvar as configurações do campo.
11. Na tela de Entidades, repita o processo: clique em Salvar e, em seguida, Confirmar para finalizar.

Após esse procedimento, o campo customizado criado na entidade inviteModelContract, estará disponível na guia Contrato da pré-admissão, a qual somente o RH possui acesso para cadastros.

1. Realize o login na XPlatform usando uma conta que tenha permissões de administrador.
2. Acesse o menu: Tecnologia > Customização > Campos.
3. Na tela aberta, utilize o box Filtrar domínios para buscar pelo domínio hcm.
4. Ao encontrar o domínio, clique para expandi-lo.
5. Na lista de serviços aberta, localize e clique para expandir o serviço onboarding.
6. Busque a entidade inviteModelContract e clique no botão Entidade.
7. Clique em Adicionar e, em seguida, informe os campos ID do Campo e Rótulo do Campo.
8. Selecione o Tipo do campo.
9. Em seguida, clique em Salvar.
10. Uma mensagem de confirmação será apresentada, clique no botão Confirmar para salvar as configurações do campo.
11. Na tela de Entidades, repita o processo: clique em Salvar e, em seguida, Confirmar para finalizar.

Após a confirmação, o campo aparecerá disponível para ser cadastrado na tela de contrato.

Seguindo o mesmo passo a passo, é possível criar outros campos na mesma entidade ou em outras entidades na Admissão Digital. Com a criação dos campos customizados e o cadastro das informações correspondentes, esses dados também estarão disponíveis como campos automáticos.

1. Realize o login na XPlatform usando uma conta que tenha permissões de administrador.
2. Acesse o menu: Tecnologia > Customização > Campos.
3. Na tela aberta, utilize o box Filtrar domínios para buscar pelo domínio hcm.
4. Ao encontrar o domínio, clique para expandi-lo.
5. Na lista de serviços aberta, localize e clique para expandir o serviço onboarding.
6. Busque a entidade Company e clique no botão Entidade.
7. Clique em Adicionar e, em seguida, informe os campos ID do Campo e Rótulo do Campo.
8. Selecione o Tipo do campo.
9. Em seguida, clique em Salvar.
10. Uma mensagem de confirmação será apresentada, clique no botão Confirmar para salvar as configurações do campo.
11. Na tela de Entidades, repita o processo: clique em Salvar e, em seguida, Confirmar para finalizar.

Após a confirmação, o campo aparecerá disponível para ser cadastrado na tela de empresas.

Seguindo o mesmo passo a passo, é possível criar outros campos na mesma entidade ou em outras entidades na Admissão Digital. Com a criação dos campos customizados e o cadastro das informações correspondentes, esses dados também estarão disponíveis como campos automáticos.

1. Realize o login na XPlatform usando uma conta que tenha permissões de administrador.
2. Acesse o menu: Tecnologia > Customização > Campos.
3. Na tela aberta, utilize o box Filtrar domínios para buscar pelo domínio hcm.
4. Ao encontrar o domínio, clique para expandi-lo.
5. Na lista de serviços aberta, localize e clique para expandir o serviço onboarding.
6. Busque a entidade branchOffice e clique no botão Entidade.
7. Clique em Adicionar e, em seguida, informe os campos ID do Campo e Rótulo do Campo.
8. Selecione o Tipo do campo.
9. Em seguida, clique em Salvar.
10. Uma mensagem de confirmação será apresentada, clique no botão Confirmar para salvar as configurações do campo.
11. Na tela de Entidades, repita o processo: clique em Salvar e, em seguida, Confirmar para finalizar.

Após a confirmação, o campo aparecerá disponível para ser cadastrado na tela de empresas.

Seguindo o mesmo passo a passo, é possível criar outros campos na mesma entidade ou em outras entidades na Admissão Digital. Com a criação dos campos customizados e o cadastro das informações correspondentes, esses dados também estarão disponíveis como campos automáticos.