runIntegration

適用於

必要角色

用法

• 若為「標準模式」整合，您必須指定 importMode、exportMode 及 periodName 的值
• 若為「快速模式」整合，您必須指定 exportMode 的值
• 參數名稱和其值區分大小寫

• JOB_NAME 是資料整合中定義的整合工作名稱。
• importMode 決定如何將資料匯入資料整合中。可接受的匯入模式：
  • Append 會新增至資料整合中現有的 POV 資料。
  • Replace 會刪除 POV 資料並以來自檔案的資料取代。
  • Map and Validate 會略過資料匯入，而使用更新的對映和邏輯帳戶重新處理資料。
  • No Import 會略過將資料匯入資料整合臨時資料表中。
• exportMode 會決定如何將資料載入目標應用程式。若為「快速模式」整合，您無法使用 Check 和 No Export 作為 exportMode 參數的值。可接受的匯出模式值為：
  • Merge 會更新現有的資料並新增資料。
  • Replace 會清除 POV 中現有的資料並載入新資料。若為標準模式，會清除 Scenario、Version、Year、Period 和 Entity 維度的資料。若為快速模式，會清除 Year、Period 和 Entity 維度的資料。您可以定義這兩種模式的自訂清除區。
  • Accumulate 會將資料新增至現有資料。適用於 Planning、Planning 模組、Financial Consolidation and Close、Tax Reporting、Profitability and Cost Management 和 Enterprise Profitability and Cost Management。
  • Subtract 會從現有餘額減去資料。適用於 Profitability and Cost Management 和 Enterprise Profitability and Cost Management。

    針對「快速模式」整合：

    • 您無法使用 Check 和 No Export 作為此參數的值。

    • 針對 Planning、Planning 模組和 Financial Consolidation and Close，唯一的有效值為 Replace、Merge 和 Accumulate。

  • No Export 會略過資料匯出。使用此模式將資料載入臨時資料表，以便在載入目標應用程式前進行複查。

  • Check 只會執行資料驗證檢查。

    若 Oracle Fusion Cloud 為目標，僅支援下列匯出模式：

    • MERGE 會將資料整合臨時資料表中的資料與現有資料合併
    • NONE 會略過將資料整合中的資料匯出到應用程式
