Introdução
Amplie seus recursos de planilha de carregamento em massa, incluindo segmentos de flexfield pré-configurados e personalizados em seus modelos do Carregador de Dados de Planilha do HCM (HSDL).
Objetivos
Neste tutorial, você:
- Gere mapas de atributos para seus segmentos de flexfield personalizados.
- Crie o modelo Manter Departamento que inclui segmentos de flexfield descritivo.
- Estenda o modelo para adicionar segmentos de flexfield extensíveis de dois contextos.
Pré-requisitos
Para concluir este tutorial, você precisa:
- Acesso à tarefa Exibir Objetos de Negócios.
- Acesso às tarefas Modelos de Planilha com uma função que tem acesso atribuído para criar modelos para o objeto de negócios Organização.
Dica:
O tutorial Configurar Acesso para Projetar e Manter Modelos do Carregador de Dados de Planilha do HCM (HSDL) explica como configurar o acesso dos Modelos de Planilha.Você já deve estar familiarizado com a criação de modelos de planilha. Se você ainda não usou a tarefa Modelos de Planilha, siga o tutorial Criando Modelos de Carregador de Dados de Planilha do HCM para se familiarizar com a navegação e a terminologia.
Tarefa 1: Gerar Mapas de Atributo
O Carregador de Dados do HCM (HDL) usa mapas de atributos para entender a forma dos objetos de negócios que ele suporta. Ao configurar e implantar alterações de flexfield, você também precisa atualizar os mapas de atributo para que HDL e HSDL possam ver os atributos disponíveis para carregar dados em seus segmentos de flexfield.
Nesta tarefa, você atualizará os mapas de atributos do objeto de negócios da Organização, pois usará esse objeto para as tarefas a seguir. No entanto, essas etapas se aplicam a todos os objetos de negócios HDL.
Observação:
Antes de atualizar os mapas de atributos, certifique-se de que seus contextos de flexfield personalizado estejam configurados e implantados.- No aplicativo Oracle HCM, navegue até Meus Grupos de Clientes > Troca de Dados > Exibir Objetos de Negócios.
- Pesquise e selecione o objeto de negócios Organização ou o objeto para o qual você configurou segmentos de flexfield.
- Clique em Atualizar Objeto na barra de ferramentas da tabela e clique em OK na janela de confirmação.
- Atualize o conteúdo da tabela e revise a Data da Última Atualização.
- Clique no nome do objeto de negócios para navegar até a página Detalhes do Objeto de Negócios.
- Selecione o componente na hierarquia que deseja revisar. Por exemplo, Organização e clique na guia Atributos de Flexfield.
- Use a lista de opções para selecionar o contexto de flexfield correto. Observe o código do flexfield fornecido à direita da lista de opções e clique em Pesquisar para verificar os atributos disponíveis no contexto.
Dica:
Os códigos de contexto de flexfield nem sempre se parecem com códigos. Você usará o código de contexto de flexfield e os nomes de atributo posteriormente ao adicionar segmentos de flexfield ao seu modelo. - Clique no componente Informações Adicionais da Organização na hierarquia. Este é um exemplo de um Flexfield Extensível (EFF). Os EFFs têm uma Categoria de Flexfield além do contexto do flexfield. Defina a Categoria do Flexfield como Departamento.
- Revise esses flexfields e anote o código de contexto e o nome do atributo para estes contextos:
- Informações do Gerente da Organização
- Informações de Dia Útil

Dica:
Depois de exibir a data de hoje, a atualização será concluída e você poderá ver os atributos de seus segmentos de flexfield personalizados na página Detalhes do Objeto de Negócios e na interface do usuário Modelos de Planilha.Observação:
Os segmentos de Flexfield Descritivo (DFF) estendem o registro base e, portanto, são encontrados no mesmo componente na hierarquia de objetos.Dica:
O tutorial Noções Básicas sobre Objetos de Negócios do Carregador de Dados do HCM (HDL) explica a tarefa Exibir Objetos de Negócios com mais detalhes.Tarefa 2: Segmentos do Flexfield Descritivo
Você pode pesquisar e editar o modelo ao qual deseja adicionar seus segmentos flexíveis personalizados ou seguir estas etapas para criar um novo modelo para manutenção de departamentos. Na Tarefa 3, você estenderá esse modelo para incluir segmentos de vários contextos EFF.
Definir o Modelo
- Navegue até Meus Grupos de Clientes > Troca de Dados > Modelos de Planilha.
- Crie um novo modelo com o nome Manter Departamento. Especifique Organização como o objeto de negócios e clique em OK.
- Navegue até a guia Design.
- Selecione o Nome da Classificação no painel Atributos Disponíveis e adicione-o ao painel Atributos Selecionados.
- Selecione a chave de usuário Organização, Nome da Classificação quando solicitado a informar qual chave usar.
- Marque a caixa de seleção Mostrar atributos excluídos no painel Atributos Selecionados.
- Edite o atributo Nome da Classificação e configure um valor constante padrão de Departamento e desmarque a caixa de seleção Visível para ocultar esse atributo das planilhas geradas por esse modelo.

