Introducción

Automatice las integraciones del cargador de datos de HCM (HDL) y el cargador de datos de hoja de cálculo de HCM (HSDL) mediante la API de REST dataLoadDataSets.

Objetivos

En este tutorial, realizará lo siguiente:

  • Comprender cómo cargar archivos en el servidor de Oracle WebCenter Content.
  • Iniciar cargador de datos HCM y cargador de datos HCM de hojas de cálculo.
  • Control del estado del juego de datos y del objeto de negocio, recuperación de mensajes e información del proceso.

Requisitos

Para completar los pasos de este tutorial, necesitará:

  1. Acceso al uso de la API de REST de HDL.
  2. Siga los pasos de Acceso a REST del tutorial Configuración del acceso del cargador de datos de HCM (HDL) y descripción de las opciones de seguridad de HDL, asegurándose de otorgar acceso al privilegio Crear juego de datos de cargador de datos de HCM mediante servicio REST para completar la tarea 2.

  3. Para completar los pasos para iniciar HSDL mediante REST, deberá asignar su rol a la plantilla de HSDL ORA_PER_JOB o a la plantilla para la que iniciará HSDL.
  4. Siga los pasos Asignar acceso al juego de datos de un rol del tutorial Otorgar acceso para ejecutar el cargador de datos de hoja de cálculo de HCM.

  5. La capacidad de codificar archivos con codificación Base 64.
  6. Postman para enviar las llamadas a la API de REST.
  7. Los ejemplos de este tutorial utilizan variables de Postman para hacer referencia al entorno y otros valores que cambian.

    Variable Descripción
    {{env}} La ruta del entorno.
    {{user}} El nombre de usuario.
    {{RequestId}} Valor utilizado para identificar de forma única un juego de datos.
    {{DataSetBusObjId}} Valor que se usa para identificar de manera única un registro de objeto de negocio dentro de un juego de datos.
    {{ProcessId}} Valor que se usa para identificar de manera única un proceso ejecutado para un juego de datos.

    Note:

    Otros valores que deberá cambiar en el cuerpo de las llamadas REST se muestran en azul. Por ejemplo, <file_name>.
  8. Si desea tener la capacidad de generar archivos de línea con fallos mediante REST, también tendrá que activar el acceso de contenido de Oracle WebCenter a los archivos de error.
    • En Configuración y mantenimiento, busque el área funcional Cargador de datos de HCM y haga clic en Configurar cargador de datos de HCM.
    • Busque el parámetro Activar Acceso de Oracle WebCenter Content a Archivos de Error y defina la sustitución en cualquier valor distinto de No.
    • Buscar activación de Oracle WebCenter
    • Guardar y Cerrar.


Tarea 1: Carga del Archivo de Datos en Oracle WebCenter Content Server

Existen varias formas de cargar archivos en el servidor de Oracle WebCenter Content. Esta tarea proporciona dos opciones REST diferentes: la acción personalizada uploadFile disponible en el recurso dataLoadDataSets del cargador de datos de HCM y el recurso REST de Oracle WebCenter.

Si desea completar los pasos que se indican a continuación, puede descargar y utilizar estos archivos:


Acción de uploadFile del cargador de datos de HCM

  1. Abra Postman y cree una nueva solicitud POST para esta URL:
  2. https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/action/uploadFile
  3. Especifique el siguiente cuerpo de JSON:
  4. {
    "content" : "UEsDBBQAAAAIAJF+Qle0P8ZqHgEAAAQFAAAJAAAAR3JhZGUuZGF0ldPNaoQwEAfw+4LvsG+wmhhKDz2ERGyg2S269LqkGovQKqRxT3n4xu6Hxj3IQECZTH4h/BmZHSmnR+pyo2rtsqbRlW3PurTKWK7srJR19Vi4dLLed5fa+u+1slc/2tHbYTv8urIfTKUL3cRx8vLfsx3bo43Mijy73pg8k2QXj8ulTwna+YUT98rfTnnBT9KX2UHKw95J1akvbbaJo/NtmIaWGgo0BNPwUsOBhmFautTSQEthGllqJNBItIF4gt1zEF3dntt6UN8+zc6a9nOw/SWWqRsUi2BoBUcBDkpJMLyC4wAHhSZYuoKnAQ7KUDCygpMAB0bKp9HirdHVMkQOmy0eowcOzTnYcPEYB9w9qGkf9tyP95vn/+isHG3+AFBLAwQUAAAACAAbSlJXX/ch5FMCAAC9CgAABwAAAEpvYi5kYXTNldFumzAYhe8r9R14g5Fut7uwwElYY0LBq7SryCNOZI1AZUy1SH74GQdDnJCY9mpSpIjkP+ezzzGAIAYhwED+qH5LuNvRXLB3mgnCRUgElRkVQbWl7d/6OyYHfTEnB1Yc9U/ASERTy3lTFIkSY6bmUrpvCsIxPbxVnPCjFjalmq9KLUWkJHvKV/SdFjKrGp7TlO58f/ZdTXrtyOMDgukC6uU9+b7/xZ+pjwzWCK1juQxXmwysYLYJ1nHWXnoZKWitpGXdFIKUwhuGJJDzn6vVBkcIylTKC/kEVJxe4WjJKn5FdUEto/8ZrGfRIj3LtivNJmGFQCAGCzmzhVMZYXTOCBlXJ7HiN7dzYj3ZBm4WSp/xkCEi/A8VrNxfBohA+gxxFC9GQ+xN3Lw2b5vZ9fZJtOXnxutR096APG/wFu+8TGMzEWiqHIBWnfeJT5aPm5ik61CtDcVYMxNebZtcdFs80C5VM4VHUx083Ly2gQtmV+mn0LadGz/M9r1ec62Cb/DhwqrY9v3QOkzdI+uwb+P27F7ncF677epexWuiya8spwpPa7Y1qd+Ffe3EbgDsCPAvzZv2Nfdh1jfj44a9BBsMMwxPcb40pGDi2D4fBK8KD9NaqEpHT1GvnAQxB+eSYE6NBAG++Sw46d2cCG9AiCJ94UXYA9sDK1ktOGnPw+gujMRtvlRvsQQG2nuZetkbzZnaSy3GjbvxSb7DopXxhEUbySRzc6so6/7WuOU66QZIwK8hiYQcVY2FMw4jmmY/BGL8J6TSC6cx+kdIR7gfTqd4fPgHUEsBAhQAFAAAAAgAkX5CV7Q/xmoeAQAABAUAAAkAJAAAAAAAAAAgAAAAAAAAAEdyYWRlLmRhdAoAIAAAAAAAAQAYANn4TRNA9dkBAAAAAAAAAAAAAAAAAAAAAFBLAQIUABQAAAAIABtKUldf9yHkUwIAAL0KAAAHACQAAAAAAAEAIAAAAEUBAABKb2IuZGF0CgAgAAAAAAABABgAjuYejz/12QEAAAAAAAAAAAAAAAAAAAAAUEsFBgAAAAACAAIAtAAAAL0DAAAAAA==",
    "fileName" : "Grades and Jobs.zip"
    }

    Note:

    El valor del "contenido" es la versión codificada Base64 del archivo New Grades and Jobs.zip.

    Se necesitan el contenido y los parámetros fileName. Los siguientes parámetros están disponibles para la acción personalizada uploadFile:

    parámetro Descripción
    content Archivo codificado Base64 que se va a cargar.
    fileName Nombre del archivo.
    contentId Identificador único del archivo en el servidor de contenidos de Oracle WebCenter. Se genera automáticamente cuando no se proporciona.

  5. Configure la autorización para la solicitud. El usuario debe tener la jerarquía de rol Cargar datos para importación basada en archivo de Human Capital Management.
  6. Defina la cabecera Content-Type en el valor:
    application/vnd.oracle.adf.action+json
  7. Haga clic en Enviar.
  8. La respuesta tendrá este formato:

    {
        "result": {
            "Status": "SUCCESS",
            "ContentId": "UCMFA00078879"
        }
    }
  9. Revise la respuesta y anote el identificador de contenido. Es necesario identificar el archivo al iniciar HDL y HSDL.
  10. Base64 codifica el archivo Jobs.csv y utiliza estos pasos para cargar el archivo csv.

