Abrir tema con navegación

Forzar referencias

Para que BarTender determine el mejor momento para que se ejecuten los archivos de comandos durante una tarea de impresión y qué base de datos habrá que usar, la aplicación examina la estructura de la plantilla y realiza una ejecución de prueba de los archivos de comandos.Entre otros factores, BarTender considera cómo y cuándo se usan los nombres compartidos de la base de datos y los orígenes de datos. Es posible forzar un campo de base de datos o un origen de datos con nombre para que primero se evalúe.

Las instrucciones condicionales ejecutan diferentes "ramas" de código, en función de cómo se evalúe una expresión condicional. Por consiguiente, parte del código podría no ejecutarse, dependiendo de las condiciones del momento de la evaluación. Esto puede suponer un problema si una referencia a un campo o nombre de parte resulta ser código saltado durante la ejecución de prueba de los archivos de comandos. Si la instrucción condicional asociada se evalúa de un modo diferente en el momento de imprimir y produce una referencia a campo o compartir nombre que no se produjo durante la anterior prueba de ejecución, el archivo de comandos podría no ejecutarse en el momento más apropiado e incluso podría fallar.

Funciones de forzado integradas de BarTender

El Editor de archivos de comando incluye dos funciones que fuerzan a que una secuencia de comandos para que haga referencia a un nombre de campo de base de datos u origen de datos: ReferenceField y 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. Así se garantiza que BarTender establezca enlaces a todos los campos de datos necesarios y que se ejecuten los archivos de comandos en respuesta a los eventos adecuados en el momento de imprimir.

En BarTender 2016, un objeto VBScript con número de campo "<Vacío>" devolverá el mensaje de error #3201:"Se estableció que un objeto de la plantilla leyera en el campo '(nombre del campo)'. Sin embargo, no se ha encontrado ese campo. ¿Desea continuar con los campos desconocidos como cadenas en blanco?" Seleccione Sí para que en la vista previa de la plantilla se muestre el campo en blanco especificado. Seleccione No para añadir contenido al campo vacío.

CerradoPara encontrar las dos funciones de forzado en el Editor de archivos de comando

  1. En el panel Ayudante para archivos de comandos, abra el libro Funciones.

  2. Dentro de Funciones, se abre el libro Declaraciones. Dentro encontrará dos sublibros, ReferenceField y ReferenceSharedSubstring.

Es mejor que se inserten las funciones de referencia al principio del archivo de comandos, antes de cualquier instrucción condicional.

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.

Forzar una referencia a un campo de base de datos o un origen de datos con nombre

Puede forzar un archivo de comandos VBScript para referenciar a un campo de base de datos o un origen de datos con nombre.

CerradoPara forzar una referencia a un campo de base de datos

  1. En el panel Ayudante para archivo de comandos, abra Funciones > Declaraciones > ReferenceField.

  2. Haga doble clic en el nombre del campo de archivo de datos que desea forzar. En el panel Archivo de comandos se mostrará un fragmento del código:

    ReferenceField("nombre de campo o número de campo")

Si el documento se configura para que lea datos de un archivo de texto normal, se especificará un número de campo. Al leer de una base de datos, se especificará un nombre de campo. A menos que el nombre de campo esté contenido en una variable, debe asegurarse de que aparece entre comillas, como en ReferenceField("precio").

CerradoPara forzar una referencia a un origen de datos con nombre

  1. En el panel Ayudante para archivo de comandos, abra Funciones > Declaraciones > ReferenceSharedSubString.

  2. Haga doble clic en el origen de datos con nombre que desea forzar. En el panel Archivo de comandos se mostrará un fragmento del código:

    ReferenceSharedSubString("Compartirnombre")

Si se ha dado algún nombre a algún origen de datos en cualquiera de los objetos de la plantilla, se puede forzar una referencia a ellos, tal como se ha mostrado anteriormente. (A menos que el nombre de origen de datos se almacene en una variable, indique el nombre entre comillas.)

Temas relacionados