Generar archivos de asignación de Oracle Integration Cloud (OIC) para el cargador de datos de HCM (HDL)

Introducción

En este tutorial se explican los pasos necesarios para generar y editar archivos de asignación específicos de objetos de negocio que, a continuación, se pueden importar a Oracle Integration Cloud (OIC) para transformar datos en la unidad de archivo de objeto de negocio del cargador de datos de HCM.

Objetivos

En este tutorial:

Permite activar la generación de archivos de asignación.
Generación de archivos de correlación genéricos y personalizados.
Editar archivos de asignación generados.

Requisitos

Para completar los pasos de este tutorial, necesitará acceder a:

La tarea Configurar cargador de datos de HCM para activar la generación de archivos de asignación.
La tarea Ver objetos de negocio para generar archivos de asignación genéricos.
Cargador de datos de HCM para importar archivos de prueba y generar archivos de asignación personalizados.

Consulte el tutorial Configuración del acceso al cargador de datos de HCM (HDL) y descripción de las opciones de seguridad de HDL para conocer los pasos para configurar este acceso.

Tarea 1: Activar generación de archivo de asignación

En este paso, activará la generación de archivos de asignación de OIC en el cargador de datos de HCM.

Existen dos métodos para generar archivos de asignación:

Generación de archivos de objetos de negocio genéricos completos.
Use la tarea Ver objetos de negocio para generar y descargar archivos de asignación que describan las jerarquías completas de objetos de negocio.
Generar archivos de objeto de negocio personalizados.
Importe y cargue archivos de prueba para confirmar la unidad de archivo al generar un archivo de asignación en la unidad del archivo importado.

Para activar la generación de archivos de asignación:

Conéctese a la aplicación Oracle HCM Cloud.
Vaya a Mi empresa > Configuración y mantenimiento.
Seleccione el área funcional Cargador de datos de HCM.
Haga clic en la tarea Configurar cargador de datos de HCM.

Haga clic en la tarea Cargador de datos de HCM dentro del área funcional Cargador de datos de HCM.

Busque el parámetro Generar archivos de asignación de objeto de negocio.

Utilice el campo Consultar por ejemplo para buscar el parámetro.

Defina Sustituir en Sí.

Existen dos opciones de sustitución disponibles al activar la generación de archivos de correlación:

Valor de Sustitución	Descripción
Solo personalizada	Permite generar archivos de asignación para archivos de datos de objeto de negocio que cargue con el cargador de datos de HCM.
Sí	Permite que se generen archivos de asignación genéricos a partir de la tarea Ver objetos de negocio además de archivos personalizados.

Haga clic en Guardar.

Sugerencia:

Para obtener más información, busque Generar archivos de asignación de objeto de negocio en el tema Parámetros de configuración del cargador de datos de HCM.

Tarea 2: Generar archivos de asignación completos

En este paso, generará un archivo de asignación para una jerarquía completa de objetos de negocio.

Conéctese a la aplicación Oracle HCM Cloud.
Vaya a Mis grupos del cliente > Intercambio de datos > Ver objetos de negocios.
Busque y seleccione el objeto de negocio Registro de documento y haga clic en Refrescar objeto.

Utilice la consulta por ejemplo para buscar el registro de documentos y haga clic en Refrescar objeto

Refresque el contenido de la tabla hasta que la columna Archivo de asignación de integración muestre un icono de archivo de descarga para el objeto de negocio Registro de documento.

Haga clic en el icono de descarga del archivo, se descargará el archivo de asignación.

Note:

Este archivo se editará en la Tarea 4.

Tarea 3: Generar archivos de asignación personalizados

Este es el enfoque recomendado para generar archivos de asignación para OIC. Primero debe crear un archivo del cargador de datos de HCM en la unidad en la que desea que la integración de OIC genere archivos. Esto tiene la ventaja de probar que la unidad de archivo HDL es correcta antes de crear la integración.

Definición de un archivo de objeto de negocio HDL. Puede descargar el archivo Asignación de trabajador File.zip para los fines de este tutorial.
Conéctese a la aplicación Oracle HCM Cloud.
Vaya a Mis grupos de clientes > Intercambio de datos > Importar y cargar datos.
Haga clic en Importar archivo.
Arrastre el asignación de trabajador File.zip descargado al botón Seleccionar archivo y haga clic en Revisar parámetros.

