建立資料匯出檔案整合

「資料匯出至檔案」可讓您將資料從 Oracle Fusion Cloud Enterprise Performance Management 應用程式匯出至資料檔案。您可以使用資料檔案將資料載入至 Oracle ERP Cloud 應用程式或外部系統。

建立資料匯出至檔案應用程式時，請注意下列事項：

  • 建立維度時，會使用資料檔案中的欄順序來指派欄順序。檔案中的第一欄被指派為 ACCOUNT 資料欄。

  • 建議您一次只匯出一年。如果資料範圍跨過一年的邊界，資料可能會重複。

  • 不會驗證 POV 類別。

  • 可以從資料匯出檔案建立「檢查規則」。檢查規則不能夠以目標值為基礎。

  • 從資料匯出檔案寫回並不適用。

  • 只支援數值資料類型。如果您需要匯出文字、智慧型列示及日期，請使用類型為「EPM 資料檔案」，且資料擷取選項為「層級 0 資料」的 EPM 資料檔案應用程式。建立整合時，請將此應用程式作為目標。

    您也可以使用 Groovy 公用類別 DataExporter。如需詳細資訊，請參閱類別 DataExporter。

  • 「資料匯出至檔案」的預設「工作流程模式」設定為簡單。當您要從 Cloud EPM 匯出資料時，由於未提供鑽研支援，因此預設工作流程模式會設定為「簡單」。

    如果您因測試想要在工作台查看資料，請將「工作流程模式」設定為完整。如需詳細資訊，請參閱定義應用程式詳細資料選項。

  • 若要新增時間戳記，請在目標應用程式中建立新的匯出欄，然後為下一欄建立 SQL Like 對映，並在指令碼中輸入 CURRENT_TIMESTAMP。

    請注意，此方法會使用完整時間戳記 (例如 21-JAN-22 04.14.33.677306 PM +00:00)，此時間戳記是以伺服器時間為基礎，不一定是當地時間。

    若要設定時間戳記格式，請使用 TO_CHAR 語法。如需詳細資訊，請參閱TO_CHAR (datetime)。

  • 不會針對資料匯出至檔案應用程式來驗證目標值。

  • 執行整合時，資料整合會匯出該資料。資料整合會建立輸出資料檔案。資料檔案的名稱為 <Target App Name>_<Process ID>.dat，並將寫入至 <APPL ROOT FOLDER>/outbox 目錄。該資料檔案可從「程序詳細資料」頁面的 OUTPUT 檔欄存取。

  • 如果在將資料匯出至檔案整合定義的過程中會一併產生資料匯出輸出檔案，則您也可以使用「資料匯出目標應用程式」選項中的下載檔案名稱欄位來指定自己的檔案名稱，例如 PlanExport.csv。

    系統會在平台 inbox/outbox 資料夾中建立輸出檔案。您可以從首頁導覽至「應用程式」卡，再導覽至概觀，然後從動作下拉清單中選取收件匣/寄件匣瀏覽器，來存取 inbox/outbox 資料夾。

    您也可以在資料整合資料夾底下建立檔案，方法是在檔案名稱前面加上資料夾，例如 inbox/PlanExport.csv 或 outbox/PlanExport.csv。

    註：

    支援 inbox 底下有子資料夾，例如 inbox/userx/PlanExport.csv。您無法在 outbox 下建立子資料夾。

    如果將「下載檔案名稱」欄位保留空白，就會使用 <Application Name>_<Process ID>.dat 名稱在 outbox 資料夾中建立輸出檔案。

  • 如果您有排定每天要進行的資料匯出工作，而且需要將輸出檔案自動分佈給某位人員，請使用 REST API for Enterprise Performance Management Cloud 中的下載應用程式快照來下載特定檔案，提供該檔案的路徑作為 applicationSnapshotName 的值。例如，若要下載收件匣中名為 s112.csv 的資料整合檔案，請以 "inbox/s112.csv" 指定該檔案作為路徑參數。

建立「資料匯出檔案」整合定義，請執行下列動作：

  1. 依您要匯出的順序建立含有此欄清單的 .CSV 檔案。

    註：

    請勿在資料檔案中包括金額欄。如果資料檔案中有金額欄，您可以在建立應用程式之後再刪除該欄。

    該檔案的名稱就是應用程式的名稱，因此請適當地命名該檔案。

  2. 依序從資料整合首頁、動作功能表、設定動作下拉清單中，選取應用程式。
  3. 在應用程式頁面中，按一下 影像顯示「新增」圖示。。
  4. 在建立應用程式頁面，依序選取類別和資料匯出。
    影像顯示「建立應用程式」頁面。
  5. 從類型中，選取資料匯出至檔案。
  6. 從檔案中，選取要從其建立應用程式的來源檔案名稱。

    您也可以按一下 影像顯示「搜尋」圖示。，然後從檔案瀏覽器頁面中搜尋檔案。

  7. 在前綴中，指定前綴讓應用程式名稱成為唯一。
    該前綴會與檔案名稱連接，形成唯一的應用程式名稱。例如，如果您要讓應用程式的名稱與現有的應用程式名稱相同，您可以將起首字母指派為前綴。
  8. 按一下確定。

    系統會登錄該應用程式。

  9. 從應用程式頁面中，按一下資料目標應用程式右側的 影像顯示「選取」圖示。，然後選取應用程式詳細資料。
  10. 選取維度頁籤。
  11. 在應用程式詳細資料中，選取維度詳細資料頁籤。
  12. 視需要編輯維度名稱和資料欄名稱。
  13. 在順序中，指定處理對映的順序。

    例如，如果 Account 設成 1、Product 設成 2，以及 Entity 設成 3，則資料整合首先會處理 Account 維度的對映，然後依序是 Product 和 Entity。

  14. 在欄順序中，指定資料匯出檔案中每一欄的順序。
    依預設，資料整合會指派 "Account" 維度作為該順序中的第一欄。
  15. 按一下儲存。
  16. 在應用程式詳細資料中，選取選項頁籤。
  17. 為資料匯出檔案選取任何適用的特性和值。
    如需詳細資訊，請參閱資料匯出目標應用程式選項。
  18. 按一下儲存。
  19. 從資料整合首頁中，按一下 影像顯示「新增」圖示。 (建立)，然後選取整合。

    「一般」頁面會顯示在「建立整合」檢視中。

  20. 在名稱和描述中，輸入新直接整合的名稱和描述。
  21. 在位置中，輸入新位置的名稱，或選擇現有位置，以指定載入資料的位置。

    位置是用來連結來源與目標，以及相關聯的成員對映。您可以在同一個位置內使用不同組選項和篩選準則，定義多個整合。位置主要是用來控制對整合的存取。您可以使用「位置安全性」控制對一般使用者的存取。

    如果您輸入新位置，必須提供「來源」與「目標」。當您儲存整合時，資料整合會自動建立位置。

    如果您選取現有的位置，資料整合會自動填入「來源」和「目標」值，您就無法變更這些值。

  22. 按一下 影像顯示「來源」圖示。 (選取來源)。
  23. 從選取來源頁面，選取直接整合來源系統。
  24. 按一下 影像顯示「目標」圖示。 (選取目標)。
  25. 從選取目標頁面中，選取資料匯出檔案目標應用程式。
  26. 按一下儲存。
  27. 選取對映維度，將來源維度成員對映至其對應的目標應用程式維度成員。

    如需詳細資訊，請參閱對映維度。

  28. 執行整合以擷取來源系統中的資料，然後將該資料載入至資料匯出檔案目標應用程式。
    如需詳細資訊，請參閱執行整合。