Introdução

Este tutorial explica as etapas para gerar e editar arquivos de mapeamento específicos do objeto de negócios que podem ser importados para o Oracle Integration Cloud (OIC) para transformar dados na forma de arquivo do objeto de negócios do Carregador de Dados do HCM.

Objetivos

Neste tutorial, você vai:

  • Ative a geração de arquivos de mapeamento.
  • Gerar arquivos de mapeamento genéricos e personalizados.
  • Edite os arquivos de mapeamento gerados.

Pré-requisitos

Para concluir as etapas deste tutorial, você precisará acessar:

  • A tarefa Configurar Carregador de Dados do HCM para ativar a geração do arquivo de mapeamento.
  • A tarefa Exibir Objetos de Negócios para gerar arquivos de mapeamento genéricos.
  • Carregador de Dados do HCM para importar arquivos de teste e gerar arquivos de mapeamento personalizados.

Para obter as etapas de configuração desse acesso, consulte o tutorial Configurar Acesso ao Carregador de Dados do HCM (HDL) e Compreender Opções de Segurança do HDL.


Tarefa 1: Ativar Geração de Arquivo de Mapeamento

Nesta etapa, você ativará a geração de arquivos de mapeamento OIC no Carregador de Dados do HCM.

Há dois métodos para gerar arquivos de mapeamento:

  • Gerar arquivos de objeto de negócios genéricos completos.

    Use a tarefa Exibir Objetos de Negócios para gerar e fazer download de arquivos de mapeamento que descrevem hierarquias completas de objetos de negócios.

  • Gerar arquivos de objeto de negócios personalizados.

    Importe e carregue arquivos de teste para confirmar a forma do arquivo ao gerar um arquivo de mapeamento na forma do arquivo importado.

Para ativar a geração de arquivos de mapeamento:

  1. Faça log-in no aplicativo Oracle HCM Cloud.
  2. Navegue até Minha Empresa > Configuração e Manutenção.
  3. Selecione a área funcional Carregador de Dados do HCM.
  4. Clique na tarefa Configurar Carregador de Dados do HCM.
    5. Clique na tarefa Carregador de Dados do HCM na área funcional do Carregador de Dados do HCM.

  5. Procure o parâmetro Gerar Arquivos do Mapeamento do Objeto de Negócios.
    6. Use o campo Consulta por Exemplo para procurar o parâmetro.

  6. Defina Substituir como Sim.

    7. Há duas opções de Substituição disponíveis ao ativar a geração de arquivos de mapeamento:

    Valor de Substituição Descrição
    Somente Personalizadas Permite gerar arquivos de mapeamento para arquivos de dados do objeto de negócios que você carrega com o Carregador de Dados do HCM.
    Sim Permite que arquivos de mapeamento genéricos sejam gerados a partir da tarefa Exibir Objetos de Negócios, além de arquivos personalizados.

  7. Clique em Salvar.

Dica:

Para obter mais informações, procure Gerar Arquivos de Mapeamento do Objeto de Negócios no tópico Parâmetros de Configuração do Carregador de Dados do HCM.


Tarefa 2: Gerar Arquivos de Mapeamento Completos

Nesta etapa, você gerará um arquivo de mapeamento para uma hierarquia completa de objetos de negócios.

  1. Faça log-in no aplicativo Oracle HCM Cloud.
  2. Navegue até Meus Grupos de Clientes > Troca de Dados > Exibir Objetos de Negócios.
  3. Procure e selecione o objeto de negócios Registro de Documento e clique em Atualizar Objeto.
    4. Use a consulta por exemplo para procurar o Document Recor e clique em Atualizar Objeto

  4. Atualize o conteúdo da tabela até que a coluna Arquivo de Mapeamento de Integração exiba um ícone de arquivo de download para o objeto de negócios Registro de Documento.
    5. Atualize a tabela até que o ícone do arquivo de download apareça para o objeto Registro de Documento.

  5. Clique no ícone de download do arquivo, o arquivo de mapeamento será baixado.

Observação:

Você editará esse arquivo na Tarefa 4.


Tarefa 3: Gerar Arquivos de Mapeamento Personalizados

