Introdução

O objeto de negócios Colaborador é complexo com cerca de 30 componentes na hierarquia de objetos. Este tutorial não tenta cobrir todos os componentes disponíveis deste objeto complexo, mas fornece orientação sobre as regras que você precisa seguir ao fazer upload de novas contratações.

Ao criar uma nova admissão, você deve fornecer dados para estes componentes da hierarquia de objetos Colaborador:

  • Auxiliar
  • PersonName
  • WorkRelationship
  • WorkTerms
  • Designação

É recomendável que você também forneça PersonLegislativeData. Se você não fornecê-lo, um registro de dados legais será gerado automaticamente, com uma chave de origem gerada automaticamente.

Observação:

Espera-se que você entenda as chaves de origem e saiba como carregar arquivos usando o carregador de Dados do HCM (HDL). Se você é novo no HDL, deverá concluir primeiro o tutorial Criar e Manter Dados com o Carregador de Dados do HCM (HDL).

Objetivos

Neste tutorial, você vai:

  • Crie e carregue um arquivo Worker.dat do Carregador de Dados do HCM para carregar novas admissões.
  • Entenda as regras específicas para carregar novas admissões.

Pré-requisitos

Para concluir este tutorial, você precisará de:

Tarefa 1: Criar o Proprietário do Sistema de Origem

Antes de carregar um arquivo que usa chaves de origem, primeiro você deve registrar o valor do proprietário do sistema de origem.

  1. No aplicativo, clique no seu nome de usuário e clique em Configuração e Manutenção.
    2. Clique em Import File

  2. Clique no ícone da gaveta lateral e clique em Pesquisar.
    3. Arquivo de importação de retirada

  3. Pesquise e selecione a tarefa Gerenciar Consultas Comuns.
  4. Procure o Tipo de Pesquisa HRC_SOURCE_SYSTEM_OWNER.
  5. Clique no ícone Adicionar na tabela Lookup Codes.
    6. Arquivo de importação de retirada

  6. Especifique EMP no código de consulta e significado, especifique uma Data Inicial de 01/01/2000.
  7. Clique em Salvar.

Tarefa 2: Criar o Arquivo de Colaborador

Nesta etapa, você criará um arquivo Worker.dat contendo registros para os componentes obrigatórios e recomendados da hierarquia de objetos do Colaborador.

Hierarquia de objetos do colaborador criada neste tutorial

Auxiliar

O componente Colaborador identifica o colaborador com o Número da Pessoa e a Data de Nascimento.

Crie um novo arquivo e adicione estas linhas de arquivo: 

METADATA|Worker|SourceSystemOwner|SourceSystemId|EffectiveStartDate|PersonNumber|StartDate|DateOfBirth|ActionCode
MERGE|Worker|EMP|HDL001|2001/09/08|HDL-1001|2001/09/08|1952/05/21|HIRE
MERGE|Worker|EMP|HDL002|2005/02/08|HDL-1002|2005/02/08|1966/04/21|HIRE

Neste exemplo:

  • Cada registro Colaborador é identificado exclusivamente por uma chave de origem usando os atributos SourceSystemOwner e SourceSystemId. Por exemplo, EMP e HDL001, EMP e HDL002.
  • O atributo PersonNumber é a chave do usuário e também é fornecido, mas se você estiver gerando números de pessoas automaticamente, não precisará fornecê-los.

    • Dica:

    Se você estiver gerando números automaticamente, o fornecimento de uma chave de origem se tornará obrigatório, pois o atributo de chave do usuário, PersonNumber, não poderá ser fornecido.
  • Um ActionCode de HIRE é necessário para novas contratações.
  • O valor de EffectiveStartDate deve corresponder ao valor StartDate ao criar novas admissões.

Nome da Pessoa

O componente PersonName registra o nome do seu funcionário.

Adicione estas linhas de arquivo ao arquivo: 

METADATA|PersonName|SourceSystemOwner|SourceSystemId|EffectiveStartDate|PersonId(SourceSystemId)|NameType|LegislationCode|Title|LastName|FirstName
MERGE|PersonName|EMP|HDL001_NME|2001/09/08|HDL001|GLOBAL|US|MR.|Wells|Christopher
MERGE|PersonName|EMP|HDL002_NME|2005/02/08|HDL002|GLOBAL|US|MRS.|Hugh|Lorraine

