Aspose.Words Java版buildReport()生成无效超链接原因排查

使用Aspose.Words Java版结合LINQ报表语法动态生成报告，参考官方文档使用<<link [uri_or_bookmark_expression] [display_text_expression]>>标签插入超链接。执行buildReport()后，生成的内容为HYPERLINK \l "LinkLabel"，而手动在Word中创建的超链接（按Alt+F9查看域代码）格式为{ HYPERLINK \l "LinkLabel" }，因缺失大括号导致超链接无效。请问该问题原因是什么？操作是否存在错误假设？

相关代码示例：

_engine = new ReportingEngine();
_engine.getKnownTypes().add(Helper.class);
_engine.setOptions(ReportBuildOptions.ALLOW_MISSING_MEMBERS | ReportBuildOptions.REMOVE_EMPTY_PARAGRAPHS);
Document document = new Document();
DocumentBuilder builder = new DocumentBuilder(document);

builder.write("<<link [LinkLabel]>>");
// document.getText(): <<link [LinkLabel]>>
_engine.buildReport(document, dataSource, "NewDoc");
// document.getText() now: HYPERLINK \l "LinkLabel"

• 问题根源：通过DocumentBuilder.write()写入的LINQ报表标签属于普通文本，报表引擎处理后输出的HYPERLINK内容同样是纯文本，而非Word的域对象。Word中超链接的大括号{}是域结构的标识，纯文本格式的HYPERLINK无法被识别为有效超链接。
• 错误假设：默认DocumentBuilder.write()写入的标签会被报表引擎解析并生成域对象，但实际上该方法仅写入纯文本，报表引擎处理后不会自动将结果转换为域结构。
• 解决办法：
  1. 提前制作包含<<link>>标签的Word模板文件（.docx），使用Aspose.Words加载该模板后执行buildReport()，报表引擎会正确识别标签并生成带大括号的HYPERLINK域。
  2. 若需动态构建模板内容，可在报表处理完成后，遍历文档内容将纯文本的HYPERLINK \l "xxx"替换为对应的域对象，或者直接使用DocumentBuilder.insertField()方法手动插入超链接域。

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