Importazione di mapping di dati

I mapping dei membri vengono utilizzati per derivare i membri target per ogni dimensione in base al valore di origine. I mapping dei membri vengono utilizzati come riferimento durante il caricamento dati, consentendo a Oracle Hyperion Financial Data Quality Management, Enterprise Edition di stabilire come assegnare le dimensioni ai dati caricati nell'applicazione target. Questi mapping definiscono le relazioni tra i membri di origine e i membri delle dimensioni target con un'unica dimensione. È necessario creare un mapping dei membri per ogni dimensione target.

È possibile importare i mapping dei membri da un file selezionato in formato Excel, .CSV o .TXT. È anche possibile creare nuovi mapping in un file di testo e importarli. L'importazione dei mapping dei membri supporta le modalità di unione o di sostituzione insieme alle opzioni di convalida o di non convalida per i membri target.

Risorsa REST

POST /aif/rest/{api_version}/jobs

Richiesta

Tipi di supporti disponibili: application/json

Nella seguente tabella è riepilogata la richiesta client.

Tabella A-5 Parametri

Nome Descrizione Tipo Obbligatorio Impostazione predefinita
api_version Versione dell'API utilizzata (ad esempio, V1) Percorso Nessuno
jobType Il tipo di job, MAPPINGIMPORT Percorso Nessuno
jobName

Il nome di una specifica dimensione da importare, ad esempio ACCOUNT o ALL per importare tutte le dimensioni

Percorso Nessuno
fileName Il file e il percorso da cui importare i mapping. Il formato del file può essere .CSV, .TXT, .XLS o .XLSX. Prima dell'importazione, il file deve essere stato caricato nella cartella della posta in entrata (inbox) o in una sottodirectory di questa cartella. Nel percorso del file, includere la cartella della posta in entrata (inbox), ad esempio,inbox/BESSAPPJan-06.csv Percorso Nessuno
importMode La modalità di importazione: MERGE per aggiungere nuove regole o sostituire quelle esistenti oppure REPLACE per eliminare le precedenti regole di mapping prima dell'importazione Percorso No MERGE
validationMode Specifica se utilizzare la modalità di convalida o meno, rispettivamente con il valore true o false. Il valore true convalida i membri target rispetto all'applicazione target; il valore false carica il file di mapping senza eseguire alcuna convalida. Notare che l'esecuzione del processo di convalida richiede un uso intenso delle risorse e un tempo maggiore rispetto all'impostazione false che disattiva questo processo; la maggior parte degli utenti seleziona false Percorso No false
locationName La posizione di FDMEE dove devono essere caricate le regole di mapping; queste regole sono specifiche della posizione di FDMEE scelta Percorso No Nessuno

Esempio del corpo della richiesta

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

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

Per il codice di esempio, verificare gli esempi di codice inclusi nella sezione Esecuzione delle regole dati.

Risposta

Nella tabella che segue sono riepilogati i parametri di risposta.

Tabella A-6 Parametri

Nome Descrizione

jobId

L'ID processo generato in FDMEE per il job, ad esempio 1880

jobStatus

Lo stato del job, ad esempio RUNNING

logFileName

File di log contenente le voci per questa esecuzione, ad esempio outbox/logs/BESSAPP-DB_1880.log

outputFileName

Nome del file di output, se generato, o altrimenti null

processType

Tipo di processo eseguito, IMPORT_MAPPING

executedBy

Nome di accesso dell'utente utilizzato per eseguire la regola, ad esempio admin

details

Restituisce lo stack trace dell'eccezione nel caso di un errore dell'applicazione o null

Tipi di supporti disponibili: application/json

Parametri

Esempio del corpo della risposta

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

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

Per il codice di esempio, verificare gli esempi di codice inclusi nella sezione Esecuzione delle regole dati.