Neste exemplo:

  • Cada registro PersonName é identificado exclusivamente por uma chave de origem usando os atributos SourceSystemOwner e SourceSystemId. Por exemplo, EMP, HDL001_NME.
  • Para identificar o registro do Colaborador ao qual cada PersonName se destina, o ID do sistema de origem é fornecido ao atributo de ID substituto pai PersonId com a dica (SourceSystemId). Por exemplo, HDL001 ou HDL002.

    • Dica:

    Como o registro PersonName local e o registro Worker pai usam o mesmo proprietário do sistema de origem, o proprietário do sistema de origem pai pode herdar seu valor do atributo SourceSystemOwner local.
  • O LegislationCode determina os valores válidos para o atributo Título, portanto, se você alterar o código da legislação, talvez precise alterar o valor do atributo Título.

    • Dica:

    Use a tarefa Exibir Objetos de Negócios para localizar o tipo de consulta usado para validar os atributos validados pela consulta.
  • O valor de EffectiveStartDate no registro PersonName deve corresponder ao do registro Colaborador para novas admissões.

Dados Legais da Pessoa

O componente PersonLegislativeData é onde você captura o estado civil e o sexo do funcionário.

Adicione estas linhas de arquivo ao seu arquivo: 

METADATA|PersonLegislativeData|SourceSystemOwner|SourceSystemId|EffectiveStartDate|PersonId(SourceSystemId)|LegislationCode|Sex|MaritalStatus
MERGE|PersonLegislativeData|EMP|HDL001_LEG|2001/09/08|HDL001|US|M|M
MERGE|PersonLegislativeData|EMP|HDL002_LEG|2005/02/08|HDL002|US|F|S

Neste exemplo:

  • Cada registro PersonLegislativeData é identificado exclusivamente por uma chave de origem. Por exemplo, EMP, HDL001_LEG.
  • O registro pai é Colaborador, portanto, você faz referência ao registro pai da mesma maneira que para PersonName, usando o atributo PersonId(SourceSystemId).
  • O LegislationCode determina os valores válidos para os atributos Sex e MaritalStatus.
  • O valor de EffectiveStartDate no registro PersonLegislativeData deve corresponder ao do registro Colaborador para novas admissões.

Relação de Trabalho

O componente WorkRelationship especifica o empregador legal de seu funcionário.

Adicione estas linhas de arquivo ao arquivo: 

METADATA|WorkRelationship|SourceSystemOwner|SourceSystemId|PersonId(SourceSystemId)|LegalEmployerName|DateStart|WorkerType|PrimaryFlag
MERGE|WorkRelationship|EMP|HDL001_POS|HDL001|Vision Corporation|2001/09/08|E|Y
MERGE|WorkRelationship|EMP|HDL002_POS|HDL002|Vision Corporation|2005/02/08|E|Y

Neste exemplo:

  • Cada registro WorkRelationship é identificado exclusivamente por uma chave de origem. Por exemplo, EMP, HDL001_POS.
  • O registro pai ainda é o registro do Colaborador, portanto, você faz referência ao registro pai usando o atributo PersonId(SourceSystemId).
  • O valor do atributo DateStart deve corresponder ao StartDate fornecido no registro de Colaborador pai para novas contratações.

Dica:

Você precisará alterar o valor LegalEmployerName da Vision Corporation com um empregador legal disponível em seu banco de dados.

Condições do Emprego

As Condições de Emprego não estão mais visíveis no Oracle HCM, mas você ainda precisa fornecer um registro WorkTerms esqueleto para vincular os registros WorkRelationship e Atribuição.

Adicione estas linhas de arquivo ao arquivo: 

METADATA|WorkTerms|SourceSystemOwner|SourceSystemId|PeriodOfServiceId(SourceSystemId)|ActionCode|EffectiveStartDate|EffectiveSequence|EffectiveLatestChange|AssignmentName|AssignmentNumber|PrimaryWorkTermsFlag
MERGE|WorkTerms|EMP|HDL001_TRM|HDL001_POS|HIRE|2001/09/08|1|Y|ET-HDL001|ET-HDL001|Y
MERGE|WorkTerms|EMP|HDL002_TRM|HDL002_POS|HIRE|2005/02/08|1|Y|ET-HDL002|ET-HDL002|Y

