Descripción general

El objetivo de este ejemplo es crear una integración que imprima un documento de BarTender específico después de detectar un archivo disparador vacío. Las técnicas utilizadas aquí también se aplican a los ejemplos posteriores.

Escenario

Una planta de fabricación de piezas necesita imprimir un artículo con un número serializado al final de una línea de ensamblaje. En este artículo, no hay otra información dinámica o cambiante, aparte del código de barras que se incrementa. Lo que genera el archivo disparador es un “Sensor de Presencia Láser” hacia el final de la línea de ensamblaje, que detecta las piezas y genera un archivo de texto vacío. Este archivo de texto se coloca en un directorio específico que el Servicio de Integración está monitoreando. Cuando se detecta el archivo, el Servicio de Integración elimina el archivo vacío e imprime el documento especificado.

Implementación

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

Configurar el archivo disparador vacío

1. Crea la carpeta de red donde se guardará el archivo vacío. Esta es la carpeta que el Servicio de Integración va a monitorear. En este ejemplo, se llamará \\AssemblyLine\NextPart.
2. En algún otro directorio, crea un archivo de texto en blanco llamado "part.txt".

Crear el documento de BarTender

1. Abre BarTender.
2. En el menú Archivo, selecciona Nuevo para abrir el Asistente de Nuevo Documento.
3. Selecciona Plantilla en blanco y luego haz clic en Finalizar para cerrar el asistente. Aparecerá un nuevo documento en BarTender.
4. En el menú Archivo, selecciona Imprimir para abrir el cuadro de diálogo Imprimir.
5. En la lista desplegable Nombre, selecciona la impresora que deseas usar y luego haz clic en Cerrar para salir del cuadro de diálogo Imprimir.
6. En el menú Archivo, selecciona Configurar página para abrir el cuadro de diálogo Configurar página y configura la página según tus necesidades.
7. Cuando termines de configurar la página, haz clic en Aceptar para cerrar el cuadro de diálogo Configurar página.
8. En el menú Crear, selecciona Código de barras.
9. En el cuadro de diálogo Seleccionar código de barras, elige un tipo de código de barras y haz clic sobre él. Haz clic en el botón Seleccionar para cerrar el cuadro de diálogo.
10. Haz clic en cualquier parte de la plantilla para agregar el objeto de código de barras.
11. Haz doble clic en el código de barras para abrir el cuadro de diálogo Propiedades del código de barras.
12. En el panel de navegación izquierdo, haz clic en la fuente de datos del código de barras.
13. Haz clic en la pestaña Transformaciones.
14. A la derecha del campo Serialización, haz clic en el ícono  para abrir el cuadro de diálogo Serialización.
15. En la pestaña Serialización, selecciona Incrementar.
16. Haz clic en Aceptar para cerrar el cuadro de diálogo Serialización.
17. Haz clic en Cerrar para salir del cuadro de diálogo Propiedades del código de barras.
18. En el menú Archivo, selecciona Guardar como y guarda el documento de BarTender con el nombre Serialized.btw.
19. Cierra BarTender.

Crear e implementar la integración

1. Abre BarTender Integration Builder.
2. Haz clic en Crear nueva integración para abrir el cuadro de diálogo Nueva integración.
3. Haz clic en Archivo y luego en Aceptar.
4. En el panel Integración de archivos, selecciona Integración.
5. En el panel Propiedades, ingresa el Nombre de tu integración como "Cada pieza".
6. En la lista desplegable Iniciar integración, selecciona Automático.
7. En Cuenta de usuario, selecciona si deseas heredar los permisos del servicio.
8. Ten en cuenta que, por defecto, las acciones heredarán la cuenta de usuario especificada en el nodo Integración, así que no será necesario configurarla de nuevo en el nodo Acciones.
8. En el panel Integración de archivos, selecciona Detección de archivos.
9. En el panel Propiedades, en Opciones de detección, selecciona "Equipo/Red" en la lista desplegable Ubicación.
10. En la opción Carpeta a escanear, escribe la ruta o navega hasta la carpeta que deseas que el Servicio de Integración monitoree. En este caso, especifica la carpeta \\AssemblyLine\NextPart que creaste en la sección Configurar el archivo disparador vacío de arriba.
11. En el campo Patrón de archivo, escribe "*.txt". (No incluyas las comillas.)
12. Desplázate hasta la sección Acciones después de la detección. En la lista desplegable Acción, selecciona Eliminar archivo. El archivo ya no es necesario después de ser detectado.
13. En el panel Integración de archivos, haz clic en la acción Imprimir documento. (Esta es la acción predeterminada.)
14. En el panel Propiedades bajo Documento, haz clic en el botón Examinar para buscar y seleccionar el documento de BarTender que creaste antes, Serialized.btw. Haz clic en Abrir.
15. Haz clic en  en la esquina superior izquierda de Integration Builder para guardar el archivo de integración como NewPart.btin.
16. Haz clic en  Implementar integración para abrir el cuadro de diálogo Nueva implementación.
17. Ingresa un nombre y una descripción para la implementación.
18. Asegúrate de que la configuración Archivo de integración muestre NewPart.btin. Si no es así, haz clic en Examinar y selecciona NewPart.btin.
19. En Servidores de destino, agrega el o los servidores donde deseas implementar el archivo de integración.
20. En Programación, selecciona Inmediatamente.
21. Especifica la configuración de Manejo de errores que desees.
22. Haz clic en Aceptar para cerrar el cuadro de diálogo e implementar el archivo de integración.
23. La Consola de administración se abrirá en el nodo Integraciones, mostrando tu integración.

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

1. En la Consola de administración, haz clic en el nombre de la integración "Cada pieza" para ver los detalles de la integración.
2. Mientras ejecutas el escenario de ejemplo en el siguiente paso, puedes observar los pasos de procesamiento de la integración en la sección Salida de esta vista.
2. Usando el Explorador de Windows, copia el archivo de texto en blanco part.txt a la carpeta \\AssemblyLine\NextPart.
3. La integración comienza casi de inmediato, eliminando el archivo de texto vacío de la carpeta NextPart y enviando el documento de BarTender a imprimir. Cada vez que ejecutes el escenario, el código de barras del documento impreso se incrementará en 1.