Introdução

Ao definir integrações usando o Oracle Integration Cloud (OIC), há tarefas de configuração a serem executadas. Este tutorial aborda a configuração típica necessária para integrações que usam o HCM Data Loader (HDL) para manter o Oracle HCM Cloud.

Objetivos

Neste tutorial, você:

  • Crie funções e contas de usuário para acessar a funcionalidade do Carregador de Dados do HCM.
  • Crie as conexões OIC necessárias para um servidor FTP para a integração do Oracle HCM Cloud.

Pré-requisitos

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

  • OIC (Oracle Integration Cloud).
  • Console de Segurança para criar atribuições personalizadas e contas de usuário.
  • A tarefa Acesso ao Objeto de Negócios do Carregador de Dados do HCM para configurar os objetos de negócios para os quais suas contas de usuário HDL podem carregar dados em massa.

    Essas hierarquias de função fornecem este acesso:

    Nome da Atribuição Código da Atribuição Acesso Concedido
    Gerenciar Acesso ao Objeto do Negócio do Carregador de Dados HCM HRC_MANAGE_HDL_BO_ACCESS_PRIV Tarefa de Acesso ao Objeto Comercial do Carregador de Dados HCM
    Usuário de Configurações Funcionais ORA_ASM_FUNCTIONAL_SETUPS_USER_ABSTRACT Configuração e manutenção

Observação:

Este tutorial pressupõe que você ativou o objeto de negócios baseado em função para HDL. Consulte Tarefa 1 do tutorial Configurar Acesso ao Carregador de Dados do HCM (HDL) e Entender as Opções de Segurança do HDL para ativar essa funcionalidade.

Para criptografar arquivos no OIC, conclua as etapas na Tarefa 5 do tutorial Configurar Acesso ao Carregador de Dados do HCM (HDL) e Entender as Opções de Segurança do HDL para gerar o certificado PGP fusion-key e extrair a chave pública.

Atenção:

É recomendável criptografar todos os arquivos antes de fazer upload deles no Oracle WebCenter. Qualquer usuário com acesso à conta hcm$/dataloader$/import$ pode fazer download de qualquer arquivo colocado lá.


Tarefa 1: Definir Contas de Usuário do Carregador de Dados do HCM

Há três contas de usuário a serem consideradas ao criar integrações do OIC com o Carregador de Dados do HCM.

  • Uma conta de desenvolvimento para testar a forma do seu arquivo HDL e gerar arquivos de mapeamento.
  • Uma conta de usuário para sua conexão do Oracle WebCenter Content que só tem acesso à conta de importação do Carregador de Dados do HCM.
  • Uma conta de usuário para sua conexão REST do Carregador de Dados do HCM que só tem acesso à API REST do HDL e está configurada para fazer upload apenas de dados para os objetos de negócios que a integração mantém.

Esta tarefa descreve como criar essas contas.

Dica:

Consulte o tutorial Configurar Acesso ao Carregador de Dados do HCM (HDL) e Entender as Opções de Segurança do HDL para obter orientação mais detalhada sobre a criação de funções HDL e a atribuição de acesso ao objeto de negócios.

Conta de Desenvolvimento

Você usará essa conta para iniciar o Carregador de Dados do HCM para testar a forma do arquivo e gerar arquivos de mapeamento do OIC.

Observação:

Essa conta só será necessária em seu ambiente de desenvolvimento no qual você configura e testa suas integrações.
  1. Adicionar estas hierarquias de atribuição:
    2. Nome da Atribuição Código da Atribuição Concede Acesso a
    Carregamento de Dados do HCM ORA_HRC_HCM_DATA_LOAD_DUTY Tarefas do Carregador de Dados do HCM na área de trabalho Intercâmbio de Dados.
    Fazer upload dos dados para Importação baseada no arquivo do Human Capital Management HCM_DATALOADER_IMPORT_RWD O diretório hcm/dataloader/import no servidor do Oracle WebCenter Content.
    Fazer download dos dados na Exportação baseada no arquivo do Human Capital Management HCM_DATALOADER_EXPORT_RWD O diretório hcm/dataloader/export no servidor do Oracle WebCenter Content. Necessário para exportar arquivos de erro.

  2. Use a tarefa Acesso ao Objeto de Negócios do Carregador de Dados do HCM em Configuração e Manutenção para conceder acesso aos objetos de negócios aos quais o usuário de desenvolvimento precisa ter acesso. Pode ser Todos os objetos de negócios.