Neste exemplo:

  • Cada registro WorkTerms é identificado exclusivamente por uma chave de origem. Por exemplo, EMP, HDL001_TRM.
  • O pai do WorkTerms é o WorkRelationship, o registro pai é identificado pelo atributo PeriodOfServiceId. A dica SourceSystemId é adicionada para que você possa fornecer a chave de origem para identificar a relação de trabalho pai.
  • Como o registro de relação de trabalho pai e o registro de condições de emprego local usam o mesmo proprietário do sistema de origem, ambas as referências usam o mesmo atributo SourceSystemOwner.
  • O valor EffectiveStartDate deve corresponder ao valor do registro WorkRelationship.

Observação:

Você só precisa fornecer os atributos obrigatórios ao carregar o registro de condições de trabalho. O nível, o local, o departamento etc. agora são preenchidos apenas no componente Atribuição.

Designação

O tipo de registro Atribuição é o local em que você especifica o departamento, o local, a posição, o cargo de seu funcionário, etc.

Adicione estas linhas de arquivo ao arquivo: 

METADATA|Assignment|SourceSystemOwner|SourceSystemId|ActionCode|EffectiveStartDate|EffectiveSequence|EffectiveLatestChange|WorkTermsAssignmentId(SourceSystemId)|AssignmentName|AssignmentNumber|AssignmentStatusTypeCode|PersonTypeCode|BusinessUnitShortCode|PrimaryAssignmentFlag|JobId(SourceSystemId)|JobId(SourceSystemOwner)
MERGE|Assignment|EMP|HDL001_ASG|HIRE|2001/09/08|1|Y|HDL001_TRM|HDL001|HDL001|ACTIVE_PROCESS|Employee|Vision Operations|Y|SCN|VISION
MERGE|Assignment|EMP|HDL002_ASG|HIRE|2005/02/08|1|Y|HDL002_TRM|HDL002|HDL002|ACTIVE_PROCESS|Employee|Vision Operations|Y|MGR|VISION

Neste exemplo:

  • Cada registro de Atribuição é identificado exclusivamente por uma chave de origem. Por exemplo, EMP, HDL001_ASG.
  • O pai da Atribuição é o WorkTerms, o registro pai é identificado pelo atributo WorkTermsAssignmentId. Usando a dica SourceSystemId, você pode usar a chave de origem para identificar o registro WorkTerms pai.
  • O Job também é referenciado por sua chave de origem, mas como tem um valor de proprietário do sistema de origem diferente, ele não pode usar o valor fornecido para o atributo SourceSystemOwner.

    Para especificar um proprietário de sistema de origem diferente para uma referência de objeto externo, adicione a dica SourceSystemOwner ao atributo que identifica o objeto externo, ou seja, JobId(SourceSystemOwner).

    • Dica:

    Os cargos mencionados neste exemplo são criados pelo tutorial Criar e Manter Dados com o Carregador de Dados do HCM (HDL).
  • O valor EffectiveStartDate deve corresponder ao valor do registro WorkTerms.

Dica:

Você precisará alterar o valor BusinessUnitShortCode de Operações Vision com uma unidade de negócios disponível no seu banco de dados.

Dica:

Você pode usar essas etapas para estender esse arquivo para incluir outros componentes da hierarquia do Colaborador, como PersonEmail.

Tarefa 3: Salvar e Carregar Seu Arquivo

  1. Salve seu arquivo, nomeando-o como Worker.dat. Como alternativa, faça download do arquivo Worker.dat e edite-o.
  2. Compacte (zip) o Worker.dat em um nome de arquivo de sua escolha, mas ele deve ter uma extensão de arquivo .zip.
  3. Carregue seu arquivo usando o Carregador de Dados do HCM.

Próximas Etapas

Os tutoriais a seguir expandirão ainda mais seu conhecimento sobre o Carregador de Dados do HCM:

Os tutoriais mais recentes para HDL e HSDL são publicados neste tópico no Cloud Customer Connect:

Para obter mais informações, consulte estes tópicos de ajuda:

Agradecimentos

  • Autores - Ema Johnson (Gerente Sênior de Produtos)

Mais Recursos de Aprendizagem

Explore outros laboratórios em docs.oracle.com/learn ou acesse mais conteúdo de aprendizado gratuito no canal do Oracle Learning YouTube. Além disso, acesse education.oracle.com/learning-explorer para se tornar um Oracle Learning Explorer.

Para obter a documentação do produto, visite o Oracle Help Center.