Oracle EDMCS 命令

要連線至 Oracle® 企業資料管理雲端服務 (EDMCS)，新增包含 Oracle EDMCS 連線指令的步驟。例如：

匯入和匯出階層結構
將分層結構轉換為平衡或世代格式
自動管理 EDMCS

要啟用這些指令，IT 管理員首先建立 Oracle EDMCS 連接器。

將世代檔案轉換為父子檔案

要將世代資料結構轉換成父-子-也就是ragged-格式，請使用Convert generational file to parent-child 指令。

等效的 API 呼叫： NA

摘要資訊

摘要資訊	詳細資訊
輸入檔	輸入要轉換的檔案。
分隔符號	選擇中使用的分隔符輸入檔案。
具有標頭	如果輸入檔案包含標頭列，請勾選此方塊。
具有別名	如果輸入檔案包含要在父或子值之後保留的別名，例如`父,別名` 或`子,別名` 的列，請勾選此方塊。

输出

輸出	輸出類型
轉換後的父-子檔案	檔案

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障

轉換父子檔案

若要將父/子資料結構轉換成Raggged Generational 或balanced 格式，請使用Convert parent-child file 指令。

等效的 API 呼叫： NA

摘要資訊

摘要資訊	詳細資訊
輸入檔	輸入要轉換的檔案。
分隔符號	選擇輸入檔案中使用的分隔符。
層級結構類型	選擇要將檔案轉換為的階層類型。
父列名稱	輸入包含父值的欄名稱。
子列名稱	輸入包含子值的欄名稱。

输出

輸出	輸出類型
層級結構檔案	檔案

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障

在實體間複製檔案

若要將檔案從來源環境複製到目前的目標環境，請使用Copy File Between Instances 指令。

例如，使用此命令將檔案從測試環境複製到生產環境。

等效 API 調用： https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/prest/lcm_copy_file_v2.html

摘要資訊

摘要資訊	詳細資訊
來源檔案名稱	輸入要複製的檔案名稱。
來源使用者名稱	輸入來源環境的使用者名稱。
來源實體密碼	輸入來源環境的密碼。注意：或者，輸入 EPM Automate 在源密碼檔案中產生的密碼檔案。
源密碼檔案	輸入來源環境的密碼檔案。注意：或者，直接在源實例密碼中輸入密碼。
來源 URL	輸入來源環境的 URL。
目標檔案名稱	輸入目標環境中複製檔案的名稱。

输出

無

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障
10	警告	命令已完成，但有警告

複製快照

若要透過從來源環境複製快照到目前的目標環境來遷移或clone- 環境，請使用Copy snapshot 指令。

例如，使用此命令將快照從測試環境複製到生產環境。

等效 API 調用： https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/prest/lcm_copy_application_snapshot_v2.html

摘要資訊

摘要資訊	詳細資訊
快照名稱	輸入要遷移的快照名稱。
來源使用者名稱	輸入來源環境的使用者名稱。
來源實體密碼	輸入來源環境的密碼。注意：或者，輸入 EPM Automate 在源密碼檔案中產生的密碼檔案。
源密碼檔案	輸入來源環境的密碼檔案。注意：或者，直接在源實例密碼中輸入密碼。
來源 URL	輸入來源環境的 URL。
來源網域	輸入來源環境的網域。

输出

無

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障

建立要求

若要建立新的 Oracle EDMCS 請求，請使用Create Request 指令。

等效的 API 調用： https://docs.oracle.com/en/cloud/saas/enterprise-data-management-cloud/edmra/op-v1-requests-post.html

摘要資訊

摘要資訊	詳細資訊
檢視名稱	輸入要在其中建立請求的檢視名稱。
標題：	輸入請求標題。
說明	可選擇輸入請求說明。
附註	可選擇輸入請求備註。
子列名稱	輸入包含子值的欄名稱。

输出

輸出	輸出類型
請求 JSON	JSON
請求 ID	字串

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般失敗

從檔案建立請求項目

若要在 EDMCS 請求中加入上傳檔案中的項目，請使用Create Request Items From File 指令。

等效 API 調用： https://docs.oracle.com/en/cloud/saas/enterprise-data-management-cloud/edmra/op-v1-requests-requestid-import-post.html

