用导航打开主题

强制引用

为了确定在打印作业过程中运行脚本的最佳时机，以及需要访问的数据库字段，BarTender 会检查模板结构，进行脚本运行测试。 除其他因素之外，BarTender 还要考虑何时使用任意数据库字段和数据源名称以及如何使用。 您可以强制先评估数据库字段或共享的具名数据源。

条件语句会根据条件表达式的计算结果执行不同的代码“分支”。 因此，根据计算时的条件，某些代码可能不会执行。 如果在其进行脚本运行测试的过程中，某字段或共享名称的引用刚好在跳过的代码中，就会产生问题。 如果相关的条件语句在打印时的计算结果不同，以致要引用该字段或共享名称，而在前面的运行测试过程中却并没有引用它，那么，脚本就可能无法在最有效的时机运行，甚至还可能失败。

BarTender 的内置强制函数

“脚本编辑器”包括两个强制脚本引用某数据库字段或数据源名称的函数： ReferenceField 和 ReferenceSharedSubString。 These functions don't change or assign any values. They simply force the application to notice the presence of an item that could be missed during the test run of a script. 这样可确保 BarTender 建立所有必需的数据字段的链接，还可确保在打印时能执行脚本来响应相应的事件。

在 BarTender 2016 中，具有 “<Empty>” 字段号的 VBScript 对象将显示错误消息 #3201： “An object on the template was set to read in the field '(field name)'. However, this field was not found. Proceed with unknown field as blank string?" 选择“是”，以便在模板预览中显示特定的空白字符串字段。 选择“否”，向空白字段添加内容。

关闭在“脚本编辑器”中查找两个强制函数

  1. 在“脚本助理”窗格中，展开函数书籍。

  2. 在“函数”下面，展开声明书籍。 有两本子书籍，ReferenceField 或 ReferenceSharedSubstring。

最好将引用函数插入脚本的开头处、所有条件语句之前。

The ReferenceField sub-book will be available only if your template is connected to a database.

The ReferenceSharedSubString sub-book will be available only if you have a Named Data Source linked to an object on your template.

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

您可以强制 VBScript 引用数据库字段或具名数据源。

关闭强制引用数据库字段

  1. 在“脚本助理”窗格中，打开“函数 > 声明 > ReferenceField”。

  2. 在您要强制的数据文件字段名称上双击。 “脚本”窗格中将显示代码段。

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

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

关闭强制引用具名数据源

  1. 在“脚本助理”窗格中，打开“函数 > 声明 > ReferenceSharedSubString”。

  2. 在您要强制的具名数据源上双击。 “脚本”窗格中将显示代码段。

    ReferenceSharedSubString("共享名称")

如果已为模板中任何数据源赋予了某名称，则可以如上所示强制引用它们。 （除非数据源名称存储在变量中，否则请用引号将名称引上。）

相关主题