REST de Oracle WebCenter

La ventaja del recurso REST de Oracle WebCenter es que no tiene que codificar primero el archivo y, por lo tanto, este servicio REST podrá cargar archivos de origen más grandes. Sin embargo, es un poco más complejo de usar.

La acción uploadFile del cargador de datos de HCM solo cargará archivos en la cuenta de importación del cargador de datos de HCM en Oracle WebCenter. Esta API le permitirá cargar en cualquier cuenta de Oracle WebCenter a la que tenga acceso el usuario.

Creación de la solicitud

  1. Abra Postman y cree una nueva solicitud POST para esta URL:
  2. https://{{env}}/documents/files/data
  3. Especifique los siguientes form-data en el cuerpo:
  4. Tecla Valor
    metadataValues
    {
    "dDocAuthor":"{{user}}",
    "dDocTitle":"<file_name>",
    "dSecurityGroup":"FAFusionImportExport",
    "dDocAccount":"hcm$/dataloader$/import$",
    "dDocType":"Document"
    }

    Note:

    Sustituya <file_name> por el nombre de archivo.
    primaryFile

  5. Pase el mouse sobre la clave primaryFile para exponer la lista de opciones Texto/Archivo y defina el valor en Archivo.
    Desplace el mouse sobre la entrada primaryFile para ver la lista de opciones Texto/Archivo.

  6. Configure la autorización para la solicitud. El usuario debe tener la jerarquía de rol Cargar datos para importación basada en archivo de Human Capital Management.
  7. Guarde la solicitud. Ahora puede cargar archivos.

Carga de archivos

En este paso, utilizará la solicitud creada anteriormente para cargar archivos zip y csv en el servidor de Oracle WebCenter Content.

  1. En los datos de formulario del cuerpo de la solicitud, haga clic en Select Files
    Desplace el mouse sobre la entrada primaryFile para ver la lista de opciones Texto/Archivo.

    Sugerencia:

    El botón Seleccionar archivo solo está disponible cuando la lista de opciones primaryFile está definida en Archivo.
  2. Utilice el explorador de archivos para buscar y seleccionar el archivo.
  3. Desplace el mouse sobre la entrada primaryFile para ver la lista de opciones Texto/Archivo.

  4. Edite el valor metadataValues de la clave dDocTitle para especificar el nombre del archivo.
    Desplace el mouse sobre la entrada primaryFile para ver la lista de opciones Texto/Archivo.

    Sugerencia:

    Cuando inicia el cargador de datos de HCM, el nombre del juego de datos se establece por defecto en el valor que proporciona aquí.
  5. Haga clic en Enviar.
  6. La respuesta tendrá este formato:

    {
        "dWebExtension": "zip",
        "dRevClassID": "213206",
        "createdBy": "VISION_INTEGRATION",
        "modifiedBy": "VISION_INTEGRATION",
        "XFND_RANDOM": "4641327459804635554",
        "dReleaseState": "N",
        "dPublishState": "",
        "dID": "213551",
        "xComments": "",
        "errorCode": "0",
        "title": "Grades and Jobs.zip",
        "size": "1125",
        "createdTime": "10/3/23 7:27 AM",
        "dDocName": "UCMFA00213206",
        "mimeType": "application/zip",
        "dRevRank": "0",
        "dDocID": "426034",
        "name": "New Grades and Jobs.zip",
        "dDocAccount": "hcm$/dataloader$/import$",
        "ownedBy": "VISION_INTEGRATION",
        "xStorageRule": "FusionStorageRule",
        "dStatus": "DONE",
        "modifiedTime": "10/3/23 7:27 AM",
        "XFND_SIGNATURE": "Y-Qs7rQwyYANlmfo-....",
        "errorKey": "!csServiceStatusMessage_checkin,UCMFA00213206",
        "dExtension": "zip",
        "dWorkflowState": "",
        "XFND_SCHEME_ID": "1",
        "XFND_CERT_FP": "901B32887DDC81F780757624",
        "dPublishType": "",
        "dUser": "VISION_INTEGRATION",
        "dSecurityGroup": "FAFusionImportExport",
        "errorMessage": "Successfully checked in content item 'UCMFA00213206'.",
        "dRevisionID": "1",
        "version": "1"
    }
  7. Revise la respuesta y anote el identificador de contenido. Es necesario identificar el archivo al iniciar HDL y HSDL.
  8. Note:

    La API de REST de Oracle WebCenter Content utiliza la etiqueta dDocName para devolver el ID de contenido.
  9. Repita los pasos de Upload File para el archivo csv.


Tarea 2: Iniciar carga masiva de datos

Carga de datos con el cargador de datos de HCM

