循环周期级别的 RunInterfaceService (导出)

RunInterfaceService (导出) 宏用于运行接口服务，以便在循环周期的上下文中导出日历数据。此宏在循环周期级别执行。
此表列出了用于执行 RunInterfaceService (导出) 宏的参数：
参数 说明
接口服务名 运行的接口服务的名称。
方向 数据流的方向。
注意：创建宏时，此值设置为“导出”。
日历类型 导出数据的期间。可能的值：
  • 时段：在“周期标签”中指定的周期，使用 [周期标签]、[周期数] 和 [范围级别] 参数。
  • 当前时段：当前计划周期，使用 [周期数] 和 [范围级别]。
  • 开始时段：循环周期范围中第一个（最旧）周期，可用于检索所有时段。使用 [周期数] 和 [范围级别]。
注意：如果未指定值，则考虑开始时段。
周期标签 导出数据的起始期间。此项支持滚动周期节点。
注意：
  • 仅当“日历类型”设置为“时段”时，此字段才适用。
  • 如果未指定值，则考虑当前计划周期。
周期数 要导出的范围级别周期数。如果范围级别不等于用于存储计划的日历级别，或如果启用了“套筒式”选项，则导出选定周期中指定范围内的所有基础时段。可能的值：
  • 空：导出截至循环周期范围结束的所有基准期间。
  • 0：如果“日历类型”设置为“时段”，则导出属于周期标签中指定周期的所有基础时段。
  • >=1：导出从指定的开始周期开始，属于范围级别时段 [周期数] 的所有基准期间。
范围级别 [周期数] 用于导出的日历范围级别。
注意：如果未指定此值，则周期数基于存储方案值的日历级别。
必须按以下格式指定命令字段的值：RunInterfaceService (接口服务名, 方向, [日历类型], [周期标签], [周期数], [范围级别]).
注意：可选参数在 [ ] 中指定。
表 1. 示例
需求 参数
将基础日历周期从当前计划周期导出到日历级别的循环周期范围内，以便存储方案值（未定义套筒式周期）。 RunInterfaceService("My AP Calendar","Export","Current Bucket","")
导出基础日历周期，从与日历级别 6 个时段对应的当前计划周期开始，以便存储方案值。 RunInterfaceService("My AP Calendar","Export","Current Bucket","6")
导出基础日历周期，从与日历级别 10 个时段对应的 FY14 M12 周期，以便存储方案值。 RunInterfaceService("My AP Calendar","Export","Bucket","FY14 M12","10")
导出基础日历周期，从于与 10 个月对应的 FY14 M12 周期开始。 RunInterfaceService("My AP Calendar","Export","Bucket","FY14 M12","10", "Months")

从当前计划周期导出 1 个月日历数据的套筒式基础时段。例如，“FY14 M12”，该循环已启用了“套筒式”选项。用于存储计划的循环日历级别为“周”，循环的套筒式周期为 7 天，未来范围为 8 周。

结果是 1 个月套筒式基础时段，即 7 个每日时段、3 个每周时段）。

 RunInterfaceService("Export Scenario file","Export","Current Bucket","1","Months").

验证和错误消息

此表列出了循环周期状态及相关验证消息：
循环周期状态 方案状态 是否可以执行？ 验证消息
未决 N/A 否 由于循环周期的状态为“未决”，因此无法运行宏 {0}。
正在运行 任意 是 N/A
已完成 任意 是 N/A
已中止 任意 是 N/A
已暂停 任意 是 N/A
已存档 任意 否 由于循环周期的状态为“已存档”，因此无法运行宏 {0}
在成功验证和执行宏后，在指定循环周期的上下文中导出日历数据。如果验证失败，系统将中止宏并显示相关错误消息。此表列出了各种验证失败时显示的错误消息：
验证条件/规则 错误消息
检查传递的接口服务是否有效。 未找到接口服务“{0}”。
如果方向与所选接口服务的接口方向不匹配，则不执行宏。 方向参数“{0}”与所选接口服务“{1}”的方向不匹配。
如果日历级别低于存储方案值的日历级别，则系统会显示一条警告消息，并且中止导入过程。 日历级别“{0}”位于日历级别“{1}”之下，用于存储方案值。
循环周期上下文中的 RunInterfaceService 必须来自状态为“正在运行”、“已暂停”、“已完成”、“已中止”的循环周期。 无法为状态为“{0}”的循环周期执行 RunInterfaceService。
如果所选接口服务数据实体不适用于当前宏上下文，则不会执行宏，即 RunInterfaceService 只能在循环周期上下文中运行数据实体为日历的接口。 接口服务“{0}”与循环周期宏所需的数据实体不匹配。
在循环周期上下文中执行 RunInterfaceService 时，所选接口服务必须引用与当前循环周期日历匹配的日历。否则不执行宏。 在接口服务“{0}”中引用的日历与当前循环周期的日历不匹配
在执行 RunInterfaceService 进行导出时，请检查范围级别（如果已指定）是否有效。 无法找到范围级别“{0}”。
在执行 RunInterfaceService 进行导出时，请检查范围级别（如果已指定）是位于存储计划的日历级别，还是高于存储计划的日历级别（假如未启用“套筒式”选项）。 范围级别“{0}”位于日历级别“{1}”之下，用于存储方案值