Aplicable a: BarTender 2019 y versiones posteriores.

Descripción general

El objetivo de este ejemplo es incluir un Script de Comando de Impresión en una integración de archivos.

Este tipo de integración puede ser necesaria para empresas que tienen diferentes aplicaciones y bases de datos con distintas necesidades de impresión distribuidas en su red. En estos casos, el documento de BarTender que se va a imprimir puede variar dependiendo de los datos incluidos en el archivo disparador.

Con poca programación, estas aplicaciones pueden modificarse o configurarse para escribir en un archivo de texto los datos que se usarán para la impresión, así como líneas de comando integradas. El Servicio de Integración puede entonces leer y ejecutar estas líneas de comando, indicando a BarTender cómo imprimir el elemento según las instrucciones específicas contenidas en el archivo.

Escenario

Una empresa necesita imprimir facturas que son ingresadas por diferentes usuarios en toda su red. Cada usuario tiene acceso a una unidad compartida. Sin embargo, las facturas tienen diferentes formatos dependiendo del usuario y del producto facturado. Cada departamento utiliza una impresora diferente.

En esta situación, una aplicación de facturación puede crear, junto con cada factura, un archivo de texto que contenga tanto los datos como un Script de Comando de Impresión, con el script indicando a BarTender que:

1. Abra el documento de BarTender especificado.
2. Utilice el archivo disparador como archivo de datos.
3. Imprima en una impresora específica.
4. Elimine el archivo disparador.

Implementación

Los siguientes procedimientos describen cómo configurar, desplegar y verificar la integración para el escenario descrito anteriormente.

Configurar los archivos de datos

1. Cree la carpeta de red donde se guardarán los archivos disparadores. Esta es la carpeta que el Servicio de Integración va a monitorear. En este ejemplo, se llamará \\InvoiceServer\NewInvoice.
2. Para cada tipo de factura, cree un archivo de ejemplo en el que los datos estén estructurados y delimitados exactamente como estarán en los archivos de datos reales. En este ejemplo, hay dos departamentos que imprimen facturas.

• Para el primero, cree un archivo de texto llamado invoice1.txt que contenga dos líneas de datos delimitados por comas (como se muestra a continuación).
  

  BusinessName,ContactName,Position,Address1,City,State,Zip,Country,Phone1,Phone2
  Around the Town,Jerome Davis,Buyer,1220 Governor Sq.,Haddonfield,GA,31002,USA,(706) 555-7788,(706) 555-6750

• Para el segundo, cree un archivo de texto llamado invoice2.txt que contenga dos líneas de datos delimitados por comillas y comas (como se muestra a continuación).
  

  "BusinessName","ContactName","Position","Address1","City","State","Zip","Country","Phone1","Phone2"
  "Far Fetched Imports","Jerry Bom","manager","3320 Happy St.","Incident","Washington","98887","USA","(206) 555-7788","(206) 555-6750"

• Guarde los archivos de texto en el directorio creado en el Paso 1, \\InvoiceServer\NewInvoice.

Crear los documentos de BarTender

1. Siguiendo los mismos pasos de la sección Crear el Documento de BarTender del artículo Imprimir documento usando un archivo de datos, cree un documento de BarTender para el primer departamento, usando invoice1.txt como base de datos.
2. Guarde el documento como HardwareInvoice.btw.
3. Repita los mismos pasos para crear un segundo documento de BarTender para el segundo departamento, usando invoice2.txt como base de datos, asegurándose de especificar el tipo de delimitación como "Comillas y Coma".
4. Guarde el documento como SoftwareInvoice.btw.
5. Mueva ambos archivos de base de datos de ejemplo fuera de la carpeta que el Servicio de Integración va a escanear y colóquelos en otra carpeta.
6. Cierre BarTender.

Agregar el Script de Comando de Impresión a los archivos disparadores

1. Abra invoice1.txt y agregue las siguientes dos líneas al principio del archivo. (Los únicos saltos de línea duros están justo antes y justo después de %END%.)
   

   %BTW% /AF=c:\command\HardwareInvoice.btw /D="%Trigger File Name%" /PRN="EasyCoder F4 (203 dpi)" /R=3 /P /DD 
   %END%

   
   Así que el archivo completo ahora contiene lo siguiente:
   

   %BTW% /AF=c:\command\HardwareInvoice.btw /D="%Trigger File Name%" /PRN="EasyCoder F4 (203 dpi)" /R=3 /P /DD 
   %END%
   BusinessName,ContactName,Position,Address1,City,State,Zip,Country,Phone1,Phone2
   Around the Town,Jerome Davis,Buyer,1220 Governor Sq.,Haddonfield,GA,31002,USA,(706) 555-7788,(706) 555-6750

2. Guarde el documento como invoice1.dat.
3. Abra invoice2.txt y agregue las siguientes dos líneas al principio del archivo. (Los únicos saltos de línea duros están justo antes y justo después de %END%.)
   

   %BTW% /AF=c:\command\SoftwareInvoice.btw /D="%Trigger File Name%" /PRN="Datamax 4400" /R=3 /P /DD 
   %END%

4. Así que el archivo completo ahora contiene lo siguiente:
   

   %BTW% /AF=c:\command\SoftwareInvoice.btw /D="%Trigger File Name%" /PRN="Datamax 4400" /R=3 /P /DD 
   %END%
   "BusinessName","ContactName","Position","Address1","City","State","Zip","Country","Phone1","Phone2"
   "Far Fetched Imports","Jerry Bom","manager","3320 Happy St.","Incident","Washington","98887","USA","(206) 555-7788","(206) 555-6750"

5. Guarde el documento como invoice2.dat.

Crear y desplegar el archivo de integración

Crear

