Esecuzione delle regole dati

Esegue una regola di caricamento dati di Oracle Hyperion Financial Data Quality Management, Enterprise Edition basata sui periodi di inizio e di fine e sulle opzioni di importazione ed esportazione specificati.

Prerequisiti

  • Regole dati: le regole di caricamento dati definiscono in che modo Integrazioni carica i dati da un file. Per caricare i dati, è necessario avere delle regole di caricamento dati predefinite.

  • Per eseguire una specifica regola dati, è necessario disporre dei privilegi richiesti.

Risorsa REST

POST /aif/rest/{api_version}/jobs

Richiesta

Tipi di supporti disponibili: application/json

Parametri

Nella seguente tabella è riepilogata la richiesta client.

Tabella A-1 Parametri

Nome Descrizione Tipo Obbligatorio Impostazione predefinita
api_version Versione dell'API utilizzata (ad esempio, V1) Percorso Sì Nessuno
jobType Deve essere impostato su "DATARULE"   Sì Nessuno
jobName Il nome della regola di caricamento dati in FDMEE. Se il nome della regola contiene degli spazi, racchiuderlo tra virgolette.   Sì Nessuno
startPeriod Il primo periodo per il quale devono essere caricati i dati. Il nome del periodo deve essere definito nel mapping dei periodi in FDMEE.   Sì Nessuno
endPeriod L'ultimo periodo per il quale devono essere caricati i dati. Il nome del periodo deve essere definito nel mapping dei periodi in FDMEE.   Sì Nessuno
importMode Determina la modalità di importazione dei dati in FDMEE.

Di seguito sono riportati i valori consentiti.

  • APPEND per aggiungere i dati ai dati POV esistenti in FDMEE

  • REPLACE per eliminare i dati POV e sostituirli con quelli del file

  • RECALCULATE per saltare l'importazione dei dati, ma rielaborare i dati con mapping e conti logici aggiornati

  • NONE per ignorare l'importazione dei dati nella tabella intermedia di FDMEE

   Sì Nessuno
exportMode Determina la modalità di esportazione dei dati in FDMEE.

Di seguito sono riportati i valori accettabili per un'applicazione Oracle Hyperion Planning.

  • STORE_DATA per unire i dati della tabella intermedia di FDMEE con i dati di Planning esistenti

  • ADD_DATA per aggiungere i dati della tabella intermedia di FDMEE in Planning

  • SUBTRACT_DATA per sottrarre i dati nella tabella intermedia di FDMEE dai dati di Planning esistenti

  • REPLACE_DATA per cancellare i dati POV e sostituirli con quelli nella tabella intermedia di FDMEE. Vengono cancellati i dati per Scenario, Versione, Anno, Periodo ed Entità.

  • NONE per ignorare l'esportazione dei dati da FDMEE a Planning

Di seguito sono riportati i valori accettabili per le applicazioni Financial Consolidation and Close e Tax Reporting.

  • MERGE: per impostazione predefinita, il caricamento di tutti i dati viene elaborato in modalità Unisci. Se i dati esistono già nell'applicazione, il sistema sovrascrive i dati esistenti con i nuovi dati inclusi nel file di caricamento. Se i dati non esistono, verranno creati nuovi dati.

  • REPLACE: il sistema cancella innanzitutto i dati esistenti nell'applicazione che corrispondono ai dati presenti nel file di caricamento dati. Viene quindi eseguito il caricamento dei dati in modalità Unisci.

  • NONE: ignora l'esportazione dei dati da FDMEE a Financial Consolidation and Close.

   Sì Nessuno
fileName Nome file facoltativo. Se non si specifica un nome file, questa interfaccia API importa i dati contenuti nel nome file specificato nella regola di caricamento dati. Il file di dati deve essere già presente in Posta in entrata prima dell'esecuzione della regola dati.   Sì Nessuno

URL di esempio

https://<SERVICE_NAME>-<TENANT_NAME>.<dcX>.oraclecloud.com/aif/rest/V1/jobs

Esempio del corpo della richiesta

{"jobType":"DATARULE",
"jobName":"aso to bso dr",
"startPeriod":"Dec-18",
"endPeriod":"Dec-18",
"importMode":"REPLACE",
"exportMode":"NONE",
"fileName":""
}

Risposta

Tipi di supporti disponibili: application/json

Tabella A-2 Parametri

Nome Descrizione

status

Stato del job: -1 = in corso; 0 = completato; 1 = errore; 2 = annullamento in sospeso; 3 = annullato; 4 = parametro non valido

jobStatus

Il testo che rappresenta lo stato del job con uno dei seguenti valori "RUNNING", "SUCCESS”, "FAILED"

jobId

L'ID processo generato in FDMEE per il job

logFileName

File di log contenente le voci per questa esecuzione.

outputFileName

Nome del file di output, se generato.

processType

Tipo di processo eseguito. Contiene "COMM_LOAD_BALANCES" per tutte le esecuzioni di regole dati

executedBy

Nome di accesso dell'utente utilizzato per eseguire la regola.

dettagli

Restituisce lo stack trace dell'eccezione in caso di un errore dell'applicazione

Esempio del corpo della risposta

Di seguito è riportato un esempio del corpo della risposta in formato JSON.

{
    "jobStatus": "RUNNING"
"jobId": 2019
"logFileName": "\outbox\logs\Account Reconciliation Manager_2019.log"
"outputFileName": null
"processType": "COMM_LOAD_BALANCES"
"executedBy": "admin"
"status": -1
"links": [1]
    0:  {
    "rel": "self"
    "href": "https://<SERVICE_NAME>-<TENANT_NAME>.<dcX>.oraclecloud.com/aif/rest/V1/jobs/2019"
    "action": "GET"
}
"details": null

}