En este paso, llamará a la acción personalizada createFileDataSet para iniciar HDL para procesar un archivo cargado previamente en la cuenta hcm$/dataloader$/import$ en el servidor de Oracle WebCenter Content.

  1. En Postman, cree una nueva solicitud POST para esta URL:
  2. https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/action/createFileDataSet

    Note:

    Necesitará el privilegio de seguridad de la función Crear juego de datos de cargador de datos de HCM mediante servicio REST para enviar esta solicitud.
  3. Especifique el siguiente cuerpo de JSON:
  4. {
        "contentId" : "<content_id>"
    }

    Sugerencia:

    Sustituya el valor <content_id> por el ID de contenido del archivo.

    El único parámetro necesario es contentId. Los siguientes parámetros están disponibles para la acción personalizada createFileDataSet:

    parámetro Descripción Configurar el parámetro del cargador de datos de HCM que proporciona el valor por defecto
    contentId Identificador único del archivo en el servidor de contenidos de Oracle WebCenter.
    fileAction Los valores válidos son IMPORT_AND_LOAD y IMPORT_ONLY. Acción de Archivo
    dataSetName Nombre del conjunto de datos. El valor por defecto es el título del documento del archivo.
    importConcurrentThreads Número máximo de threads simultáneos que asignar al proceso de importación. Número máximo de threads simultáneos para importación
    loadConcurrentThreads Número máximo de threads simultáneos que asignar al proceso de carga. Número máximo de threads simultáneos para carga
    importMaxErrorPercentage Porcentaje máximo de registros con errores antes de que cese la importación. Porcentaje máximo de errores de importación
    loadMaxErrorPercentage Porcentaje máximo de registros con errores antes de que cese la carga. Porcentaje máximo de errores de carga
    fileEncryption Cifrado utilizado para el archivo de origen.

    Suministre NONE, PGPUNSIGNED o PGPSIGNED.

    Sugerencia:

    Siempre se recomienda cifrar los archivos antes de cargarlos en Oracle WebCenter. A la cuenta de importación del cargador de datos de HCM a menudo acceden varios usuarios, todos los cuales pueden descargar y revisar el contenido de los archivos no cifrados.

    Cifrado de archivos
    verificationKey Clave de verificación utilizada para el cifrado del archivo de origen. Suministre cuando fileEncryption sea PGPSIGNED.
    deleteSourceFile Indica si el archivo de origen se debe suprimir después de importar los datos a las tablas temporales. Suprimir archivo de origen

    Note:

    La última columna de la tabla especifica el nombre del parámetro en la tarea Configurar cargador de datos de HCM que define el valor por defecto para cada parámetro de API de REST.
  5. Configure la autorización para la solicitud. El usuario debe tener la jerarquía de rol Usar servicio REST - Juegos de datos de carga de datos.
  6. Defina la cabecera Content-Type en el valor:
    application/vnd.oracle.adf.action+json
  7. Haga clic en Enviar.
  8. La respuesta tendrá este formato:

    {
        "result": {
            "Status": "SUCCESS",
            "RequestId": "107468"
        }
    }

    Note:

    La RequestId de la respuesta se utiliza para recuperar la información del juego de datos mediante el recurso dataLoadDataSets.


Cargar datos con cargador de datos de hoja de cálculo de HCM

En este paso, llamará a la acción personalizada createSpreadsheetDataSet para iniciar HSDL para procesar un archivo cargado previamente en la cuenta hcm$/dataloader$/import$ en el servidor de Oracle WebCenter Content.

El archivo debe tener forma para la plantilla HSDL que está utilizando para cargar el archivo.

  1. En Postman, cree una nueva solicitud POST para esta URL:
  2. https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/action/createSpreadsheetDataSet
  3. Especifique el siguiente cuerpo de JSON:
  4. {
        "contentId" : "<content_id>",
        "templateCode" : "ORA_PER_JOB"
    }

    Sugerencia:

    Sustituya el valor <content_id> por el ID de contenido del archivo.

    Sugerencia:

    La plantilla ORA_PER_JOB es una plantilla preconfigurada disponible para cargar trabajos. Puede buscar códigos de plantilla mediante la tarea Ejecutar cargador de datos de hoja de cálculo.

    Los únicos parámetros necesarios son contentId y templateCode. Los siguientes parámetros están disponibles para la acción personalizada createSpreadsheetDataSet:

    parámetro Descripción Configurar el parámetro del cargador de datos de HCM que proporciona el valor por defecto
    contentId Identificador único del archivo en el servidor de contenidos de Oracle WebCenter.
    templateCode Código de plantilla de hoja de cálculo con el que cargar el archivo.
    fileAction Los valores válidos son IMPORT_AND_LOAD y IMPORT_ONLY.

    Sugerencia:

    Si solo importa el archivo, no puede supervisarlo ni cargarlo con REST; en cambio, genere una hoja de cálculo para la plantilla, recupere el juego de datos y cárguelo desde la hoja de cálculo.
    "IMPORT_AND_LOAD"
    dataSetName Nombre del conjunto de datos. El valor por defecto es el código de plantilla y el registro de hora.
    importConcurrentThreads Número máximo de threads simultáneos que asignar al proceso de importación. Número máximo de threads simultáneos para importación
    loadConcurrentThreads Número máximo de threads simultáneos que asignar al proceso de carga. Número máximo de threads simultáneos para carga
    importMaxErrorPercentage Porcentaje máximo de registros con errores antes de que cese la importación. Porcentaje máximo de errores de importación
    loadMaxErrorPercentage Porcentaje máximo de registros con errores antes de que cese la carga. Porcentaje máximo de errores de carga
    fileEncryption Cifrado utilizado para el archivo de origen.

    Suministre NONE, PGPUNSIGNED o PGPSIGNED.

    Sugerencia:

    Siempre se recomienda cifrar los archivos antes de cargarlos en Oracle WebCenter. A la cuenta de importación del cargador de datos de HCM a menudo acceden varios usuarios, todos los cuales pueden descargar y revisar el contenido de los archivos no cifrados.

    Cifrado de archivos
    verificationKey Clave de verificación utilizada para el cifrado del archivo de origen. Suministre cuando fileEncryption sea PGPSIGNED.
    deleteSourceFile Indica si el archivo de origen se debe suprimir después de importar los datos a las tablas temporales. Suprimir archivo de origen
    headerIncludedFlag Indica si se incluye una cabecera en el archivo de origen para asignar un nombre a los atributos incluidos en el archivo. "Y"
    attributeDelimiter Caracteres utilizados para separar valores en el archivo. "," (coma).
    newLineIndicator Caracteres utilizados para indicar una nueva línea. "n", con el prefijo del carácter de escape.
    escapeIndicator Caracteres utilizados para escapar de los caracteres delimitadores dentro de un valor de atributo. "/" (barra inversa)
    dateFormat Formato de fecha utilizado para los atributos con el tipo de datos de fecha El formato por defecto es AAAA/MM/DD.

  5. Configure la autorización para la solicitud. El usuario debe tener la jerarquía de rol Usar servicio REST - Juegos de datos de carga de datos.
  6. Defina la cabecera Content-Type en el valor:
    application/vnd.oracle.adf.action+json
  7. Haga clic en Enviar.
  8. La respuesta tendrá este formato:
    {
        "result": {
            "Status": "SUCCESS",
            "RequestId": "107483",
            "UserInfo": "",
            "Review": "https://{env}/hcmUI/oracle/apps/hcm/enterpriseSetup/hdlSpreadsheetLoader/di/GenericHdlSpreadsheet.xlsx?layoutCode=ORA_PER_JOB&dataSetName="Job#2024-08-06 11:40:56"",
            "FileAction": "IMPORT_AND_LOAD",
            "DataSetName": ""Job#2024-08-06 11:40:56""
        }
    }

    Note:

    Utilice RequestId de la respuesta para supervisar el estado del juego de datos mediante el recurso dataLoadDataSets.

    Sugerencia:

    Utilice el enlace Revisar para generar una hoja de cálculo a partir de la plantilla de HSDL para revisar el juego de datos.


