Introducción
Amplíe las capacidades de la hoja de cálculo de carga masiva mediante la inclusión de segmentos de campos flexibles personalizados y preconfigurados en las plantillas del cargador de datos de hoja de cálculo de HCM (HSDL).
Los campos flexibles descriptivos extienden el registro del objeto base, por lo que puede incluir un contexto de campo flexible descriptivo por fila de hoja de cálculo. En este tutorial aprenderá a agregar atributos de DFF para un contexto junto con los atributos del contexto global.
Los campos flexibles extensibles se conservan en los registros secundarios, por lo que puede incluir varios contextos mediante el uso de varias incidencias del objeto secundario. En este tutorial aprenderá a agregar atributos EFF de varios contextos.
Objetivos
En este tutorial va a:
- Permite generar asignaciones de atributos para los segmentos de campo flexible personalizados.
- Cree la plantilla Mantener departamento, que incluye segmentos de campos flexibles descriptivos.
- Amplíe la plantilla para agregar segmentos de campo flexible extensible desde dos contextos.
Ya debe estar familiarizado con la creación de plantillas de hoja de cálculo. Si no ha utilizado la tarea Plantillas de hoja de cálculo antes, complete primero el tutorial Creación de plantillas de cargador de datos de hoja de cálculo de HCM.
Requisitos
Para completar este tutorial, necesita:
- Acceso a la tarea Ver objetos de negocio.
- Acceso a las tareas de Plantillas de hoja de cálculo con un rol que tiene asignado acceso para crear plantillas para el objeto de negocio Organización.
Siga las tareas 2 y 3 del tutorial Configuración del acceso para diseñar y mantener plantillas de HSDL (programa de carga de datos de hoja de cálculo de HCM) para crear dicho rol.
Note:
En este tutorial se asume que ha activado Redwood. Siga la versión 25C de este tutorial para la navegación y las capturas de pantalla si este no es el caso.Tarea 1: Actualización y revisión de atributos para un objeto de negocio
La tarea Ver objetos de negocio es el diccionario de datos para el cargador de datos de HCM (HDL) y HSDL. En esta tarea, aprenderá a actualizar los atributos de un objeto de negocio para incluir segmentos de campo flexible recién configurados y a buscar los detalles que necesitará para agregar atributos de segmento de campo flexible a sus plantillas de hoja de cálculo.
Actualizar atributos para un objeto de negocio
Los 'mapas' de atributos se utilizan para comprender la forma de los objetos de negocio para los que puede cargar datos en bloque. Cuando configura y despliega cambios de campo flexible, también debe refrescar las asignaciones de atributos para que HDL y HSDL puedan ver los atributos disponibles para cargar datos en los segmentos de campo flexible.
En los siguientes pasos, actualizará los atributos del objeto de negocio Organización, ya que utilizará este objeto para las siguientes tareas. Sin embargo, estos pasos se aplican a todos los objetos de negocio de HDL.
Note:
Antes de actualizar los atributos de un objeto de negocio, asegúrese de que los contextos de campos flexibles personalizados estén configurados y desplegados.- En la aplicación Oracle HCM, vaya a Mis grupos de clientes > Intercambio de datos > Ver objetos de negocio.
- Busque el objeto de negocio Organization.
- Haga clic en el menú Acciones del objeto de negocio y seleccione la acción Actualizar atributos.
- Haga clic en Enviar en el panel Actualizar atributos de objeto de negocio.
El panel se cerrará y recibirá un mensaje confirmando el envío.
- Refresque el contenido de la tabla periódicamente hasta que la fecha de Última actualización el sea la fecha actual. Esto confirma que la solicitud de actualización de los atributos ha finalizado.
Identificación de Códigos de Contexto y Categoría de Campo Flexible
Al incluir atributos de segmento de campo flexible en las plantillas de HSDL, debe configurar el contexto de campo flexible y, en el caso de los atributos de campo flexible extensible, la categoría de campo flexible para esos atributos. Para ello, debe definir por defecto los atributos de categoría de campo flexible y contexto de campo flexible en la plantilla HSDL con el código de contexto de campo flexible y el código de categoría de campo flexible.
Estos pasos muestran cómo buscar estos códigos en las páginas Ver objetos de negocio para los atributos utilizados en la tarea 3 y la tarea 4.
Sugerencia:
Puede completar estos pasos antes de agregar los atributos de segmento de campo flexible a la plantilla o al lado.- En la página Ver objetos de negocio, haga clic en el nombre del objeto para navegar a la página Atributos.
- Haga clic en el separador Atributos de campo flexible para revisar los atributos disponibles para cargar los segmentos de campo flexible descriptivo configurados para el objeto.
- Use los filtros de búsqueda para seleccionar el contexto de campo flexible que se actualizó. En la tarea 3 se utiliza el contexto de salario de departamento.
- Utilice el panel Gestión de columnas para mostrar la columna Código de contexto.
- Anote el código de contexto para el contexto de DFF. El atributo Contexto de campo flexible de la plantilla de HSDL se definirá por defecto en este valor.
- Haga clic en la cabecera de la página para cambiar el objeto que se centra a Información adicional de organización. Este es un ejemplo de un campo flexible extensible (EFF). Los campos flexibles flexibles tienen una categoría de campo flexible además del contexto de campo flexible.
- Vaya al separador Atributos de campo flexible.
- Utilice el panel Gestión de columnas para mostrar las columnas Código de categoría y Código de contexto.
- Busque Reporting Name (Nombre de informe).
- Borre los criterios de búsqueda y filtre la lista de atributos para la categoría Departamento y el contexto Información de día laborable.
- Anote el código de categoría y el código de contexto para el contexto de información de día laborable. Los atributos Contexto de campo flexible y Categoría de campo flexible extensible se establecerán por defecto en estos valores en la plantilla de hoja de cálculo de la Tarea 4.
Note:
Los segmentos de campo flexible descriptivo (DFF) amplían el registro base y, por lo tanto, se encuentran en el mismo componente de la jerarquía de objetos.
Sugerencia:
El separador Atributos de campo flexible solo está disponible para los objetos que admiten campos flexibles.
Observará que hay varios atributos de nombre de informe en varias categorías y contextos de campos flexibles.
En la tarea 4, agregamos el nombre de informe para la categoría Departamento, por lo que debe anotar el código de categoría DEPARTMENT y el código de contexto PER_ORG_MANAGER_INFO para esta entrada.
Sugerencia:
En el tutorial Objetos de negocio del cargador de datos de HCM (HDL) se explica con mayor detalle la tarea Ver objetos de negocio.Lista de Control
Valores que se deben tener en cuenta para las siguientes tareas:
| Valor | Ejemplo | Utilizado para |
|---|---|---|
| Código de contexto de campo flexible descriptivo | Contexto de salario de departamento | Valor de contexto predeterminado en la Tarea 3 |
| Código de categoría de campo flexible descriptivo | DEPARTAMENTO | EFF_CATEGORY_CODE por defecto en la tarea 4 |
| Cd Contexto Campo Flexible | PER_ORG_MANAGER_INFO / PER_WORK_DAY_INFO | Código de contexto predeterminado en la Tarea 4 |
Sugerencia:
Algunos códigos de contexto son texto descriptivo en lugar de code values en mayúsculas. Utilice el valor exacto que se muestra en la columna Example (Ejemplo).Tarea 2: Crear una plantilla de mantenimiento de departamento
En esta tarea, creará una plantilla para mantener los departamentos, que luego se utilizará para las siguientes tareas.
Si ya tiene una plantilla, puede omitir esta tarea. Antes de continuar, confirme que la plantilla se haya probado correctamente. Para los atributos de DFF, debe incluir el objeto propietario del DFF. Para los atributos de EFF, debe incluir el objeto principal para el objeto propietario del EFF.
Introducir información de plantilla
- Vaya a Mis grupos de clientes > Intercambio de datos > Plantillas de hoja de cálculo.
- Haga clic en Agregar.
- En el paso Introducir información de plantilla, introduzca el nombre Mantener departamento. Especifique Organización como objeto de negocio.
- Haga clic en Continuar
Seleccionar atributos
- Seleccione el atributo Nombre de clasificación.
- Seleccione Clasificación de organización en la cabecera Atributos disponibles para ver los atributos de Clasificación de organización.
- Agregue estos atributos a la plantilla:
- Estado
- Código de Juego
Sugerencia:
El atributo Definir código es obligatorio al crear departamentos. - Haga clic en Continuar.
Seleccionar identificadores de registro
Seleccionó atributos de los objetos Organización y Clasificación de organización. Ambos se muestran en el paso Seleccionar identificadores de registro.
Dejaremos el tipo de atributo en Clave de usuario, ya que esta plantilla crea nuevos registros y las claves de sustitución solo se pueden utilizar para mantener registros existentes.
No hay opciones de clave de usuario adicionales para estos objetos, por lo que no hay ninguna acción que realizar.
- Haga clic en Continuar.
Configurar atributos
- Haga clic en la cabecera del atributo Nombre de clasificación para abrir el panel Editar.
- Configure un valor por defecto constante de Departamento y desactive la casilla de control Mostrar.
- Haga clic en Guardar.
- Edite Set Code para configurar un valor predeterminado constante de COMMON.
- Configure un valor por defecto constante para el atributo Estado de A y desactive la casilla de control Mostrar.
- Haga clic en Guardar.
Ahora tiene una plantilla que se puede ampliar para incluir atributos de segmento de campo flexible descriptivos y extensibles.
Tarea 3: Segmentos de campos flexibles descriptivos
Los segmentos de DFF se definen en el mismo registro que los atributos base, por lo que no puede tener varios contextos de DFF para la misma fila de hoja de cálculo. Por lo tanto, está restringido a incluir segmentos de un contexto de campo flexible además de segmentos del contexto Elementos de datos globales.
- Vaya al paso Seleccionar atributos de la plantilla.
- Defina el filtro Objeto en Organización.
- Defina el filtro Nombre de campo flexible, de modo que solo se muestren los atributos de segmento de campo flexible y proporcione los criterios de búsqueda necesarios.
- Haga clic en el enlace de etiqueta de atributo para cualquier segmento de campo flexible en el contexto de campo flexible seleccionado.
- Seleccione los atributos de segmento de campo flexible del contexto de campo flexible descriptivo que desea utilizar y agréguelos a la plantilla, junto con los atributos de contexto de Elementos de datos globales que necesite.
- Haga clic en Continuar hasta que esté en el paso Configurar atributos.
Sugerencia:
Al agregar atributos de segmento de campo flexible para un objeto, se agregará automáticamente el atributo Valor de contexto para ese objeto. - Edite el valor de contexto para establecer su valor por defecto en el código de contexto de DFF. Este atributo se puede ocultar.
Sugerencia:
Como el objeto Organización tiene un campo flexible descriptivo, se muestra el filtro Nombre de campo flexible.
El código de contexto de campo flexible para los atributos de segmento de campo flexible está disponible aquí. Es posible que ya haya encontrado esta información en las páginas Ver objetos de negocio.
Ahora, la plantilla se puede usar para cargar datos en los segmentos de campo flexible descriptivo seleccionados.
Tarea 4: Segmentos de campos flexibles extensibles
Los campos flexibles extensibles se retienen en un registro secundario, lo que permite que se proporcionen varios contextos para el mismo principal.
En esta tarea, agregará segmentos EFF de dos contextos a la plantilla.
Agregar segmentos de campo flexible extensible
Primero agregaremos el segmento de campo flexible Nombre de informe de la categoría Departamento a nuestra plantilla.
- En el proceso guiado Plantillas de hoja de cálculo de la plantilla, vaya al paso Seleccionar atributos.
- Busque el nombre del informe.
Sugerencia:
Solo se ven dos incidencias del atributo Nombre de informe, una para cada Contexto de campo flexible. Solo hay un atributo Nombre de informe disponible en el contexto Información de mánager de organización, pero está configurado en varias categorías de campos flexibles. La tabla Seleccionar atributos solo muestra el atributo disponible y no comprende las configuraciones de categoría de campo flexible.La categoría de campo flexible y los códigos de contexto que se ven en la página Ver objetos de negocio se especificarán en la configuración de la plantilla para garantizar que los datos se carguen en la categoría y el contexto de campo flexible descriptivo correctos.
- Seleccione el atributo Nombre de informe definido en el contexto del campo flexible Información de mánager de organización.
- Haga clic en Continuar.
Ahora ha agregado atributos del objeto Información adicional de organización en la jerarquía de organización y verá que se agrega a la lista de objetos utilizados por esta plantilla.
- Haga clic en Continuar.
Los atributos obligatorios se agregan automáticamente al seleccionar el primer atributo para un objeto.
Los atributos para identificar el registro principal se establecen automáticamente por defecto en los valores del registro principal y se ocultan.
Otros atributos obligatorios para campos flexibles extensibles son:
Atributos de campo flexible extensible obligatorios para información adicional de organización Atributo Descripción Código de Contexto Indica el código de contexto de campo flexible de los segmentos de campo flexible seleccionados. Se agrega automáticamente a las definiciones de objeto de negocio que tienen atributos de segmento de campo flexible.
OrgInformationContext Indica el código de contexto de campo flexible de los segmentos de campo flexible seleccionados para el objeto de información de organización adicional. Este atributo es específico de este objeto y se puede establecer por defecto en el mismo valor que el código de contexto. EFF_CATEGORY_CODE Indica el código de categoría de campo flexible extensible. Número de Secuencia Secuencia del registro de contexto de campo flexible. Sugerencia:
Estos atributos identifican qué categoría de EFF y contexto debe crear o mantener la fila de la hoja de cálculo; normalmente se ocultan al usuario de la hoja de cálculo después de configurar sus valores por defecto. - Edite el atributo Código de contexto para definir un valor por defecto constante del Código de contexto para el atributo Nombre de informe.
- Anote la clave de atributo; la necesitará para configurar el valor por defecto para el atributo OrgInformationContext que copia el valor de este atributo.
- Desactive la casilla de control Mostrar para ocultar el atributo de las hojas de cálculo de plantilla y haga clic en Guardar.
- Configure un valor por defecto de Atributo seleccionado existente para el atributo OrgInformationContext, especificando la clave de atributo del atributo Código de contexto.
- Oculte este atributo y guarde los cambios.
- Edite el atributo EFF_CATEGORY_CODE, definiendo un valor por defecto del campo flexible Código de categoría para el atributo Nombre de informe y oculte el valor.
- Edite el atributo Número de secuencia, definiendo un valor por defecto constante de 1 y oculte el atributo.
- Agregue cualquier otro atributo de segmento de campo flexible que necesite del mismo contexto de campo flexible.
Sugerencia:
Solo los atributos de segmento de campo flexible del componente Información adicional de organización se mostrarán como columnas en las hojas de cálculo generadas a partir de esta plantilla. Todos los demás atributos tienen valores por defecto configurados y están ocultos para simplificar la entrada de datos para el usuario final.Adición de segmentos de campo flexible desde otro contexto
Cuando proporciona segmentos de campo flexible de otros contextos, debe proporcionar una incidencia diferente del objeto Información adicional de organización.
Para lograrlo en una plantilla de hoja de cálculo, primero debe duplicar los atributos de este objeto, agregar los atributos de segmento de campo flexible para el siguiente contexto y configurar el contexto de campo flexible para el objeto duplicado. Al final de esta tarea, tendrá los siguientes atributos en la plantilla para el objeto Información adicional de organización.
| Ocurrencia de objeto | Atributo | Por defecto | Mostrado |
|---|---|---|---|
| 1 | Nombre de informe | Sí | |
| 1 | Horas laborables estándar | ||
| 1 | Frecuencia de horas laborables estándar | ||
| 1 | Hora de inicio de trabajo | ||
| 1 | Hora de finalización de trabajo | ||
| 1 | Código de Contexto | PER_ORG_MANAGER_INFO | |
| 1 | CÓDIGO_CATEGORÍA_EFECTIVA | DEPARTAMENTO | |
| 1 | Contexto de información de organización | OrgInformation_OrgInformationContext | |
| 1 | Número de Secuencia | 1 | |
| 2 | Nombre de informe | ||
| 2 | Horas laborables estándar | Sí | |
| 2 | Frecuencia de horas laborables estándar | Sí | |
| 2 | Hora de inicio de trabajo | Sí | |
| 2 | Hora de finalización de trabajo | Sí | |
| 2 | Código de Contexto | PER_WORK_DAY_INFO | |
| 2 | CÓDIGO_CATEGORÍA_EFECTIVA | DEPARTAMENTO | |
| 2 | Contexto de información de organización | OrgInformation_1_Contexto de información de organización | |
| 2 | Número de Secuencia | 2 |
Note:
Los atributos que existen en cada ocurrencia de un registro deben ser los mismos. Configurará los valores por defecto adecuados para cada contexto y ocultará los atributos que no sean aplicables a un contexto.Información adicional de organización duplicadora
- En la barra de herramientas de la tabla Configurar atributos, haga clic en Más acciones > Atributos duplicados.
- Edite el registro Información adicional de organización y especifique 1. Guarde el cambio.
- Haga clic en Crear. Esto crea una copia de cada atributo seleccionado para el componente Información adicional de organización.
- Edite el atributo Nombre de informe | 1 para ocultarlo.
Este duplicado de Información adicional de organización es para un contexto de campo flexible diferente. Debe ocultar todos los atributos de los segmentos de campo flexible definidos en el registro original de Información adicional de organización.
- Haga clic en Guardar.
Sugerencia:
Los nuevos atributos tendrán un número agregado a su cabecera de columna, nombre de atributo y clave de atributo para identificar a qué nueva incidencia pertenecen.
Adición de segmentos para otro contexto
- Vaya al paso Seleccionar atributos del proceso guiado.
- Filtre los atributos al objeto Información adicional de organización, al nombre del campo flexible FEP de información de organización y al contexto del campo flexible Información de día laborable.
- Agregue estos atributos del contexto Información de día laborable a la plantilla:
- Horas laborables estándar
- Frecuencia de horas laborables estándar
- Hora de inicio de trabajo
- Hora de finalización de trabajo
Note:
A veces hay dos atributos con el mismo nombre. Uno acepta un código o ID de consulta, el otro acepta un significado o valor. Utilice el nombre de atributo para determinar cuál es cuál; el nombre de atributo que termina con _Display acepta el significado o el valor. - Haga clic en Continuar hasta que esté en el paso Configurar atributos.
- Filtre Objeto por Información adicional de organización.
Habrá dos incidencias de cada uno de los nuevos atributos de segmento de campo flexible. Cuando se agregan atributos a un componente duplicado, los atributos se agregan a cada incidencia.
- Permite ocultar los atributos de información de día laborable de la ocurrencia original de información adicional de organización.
- Edite cada uno de los atributos de información de día laborable a partir de la aparición duplicada de información adicional de organización. Cambie el encabezado de columna para quitar el número agregado y, opcionalmente, agregue o cambie la sugerencia de columna.
- Haga clic en Mostrar atributos ocultos.
- Edite estos atributos ocultos en el registro duplicado para especificar el contexto y la secuencia correctos del campo flexible:
Atributos obligatorios de campo flexible extensible para información adicional de organización Atributo Descripción Tipo por Defecto Valor Código de Contexto | 1 Indica el código de contexto de campo flexible para el segundo contexto de campo flexible. Constante PER_WORK_DAY_INFO Número de secuencia | 1 Secuencia del registro de contexto de campo flexible. Constante 2 OrgInformationContext | 1 Indica el código de contexto de campo flexible para el segundo contexto de campo flexible. Copie el valor del atributo Código de contexto | 1. Atributo seleccionado existente OrgInformation_1_Contexto de información de organización - Guarde los cambios.
- Borre todos los filtros y vuelva a ordenar las filas en el orden en que desea que las columnas se muestren en las hojas de cálculo. Por ejemplo, haga clic en Hora de inicio del trabajo y arrástrelo sobre Hora de finalización del trabajo.
Ahora ha creado una plantilla para mantener departamentos mientras rellena varios contextos de campo flexible.
Sugerencia:
Estos son los atributos que no tienen un número agregado al nombre del atributo.La lista de atributos para el objeto Información adicional de organización ahora debería tener un aspecto similar a este.
Enlaces relacionados
Tutoriales relacionados
- Configurar acceso para diseñar y mantener plantillas de cargador de datos de hoja de cálculo (HSDL) de HCM
- Creación de plantillas del cargador HCM de datos de hoja de cálculo
- Definición de Plantillas HSDL para Crear Varios Registros Secundarios en una Fila de Hoja de Cálculo
- Objetos de negocio del cargador de datos de HCM (HDL)
Los últimos tutoriales para HDL y HSDL se publican en este tema sobre Cloud Customer Connect:
Agradecimientos
- Autores: Ema Johnson (jefe principal de productos, cargador de datos de HCM e IA)
Más recursos de aprendizaje
Explore otros laboratorios en docs.oracle.com/learn o acceda a más contenido de aprendizaje gratuito en el canal YouTube de Oracle Learning. Además, visite education.oracle.com/learning-explorer para convertirse en un explorador de Oracle Learning.
Para obtener documentación sobre el producto, visite Oracle Help Center.
Inclusión de segmentos de campo flexible en plantillas de cargador de datos de hoja de cálculo de HCM
G35063-03
Mayo de 2026