摘要資訊

摘要資訊	詳細資訊
要求標題	輸入 EDMCS 請求標題。
工作表名稱	輸入申請工作表名稱。
檔案	輸入用於建立請求項目的檔案。

输出

輸出	輸出類型
更新的請求 JSON	JSON

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般失敗

刪除檔案

若要從預設上載位置、資料管理資料夾或 profitinbox/profitoutbox 刪除檔案或應用程式快照，請使用Delete file 指令。

等效 API 調用： https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/prest/delete_files_v2.html

摘要資訊

摘要資訊	詳細資訊
檔案名稱	輸入要刪除的檔案名稱。如果檔案是而不是預設上傳位置中的，請包含其位置的路徑。

输出

無

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障
10	警告	命令完成時有警告

下載檔案

若要從環境下載檔案，請使用Download file 指令。

等效 API 調用： https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/prest/download.html

摘要資訊

摘要資訊	詳細資訊
檔案名稱	輸入要下載的檔案名稱。如果檔案是而非預設上傳位置中的，請包含其位置路徑。
自動解壓縮	若要自動解壓縮下載的檔案，以作為後續命令的輸出，請勾選此方塊。注意：如果 ZIP 檔案包含多個檔案，則會保持壓縮狀態。

输出

輸出	輸出類型
下載的檔案	檔案
下載的檔案大小	整數
下載記錄	整數

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障
10	警告	指令完成時有警告

匯出尺寸映射到連線

若要匯出尺寸對應到逗號分隔值 (CSV) 檔案，請使用Export Dimension Mapping to Connection 指令。

等效的 API 呼叫： https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/prest/fdmee_export_data_mapping.html

摘要資訊

摘要資訊	詳細資訊
應用程式名稱	輸入包含標量的應用程式名稱。
維度名稱	輸入要匯出的維度名稱。
連線名稱	輸入要匯出尺寸標註到的連線名稱。
檔案名稱	輸入要匯出尺寸對應到的目標檔案名稱。
對應位置	輸入要匯出的對應位置。

输出

無

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障

匯出尺寸對應到檔案

若要匯出尺寸對應到 CSV 檔案，請使用Export Dimension Mapping to File 指令。

等效的 API 呼叫： https://docs.oracle.com/en/cloud/saas/enterprise-data-management-cloud/edmra/op-v1-dimensions-dimensionid-mapping-export-download-post.html

摘要資訊

摘要資訊	詳細資訊
應用程式名稱	輸入維度所屬應用程式的名稱。
維度名稱	輸入要匯出的尺寸標註名稱。
檔案名稱	輸入要匯出尺寸對應到的目標檔案名稱。
對應位置	輸入要匯出的對應位置。

输出

輸出	輸出類型
匯出對應檔案	檔案

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障

導出標註到連接

要在 Oracle EDMCS 中导出维度到现有连接，请使用Export Dimension to Connection 命令。

等效 API 調用： https://docs.oracle.com/en/cloud/saas/enterprise-data-management-cloud/edmra/op-v1-dimensions-dimensionid-export-connection-post.html

摘要資訊

摘要資訊	詳細資訊
應用程式名稱	輸入包含要匯出的維度的應用程式名稱。
維度名稱	輸入要匯出的維度名稱。
連線名稱	輸入要匯出尺寸標註到的連線名稱。
檔案名稱	輸入要匯出尺寸標註的目標檔名稱。

输出

無

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障

匯出尺寸標註到檔案

要在 Oracle EDMCS 中导出维度到可下载的 CSV 文件，请使用Export Dimension to File 命令。

等效的 API 調用： https://docs.oracle.com/en/cloud/saas/enterprise-data-management-cloud/edmra/op-v1-dimensions-dimensionid-export-download-post.html

摘要資訊

摘要資訊	詳細資訊
應用程式名稱	輸入包含要匯出的維度的應用程式名稱。
維度名稱	輸入要匯出的尺寸標註名稱。
檔案名稱	輸入要匯出尺寸標註到的目標檔名。
父名稱	若要僅匯出父成員的後代，請輸入父名稱。
父列名稱	若要根據列只匯出父代的子代，請輸入包含父代的列名稱。