Observação:
Ao selecionar o Nome da Classificação, os atributos Organização e Data Inicial Efetiva são adicionados automaticamente ao painel Atributos Selecionados.O atributo Data Final Efetiva também foi adicionado à lista de Atributos Selecionados, mas oculto por padrão, indicado pelo ícone à direita na linha Data Final Efetiva.
Adicionar Atributos de Classificação da Organização
- Selecione Classificação da Organização no cabeçalho Atributos Disponíveis para exibir os atributos Classificação da Organização.
- Adicione estes atributos ao seu modelo:
- Status
- Definir Código
Dica:
O atributo Definir Código é obrigatório ao criar departamentos.Observação:
Os atributos usados para identificar o registro pai são adicionados automaticamente ao modelo: Nome da Organização, Nome da Classificação, Data Inicial Efetiva, Data Final Efetiva.Os valores desses atributos são padronizados para os valores fornecidos para o registro pai (Organização) e os atributos são ocultados da planilha.
- Edite o atributo Definir Código para especificar um valor padrão constante COMMON.
- Edite o atributo Status para especificar um valor padrão de constante A e desmarque a caixa de seleção Visível.
- Valide e salve seu modelo.


Adicionar Segmentos do Flexfield Descritivo
Os segmentos DFF são definidos no mesmo registro que os atributos base para que você não possa ter vários contextos DFF para a mesma linha da planilha. Portanto, você está restrito a incluir segmentos de um contexto de flexfield, além de segmentos do contexto Elementos de Dados Globais.
- Exiba os Atributos Disponíveis do componente Organização.
- Selecione os atributos do contexto DFF que você deseja usar e adicione-os ao modelo, juntamente com quaisquer atributos de contexto Elementos de Dados Globais necessários.
- Edite o Valor de Contexto para definir um valor padrão constante do código de contexto do flexfield para os segmentos do flexfield descritivo adicionados. Este atributo pode ser ocultado.

Dica:
O atributo Valor de Contexto é selecionado automaticamente.
Dica:
O código de contexto do flexfield está disponível na guia Atributos de Flexfield da interface do usuário Exibir Objetos de Negócios.Tarefa 3: Segmentos de Flexfield Extensíveis
Os flexfields extensíveis são mantidos em um registro filho, permitindo que vários contextos sejam fornecidos para o mesmo pai.
Nesta tarefa, você adicionará segmentos EFF de dois contextos ao seu modelo.
Adicionar Segmentos de Flexfield Extensíveis
- Use o filtro de cabeçalho Atributos Disponíveis para alterar o contexto para Informações Adicionais da Organização.
- Procure o Nome do Relatório.
Use as informações de contexto do flexfield anexadas ao nome do atributo para garantir que você selecione o Nome do Relatório no contexto Informações do Gerente da Organização para o modelo.
- Adicione este atributo ao modelo.
- Edite esses quatro atributos para definir os valores padrão especificados na tabela acima e ocultá-los.
- Adicione quaisquer outros atributos de segmento de flexfield necessários do mesmo contexto de flexfield.

Os atributos obrigatórios são adicionados automaticamente ao selecionar seu primeiro segmento de flexfield. Os atributos para identificar o registro pai são automaticamente padronizados para os valores de registro pai e ocultos. Outros atributos obrigatórios para flexfields extensíveis são:
Atributo | Descrição | Tipo Padrão | Valor padrão |
---|---|---|---|
Código de Contexto | Especifica o código de contexto do flexfield dos segmentos do flexfield selecionados. Este atributo é gerado pelo Carregador de Dados do HCM para todos os tipos de registro do flexfield. | Constante | PER_ORG_MANAGER_INFO |
EFF_CATEGORY_CODE | Especifica o código de categoria do flexfield extensível. | Constante | DEPARTAMENTO |
Número de sequência | Especifica a sequência do registro de contexto do flexfield. | Constante | 1 |
OrgInformationContext | Especifica o código de contexto do flexfield dos segmentos do flexfield selecionados. Este atributo é definido pelo objeto de negócios e pode ser padronizado com o mesmo valor do Código de Contexto. | Atributo selecionado existente | | Informações Adicionais da Organização - Valor do Contexto - |~ |

