Descripción general

El objetivo de este ejemplo es crear una integración de socket de red que incluya un Script BTXML en una acción. El Script BarTender XML (Script BTXML) permite automatizar BarTender fácilmente y ofrece a los programadores de terceros una forma sencilla de integrar BarTender en sus aplicaciones.

Después de ejecutar un script BTXML, se genera una respuesta XML. Esta respuesta XML te proporciona información valiosa sobre el trabajo de impresión, como la impresora utilizada, la configuración de BarTender durante el trabajo y detalles completos sobre las etiquetas impresas.

Escenario

Una empresa necesita enviar un trabajo de impresión que contenga 100 artículos serializados a la Bandeja 1 de su impresora HP LaserJet. El trabajo de impresión se ejecutará cuando se envíen datos (en este caso, un Script BTXML) a través de un socket de red y sean leídos por el Servicio de Integración de BarTender.

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. Asegúrate de cambiar el nombre de la impresora en el Script BTXML por la impresora que selecciones aquí.
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 lo necesites.
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 los objetos de plantilla y configura tu documento de BarTender como desees.
10. En el menú Archivo, selecciona Guardar como y guarda el documento de BarTender con el nombre Scriptdoc.btw.
11. Cierra BarTender.

Crear el documento disparador del Script BTXML

<?xml version="1.0" encoding="utf-8"?>		
<XMLScript Version="2.0">
	<Command Name="Job1">
		<Print>
			<Format>c:\BarTender\Scriptdoc.btw</Format>
			<PrintSetup>
			        <NumberSerializedLabels>100</NumberSerializedLabels>
				<Printer>HP LaserJet</Printer>
				<PaperTray>Tray 1</PaperTray>
			</PrintSetup>
		</Print>
	</Command>
</XMLScript>

<?xml version="1.0" encoding="utf-8"?> 

Pega el script BTXML en un archivo de texto y guárdalo con el nombre BTXMLScript.txt.

Crear el archivo de integración: Seleccionar una integración de socket de red

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 Socket de red y luego en Aceptar.
4. En el panel Integración de socket de red, selecciona Integración.
5. En el panel Propiedades, ingresa el Nombre de tu integración como "Imprimir 100".
6. En la lista desplegable Iniciar integración, selecciona Automático.
7. En Cuenta de usuario, especifica las credenciales de usuario. Consulta Imprimir documento usando un archivo vacío para más detalles.
8. En el panel Integración de socket de red, selecciona Socket.
9. En el panel Propiedades, configura la información de Protocolo y Puerto.
10. En Dirección de red, selecciona Escuchar en todas las interfaces de red. Alternativamente, selecciona Escuchar en una dirección IP específica y elige una dirección IP de la lista desplegable, o ingresa una dirección IP manualmente.
11. Configura tus Ajustes de comunicación y Protocolo de conexión si lo deseas.
12. En el panel Integración de socket de red, selecciona Datos de entrada.
13. En el panel Propiedades, selecciona Unicode (UTF-8) para la propiedad Codificación.
14. Para Dejar de leer cuando, selecciona Secuencia de caracteres recibida.
15. En el campo Caracteres, ingresa </XMLScript>.
16. Activa Incluir secuencia en el contenido de los datos de entrada.
17. Para Formato de datos de entrada, selecciona Script BTXML.
18. En el panel Integración de socket de red, selecciona Respuesta.
19. En el panel Propiedades, selecciona tus opciones de respuesta.

Crear el archivo de integración: Agregar una acción a la integración de socket de red

1. En el panel Integración de socket de red, selecciona Acciones.
2. En el panel Propiedades, para Ejecutar acciones, selecciona Secuencialmente.
3. Para Repetir acciones, especifica "1".
4. En el panel Integración de socket de red bajo Acción, haz clic en  a la derecha de Imprimir documento para eliminar la acción predeterminada.
5. Selecciona Acción y haz clic en  Agregar para abrir el cuadro de diálogo Nueva acción.
6. Selecciona Imprimir de la lista de tipos de acción en el panel de navegación izquierdo y luego selecciona Imprimir Script BTXML
7. Haz clic en Aceptar para cerrar el cuadro de diálogo Nueva acción.
8. La acción Imprimir Script BTXML aparecerá en el panel Integración de socket de red bajo Acciones.
9. Si no está ya seleccionada, haz clic en Imprimir Script BTXML en el panel Integración de socket de red.
10. En el panel Propiedades bajo Acción, ingresa un nombre y una descripción para la acción Imprimir Script BTXML.
11. En Script, selecciona Variable en la lista desplegable Origen del script.
12. Si no está ya seleccionado, elige EventData en la lista desplegable Variables.
13. Haz clic en  en la esquina superior izquierda de Integration Builder para guardar el archivo de integración como BTXML_Integration.btin.

Probar la acción Imprimir Script BTXML (no toda la integración)

Para probar una acción "Imprimir Script BTXML", debes cambiar algunos ajustes para la prueba y luego restaurarlos a su estado original.

1. En el panel Integración de socket de red bajo Acciones, selecciona Imprimir Script BTXML.
2. En el panel Propiedades bajo Script, selecciona Script incrustado en la lista desplegable Origen del script.
3. Haz clic en el botón Importar para importar tu archivo BTXML, o simplemente pega el contenido del archivo en la ventana proporcionada.
4. Haz clic en el botón Probar a la derecha de la ventana del script.
5. Si tu acción "Imprimir Script BTXML" pasa la prueba, en el panel Integración de socket de red bajo Acciones, selecciona Imprimir Script BTXML una vez más.
6. En el panel Propiedades, vuelve a establecer el tipo de Script en Variable y el tipo de Variable en %EventData%.

Probar e implementar el archivo de integración

1. Haz clic en  Probar integración en la barra de herramientas de Integration Builder.
2. Si tu integración pasa la prueba, haz clic en  Implementar integración para abrir el cuadro de diálogo Nueva implementación.
3. Ingresa un nombre y una descripción para la implementación.
4. Asegúrate de que la configuración de Archivo de integración muestre BTXML_Integration.btin. Si no es así, haz clic en Examinar y busca y selecciona BTXML_Integration.btin.
5. Para Servidores de destino, agrega el/los servidor(es) donde deseas implementar el archivo de integración.
6. Especifica los ajustes de Manejo de errores que desees.
7. Haz clic en Aceptar para cerrar el cuadro de diálogo e implementar el archivo de integración.
8. 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. El Servicio de Integración de BarTender está monitoreando el socket de red seleccionado. Envía el contenido de BTXMLScript.txt a través del socket de red usando tu método preferido.
2. El Servicio de Integración pasa el Script BTXML a BarTender.
3. BarTender realiza las acciones especificadas en el Script BTXML, imprimiendo 100 copias del documento Scriptdoc.btw usando la bandeja 1 de la impresora indicada.