输出

輸出	輸出類型
匯出尺寸檔	檔案

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障

導出快照

要重复以前的导出操作来创建Migration内容的快照，使用 Export snapshot 命令。

等效的 API 調用： https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/prest/get_information_about_a_specific_application_snapshot.html

摘要資訊

摘要資訊	詳細資訊
快照名稱	輸入要匯出的快照名稱。

输出

無

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障
10	警告	指令完成並發出警告

擷取尺寸觀點

使用Extract Dimension Viewpoint 指令，將尺寸檢視點擷取至檔案或連線。

等效的 API 呼叫： https://docs.oracle.com/en/cloud/saas/enterprise-data-management-cloud/edmra/op-v1-dimensions-byname-extract-post.html

摘要資訊

摘要資訊	詳細資訊
應用程式名稱	輸入包含要抽取的維度的應用程式名稱。
維度名稱	輸入要擷取的尺寸標註的名稱。
檔案名稱	輸入要抽取尺寸標註的目標檔名稱。注意：如果連接名稱為空白，命令會在您的 Oracle EDMCS 範例中建立此檔案，並下載作為輸出。
摘要名稱	輸入摘要的名稱。
連線名稱	若要將標量擷取至連線而非檔案，請輸入連線名稱。

输出

輸出	輸出類型
尺寸視點匯出	檔案

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障

取得應用程式

要列出可用的 Oracle EDMCS 應用程式並擷取其元資料（包括尺寸），請使用Get Applications 指令。

等效 API 調用： https://docs.oracle.com/en/cloud/saas/enterprise-data-management-cloud/edmra/op-v1-applications-get.html

摘要資訊

無

输出

輸出	輸出類型
應用程式清單	陣列
應用程式 JSON 檔案	JSON

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障

取得連線

要列出 Oracle EDMCS 應用程式的可用連線，請使用Get Connections 指令。
等效 API 調用： https://docs.oracle.com/en/cloud/saas/enterprise-data-management-cloud/edmra/op-v1-globalconnections-get.html

摘要資訊

摘要資訊	詳細資訊
應用程式名稱	輸入包含要列出連線的應用程式名稱。

输出

輸出	輸出類型
連線清單	陣列
連線 JSON 檔案	JSON

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障

取得尺寸映射

要列出 Oracle EDMCS 尺寸的可用映射，請使用Get Dimension Mappings 指令。

等效 API 調用： https://docs.oracle.com/en/cloud/saas/enterprise-data-management-cloud/edmra/op-v1-dimensions-dimensionid-bindings-bindingid-mappingkeys-get.html

摘要資訊

摘要資訊	詳細資訊
應用程式名稱	輸入維度應用程式的名稱。
維度名稱	輸入包含所需對應的尺寸名稱。

输出

輸出	輸出類型
尺寸對應 JSON	JSON

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般失敗

取得請求

要檢索 Oracle EDMCS 請求的元資料，請使用Get Request 指令。

等效 API 調用： https://docs.oracle.com/en/cloud/saas/enterprise-data-management-cloud/edmra/op-v1-requests-requestid-get.html

摘要資訊

摘要資訊	詳細資訊
要求標題	輸入所需請求的標題。

输出

輸出	輸出類型
請求 JSON	JSON

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般失敗

取得請求

要列出連接器的整合使用者可以存取的所有請求，請使用Get Requests 指令。

等效 API 調用： https://docs.oracle.com/en/cloud/saas/enterprise-data-management-cloud/edmra/op-v1-requests-requestid-get.html

摘要資訊

無

输出

輸出	輸出類型
請求清單	陣列
請求 JSON 檔案	檔案

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障

取得意見

若要列出連接器的整合使用者可以存取的所有檢視，請使用Get Views 指令。

等效的 API 呼叫： https://docs.oracle.com/en/cloud/saas/enterprise-data-management-cloud/edmra/op-v1-views-get.html

摘要資訊

無

输出

輸出	輸出類型
視圖清單	陣列
視圖 JSON 檔案	檔案

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障

依名稱匯入尺寸標註

使用Import dimension by name 指令，以檔案名稱匯入尺寸標註到 Oracle EDMCS。

