sysext:form 如何在email finisher中包含StaticText用于法律类确认邮件

默认状态下，sysext:form的邮件渲染逻辑仅收集表单内可提交的输入类元素值，不会自动把同表单下配置的StaticText（固定说明文本、法律条款块）传递到确认邮件中，可按照以下步骤调整配置实现需求：

• 开启StaticText元素收集开关
  在表单的EmailFinisher配置段中，找到renderingOptions配置项，将includeStaticTextElements参数设置为true。该参数默认关闭，开启后渲染引擎会在生成邮件内容时，遍历表单结构树中的所有StaticText元素，把元素对应的内容按照表单内的排版顺序传递到邮件模板的渲染变量中，不会仅提取输入项的提交值。
• 匹配多分页场景的收集范围
  如果你的表单是多步骤分页结构，需要在同一个EmailFinisher配置中将collectionScope设置为allPages，避免漏收集前置步骤中（比如第一步勾选同意条款的说明块）的StaticText内容，保证所有法律相关文本都完整纳入邮件内容。
• 自定义邮件模板适配打印需求
  覆盖默认的EmailFinisher邮件模板，将传递过来的StaticText内容按照原表单的层级顺序渲染，不要打乱文本的先后排版。同时给StaticText内容块增加专属打印适配规则：
  • 输出时使用块级结构化标签排版，避免依赖浮动、绝对定位等复杂布局，降低不同邮件客户端的样式兼容问题
  • 配套设置打印媒体查询样式，确保邮件导出打印时StaticText内容不会被截断、隐藏，保留合适的行高与段间距，符合正式文档的打印阅读要求
• 修正元素归属范围
  确保需要纳入邮件的StaticText元素是直接配置在表单的结构树内，而非表单外独立放置的页面内容块。如果静态文本是散落在页面其他位置的独立内容插件，上述收集开关无法识别到这部分内容，需要将对应法律文本块迁移为表单结构下的独立StaticText元素，避免内容遗漏。

配置校验提示：完成调整后，可通过填写测试表单提交确认邮件，逐字核对邮件中StaticText内容与表单页面展示内容的一致性，重点检查条款顺序、特殊字符、加粗强调内容的保留情况；同时要保证StaticText元素在表单结构树中的顺序和页面展示顺序完全一致，避免邮件中条款排序错乱带来的法律风险。

内容的提问来源于stack exchange，提问作者Ben