Descripción general

En este ejemplo, se diseña una integración que imprime un documento de BarTender específico después de detectar un archivo desencadenante, donde el propio archivo contiene los datos que se usarán para rellenar los objetos de la plantilla del documento. Las técnicas utilizadas también se aplican a los ejemplos posteriores.

Escenario

Una empresa de ventas por correo necesita imprimir un artículo que contenga datos de un registro de ventas cada vez que se empaqueta un pedido. La aplicación de ventas genera un archivo de texto separado por comas y lo guarda en un directorio que el Servicio de Integración está monitoreando. Cuando se detecta el archivo, el Servicio de Integración elimina el archivo desencadenante, envía el contenido del archivo a BarTender para rellenar los objetos de la plantilla del documento e imprime el documento.

Implementación

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

Configurar el archivo de datos

1. Cree la carpeta de red donde se guardarán los archivos de datos. Esta es la carpeta que el Servicio de Integración va a monitorear. En este ejemplo, se llamará \\ShippingServer\NewOrders.
2. Cree un archivo de texto que contenga los datos separados por comas (como se muestra a continuación). Puede copiar y pegar los datos en el archivo de texto.

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

2. Guarde el archivo de texto en el directorio creado en el Paso 1, \\ShippingServer\NewOrders, con el nombre "order.txt".

Crear el documento de BarTender

1. Abra BarTender.
2. En el menú Archivo, seleccione Nuevo para abrir el Asistente de nuevo documento.
3. Seleccione Plantilla en blanco y luego haga clic en Finalizar para cerrar el Asistente de nuevo documento.
4. En el menú Archivo, seleccione Imprimir para abrir el cuadro de diálogo Imprimir.
5. En la lista desplegable Nombre, seleccione la impresora que desea usar y luego haga clic en Cerrar para cerrar el cuadro de diálogo Imprimir.
6. En el menú Archivo, seleccione Configurar página para abrir el cuadro de diálogo Configurar página y configure la página según sea necesario.
7. Cuando termine de configurar la página, haga clic en Aceptar para cerrar el cuadro de diálogo Configurar página.
8. En el menú Archivo, seleccione Configuración de conexión de base de datos para abrir el Asistente de configuración de base de datos.
9. Haga clic en Archivo de texto para especificar el tipo de base de datos deseado y haga clic en Siguiente.
10. En la página Seleccionar archivo del asistente, haga clic en el botón Seleccionar archivo.
11. Busque \\ShippingServer\NewOrders y haga doble clic en order.txt para seleccionarlo.
12. Haga clic en Siguiente en la página Seleccionar archivo del asistente.
13. En la página Formato de archivo del asistente, asegúrese de que Coma esté seleccionado en la lista desplegable Separación de campos y haga clic en Siguiente.
14. En la página Nombres de campos del asistente, asegúrese de que esté seleccionada la opción Asignar automáticamente nombres de campo secuenciales y haga clic en Finalizar.
15. Haga clic en Aceptar para cerrar el cuadro de diálogo Configuración de base de datos.
16. En el menú Crear, seleccione Texto.
17. En la lista desplegable Objetos de texto, seleccione Línea única.
18. Haga clic en cualquier parte de la plantilla para agregar el objeto de texto.
19. Haga clic derecho sobre el objeto de texto y seleccione Propiedades en el menú contextual para abrir el cuadro de diálogo Propiedades de texto.
20. En el panel de navegación izquierdo, haga clic en la fuente de datos del objeto de texto.
21. En la pestaña Fuente de datos, haga clic en a la derecha del campo Tipo para abrir el Asistente para cambiar el tipo de fuente de datos.
22. En la lista desplegable, seleccione Campo de base de datos y luego haga clic en Siguiente.
23. En la lista desplegable Nombre de campo, seleccione Campo 2 (En el archivo de texto, el segundo campo contiene el nombre del comprador).
24. En el campo Datos de ejemplo del campo, escriba "nombre del comprador" como dato de ejemplo.
25. Haga clic en Finalizar para cerrar el asistente.
26. Haga clic en Cerrar para cerrar el cuadro de diálogo Propiedades de texto.
27. Si desea incluir campos adicionales de la base de datos en su plantilla, simplemente regrese al paso 16, asignando en cada caso un objeto de texto al campo correspondiente de la base de datos. De lo contrario, continúe con el paso 28.
28. En el menú Archivo, seleccione Guardar para guardar el documento de BarTender con el nombre NewOrderAddress.btw.
29. Mueva el archivo de base de datos de ejemplo, order.txt, fuera de la carpeta que el Servicio de Integración va a escanear y colóquelo en otra carpeta.
30. Cierre BarTender.

Crear e implementar el archivo de integración

1. Abra 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 Aceptar.
4. En el panel Integración de archivos, seleccione Integración.
5. En el panel Propiedades, escriba el Nombre de su integración como "Cada pedido".
6. En la lista desplegable 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 Integración de archivos, seleccione Detección de archivos.
9. En el panel Propiedades, en Opciones de detección, seleccione "Equipo/Red" en la lista desplegable Ubicación.
10. Para la opción Carpeta a escanear, escriba la ruta o busque la carpeta que desea que el Servicio de Integración monitoree. En este caso, especifique la carpeta \\ShippingServer\NewOrders que creó en la sección Configurar el archivo de datos anterior.
11. En el campo Patrón de archivo, escriba "*.txt". (No incluya las comillas.)
12. Desplácese hacia abajo hasta la sección Acciones después de la detección. En la lista desplegable Acción, seleccione Eliminar archivo. Cuando el Servicio de Integración detecta el archivo, automáticamente lee cualquier dato en el archivo y lo coloca en una variable; posteriormente, una vez detectado, ya no es necesario.
13. En el panel Integración de archivos, haga clic en Imprimir documento. (Esta es la acción predeterminada.)
14. En el panel Propiedades bajo Documento, haga clic en el botón Examinar para buscar y seleccionar el documento de BarTender que creó anteriormente, NewOrderAddress.btw. Haga clic en Abrir.
15. Desplácese hacia abajo hasta Sobrescrituras de base de datos. En la lista desplegable Fuente de datos, seleccione Datos de entrada de integración.
16. Haga clic en en la esquina superior izquierda de Integration Builder para guardar el archivo de integración como NewOrderAddress.btin.
17. Haga clic en Implementar integración para abrir el cuadro de diálogo Nueva implementación.
18. Ingrese un nombre y una descripción para la implementación.
19. Asegúrese de que la configuración de Archivo de integración muestre NewOrderAddress.btin. De lo contrario, haga clic en Examinar y busque y seleccione NewOrderAddress.btin.
20. En Servidores de destino, agregue el/los servidor(es) donde desea implementar el archivo de integración.
21. En Programación, seleccione Inmediatamente.
22. Especifique la configuración de Manejo de errores deseada.
23. Haga clic en Aceptar para cerrar el cuadro de diálogo e implementar el archivo de integración.
24. La Consola de administración se abrirá en el nodo Integraciones, mostrando su integración.

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 ver los detalles 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.
3. Usando el Explorador de Windows, copie el archivo de texto order.txt en la carpeta \\ShippingServer\NewOrders.
4. La integración comienza casi de inmediato, eliminando el archivo de texto de la carpeta NewOrders y enviando el documento de BarTender a imprimir.