Dica:
Somente os atributos de segmento de flexfield no componente Informações Adicionais da Organização serão mostrados como colunas em planilhas geradas a partir desse modelo. Todos os outros atributos têm padrões configurados e ficam ocultos para simplificar a entrada de dados para o usuário final.Duplicando o Registro de Flexfield Extensível
- No painel Atributos Selecionados, verifique se você está exibindo atributos ocultos.
- Clique em qualquer um dos atributos Informações Adicionais da Organização no painel Atributos Selecionados e clique em Duplicar.
- Especifique 1 quando for solicitado o número de instâncias a serem criadas.
- Clique em OK. Isso cria uma cópia de todos os atributos selecionados para o componente Informações Adicionais da Organização.
- Edite o atributo Nome do Relatório | 1 para ocultá-lo.
Esta duplicação de Informações Adicionais da Organização é para um contexto de flexfield diferente, portanto, você deve ocultar todos os atributos para segmentos de flexfield definidos no registro original de Informações Adicionais da Organização.



Dica:
Os novos atributos terão um número anexado ao nome para identificar a qual nova ocorrência eles pertencem.
Adicionando Segmentos para Outro Contexto
- Pesquise atributos disponíveis no contexto Informações de Dia Útil.
- Adicione estes atributos do contexto Informações de Dia Útil ao seu modelo:
- Horas de Trabalho Padrão
- Frequência de Horas de Trabalho Padrão
- Horário de Início de Trabalho
- Horário de término de trabalho
Observação:
Às vezes, há dois atributos com o mesmo nome. Um aceita um código de consulta ou ID, o outro aceita um significado ou valor. Nem sempre é fácil identificá-lo no nome do atributo. Em caso de dúvida, acrescente os dois. - Revise os atributos adicionados ao painel Atributos Selecionados.
- Valide e salve seu modelo. Desmarque a caixa de seleção Mostrar atributos excluídos e clique em Opções Avançadas para Definição de Atributo na barra de ferramentas Atributos Selecionados.
- Expanda as colunas Cabeçalho da Coluna e Chave do Atributo. A chave do atributo identifica exclusivamente cada atributo em um modelo de planilha.
- Desmarque a caixa de seleção Incluir na Planilha para cada um dos atributos de segmento de flexfield específicos do novo contexto EFF do registro de Informações Adicionais da Organização original.
Dica:
Aqueles em que o não é um número na chave de atributo entre o identificador do objeto e o nome do atributo interno.
- Desmarque o atributo Incluir na Planilha para o atributo Frequência de Horas de Trabalho Padrão na nova ocorrência que aceita o ID em vez do valor.
Observação:
Os atributos que aceitam um valor ou significado quando também há um ID ou um atributo de código terão _Display na chave de atributo. - Salve suas alterações e saia da página de opções avançadas.
- Por fim, edite esses atributos em seu registro duplicado para especificar o contexto e a sequência corretos do flexfield:
Atributos Obrigatórios do Flexfield Extensível para Informações Adicionais da Organização Atributo Descrição Tipo Padrão Valor Código de Contexto | 1 Especifica o código de contexto do flexfield para o segundo contexto do flexfield. Constante PER_WORK_DAY_INFO Número de Sequência | 1 Especifica a sequência do registro de contexto do flexfield. Constante 2 OrgInformationContext | 1 Atualize o padrão para o atributo Código de Contexto | 1. Atributo selecionado existente Valor de Contexto | Informações Adicionais da Organização|1 Dica:
Você precisará marcar a caixa de seleção Mostrar atributos excluídos para localizá-los no painel Atributos Selecionados.Agora você pode ativar e usar esse modelo para manter departamentos enquanto preenche vários contextos de flexfield.
Haverá duas ocorrências de cada um dos novos atributos de segmento de flexfield. Quando você adiciona atributos a um componente duplicado, os atributos são adicionados a cada ocorrência.

Agora você precisa ocultar os novos atributos de segmento de flexfield da ocorrência original do componente EFF.

Agora você deve ter apenas um atributo Frequência de Horas de Trabalho Padrão visível na planilha; o atributo _Exibir da 1ª duplicata do registro do flexfield.
Links Relacionados
Os tutoriais mais recentes para HDL e HSDL são publicados neste tópico no Cloud Customer Connect:
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.
Incluindo Segmentos de Flexfield em Modelos do Carregador de Dados de Planilha do HCM
G35069-01
Maio de 2025