1. Abra BarTender Integration Builder.
2. Haga clic en Crear nueva integración para abrir el cuadro de diálogo Nueva integración.
3. Haga clic en Archivo y luego en OK.
4. En el panel de Integración de Archivos, seleccione Integración.
5. En el panel de Propiedades, escriba el Nombre de su integración como Cada Pedido.
6. En el menú Iniciar integración, seleccione Automático.
7. En Cuenta de usuario, especifique las credenciales de usuario. Consulte Imprimir documento usando un archivo vacío para más detalles.
8. En el panel de Integración de Archivos, seleccione Detección de archivos.
9. En el panel de Propiedades, en Opciones de detección, seleccione Equipo/Red en la lista Ubicación.
10. Para la opción Carpeta a escanear, escriba la ruta o navegue hasta la carpeta que desea que el Servicio de Integración monitoree. En este caso, especifique la carpeta \\InvoiceServer\NewInvoice que creó en la sección Configurar los archivos de datos anterior.
11. En el campo Patrón de archivo, escriba *.dat. 
12. Desplácese hacia abajo hasta la sección Acciones después de la detección. En el menú Acción, seleccione Renombrar archivo.

13. En el campo Nueva extensión, escriba .txt. Esta extensión no puede ser la misma que la especificada en Patrón de archivo.

14. En el panel de Integración de Archivos, bajo Acciones, haga clic en  a la derecha de Imprimir documento para eliminar la acción predeterminada.
15. Seleccione Acciones y haga clic en  para abrir el cuadro de diálogo Nueva acción.
16. Seleccione Imprimir en la lista de tipos de acción en el panel de navegación izquierdo y luego seleccione Script de comando de impresión.
17. Haga clic en OK para cerrar el cuadro de diálogo Nueva acción.
18. Haga clic en  en la esquina superior izquierda de Integration Builder para guardar el archivo de integración como VariantInvoices.btin.

Desplegar

1. Haga clic en  Desplegar integración para abrir el cuadro de diálogo Nuevo despliegue.
2. Ingrese un nombre y una descripción para el despliegue.
3. Asegúrese de que la configuración Archivo de integración muestre VariantInvoices.btin. Si no es así, haga clic en Examinar y busque y seleccione VariantInvoices.btin.
4. En Servidores de destino, agregue el/los servidor(es) donde desea desplegar el archivo de integración.
5. Especifique la configuración de Manejo de errores deseada.
6. Haga clic en OK para cerrar el cuadro de diálogo y desplegar el archivo de integración.
7. La Consola de administración se abrirá en el nodo Integraciones, mostrando su integración.

Entendiendo y personalizando el Script de Comando de Impresión

%BTW% es el comando del Script de Comando de Impresión que indica al Servicio de Integración que inicie BarTender y utilice la cadena que sigue como línea de comando de BarTender.

%END% le indica al Servicio de Integración que la línea de comando ha terminado y lo que sigue son los datos.

Deberá editar el Script de Comando de Impresión para ambos archivos disparadores de la siguiente manera: 

• Reemplace la ruta y el nombre de la impresora después del comando /PRN por la ruta y el nombre de sus propias impresoras.
• Reemplace c:\command\ por la ruta donde guardó sus documentos de BarTender.

También tenga en cuenta lo siguiente:

• Si alguna de las rutas, nombres de archivos o nombres de impresoras usados en su Script de Comando de Impresión contiene espacios, debe encerrar toda la ruta entre comillas.
• La Consola de administración reconocerá %Trigger File Name% como una variable y la reemplazará automáticamente por el nombre del archivo disparador más reciente antes de pasar el parámetro a BarTender. No reemplace %Trigger File Name% por el nombre del archivo de base de datos.
• El comando /R=3 le indica a BarTender que trate la tercera línea del archivo disparador como el registro de datos.
• Cuando use el Script de Comando de Impresión para imprimir una etiqueta que tenga una unión interna entre dos bases de datos, donde una base de datos es un archivo de texto y la otra es una base de datos de cualquier tipo distinto a texto, y se realiza una sobrescritura de base de datos en la base de datos de texto usando el comando /D, el comando /R debe establecerse en /R=1 en lugar de /R=3.
• El comando /P le indica a BarTender que imprima el elemento.
• El comando /DD le indica a BarTender que elimine el archivo disparador después de leerlo.

Ejecutar el escenario y ver el procesamiento de la integración

1. En la Consola de administración, haga clic en el nombre de la integración Cada Pedido para abrir una vista detallada de la integración.
2. Mientras ejecuta el escenario de ejemplo en el siguiente paso, puede observar los pasos de procesamiento de la integración en la sección Salida de esta vista.
2. Usando el Explorador de Windows, copie el archivo de texto invoice1.dat en la carpeta \\InvoiceServer\NewInvoice.
3. La integración comienza casi de inmediato, detectando el archivo invoice1.dat y renombrando invoice1.dat a invoice1.txt.
4. BarTender se inicia en segundo plano (ni siquiera lo verá abrirse) y envía el archivo .txt a la línea de comando contenida en el archivo disparador, insertando invoice1.txt en la variable %Trigger File Name%
5. Luego, BarTender abre HardwareInvoice.btw, lee los datos de invoice1.txt, imprime el elemento y elimina invoice1.txt.
3. Usando el Explorador de Windows, copie el archivo de texto invoice2.dat en la carpeta \\InvoiceServer\NewInvoice.
4. La integración comienza casi de inmediato, detectando el archivo invoice2.dat y renombrando invoice2.dat a invoice2.txt.
5. BarTender se abre y envía el archivo .txt a la línea de comando contenida en el archivo disparador, insertando invoice2.txt en la variable %Trigger File Name%
6. Luego, BarTender abre SoftwareInvoice.btw, lee los datos de invoice2.txt, imprime el elemento y elimina invoice2.txt.