Introdução
Este tutorial explica as etapas para gerar arquivos de dados formatados do Carregador de Dados do HCM (HDL) e do Carregador de Dados de Planilha do HCM (HSDL) usando Extrações do HCM e como automatizar a importação e o carregamento desses arquivos. Ele pressupõe que você já tenha experiência com Extrações de HCM, HDL e HSDL.
Utilize as Extrações do HCM para recuperar os dados que deseja incluir em um arquivo HDL ou HSDL. Para formatar os dados na forma necessária, crie um relatório do BI Publisher com um layout de Modelo eText e faça referência a isso na opção de entrega Interface do Carregador de Dados definida na sua extração.
Na execução da extração, a opção de entrega Interface do Carregador de Dados coloca o arquivo gerado no servidor do Oracle WebCenter Content. A opção de entrega define valores de parâmetro que permitem que o Carregador de Dados do HCM processe corretamente o arquivo.
Uma única extração pode incluir várias opções de entrega, tanto para processamento HDL quanto HSDL. O diagrama a seguir descreve uma única extração do HCM que inclui duas opções de entrega para gerar dois arquivos. Cada arquivo é formatado por um Modelo eText separado fornecido no mesmo relatório do BI Publisher.
Para automatizar a importação e o carregamento de todos os arquivos gerados para uma execução de extração, você pode criar um padrão de fluxo de folha de pagamento que:
- Envia sua extração para gerar os arquivos HDL e/ou HSDL.
- Inicia a tarefa Executar Carregador de Dados do HCM para:
- Leia cada configuração de opção de entrega.
- Leia o(s) arquivo(s) gerado(s) pelo servidor do Oracle WebCenter Content.
- Inicie o Carregador de Dados de Planilha do HCM para cada opção de entrega configurada com um tipo de arquivo do Carregador de Planilha.
- Compactar todos os arquivos gerados por todas as opções de entrega de tipo de arquivo do Carregador de Dados em um único arquivo zip.
- Inicie o Carregador de Dados do HCM para o arquivo zip resultante.

Observação:
A tarefa Executar Carregador de Dados do HCM envia o Carregador de Dados do HCM como usuário da sessão para que ele possa ser usado com os recursos de segurança do Carregador de Dados do HCM ativados. Para obter mais informações, consulte o tutorial Configurar o Acesso ao Carregador de Dados do HCM (HDL) e Compreender as Opções de Segurança do HDL.Objetivos
Neste tutorial, você importará uma Extração do HCM simples, criará o relatório do BI Publisher e as opções de entrega para gerar arquivos HDL e HSDL para o caso de uso Suspender Conta de Usuário. Em seguida, você criará um padrão de fluxo de folha de pagamento para enviar sua extração e iniciar o HDL e o HSDL para processar os arquivos gerados.
Pré-requisitos
- Espera-se que você entenda como criar Extrações do HCM e como formar e carregar arquivos do Carregador de Dados do HCM.
- Definições de Extração
- Carregador de Dados do HCM
- Carregador de Dados de Planilhas do HCM
- Relatórios e Análises
- Padrões do Fluxo da Folha de Pagamento
- Faça download do arquivo Suspender Contas de Usuário resources.zip e descompacte-o.
- A solução HSDL requer o uso de um modelo de planilha para suspender contas de usuário.
Para os fins deste tutorial, você pode suspender contas de usuário usando o modelo HSDL pré-configurado Ativar/Desativar uma Conta de Usuário Existente disponível no Cloud Customer Connect.
- Siga as instruções no tutorial Importando Modelos do Carregador de Dados de Planilha do HCM para importar este modelo, especificando um nome de Suspender Contas de Usuário e um código de SUSPEND_USER_ACCOUNTS.
- Edite o modelo importado para configurar um valor de constante padrão Y para o atributo Desativar.
- Certifique-se de que a função usada para executar a Extração do HCM esteja atribuída ao modelo de planilha.
Você precisará acessar a seguinte funcionalidade no Oracle HCM Cloud:
Tarefa 1: Criar sua Extração do HCM
Nesta etapa, você importará a extração Suspender Contas de Usuário.
ADVERTÊNCIA:
Este extrato é puramente para fins de demonstração de opções de entrega. É básico, apenas recuperando todos os registros da entidade do usuário PER_EXT_SEC_PERSON_UE em que o número da pessoa é como '123%'.Importar o Exemplo de Extração
Para importar a extração:
- Navegue até Meus Grupos de Clientes > Troca de Dados.
- Clique em Extrair Definições.
- Clique em Importar.
- Especifique o Nome da Extração como Suspender Extração de Contas de Usuário.
- Importe o arquivo XML baixado do arquivo Suspender Contas de Usuário resources.zip e clique em OK.
- Clique em OK na mensagem de Confirmação. Você retornará à página Definições de Extração.
- Procure a extração importada Suspender Extração de Contas de Usuário.
- Clique no nome da extração para editar a definição da extração.
- Especifique um Consumidor para sua extração e clique em Salvar.
Dica:
O nome da extração é referenciado nos parâmetros do padrão de fluxo da folha de pagamento definidos na Tarefa 5.
Parâmetro de Carga Automática
Crie o parâmetro Carga Automática para que o fluxo de ponta a ponta do Carregador de Dados do HCM funcione.
- Na página Definir, clique em Adicionar na barra de ferramentas da tabela Parâmetros.
- Especifique a seguinte definição de parâmetro:
- Clique em Salvar.

