Descripción general

En este ejemplo, crearemos una integración donde usaremos un archivo de imagen como archivo desencadenante y también utilizaremos esa misma imagen dentro de la etiqueta al momento de imprimir. Siempre que la imagen que desees imprimir tenga el mismo nombre en el archivo desencadenante, podrás cambiar dinámicamente la imagen que quieras imprimir en la etiqueta durante la impresión.

Archivos de ejemplo

• ImageLabel.btw
• Picture.png
• ImageFileIntegration.btin

Implementación

Crea una carpeta llamada Test en tu unidad C:\. Usaremos esta carpeta para guardar tus archivos y también será la carpeta de escaneo para tu integración. Coloca todos los archivos de ejemplo en esta carpeta Test.

Crea el documento de BarTender

Puedes usar el archivo ImageLabel.btw de arriba o simplemente crear un documento de BarTender siguiendo las instrucciones a continuación:

1. Abre BarTender Designer
2. Crea un nuevo documento de BarTender
3. Selecciona la opción de selector de imagen que aparece arriba y, en Archivo de imagen externo, selecciona Especificar nombre de archivo...
4. Navega hasta la carpeta Test, haz clic en el archivo Picture.png y luego en Seleccionar
5. Guarda tu documento de BarTender y nómbralo ImageLabel.btw

Crea la integración

Puedes usar el archivo ImageFileIntegration.btin de arriba o simplemente crear una nueva integración siguiendo las instrucciones a continuación:

1. Abre Integration Builder
2. Selecciona Archivo entre las opciones de integración disponibles
   
3. En las opciones de Detección de archivo, cambia el patrón de archivo a *.png
4. En esta misma ventana, configura Acciones después de la detección en Ninguna. Más adelante explicaremos por qué.
5. Dirígete a la acción Imprimir documento. En Documento, selecciona ImageLabel.btw como la etiqueta que deseas imprimir.
6. Agrega una acción usando el botón azul junto al árbol de Acciones. Específicamente, selecciona la acción Eliminar archivo:
   
7. En la opción de archivo, navega y selecciona la imagen Picture.png como el archivo que se eliminará. Esta acción cumple dos funciones:
   • Permite que la imagen se use en la acción Imprimir documento, es decir, la etiqueta tiene una imagen de referencia al momento de imprimir, y
   • Evita que la integración se ejecute indefinidamente en un bucle infinito, lo cual ocurriría después de configurar Acciones después de la detección en Ninguna.
8. Guarda tu integración.

Prueba la integración

1. Haz clic en la opción Probar integración en el menú Inicio.
   
2. Haz clic en el botón Iniciar en la parte superior derecha de la ventana de pruebas. Tu integración debería comenzar ahora.
3. Observa los mensajes de salida. Verás cómo BarTender puede imprimir el documento y luego eliminar la imagen.
4. Puedes probar de nuevo agregando otra imagen Picture.png de tu elección (recuerda que puedes usar cualquier imagen siempre y cuando el nombre y la extensión sean Picture.png cuando la coloques en la carpeta Test de activación)
   

Despliega la integración

1. Desde la barra de herramientas de Integration Builder, haz clic en Desplegar integración para abrir el cuadro de diálogo Nuevo despliegue.
2. En el cuadro de diálogo Nuevo despliegue, ingresa un nombre y una descripción para tu despliegue.
3. Asegúrate de que la configuración Archivo de integración muestre IntegrationFile.btin (o el nombre con el que guardaste tu integración).
4. En Servidores de destino, agrega el/los servidor(es) donde deseas desplegar el archivo de integración.
5. Especifica la configuración de Manejo de errores que desees.
6. Haz 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 tu integración.