匯入資料對映

成員對映是用於依據來源值衍生出每個維度的目標成員。資料載入時會參照成員對映，可讓 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`	要匯入之特定維度的維度名稱，例如 `ACCOUNT`，或 `ALL` 表示匯入所有維度	路徑	是	無
`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 參數

名稱	描述
`jobId`	FDMEE 中為工作產生的程序 ID，例如 1880
`jobStatus`	工作狀態，例如 `RUNNING`
`logFileName`	包含這次執行之相關項目的日誌檔，例如 `outbox/logs/BESSAPP-DB_1880.log`
`outputFileName`	所產生之輸出檔案的名稱 (若有的話)，否則為`空值`
`processType`	所執行的程序類型，`IMPORT_MAPPING`
`executedBy`	用於執行規則之使用者的登入名稱，例如 `admin`
`details`	如果發生應用程式錯誤，則傳回例外堆疊追蹤，否則為`空值`

支援的媒體類型：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"
}

如需範例程式碼，請參閱執行資料規則中包含的程式碼範例。