Docker环境下jsReport渲染docx复选框失效问题求助

在Docker环境下使用jsReport将自定义docx模板渲染为PDF时，字符串字段（如姓名、出生日期等）渲染正常，但布尔值字段ready被渲染为字符串"true"而非复选框样式，传入的数据结构如下：

{
"customer": {
"fullName": "John Doe",
"birthDate": "10.10.1999",
"companyRegistrationNumber": " / AB123456",
"fullAddress": "Street 1234 B5",
"email": "mail@support.com"
},
"date": "11.09.2022",
"ready": true
}

解决方法 #

1. 修正docx模板的复选框绑定 #

jsReport的docx渲染引擎需要模板中的复选框通过内容控件绑定到布尔字段，而非直接插入文本占位符：

• 打开docx模板，启用「开发者选项」，插入复选框内容控件
• 选中该复选框，打开控件属性，在「绑定」区域设置XPath为对应字段路径（比如/root/ready，根据你的数据结构调整）
• 确保复选框的状态与布尔值关联：勾选状态对应true，未勾选对应false

2. 用自定义脚本生成复选框符号 #

如果模板绑定无法生效，可在jsReport的渲染脚本中手动将布尔值转换为复选框符号：

• 在模板的「Scripts」部分添加前置渲染脚本：

function beforeRender(req, res, done) {
  req.data.readyCheckbox = req.data.ready ? '☑' : '☐';
  done();
}

• 将docx模板中的{{ready}}占位符替换为{{readyCheckbox}}，渲染时会显示对应状态的复选框符号

3. 检查并更新jsreport-docx插件版本 #

旧版本的jsreport-docx插件可能存在布尔值与复选框的兼容性问题：

• 进入Docker容器，执行命令查看插件版本：

jsreport-cli list plugins

• 若版本较旧，执行更新命令：

jsreport-cli install jsreport-docx --save

• 重启jsReport服务后重新测试

4. 验证数据类型正确性 #

确保传入jsReport的ready字段是布尔类型而非字符串：

• 在前置渲染脚本中添加日志验证：

function beforeRender(req, res, done) {
  console.log(typeof req.data.ready); // 正常应输出"boolean"
  // 若为字符串类型，手动转换
  if (typeof req.data.ready === 'string') {
    req.data.ready = req.data.ready === 'true';
  }
  done();
}

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