Esta é a abordagem recomendada para gerar arquivos de mapeamento para o OIC. Primeiro, crie um arquivo do Carregador de Dados do HCM na forma em que deseja que a integração do OIC gere arquivos. Isso tem a vantagem de testar se a forma do arquivo HDL está correta antes de criar sua integração.

  1. Definir um arquivo de objeto de negócio HDL. Você pode fazer download do arquivo Mapeamento de Colaborador File.zip para fins deste tutorial.
  2. Faça log-in no aplicativo Oracle HCM Cloud.
  3. Navegue até Meus Grupos de Clientes > Troca de Dados > Importar e Carregar Dados.
  4. Clique em Importar Arquivo.
  5. Arraste o Mapeamento do Colaborador File.zip baixado para o botão Escolher Arquivo e clique em Revisar Parâmetros.
    6. Selecione o arquivo de origem e clique em Review Parameters

  6. Marque a caixa de seleção Gerar Arquivo do Mapeamento do Objeto de Negócios.
    7. Marque a caixa de seleção Gerar Arquivo do Mapeamento do Objeto de Negócios

  7. Clique em Submeter.
  8. Clique em OK para descartar a janela de confirmação Submetido.
  9. Atualize a tabela Conjuntos de Dados até que seu arquivo de teste seja visto.
  10. Ocasionalmente, atualize a tabela Objetos de Negócios do seu conjunto de dados até que a Importação seja concluída.
  11. Clique em Fazer Download do Arquivo de Mapeamento na barra de ferramentas da tabela Objetos de Negócios para fazer download do arquivo de mapeamento personalizado.

    Este botão é ativado quando o arquivo do objeto de negócios é importado.

    12. Clique no botão Fazer Download do Arquivo de Mapeamento

Dica:

Se você tiver algum erro de importação, é provável que a forma do arquivo esteja incorreta. Verifique e corrija os erros e faça download do arquivo de mapeamento somente quando tiver importado com êxito o arquivo de teste.


Tarefa 4: Editando Arquivos de Mapeamento

É possível editar os arquivos de mapeamento gerados pelo Carregador de Dados do HCM. Nessa tarefa, você editará o arquivo de mapeamento de Registro de Documento gerado na Tarefa 2.

Compreender a Forma do Arquivo

  1. Abra o arquivo DocumentsOfRecord.nxsd gerado na Tarefa 2.
  2. Verifique o conteúdo do arquivo. Todos os arquivos de mapeamento seguem a mesma estrutura; há 3 tipos de grupos de elementos:
    • Grupo ObjectFileData

      Haverá um grupo ObjectFileData, encontrado na parte superior do arquivo. Para cada objeto de negócios na hierarquia, esse grupo inclui um elemento ObjectLabel e um elemento Objeto:

      • O elemento ObjectLabel define a linha METADATA.
      • O elemento Objeto define a linha MERGE (dados).

      Dica:

      A formatação das linhas também é definida.

    • Grupo ObjectLabel

      Há um grupo ObjectLabel para cada objeto de negócios na hierarquia de objetos. O grupo ObjectLabel inclui elementos para definir os nomes dos atributos disponíveis para o objeto de negócios. Quando o OIC gera um arquivo usando esse mapeamento, os nomes de atributo (e os terminadores) são anexados ao elemento ObjectLabel definido no grupo ObjectFileData acima.

    • Grupo Objeto

      Há um grupo de Objetos para cada objeto de negócios na hierarquia de objetos. O grupo de Objetos inclui elementos para mapear os valores dos atributos disponíveis para o objeto de negócios. Quando o OIC gera um arquivo usando esse mapeamento, os valores de atributo (e terminadores) são anexados ao elemento do Objeto definido no grupo ObjectFileData acima.

  3. Revise o grupo ObjectFileData DocumentOfRecordFileData.

    4. A hierarquia de objetos de negócios DocumentsOfRecord tem dois objetos: DocumentOfRecord e DocumentAttachment. Um elemento ObjectLabel e um elemento de Objeto são gerados para cada objeto de negócios na hierarquia:


  4. Revise o grupo ObjectLabel DocumentOfRecordsLabel.

    5. Este grupo inclui um elemento para definir o nome de cada atributo disponível para o objeto de negócios DocumentsOfRecord, incluindo qualquer atributo de segmento de flexfield implantado.


    Observação:

    O grupo completo é muito grande para ser exibido aqui.
  5. Revise o grupo de Objetos DocumentOfRecord.

    6. Este grupo inclui um elemento para mapear os valores de cada atributo disponível para o objeto de negócios DocumentsOfRecord.


    Dica:

    A ordem dos atributos no ObjectLabel e nos grupos de Objetos do mesmo objeto de negócios deve corresponder.
  6. Revise o grupo ObjectLabel DocumentAttachmentLabel.

    7. Este grupo inclui um elemento para definir o nome de cada atributo disponível para o objeto de negócios DocumentAttachment.


  7. Revise o grupo de Objetos DocumentAttachment.

    8. Este grupo inclui um elemento para mapear os valores de cada atributo disponível para o objeto de negócios DocumentAttachment.