Conta HDL do Oracle WebCenter Content

Essa conta só terá acesso à conta hcm$/dataloader$/import$ no Oracle WebCenter Content Server. Essa conta será usada para definir a Conexão do Oracle WebCenter HDL que pode ser usada por todas as suas integrações do Carregador de Dados do HCM. Você criará essa conexão na Tarefa 4.

  1. Crie uma função com a seguinte hierarquia de funções:
    2. Nome da Atribuição Código da Atribuição Concede Acesso a
    Fazer upload dos dados para Importação baseada no arquivo do Human Capital Management HCM_DATALOADER_IMPORT_RWD O diretório hcm/dataloader/import no servidor do Oracle WebCenter Content.

  2. Crie uma conta de usuário, como HDL_UPLOAD_FILE, e conceda acesso a essa função de job.

Conta REST de HDL

É recomendável criar contas individuais para cada integração do Carregador de Dados do HCM para garantir que a conta do usuário só tenha acesso aos objetos de negócios que eles precisam manter. Crie uma conta que terá acesso a:

  • API REST do Carregador de Dados do HCM.
  • A ação personalizada createFileDataSet na API REST do Carregador de Dados do HCM.
  • A conta hcm$/dataloader$/import$ do Oracle WebCenter necessária para ler o arquivo que está sendo submetido a upload.
  • Os objetos de negócios específicos da integração.

Execute estas etapas:

  1. Siga as etapas abaixo do cabeçalho Acesso REST na Tarefa Dois do tutorial Configurar Acesso ao Carregador de Dados do HCM (HDL) e Compreender Opções de Segurança do HDL para criar uma função com acesso REST do HDL.
  2. Use a tarefa Acesso ao Objeto de Negócios do Carregador de Dados do HCM em Configuração e Manutenção para conceder acesso aos objetos de negócios que sua integração é responsável pela manutenção.

    Dica:

    Se estiver usando o Redwood, essa interface de usuário agora estará disponível na área de trabalho Intercâmbio de Dados.
  3. Crie uma conta de usuário com o nome da sua integração e conceda acesso a esta função de cargo.

Você usará essa conta para criar a conexão REST do Carregador de Dados do HCM na Tarefa 5 deste tutorial.


Tarefa 2: Importar a Chave de Criptografia para o OIC

O Carregador de Dados do HCM usa a chave privada do certificado PGP fusion-key para decriptografar arquivos criptografados enviados para importação.

Observação:

É recomendável criptografar todos os arquivos antes de fazer upload deles no Oracle WebCenter. Qualquer usuário com acesso à conta hcm$/dataloader$/import$ pode fazer download de qualquer arquivo colocado lá.

Esta etapa importa a chave pública do certificado PGP fusion-key para o OIC, para que você possa criptografar arquivos transformados prontos para processamento pelo HDL.

  1. Faça login no OIC.
  2. Navegue até Definições > Certificados.
  3. Clique em Fazer Upload. A página Fazer Upload de Certificado é exibida.
  4. Especifique um nome, como fusion-key-pub e, opcionalmente, forneça uma descrição para o certificado.
  5. Especifique um Tipo de PGP (Criptografia e Decriptografia).
  6. Use o botão Procurar para selecionar o arquivo público de chave do Fusion que você baixou na Console de Segurança.
  7. Especifique valores para as perguntas restantes.
    8. Clique no botão Gerar em nível de página.

  8. Clique em Fazer Upload

    9. Dica:

    Este certificado será listado quando você executar a ação do arquivo de preparação Criptografar Arquivo no OIC.


Tarefa 3: Definir uma Conexão FTP para Ler Arquivos de Origem

Nesta tarefa, você definirá uma conexão FTP no OIC que pode ser usada para ler e descriptografar arquivos de origem de um servidor FTP externo.

