Datenzuordnungen importieren

Mit Elementzuordnungen können Sie die Zielelemente für jede Dimension anhand des Quellwertes ableiten. Elementzuordnungen werden während des Dataloads referenziert. Dadurch kann Oracle Hyperion Financial Data Quality Management, Enterprise Edition bestimmen, wie die in die Zielanwendung geladenen Daten dimensionalisiert werden. Elementzuordnungen definieren Beziehungen zwischen Quellelementen und Zieldimensionselementen in einer einzelnen Dimension. Sie müssen eine Elementzuordnung für jede Zieldimension erstellen.

Sie können Elementzuordnungen aus einer ausgewählten Excel-, CSV- oder TXT-Datei importieren. Sie können auch neue Zuordnungen in einer Textdatei erstellen und diese importieren. Die Funktion zum Importieren von Elementzuordnungen unterstützt den Zusammenführungs- und den Ersetzungsmodus sowie Optionen für Validierung oder keine Validierung von Zielelementen.

REST-Ressource

POST /aif/rest/{api_version}/jobs

Anforderung

Unterstützte Medientypen: application/json

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

Tabelle A-5 Parameter

Name Beschreibung Typ Erforderlich Standard
api_version Version der verwendeten API, z.B. V1 Pfad Ja Keine
jobType Jobtyp (MAPPINGIMPORT) Pfad Ja Keine
jobName

Name einer bestimmten zu importierenden Dimension, z.B. ACCOUNT oder ALL für den Import aller Dimensionen

Pfad Ja Keine
fileName Datei und Pfad für den Import von Zuordnungen. Das Dateiformat kann CSV, TXT, XLS oder XLSX lauten. Die Datei muss vor dem Import entweder in die Inbox oder in ein Unterverzeichnis der Inbox hochgeladen werden. Nehmen Sie die Inbox in den Dateipfad auf, z.B. inbox/BESSAPPJan-06.csv. Pfad Ja Keine
importMode Importmodus: MERGE zum Hinzufügen neuer oder Ersetzen vorhandener Regeln oder REPLACE zum Löschen vorhandener Zuordnungsregeln vor dem Import Pfad Nein MERGE
validationMode Verwendung des Validierungsmodus (true oder false). Beim Eintrag true werden die Zielelemente anhand der Zielanwendung validiert, bei false wird die Zuordnungsdatei ohne Validierungen geladen. Beachten Sie, dass der Validierungsprozess ressourcenintensiv ist und länger als der Validierungsmodus false dauert. Daher wählen die meisten Kunden die Option false aus. Pfad Nein false
locationName FDMEE-Location, in der die Zuordnungsregeln geladen werden sollen. Zuordnungsregeln sind für eine Location in FDMEE spezifisch. Pfad Nein Keine

Beispiel für den Anforderungstext

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

{
"jobType":"MAPPINGIMPORT",
"jobName":"ACCOUNT",
"fileName":"inbox/BESSAPPJan-06.csv",
"importMode":"MERGE",
"validationMode":"false",
"locationName":"BESSAPP"
}

Beispielcode finden Sie unter Datenregeln ausführen.

Antwort

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

Tabelle A-6 Parameter

Name Beschreibung

jobId

In FDMEE für den Job generierte Prozess-ID, z.B. 1880

jobStatus

Jobstatus, z.B. RUNNING

logFileName

Logdatei mit Einträgen für diese Ausführung, z.B. outbox/logs/BESSAPP-DB_1880.log

outputFileName

Name der generierten Ausgabedatei (sofern vorhanden, andernfalls null)

processType

Typ des ausgeführten Prozesses (IMPORT_MAPPING)

executedBy

Anmeldename des Benutzers, der die Regel ausgeführt hat, z.B. admin

details

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

Unterstützte Medientypen: application/json

Parameter

Beispiel für den Antworttext

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

{
"links": 
[
0]
"status":"-1"
"details":"null"
"jobId":"1880"
"jobStatus":"RUNNING",
"logFileName":"outbox/logs/BESSAPP-DB_1880.log",
"outputFileName":"null",
"processType":"IMPORT_MAPPING",
"executedBy":"admin"
}

Beispielcode finden Sie unter Datenregeln ausführen.