Tarea 3: Supervisión del estado del juego de datos

En este paso, supervisará el estado del juego de datos mediante el recurso dataLoadDataSets. Este recurso se puede utilizar para supervisar los conjuntos de datos HDL y HSDL.

Sugerencia:

Los archivos HSDL que solo se importan no crean un juego de datos en las tablas temporales del cargador de datos de HCM y no se pueden supervisar mediante REST.

Supervisión de un juego de datos específico

  1. En Postman, cree una nueva solicitud GET para esta URL:
  2. https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}

    Note:

    Sustituya {{RequestId}} por el valor RequestId devuelto cuando envió su archivo.
  3. Configure la autorización para la solicitud y haga clic en Enviar.
  4. La respuesta tendrá este formato:

    {
        "RequestId": 107468,
        "DataSetId": 300100621962415,
        "ContentId": "UCMFA00103266",
        "DataSetName": "Grades and Jobs.zip",
        "DataSetStatusCode": "ORA_IN_ERROR",
        "DataSetStatusMeaning": "Error",
        "TransferStatusCode": "SUCCESS",
        "TransferStatusMeaning": "Success",
        "ImportStatusCode": "SUCCESS",
        "ImportStatusMeaning": "Success",
        "LoadStatusCode": "ERROR",
        "LoadStatusMeaning": "Error",
        "SourceTypeCode": "ZIP_DAT_FILE",
        "SourceTypeMeaning": "Compressed DAT file",
        "IntegrationTypeCode": null,
        "IntegrationTypeMeaning": null,
        "ImportPercentageComplete": 100,
        "LoadPercentageComplete": 100,
        "ImportSuccessPercentage": 100,
        "LoadSuccessPercentage": 59,
        "FileLineTotalCount": 38,
        "FileLineImportErrorCount": 0,
        "FileLineImportSuccessCount": 38,
        "ObjectTotalCount": 37,
        "ObjectLoadErrorCount": 15,
        "ObjectRollbackErrorCount": 0,
        "ObjectSuccessCount": 22,
        "ObjectUnprocessedCount": 0,
        "SpreadsheetTemplateCode": null,
        "SpreadsheetTemplateName": null,
        "SpreadsheetTemplateUserTypeCode": null,
        "SpreadsheetTemplateUserTypeMeaning": null,
        "SpreadsheetMessage": null,
        "FileSize": 1175,
        "CreatedBy": "HCM_USER10",
        "CreationDate": "2024-08-06T11:38:28+00:00",
        "LastUpdatedBy": "HCM_USER10",
        "LastUpdateDate": "2024-08-06T11:40:04.127+00:00",
        "ProtectedFlag": false,
        "Review": null,
        "FailedLinesFileContentId": null,
        "FailedLinesFileEncryptionType": null,
        "FailedLinesFileEncryptionKey": null,
        "links": [
        ...
        ]
    }
  5. Repita el proceso para el archivo csv, la respuesta devolverá información para los elementos relacionados con la hoja de cálculo.

Identificar Juegos de Datos con Errores

Utilice esta URL para recuperar la información de resumen de todos los juegos de datos con errores:

https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets?q=DataSetStatusCode=ORA_IN_ERROR&fields=RequestId,DataSetName,DataSetStatusCode,ImportStatusCode,LoadStatusCode,SourceTypeCode,FileLineTotalCount,FileLineImportErrorCount,ObjectTotalCount,ObjectLoadErrorCount,LastUpdateDate&onlyData=true

La respuesta tendrá este formato:

