Datenregeln ausführen

Führt eine Dataload-Regel von Oracle Hyperion Financial Data Quality Management, Enterprise Edition basierend auf Start- und Endperiode sowie den angegebenen Import- oder Exportoptionen aus.

Voraussetzungen

  • Datenregeln: Dataload-Regeln definieren, wie Integrationen Daten aus einer Datei laden. Zum Laden von Daten müssen vordefinierte Dataload-Regeln vorhanden sein.

  • Sie müssen über die erforderlichen Berechtigungen verfügen, um eine bestimmte Datenregel ausführen zu können.

REST-Ressource

POST /aif/rest/{api_version}/jobs

Anforderung

Unterstützte Medientypen: application/json

Parameter

Die folgende Tabelle enthält eine Übersicht der Clientanforderung.

Tabelle A-1 Parameter

Name Beschreibung Typ Erforderlich Standard
api_version Version der verwendeten API, z.B. V1 Pfad Ja Keine
jobType Muss auf "DATARULE" gesetzt werden.   Ja Keine
jobName Name einer in FDMEE definierten Dataload-Regel. Sie müssen den Regelnamen in Anführungszeichen setzen, wenn er Leerzeichen enthält.   Ja Keine
startPeriod Erste Periode, für die Daten geladen werden sollen. Dieser Periodenname muss in der Periodenzuordnung von FDMEE definiert sein.   Ja Keine
endPeriod Letzte Periode, für die Daten geladen werden sollen. Dieser Periodenname muss in der Periodenzuordnung von FDMEE definiert sein.   Ja Keine
importMode Bestimmt, wie die Daten in FDMEE importiert werden.

Zulässige Werte:

  • APPEND zum Hinzufügen zu den vorhandenen POV-Daten in FDMEE

  • REPLACE, um die POV-Daten zu löschen und mit den Daten aus der Datei zu ersetzen.

  • RECALCULATE, um den Datenimport zu überspringen. Die Daten werden jedoch mit aktualisierten Zuordnungen und logischen Konten neu verarbeitet.

  • NONE zum Überspringen des Datenimports in die FDMEE-Staging-Tabelle

   Ja Keine
exportMode Bestimmt, wie die Daten in FDMEE exportiert werden.

Zulässige Werte für Oracle Hyperion Planning-Anwendungen:

  • STORE_DATA zum Zusammenführen der Daten mit den vorhandenen Planning-Daten in der FDMEE-Staging-Tabelle

  • ADD_DATA zum Hinzufügen der Daten in der FDMEE-Staging-Tabelle in Planning

  • SUBTRACT_DATA zum Subtrahieren der Daten in der FDMEE-Staging-Tabelle von den vorhandenen Planning-Daten

  • REPLACE_DATA zum Löschen und Ersetzen der POV-Daten durch die Daten in der FDMEE-Staging-Tabelle. Die Daten werden für Szenario, Version, Jahr, Periode und Entity gelöscht.

  • NONE zum Überspringen des Datenexports von FDMEE in Planning

Zulässige Werte für Financial Consolidation and Close- und Tax Reporting Cloud-Anwendungen:

  • MERGE - Standardmäßig wird jeder Dataload im Zusammenführungsmodus verarbeitet. Wenn in der Anwendung bereits Daten vorhanden waren, überschreibt das System die vorhandenen Daten mit den neuen Daten aus der Ladedatei. Wenn noch keine Daten vorhanden sind, werden die neuen Daten erstellt.

  • REPLACE - Das System ersetzt zuerst alle vorhandenen Daten in der Anwendung durch die in der Dataload-Datei referenzierten Daten. Dann führt das System den Dataload im Zusammenführungsmodus durch.

  • NONE - Der Datenexport aus FDMEE in Financial Consolidation and Close wird übersprungen.

   Ja Keine
fileName Optionaler Dateiname. Wenn Sie keinen Dateinamen angeben, importiert diese API die Daten, die in der Datei enthalten sind, deren Name in der Dataload-Regel angegeben ist. Die Datendatei muss bereits vor der Datenregelausführung in der INBOX vorhanden sein.   Ja Keine

Beispiel-URL

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

Beispiel für den Anforderungstext

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

Antwort

Unterstützte Medientypen: application/json

Tabelle A-2 Parameter

Name Beschreibung

status

Status des Jobs: -1 = Wird verarbeitet, 0 = Erfolgreich, 1 = Fehler, 2 = Abbruch ausstehend, 3 = Abgebrochen, 4 = Ungültiger Parameter

jobStatus

Textdarstellung des Jobstatus mit einem der folgenden Werte: "RUNNING", "SUCCESS". "FAILED"

jobId

In FDMEE für den Job generierte Prozess-ID

logFileName

Logdatei mit Einträgen für diese Ausführung

outputFileName

Name der generierten Ausgabedatei (sofern vorhanden)

processType

Typ des ausgeführten Prozesses. Enthält für alle Datenregelausführungen den Wert "COMM_LOAD_BALANCES".

executedBy

Anmeldename des Benutzers, der die Regel ausgeführt hat

details

Gibt das Ausnahme-Stacktrace im Fall eines Anwendungsfehlers zurück.

Beispiel für den Antworttext

Der folgende Abschnitt enthält ein Beispiel für den Antworttext im JSON-Format.

{
    "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

}