• periodName 是一或多個用於匯入或匯出資料的期間或期間範圍的名稱，每個期間或期間範圍都使用大括號括住。可接受的期間命名慣例如下：
  • 若為單一期間載入，請在大括號中指定期間名稱，例如 {Jan-21}
  • 若為多期間載入，請在大括號中括住開始和結束期間名稱，例如 {Jan-21}{Mar-21} (載入從 Jan-21 開始到 Mar-21 結束的所有期間的資料)
  • 若為 Planning、Planning 模組、Financial Consolidation and Close、FreeForm 和 Tax Reporting：您可以使用 {Jan#FY21}{Mar#FY21} 格式指定商業程序期間名稱和年度，以載入從 Jan-21 開始到 Mar-21 結束之所有期間的資料。

    期間名稱必須使用大括號括住。

    • 單一期間—參照期間對映中定義的單一期間資料管理期間名稱。
    • 多期間—參照多期間載入。此參數以 {Month-Year}{Month-Year} 格式指定。例如，{Jan-20}{Mar-20} 表示載入從 Jan-20 到 Mar-20 的多個期間。
    • Planning 期間名稱—參照 {Month#Year} 格式的 Planning 期間名稱，例如 {Jan#FY20}{Mar#FY20}。使用此慣例，您便無需指定資料整合期間名稱。而是改為指定 Year 和 Scenario 維度的成員。

      Planning、Tax Reporting 和 Financial Consolidation and Close 商業程序可支援此參數。適用於您衍生自內部部署資料來源的服務應用程式和雲端部署。

      如果藉由擷取 Year 和 Period 成員名稱，從 EPM Cloud Groovy 指令碼進行觸發，使用此慣例會非常實用。此應用程式期間對映或全域期間對映必須存在於期間對映目標值中的 Year 和 Month。

    • 替代變數—這是先前 Planning 期間名稱格式的擴充功能，使用替代變數而非實際的 Year 和 Month 成員名稱，可以使用 {Month#&CurYr}{&FcstMonth#&CurYr} 格式指定，例如 {Jan#&CurYr}{&FcstMonth#&CurYr}。

      支援實際成員名稱及替代變數的組合。

      Planning、Tax Reporting 和 Financial Consolidation and Close 商業程序可支援此格式。

      此應用程式期間對映或全域期間對映必須存在於執行命令之環境的資料整合中，且期間對映的目標值中有可用的 Year 和 Month 值。在此情況下，Year 和 Month 會參照執行期間替代變數的目前值。

    • GLOBAL POV—會執行全域 POV 期間的資料載入。使用 {GLOBAL_POV} 格式。

    Note:

    如果您使用此討論中所述參數以外的任何期間命名參數，將會得到輸入無效 – HTTP 400 錯誤訊息。

    從 REST API 文件複製 periodName 區段。其中概述不同的格式，例如全域 POV、Subvar 等。

  • {GLOBAL_POV} 會在資料整合的系統或應用程式設定值中全域 POV 所定義的期間執行資料載入。

    Note:

    Planning、Planning 模組、Financial Consolidation and Close 和 Tax Reporting 支援 {Month#Year} 期間命名慣例格式。在此慣例下，您可以指定 Year 和 Scenario 維度的成員名稱，而非資料整合期間名稱。如果藉由擷取 Year 和 Period 成員名稱，從 Groovy 指令碼觸發此命令，此方法會非常實用。

    {Jan#&CurYr}{&FcstMonth#&CurYr} 替代變數命名慣例是先前期間命名慣例的擴充功能。如果是在 Planning、Planning 模組、Financial Consolidation and Close 和 Tax Reporting 執行此命令，您可以指定替代變數而非 Year 和 Month 成員名稱。同時支援成員名稱和替代變數的組合。

    只有在資料整合中已存在的目標值包含 Year 和 Month 的應用程式期間對映或全域期間對映時，先前期間命名和替代變數命名慣例才會生效。
• inputFileName，針對檔案式資料載入，指定要從其中匯入資料、可在收件匣中取得的檔案名稱。如果指定整合定義中的目錄名稱，則只會傳送檔案。如果未在整合定義中包含目錄名稱，請使用 inbox/DIR_NAME/FILE_NAME 格式，例如 inbox/GLBALANCES.txt 或 inbox/EBSGL/GLBALANCES.txt。如果檔案已上傳至環境中的預設位置，請使用 #epminbox/FILE_NAME 慣例 (例如 #epminbox/GLBALANCES.txt)，以識別輸入資料檔。

  此參數僅適用於原生檔案式資料載入。如果沒有為檔案式資料載入指定此參數值，此命令會從整合定義中指定的檔案匯入資料。如果為非檔案式的資料載入指定此參數值，則命令會忽略此參數值。

• PARAMETERS (選擇性)，識別 PARAMETER_NAME="PARAMETER" 格式的執行時期參數。參數包括來源篩選和目標選項。

  Note:

  此時您可以在目標應用程式的維度 (中繼資料) 類型使用的唯一參數是 "Refresh Database"=Yes|No。

範例

• 單一期間匯入：

  epmAutomate runIntegration VisionDataLoad importMode=Replace exportMode=Merge period="{Mar-15}"

• 多期間匯入：

  epmAutomate runIntegration VisionDataLoad importMode=Replace exportMode=Merge period="{Mar-15} {Jun-15}"

• 增量檔案式資料整合：

  epmAutomate runIntegration IncrementalFileLoad importMode=Replace exportMode=Merge period="{Jan-20}{Mar-20}" inputFileName=File1.txt