使用作业

您可以使用在 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 是应用于计算模型的作业的名称。如果未从命令行覆盖,则从作业中获取计算模型所需的参数值。如果未在命令行上指定参数值,则需要此项。默认值为 Calculation(计算)。
  • 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"