Introduzione
Automatizza le integrazioni del programma di caricamento dati HCM (HDL) e del programma di caricamento dati foglio di calcolo HCM (HSDL) utilizzando l'API REST dataLoadDataSets.
Obiettivi
In questa esercitazione:
- Comprendere come caricare i file nel server Oracle WebCenter Content.
- Avvia il programma di caricamento dati HCM e il caricamento dati foglio di calcolo HCM.
- Monitorare lo stato del set di dati e del business object, recuperare i messaggi e le informazioni sul processo.
Prerequisiti
Per completare i passaggi di questa esercitazione, è necessario:
- Accesso all'uso dell'API REST HDL.
- Per completare i passi per l'avvio di HSDL tramite REST, è necessario assegnare il ruolo al modello HSDL ORA_PER_JOB o al modello per il quale si avvierà HSDL.
- La possibilità di codificare file con codifica Base 64.
- Postman per sottomettere le chiamate API REST.
- Se si desidera poter generare file di riga non riusciti utilizzando REST, sarà inoltre necessario abilitare l'accesso al contenuto di Oracle WebCenter ai file di errore.
- In Impostazione e manutenzione, individuare l'area funzionale Programma di caricamento dati HCM e fare clic su Configura programma di caricamento dati HCM.
- Cercare il parametro Abilita accesso a file di errore di Oracle WebCenter Content e impostare l'override su un valore diverso da No.
- Salva e chiudi
Per completare il task 2, eseguire i passi Accesso REST nell'esercitazione su Configura accesso HDL (HCM Data Loader) e comprendere le opzioni di sicurezza HDL, assicurandosi di concedere l'accesso al privilegio Crea set di dati programma di caricamento dati HCM mediante servizio REST.
Attenersi alla procedura di assegnazione dell'accesso al set di dati di un ruolo nell'esercitazione Concedere l'accesso all'esecuzione del programma di caricamento dati foglio di calcolo HCM.
Gli esempi di questa esercitazione utilizzano variabili Postman per fare riferimento all'ambiente e ad altri valori che cambiano.
| Variabile | Descrizione |
|---|---|
| {{env}} | Il percorso ambientale. |
| {{user}} | Il nome utente. |
| {{RequestId}} | Valore utilizzato per identificare in modo univoco un data set. |
| {{DataSetBusObjId}} | Valore utilizzato per identificare in modo univoco un record business object all'interno di un data set. |
| {{ProcessId}} | Valore utilizzato per identificare in modo univoco un processo sottomesso per un data set. |
Nota
Gli altri valori che è necessario modificare nel corpo delle chiamate REST vengono visualizzati in blu. Ad esempio, <file_name>.
Task 1: Caricamento del file di dati nel server Oracle WebCenter Content
Esistono diversi modi per caricare i file nel server Oracle WebCenter Content. Questo task fornisce due opzioni REST diverse: l'azione personalizzata uploadFile disponibile nella risorsa dataLoadDataSets del programma di caricamento dati HCM e la risorsa REST di Oracle WebCenter.
Se vuoi completare i passaggi che seguono puoi scaricare e utilizzare questi file:
- Nuovi livelli e Jobs.zip per il programma di caricamento dati HCM.
- Jobs.csv per il programma di caricamento dei dati foglio di calcolo HCM.
Azione uploadFile programma di caricamento dati HCM
- Aprire Postman e creare una nuova richiesta POST per questo URL:
- Specificare il seguente corpo JSON:
- Configurare l'autorizzazione per la richiesta. L'utente deve disporre della gerarchia di ruoli Carica dati per importazione basata su file Human Capital Management.
- Impostare l'intestazione Tipo di contenuto sul valore indicato di seguito.
application/vnd.oracle.adf.action+json
- Fare clic su Invia.
- Rivedere la risposta e prendere nota dell'ID contenuto. È necessario identificare il file quando si avvia HDL e HSDL.
- Base64 codifica il file Jobs.csv e usa questi passaggi per caricare il file 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"
}
Nota
Il valore del "contenuto" è la versione codificata Base64 del file Nuovi livelli e Jobs.zip.Il contenuto e i parametri fileName sono obbligatori. Per l'azione personalizzata uploadFile sono disponibili i parametri riportati di seguito.
| Parametro | Descrizione |
|---|---|
| content | File codificato Base64 da caricare. |
| fileName | Il nome del file. |
| contentId | Identificativo univoco del file nel content server Oracle WebCenter. Generato automaticamente, se non fornito. |
La risposta avrà il seguente formato:
{
"result": {
"Status": "SUCCESS",
"ContentId": "UCMFA00078879"
}
}
REST Oracle WebCenter
Il vantaggio della risorsa REST di Oracle WebCenter è che non è necessario codificare prima il file, pertanto questo servizio REST sarà in grado di caricare file di origine di dimensioni maggiori. Tuttavia, è un po 'più complesso da usare.
L'azione uploadFile del programma di caricamento dati HCM caricherà i file solo nell'account di importazione del programma di caricamento dati HCM in Oracle WebCenter. Questa API consentirà di eseguire il caricamento in qualsiasi account Oracle WebCenter a cui l'utente ha accesso.
Crea la richiesta
- Aprire Postman e creare una nuova richiesta POST per questo URL:
- Specificare i dati_modulo seguenti nel corpo:
- Passare il puntatore del mouse sulla chiave primaryFile per esporre l'elenco di scelte Testo/File e impostare il valore su File.
- Configurare l'autorizzazione per la richiesta. L'utente deve disporre della gerarchia di ruoli Carica dati per importazione basata su file Human Capital Management.
- Salvare la richiesta. È ora possibile caricare i file.
https://{{env}}/documents/files/data
| Legenda | Valore |
|---|---|
| metadataValues | {
"dDocAuthor":"{{user}}",
"dDocTitle":"<file_name>",
"dSecurityGroup":"FAFusionImportExport",
"dDocAccount":"hcm$/dataloader$/import$",
"dDocType":"Document"
}
Nota Sostituire <file_name> con il nome del file. |
| primaryFile |
Caricare i file
In questo passo verrà utilizzata la richiesta creata in precedenza per caricare i file ZIP e CSV nel server Oracle WebCenter Content.
- Nei dati del form del corpo della richiesta, fare clic su Seleziona file
Suggerimento
Il pulsante Seleziona file è disponibile solo se l'elenco di scelte primaryFile è impostato su File. - Utilizzare File Browser per trovare e selezionare il file.
- Modificare il valore della chiave metadataValues dDocTitle per specificare il nome del file.
Suggerimento
Quando si avvia il programma di caricamento dati HCM, il nome del set di dati viene impostato automaticamente sul valore fornito qui. - Fare clic su Invia.
- Rivedere la risposta e prendere nota dell'ID contenuto. È necessario identificare il file quando si avvia HDL e HSDL.
- Ripetere la procedura per caricare il file per il file CSV.
La risposta avrà il seguente 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"
}
Nota
L'API REST di Oracle WebCenter Content utilizza l'etichetta dDocName per restituire l'ID contenuto.Task 2: Avvia caricamento dati in blocco
Carica dati con il programma di caricamento dati HCM
In questo passo si chiama l'azione personalizzata createFileDataSet per avviare HDL per elaborare un file caricato in precedenza nell'account hcm$/dataloader$/import$ sul server Oracle WebCenter Content.
- In Postman creare una nuova richiesta POST per questo URL:
- Specificare il seguente corpo JSON:
- Configurare l'autorizzazione per la richiesta. L'utente deve disporre della gerarchia di ruoli Usa servizio REST - Data Load Data Sets.
- Impostare l'intestazione Tipo di contenuto sul valore indicato di seguito.
application/vnd.oracle.adf.action+json
- Fare clic su Invia.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/action/createFileDataSet
Nota
Per sottomettere questa richiesta, sarà necessario disporre del privilegio di sicurezza della funzione Crea set di dati programma di caricamento dati HCM mediante servizio REST.{
"contentId" : "<content_id>"
}
Suggerimento
Sostituire il valore <content_id> con l'ID contenuto del file.L'unico parametro richiesto è contentId. Per l'azione personalizzata createFileDataSet sono disponibili i parametri riportati di seguito.
| Parametro | Descrizione | Configurare il parametro del programma di caricamento dati HCM che fornisce il valore predefinito |
|---|---|---|
| contentId | Identificativo univoco del file nel content server Oracle WebCenter. | |
| fileAction | I valori validi sono IMPORT_AND_LOAD e IMPORT_ONLY. | Azione file |
| dataSetName | Nome del data set. Il valore predefinito è il titolo del documento del file. | |
| importConcurrentThreads | Numero massimo di thread concorrenti da assegnare al processo di importazione. | Numero massimo di thread concorrenti per l'importazione |
| loadConcurrentThreads | Numero massimo di thread concorrenti da assegnare al processo di caricamento. | Numero massimo di thread concorrenti per il caricamento |
| importMaxErrorPercentage | Percentuale massima di record con errori prima che l'importazione cessi. | Percentuale massima di errori importazione |
| loadMaxErrorPercentage | Percentuale massima di record con errori prima che il caricamento cessi. | Percentuale massima di errori caricamento |
| fileEncryption | Cifratura utilizzata per il file di origine.
Fornire NESSUNO, PGPUNSIGNED o PGPSIGNED. Suggerimento Si consiglia sempre di cifrare i file prima di caricarli in Oracle WebCenter. L'account di importazione del programma di caricamento dati HCM è spesso accessibile da vari utenti, che possono tutti scaricare ed esaminare il contenuto dei file non cifrati. |
Cifratura file |
| verificationKey | Chiave di verifica utilizzata per la cifratura del file di origine. Fornire quando fileEncryption è PGPSIGNED. | |
| deleteSourceFile | Indica se il file di origine deve essere eliminato dopo l'importazione dei dati nelle tabelle di staging. | Elimina il file di origine |
Nota
L'ultima colonna della tabella specifica il nome del parametro nel task Configura programma di caricamento dati HCM che definisce il valore predefinito per ogni parametro API REST.La risposta avrà il seguente formato:
{
"result": {
"Status": "SUCCESS",
"RequestId": "107468"
}
}
Nota
Il file RequestId della risposta viene utilizzato per recuperare le informazioni sul data set utilizzando la risorsa dataLoadDataSets.Carica dati con il programma di caricamento dati foglio di calcolo HCM
In questo passo si chiama l'azione personalizzata createSpreadsheetDataSet per avviare HSDL per elaborare un file caricato in precedenza nell'account hcm$/dataloader$/import$ sul server Oracle WebCenter Content.
La forma del file deve corrispondere al modello HSDL utilizzato per caricare il file.
- In Postman creare una nuova richiesta POST per questo URL:
- Specificare il seguente corpo JSON:
- Configurare l'autorizzazione per la richiesta. L'utente deve disporre della gerarchia di ruoli Usa servizio REST - Data Load Data Sets.
- Impostare l'intestazione Tipo di contenuto sul valore indicato di seguito.
application/vnd.oracle.adf.action+json
- Fare clic su Invia. La risposta avrà il seguente formato:
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/action/createSpreadsheetDataSet
{
"contentId" : "<content_id>",
"templateCode" : "ORA_PER_JOB"
}
Suggerimento
Sostituire il valore <content_id> con l'ID contenuto del file.Suggerimento
Il modello ORA_PER_JOB è un modello preconfigurato disponibile per il caricamento dei job. È possibile trovare i codici modello utilizzando il task Esegui programma di caricamento dati foglio di calcolo.Gli unici parametri richiesti sono contentId e templateCode. Per l'azione personalizzata createSpreadsheetDataSet sono disponibili i parametri riportati di seguito.
| Parametro | Descrizione | Configurare il parametro del programma di caricamento dati HCM che fornisce il valore predefinito |
|---|---|---|
| contentId | Identificativo univoco del file nel content server Oracle WebCenter. | |
| templateCode | Codice modello foglio di calcolo con cui caricare il file. | |
| fileAction | I valori validi sono IMPORT_AND_LOAD e IMPORT_ONLY.
Suggerimento Se si importa solo il file, non è possibile monitorarlo o caricarlo con REST, generare invece un foglio di calcolo per il modello, recuperare il data set e caricarlo dal foglio di calcolo. |
"IMPORT_AND_LOAD" |
| dataSetName | Nome del data set. | Il valore predefinito è il codice del modello e l'indicatore orario. |
| importConcurrentThreads | Numero massimo di thread concorrenti da assegnare al processo di importazione. | Numero massimo di thread concorrenti per l'importazione |
| loadConcurrentThreads | Numero massimo di thread concorrenti da assegnare al processo di caricamento. | Numero massimo di thread concorrenti per il caricamento |
| importMaxErrorPercentage | Percentuale massima di record con errori prima che l'importazione cessi. | Percentuale massima di errori importazione |
| loadMaxErrorPercentage | Percentuale massima di record con errori prima che il caricamento cessi. | Percentuale massima di errori caricamento |
| fileEncryption | Cifratura utilizzata per il file di origine.
Fornire NESSUNO, PGPUNSIGNED o PGPSIGNED. Suggerimento Si consiglia sempre di cifrare i file prima di caricarli in Oracle WebCenter. L'account di importazione del programma di caricamento dati HCM è spesso accessibile da vari utenti, che possono tutti scaricare ed esaminare il contenuto dei file non cifrati. |
Cifratura file |
| verificationKey | Chiave di verifica utilizzata per la cifratura del file di origine. Fornire quando fileEncryption è PGPSIGNED. | |
| deleteSourceFile | Indica se il file di origine deve essere eliminato dopo l'importazione dei dati nelle tabelle di staging. | Elimina il file di origine |
| headerIncludedFlag | Indica se nel file di origine è inclusa un'intestazione per assegnare un nome agli attributi inclusi nel file. | "S" |
| attributeDelimiter | Caratteri utilizzati per separare i valori nel file. | "," (virgola). |
| newLineIndicator | Caratteri utilizzati per indicare una nuova riga. | "n", preceduto dal carattere di escape. |
| escapeIndicator | Caratteri utilizzati per eseguire l'escape dei caratteri delimitatori all'interno di un valore attributo. | "/" (barra rovesciata) |
| dateFormat | Formato data utilizzato per gli attributi con tipo di dati data | Il formato di default è AAAA/MM/GG. |
{
"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""
}
}
Nota
Utilizzare RequestId dalla risposta per monitorare lo stato del data set utilizzando la risorsa dataLoadDataSets.Suggerimento
Utilizzare il collegamento Revisione per generare un foglio di calcolo dal modello HSDL per rivedere il data set.Task 3: Controlla stato set di dati
In questo passo è possibile monitorare lo stato del data set utilizzando la risorsa dataLoadDataSets. Questa risorsa può essere utilizzata per monitorare sia i data set HDL che HSDL.
Suggerimento
I file HSDL importati solo non creano un data set nelle tabelle intermedie del programma di caricamento dati HCM e non possono essere monitorati mediante REST.Monitorare un set di dati specifico
- In Postman creare una nuova richiesta GET per questo URL:
- Configurare l'autorizzazione per la richiesta e fare clic su Invia.
- Ripetere per il file CSV, la risposta restituirà informazioni per gli elementi correlati al foglio di calcolo.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}
Nota
Sostituire {{RequestId}} con il valore RequestId restituito al momento della sottomissione del file.La risposta avrà il seguente 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": [
...
]
}
Identifica i data set in errore
Utilizzare questo URL per recuperare le informazioni di riepilogo per tutti i data set in errore:
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 risposta avrà il seguente 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"
},...
Monitorare i data set per un modello HSDL specifico
Utilizzare questo URL per recuperare le informazioni di riepilogo per tutti i data set caricati con un modello di foglio di calcolo specifico:
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 risposta avrà il seguente 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": [
...
Task 4: Controlla stato business object
Se il set di dati HDL contiene più file di business object, è possibile monitorare lo stato dei singoli business object.
Rivedi tutti i business object in un set di dati
- In Postman creare una nuova richiesta GET per questo URL:
- Configurare l'autorizzazione per la richiesta e fare clic su Invia.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/businessObjects?onlyData=true
Nota
Sostituire {{RequestId}} con il valore RequestId restituito al momento della sottomissione del file.La risposta avrà il seguente 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": [
...
Monitorare un business object specifico in un data set
- In Postman creare una nuova richiesta GET per questo URL:
- Configurare l'autorizzazione per la richiesta e fare clic su Invia.
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
Nota
Sostituire {{RequestId}} con il valore RequestId restituito quando si sottomette il file e {{DataSetBusObjId}} con il valore DataSetBusObjId per il record del business object da recuperare.La risposta avrà il seguente 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
}
Identifica business object in errore
- Utilizzare questo URL per recuperare le informazioni di riepilogo per tutti i business object nel data set in errore durante il caricamento:
- Configurare l'autorizzazione per la richiesta e fare clic su Invia.
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 risposta avrà il seguente formato:
{
"items": [
{
"DataSetBusObjId": 300100621962439,
"LoadOrder": 2,
"BusinessObjectName": "Job",
"TransferStatusCode": "SUCCESS",
"ImportStatusCode": "SUCCESS",
"LoadStatusCode": "ERROR",
"FileLineTotalCount": 24,
"FileLineImportErrorCount": 0,
"ObjectTotalCount": 23,
"ObjectLoadErrorCount": 15
}
]...
Task 5: Recupera messaggi
Quando il set di dati contiene errori, è possibile recuperare i messaggi generati insieme agli identificativi per i record per i quali viene segnalato ogni messaggio.
Recupera tutti i messaggi per un set di dati
- In Postman creare una nuova richiesta GET per questo URL:
- Configurare l'autorizzazione per la richiesta e fare clic su Invia.
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
Nota
Sostituire {{RequestId}} con il valore RequestId restituito al momento della sottomissione del file.La risposta avrà il seguente 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
},
...
Task 6: Genera file linee non riuscite
Oltre all'estrazione diretta delle informazioni sui messaggi, è possibile avviare la generazione di un file di righe non riuscite. Questi file includono tutte le righe di dati con errori e facoltativamente includono il testo del messaggio.
Suggerimento
I file delle righe non riuscite generati possono essere scaricati dall'account hcm$/dataloader$/export$ in Oracle WebCenter.Generazione di un file di linee non riuscite per il data set
- In Postman creare una nuova richiesta POST per questo URL:
- Specificare il seguente corpo JSON:
- Impostare l'intestazione Tipo di contenuto sul valore indicato di seguito.
application/vnd.oracle.adf.action+json
- Configurare l'autorizzazione per la richiesta e fare clic su Invia. La risposta avrà il seguente formato:
- Utilizzare questo URL GET per recuperare i dettagli del file dalla risorsa dataLoadDataSets:
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}?onlyData=true&fields=FailedLinesFileContentId,FailedLinesFileEncryptionType,FailedLinesFileEncryptionKeyLa risposta sarà simile a:Nota
Sostituire {{RequestId}} con il valore RequestId restituito al momento della sottomissione del file.{ "FailedLinesFileContentId": "107468_ERRFILE", "FailedLinesFileEncryptionType": "PGPUNSIGNED", "FailedLinesFileEncryptionKey": "customer-key" }
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/action/generateFailedLinesFile
Nota
Sostituire {{RequestId}} con il valore RequestId restituito al momento della sottomissione del file.{
"includeMessagesFlag" : "Y",
"messageLanguage" : "US",
"fileEncryption" : "PGPUNSIGNED",
"encryptionKey" : "<customer-key>"
}
Suggerimento
Sostituire <chiave-cliente> con il nome del certificato PGP che verrà utilizzato per cifrare i file. Fornire il nome specificato trovato nella pagina Certificati della Console sicurezza.
Per questa azione personalizzata sono disponibili i parametri riportati di seguito.
| Parametro | Descrizione | Valore predefinito | Obbligatorio. |
|---|---|---|---|
| includeMessagesFlag | Determina se i messaggi di avvertenza e di errore sono inclusi nel file. Fornitura Y o N. | "N" | |
| messageLanguage | Il codice di due lettere per identificare la lingua in cui fornire i messaggi. | "Stati Uniti" | |
| fileEncryption | Tipo di cifratura con cui cifrare il file generato. I valori validi sono PGPUNSIGNED, PGPSIGNED e NONE. |
Always. Quando non si crittografano i file è necessario specificare NONE. | |
| encryptionKey | Il certificato PGP con cui cifrare il file generato. Questo deve essere disponibile nell'elenco dei certificati PGP nella console di sicurezza. HDL crittografa il file con la chiave pubblica per la decifrazione con la chiave privata. | Quando fileEncryption è 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."
}
}
Genera un file di linee non riuscite per un business object
L'azione personalizzata generateFailedLinesFile è disponibile anche nella risorsa businessObjects figlio. Ha gli stessi parametri dell'azione personalizzata a livello di set di dati.
- In Postman creare una nuova richiesta POST per questo URL:
- Specificare il seguente corpo JSON:
- Impostare l'intestazione Tipo di contenuto sul valore indicato di seguito.
application/vnd.oracle.adf.action+json
- Configurare l'autorizzazione per la richiesta e fare clic su Invia. La risposta avrà il seguente formato:
- Utilizzare questo URL GET per recuperare i dettagli del file dalla risorsa dataLoadDataSets:
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/businessObjects/{{DataSetBusObjId}}?onlyData=true&fields=FailedLinesFileContentId,FailedLinesFileEncryptionType,FailedLinesFileEncryptionKeyLa risposta sarà simile a:È inoltre possibile ottenere i dettagli del file più recenti dalla risorsa businessObjects, come descritto nel task 4. La risposta includerà i seguenti campi:
{ "FailedLinesFileContentId": "107468_JOB_ERRFILE", "FailedLinesFileEncryptionType": "PGPUNSIGNED", "FailedLinesFileEncryptionKey": "customer-key" }
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/businessObjects/{{DataSetBusObjId}}/action/generateFailedLinesFile
Nota
Sostituire {{RequestId}} con il valore RequestId restituito quando si sottomette il file e {{DataSetBusObjId}} con il valore DataSetBusObjId per il business object nel set di dati per il quale si desidera generare il file.{
"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."
}
}
Task 7: Recupera dettagli processo sottomesso
È possibile recuperare informazioni sui processi e i sottoprocessi sottomessi per il data set.
Recupera dettagli processo
In genere, viene visualizzato un record per i processi di trasferimento, importazione e caricamento per ogni business object nel set di dati, insieme a qualsiasi postprocesso di business object e set di dati. Se è stata sottomessa un'ulteriore elaborazione del set di dati, ad esempio risottomettere il caricamento, sottomettere il rollback o generare una linea di linee non riuscite, saranno presenti processi aggiuntivi.
- In Postman creare una nuova richiesta GET per questo URL:
- Configurare l'autorizzazione per la richiesta e fare clic su Invia.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/processes?onlyData=true&fields=ProcessId,ProcessCode,BusinessObjectName,FileActionCode,TotalCount,ErrorCount,ElapsedTime,ThreadsAllocated,ThreadsUsed
In questo modo la risposta potrebbe cercare un set di dati contenente il business object Lavoratore. In questo esempio, Load è stato sottomesso due volte per il business object.
{
"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
}
...
Recupera informazioni processo secondario
I processi secondari sono una risorsa figlio della risorsa processi. Recupera i dettagli dei sottoprocessi sottomessi da un processo specificato. Per i processi di trasferimento, importazione e caricamento, questi saranno i dettagli dei processi multi-thread. Per ORA_HDL_POST_PROCESS questo dettaglierà i singoli processi post inviati.
- In Postman creare una nuova richiesta GET per questo URL:
- Configurare l'autorizzazione per la richiesta e fare clic su Invia.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/processes/{{ProcessId}}/child/subprocesses?onlyData=true&fields=ProcessName,ProcessId,ProcessCode,Elapsedtime,ProcessStatusMeaning
Nota
Sostituire {{RequestId}} con il valore RequestId restituito quando si sottomette il file e {ProcessId}} con ProcessId per il processo per il quale si desidera che vengano eseguiti i processi secondari.In questo modo la risposta potrebbe cercare il processo ORA_HDL_POST_PROCESS sottomesso per il business object Lavoratore.
{
"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"
}
...
Task 8: Sottometti elaborazione di un set di dati esistente
Se il file del programma di caricamento dati HCM è stato importato solo o si desidera tentare di caricare i record precedentemente non riusciti, è possibile sottomettere il caricamento per il data set. Se i record sono stati caricati correttamente, è possibile sottomettere il rollback per il set di dati. Il rollback viene avviato solo per i business object che supportano l'azione di rollback.
Suggerimento
L'elemento RollbackEnabledFlag nella risorsa businessObjects indica se il business object supporta il rollback.Sottometti elaborazione di un set di dati
- In Postman creare una nuova richiesta POST per questo URL:
- Specificare il seguente corpo JSON:
- Impostare l'intestazione Tipo di contenuto sul valore indicato di seguito.
application/vnd.oracle.adf.action+json
- Configurare l'autorizzazione per la richiesta e fare clic su Invia. La risposta avrà il seguente formato:
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/action/submit
Nota
Sostituire {{RequestId}} con il valore RequestId restituito al momento della sottomissione del file.{
"fileAction" : "LOAD"
}
Per questa azione personalizzata sono disponibili i parametri riportati di seguito.
| Parametro | Descrizione | Valore predefinito |
|---|---|---|
| fileAction | I valori validi sono LOAD e ROLLBACK.
Suggerimento Per i file HSDL, se si importa solo il file, non è possibile caricarlo con REST, generare invece un foglio di calcolo per il modello, recuperare il data set e caricarlo dal foglio di calcolo. |
"Scarica" |
| loadConcurrentThreads | Numero massimo di thread concorrenti da assegnare al processo di caricamento. | Valore predefinito del parametro Numero massimo di thread concorrenti per il caricamento. |
{
"result": {
"Status": "SUCCESS",
"RequestId": "107683"
}
}
Sottomette l'elaborazione per un business object all'interno di un data set
L'azione personalizzata Sottometti è disponibile anche a livello di business object in cui ha gli stessi parametri, ma sottomette solo l'elaborazione del business object specificato dall'URL.
Utilizzare questo URL per avviare l'elaborazione per un business object specifico.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/businessObjects/{{DataSetBusObjId}}/action/submit
Nota
Sostituire {{DataSetBusObjId}} con il valore DataSetBusObjId restituito durante la revisione del business object all'interno del data set.Suggerimento
È possibile eseguire il test mediante la codifica Base64, il caricamento e la sottomissione del file JobFamily.zip, che crea le famiglie professionali a cui fa riferimento il file Job.dat con un errore precedente.Una volta che le famiglie di mansioni sono state caricate correttamente, avviare LOAD per il data set o il business object Mansione all'interno del data set come descritto in precedenza.
Task 9: Arresta un set di dati o un business object in corso
È possibile richiedere l'interruzione dei data set e dei business object in corso.
Interrompi elaborazione di un data set
- In Postman creare una nuova richiesta POST per questo URL:
- Impostare l'intestazione Tipo di contenuto sul valore indicato di seguito.
application/vnd.oracle.adf.action+json
- Configurare l'autorizzazione per la richiesta e fare clic su Invia.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/action/stop
Nessun parametro per questa azione.
Se il set di dati non è attualmente in corso, si otterrà invece questa risposta:
{
"result": "You can't stop processing this data set because it isn't being processed. Check the current status of the data set."
}
Interrompi elaborazione di un business object
L'azione personalizzata Interrompi è disponibile anche a livello di business object. Utilizzare questo URL per richiedere l'interruzione dell'elaborazione per un business object specifico:
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/child/businessObjects/{{DataSetBusObjId}}/action/stop
Nota
Sostituire {{DataSetBusObjId}} con il valore DataSetBusObjId restituito durante la revisione del business object all'interno del data set.Task 10: Eliminazione di un data set
È possibile eliminare i dati della tabella di staging per i data set se non vengono elaborati.
Elimina dati tabella intermedia HDL
- In Postman creare una nuova richiesta POST per questo URL:
- Impostare l'intestazione Tipo di contenuto sul valore indicato di seguito.
application/vnd.oracle.adf.action+json
- Configurare l'autorizzazione per la richiesta e fare clic su Invia.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/action/deleteDataSet
Non sono presenti parametri per questa azione.
Elimina dati tabella intermedia HSDL
Se si sottomette questa azione, il data set verrà eliminato sia dalle tabelle di staging HSDL che HDL.
- In Postman creare una nuova richiesta POST per questo URL:
- Impostare l'intestazione Tipo di contenuto sul valore indicato di seguito.
application/vnd.oracle.adf.action+json
- Configurare l'autorizzazione per la richiesta e fare clic su Invia.
https://{{env}}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets/{{RequestId}}/action/deleteSpreadsheetDataSet
Non sono presenti parametri per questa azione.
Collegamenti correlati
- Playbook sulla soluzione: caricare i dati in Oracle Fusion Cloud Human Capital Management (HCM)
- Guida per l'utente: Programma di caricamento dati HCM
- Esercitazioni sul programma di caricamento dati HCM Oracle in base agli esempi
La sezione Opera descrive altri modi per caricare i file nel server Oracle WebCenter Content.
Altre risorse di apprendimento
Esplora altri laboratori su docs.oracle.com/learn o accedi a più contenuti di formazione gratuiti sul canale YouTube di Oracle Learning. Inoltre, visitare education.oracle.com/learning-explorer per diventare Oracle Learning Explorer.
Per la documentazione del prodotto, visitare Oracle Help Center.
Uso dell'API REST del programma di caricamento dati HCM
G35315-01
Maggio 2025
Copyright ©2025,
Oracle e/o relative consociate.