The World's Leading Software for Label, Barcode, RFID & Card Printing White Paper Resumen de integración Importar datos a BarTender y controlar BarTender desde otros programas Contenido Introducción ................................................................................. 4 Seleccionar los datos de etiqueta deseados ............................. 4 Consulta BarTender de datos externos ................................................ 4 Compatible con cualquier relación de bases de datos ....................... 5 Métodos de consulta .......................................................................... 5 Consulta Externa con exportación de datos ........................................ 6 Conexión directa con una consulta externa........................................ 6 Consultas dentro y fuera de BarTender................................................ 6 Métodos de importación de datos .............................................. 6 Métodos de importación nativos de BarTender ................................... 7 OLE DB y ODBC ................................................................................ 7 Importar gráficos incrustados y vinculados......................................... 7 Métodos de importación controlados de forma externa ..................... 8 Transferir datos mediante programación usando paquetes .NET SDK o automatización con ActiveX .................................................... 8 Usar Commander para transferir datos de sistemas ERP como Oracle, SAP e IBM WebSphere ......................................................... 8 Controlar BarTender .................................................................... 9 Paquetes .NET SDK y automatización con ActiveX (COM) ................. 9 Funciones de integración admitidas ................................................... 9 Controlar BarTender usando XML .................................................... 10 Obtener el estado del trabajo de impresión ...................................... 10 Entornos de programación necesarios ............................................. 10 Para obtener más información ......................................................... 11 Control de la interfaz de línea de comandos ...................................... 11 Para obtener más información ......................................................... 12 Usar Commander™ para controlar BarTender .................................... 12 Cómo funciona Commander............................................................. 12 Cuándo usar Commander ................................................................ 13 Integraciones ya creadas, listas para ser usadas............................. 13 Resumen de los desencadenadores de eventos de Commander .... 14 Incluir comandos en datos desencadenadores ................................ 14 Convertir de XML a BTXML usando transformaciones XSL ............. 15 Obtener el estado del trabajo de impresión ...................................... 15 Entornos de grandes volúmenes de impresión ................................ 15 Para obtener más información ......................................................... 15 Alertas y registros...................................................................... 16 Las alertas reducen el tiempo de inactividad ..................................... 16 Alertas de BarTender ....................................................................... 16 Alertas de Commander..................................................................... 16 Alertas de Printer Maestro ................................................................ 16 Página 2 Los trabajos de impresión y el registro de eventos ayudan a verificar los trabajos de impresión...................................................... 17 La importancia de guardar un registro al automatizar BarTender .... 17 La base de datos del sistema BarTender ......................................... 17 Los tres tipos de información que se registra ................................... 17 Sencilla visualización de registros .................................................... 18 Recuperar datos de la base de datos del sistema mediante programación ................................................................................... 19 Guardando el registro en un archivo de texto................................... 19 Para obtener más información ......................................................... 19 Utilizar plantillas de código de impresora ............................... 19 Entender las plantillas de código de impresora ................................ 20 Imprimir con plantillas de código de impresora ................................ 20 Problemas técnicos de las plantillas de código de impresora ......... 22 Para obtener más información ......................................................... 25 Conclusión.................................................................................. 25 Página 3 Documentación: Resumen de integración Introducción La impresión de etiquetas suele ser parte de un proceso de software más grande que solo BarTender. Por ejemplo, las aplicaciones de fabricación, inventario, envíos, contabilidad y otras funciones de gestión de cadenas de suministros suelen depender de etiquetas para poder realizar las funciones de identificación y seguimiento básicas. Por eso muchas de las funciones más potentes de BarTender están dedicadas a la integración con otros programas. Los métodos de integración disponibles varían, desde la simplicidad de BarTender leyendo datos de una base de datos externa, hasta el control mediante programación de BarTender desde otros programas, usando nuestros paquetes .NET SDK. También es posible iniciar trabajos de impresión usando una gran variedad de métodos, incluyendo la creación de un sencillo archivo de datos, enviar un correo electrónico o transmitir un mensaje mediante TCP/IP. Seleccionar los datos de etiqueta deseados Al integrar BarTender con otros programas, casi siempre seleccionará datos de una base de datos externa y los importará de alguna forma a BarTender para imprimir en etiquetas. Hacer que BarTender lea cada registro del sistema de base de datos solo es útil si se quiere imprimir una etiqueta por cada elemento de la base de datos. En su lugar, normalmente solo querremos importar a BarTender uno o varios registros de la base de datos. Los dos principales problemas son: • • Cómo escoger qué registros de la base de datos imprimir. Cómo llevar esos datos de etiqueta a BarTender. Este capítulo presupone que BarTender obtendrá los datos de etiqueta de una ubicación a la que se puede acceder mediante LAN o WAN. Sin embargo, en algunos casos podría ocurrir que no se pueda acceder directamente a la base de datos desde el equipo Windows que ejecuta BarTender. En ese caso, tendrá que exportar sus datos a un formato intermedio para usarlo posteriormente con BarTender. Este caso se explicará posteriormente en el capítulo Usar Commander™ para controlar BarTender. Las siguientes secciones comparan los dos métodos generales para seleccionar qué registros de datos imprimir: • • Consulta BarTender de datos externos Consulta externa (con y sin exportación de datos) Consulta BarTender de datos externos BarTender puede conectarse directamente a una gran variedad de bases de datos externas y hojas de cálculo. BarTender incluso admite “uniones” de varias tablas a partir de varias bases de datos ejecutándose en plataformas con diferentes sistemas operativos. Página 4 Documentación: Resumen de integración Compatible con cualquier relación de bases de datos BarTender permite acceder simultáneamente a varias tablas y formatos de datos situados en diferentes ordenadores. Por ejemplo: • • • • • Tablas de base de datos de Oracle en un servidor LINUX. Tablas SQL en un servidor Windows. Access, Excel y otras tablas de Windows en un equipo local. Un sencillo archivo de texto en el PC, en Envío. Y muchos más. Métodos de consulta Entre los métodos de consulta de BarTender disponibles para seleccionar los registros, se incluyen: • • • • • Búsqueda sencilla – Búsqueda de un valor de campo (como fecha, número de parte, clase de producto, etc.). Compleja “consulta por ejemplo” – Nuestro asistente y administrador de configuración de base de datos facilita la Búsqueda en un solo elemento o en varios definición de enlaces, la configuración de campos de varias tablas (con varios campos las uniones adecuadas, la consulta de las de búsqueda “AND” y “OR” unidos como se bases de datos combinadas y la desee). producción de etiquetas. Expresión SQL personalizada – Cree su propio SQL desde cero, o empiece con SQL generado por nuestro cuadro de diálogo de consultas. Lista de elección (Seleccionar de una lista) – Seleccionar manualmente los registros de base de datos que se desea utilizar. Rango de registro – Especificar un rango numérico de registros a imprimir. Con los primeros tres métodos, los valores que busca BarTender pueden ser estáticos, introducidos mediante un cuadro de diálogo en el momento de la impresión, o proporcionados por un programa externo que controle a BarTender. Los métodos de lista de elección y de rango de registro no suelen utilizarse en integraciones, donde otros programas controlan a BarTender. La pantalla de consulta ofrece una forma sencilla de definir búsquedas complejas. Página 5 Documentación: Resumen de integración Consulta Externa con exportación de datos No es necesario consultar los datos de etiquetas desde BarTender. De forma alternativa, puede usar: • • Herramientas de informes nativas de otros programas. Herramientas de "minería de datos" de terceros. Independientemente del método utilizado, normalmente luego habrá que usar uno de estos métodos de transporte de datos: • • • Exportar o “volcar” los resultados de la consulta en un “archivo intermediario” para que Commander o BarTender lo importen posteriormente. Usar TCP/IP para enviar los datos directamente a Commander. Transferir datos mediante programación usando los paquetes .NET SDK o automatización con ActiveX (haga clic para pasar a este capítulo). Conexión directa con una consulta externa Es posible realizar una consulta desde fuera de BarTender sin crear un archivo intermediario. Una forma es diseñar una consulta "de selección" desde Microsoft Access para extraer de la base de datos los datos que se quieren usar. Como Access presenta el resultado de una consulta de selección como si fuera una tabla, BarTender puede importar directamente los datos como si los leyera de una tabla de datos. Consultas dentro y fuera de BarTender Obviamente, si realizamos las consultas desde BarTender, el soporte técnico de Seagull estará en mejor posición para ayudarnos con nuestros problemas para obtener datos. Por otro lado, no hay nada malo en usar herramientas de consulta externas. Como es complicado decir por adelantado qué método será el más rápido, recomendamos empezar con el método con el que se esté más familiarizado. Una situación clave en la que sus opciones se reducen es cuando no se puede acceder directamente a la plataforma de su base de datos desde el ordenador Windows que ejecuta BarTender. En este caso, tendrá que exportar sus datos a un formato intermedio para usarlo posteriormente con BarTender. Como se explicó en la sección Usar Commander™ para controlar BarTender de este documento, la utilidad Commander, incluida con las dos ediciones Automation de BarTender, puede iniciar automáticamente los trabajos de etiqueta de BarTender cuando detecta la llegada de estos datos. Métodos de importación de datos Tanto si consulta sus datos de forma externa o desde BarTender, la compatibilidad de datos con BarTender es algo a tener en cuenta. Página 6 Documentación: Resumen de integración Métodos de importación nativos de BarTender Si el software de su sistema almacena o puede generar los datos en uno de los muchos formatos de datos admitidos por BarTender, entonces BarTender podrá leer los datos de etiquetas sin ninguna programación especial ni procesos personalizados. BarTender admite varios orígenes de datos, desde simples archivos de texto hasta varias bases de datos ejecutándose en varias plataformas. Esto incluye: • • Lectura directa de texto delimitado. (Para obtener más información, por favor consulte el tema “Archivos de texto” en el sistema de ayuda en línea de BarTender.) Uso de OLE DB y ODBC para leer una base de datos externa. Escoja una de las muchas conexiones de datos preconfiguradas o configure cualquier driver OLE DB o ODBC. OLE DB y ODBC La compatibilidad de BarTender con los estándares de drivers de base de datos ODBC y OLE DB de Microsoft permite la lectura de datos de etiquetas desde casi cualquier plataforma de base de datos importante, incluyendo Access, Excel, MS SQL Server, Oracle db, MySQL y muchas otras. Si el driver necesario no está ya incluido en BarTender o Windows, el proveedor de la plataforma de base de datos suele disponer de uno. Para obtener más información Por favor, consulte los temas “Entender OLE DB” y “Entender ODBC” en el sistema de ayuda en línea de BarTender. Importar gráficos incrustados y vinculados Para gráficos que cambian en cada etiqueta, puede leer gráficos incrustados directamente en su base de datos, o simplemente hacer referencia a vínculos de gráficos externos. Página 7 Documentación: Resumen de integración Métodos de importación controlados de forma externa A veces su base de datos externa estará almacenada en un formato propietario (incompatible con OLE DB u ODBC) o estará situada en alguna parte de la red que BarTender no pueda “ver”. O quizás tenga otros motivos para consultar los datos de etiqueta desde fuera de BarTender (consulte Consulta Externa con exportación de datos ) y exportarlos para que los use BarTender. Entre los métodos compatibles se incluyen: • • Usar paquetes .NET SDK de Seagull o automatización con ActiveX para transferir datos mediante programación a BarTender. (Incluye la transmisión de XML.) Usar la utilidad intermediaria Commander de Seagull para transferir datos de transacción desde varios sistemas ERP a BarTender. (Incluye compatibilidad con SAP y las aplicaciones WMS y MSCA de Oracle.) Transferir datos mediante programación usando paquetes .NET SDK o automatización con ActiveX Como explicaremos en la sección Controlar BarTender, los paquetes .NET SDK de Seagull .NET y la compatibilidad con automatización con ActiveX permiten escribir código en sus propias aplicaciones para iniciar y controlar los trabajos de impresión de BarTender. Además, estas herramientas admiten comandos que permiten asignar valores a subcadenas con nombre dentro de BarTender, permitiendo así rellenar una etiqueta con datos de un trabajo de impresión. También se pueden especificar varios registros de datos de etiquetas usando BarTender XML Script (BTXML). Para obtener más información Por favor, consulte: • • • La documentación técnica BarTender's .NET SDKs La documentación técnica BarTender’s ActiveX Automation Interface El tema “Automatizar BarTender” en el sistema de ayuda de BarTender Usar Commander para transferir datos de sistemas ERP como Oracle, SAP e IBM WebSphere Los principales sistemas ERP pueden exportar datos de transacción en varios formatos de datos intermediarios, especialmente diseñados para la integración con otras aplicaciones de software. BarTender puede leer muchos de los formatos ofrecidos por las aplicaciones de Oracle, SAP e IBM WebSphere, incluyendo: • • • • • Solicitudes de impresión XML de Oracle Solicitudes de impresión de sucesos de sensor IBM WebSphere SAP AII XML Archivos de texto de anchura fija, generados por SAPscript IDocs de SAP Para obtener más información Por favor, examine la siguiente documentación técnica: Página 8 Documentación: Resumen de integración • • • Integration with Oracle's WMS and MSCA Integration with IBM WebSphere Sensor Events Integration with SAP Controlar BarTender Los anteriores capítulos explican cómo introducir datos en BarTender. Ahora tenemos que saber cómo completar una integración controlando BarTender desde otro software, incluyendo sistemas diferentes a Windows. Dependiendo de sus necesidades y de la plataforma de su base de datos, puede usar uno de estos tres métodos: • • • Paquetes.NET SDK o automatización con ActiveX Interfaz de línea de comandos Utilidad de integración mediante Commander™ Cuando la integración esté completada, los usuarios ni siquiera tendrán que saber que BarTender es el que realmente está imprimiendo las etiquetas. Paquetes .NET SDK y automatización con ActiveX (COM) Automatización con ActiveX (también llamado COM) es un estándar establecido hace mucho tiempo por Microsoft que permite a un programa de Windows controlar a otro. BarTender se puede controlar mediante automatización con ActiveX desde mediados de los 90. Sin embargo, a los desarrolladores familiarizados con los lenguajes .NET (C# y VB.NET) les resultará más sencillo desarrollar aplicaciones para controlar BarTender usando los paquetes de desarrollo de software .NET de Seagull. Estos paquetes son bibliotecas de código previamente escrito y depurado, diseñadas especialmente para controlar BarTender, incluyendo la carga de formatos de etiqueta y el inicio de trabajos de impresión. La integración mediante los paquetes de desarrollo o automatización con ActiveX es una forma estupenda de controlar completamente BarTender desde otros programas y ofrece más potencia y flexibilidad que la "interfaz de línea de comandos". (Solo las ediciones Automation de BarTender son compatibles con automatización con ActiveX y los paquetes de desarrollo.) Funciones de integración admitidas Los programas que usan los paquetes de desarrollo y automatización con ActiveX funcionan llamando a métodos (funciones) y leyendo y escribiendo varias propiedades (valores de datos) en BarTender. Por ejemplo, puede: • • • • Cargar y cerrar BarTender Abrir formatos de etiqueta Modificar los objetos del formato de etiqueta Proporcionar los datos que se van a imprimir Página 9 Documentación: Resumen de integración • • • • • Iniciar trabajos de impresión Solicitar el estado de un trabajo de impresión Solicitar la reimpresión de trabajos Gestionar los archivos almacenados en Librarian Consultar datos de la base de datos del sistema Controlar BarTender usando XML En lugar de enviar a BarTender un comando cada vez mediante ActiveX o el paquete de desarrollo de BarTender, estas herramientas también pueden enviar a BarTender varios comandos a la vez, colocándolos en un solo mensaje en formato XML. Para saber más sobre el formato XML admitido por BarTender (llamado BTXML), por favor, lea: • • La documentación técnica BarTender's .NET SDKs El tema “Automatización con BarTender XML Script” en el sistema de ayuda de BarTender (Solo la edición Enterprise Automation de BarTender permite utilizar BTXML.) Obtener el estado del trabajo de impresión Al controlar BarTender mediante BTXML, las aplicaciones pueden recibir de BarTender información del estado del trabajo de impresión, dentro de una respuesta XML. De forma alternativa, puede usar el paquete de desarrollo de la base de datos del sistema BarTender (uno de los diferentes paquetes .NET SDK de BarTender) para recuperar el estado final de un trabajo de impresión. Entornos de programación necesarios Para usar los paquetes .NET SDK, es necesario usar uno de los lenguajes .NET: • • C# VB.NET Para acceder a la interfaz de automatización con ActiveX de BarTender, hay que usar un entorno de programación o de series de comandos compatible con automatización con ActiveX. La mayoría de las herramientas de desarrollo estándar de Windows proporcionan esta función, incluyendo: • • • • • • • • Visual Basic, VBA (Visual Basic para Aplicaciones) VBScript Java Script (JScript) Visual C++ (y otras versiones de C para Windows) Power Builder Access, Word, Excel o cualquier aplicación compatible con VBA Delphi Windows Scripting Host (WSH) Página 10 Documentación: Resumen de integración Para obtener más información Por favor, consulte: • • • El tema “Automatizar BarTender” en el sistema de ayuda de BarTender La documentación técnica BarTender's .NET SDKs La documentación técnica BarTender’s ActiveX Automation Interface Control de la interfaz de línea de comandos La línea de comandos de BarTender proporciona un conjunto mínimo de funciones para controlar BarTender. Es especialmente adecuada para especificar qué formato de etiqueta y archivo de texto externo usar para un trabajo de impresión. Sin embargo, proporciona poco control adicional. (Se necesita la edición Automation o superior para poder usar la línea de comandos.) Usando líneas de comandos, se puede: • • • • • • • • Cargar y cerrar BarTender Seleccionar y cambiar el formato de etiqueta Especificar el número de copias por etiqueta Iniciar trabajos de impresión Seleccionar y cambiar el origen de datos externo Especificar un archivo de impresión al que enviar el resultado de la impresión (si se imprime en un archivo y no en una impresora) Seleccionar y cambiar la impresora. Enviar BarTender XML Script (requiere la edición Enterprise Automation) Para ejecutar BarTender usando líneas de comandos, la aplicación con el control debe proporcionar una función de comando “run program” o una opción similar. Entre los términos habituales para esta función tenemos: • • • • • • Run Runprogram Execute Shell Command Open Una variación común de este método es crear un archivo "por lotes" que contenga la línea de comandos BarTender deseada y luego hacer que el programa ejecute ese archivo por lotes. Un ejemplo de una línea de comandos de BarTender que se podría ejecutar desde un archivo por lotes sería: bartend.exe /AF=Address.btw /D=Customers.dat /P Página 11 Documentación: Resumen de integración Para obtener más información Para obtener toda la documentación de la interfaz de línea de comandos de BarTender, consulte el tema “Automatización con la interfaz de línea de comandos” en la ayuda de BarTender. Usar Commander™ para controlar BarTender La utilidad Commander, incluida en las dos ediciones Automation de BarTender, es una aplicación “en segundo plano” que puede ejecutarse como aplicación o como servicio. Commander usa automatización con ActiveX para controlar BarTender por usted, pero usted (y sus otras aplicaciones controladoras) no tienen que preocuparse en absoluto por ActiveX. En su lugar, sus programas generan un evento “desencadenador”, como escribir datos en un archivo o enviar un mensaje a un puerto TCP/IP. Ni a Commander ni a BarTender les importa dónde se ha originado el desencadenador. Esto permite a BarTender integrarse más fácilmente con sistemas de la red que no son Windows y a los que las aplicaciones Windows no podrían acceder directamente de otra forma. Commander permite integrar aplicaciones Windows y de otros sistema operativos con BarTender sin escribir código. Cómo funciona Commander Commander funciona detectando y esperando a ciertos “desencadenadores” de otras aplicaciones de software. Tras detectar un desencadenador, Commander responde realizando una o más acciones definidas por el usuario, una de las cuales suele ser iniciar un trabajo de impresión de BarTender. Página 12 Documentación: Resumen de integración Commander permite integrar BarTender con datos generados prácticamente desde cualquier sistema (Linux/UNIX, AS/400, AIX, etc.) sin más programación adicional. Cuándo usar Commander Commander puede ser especialmente útil en cualquiera de estas situaciones: • • • • No sabe cómo producir líneas de comando o comandos de automatización con ActiveX desde el programa o entorno que tiene el control (o quizás ni siquiera sea posible). No tiene acceso al código fuente de su otro programa. Está trabajando con una plataforma diferente de Windows, como Linux, UNIX, AIX o AS/400, que no puede acceder directamente al sistema Windows que está ejecutando BarTender. El programa con el control no está en la misma red que BarTender. Como ejemplos reales tenemos: • • La aplicación con el control se encuentra en otro país y transmite datos de etiqueta y solicitudes de trabajos de impresión a través de Internet por correo electrónico. Está usando una aplicación Linux o de servidor que no admite comandos ActiveX. Integraciones ya creadas, listas para ser usadas Como indicaremos más adelante en este capítulo, es posible crear integraciones de Commander completamente personalizadas que: • • • Reciban y respondan a varios tipos de desencadenadores Analicen y extraigan comandos para controlar Commander y BarTender Extraigan y modifiquen los datos de etiqueta a imprimir Sin embargo, no es imprescindible que cree estas integraciones desde cero porque Commander ya incluye integraciones creadas previamente para: Página 13 Documentación: Resumen de integración • • • • Oracle WMS Oracle MSCA SAP AII Sucesos de sensor de WebSphere, de IBM Resumen de los desencadenadores de eventos de Commander Entre los tipos de desencadenador compatibles con Commander encontramos: • • • Creación de archivos de datos Recepción de correos electrónicos Recepción de datos a través de un socket TCP/IP Dependiendo de los requisitos de la integración, los desencadenadores que use pueden contener datos útiles o no. Desencadenadores “vacíos” Cuando los desencadenadores no contienen datos de etiqueta funcionan solo como una llamada para "despertar" a Commander y que empiece a procesar uno más comandos definidos por el usuario. En este caso, BarTender tiene que leer los datos que se imprimirán en las etiquetas usando uno de los métodos de importación de datos disponibles. Desencadenadores que contienen datos de etiqueta De forma alternativa, los mensajes y archivos desencadenadores pueden contener los auténticos datos de etiqueta que se imprimirán. Incluir comandos en datos desencadenadores Los desencadenadores de las aplicaciones con el control pueden incluir algo más que solo datos de etiqueta. También pueden incluir comandos incrustados, diseñados para controlar Commander, BarTender o ambos. Commander Script Commander Script es un lenguaje de comandos basado en texto para enviar instrucciones a Commander y que éste las ejecute. Las aplicaciones con el control pueden incluir diferentes comandos de Commander Script dentro de diferentes activadores, enviando así diferentes instrucciones a Commander dependiendo de las acciones solicitadas. Commander Script incluye comandos para controlar el comportamiento de BarTender, además de para ejecutar otras aplicaciones usando parámetros de línea de comandos. BarTender XML Script (BTXML) Hay varias formas de controlar BarTender usando XML. Un método sirve para que una aplicación con el control incluya XML en los desencadenadores que detectará Commander. Commander luego los convertirá en BTXML (si es necesario) y lo enviará a BarTender para que lo procese. Página 14 Documentación: Resumen de integración Convertir de XML a BTXML usando transformaciones XSL La mayoría de los paquetes de software ERP ya incluyen funciones estándar para generar XML. Es uno de los motivos por los que XML es tan cómodo para controlar aplicaciones y que envíen comandos a BarTender. Sin embargo, un posible inconveniente es que el XML generado normalmente por nuestro software puede no ser compatible con el formato BTXML que entiende BarTender. Una alternativa a generar XML personal desde la aplicación ERP es generar el XML en su formato predeterminado y crear un documento de transformación de XSL para que lo use Commander. Commander puede usar XSL (siglas de Lenguaje extensible de hojas de estilo) para convertir automáticamente el XML proporcionado en BTXML. Para saber más sobre las hojas de estilo XSL, por favor consulte: • • • El tema “Integrating with Oracle” en el sistema de ayuda de BarTender Integration with Oracle's WMS and MSCA What’s New in BarTender 9.2 (Solo la edición Enterprise Automation de BarTender es compatible con BTXML y XSL.) Obtener el estado del trabajo de impresión Al controlar BarTender mediante BTXML, las aplicaciones pueden recibir de BarTender información del estado del trabajo de impresión, dentro de una respuesta XML. Entornos de grandes volúmenes de impresión Cuando Commander recibe varios desencadenadores en un breve periodo de tiempo, éstos se ponen en cola y reciben respuesta en el orden recibido. Por tanto, los usuarios que intentan conseguir el máximo rendimiento de impresión deberían pensar en usar la edición Enterprise Automation. Permite lanzar varias sesiones de BarTender para poder ocuparse de más de un desencadenador al mismo tiempo. Esto puede aumentar notablemente la producción de etiquetas general de un sistema. Por el contrario, la edición Automation solo puede controlar una sesión de BarTender cada vez. Por tanto, independientemente de la cantidad de desencadenadores que estén esperando a ser procesados, solo puede procesarse un desencadenador cada vez. En entornos que envían un gran volumen de desencadenadores a Commander, esta limitación puede aumentar la producción general y el tiempo de respuesta. Para obtener más información Por favor, consulte: • • • El sistema de ayuda en línea de Commander La documentación técnica Commander La documentación técnica Commander Examples Página 15 Documentación: Resumen de integración Alertas y registros Como describimos anteriormente, los programas que controlan a BarTender pueden solicitarle información del estado del trabajo de impresión usando código, recibir el estado indirectamente de Commander, o usar los paquetes .NET SDK para consultar la información de estado registrada anteriormente en la base de datos del sistema BarTender. Sin embargo, no es necesario usar ningún código para recuperar la información del estado de BarTender. BarTender, Commander y Printer Maestro pueden enviarle activamente alertas de correo en respuesta a determinados eventos. También puede registrarse una gran variedad de trabajos de impresión, estados e informaciones de eventos en una base de datos SQL, para revisarlos posteriormente. Las alertas reducen el tiempo de inactividad Al gestionar la creación de etiquetas en un entorno empresarial, querrá que le avisen lo más rápido posible cuando un componente vital falle, o cuando se quede sin material, o su software detecte alguna condición de error. Para satisfacer esta demanda, BarTender, Commander y Printer Maestro pueden enviar mensajes de alerta personalizados. Alertas de BarTender Puede configurar las dos ediciones Automation de BarTender para enviar correos electrónicos informativos como respuesta a diferentes eventos, avisos y errores. Por ejemplo: • • • • Trabajo de impresión solicitado No se puede acceder a la base de datos Impresora no disponible Trabajo de impresión fallido Alertas de Commander La aplicación complementaria Commander, incluida con las dos ediciones Automation de BarTender, también envía alertas por correo electrónico. Por ejemplo: • • • La detección de desencadenadores empezó/se detuvo Error accediendo al archivo desencadenador Error analizando el XML Alertas de Printer Maestro La aplicación complementaria Printer Maestro proporcionada con las dos ediciones Automation de BarTender, puede enviar alertas mediante mensajería instantánea (MI), mensajes de texto (SMS) y correo electrónico. Por ejemplo: • • Impresora offline Equipo offline Página 16 Documentación: Resumen de integración • • • Queda poco o nada de papel Queda poco o nada de cinta Mensajes de error específicos de determinados modelos de impresora, como un problema con el cabezal de impresión. Para obtener más información sobre Printer Maestro y las Alertas, consulte la documentación técnica “Printer Maestro” (solo en inglés): • • http://www.seagullscientific.com/docs/whitepapers/Enterprise-PrintManagement(English).pdf Sistema de ayuda en línea de Printer Maestro. Los trabajos de impresión y el registro de eventos ayudan a verificar los trabajos de impresión Para ayudar en las auditorías de seguridad y asegurar que los trabajos de impresión automatizados se realicen con éxito, las ediciones Automation de BarTender y Printer Maestro permiten guardar en la “base de datos del sistema BarTender” un registro extremadamente detallado de la importante información de eventos de la aplicación y de trabajos de impresión. (Con la edición Enterprise Automation de BarTender instalada, Printer Maestro puede registrar los eventos de trabajo de impresión y de impresora desde cualquier aplicación Windows, no solo BarTender.) La importancia de guardar un registro al automatizar BarTender Si está sentado ante el ordenador, usando manualmente BarTender para ejecutar un trabajo de impresión, puede ver importantes mensajes de advertencia o de error bajo ciertas circunstancias. Sin embargo, cuando BarTender está siendo controlado desde otro software, se ejecuta de forma “invisible” y por tanto estos mensajes no aparecen. Sus opciones para conocer la existencia de posibles problemas son por tanto las "alertas" en tiempo real (explicadas anteriormente) y el registro (que permite revisar y confirmar trabajos de impresión a posteriori). La base de datos del sistema BarTender Cuando el registro está activado, BarTender y Printer Maestro pueden almacenar diferente información en la base de datos del sistema BarTender. Esta base de datos puede crearse mediante una copia gratuita de SQL Server Express Edition (incluida con BarTender), o desde una instalación completa de SQL Server, si dispone de una. Los tres tipos de información que se registra BarTender y Printer Maestro pueden registrar tres tipos de información en la base de datos del sistema BarTender: • Información de trabajo de impresión: o Nombre, e incluso una copia, del formato de etiqueta (es decir, el archivo BTW). o Nombre de usuario y de equipo. Página 17 Documentación: Resumen de integración Detalles sobre el estado de la impresora y las opciones de impresión de BarTender. • • Datos e imágenes de etiqueta: Permite volver a imprimir fácilmente cualquier etiqueta dañada y responder rápidamente a las auditorías de seguridad. Mensajes de evento de la aplicación: Revisar los posibles errores y advertencias que aparecieron durante los trabajos de impresión es especialmente útil al depurar integraciones entre otros programas y BarTender. Sencilla visualización de registros Es muy fácil consultar, dar formato, recuperar y visualizar la información registrada, usando: • • History Explorer Reprint Console History Explorer permite examinar fácilmente los trabajos de impresión realizados y personalizar la visión de los datos. Para obtener más detalles sobre History Explorer y Reprint Console, por favor consulte: • • • La documentación técnica History Explorer La documentación técnica Reprint Console Los sistemas de ayuda en línea de History Explorer y de Reprint Console Página 18 Documentación: Resumen de integración Recuperar datos de la base de datos del sistema mediante programación Usando el paquete .NET SDK, puede obtener cualquier dato que pueda ver usando History Explorer. Puede usar esta información de diferentes formas, como creando una integración con su propio almacén de datos, o recuperando información sobre el trabajo de impresión para que la use su propia aplicación. Guardando el registro en un archivo de texto BarTender también permite guardar el registro en archivos de texto. Sin embargo: • • • • • • • La información disponible no es tan detallada. El formato no puede ser personalizado tan fácilmente. No se proporcionan visores de registro dedicados. Encontrar la información exacta que se busca no será tan fácil. Rastrear la información de varios trabajos es más complicado. No hay mantenimiento automático del registro. Los registros de archivo de texto no son tan seguros como una base de datos SQL. Para obtener más información Para obtener más detalles sobre el registro, incluyendo detalles de la base de datos del sistema BarTender y la seguridad del registro, consulte: http://www.seagullscientific.com/docs/whitepapers/WhitePaper_Whats NewInBT900.pdf Para obtener más información sobre las otras aplicaciones mencionadas anteriormente, incluyendo Printer Maestro, History Explorer, Reprint Console, etc., por favor consulte la documentación técnica dedicada a ellos en: http://www.seagullscientific.com/aspx/whitepapers.aspx. Consulte también el sistema de ayuda de Printer Maestro, History Explorer y Reprint Console. Utilizar plantillas de código de impresora Hasta ahora, en este Resumen de Integración, hemos visto varias formas de realizar las dos operaciones más básicas de integrar el proceso de impresión de etiquetas de BarTender con otro software: • • Enviar datos de etiqueta externos a BarTender. Controlar BarTender desde otro software. Página 19 Documentación: Resumen de integración Estos dos métodos pueden implementarse tan perfectamente con otro programa que los usuarios no tienen por qué saber que BarTender es el software que realmente está imprimiendo las etiquetas. Sin embargo, hay algunos entornos en los que la integración directa con BarTender podría no ser posible. Algunos de estos inconvenientes pueden solventarse usando la función de BarTender para exportar plantilla de código de impresora. (Solo disponible en las dos ediciones Automation.) Entender las plantillas de código de impresora Aunque implementar y usar plantillas de código de impresora necesita conocimientos técnicos especializados, explicar el concepto básico es bastante sencillo. En primer lugar, revisemos cómo funciona un trabajo de impresión convencional. Trabajos de impresión convencionales Con los trabajos de impresión convencionales, BarTender lee(o recibe) datos de etiqueta de una fuente de datos externa. A continuación BarTender une esos datos de etiqueta con el formato de etiqueta que hemos diseñado y genera comandos que piden a la impresora que imprima los diferentes campos de datos de etiqueta en las partes adecuadas. Con este método, se proporcionan los datos antes de generar los comandos de impresora. Generar plantillas de código de impresora Al imprimir con plantillas de código de impresora, los datos de impresora los proporciona otro programa diferente a BarTender y se entrega tras la generación de los comandos de impresora. Para que esto sea posible, en lugar de enviar los comandos de impresora directamente a la impresora, BarTender los envía a un archivo de datos. Además, cada posición del código de impresora, en la que normalmente se situarían los datos de etiqueta, es reemplazada por un comodín fácilmente reconocible. Por ejemplo, la parte del código de impresora en el que normalmente habría un campo de texto, podría contener este texto en su lugar: <*CAMPO1*> El siguiente objeto de la etiqueta, quizás un código de barras, podría contener en vez de eso: <*CAMPO2*> El archivo de texto que crea BarTender y contiene este código de impresora especialmente modificado se denomina Plantilla de código de impresora. (Por favor, recuerde que el ejemplo anterior es solo ilustrativo, usando una sintaxis totalmente arbitraria. Cualquier parecido con la sintaxis real será pura coincidencia.). Imprimir con plantillas de código de impresora Imprimir la plantilla de código de impresora descrito anteriormente no es útil porque los datos de etiqueta <*CAMPO1*> y <*CAMPO2*> aparecerían en todas Página 20 Documentación: Resumen de integración las etiquetas. En vez de eso, almacenamos las plantillas de código de impresora en un programa o en un dispositivo de hardware que sepan cómo sustituir los comodines por datos reales. No dispondremos de un código de impresora útil, que pueda usar una impresora hasta que los datos de etiqueta se hayan "unido" a la plantilla de código de impresora. Entre los usos de las plantillas de código de impresora (PCT) encontramos: Incrustar código de impresora directamente a programas Muchas personas saben que antes de que existieran los ordenadores personales y Windows, el software se ejecutaba sobre enormes ordenadores. En algunos de los primeros programas diseñados para gestionar cadenas de suministros, los programadores escribían a mano todo el código de impresora necesario para las etiquetas, y simplemente lo compilaban como parte del programa. Los cambios en el formato de etiqueta, por pequeños que fueran, suponían cambiar a mano estas secciones de código de impresora incrustado. Algunas de estas antiguas aplicaciones aún se usan hoy en día y algunos veteranos aún prefieren escribir a mano el código de sus etiquetas. Una forma más eficaz de gestionar los formatos de etiqueta incrustados es usar BarTender para generar una plantilla de código de impresora (PCT) en un archivo y luego compilar ese código de impresora en el programa. Cambiar el diseño de etiqueta aún requiere tiempo, porque hay que ejecutar BarTender, realizar el cambio, exportar a una nueva PCT y volver a compilarla en el programa externo. Sin embargo, trabajando con un buen programa completamente visual, como BarTender, será mucho más fácil y rápido diseñar etiquetas que escribir su código a mano. Integración con SAPscript-ITF SAPscript es un motor de informes, disponible en SAP, que permite combinar automáticamente los datos de etiqueta proporcionados por SAP y un formato de plantilla de código de impresora proporcionado de forma externa, llamado ITF (Interchange Text Format o Formato de Intercambio de Texto). Igual que hacemos al crear formatos incrustados, tenemos que exportar una PCT desde BarTender, en este caso usando el formato SAPscript-ITF PCT compatible con cualquiera de las ediciones Automation. El archivo ITF exportado deberá ser "enviado" al sistema SAP. A continuación se puede configurar el sistema SAP para ejecutar el informe SAPscript adecuado y unirlo a los datos de etiqueta necesarios cada vez que una transacción SAP necesite una o más etiquetas. Aunque el sistema SAPscript-ITF simplifica los cambios de formato de etiqueta, al no tener que compilar e incrustar físicamente nuevo código de impresora en la aplicación SAP, aún debe enfrentarse a los Problemas técnicos de las plantillas de código de impresora descritos en la siguiente sección. Página 21 Documentación: Resumen de integración Dispositivos de teclado portátiles Existen varios dispositivos de teclado portátiles que son poco más que un teclado portátil, una pequeña pantalla y un puerto de impresora. Estos dispositivos suelen carecer de la capacidad de las "terminales de datos" portátiles y no tienen ningún tipo de conectividad a la red principal de la compañía. El uso más común es conectarlo a una impresora transportada sobre ruedas en el almacén, sobre una carreta o en una carretilla elevadora. Un dispositivo de teclado portátil que no esté ejecutando Windows y no está conectado a la red principal obviamente no podrá ejecutar un programa de impresión como BarTender. Sin embargo, muchos dispositivos de teclado permiten descargar y almacenar plantillas de código de impresora. Pueden solicitar los datos de etiqueta, unirlos con las PCT y generar el código de impresora para la impresora conectada. Usar impresoras compatibles con XML Aunque la mayoría de las impresoras de etiquetas proporcionan un lenguaje de impresora completo y robusto, algunos de ellos tienen una opción para aceptar plantillas de código de impresora. Al igual que los formatos incrustados y los dispositivos de teclado (explicados anteriormente), antes hay que diseñar una etiqueta y exportar una PCT para descargarla posteriormente en la impresora. Por tanto, solo tenemos la opción de enviar datos de etiqueta (sin código de impresora) a la impresora compatible con XML. Imprimir en entornos diferentes de Windows Incluso si el programa que tiene el control no se está ejecutando sobre Windows, la aplicación intermedia Commander incluida con las dos ediciones Automation de BarTender ofrece numerosas opciones para su integración con BarTender. (Por favor, consulte la sección anterior de esta documentación técnica y la documentación independiente Commander.) Sin embargo, si la aplicación con el control está configurada de forma que no tiene acceso a equipos Windows en la red, el incrustar plantillas de código de impresora ofrece un método por el que aún se puede aprovechar la comodidad del diseño de etiquetas basado en Windows (aunque no sea una impresión basada en Windows). Problemas técnicos de las plantillas de código de impresora Generar plantillas de código de impresora necesita cualquiera de las ediciones Automation de BarTender. Sin embargo, a diferencia de un trabajo de impresión de etiquetas convencional, BarTender no sirve como motor de impresión para los trabajos de etiqueta. Por tanto BarTender no puede proporcionar varias funciones de impresión de etiquetas avanzadas que hemos desarrollado a lo largo de muchos años. Entre los problemas técnicos y de seguridad de las plantillas de código de impresora encontramos: A menudo necesita conocimientos de programación Cuando se usa BarTender como motor de impresión, no hay que preocuparse por los detalles técnicos de comunicación con la impresora. Por Página 22 Documentación: Resumen de integración el contrario, para incrustar formatos de etiqueta en otro software, hay que saber programar en el lenguaje en el que fue escrito dicho software, además de poder leer, manipular e incrustar grandes secciones de código de impresora. Dificultad de cambiar el formato de etiqueta Al usar BarTender como motor de impresión, simplemente modificamos el diseño de etiqueta y ya podemos imprimir de nuevo. Por el contrario, por muy pequeño que sea el cambio hecho al usar plantillas de código de impresora, tenemos que: • • • Ejecutar BarTender y modificar la etiqueta. Exportar el diseño de etiqueta a una plantilla de código de impresora (PCT). Volver a incrustar la PCT en la aplicación y volver a compilarla. (O volver a descargar la PCT en los dispositivos de hardware.) Mantenimiento de impresora más complicado Si ha almacenado plantillas de código de impresora en una impresora que falla, normalmente tendrá que llamar a alguien del departamento de informática para reiniciar la producción de etiquetas en la impresora de repuesto, aunque siga usando exactamente el mismo modelo de impresora. Esto es debido a que hay que ejecutar todo el proceso personalizado que utiliza la compañía para instalar las PCT. Por el contrario, cuando se usa BarTender como motor de impresión, se puede imprimir en la nueva impresora inmediatamente. Y cambiar de marca de impresora solo supone indicar un driver de impresora diferente. ¡Por el contrario, cambiar de marca de impresora cuando se usan PCT suele exigir programación personalizada! Sin supervisión del estado del trabajo de impresión Muchos “Drivers by Seagull™” para impresoras Windows proporcionan la utilidad de Windows y BarTender Printer Maestro, con información como: • • • • ¿Está la impresora en línea? ¿El trabajo de impresora está ejecutándose o está atascado? ¿La impresora tiene suficientes etiquetas? ¿Por qué se ha detenido la impresora? Por el contrario, al imprimir usando PCT, a menos que se haya programado una utilidad propia para gestionar este tipo de supervisión de estado, normalmente se imprimirá "a ciegas", sin conocer el estado de la impresora. Imposibilidad de admitir varios modelos de impresora Al imprimir desde BarTender, se pueden seleccionar diferentes impresoras en cuestión de segundos. Aún más, al usar la utilidad Printer Maestro, si un trabajo de impresión falla debido a un "atasco" o a una impresora que no está disponible, se puede trasladar el trabajo de impresión a una impresora de otra marca o modelo con un rápido movimiento de ratón. Por el contrario, como los PCT son por su misma definición, código para una determinada impresora, no Página 23 Documentación: Resumen de integración se puede "trasladar" un trabajo de impresión fallido a una impresora de otra marca. De hecho, los diferentes modelos de impresora de la mayoría de fabricantes son lo bastante diferentes entre sí para necesitar diferentes PCT para cada modelo. (Incluso hemos visto casos de modelos de impresora “idénticos”, con diferentes versiones de firmware, que necesitaban PCT ligeramente diferentes.) Sin acceso a códigos de barras y fuentes incompatibles Cuando BarTender usa “Drivers by Seagull™” de impresora Windows, tenemos acceso a todas las fuentes y códigos de barras integrados en la impresora. Por tanto, también estarán a disposición de cualquier PCT generado. Sin embargo, BarTender también puede imprimir fuentes TrueType (y varias de otros creadores), además de una extraordinaria variedad de códigos de barras de una y dos dimensiones incluso si estas fuentes y códigos de barras no están integrados en la impresora. Esto se debe a que BarTender puede, si es necesario, enviar estos elementos a las impresoras como tramas. Por el contrario, las plantillas de código de impresora solo admiten gráficos estáticos (es decir, que no cambian). Esto evita la impresión de códigos de barras "con tramas" y de texto que cambia de una etiqueta a otra. Sin compatibilidad con gráficos cambiantes Por los mismos motivos descritos, las PCT no son compatibles con la lectura e impresión de diferentes objetos gráficos para diferentes etiquetas. Por ejemplo, si quisiéramos leer una imagen diferente de una base de datos para imprimirla junto a cada código de barras de las etiquetas de inventario, no podríamos imprimir usando PCT. Sin formato de párrafo: BarTender ofrece una gran cantidad de funciones de formato de párrafo, incluyendo ajuste de línea, sangrado, justificado, viñetas, numeración y espaciado de línea. El uso de PCT no permite este tipo de formato de párrafo. Sin tamaño de fuente variable El cuadro de diálogo Fuente de BarTender tiene una opción Cambio automático de tamaño que permite a BarTender aumentar o reducir automáticamente el tamaño de la fuente de un objeto de texto, dependiendo de la cantidad de texto proporcionado para el mismo en cada etiqueta. Por el contrario, el uso de PCT requiere que cada objeto de texto siempre se imprima con el mismo tamaño de fuente en cada etiqueta. Pérdida de numerosas funciones de seguridad y de preparación de auditoría Entre las aplicaciones complementarias disponibles en el paquete con la aplicación BarTender están: • BarTender Security Center – Gestiona los permisos y otras funciones de seguridad. Página 24 Documentación: Resumen de integración • • Librarian – Permite a grandes grupos de usuarios, diseñadores y administradores, gestionar de forma segura y cooperativa el almacenamiento y la revisión de los formatos de etiqueta y otros archivos. History Explorer – Permite a los usuarios ver información sobre pasados trabajos de impresión, incluyendo imágenes de etiquetas y cualquier mensaje de trabajo de impresión que pueda haberse generado. El uso de PCT anula completamente estas funciones de seguridad y de registro que posibilitan las funciones de auditoría de History Explorer. Pérdida de funciones avanzadas de gestión de impresión Printer Maestro es una poderosa herramienta que puede supervisar cada impresora y trabajo de impresión de en una red Windows y mostrar la información de estado en una sola pantalla. Printer Maestro incluso permite mover los trabajos de impresión fallidos de una impresora a otra (incluso de una marca diferente) con un solo movimiento rápido de ratón. Por el contrario, el uso de PCT anula las funciones estándar de Windows que permiten realizar estas funciones de gestión. Para obtener más información Para obtener más información sobre las plantilla de código de impresora, consulte la documentación técnica Exporting Printer Code Templates. Conclusión Hay muchas formas de integrar BarTender con otros programas. El mejor método no dependerá solo de las capacidades del software, sino también de los métodos de integración que prefiera usar. Por suerte, las versátiles opciones de importación de datos y las potentes funciones para controlar BarTender desde otros programas, proporcionan una gran cantidad de opciones para implementar una integración rápida, funcional y fiable. Página 25 Documentación técnica de Seagull disponible Documentación técnica general • Ventajas de Drivers by Seagull Aplicaciones complementarias • Printer Maestro: Enterprise Print Management • Librarian • BarTender Security Center • BarTender Web Print Server Mejoras recientes • What’s New in the Latest BarTender Documentación técnica sobre integración • Resumen de integración • Commander • Commander Examples • BarTender's .NET SDKs • BarTender's ActiveX Automation Interface • Exporting Printer Code Templates • Using BarTender with Remote Desktop Services and Citrix XenApp • Integration with Oracle's WMS and MSCA • Integration with IBM WebSphere Sensor Events • Integration with SAP Documentación técnica variada • Weighing Scales • Dynamically Changing Objects at Print Time using VB Script • GHS Compliance Labeling • Licensing for BarTender's Automation Editions • Printing International Characters Using BarTender • BarTender Software Activation • Using BarTender's Application Identifier Wizard • Optimizing Output Performance • Status Monitor Overview • Silent Install Para conseguir las versiones descargables, visite: www.seagullscientific.com/aspx/white-papers.aspx Versión: 2012-09-13 10:57 Copyright © 2012 Seagull Scientific, Inc.