Forzar referencias

Cuando BarTender determina el mejor momento para que se ejecuten los archivos de comandos durante una tarea de impresión y qué base de datos necesita usar, la aplicación examina la estructura de las plantillas 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 campos de bases de datos y los orígenes de datos compartidos.

Las instrucciones condicionales ejecutan diferentes "ramas" de código, en función de cómo se evalúe una expresión condicional. En consecuencia, dependiendo de las condiciones en el momento de la evaluación, algunos códigos podrían no ejecutarse. Esto puede suponer un problema si una referencia a un campo o nombre resulta estar contenido en el 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, y si no se referenció en la anterior ejecución de prueba, el archivo de comandos podría no ejecutarse en el momento más apropiado e incluso podría fallar.

En estos casos, puede utilizar funciones de forzado para asegurarse de que el archivo de comandos haga referencia al campo de la base de datos o al nombre del origen de datos que desea.

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. Estas funciones no cambian ni asignan ningún valor; únicamente fuerzan a la aplicación a notificar la presencia de un elemento que podría perderse durante la ejecución de prueba de un comando. Cuando utilice estas funciones, BarTender establece enlaces a todos los campos de datos necesarios y sus archivos de comando se ejecutan en respuesta a los eventos adecuados en el momento de imprimir.

Un objeto VBScript que tenga el número de campo "<Empty>" podría mostrar 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?" Haga clic en para que en la vista previa de la plantilla se muestre el campo en blanco especificado. Haga clic en 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 la carpeta Funciones.

  2. En la carpeta Funciones, expanda la carpeta Declaraciones. ReferenceField y ReferenceSharedSubstring se encuentran en esta carpeta.

Recomendamos que inserte las funciones de referencia al principio de su archivo de comandos antes de cualquier instrucción condicional.

La función ReferenceField solo está disponible si su plantilla está conectada a una base de datos.

La función ReferenceSharedSubString está disponible solo si cuenta con un origen de datos con nombre vinculado a un objeto de su plantilla.

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 archivos de comandos, expanda Funciones, expanda Declaraciones y, después, ReferenceField.

  2. Haga doble clic en el nombre del campo de base de datos que quiera forzar. En el panel Archivo de comandos se muestra un fragmento del código que se parece al siguiente:

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

Si el documento está configurado para que lea datos de un archivo de texto normal, especifica un número de campo. Cuando el documento lee desde una base de datos, especifique un nombre de campo. A menos que el nombre de campo esté contenido en una variable, debe asegurarse de que esté entrecomillado, como en ReferenceField("precio").

CerradoPara forzar una referencia a un origen de datos con nombre

  1. En el panel Ayudante para archivos de comandos, expanda Funciones, expanda Declaraciones y, después, ReferenceSharedSubString.

  2. Haga doble clic en el origen de datos con nombre que desee forzar. En el panel Archivo de comandos se muestra un fragmento del código que se parece al siguiente:

    ReferenceSharedSubString("Compartirnombre")

Si cualquier origen de datos de la plantilla tiene nombre, puede forzar una referencia a ellos, tal como se ha mostrado anteriormente. A menos que el origen de datos esté contenido en una variable, debe asegurarse de que esté entrecomillado, como en ReferenceSharedSubString("precio").

Temas relacionados