从 Better PDF Exporter 迁移
Exportelier 不会执行 Better PDF Exporter 的模板，也不会复制其资源。迁移意味着选择最能保留每个模板意图的 Exportelier 编写模式，然后基于具有代表性的 Jira 数据验证结果。
当现有的品牌 Word 布局是唯一可信来源时，请使用 Word Template Mode。当一个与格式无关的模板需要同时生成 PDF、Markdown 和 DOCX 时，请使用可视化设计器。Word 模板只支持 DOCX 输入、DOCX 输出。
对应关系表
| 现有结构或需求 | Exportelier 对应方式 | 迁移说明 |
|---|---|---|
| 品牌页面布局、样式、原生页眉、页脚和页码 | Word Template Mode | 上传不含宏的 .docx；原生 OOXML 布局会原样保留。 |
| 用一个维护中的模板生成 PDF、Markdown 和 DOCX | 可视化设计器 | 使用受支持的设计器组件重建一次布局。 |
| 问题键、摘要、状态、人员和日期 | 字段绑定或 Word 值 token | 请使用 token 参考，而不是复制原有产品的占位符。 |
| 重复的评论、子任务、工作日志或附件 | 设计器表格/列表组件，或 Word 的 ${#each …} 循环 | 请显式验证空集合和大型集合的情况。 |
| 可选内容 | Word 的 ${#if path} 条件 | Word 条件只判断真值；不支持表达式和脚本。 |
| 描述和评论的富文本 | 支持 ADF 的文本渲染 | 请在示例输出中检查表格、列表、代码块和不受支持的 ADF 回退。 |
| 附件图库或元数据列表 | 设计器附件组件，或 Word 附件元数据循环 | 嵌入的二进制内容和远程图片存在与格式相关的限制。 |
| 搜索、看板、冲刺、版本或待办事项列表的选择 | 导出上下文，位于模板之外 | JQL 和数据获取绝不会在 Word 模板内部运行。 |
| PDF 签名、水印或嵌入 PDF 附件 | PDF 专属的设计器设置 | 这些无法映射到 Word Template Mode，在设计器导出 DOCX 时也可能降级。 |
| Groovy、JavaScript、XSL-FO 扩展或任意表达式 | 无直接对应 | 请改用字段绑定、固定格式化器和显式布局组件。脚本绝不会被执行。 |
推荐路径
- 按实际导出量和业务 影响清点排名前三的模板。
- 为每个模板分别判断：是原生 Word 保真度更重要，还是多格式维护更重要。
- 从任何候选 Word 模板中移除宏和活动内容。
- 使用 token 参考替换占位符，或在可视化设计器中重建布局。
- 至少测试一个内容稀疏的问题、一个普通问题，以及一个包含大量富文本和集合的问题。
- 将结果与商定的验收清单进行比较——而不是与原有引擎未记录的行为进行比较。
如果您希望在重建过程中获得帮助，请联系支持；我们为一定数量的模板提供协助迁移服务。
硬性边界
- 上传的 Word 模板只能生成 DOCX。
- 启用宏的文件、活动内容和不安全的关系会被拒绝。
- 外部模板语法绝不会被执行。
- 设计器导出 DOCX 存在已记录的降级情况——参见输出格式。