Coluna | Valor |
---|---|
Nome | Carga Automática |
Nome da Tag | AUTO_LOAD |
Tipo de Dados | Texto |
Exibição | Sim |
Revisar Tags de Extração
Seu arquivo rtf usado para criar seu Modelo eText fará referência às tags definidas em sua Extração do HCM para agrupar e exportar dados.
Para localizar estas tags:
- Edite sua definição de extração e clique na guia Design.
- Clique no nome do registro na hierarquia Nome do Objeto para revisar o nome da tag do objeto.
- Clique na guia Atributos para revisar a lista de atributos.
- Clique no nome do atributo para revisar a tag de cada atributo.



Tarefa 2: Definir Layout do Arquivo do BI Publisher
Nessa etapa, você primeiro criaria o arquivo rtf para gerar os dados extraídos para o formato de arquivo Carregador de Dados do HCM ou Carregador de Dados de Planilha do HCM.
Consulte a documentação Extrações do HCM e use o Criador de Modelos para Word para criar um layout rtf que formate os dados extraídos no formato de arquivo HDL.
Carregador de Dados do HCM
Para suspender contas de usuário usando o Carregador de Dados do HCM, você precisa gerar um arquivo de Usuário com esta estrutura:
SET PURGE_FUTURE_CHANGES Y METADATA|User|PersonNumber|Suspended MERGE|User|{person_number}|Y
Para efeitos deste tutorial, revise o arquivo SuspendUserAccounts.rtf baixado do arquivo Suspender Contas de Usuário resources.zip.
- Primeiro, a instrução
SET PURGE_FUTURE_CHANGES Y
é gerada. - A linha METADATA é gerada uma vez para o objeto Usuário, especificando os nomes de campo HDL PersonNumber e Suspenso. A instrução METADATA, os nomes de objetos e atributos são delimitados pelo caractere de barra vertical '|'.
- Para cada registro encontrado no registro de Extrações do HCM Person_Record, uma linha MERGE é gerada.
- A tag External_Person_Number é usada para gerar o número da pessoa da extração. O valor Suspenso é gerado a partir de uma constante definida na rtf.
Carregador de Dados de Planilhas do HCM
Você pode gerar um layout de arquivo HSDL da mesma forma que para o HDL. Os cabeçalhos de coluna e o delimitador de atributo serão diferentes.
Para efeitos deste tutorial, revise o arquivo SuspendUserAccounts HSDL.rtf baixado do arquivo Suspender Contas de Usuário resources.zip.
- Somente uma coluna é gerada por este arquivo rtf com um cabeçalho de
User_PersonNumber
. - A tag External_Person_Number é usada para extrair o número da pessoa do usuário a ser suspenso.
- Não há valor necessário para a coluna Desativar na planilha HSDL, pois o valor é padronizado pelo próprio modelo HSDL.
Dica:
O tutorial Importar Arquivos para Planilhas do Carregador de Dados de Planilha do HCM explica como fazer download do modelo csv que inclui os nomes de atributo necessários para o cabeçalho do arquivo.Tarefa 3: Definir o Relatório do BI Publisher
Nessa etapa, você criará um relatório para gerar os dados extraídos usando os arquivos rtf criados na Tarefa 2.
Criar o Relatório de BI Publisher
- Navegue até Ferramentas > Relatórios e Análises
- Clique em Procurar Catálogo.
- Clique em Criar > Relatório.
- Na caixa de diálogo Criar Relatório, selecione Usar Modelo de Dados.
- Clique no ícone Pesquisar para abrir o browser do Modelo de Dados.
- Navegue até a pasta Pastas Compartilhadas > Gerenciamento de Capital Humano > Folha de Pagamento > Modelos de Dados.
- Selecione o globalReportsDataModel e clique em OK.
- Selecione Usar Editor de Relatório para saber como criar seu relatório e clique em Concluir.
- Salve o relatório nas Pastas Compartilhadas > Personalizado > Gerenciamento de Capital Humano > pasta HDL, com o nome SuspendUserAccounts.