等效的 API 調用： https://docs.oracle.com/en/cloud/saas/enterprise-data-management-cloud/edmra/op-v1-dimensions-byname-import-post.html

摘要資訊

摘要資訊	詳細資訊
檔案名稱	輸入要匯入的檔案名稱。注意：檔案從暫存區或連線匯入。
應用程式名稱	輸入包含標量的應用程式名稱。
維度名稱	輸入要接收匯入的尺寸標註名稱。
匯入選項	選擇匯入時是否重設、取代或合併尺寸標註。
連線名稱	輸入要從連線匯入檔案的名稱。若要從暫存區匯入，請留空。

输出

無

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障

從連線匯入尺寸

要從現有連線匯入尺寸標註到 Oracle EDMCS，請使用Import Dimension from Connection 指令。

等效 API 調用： https://docs.oracle.com/en/cloud/saas/enterprise-data-management-cloud/edmra/op-v1-dimensions-dimensionid-import-connection-post.html

摘要資訊

摘要資訊	詳細資訊
應用程式名稱	輸入包含維度的應用程式名稱。
連線名稱	輸入要從標註匯入的連線名稱。
維度名稱	輸入要接收匯入的尺寸標註的名稱。
檔案名稱	輸入要從指定連線匯入的檔案名稱。
重設尺寸	若要在匯入前重設尺寸，請勾選此方塊。
匯入選項	如果重設尺寸沒有勾選，請選擇匯入時是否重設、取代或合併尺寸。

输出

無

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障

從檔案匯入尺寸

要從上傳的 CSV 或 ZIP 檔案匯入尺寸標註到 Oracle EDMCS，請使用Import Dimension from File 指令。

等效 API 調用： https://docs.oracle.com/en/cloud/saas/enterprise-data-management-cloud/edmra/op-v1-dimensions-dimensionid-import-file-post.html

摘要資訊

摘要資訊	詳細資訊
檔案	輸入要匯入的檔案。
應用程式名稱	輸入包含標量的應用程式名稱。
維度名稱	輸入要接收匯入的尺寸名稱。
重設尺寸	若要在匯入前重設尺寸，請勾選此方塊。
匯入選項	如果重設尺寸沒有勾選，請選擇匯入時是否取代、合併或重設尺寸。

输出

無

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障

匯入快照

若要將快照內容從預設上傳位置匯入服務環境，請使用Import snapshot 指令。

等效 API 調用： https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/prest/lcm_import_v2.html

摘要資訊

摘要資訊	詳細資訊
快照名稱	輸入要匯入的快照名稱。
新預設密碼	輸入分配給在身分網域中建立的新使用者的密碼。注意：密碼必須符合身份域的最低要求。
重設密碼	若要要求新使用者在首次登入時變更密碼，請勾選此方塊。

输出

無

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障
10	警告	指令完成並發出警告

列出檔案

要列出預設位置、資料管理資料夾和 profitinbox/profitoutbox 中的檔案，請使用List files 指令。

注意：此命令不列出 Migration 快照。

等效 API 調用： https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/prest/list_files_v2.html

摘要資訊

摘要資訊	詳細資訊
篩選	輸入要傳回檔案的條件。例如，使用 glob synax-such as`*.csv`- 來傳回符合模式的所有檔案。

输出

輸出	輸出類型
EDMCS 檔案	陣列
EDMCS 檔案 CSV	檔案

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障
10	警告	命令已完成，但有警告

更新請求狀態

要更新 Oracle EDMCS 請求的狀態，請使用Update Request Status 指令。

等效的 API 呼叫：

摘要資訊

摘要資訊	詳細資訊
要求標題	輸入要更新請求的標題。
狀態	選擇要將要求更新為的狀態。
警告過渡	啟用此核取方塊可繞過任何具有警告嚴重性的自訂驗證失敗，並進入下一階段。

输出

輸出	輸出類型
更新的請求 JSON	JSON

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障

上傳檔案

若要上載檔案，請使用 Upload file 指令。例如，使用此命令上載包含以下內容的檔案：資料或元資料：

資料或元資料
規則或維度定義
映射交易
範本
備份快照

等效 API 調用： https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/prest/upload.html

