成員對映是用於依據來源值衍生出每個維度的目標成員。資料載入時會參照成員對映,可讓 Oracle Hyperion Financial Data Quality Management, Enterprise Edition 決定如何將載入至目標應用程式的資料維度化。成員對映在單一維度內定義來源成員與目標維度成員之間的關係。您必須針對每個目標維度建立一個成員對映。
您可以從選取的 Excel、.CSV 和 .TXT 檔案中匯入成員對映。您可以在文字檔中建立新的對映再匯入。匯入成員對映支援合併或取代模式,以及目標成員的有驗證或無驗證選項。
REST 資源
POST /aif/rest/{api_version}/jobs
要求
支援的媒體類型:application/json
下表彙總用戶端要求。
表格 A-5 參數
名稱 | 描述 | 類型 | 必要 | 預設值 |
---|---|---|---|---|
api_version |
您使用的 API 版本,例如 V1 | 路徑 | 是 | 無 |
jobType |
工作類型,MAPPINGIMPORT |
路徑 | 是 | 無 |
jobName |
要匯入之特定維度的維度名稱,例如 |
路徑 | 是 | 無 |
fileName |
要從中匯入對映的檔案和路徑。檔案格式可以是 .CSV、.TXT、.XLS 或 .XLSX。檔案必須在匯入之前上傳至 inbox,或 inbox 的子目錄。在檔案路徑中包含 inbox,例如 inbox/BESSAPPJan-06.csv |
路徑 | 是 | 無 |
ImportMode |
匯入模式:MERGE 表示新增規則或取代現有規則,或 REPLACE 表示匯入之前清除先前的對映規則 |
路徑 | 否 | MERGE |
validationMode |
是否使用驗證模式,true 或 false 。輸入 true 會針對目標應用程式來驗證目標成員;false 會載入對映檔案而完全不驗證。請注意,驗證程序會耗用大量資源,且所花的時間比驗證模式 false 更長;大部分客戶選取的選項是 false |
路徑 | 否 | false |
locationName |
其中應該入對映規則的 FDMEE 位置;對映規則取決於 FDMEE 中的位置 | 路徑 | 否 | 無 |
要求內文的範例
以下顯示要求內文的範例 (JSON 格式)。
{ "jobType":"MAPPINGIMPORT", "jobName":"ACCOUNT", "fileName":"inbox/BESSAPPJan-06.csv", "importMode":"MERGE", "validationMode":"false", "locationName":"BESSAPP" }
如需範例程式碼,請參閱執行資料規則中包含的程式碼範例。
回應
下表彙總回應參數。
表格 A-6 參數
名稱 | 描述 |
---|---|
|
FDMEE 中為工作產生的程序 ID,例如 1880 |
|
工作狀態,例如 |
|
包含這次執行之相關項目的日誌檔,例如 |
|
所產生之輸出檔案的名稱 (若有的話),否則為 |
|
所執行的程序類型, |
|
用於執行規則之使用者的登入名稱,例如 |
|
如果發生應用程式錯誤,則傳回例外堆疊追蹤,否則為 |
支援的媒體類型:application/json
參數
回應內文的範例
以下顯示回應內文的範例 (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" }
如需範例程式碼,請參閱執行資料規則中包含的程式碼範例。