使用工作

您可以使用「PCM 代理程式」中所建立「計算」類型的工作,為此命令提供預先定義的參數。

必須在命令行中提供任何未儲存在工作定義中的必要參數,且可以在命令行中覆寫工作定義中的任何參數。

用法

epmautomate calculateModel [jobName=JOB_NAME] [povName=POV_NAME] [modelName=MODEL_NAME] [executionType=EXECUTION_TYPE] [povDelimiter=DELIMITER] [optimizeForReporting=true|false] [captureDebugScripts=true|false] [comment=COMMENT] [PARAMETER=VALUE],其中:
  • jobName=JOB_NAME 是應用於計算模型的工作名稱。如果未從命令行覆寫,則會從工作取得計算模型所需的參數值。若未在命令行指定參數值,則為必要。預設值為計算。
  • povName=POV_NAME (選擇性) 是要計算的資料 POV 名稱。若要計算多個 POV,請使用逗號作為分隔符號來列出 POV 名稱。請勿使用任何其他分隔符號來分隔 POV 名稱。如果成員名稱中有空格,請以雙引號括住 POV 名稱清單。
  • modelName=MODEL_NAME (選擇性) 是要計算的模型名稱。如果名稱中包含空格,請以雙引號括住模型名稱。
  • executionType=EXECUTION_TYPE (選擇性) 是下列其中一項,用以識別規則執行類型。
    • ALL_RULES 可使用所有規則來計算 POV。

      若指定這個值,則請勿指定規則子集合或單一規則相關執行時期參數,例如 rulesetSeqNumStart、rulesetSeqNumEnd 和 ruleName。

    • RULESET_SUBSET 可使用規則集的子集合來計算 POV。

      若使用這個值,則必須指定 rulesetSeqNumStart 和 rulesetSeqNumEnd 值作為執行時期參數。

    • SINGLE_RULE 可執行特定規則來計算 POV。

      若使用這個值,則必須僅指定 ruleName 作為執行時期參數。

    • RUN_FROM_RULE 可從特定規則開始在 POV 上執行計算。

      若使用這個值,則必須僅指定 ruleName 作為執行時期參數。

    • STOP_AFTER_RULE 可在特定規則完成計算之後停止計算 POV。

      若使用這個值,則必須僅指定 ruleName 作為執行時期參數。

  • povDelimiter (選擇性) 是 POV 值中使用的分隔符號。預設分隔符號為 :: (兩個冒號)。分隔符號必須以雙引號括住。僅支援下列分隔符號:
    • _ (底線)
    • # (井號)
    • ~ (波狀符號)
    • % (百分比)
    • ; (分號)
    • : (冒號)
    • - (破折號)
  • optimizeForReporting=true|false (選擇性),指定是否使用報表最佳化來執行計算。預設值為 false。

    將此值設為 false 可略過建立聚總步驟以節省處理時間;例如,執行單一規則或連續系列的 POV 時。執行多個並行計算工作時,請為所有作業設定 optimizeForReporting=true,如此只有最後一個要完成的工作才會執行聚總,避免冗餘處理,並防止減慢執行中的作業速度。

  • captureDebugScripts=true|false (選擇性),識別是否要在收件匣中產生偵錯指令碼。Oracle 可能需要這些指令碼來疑難排解計算問題。預設值為 false。
  • COMMENT (選擇性),在雙引號中指定處理的相關註解。
  • PARAMETER=VALUE(選擇性),指出用於執行計算的執行時期參數和其值。依程序需要的數量指定參數和值配對。有效的參數和其值為:
    • rulesetSeqNumStart 指定規則集中要執行的第一個規則的序號。只有使用 EXECUTION_TYPE=RULESET_SUBSET 時才有效。
    • rulesetSeqNumEnd 指定規則集中要執行的最後一個規則的序號。只有使用 EXECUTION_TYPE=RULESET_SUBSET 時才有效。
    • ruleName 指定要執行的規則名稱。如果值包含空格字元,請以雙引號括住這個值。只有在 EXECUTION_TYPE 的值設為 SINGLE_RULE、RUN_FROM_RULE 或 STOP_AFTER_RULE 時才有效。
    • clearCalculatedData=true|false 指定是否要清除現有的計算。預設值為 false。
    • executeCalculations=true|false 指定是否要執行計算。預設值為 false。

    Note:

    參數值 (true 和 false) 必須全部小寫。

範例

  • 使用工作執行所有規則以計算單一 POV:

    epmautomate calculateModel jobName=CalculateUsingActualModel

  • 使用工作執行所有規則以計算單一 POV,但置換工作中的 POV_NAME、EXECUTION_TYPE 和 COMMENTS 值:

    epmautomate calculateModel jobName=CalculateUsingActualModel povName=FY22::Jan::Actual::Working executeCalculations=true comment="Running all rules to calculate a POV"