Dica:
O nome e o caminho do relatório precisam ser fornecidos à sua opção de entrega de Extração do HCM, portanto, anote-os.Observação:
O subdiretório HDL pode não existir, então você pode precisar criá-lo.Fazer Upload do Layout do Relatório
Nesta etapa, você fará upload do arquivo rtf como o layout do relatório do BI Publisher. O processo é o mesmo para HDL e HSDL.
- Clique em Fazer Upload no cabeçalho Fazer Upload ou Gerar Layout.
- Especifique um Nome do Layout de Suspender Contas de Usuário HDL.
- Clique em Escolher Arquivo para procurar e selecionar o arquivo SuspendUserAccounts.rtf do Carregador de Dados do HCM revisado na Tarefa 2.
- Especifique um Tipo de eText Modelo.
- Especifique a Localidade.
- Clique em Fazer Upload.

Dica:
O nome do layout precisa ser fornecido à sua opção de entrega de Extração do HCM, portanto, anote-a.
Seu relatório é salvo automaticamente.
Repita as etapas de Fazer Upload do Layout de Relatório para criar um layout Suspender Contas de Usuário HSDL usando o arquivo SuspendUserAccounts HSDL.rtf.
Tarefa 4: Definir a Opção de Distribuição de Extração do HCM
Nesta etapa, você criará opções de entrega em sua Extração do HCM para usar o relatório do BI Publisher a fim de formatar a saída de extração e lançar essa saída no servidor do Oracle WebCenter Content.
Definir a Opção de Entrega
- Navegue até Meus Grupos de Clientes > Troca de Dados > Definições de Extração
- Procure a extração Suspender Extração de Contas de Usuário e clique no nome da extração para editá-la.
- Clique na guia Entrega.
- Clique em Adicionar na barra de ferramentas da tabela Opções de Entrega de Extração.
- Especifique o Nome da Opção de Distribuição como Suspender HDL da Conta do Usuário e especifique um Tipo de Distribuição da Interface do Carregador de Dados.
- Clique em OK para definir a opção de entrega.
A opção de entrega Interface do Carregador de Dados fornece parâmetros que você precisará especificar para HDL e/ou HSDL para poder processar o arquivo gerado pela opção de entrega:
Campo Descrição Tipo de Saída 'Texto' Relatório O caminho e o nome do arquivo do relatório do BI Publisher criados na Tarefa 3. Nome do Modelo O nome do layout no relatório do BI Publisher nomeado pelo campo Relatório. Nome de Saída O nome a ser usado para o arquivo gerado, sem a extensão do arquivo. Para arquivos HDL, esse deve ser o nome do arquivo específico do objeto de negócios. Modo de Criptografia O tipo de criptografia do arquivo gerado. Especifique PGP - Não Assinado para criptografar o arquivo. Observação:
Deixe seus arquivos sem criptografia em seu ambiente de teste enquanto desenvolve sua integração. Os arquivos gerados são publicados no Oracle WebCenter, onde qualquer pessoa com acesso à conta hcm/dataloader/import pode fazer download e lê-los. Recomendamos que você sempre criptografe arquivos postados aqui.Nome da Integração Um valor para identificar arquivos de saída no servidor do Oracle WebCenter Content. Ela é concatenada com o ID do processo para formar o ID do Conteúdo. Especifique um valor exclusivo para cada opção de entrega na mesma extração.
Tipo de Arquivo O tipo de arquivo de saída. Grupo de Distribuições Compactado Tipo de Arquivo: Carregador de Dados O nome do arquivo zip no qual todos os arquivos gerados pelo Carregador de Dados serão compactados juntos. Você deve fornecer o mesmo valor, com uma extensão .zip, para todas as opções de entrega do Carregador de Dados na mesma extração.
Tipo de Arquivo: Carregador de Planilha
Não é obrigatório.
Compactar Especifique Não se não quiser compactar o arquivo gerado pela opção de entrega. Especifique Sim - Compactar Primeiro se quiser compactar o arquivo gerado pela opção de entrega, isso poderá ser útil para arquivos de volume maiores. Se você também estiver criptografando o arquivo, ele será compactado primeiro e, em seguida, criptografado.
Observação:
O Carregador de Dados do HCM não é afetado por esta configuração. O processo Executar Carregador de Dados do HCM primeiro decriptografará arquivos criptografados, descompactará arquivos compactados e, em seguida, alterará as extensões de arquivo antes de compactar todos os arquivos gerados com o mesmo valor de parâmetro Compactar Grupo de Entrega. O arquivo compactado é então submetido ao HDL.Código do Modelo da Planilha O código do modelo HSDL com o qual carregar dados. Formato de Data do Arquivo da Planilha Formato de data usado para atributos com o tipo de dados de data. O formato padrão é AAAA/MM/DD. Delimitador do Arquivo da Planilha Caracteres usados para separar valores no arquivo. O padrão é vírgula. Indicador de Escape do Arquivo da Planilha Caracteres usados para fazer escape dos caracteres delimitadores dentro de um valor de atributo. O padrão é uma barra invertida. Cabeçalho do Arquivo da Planilha Incluído Indica se um cabeçalho está incluído no arquivo de origem para nomear os atributos incluídos no arquivo. O valor padrão é S. Indicador de Nova Linha da Planilha Caracteres usados para indicar uma nova linha. O valor padrão é n, prefixado com o caractere de escape. Dica:
O parâmetro Substituir Extensão de Arquivo não é usado. - Especifique estes valores de parâmetro para a opção de entrega HDL:
Tipo de Saída Texto Relatório /Custom/Human Gerenciamento de Capital/HDL/SuspendUserAccounts.xdo Nome do Modelo Suspender Contas de Usuário HDL Nome de Saída Usuário Modo de Criptografia Nenhum(a) Dica:
Você precisará alterar isso para PGP - Não Assinado depois de confirmar que a forma do arquivo gerado está correta.Nome da Integração SUA Tipo de Arquivo Data Loader Grupo de Distribuições Compactado User.zip Compactar No Dica:
Considere alterar essa opção para Sim - Compactar Primeiro depois de confirmar que a forma de arquivo gerada está correta.
- Clique em OK.
- Repita as etapas acima para criar a opção de entrega Suspender HSDL de Contas de Usuário.
Para a Opção de Entrega do Carregador de Dados de Planilha do HCM, especifique estes valores de parâmetro:
Tipo de Saída Texto Relatório /Custom/Human Gerenciamento de Capital/HDL/SuspendUserAccounts.xdo Nome do Modelo Suspender HSDL de Contas de Usuário Nome de Saída Suspender HSDL de Contas de Usuário Modo de Criptografia Nenhum(a) Dica:
Você precisará alterar isso para PGP - Não Assinado depois de confirmar que a forma do arquivo gerado está correta.Nome da Integração SUAHSDL Tipo de Arquivo Carregador de Planilha Grupo de Distribuições Compactado Compactar No Código do Modelo da Planilha SUSPEND_USER_ACCOUNTS
- Clique em Validar para navegar até a Estrutura de Execução de Extração.
- Clique em Validar na barra de ferramentas da tabela.
- Verifique e resolva quaisquer erros de validação.



