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á:
- Acceso al uso de la API de REST de HDL.
- 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.
- La capacidad de codificar archivos con codificación Base 64.
- Postman para enviar las llamadas a la API de REST.
- 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.
- Guardar y Cerrar.
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.
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.
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>.
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:
- Nuevos grupos y Jobs.zip para el cargador de datos de HCM.
- Jobs.csv para el cargador de datos de la hoja de cálculo de HCM.
Acción de uploadFile del cargador de datos de HCM
- Abra Postman y cree una nueva solicitud POST para esta URL:
- Especifique el siguiente cuerpo de JSON:
- 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.
- Defina la cabecera Content-Type en el valor:
application/vnd.oracle.adf.action+json
- Haga clic en Enviar.
- Revise la respuesta y anote el identificador de contenido. Es necesario identificar el archivo al iniciar HDL y HSDL.
- Base64 codifica el archivo Jobs.csv y utiliza estos pasos para cargar el archivo csv.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/action/uploadFile
{
"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. |
La respuesta tendrá este formato:
{
"result": {
"Status": "SUCCESS",
"ContentId": "UCMFA00078879"
}
}
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
- Abra Postman y cree una nueva solicitud POST para esta URL:
- Especifique los siguientes form-data en el cuerpo:
- Pase el mouse sobre la clave primaryFile para exponer la lista de opciones Texto/Archivo y defina el valor en Archivo.
- 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.
- Guarde la solicitud. Ahora puede cargar archivos.
https://{{env}}/documents/files/data
| 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 |
Carga de archivos
En este paso, utilizará la solicitud creada anteriormente para cargar archivos zip y csv en el servidor de Oracle WebCenter Content.
- En los datos de formulario del cuerpo de la solicitud, haga clic en Select Files
Sugerencia:
El botón Seleccionar archivo solo está disponible cuando la lista de opciones primaryFile está definida en Archivo. - Utilice el explorador de archivos para buscar y seleccionar el archivo.
- Edite el valor metadataValues de la clave dDocTitle para especificar el nombre del 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í. - Haga clic en Enviar.
- Revise la respuesta y anote el identificador de contenido. Es necesario identificar el archivo al iniciar HDL y HSDL.
- Repita los pasos de Upload File para el archivo csv.
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"
}
Note:
La API de REST de Oracle WebCenter Content utiliza la etiqueta dDocName para devolver el ID de contenido.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.
- En Postman, cree una nueva solicitud POST para esta URL:
- Especifique el siguiente cuerpo de JSON:
- 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.
- Defina la cabecera Content-Type en el valor:
application/vnd.oracle.adf.action+json
- Haga clic en Enviar.
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.{
"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.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.
- En Postman, cree una nueva solicitud POST para esta URL:
- Especifique el siguiente cuerpo de JSON:
- 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.
- Defina la cabecera Content-Type en el valor:
application/vnd.oracle.adf.action+json
- Haga clic en Enviar. La respuesta tendrá este formato:
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/action/createSpreadsheetDataSet
{
"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. |
{
"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
- En Postman, cree una nueva solicitud GET para esta URL:
- Configure la autorización para la solicitud y haga clic en Enviar.
- Repita el proceso para el archivo csv, la respuesta devolverá información para los elementos relacionados con la hoja de cálculo.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}
Note:
Sustituya {{RequestId}} por el valor RequestId devuelto cuando envió su archivo.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": [
...
]
}
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
- En Postman, cree una nueva solicitud GET para esta URL:
- Configure la autorización para la solicitud y haga clic en Enviar.
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.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
- En Postman, cree una nueva solicitud GET para esta URL:
- Configure la autorización para la solicitud y haga clic en Enviar.
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.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
- 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:
- Configure la autorización para la solicitud y haga clic en Enviar.
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
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
- En Postman, cree una nueva solicitud GET para esta URL:
- Configure la autorización para la solicitud y haga clic en Enviar.
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.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
- En Postman, cree una nueva solicitud POST para esta URL:
- Especifique el siguiente cuerpo de JSON:
- Defina la cabecera Content-Type en el valor:
application/vnd.oracle.adf.action+json
- Configure la autorización para la solicitud y haga clic en Enviar. La respuesta tendrá este formato:
- 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,FailedLinesFileEncryptionKeyLa respuesta será similar a:Note:
Sustituya {{RequestId}} por el valor RequestId devuelto cuando envió su archivo.{ "FailedLinesFileContentId": "107468_ERRFILE", "FailedLinesFileEncryptionType": "PGPUNSIGNED", "FailedLinesFileEncryptionKey": "customer-key" }
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/action/generateFailedLinesFile
Note:
Sustituya {{RequestId}} por el valor RequestId devuelto cuando envió su archivo.{
"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.
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. |
{
"result": {
"Status": "SUCCESS",
"RequestId": "107640",
"ErrorFileContentID": "107468_ERRFILE",
"UserInfo": "The file will be available on the Oracle WebCenter on completion of this process."
}
}
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.
- En Postman, cree una nueva solicitud POST para esta URL:
- Especifique el siguiente cuerpo de JSON:
- Defina la cabecera Content-Type en el valor:
application/vnd.oracle.adf.action+json
- Configure la autorización para la solicitud y haga clic en Enviar. La respuesta tendrá este formato:
- 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,FailedLinesFileEncryptionKeyLa 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" }
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.{
"includeMessagesFlag" : "Y",
"messageLanguage" : "US",
"fileEncryption" : "PGPUNSIGNED",
"encryptionKey" : "customer-key"
}
{
"result": {
"Status": "SUCCESS",
"RequestId": "107669",
"ErrorFileContentID": "107468_JOB_ERRFILE",
"UserInfo": "The file will be available on the Oracle WebCenter on completion of this process."
}
}
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.
- En Postman, cree una nueva solicitud GET para esta URL:
- Configure la autorización para la solicitud y haga clic en Enviar.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/processes?onlyData=true&fields=ProcessId,ProcessCode,BusinessObjectName,FileActionCode,TotalCount,ErrorCount,ElapsedTime,ThreadsAllocated,ThreadsUsed
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.
- En Postman, cree una nueva solicitud GET para esta URL:
- Configure la autorización para la solicitud y haga clic en Enviar.
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.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
- En Postman, cree una nueva solicitud POST para esta URL:
- Especifique el siguiente cuerpo de JSON:
- Defina la cabecera Content-Type en el valor:
application/vnd.oracle.adf.action+json
- Configure la autorización para la solicitud y haga clic en Enviar. La respuesta tendrá este formato:
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/action/submit
Note:
Sustituya {{RequestId}} por el valor RequestId devuelto cuando envió su archivo.{
"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. |
{
"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
- En Postman, cree una nueva solicitud POST para esta URL:
- Defina la cabecera Content-Type en el valor:
application/vnd.oracle.adf.action+json
- Configure la autorización para la solicitud y haga clic en Enviar.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/action/stop
No hay parámetros para esta acción.
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
- En Postman, cree una nueva solicitud POST para esta URL:
- Defina la cabecera Content-Type en el valor:
application/vnd.oracle.adf.action+json
- Configure la autorización para la solicitud y haga clic en Enviar.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/action/deleteDataSet
No hay parámetros para esta acción.
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.
- En Postman, cree una nueva solicitud POST para esta URL:
- Defina la cabecera Content-Type en el valor:
application/vnd.oracle.adf.action+json
- Configure la autorización para la solicitud y haga clic en Enviar.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/action/deleteSpreadsheetDataSet
No hay parámetros para esta acción.
Enlaces relacionados
- Manual de soluciones: Carga de datos en Oracle Fusion Cloud Human Capital Management (HCM)
- Guía del usuario: Cargador de datos de HCM
- HCM Data Loader Oracle mediante tutoriales de ejemplo
En la sección Operate (Operar) se describen otras formas de cargar archivos en el servidor de Oracle WebCenter Content.
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.
Uso de la API de REST del cargador de datos de HCM
G35312-01
Mayo de 2025
Copyright ©2025,
Oracle y/o sus filiales.