EmailWorksheet 宏

EmailWorksheet 宏用于加载具有传递上下文（货品、库位和周期）的工作表，并将工作表通过电子邮件发送给用户。此宏在方案级别执行。
宏参数决定要通过电子邮件发送的上下文和工作表。此表列出了用于执行 EmailWorksheet 宏的参数。此宏不支持多面板工作表。
参数 说明
导出类型 用于发送的工作表文件格式。可能的选项：
  • PDF
  • XLS
工作表名称 要执行和通过电子邮件发送的工作表名称。
用户 工作表的电子邮件收件人。
注意：用户必须具有工作表的访问权限。
已传递货品 传递到工作表的货品选择。此值可以是单个元素或元素集。
注意：
  • MDX 定义支持元素集。
  • 如果未指定此值，则使用默认工作表定义（如果已定义），否则使用默认层次结构的顶部节点。
  • 如果需要当前货品数据上下文，可以使用 %itemcontext%（此参数仅在工作表中执行命令时才适用）。
已传递的位置 传递到工作表的库位选择。此值可以是单个元素或元素集。
注意：
  • MDX 定义支持元素集。
  • 如果未指定此值，则使用默认工作表定义（如果已定义），否则使用默认层次结构的顶部节点。
  • 如果需要当前库位数据上下文，可以使用 %locationcontext%（此参数仅在工作表中执行命令时才适用）。
已传递的时间段 传递到工作表的周期选择。此值可以是单个元素或元素集。
注意：
  • MDX 定义支持元素集。
  • 如果未指定此值，则使用默认工作表定义（如果已定义），否则使用默认层次结构的顶部节点。
  • 如果需要当前周期数据上下文，可以使用 %periodcontext%（此参数仅在工作表中执行命令时才适用）。
必须按以下格式指定“命令”字段的值：EmailWorksheet(导出类型, 工作表名称, 用户/角色, [已传递货品], [已传递库位], [已传递周期])
注意：可选参数在 [ ] 中指定。
表 1. 示例
需求 参数
执行带有工作表定义中默认项目、位置和周期选择的“需求利润分析”工作表并以电子邮件形式将 PDF 输出发送到用户“Scott”。

EmailWorksheet("PDF","需求利润分析","Scott").

EmailWorksheet("PDF","需求利润分析","Scott","","","").
执行带有工作表定义中默认项目、位置和周期选择的“需求要素”工作表并以电子邮件形式将 XLS 输出发送到用户“Harry”。 EmailWorksheet("XLS","需求要素","Harry","","","").
执行带有“品牌 A”项目节点、默认位置选择和“滚动周”周期节点的“预测准确性分析”工作表并以电子邮件形式将 PDF 输出发送至用户“Harry”。 EmailWorksheet("PDF","预测准确性分析","Harry","品牌 A","","滚动周").

验证和执行

在成功验证和执行宏后，系统将加载包含选定货品、库位和周期的工作表，并通过电子邮件发送到指定用户。以下是验证规则：

  • 如果宏参数为空，则使用在工作表中为货品、库位和周期选择指定的默认值。
  • 如果货品、库位和周期的宏参数和工作表默认参数为空，则使用货品、库位和周期的顶部节点选择。

验证和错误消息

此表列出了循环周期和方案状态及相关验证消息：
循环周期状态 方案状态 是否可以执行？ 验证消息
未决 N/A 否 由于循环周期的状态为“未决”，因此无法运行宏 {0}。
正在运行 任意 是 N/A
已暂停 任意 否 由于循环周期的状态为“已暂停”，因此无法运行宏 {0}
已完成 任意 是 N/A
已中止 任意 是 N/A
已存档 任意 否 由于循环周期的状态为“已存档”，因此无法运行宏 {0}。
执行 EmailWorksheet 宏时执行验证。如果验证失败，将中止宏并显示相关错误消息。此表列出了各种验证失败时显示的错误消息：
验证条件 错误消息
确保工作表对当前用户和模块有效。 未为模块 {1} 或用户 {2} 启用工作表 {0}。
只有标准工作表支持添加工作表屏幕捕获。

暂不支持多面板工作表。

 无效参数值 {0}。数据表的类型不是“标准”。
确保导出类型对应可用的格式。 无效参数值 {0}。导出类型必须为 PDF 或 XLS。
确保指定用户有效并且具有有效的电子邮件地址。 未找到用户 {0}。
确保指定用户拥有对所需工作表的访问权限。 用户“{0}”无权访问工作表“{1}”
如果已指定，则确保货品节点有效。 未找到货品 {0}。
如果已指定，则确保库位节点有效。 未找到库位 {0}。
如果已指定，则确保周期节点有效。 无法找到周期标签 {0}。
如果已指定，则确保可以评估货品节点的值。

在某些情况下，工作表参数 rv_item_passed 不能用于初始化宏参数。

 无法评估传递的货品。请定义一个备用选择。
如果已指定，则确保可以评估库位节点的值。

在某些情况下，工作表参数 rv_location_passed 不能用于初始化宏参数。

 无法评估传递的库位。请定义一个备用选择。
如果已指定，则确保可以评估为期间节点指定的值。

在某些情况下，工作表参数 rv_period_passed 不能用于初始化宏参数。

 无法评估传递的周期。请定义一个备用选择。