Dica:
Você pode precisar atualizar a tabela.Testar a geração de arquivos
Nesta etapa, você confirmará se os arquivos são gerados na forma necessária.
Na página Definições de Extração:
- Procure sua extração e clique em Enviar Extração.
- Especifique um Nome da Instância de Extração e forneça o parâmetro Data de Efetivação com a data de hoje.
- Clique em Submeter. Isso o levará à página Exibir Resultados da Extração.
- Clique em Atualizar até que sua instância de extração seja concluída.
- Clique no nome da instância do fluxo de extração para exibir mais informações.
- Expanda a seção Opções de Entrega de Extração.
- Clique no ícone de download do arquivo em relação ao arquivo de saída e revise a saída.
- Faça as alterações necessárias no arquivo de layout rtf do relatório do BI Publisher, até que o arquivo de saída gerado possa ser carregado com êxito com o Carregador de Dados do HCM.
- Quando estiver satisfeito com a forma do arquivo, lembre-se de atualizar a opção de entrega para definir o Modo de Criptografia como PGP - Não Assinado.




Dica:
O nome do arquivo é gerado a partir do Nome de Saída definido em cada opção de entrega.Dica:
Uma vez criptografado, você não poderá revisar o conteúdo do arquivo.Tarefa 5: Definir o Padrão de Fluxo da Folha de Pagamento
Nesta etapa, você definirá um padrão de fluxo de folha de pagamento para enviar sua Extração do HCM e iniciará a tarefa Executar Carregador de Dados do HCM para processar os arquivos gerados por sua extração.
Criar o Padrão de Fluxo da Folha de Pagamento
- Navegue até Meus Grupos de Clientes > Folha de Pagamento > Padrões de Fluxo de Folha de Pagamento.
- Criar um novo fluxo.
- Opcionalmente, especifique um Grupo de Dados Legais e clique em Continuar.
- Especifique o nome Suspender Contas de Usuário para o Padrão de Fluxo, opcionalmente, forneça uma descrição e defina o valor LDG Obrigatório.
- Marque as caixas de seleção Extrações do HCM e Preparações para o valor Atividades a Incluir.
- Role e selecione as tarefas Suspender Extração de Contas de Usuário e Executar Carregador de Dados do HCM.
- Clique em Próximo para navegar até a página Sequência de Tarefas.
- Edite os valores da Tarefa Seguinte para garantir que as tarefas estejam nesta ordem:



