Adobe ColdFusion 2021的CFScript是否支持CFDocument功能？

核心结论 #

Adobe ColdFusion 2021 已原生支持在CFScript中使用CFDocument功能，2018及更早的ACF版本确实无官方原生的CFScript对应实现，仅标签形式可用。

具体调用方法 #

ACF2021提供了全局的cfdocument()函数，参数与原<cfdocument>标签的属性完全兼容，支持所有原标签的配置项，使用示例如下：

// 导出PDF文件示例
cfdocument(
    format = "pdf",
    filename = expandPath("./export.pdf"),
    overwrite = true,
    marginTop = 10,
    marginBottom = 10
) {
    // 文档主体内容区域
    writeOutput("<h2>销售数据报表</h2>");
    writeOutput("<table border='1'><tr><th>产品名称</th><th>销售额</th></tr>");
    writeOutput("<tr><td>产品A</td><td>12000</td></tr></table>");

    // 原cfdocumentitem、cfdocumentsection标签均有同名CFScript函数支持
    cfdocumentitem(type = "header") {
        writeOutput("<p style='text-align:right;'>生成时间：#now()#</p>");
    }
    
    cfdocumentitem(type = "footer") {
        writeOutput("<p style='text-align:center;'>第 #cfdocument.currentpagenumber# 页 / 共 #cfdocument.totalpages# 页</p>");
    }
}

注意事项 #

• 该功能需要ColdFusion 2021 累积更新1及以上版本支持，如果你使用的是初始发行版，建议先安装官方最新累积更新包避免功能异常
• 实现逻辑与Lucee的CFScript CFDocument基本一致，原有Lucee环境的相关代码仅需少量调整即可兼容ACF2021环境
• 所有原<cfdocument>体系下的子标签均有对应的CFScript函数可用，参数规则与标签属性完全对齐

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