{
    "items": [
        {
            "RequestId": 107483,
            "DataSetName": "Job#2024-08-06 11:40:56",
            "DataSetStatusCode": "ORA_IN_ERROR",
            "ImportStatusCode": "SUCCESS",
            "LoadStatusCode": "ERROR",
            "SourceTypeCode": "SPREADSHEET",
            "FileLineTotalCount": 6,
            "FileLineImportErrorCount": 0,
            "ObjectTotalCount": 6,
            "ObjectLoadErrorCount": 2,
            "LastUpdateDate": "2024-08-06T11:42:13.333+00:00"
        },
        {
            "RequestId": 107468,
            "DataSetName": "Grades and Jobs.zip",
            "DataSetStatusCode": "ORA_IN_ERROR",
            "ImportStatusCode": "SUCCESS",
            "LoadStatusCode": "ERROR",
            "SourceTypeCode": "ZIP_DAT_FILE",
            "FileLineTotalCount": 38,
            "FileLineImportErrorCount": 0,
            "ObjectTotalCount": 37,
            "ObjectLoadErrorCount": 15,
            "LastUpdateDate": "2024-08-06T11:40:04.127+00:00"
        },...

Supervisión de juegos de datos para una plantilla de HSDL específica

Utilice esta URL para recuperar información de resumen para todos los juegos de datos cargados con una plantilla de hoja de cálculo específica:

https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets?q=SpreadsheetTemplateCode=ORA_PER_JOB&fields=RequestId,DataSetName,ImportStatusCode,LoadStatusCode,SourceTypeCode,ObjectTotalCount,ObjectLoadErrorCount,Review&onlyData=true

La respuesta tendrá este formato:

{
    "items": [
        {
            "RequestId": 107483,
            "DataSetName": "Job#2024-08-06 11:40:56",
            "ImportStatusCode": "SUCCESS",
            "LoadStatusCode": "ERROR",
            "SourceTypeCode": "SPREADSHEET",
            "ObjectTotalCount": 6,
            "ObjectLoadErrorCount": 2,
            "Review": "https://cptapniqy.fusionapps.ocs.oc-test.com:443/hcmUI/oracle/apps/hcm/enterpriseSetup/hdlSpreadsheetLoader/di/GenericHdlSpreadsheet.xlsx?layoutCode=ORA_PER_JOB&dataSetName=Job#2024-08-06 11:40:56"
        }
    ],
    "count": 1,
    "hasMore": false,
    "limit": 25,
    "offset": 0,
    "links": [
	...


Tarea 4: Supervisión del estado del objeto de negocio

Cuando el juego de datos HDL tiene varios archivos de objeto de negocio, puede que desee supervisar el estado de los objetos de negocio individuales.

Revisar todos los objetos de negocio de un juego de datos

  1. En Postman, cree una nueva solicitud GET para esta URL:
  2. https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/businessObjects?onlyData=true

    Note:

    Sustituya {{RequestId}} por el valor RequestId devuelto cuando envió su archivo.
  3. Configure la autorización para la solicitud y haga clic en Enviar.
  4. La respuesta tendrá este formato:

    {
        "items": [
            {
                "DataSetBusObjId": 300100621962438,
                "BusinessObjectDiscriminator": "Grade",
                "BusinessObjectName": "Grade",
                "DatFileName": "Grade.dat",
                "LoadOrder": 1,
                "BusinessObjectId": 300100028324439,
                "TransferStatusCode": "SUCCESS",
                "TransferStatusMeaning": "Success",
                "ImportStatusCode": "SUCCESS",
                "ImportStatusMeaning": "Success",
                "LoadStatusCode": "SUCCESS",
                "LoadStatusMeaning": "Success",
                "ImportPercentageComplete": 100,
                "LoadPercentageComplete": 100,
                "ImportSuccessPercentage": 100,
                "LoadSuccessPercentage": 100,
                "FileLineTotalCount": 14,
                "FileLineImportErrorCount": 0,
                "FileLineImportSuccessCount": 14,
                "ObjectTotalCount": 14,
                "ObjectLoadErrorCount": 0,
                "ObjectRollbackErrorCount": 0,
                "ObjectSuccessCount": 14,
                "ObjectUnprocessedCount": 0,
                "DataSetId": 300100621962415,
                "RequestId": 107468,
                "CreatedBy": "HCM_USER10",
                "CreationDate": "2024-08-06T11:38:29+00:00",
                "LastUpdateDate": "2024-08-06T11:39:24.490+00:00",
                "LastUpdatedBy": "FUSION_APPS_HCM_ESS_LOADER_APPID",
                "RollbackEnabledFlag": false,
                "FailedLinesFileContentId": null,
                "FailedLinesFileEncryptionType": null,
                "FailedLinesFileEncryptionKey": null
            },
            {
                "DataSetBusObjId": 300100621962439,
                "BusinessObjectDiscriminator": "Job",
                "BusinessObjectName": "Job",
                "DatFileName": "Job.dat",
                "LoadOrder": 2,
                "BusinessObjectId": 300100028327309,
                "TransferStatusCode": "SUCCESS",
                "TransferStatusMeaning": "Success",
                "ImportStatusCode": "SUCCESS",
                "ImportStatusMeaning": "Success",
                "LoadStatusCode": "ERROR",
                "LoadStatusMeaning": "Error",
                "ImportPercentageComplete": 100,
                "LoadPercentageComplete": 100,
                "ImportSuccessPercentage": 100,
                "LoadSuccessPercentage": 34,
                "FileLineTotalCount": 24,
                "FileLineImportErrorCount": 0,
                "FileLineImportSuccessCount": 24,
                "ObjectTotalCount": 23,
                "ObjectLoadErrorCount": 15,
                "ObjectRollbackErrorCount": 0,
                "ObjectSuccessCount": 8,
                "ObjectUnprocessedCount": 0,
                "DataSetId": 300100621962415,
                "RequestId": 107468,
                "CreatedBy": "HCM_USER10",
                "CreationDate": "2024-08-06T11:38:29.004+00:00",
                "LastUpdateDate": "2024-08-06T11:39:58.914+00:00",
                "LastUpdatedBy": "FUSION_APPS_HCM_ESS_LOADER_APPID",
                "RollbackEnabledFlag": false,
                "FailedLinesFileContentId": null,
                "FailedLinesFileEncryptionType": null,
                "FailedLinesFileEncryptionKey": null
            }
        ],
        "count": 2,
        "hasMore": false,
        "limit": 25,
        "offset": 0,
        "links": [
                ...


Supervisión de un objeto de negocio específico en un juego de datos

  1. En Postman, cree una nueva solicitud GET para esta URL:
  2. https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/businessObjects/{{DataSetBusObjId}}?onlyData=true&fields=DataSetBusObjId,BusinessObjectName,LoadOrder,TransferStatusCode,ImportStatusCode,LoadStatusCode,ImportSuccessPercentage,LoadSuccessPercentage,FileLineTotalCount,FileLineImportErrorCount,ObjectTotalCount,ObjectSuccessCount,ObjectLoadErrorCount

    Note:

    Sustituya {{RequestId}} por el valor RequestId devuelto cuando envió su archivo y {{DataSetBusObjId}} por DataSetBusObjId para el registro de objeto de negocio que desea recuperar.
  3. Configure la autorización para la solicitud y haga clic en Enviar.
  4. La respuesta tendrá este formato:

    {
        "DataSetBusObjId": 300100621962439,
        "BusinessObjectName": "Job",
        "LoadOrder": 2,
        "TransferStatusCode": "SUCCESS",
        "ImportStatusCode": "SUCCESS",
        "LoadStatusCode": "ERROR",
        "ImportSuccessPercentage": 100,
        "LoadSuccessPercentage": 34,
        "FileLineTotalCount": 24,
        "FileLineImportErrorCount": 0,
        "ObjectTotalCount": 23,
        "ObjectSuccessCount": 8,
        "ObjectLoadErrorCount": 15
    }


Identificar objetos de negocio con errores

  1. Utilice esta URL para recuperar la información de resumen de todos los objetos de negocio del juego de datos con errores durante la carga:
  2. https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/businessObjects?q=LoadStatusCode=ERROR&fields=DataSetBusObjId,LoadOrder,BusinessObjectName,TransferStatusCode,ImportStatusCode,LoadStatusCode,FileLineTotalCount,FileLineImportErrorCount,ObjectTotalCount,ObjectLoadErrorCount&onlyData=true
  3. Configure la autorización para la solicitud y haga clic en Enviar.
  4. La respuesta tendrá este formato:

    {
        "items": [
            {
                "DataSetBusObjId": 300100621962439,
                "LoadOrder": 2,
                "BusinessObjectName": "Job",
                "TransferStatusCode": "SUCCESS",
                "ImportStatusCode": "SUCCESS",
                "LoadStatusCode": "ERROR",
                "FileLineTotalCount": 24,
                "FileLineImportErrorCount": 0,
                "ObjectTotalCount": 23,
                "ObjectLoadErrorCount": 15
            }
        ]...


Tarea 5: Recuperar mensajes

Cuando el juego de datos tiene errores, puede recuperar los mensajes emitidos para él junto con los identificadores de los registros en los que se informa cada mensaje.

Recuperar todos los mensajes de un juego de datos

  1. En Postman, cree una nueva solicitud GET para esta URL:
  2. https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/messages?totalResults=true&orderBy=DatFileName,FileLine&fields=DatFileName,BusinessObjectDiscriminator,OriginatingProcessCode,FileLine,ConcatenatedUserKey,SourceSystemOwner,SourceSystemId,SourceReference001,MessageTypeCode,MessageText,MessageUserDetails&onlyData=true

    Note:

    Sustituya {{RequestId}} por el valor RequestId devuelto cuando envió su archivo.
  3. Configure la autorización para la solicitud y haga clic en Enviar.
  4. La respuesta tendrá este formato:

    {
        "items": [
            {
                "DatFileName": "Job.dat",
                "BusinessObjectDiscriminator": "Job",
                "OriginatingProcessCode": "LOAD",
                "FileLine": 4,
                "ConcatenatedUserKey": "HDL_SNR_SALES_CONS-COMMON",
                "SourceSystemOwner": null,
                "SourceSystemId": null,
                "SourceReference001": "HDL_SNR_SALES_CONS",
                "MessageTypeCode": "ERROR",
                "MessageText": "You need to enter a valid value for the JobFamilyId attribute. The current values are HDL_SALES.",
                "MessageUserDetails": null
            },
            {
                "DatFileName": "Job.dat",
                "BusinessObjectDiscriminator": "Job",
                "OriginatingProcessCode": "LOAD",
                "FileLine": 10,
                "ConcatenatedUserKey": "HDL_MRKT_DIR-COMMON",
                "SourceSystemOwner": null,
                "SourceSystemId": null,
                "SourceReference001": "HDL_MRKT_DIR",
                "MessageTypeCode": "ERROR",
                "MessageText": "You need to enter a valid value for the JobFamilyId attribute. The current values are HDL_MARKETING.",
                "MessageUserDetails": null
            },
            {
                "DatFileName": "Job.dat",
                "BusinessObjectDiscriminator": "Job",
                "OriginatingProcessCode": "LOAD",
                "FileLine": 5,
                "ConcatenatedUserKey": "HDL_SALES_MGR-COMMON",
                "SourceSystemOwner": null,
                "SourceSystemId": null,
                "SourceReference001": "HDL_SALES_MGR",
                "MessageTypeCode": "ERROR",
                "MessageText": "The FT value for the FullPartTime attribute is invalid and doesn't exist in the  list of values.",
                "MessageUserDetails": null
            },
    ...
    


Tarea 6: Generar archivo de líneas con fallos

Además de extraer directamente la información del mensaje, puede iniciar la generación de un archivo de líneas con fallos. Estos archivos incluyen todas las líneas de datos con errores y, opcionalmente, incluyen el texto del mensaje.

Sugerencia:

Los archivos de líneas con fallos generados se pueden descargar de la cuenta hcm$/dataloader$/export$ en Oracle WebCenter.

Generar un archivo de líneas con fallos para el juego de datos

  1. En Postman, cree una nueva solicitud POST para esta URL:
  2. https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/action/generateFailedLinesFile

    Note:

    Sustituya {{RequestId}} por el valor RequestId devuelto cuando envió su archivo.
  3. Especifique el siguiente cuerpo de JSON:
  4. {
      "includeMessagesFlag" : "Y",
      "messageLanguage" : "US",
      "fileEncryption" : "PGPUNSIGNED",
      "encryptionKey" : "<customer-key>"
    }

    Sugerencia:

    Sustituya <clave de cliente> por el nombre del certificado PGP que utilizará para cifrar los archivos. Proporcione el nombre especificado en la página Certificados de la consola de seguridad.
    A continuación, se muestra la Descripción de sample-arch-image.png

    Los siguientes parámetros están disponibles para esta acción personalizada:

    parámetro Descripción Valor por defecto Obligatorio
    includeMessagesFlag Determina si los mensajes de advertencia y error se incluyen en el archivo. Suministro Y o N. "N"
    messageLanguage Indica el código de dos letras que identifica el idioma en el que se deben proporcionar mensajes. "Estados Unidos"
    fileEncryption Tipo de cifrado con el que cifrar el archivo generado.

    Los valores válidos son PGPUNSIGNED, PGPSIGNED y NONE.

    Siempre. Al no cifrar los archivos, debe especificar NONE.
    encryptionKey Certificado PGP con el que cifrar el archivo generado. Esto debe estar disponible en la lista de certificados PGP en la consola de seguridad. HDL cifrará su archivo con la clave pública para que usted lo descifre con su clave privada. Cuando fileEncryption es PGPUNSIGNED o PGPSIGNED.

  5. Defina la cabecera Content-Type en el valor:
    application/vnd.oracle.adf.action+json
  6. Configure la autorización para la solicitud y haga clic en Enviar.
  7. La respuesta tendrá este formato:
    {
        "result": {
            "Status": "SUCCESS",
            "RequestId": "107640",
            "ErrorFileContentID": "107468_ERRFILE",
            "UserInfo": "The file will be available on the Oracle WebCenter on completion of this process."
        }
    }

  8. Utilice esta URL de GET para recuperar los detalles del archivo del recurso dataLoadDataSets:
    https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}?onlyData=true&fields=FailedLinesFileContentId,FailedLinesFileEncryptionType,FailedLinesFileEncryptionKey

    Note:

    Sustituya {{RequestId}} por el valor RequestId devuelto cuando envió su archivo.
    La respuesta será similar a:
    {
        "FailedLinesFileContentId": "107468_ERRFILE",
        "FailedLinesFileEncryptionType": "PGPUNSIGNED",
        "FailedLinesFileEncryptionKey": "customer-key"
    }

Generar un archivo de líneas con fallos para un objeto de negocio

La acción personalizada generateFailedLinesFile también está disponible en el recurso secundario businessObjects. Tiene los mismos parámetros que la acción personalizada de nivel de juego de datos.

  1. En Postman, cree una nueva solicitud POST para esta URL:
  2. https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/businessObjects/{{DataSetBusObjId}}/action/generateFailedLinesFile

    Note:

    Sustituya {{RequestId}} por el valor RequestId devuelto cuando envió su archivo y {{DataSetBusObjId}} por el valor DataSetBusObjId para el objeto de negocio en el juego de datos para el que desea generar el archivo.
  3. Especifique el siguiente cuerpo de JSON:
  4. {
      "includeMessagesFlag" : "Y",
      "messageLanguage" : "US",
      "fileEncryption" : "PGPUNSIGNED",
      "encryptionKey" : "customer-key"
    }
  5. Defina la cabecera Content-Type en el valor:
    application/vnd.oracle.adf.action+json
  6. Configure la autorización para la solicitud y haga clic en Enviar.
  7. La respuesta tendrá este formato:
    {
        "result": {
            "Status": "SUCCESS",
            "RequestId": "107669",
            "ErrorFileContentID": "107468_JOB_ERRFILE",
            "UserInfo": "The file will be available on the Oracle WebCenter on completion of this process."
        }
    }
  8. Utilice esta URL de GET para recuperar los detalles del archivo del recurso dataLoadDataSets:
    https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/businessObjects/{{DataSetBusObjId}}?onlyData=true&fields=FailedLinesFileContentId,FailedLinesFileEncryptionType,FailedLinesFileEncryptionKey
    La respuesta será similar a:

    También puede obtener los detalles más recientes del archivo del recurso businessObjects, como se describe en la tarea 4. La respuesta incluirá estos campos:

    {
        "FailedLinesFileContentId": "107468_JOB_ERRFILE",
        "FailedLinesFileEncryptionType": "PGPUNSIGNED",
        "FailedLinesFileEncryptionKey": "customer-key"
    }


Tarea 7: Recuperar detalles de proceso enviado

Puede recuperar información sobre los procesos y subprocesos ejecutados para el juego de datos.

Recuperar detalles de proceso

Normalmente, vería un registro para los procesos de transferencia, importación y carga de cada objeto de negocio del juego de datos, junto con cualquier objeto de negocio y proceso posterior de juego de datos. Habrá procesos adicionales si ha enviado un procesamiento posterior del juego de datos, como volver a enviar la carga, enviar la anulación o generar una línea de líneas con fallos.

  1. En Postman, cree una nueva solicitud GET para esta URL:
  2. https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/processes?onlyData=true&fields=ProcessId,ProcessCode,BusinessObjectName,FileActionCode,TotalCount,ErrorCount,ElapsedTime,ThreadsAllocated,ThreadsUsed
  3. Configure la autorización para la solicitud y haga clic en Enviar.
  4. Así es como la respuesta puede buscar un juego de datos que contenga el objeto de negocio Worker. En este ejemplo, la carga se ha enviado dos veces para el objeto de negocio.

    {
        "items": [
            {
                "ProcessId": 300100618948404,
                "ProcessCode": "ORA_TRANSFER_OBJECT",
                "BusinessObjectName": "Worker",
                "FileActionCode": null,
                "TotalCount": 540,
                "ErrorCount": 0,
                "ElapsedTime": "+000000000 00:00:40.347000",
                "ThreadsAllocated": 8,
                "ThreadsUsed": 1
            },
            {
                "ProcessId": 300100618948432,
                "ProcessCode": "ORA_IMPORT_OBJECT",
                "BusinessObjectName": "Worker",
                "FileActionCode": null,
                "TotalCount": 540,
                "ErrorCount": 0,
                "ElapsedTime": "+000000000 00:00:13.475000",
                "ThreadsAllocated": 8,
                "ThreadsUsed": 8
            },
            {
                "ProcessId": 300100618950528,
                "ProcessCode": "ORA_LOAD_OBJECT",
                "BusinessObjectName": "Worker",
                "FileActionCode": "IMPORT_AND_LOAD",
                "TotalCount": 54,
                "ErrorCount": 54,
                "ElapsedTime": "+000000000 00:00:43.242000",
                "ThreadsAllocated": 8,
                "ThreadsUsed": 3
            },
            {
                "ProcessId": 300100618950575,
                "ProcessCode": "ORA_HDL_POST_PROCESS",
                "BusinessObjectName": "Worker",
                "FileActionCode": null,
                "TotalCount": 0,
                "ErrorCount": 0,
                "ElapsedTime": "+000000000 00:00:43.444000",
                "ThreadsAllocated": null,
                "ThreadsUsed": null
            },
            {
                "ProcessId": 300100619031844,
                "ProcessCode": "ORA_LOAD_OBJECT",
                "BusinessObjectName": "Worker",
                "FileActionCode": "ORA_LOAD",
                "TotalCount": 54,
                "ErrorCount": 11,
                "ElapsedTime": "+000000000 00:14:56.706000",
                "ThreadsAllocated": 8,
                "ThreadsUsed": 3
            },
            {
                "ProcessId": 300100619039767,
                "ProcessCode": "ORA_HDL_POST_PROCESS",
                "BusinessObjectName": "Worker",
                "FileActionCode": null,
                "TotalCount": 0,
                "ErrorCount": 0,
                "ElapsedTime": "+000000000 00:00:34.738000",
                "ThreadsAllocated": null,
                "ThreadsUsed": null
            },
            {
                "ProcessId": 300100619039775,
                "ProcessCode": "ORA_ORACLE_SEARCH",
                "BusinessObjectName": "Worker",
                "FileActionCode": null,
                "TotalCount": 0,
                "ErrorCount": 0,
                "ElapsedTime": "+000000000 00:01:41.009000",
                "ThreadsAllocated": null,
                "ThreadsUsed": null
            }
     
    ...


Recuperar información de subproceso

Los subprocesos son un recurso secundario del recurso processes. Recupera los detalles de los subprocesos enviados por un proceso especificado. Para los procesos de transferencia, importación y carga, estos serán detalles de los procesos de varios hilos conductores. Para ORA_HDL_POST_PROCESS, se detallarán los procesos de contabilización individuales enviados.

  1. En Postman, cree una nueva solicitud GET para esta URL:
  2. https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/processes/{{ProcessId}}/child/subprocesses?onlyData=true&fields=ProcessName,ProcessId,ProcessCode,Elapsedtime,ProcessStatusMeaning

    Note:

    Sustituya {{RequestId}} por el valor RequestId devuelto cuando envió su archivo y {ProcessId}} por ProcessId para el proceso para el que desea que se realicen los subprocesos.
  3. Configure la autorización para la solicitud y haga clic en Enviar.
  4. Así es como la respuesta puede buscar el proceso ORA_HDL_POST_PROCESS ejecutado para el objeto de negocio Worker.

    {
        "items": [
            {
                "ProcessName": "Refresh Manager Hierarchy",
                "ProcessId": 300100619039790,
                "ProcessCode": "WORKER_REFRESHMANAGERHIERARCHY",
                "Elapsedtime": "+000000000 00:00:08.216000",
                "ProcessStatusMeaning": "Succeeded"
            },
            {
                "ProcessName": "Update Person Search Keywords",
                "ProcessId": 300100619037746,
                "ProcessCode": "WORKER_UPDATEPERSONSEARCHKEYWORDS",
                "Elapsedtime": "+000000000 00:00:09.093000",
                "ProcessStatusMeaning": "Succeeded"
            },
            {
                "ProcessName": "EMEA Localization Postprocessing",
                "ProcessId": 300100619037756,
                "ProcessCode": "WORKER_EMEALOCALIZATIONPOSTPROCESSING",
                "Elapsedtime": "+000000000 00:00:02.959000",
                "ProcessStatusMeaning": "Succeeded"
            },
            {
                "ProcessName": "Global Tax Reporting Unit Maintenance",
                "ProcessId": 300100619037764,
                "ProcessCode": "WORKER_GLOBALTAXREPORTINGUNITMAINTENANCE",
                "Elapsedtime": "+000000000 00:00:02.702000",
                "ProcessStatusMeaning": "Succeeded"
            }
     ...


Tarea 8: Enviar procesamiento de un juego de datos existente

Si el archivo del cargador de datos de HCM solo se importó o si desea intentar cargar registros con fallos anteriores, puede enviar la carga del juego de datos. Si ha cargado correctamente los registros, puede enviar el rollback para el juego de datos. El rollback solo se inicia para objetos de negocio que soportan la acción de rollback.

Sugerencia:

El elemento RollbackEnabledFlag del recurso businessObjects indica si el objeto de negocio soporta el rollback.

Envío del procesamiento de un juego de datos

  1. En Postman, cree una nueva solicitud POST para esta URL:
  2. https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/action/submit

    Note:

    Sustituya {{RequestId}} por el valor RequestId devuelto cuando envió su archivo.
  3. Especifique el siguiente cuerpo de JSON:
  4. {
    "fileAction" : "LOAD"
    }

    Los siguientes parámetros están disponibles para esta acción personalizada:

    parámetro Descripción Valor por defecto
    fileAction Los valores válidos son LOAD y ROLLBACK.

    Sugerencia:

    Para los archivos HSDL, si solo importa el archivo, no puede cargarlo con REST; en cambio, genere una hoja de cálculo para la plantilla, recupere el juego de datos y cárguelo desde la hoja de cálculo.
    "LOAD"
    loadConcurrentThreads Número máximo de threads simultáneos que asignar al proceso de carga. Se establece por defecto en el parámetro Máximo de Threads Simultáneos para Carga.

  5. Defina la cabecera Content-Type en el valor:
    application/vnd.oracle.adf.action+json
  6. Configure la autorización para la solicitud y haga clic en Enviar.
  7. La respuesta tendrá este formato:
    {
        "result": {
            "Status": "SUCCESS",
            "RequestId": "107683"
        }
    }


Ejecutar procesamiento para un objeto de negocio dentro de un juego de datos

La acción personalizada enviar también está disponible en el nivel de objeto de negocio, donde tiene los mismos parámetros pero solo ejecuta el procesamiento del objeto de negocio especificado por la URL.

Utilice esta URL para iniciar el procesamiento de un objeto de negocio específico.

https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/businessObjects/{{DataSetBusObjId}}/action/submit

Note:

Sustituya {{DataSetBusObjId}} por el valor DataSetBusObjId devuelto al revisar el objeto de negocio dentro del juego de datos.

Sugerencia:

Puede probar esto mediante la codificación Base64, la carga y el envío del archivo JobFamily.zip, que crea las familias de trabajos a las que hace referencia el archivo Job.dat con el error anterior.

Una vez que las familias de puestos se hayan cargado correctamente, inicie LOAD para el juego de datos o el objeto de negocio Job dentro del juego de datos como se ha descrito anteriormente.



Tarea 9: Detener un juego de datos en curso u objeto de negocio

Puede solicitar parar los juegos de datos y los objetos de negocio en curso.

Detener el procesamiento de un juego de datos

  1. En Postman, cree una nueva solicitud POST para esta URL:
  2. https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/action/stop

    No hay parámetros para esta acción.

  3. Defina la cabecera Content-Type en el valor:
    application/vnd.oracle.adf.action+json
  4. Configure la autorización para la solicitud y haga clic en Enviar.
  5. Si el juego de datos no está en curso actualmente, obtendrá esta respuesta:

    {
        "result": "You can't stop processing this data set because it isn't being processed. Check the current status of the data set."
    }


Detener procesamiento de un objeto de negocio

La acción personalizada stop también está disponible en el nivel de objeto de negocio. Utilice esta URL para solicitar que se detenga el procesamiento de un objeto de negocio específico:

https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/businessObjects/{{DataSetBusObjId}}/action/stop

Note:

Sustituya {{DataSetBusObjId}} por el valor DataSetBusObjId devuelto al revisar el objeto de negocio dentro del juego de datos.

Tarea 10: Supresión de un juego de datos

Si no se están procesando, puede eliminar los datos de la tabla temporal de los conjuntos de datos.

Suprimir datos de tabla temporal de HDL

  1. En Postman, cree una nueva solicitud POST para esta URL:
  2. https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/action/deleteDataSet

    No hay parámetros para esta acción.

  3. Defina la cabecera Content-Type en el valor:
    application/vnd.oracle.adf.action+json
  4. Configure la autorización para la solicitud y haga clic en Enviar.

Suprimir datos de tabla temporal de HSDL

Si ejecuta esta acción, se eliminará el juego de datos de las tablas temporales HSDL y HDL.

  1. En Postman, cree una nueva solicitud POST para esta URL:
  2. https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/action/deleteSpreadsheetDataSet

    No hay parámetros para esta acción.

  3. Defina la cabecera Content-Type en el valor:
    application/vnd.oracle.adf.action+json
  4. Configure la autorización para la solicitud y haga clic en Enviar.


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.