Editar a Forma DocumentOfRecord

O OIC exige que você forneça um valor para cada atributo definido pelos elementos no arquivo de mapeamento. Se você não precisar de atributos no arquivo HDL gerado, remova os dois elementos do atributo dos grupos ObjectLabel e de Objetos.

  1. Exclua os elementos dos grupos DocumentsOfRecordLabel e DocumentsOfRecord para todos os atributos, exceto estes:
    • DocumentName
    • DocumentCode
    • PersonNumber
    • DocumentType
  2. Reordene os elementos nesses grupos para que eles apareçam nesta ordem de atributo:
    • PersonNumber
    • DocumentType
    • DocumentCode
    • DocumentName

    Observação:

    O último elemento do grupo tem um valor terminatedBy diferente. A maioria dos elementos é terminada pelo caractere pipe, o último é terminado por um caractere de fim de linha. Ao editar o arquivo, certifique-se de que o último elemento em cada grupo tenha o terminador de fim de linha.

    Dica:

    A ordem dos elementos nesses grupos determina a ordem em que os atributos são incluídos no arquivo gerado pelo OIC. Por exemplo, essa estrutura gerará esta linha METADATA: 
    METADATA|DocumentsOfRecord|PersonNumber|DocumentType|DocumentCode|DocumentName

Editar a Forma DocumentAttachment

  1. Exclua os elementos dos grupos DocumentAttachmentLabel e DocumentAttachment para todos os atributos, exceto estes:
    • Cargo
    • Arquivo
    • DataTypeCode
    • DocumentCode
    • PersonNumber
    • DocumentType
    • URLorTextorFileName
  2. Reordene os elementos nesses grupos para que eles apareçam nesta ordem de atributo:
    • PersonNumber
    • DocumentType
    • DocumentCode
    • DataTypeCode
    • URLorTextorFileName
    • Cargo
    • Arquivo

    Isso gerará esta linha METADATA: 

    METADATA|DocumentAttachment|PersonNumber|DocumentType|DocumentCode|DataTypeCode|URLorTextorFileName|Title|File

Agora você pode importar seu arquivo para o OIC para gerar um arquivo HDL DocumentOfRecord.dat.

Observação:

Você poderá remover definições inteiras de objetos de negócios de seus arquivos de mapeamento gerados se não precisar fornecer dados para eles. Para fazer isso, certifique-se de remover os grupos de ObjectLabel e Objeto do objeto de negócios, além dos elementos de ObjectLabel e Objeto do grupo ObjectFileData.

Adicionando instruções SET à forma do seu arquivo

Talvez seja necessário incluir instruções SET no arquivo do objeto de negócios. A maneira mais simples de fazer isso é editar o nxsd para criar um elemento que permita definir as instruções SET no seu mapeamento OIC.

Nesta etapa, você editará o Worker.nxsd gerado na Tarefa 3.

  1. Abra o arquivo Worker.nxsd que você gerou na Tarefa 3 em um editor de texto.

    2. O elemento WorkerFileData deve ter esta aparência:


  2. Edite este elemento para introduzir uma entrada de referência antes da referência WorkerLabel. Adicionar: 
    3. <element ref="tns:SetInstructions" minOccurs="0" nxsd:startsWith="">
  3. Crie um novo elemento SetInstructions imediatamente abaixo do elemento WorkerFileData:
    4. <!-- SetInstructions -->
  <element name="SetInstructions">
      <complexType>
         <sequence>
            <element name="Instruction" type="string" nxsd:style="terminated" nxsd:terminatedBy="${eol}" />
         </sequence>
      </complexType>
   </element>

    Dica:

    Isso dá suporte a uma instrução SET. Crie elementos adicionais, como Instruction1, Instruction2, se precisar definir várias instruções de SET no arquivo a ser gerado pelo OIC.


Próximas Etapas

Siga as etapas deste tutorial para gerar um arquivo de mapeamento que o OIC usa para gerar seus dados de origem na forma de arquivo de objeto de negócios do Carregador de Dados do HCM.

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.