强制引用

为了确定在打印作业期间何时最适合运行脚本，以及需要访问哪些数据库字段，BarTender 会检查模板的结构，并试运行脚本。除其他因素之外，BarTender 还要考虑何时使用任意数据库字段和共享数据源以及如何使用。

条件语句会根据条件表达式的评估结果运行不同的代码“分支”。因此，根据条件的评估结果，有些代码可能不会运行。如果某些代码在脚本试运行期间被跳过，而其中恰好包含对字段或共享名称的引用，那么可能会产生问题。如果相关的条件语句在打印时具有不同的评估结果，以致要引用字段或共享名称，但在之前的试运行期间并没有执行引用，那么脚本可能无法在最有效的时机运行，甚至还可能会失败。

在这些情况下，可以使用强制函数来确保脚本会引用所需数据库字段或数据源名称。

BarTender 的内置强制函数

“脚本编辑器”包括两个强制脚本引用某数据库字段或数据源名称的函数：ReferenceField 和 ReferenceSharedSubString。这两个函数不会更改或分配任何值，而只会强制应用程序注意某个项目的存在，以免在脚本试运行期间错过。使用这两个函数时，BarTender 会建立与所有必需数据字段的链接，并在打印时运行脚本来响应相应的事件。

在“脚本助理”窗格中，展开函数书籍。
在“函数”文件夹中，展开“声明”文件夹。此文件夹中包含 ReferenceField 和 ReferenceSharedSubstring。

建议在脚本开始处，条件语句之前插入引用函数。

仅当模板连接至数据库时，ReferenceField 函数才可用。

仅当模板上的对象链接至具名数据源时，ReferenceSharedSubString 函数才可用。

强制引用数据库字段或具名数据源

在“脚本助理”窗格中，依次展开“函数”、“声明”和“ReferenceField”。
双击要强制引用的数据库字段的名称。“脚本”面板中会显示类似于以下内容的代码段：

ReferenceField("字段名称或字段号")

如果将文档配置为从常规文本文件中读取数据，请指定字段号。如果文档从数据库中读取数据，请指定字段名称。除非字段名称本身包含在变量中，否则一定要在字段名称两边加上引号，例如 ReferenceField("price")。

在“脚本助理”窗格中，依次展开“函数”、“声明”和“ReferenceSharedSubString”。
双击要强制引用的具名数据源。“脚本”面板中会显示类似于以下内容的代码段：

ReferenceSharedSubString("共享名称")

如果模板中的数据源具有名称，可以如所示强制引用该名称。除非数据源名称本身包含在变量中，否则一定要在名称两边加上引号，例如 ReferenceSharedSubString("price")。