摘要資訊

摘要資訊	詳細資訊
上傳檔案	輸入要上傳的檔案。
上傳名稱	輸入上載檔案的名稱。若要保持相同名稱，請留空。
檔案路徑	輸入上載檔案的路徑。若要使用預設上載位置，請留空。
覆寫	若要覆寫上載位置的現有同名檔案，請勾選此方塊。
分塊大小	輸入用於上傳檔案的分塊大小。預設為 50。

输出

輸出	輸出類型
上傳檔案大小	整數
上傳的記錄	整數

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障
10	警告	指令已完成，但有警告

上載檔案至暫存區

若要上載檔案到暫存區，請使用Upload file to staging 指令。

等效的 API 呼叫： https://docs.oracle.com/en/cloud/saas/enterprise-data-management-cloud/edmra/op-v1-files-staging-post.html

摘要資訊

摘要資訊	詳細資訊
上傳檔案	輸入要上傳的檔案。
檔案名稱	輸入上載檔案的名稱。若要保持相同名稱，請留空。

输出

輸出	輸出類型
上傳檔案大小	整數

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障
10	警告	指令已完成，但有警告

上傳請求檔案

若要上傳檔案作為請求的附件，請使用上傳請求檔案 指令。

等效 API 調用： https://docs.oracle.com/en/cloud/saas/enterprise-data-management-cloud/edmra/op-v1-requests-requestid-attachments-importfile-post.html

摘要資訊

摘要資訊	詳細資訊
請求 ID	輸入要上傳檔案至的要求的 ID。
上傳檔案	輸入要上傳的檔案。

输出

輸出	輸出類型
要求上傳檔案 URL	字串

退出代碼

代碼	類型	詳細資訊
0	成功	成功
1	錯誤	無效參數
2	錯誤	一般故障

Workiva 支援中心

將世代檔案轉換為父子檔案

摘要資訊

输出

退出代碼

轉換父子檔案

摘要資訊

输出

退出代碼

在實體間複製檔案

摘要資訊

注意： 或者，輸入 EPM Automate 在源密碼檔案 中產生的密碼檔案。

注意： 或者，直接在源實例密碼 中輸入密碼。

输出

退出代碼

複製快照

摘要資訊

注意： 或者，輸入 EPM Automate 在源密碼檔案 中產生的密碼檔案。

注意： 或者，直接在源實例密碼 中輸入密碼。

输出

退出代碼

建立要求

摘要資訊

输出

退出代碼

從檔案建立請求項目

摘要資訊

输出

退出代碼

刪除檔案

摘要資訊

输出

退出代碼

下載檔案

摘要資訊

注意： 如果 ZIP 檔案包含多個檔案，則會保持壓縮狀態。

输出

退出代碼

匯出尺寸映射到連線

摘要資訊

输出

退出代碼

匯出尺寸對應到檔案

摘要資訊

输出

退出代碼

導出標註到連接

摘要資訊

输出

退出代碼

匯出尺寸標註到檔案

摘要資訊

输出

退出代碼

導出快照

摘要資訊

输出

退出代碼

擷取尺寸觀點

摘要資訊

注意： 如果連接名稱 為空白，命令會在您的 Oracle EDMCS 範例中建立此檔案，並下載作為輸出。

输出

退出代碼

取得應用程式

摘要資訊

输出

退出代碼

取得連線

摘要資訊

输出

退出代碼

取得尺寸映射

摘要資訊

输出

退出代碼

取得請求

摘要資訊

输出

退出代碼

注意：或者，輸入 EPM Automate 在源密碼檔案中產生的密碼檔案。

注意：或者，直接在源實例密碼中輸入密碼。

注意：或者，輸入 EPM Automate 在源密碼檔案中產生的密碼檔案。

注意：或者，直接在源實例密碼中輸入密碼。

注意：如果 ZIP 檔案包含多個檔案，則會保持壓縮狀態。

注意：如果連接名稱為空白，命令會在您的 Oracle EDMCS 範例中建立此檔案，並下載作為輸出。

注意：檔案從暫存區或連線匯入。

注意：密碼必須符合身份域的最低要求。

注意：此命令不列出 Migration 快照。