Seleccione el archivo de origen y haga clic en Review Parameters.

Active la casilla de control Generar archivo de asignación de objeto de negocio.

Active la casilla de control Generar Archivo de Asignación de Objeto de Negocio.

Haga clic en Enviar.
Haga clic en Aceptar para cerrar la ventana de confirmación Enviado.
Refresque la tabla Conjuntos de datos hasta que se vea el archivo de prueba.
En ocasiones, refresque la tabla Objetos de Negocio para el juego de datos hasta que finalice la importación.
Haga clic en Descargar Archivo de Asignación en la barra de herramientas de la tabla Objetos de Negocio para descargar el archivo de asignación personalizado.
Este botón se activa una vez que se importa el archivo de objeto de negocio.

Haga clic en el botón Download Mapping File.

Sugerencia:

Si tiene algún error de importación, es probable que la forma del archivo sea incorrecta. Revise y corrija los errores y descargue el archivo de asignación solo cuando haya importado correctamente el archivo de prueba.

Tarea 4: Edición de archivos de asignación

Puede editar los archivos de asignación generados por el cargador de datos de HCM. En esta tarea, editará el archivo de asignación de registro de documentos que generó en la tarea 2.

Descripción de la unidad de archivo

Abra el archivo DocumentsOfRecord.nxsd que ha generado en la Tarea 2.
Revise el contenido del archivo. Todos los archivos de correlación siguen la misma estructura; hay 3 tipos de grupos de elementos:
- Grupo ObjectFileData
  Habrá un grupo ObjectFileData, que se encuentra en la parte superior del archivo. Para cada objeto de negocio de la jerarquía, este grupo incluye un elemento ObjectLabel y un elemento Object:
  - El elemento ObjectLabel define la línea METADATA.
  - El elemento Object (Objeto) define la línea MERGE (datos).
  Sugerencia:
  También se define el formato de las líneas.
- Grupo ObjectLabel
  Hay un grupo ObjectLabel para cada objeto de negocio de la jerarquía de objetos. El grupo ObjectLabel incluye elementos para definir los nombres de los atributos disponibles para el objeto de negocio. Cuando OIC genera un archivo mediante esta asignación, los nombres de atributo (y los terminadores) se agregan al elemento ObjectLabel definido en el grupo ObjectFileData anterior.
- Grupo de objetos
  Hay un grupo de objetos para cada objeto de negocio de la jerarquía de objetos. El grupo de objeto incluye elementos para asignar los valores de los atributos disponibles para el objeto de negocio. Cuando OIC genera un archivo mediante esta asignación, los valores de atributo (y los terminadores) se agregan al elemento de objeto definido en el grupo ObjectFileData anterior.
Revise el grupo ObjectFileData DocumentOfRecordFileData.

La jerarquía de objetos de negocio DocumentsOfRecord tiene dos objetos: DocumentOfRecord y DocumentAttachment. Se generan un elemento ObjectLabel y un elemento Object para cada objeto de negocio de la jerarquía:

Revise el grupo ObjectLabel DocumentOfRecordsLabel.

Este grupo incluye un elemento para definir el nombre de cada atributo disponible para el objeto de negocio DocumentsOfRecord, incluidos los atributos de segmento de campo flexible desplegados.

Note:

El grupo completo es demasiado grande para mostrarse aquí.

Revise el grupo de objetos DocumentOfRecord.

Este grupo incluye un elemento para asignar los valores de cada atributo disponible para el objeto de negocio DocumentsOfRecord.

Sugerencia:

El orden de los atributos de los grupos de objetos y ObjectLabel para el mismo objeto de negocio debe coincidir.

Revise el grupo ObjectLabel DocumentAttachmentLabel.

Este grupo incluye un elemento para definir el nombre de cada atributo disponible para el objeto de negocio DocumentAttachment.

Revise el grupo de objetos DocumentAttachment.

Este grupo incluye un elemento para asignar los valores de cada atributo disponible para el objeto de negocio DocumentAttachment.

