ClearMeasure 宏

ClearMeasure 宏用于清除方案中所有维度（除周期散布度量）或指定货品、库位、周期或指定标签中指定度量的数据。此宏在方案级别执行。
此表描述了用于宏的参数：
参数名 说明
度量代码 要为其清除数据的度量代码。
注意：
  • 如果未定义，则考虑所有可用的度量代码（不包括周期散布度量）。
  • 对于业务数据/订单，度量代码可以引用源或目标。
货品层次结构节点 该级别上用于存储方案值的传递节点的所有子级实体。
注意：如果未指定，则考虑所有货品。
库位层次结构节点 基础级别上传递节点的所有子级实体。
注意：
  • 如果未指定，则考虑所有库位。
  • 对于业务数据度量，库位层次结构节点指业务/订单数据的目标库位。
周期标签 该级别上用于存储方案值的传递节点的所有子级实体。此项也支持滚动周期节点。
注意：
  • 若未指定，则考虑包含 pconst 的循环周期范围。
  • 对于业务数据度量，周期标签应用于业务/订单数据的交货/结束/接收日期。
  • 对于市场情报度量，清除开始日期和结束日期在周期标签内的 MI 事件。
标记 如果已指定，则清除带有标签的度量数据。
筛选 此筛选条件应用于指定货品和库位层次结构级别的选定货品和库位。指定周期标签中符合筛选条件的库位货品用于清除度量。
对于执行宏，必须使用以下格式指定“命令”字段的值：ClearMeasure([度量代码], [货品层次结构节点], [库位层次结构节点], [周期标签], [标记], [筛选])
注意：可选参数在 [ ] 中指定。

在执行宏时，将清除由参数定义的标准中的度量值。对于业务数据度量，系统将清除“自度量”和“至度量”值，并删除业务数据记录。

对于市场情报度量，系统将清除度量值并删除 MI 事件：

注意：
  • 从数据处理中排除状态为“未决”或“待删除”的 MI 事件（其中用户不负责编辑方案）。
  • 使用“删除 MI 事件”宏可以对 MI 事件进行高级删除（包括其他筛选）。
表 1. 示例
需求 参数
清除循环周期范围内所有周期和所有库位的所有货品的度量（排除周期散布度量）。 ClearMeasure("","","","")
清除循环周期范围内所有周期和所有库位的所有货品的 FREV 度量。 ClearMeasure("FREV","","","")
清除循环周期范围内所有库位的 GOO 货品的度量（排除周期散布度量）。 ClearMeasure("","GOO","","")
清除循环周期范围内所有库位的所有 DC 货品的度量（排除周期散布度量）。 ClearMeasure("","","All DCs","")
清除（在存储计划的循环日历级别）日历周期“FY 10”持续时间内所有库位的所有货品的度量（排除周期散布度量）。 ClearMeasure("","","","FY 10")
清除（在存储方案值的日历级别）“今年”内 US 库位的 GOO 货品的 BREV 度量。 ClearMeasure("BREV","GOO","US","Current Year")
清除循环周期范围内所有周期和所有库位的所有货品中具有 DPLS_AdvanceForecasting 标签的度量（排除周期散布度量）。 ClearMeasure ("","","","","DPLS_AdvanceForecasting")
清除循环周期范围内 DPLS_HUNITS > 0 的所有库位货品组合中具有 DPLS_AdvanceForecasting 标签的度量（排除周期散布度量）。 ClearMeasure ("","","","","DPLS_AdvanceForecasting", "[DPLS_HUNITS] > 0")

清除循环周期范围内所有周期和所有库位的所有货品的业务数据度量 SPLS_PRODUCTION_PLANNED_TD。

这会清除与业务数据（SPLS_PRODUCTION_PLANNED_TD 和 SPLS_PRODUCTION_PLANNED_SHIFTED_TD）和业务数据记录关联的两个度量的度量值。

 ClearMeasure ("SPLS_PRODUCTION_PLANNED_TD","","","")

清除目标库位“IN:B1 to F1 by Truck”上所有货品的业务数据度量 SPLS_PRODUCTION_PLANNED_TD，该数据的接收日期位于“FY19 M03”时段内。

这会清除与业务数据（SPLS_PRODUCTION_PLANNED_TD 和 SPLS_PRODUCTION_PLANNED_SHIFTED_TD）和业务数据记录关联的两个度量的度量值。

 ClearMeasure ("SPLS_PRODUCTION_PLANNED_TD","IN:B1 to F1 by Truck","FY19 M03","")
清除所有货品和库位的市场情报度量 DPLS_FMI_EVENT，这些事件的开始和结束日期都在周期 FY20 M06 中，删除度量值和 MI 事件。 ClearMeasure ("DPLS_FMI_EVENT","","","FY20 M06")

执行宏时执行验证。如果任何验证失败，将中止宏并显示相关错误消息。

下表描述了在各种循环周期、方案状态和验证消息中运行宏的能力。
循环周期状态 方案状态 是否可以执行？ 验证消息
未决 N/A 否 由于循环周期的状态为“未决”，因此无法运行宏 {0}
正在运行 WIP 是 N/A
正在运行 审查、已拒绝、已停止、已核准、已发布 否 由于方案的状态为{1}，因此无法运行宏 {0}
已暂停 任意 否 由于循环周期未运行，因此无法运行宏 {0}
已完成 任意 否 由于循环周期的状态为“已完成”，因此无法运行宏 {0}
已中止 已停止 否 由于循环周期的状态为“已中止”，因此无法运行宏 {0}
已存档 任意 否 由于循环周期的状态为“已存档”，因此无法运行宏 {0}
此表描述了宏执行过程中显示的错误消息。
验证条件 错误消息
无法在相同的宏命令中针对度量参数和标签参数传递值，只能传递其中一种参数。 无法指定度量和标签。
检查标签名称是否存在，是否已启用 无法找到标签“{0}”。