Tarefa | Tarefa Seguinte |
---|---|
Fluxo Inicial | Suspender Extração de Contas de Usuário |
Suspender Extração de Contas de Usuário | Executar Carregador de Dados do HCM |
Executar Carregador de Dados do HCM | Finalizar Fluxo |
Definir os Parâmetros do Fluxo de Processos
- Clique em Próximo para navegar até a página Parâmetros. Crie os seguintes parâmetros: Data de Efetivação
Campo | Valor |
---|---|
Parâmetro do Fluxo | Data de Efetivação |
Exibição | Sim |
Formato de Exibição | Data |
Sequência | 10 |
Parâmetro de Chave | Data do Processo |
Grupo de Configurações do Processo
Campo | Valor |
---|---|
Parâmetro do Fluxo | Grupo de Configurações do Processo |
Exibição | Sim |
Formato de Exibição | LOV Inteligente |
Pesquisa | Grupo de Configurações do Processo|ActionParameterGroupPVO |
Sequência | 20 |
Data de Início
Campo | Valor |
---|---|
Parâmetro do Fluxo | Data Inicial |
Exibição | Sim |
Formato de Exibição | Data |
Sequência | 30 |
Carregamento Automático
Campo | Valor |
---|---|
Parâmetro do Fluxo | Carga Automática |
Exibição | Sim |
Formato de Exibição | Texto |
Sequência | 40 |
Base do Parâmetro | Ligação Constante |
Valor Base | S |
Nome da Extração Base
Campo | Valor |
---|---|
Parâmetro do Fluxo | Nome Base do Extrato |
Exibição | No |
Formato de Exibição | Texto |
Sequência | 50 |
Base do Parâmetro | Ligação Constante |
Valor Base | Suspender Extração de Contas de Usuário |
Categoria do Relatório
Campo | Valor |
---|---|
Parâmetro do Fluxo | Categoria de Relatório |
Exibição | No |
Formato de Exibição | LOV Inteligente |
Pesquisa | Categoria do relatório|OverridingReportCategoryPVO |
Sequência | 60 |
Base do Parâmetro | Lançar Ligação SQL |
Valor Base | selecione to_char(report_category_id) em pay_report_categories, em que base_category_name='Suspender Extração de Contas de Usuário' |
Configurar parâmetros da tarefa
- Clique em Próximo para navegar até a página Parâmetros da Tarefa.
- Selecione o registro de extração do HCM Suspender Contas de Usuário.
- Atualize o parâmetro Data Efetiva, definindo o Valor Base como Data Efetiva. Este parâmetro de tarefa agora aceitará o valor do parâmetro Data de Efetivação do fluxo de folha de pagamento.
- Atualize o parâmetro Carga Automática, garantindo que a Base do Parâmetro seja Vincular ao Fluxo e definindo o Valor Base como Carga Automática. Este parâmetro de tarefa agora aceitará o valor do parâmetro Carga Automática do fluxo de folha de pagamento.
- Atualize o parâmetro Grupo de Configuração do Processo, garantindo que a Base do Parâmetro seja Vincular ao Fluxo e definindo o Valor Base como Grupo de Configuração do Processo. Este parâmetro de tarefa agora aceitará o valor do parâmetro Grupo de Configuração do Processo do fluxo da folha de pagamento.
- Atualize o parâmetro Data Inicial, garantindo que a Base do Parâmetro seja Vincular ao Fluxo e definindo o Valor Base como Data Inicial. Este parâmetro de tarefa agora aceitará o valor do parâmetro Data Inicial do fluxo de folha de pagamento.
- Selecione a tarefa Executar Carregador de Dados do HCM na tabela Tarefas.
- Clique em Próximo para navegar até a página Revisar e clique em Submeter.
- Procure sua nova tarefa de fluxo de folha de pagamento e clique em Editar.
- No painel Tarefas, clique em Ir para Tarefa na tarefa Executar Carregador de Dados do HCM.
- Edite o parâmetro Nome do Fluxo do Processo de Extração garantindo que a Base do Parâmetro seja Vincular à Tarefa do Fluxo e definindo o Valor Base como Suspender Contas de Usuário - Extrair, Enviar e Processo da Folha de Pagamento.
- Clique em Submeter.