Editar la unidad DocumentOfRecord

OIC requiere que proporcione un valor para cada atributo definido por los elementos en el archivo de asignación. Si no necesita atributos en el archivo HDL generado, elimine ambos elementos para el atributo de los grupos ObjectLabel y Object.

Suprima los elementos de los grupos DocumentsOfRecordLabel y DocumentsOfRecord para todos los atributos, excepto estos:
- Nombre del Documento
- DocumentCode
- Número de persona
- DocumentType
Reordene los elementos de estos grupos para que aparezcan en este orden de atributos:
- Número de persona
- DocumentType
- DocumentCode
- Nombre del Documento
Note:
El último elemento del grupo tiene un valor terminatedBy diferente. La mayoría de los elementos se terminan con el carácter de pleca; el último se termina con un carácter de final de línea. Al editar el archivo, asegúrese de que el último elemento de cada grupo tiene el terminador de final de línea.
Sugerencia:
El orden de los elementos de estos grupos determina el orden en que los atributos se incluyen en el archivo generado por OIC. Por ejemplo, esta estructura generará esta línea METADATA:
```
METADATA|DocumentsOfRecord|PersonNumber|DocumentType|DocumentCode|DocumentName
```

Editar la unidad DocumentAttachment

Suprima los elementos de los grupos DocumentAttachmentLabel y DocumentAttachment para todos los atributos, excepto estos:
- Título
- Archivo
- DataTypeCode
- DocumentCode
- Número de persona
- DocumentType
- URLorTextorFileName
Reordene los elementos de estos grupos para que aparezcan en este orden de atributos:
- Número de persona
- DocumentType
- DocumentCode
- DataTypeCode
- URLorTextorFileName
- Título
- Archivo
Esto generará esta línea METADATA:
```
METADATA|DocumentAttachment|PersonNumber|DocumentType|DocumentCode|DataTypeCode|URLorTextorFileName|Title|File
```

Ahora puede importar el archivo a OIC para generar un archivo HDL DocumentOfRecord.dat.

Note:

Puede eliminar definiciones completas de objetos de negocio de los archivos de asignación generados si no necesita proporcionar datos para ellos. Para ello, asegúrese de eliminar los grupos ObjectLabel y el objeto para el objeto de negocio, además de los elementos ObjectLabel y el objeto del grupo ObjectFileData.

Adición de instrucciones SET a la forma de archivo

Puede que necesite incluir instrucciones SET en el archivo de objeto de negocio. La forma más sencilla de hacerlo es editar el nxsd para crear un elemento que le permita definir las instrucciones SET dentro de la asignación de OIC.

En este paso, editará el Worker.nxsd que ha generado en la tarea 3.

Abra el archivo Worker.nxsd que ha generado en la Tarea 3 en un editor de texto.

El elemento WorkerFileData se debe parecer al siguiente:

Edite este elemento para introducir una entrada de referencia antes de la referencia WorkerLabel. Agregar:

<element ref="tns:SetInstructions" minOccurs="0" nxsd:startsWith="">

Cree un nuevo elemento SetInstructions inmediatamente debajo del elemento WorkerFileData:

<!-- SetInstructions -->
  <element name="SetInstructions">
      <complexType>
         <sequence>
            <element name="Instruction" type="string" nxsd:style="terminated" nxsd:terminatedBy="${eol}" />
         </sequence>
      </complexType>
   </element>

Sugerencia:

Esto admite una instrucción SET. Cree elementos adicionales, como Instruction1, Instruction2, si necesita definir varias instrucciones SET en el archivo que va a generar OIC.

Pasos Siguientes

Siga los pasos de este tutorial para generar un archivo de asignación que OIC utiliza para generar los datos de origen en la unidad de archivo de objeto de negocio del cargador de datos de HCM.

Agradecimientos

Autores: Ema Johnson (mánager principal de productos)

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.

Título e Información de Copyright

Generar archivos de asignación de cargador de datos de HCM (HDL) para usarlos en Oracle Integration Cloud (OIC)

G35323-01

Mayo de 2025

Oracle y/o sus filiales.