方案级别的 RunInterfaceService (导出)
RunInterfaceService (导出) 宏用于运行接口服务,以便导出当前方案的计划数据。此宏在方案级别执行。
此表列出了用于执行 RunInterfaceService (导出) 宏的参数:
参数 | 说明 |
---|---|
接口服务名 | 运行的接口服务的名称。 |
方向 | 数据流的方向。值必须设置为“导出”。 |
货品层次结构节点 | 要导出的货品。 注意:如果未指定值,则导出所有货品。
|
库位层次结构节点 | 要导出货品的库位。 注意:如果未指定值,则导出所有库位。
|
日历类型 | 导出数据的期间。可能的值:
注意:如果未指定值,则考虑开始时段。
|
周期标签 | 要导出的循环周期。此项支持滚动周期节点。 注意:
|
周期数 | 要导出的范围级别周期数。如果范围级别不等于用于存储方案值的日历级别,或如果启用了“套筒式”选项,则导出选定周期中指定范围内的所有基础时段。可能的值:
|
范围级别 | [周期数] 用于导出的日历范围级别。 注意:如果未指定此值,则周期数基于存储方案值的日历级别。
|
筛选 | 用于确定货品和库位选择的筛选器。仅导出符合筛选条件的选定货品和库位的相关数据。 |
必须按以下格式指定“命令”字段的值:RunInterfaceService (接口服务名, 方向, [货品层次结构节点], [库位层次结构节点], [日历类型], [周期标签], [周期数], [范围级别], [筛选]).
注意:可选参数在 [ ] 中指定。
需求 | 参数 |
---|---|
导出循环周期范围内当前计划周期的所有库位的所有货品。 | RunInterfaceService("导出方案文件","导出","","","当前时段","") |
导出存储方案值的日历级别中日历时段“今年”持续时间内所有库位的 GOO 货品(未定义套筒式时段)。 | RunInterfaceService("导出方案文件","导出","GOO","","时段","今年","0") |
导出当前计划周期内所有库位的 GOO 货品。例如,“FY10 M03”为 1 个月周期(如果用于存储方案值的循环日历级别 = 月份)。 | RunInterfaceService("导出方案文件","导出","GOO","","当前时段","1"). |
导出 52 个周周期(如果用于存储方案值的循环日历级别 = 周)的当前循环周期的 US 库位的所有货品。 | RunInterfaceService("导出方案文件","导出","","US","当前时段","52")。 |
导出 9 个月周期(如果用于存储方案值的循环日历级别 = 月份)的日历时段“FY10 M03”的所有库位的所有货品。 | RunInterfaceService("导出方案文件","导出","","","时段","FY10 M03","9") |
导出循环周期范围内所有周期所有库位的所有货品,从第一个(最旧)历史周期开始。 | RunInterfaceService("导出方案文件","导出","","","","") |
导出用于存储方案值的日历级别中 7 个周期内所有库位的所有货品,从循环周期范围中第一个(最旧)周期开始。如果循环范围指定为历史 = 6 和未来 = 6。结果是导出流程中的 6 个历史周期和 1 个未来周期(未定义套筒式时段)。 | RunInterfaceService("导出方案文件","导出","","","开始时段","7") |
导出 pconst 为 0 < [DPLS_FUNITS] 的所有库位的 GOO 货品。例如,“FY10 M03”为 1 个月周期(如果用于存储方案值的循环日历级别 = 月份且未定义套筒式时段)。 | RunInterfaceService("导出方案文件","导出","GOO","","当前时段","1","", "0 < [DPLS_FUNITS]"). |
导出每周周期 3 个月(如果用于存储方案值的循环日历级别 = 周)的日历时段“FY10 M03”中所有库位的所有货品。 | RunInterfaceService("导出方案文件","导出","","","时段","FY10 M03","3", "月") |
导出当前计划周期内所有库位的 GOO 货品。例如,“FY10 M03”为每周周期的 1 个月(如果用于存储方案值的循环日历级别 = 周且未定义套筒式时段)。 | RunInterfaceService("导出方案文件","导出","GOO","","当前时段","1","月"). |
导出当前计划周期内所有库位的 GOO 货品。例如,“FY10 M03”为一个月,其中为循环启用了套筒式。用于存储方案值的循环日历级别为“周”,循环的套筒式周期为 7 天,未来范围为 8 周。结果是 1 个月套筒式基础时段,即 7 个每日时段、3 个每周时段)。 | RunInterfaceService("导出方案文件","导出","GOO","","当前时段","1","月"). |
验证和错误消息
此表列出了循环周期状态及相关验证消息:
循环周期状态 | 方案状态 | 是否可以执行? | 验证消息 |
---|---|---|---|
未决 | N/A | 否 | 由于循环周期的状态为“未决”,因此无法运行宏 {0} |
正在运行 | 任意 | 是 | N/A |
已完成 | 任意 | 是 | N/A |
已中止 | 任意 | 是 | N/A |
已暂停 | 任意 | 是 | N/A |
已存档 | 任意 | 否 | 由于循环周期的状态为“已存档”,因此无法运行宏 {0} |
在宏成功验证和执行后,将为当前方案导出计划数据。如果验证失败,系统将中止宏并显示相关错误消息。此表列出了各种验证失败时显示的错误消息:
验证条件/规则 | 错误消息 |
---|---|
检查传递的接口服务是否有效。 | 未找到接口服务“{0}”。 |
如果所选接口服务数据实体不适用于当前宏上下文,则不会执行宏,即方案的 RunInterfaceService 只能运行数据实体为方案值的接口。 | 接口服务“{0}”与方案宏所需的数据实体不匹配。 |
如果方向与所选接口服务的接口方向不匹配,则不执行宏。 | 方向参数“{0}”与所选接口服务“{1}”的方向不匹配。 |
如果日历级别低于存储方案值的日历级别,则系统会显示一条警告消息,并且中止导入过程。 | 日历级别“{0}”位于日历级别“{1}”之下,用于存储方案值。 |
循环周期上下文中的 RunInterfaceService 必须属于状态为“正在运行”、“已暂停”、“已完成”、“已中止”的循环周期。 | 无法为状态为“{0}”的循环周期执行 RunInterfaceService。 |
在循环周期上下文中执行 RunInterfaceService 时,所选接口服务必须引用与当前循环周期日历匹配的日历。否则不执行宏。 | 在接口服务“{0}”中引用的日历与当前循环周期的日历不匹配。 |
在执行 RunInterfaceService 进行导出时,请检查范围级别(如果已指定)是否有效。 | 无法找到范围级别“{0}”。 |
在执行 RunInterfaceService 进行导出时,请检查范围级别(如果已指定)是位于存储计划的日历级别,还是高于存储方案值的日历级别(假如未启用“套筒式”选项)。 | 范围级别“{0}”位于日历级别“{1}”之下,用于存储方案值。 |