如何通过XML向AEM 6.1 Forms API传输富文本？

嘿，别担心，AEM 6.1里完全可以实现把外部富文本传入PDF模板的需求，我给你梳理下具体的操作步骤和注意点：

1. 先搞定外部XML的富文本格式 #

你的外部数据源里的富文本内容必须是合法的XHTML结构，因为AEM Designer的富文本字段默认只解析标准XHTML。举个正确的示例：

<userDescription>
  <p>这是一段<b>加粗</b>的自我介绍，还有<i>斜体</i>的重点内容。</p>
  <p>下面是换行测试<br/>是不是成功换行了？</p>
  <p>还支持<span style="color:#2E8B57">自定义颜色</span>的文本哦</p>
</userDescription>

注意：XML节点里的XHTML标签要完整闭合，不要出现未结束的标签，否则可能解析失败。

2. 检查Designer模板的绑定设置 #

你已经用XML Schema建了数据连接，接下来要确认富文本字段的绑定是否正确：

• 打开PDF模板，选中目标富文本字段
• 在右侧Object > Field面板的“Value”选项中，绑定到XML Schema里对应的富文本节点（比如上面的userDescription）
• 一定要在“Options”标签下确认Allow Rich Text Formatting是勾选状态（你之前应该设过，但再检查下准没错）

3. API传输时的关键细节 #

当你通过API把XML数据传给AEM生成PDF时，注意这两点：

• 确保XML数据的编码是UTF-8，避免出现中文或特殊字符乱码
• 如果用的是AEM Forms Service的标准API（比如generatePDF方法），直接把包含富文本的完整XML作为数据源参数传入即可，API会自动把XHTML内容渲染到对应的富文本字段中
• 建议先在Designer里手动导入测试XML预览效果，确认富文本渲染正常后再走API流程，这样能快速排查模板端的问题

4. 常见坑点排查 #

• 如果富文本显示成带标签的纯文本：要么是XML里的内容不是标准XHTML，要么是字段没开启富文本格式，回去检查这两个点
• 如果部分样式不生效：比如字体、颜色，要确认Designer里富文本字段的默认样式和XHTML中的内联样式是否兼容，AEM 6.1支持大部分基础CSS内联样式，但复杂样式可能需要调整模板的默认设置

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