Dica:

Estas etapas descrevem uma conexão FTP com uma chave privada PGP para decriptografar arquivos de origem. Outras opções de criptografia estão disponíveis.
  1. Faça login no OIC e navegue até Design > Conexões.
  2. Clique em Criar.
  3. Procure e selecione FTP na página Criar conexão.
    4. Pesquisar FTP.

  4. Especifique um nome e, opcionalmente, uma descrição. Clique em Criar.
    5. Especifique um nome e uma descrição

  5. Especifique o Endereço do Host do Servidor FTP e defina a Porta do Servidor FTP como 21 para FTP.
  6. Defina a Política de Segurança e forneça o nome do usuário e as informações de acesso à conta.
    7. Especifique os detalhes da conexão.

  7. Se seus arquivos de origem forem criptografados por PGP, você precisará especificar a chave privada para decriptografia de arquivo.
    • Expanda a seção Segurança Opcional.
    • Clique no ícone Fazer Upload à direita do campo Chave Privada PGP.
      • Faça upload do arquivo de chave privada
    • Selecione o arquivo de chave privada e clique em Fazer Upload.
      • Fazer upload do arquivo.
    • Especifique a senha da sua chave privada no campo Senha da Chave Privada PGP.
  8. Clique em Teste.
  9. Salve sua conexão.


Tarefa 4: Definir a Conexão do Oracle WebCenter

Essa conexão pode ser usada por todas as suas integrações de HDL para fazer upload de arquivos HDL para o servidor do Oracle WebCenter Content, pronto para que o HDL os processe.

Antes de criar esta conexão, certifique-se de ter uma conta de usuário que tenha acesso à conta de importação de arquivos do Carregador de Dados do HCM hcm$/dataloader$/import$. As etapas para criar esse usuário são fornecidas na Tarefa 1.

  1. Faça login no OIC e navegue até Design > Conexões.
  2. Clique em Criar.
  3. Procure o HCM e selecione o adaptador do Oracle HCM Cloud.
    4. Pesquisar HCM.

  4. Especifique um Nome de Importação de HDL do Oracle WebCenter. O identificador será gerado automaticamente.
    5. Especifique um nome e uma descrição

  5. Defina Função como Chamar e, opcionalmente, especifique uma Descrição.
  6. Clique em Criar.
  7. Especifique o Host do HCM Cloud com o URL do seu ambiente.
  8. Especifique o nome de usuário e a senha da sua conta de usuário do Oracle WebCenter.
    9. Especifique o url do ambiente, o nome de usuário e a senha

  9. Clique em Testar e Salvar.


Tarefa 5: Definir a Conexão REST do Carregador de Dados do HCM

Esta etapa cria um conector para a API REST do Carregador de Dados do HCM usada para iniciar o Carregador de Dados do HCM.

É recomendável criar uma conexão separada para cada uma das suas integrações HDL, protegida por uma conta de usuário que só tenha acesso a dados de carga em massa para os objetos de negócios mantidos pela integração.

Antes de criar esta conexão, certifique-se de ter esta conta de usuário configurada. As etapas para criar uma conta desse tipo são fornecidas na Tarefa 1.

  1. Faça login no OIC e navegue até Design > Conexões.
  2. Clique em Criar.
  3. Procure o REST e selecione o adaptador REST.
    4. Pesquisar REST.

  4. Especifique um Nome específico para a sua integração, como HDL - Novas Contratações. O identificador será gerado automaticamente.
    5. Especifique um nome e uma descrição

  5. Defina Função como Chamar e, opcionalmente, especifique uma Descrição.
  6. Clique em Criar.
  7. Especifique um Tipo de Conexão do URL Base da API REST.
  8. Especifique um URL de Conexão de: 
    https://{host}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets

    9. Observação:

    Substitua {host} pelos detalhes do seu host.
    Especifique o url do ambiente

  9. Especifique o nome do usuário e a senha da sua conta de usuário de integração.
    10. Especifique o url do ambiente

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.

Forneça links a recursos adicionais. Esta seção é opcional; exclua se não for necessário.

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.