Descripción general

El objetivo de este ejemplo es utilizar una integración de servicio web para imprimir un documento de BarTender. Un servicio web es un sistema de software diseñado para permitir la interacción entre máquinas a través de una red. Cualquier aplicación que pueda enviar una solicitud a un servicio web puede activar la integración.

Este ejemplo permite que un servicio web envíe una solicitud GET al Servicio de Integración de BarTender mediante una integración de servicio web. El servicio web enviará valores que la integración usará como fuentes de datos nombradas en el documento de BarTender.

Escenario

Una empresa con un sistema ERP externo necesita completar un campo de texto y un valor de código de barras en un documento de BarTender usando una solicitud web. Para lograr esto, los datos de la solicitud web se enviarán a una integración, que a su vez los pasará a las fuentes de datos nombradas del documento de BarTender especificado. Estas fuentes de datos nombradas luego completan el objeto de texto y el objeto de código de barras en el documento al momento de imprimir.

Implementación

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

Crear el documento de BarTender

1. Abre BarTender.
2. En el menú Archivo, selecciona Nuevo para abrir el Asistente para nuevo documento.
3. Selecciona Plantilla en blanco y luego haz clic en Finalizar para cerrar el Asistente para nuevo documento. 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.
6. Haz clic en Cerrar para cerrar el cuadro de diálogo Imprimir.
7. 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 sea necesario.
8. Cuando termines de configurar la página, haz clic en Aceptar para cerrar el cuadro de diálogo Configurar página.
9. En el menú Crear, selecciona Texto y luego Línea única.
10. Haz clic en la plantilla para colocar el objeto de texto.
11. En el menú Crear, selecciona Código de barras y luego Code 128.
12. Haz clic en la plantilla para colocar el objeto de código de barras.
13. Haz doble clic en el borde alrededor del objeto de texto para abrir el cuadro de diálogo Propiedades de texto.
14. En la pestaña Fuente de datos, a la derecha del campo Nombre, haz clic en para abrir el Asistente para cambiar el nombre de la fuente de datos.
15. En el campo Nombre, escribe "Company" (sin las comillas).
16. Haz clic en Aceptar para cerrar el Asistente para cambiar el nombre de la fuente de datos.
17. Deja el Tipo como Datos incrustados.
18. En el campo Datos incrustados, escribe el nombre de tu empresa.
19. Haz clic en Cerrar para cerrar el cuadro de diálogo Propiedades de texto.
20. Haz doble clic en el objeto de código de barras para abrir el cuadro de diálogo Propiedades del código de barras.
21. En la pestaña Fuente de datos, a la derecha del campo Nombre, haz clic en para abrir el Asistente para cambiar el nombre de la fuente de datos.
22. Selecciona Nombrar la fuente de datos.
23. En el campo Nombre, escribe "IDNumber" (sin las comillas).
24. Haz clic en Aceptar para cerrar el Asistente para cambiar el nombre de la fuente de datos.
25. Deja el Tipo como Datos incrustados.
26. En el campo Datos incrustados, escribe cualquier número de 4 dígitos.
27. Haz clic en Cerrar para cerrar el cuadro de diálogo Propiedades del código de barras.
28. Guarda el archivo como GETSampleDocument.btw.
29. Cierra BarTender.

Crear el archivo de integración

1. Abre Integration Builder.
2. Haz clic en Crear nueva integración para abrir el cuadro de diálogo Nueva integración.
3. Haz clic en Servicio web y luego en Aceptar.
4. En el panel Integración de servicio web, asegúrate de que Servicio esté seleccionado.
5. En el panel Integración de servicio web, selecciona Integración.
6. En el panel Propiedades, ponle un nombre a tu integración y agrega una descripción si lo deseas.
7. En la lista desplegable Iniciar integración, selecciona Automático.
8. En el panel Integración de servicio web, selecciona Respuesta.
9. En el panel Propiedades bajo Respuesta, selecciona application/json en la lista desplegable Tipo de contenido.
10. En la lista desplegable Fuente, selecciona Resumen de acciones, para recibir un resumen después de que se ejecute la integración.
8. En el panel Integración de servicio web, selecciona Variables.
8. Desplázate hasta la parte inferior del panel Propiedades y haz clic en . En el campo Nombre, escribe "Company" (sin las comillas).
8. Haz clic en para crear otra variable nueva. En el campo Nombre, escribe "IDNumber" (sin las comillas).
11. En el panel Integración de servicio web bajo Acciones, selecciona Imprimir documento.
12. En el panel Propiedades bajo Documento, ingresa la ruta y el nombre del archivo del documento de BarTender que creaste previamente, GETSampleDocument.btw.
12. Haz clic en para agregar las Fuentes de datos nombradas y Opciones de impresión personalizadas a la integración.
13. Desplázate hasta Fuentes de datos nombradas. Si aún no está habilitado, marca Especificar valores para fuentes de datos nombradas.
14. En la lista Fuentes de datos nombradas, elimina el valor actual de la fuente de datos nombrada Company.
15. A la derecha de la columna Valor, haz clic en y selecciona Variables.
16. En el cuadro de diálogo Insertar variable, selecciona Company y haz clic en Aceptar. Esto establecerá el valor de la fuente de datos nombrada Company como %Company%.
17. En la lista Fuentes de datos nombradas, elimina el valor actual de la fuente de datos nombrada IDNumber.
18. A la derecha de la columna Valor, haz clic en y selecciona Más variables.
19. En el cuadro de diálogo Insertar variable, selecciona IDNumber y haz clic en Aceptar. Esto establecerá el valor de la fuente de datos nombrada IDNumber como %IDNumber%.
20. Haz clic en en la esquina superior izquierda de Integration Builder para guardar el archivo de integración como WebRequestPrint.btin.

La integración ya está lista para ser implementada.

Implementar la integración

1. En la barra de herramientas de Integration Builder, haz clic en Implementar integración para abrir el cuadro de diálogo Nueva implementación.
2. En el cuadro de diálogo Nueva implementación, ingresa un nombre y una descripción para tu implementación.
3. Asegúrate de que la configuración de Archivo de integración muestre WebRequestPrint.btin. Si no es así, haz clic en Examinar y busca y selecciona WebRequestPrint.btin.
4. En Servidores de destino, agrega el o los servidores donde deseas implementar el archivo de integración.
5. Especifica la configuración de Manejo de errores que desees.
6. Haz clic en Aceptar para cerrar el cuadro de diálogo e implementar el archivo de integración.
7. Se abrirá la Consola de administración en el nodo Integraciones, mostrando tu integración.

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

1. El Servicio de Integración de BarTender está monitoreando el servicio web seleccionado. Envía la solicitud web a través de la url usando tu método preferido. La url será similar a: http://<host>/Integration/WebRequestPrint/Execute.

2. El Servicio de Integración lee la solicitud web y pasa los valores a BarTender.
3. Las fuentes de datos nombradas del documento de BarTender ahora se completan con los valores de la solicitud web.
4. El documento de BarTender se imprime.