Observação:
É necessário definir o valor base para o Nome do Fluxo do Processo de Extração, mas a lista de valores não estará disponível até que o padrão do fluxo do processo seja salvo. Você editará esse parâmetro após criar o fluxo.Você retornará à página Padrões de Fluxo de Folha de Pagamento.


Tarefa 6: Submeter o Fluxo de Folha de Pagamento
Nesta etapa, você enviará seu fluxo e monitorará os resultados.
- Navegue até Meus Grupos de Clientes > Troca de Dados
- Clique em Submeter um Fluxo.
- Procure o fluxo Suspender Contas de Usuário.
- Clique no nome do fluxo para navegar até a página Enviar um Fluxo de Folha de Pagamento.
- Especifique um nome para o fluxo de folha de pagamento. Pode ser qualquer valor exclusivo.
- Especifique uma Data de Efetivação.
- Clique em Enviar, que o levará até a página Lista de Verificação da Folha de Pagamento.
- Clique periodicamente em Atualizar até que os processos de extração e Execução do Carregador de Dados do HCM sejam concluídos.
- Clique no nome da tarefa Executar Carregador de Dados do HCM para navegar até a tarefa Importar e Carregar Dados, na qual você pode revisar o status do conjunto de dados e quaisquer mensagens geradas.



Dica:
O comportamento padrão do HDL é excluir o arquivo de origem do Oracle WebCenter quando os dados são recuperados, e é por isso que é importante validar a forma do arquivo chamando a extração diretamente conforme descrito na Tarefa 4.Links Relacionados
Os tutoriais mais recentes para HDL e HSDL são publicados neste tópico no Cloud Customer Connect:
Consulte este tópico de ajuda para obter mais informações:
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.
Iniciar Carregador de Dados do HCM para Arquivos Gerados de Extração do HCM
G34811-01
Maio de 2025