jsReport使用docxChild助手报错“需设置asset参数”的问题咨询

核心问题原因 #

你之前的{{docxChild "test_jsReport2.docx"}}写法不符合助手的参数要求，docxChild需要明确指定asset命名参数，而非直接传递字符串。

正确操作步骤 #

1. 确认资产关联状态

   • 打开主模板test-word的Assets标签页，确保已添加并关联test_jsReport2.docx资产；若资产在子文件夹中，需确认路径正确。
   • 检查资产名称的大小写、空格是否完全匹配，jsReport对文件名大小写敏感。

2. 修正docxChild调用语法
   以下两种方式二选一：

   • 使用资产名称调用（适用于无重名资产的场景）：

     {{docxChild asset="test_jsReport2.docx"}}
     

   • 使用资产shortid调用（更稳定，避免名称冲突）：
     进入test_jsReport2.docx资产详情页，复制其shortid（可从URL或属性栏获取），替换为如下格式：

     {{docxChild asset="your-asset-shortid-here"}}
     

3. 验证模板基础设置

   • 确保主模板test-word的引擎设置为handlebars，docxChild是该引擎的内置助手，引擎不匹配会导致助手无法正常工作。
   • 移除你之前添加的自定义注册助手脚本，默认情况下jsReport已内置docxChild，手动注册可能导致冲突。

额外排查点 #

• 若资产在子目录下，调用时需带上路径，例如：{{docxChild asset="subfolder/test_jsReport2.docx"}}
• 重新上传资产文件，确认文件本身无损坏（你已验证单独运行正常，此步可跳过）

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