Aunque presionar el botón de inicio o dejar que las integraciones se inicien automáticamente parece algo que no puede fallar, es un primer paso clave en el ciclo de integración. Este paso indica a la integración que comience a buscar ese disparador. Si algo ha salido mal o la ubicación del disparador ya no está disponible, la integración esperará indefinidamente o incluso puede fallar.

Cada tipo de integración tendrá un nombre diferente para esta información en tu archivo de integración y debe configurarse para que funcione. Para todos los tipos de integraciones, la configuración estará en la primera subsección de la sección de Integración y dirá qué está buscando. En esta captura de pantalla, se trata de una integración de archivos, por lo que aparece Detección de Archivos como nombre de la subsección, ya que está buscando archivos para activar la integración.

Muchas veces, los problemas en este paso tienen que ver con permisos, nombres de archivos y configuración del disparador. Si intentas iniciar la integración en Integration Builder, puede aparecer un error de inmediato indicando el problema.

Aquí tienes algunos escenarios para los tipos de integración más comunes que pueden causar problemas en este paso:

Integraciones de archivos

Para las integraciones de archivos, los permisos y la ubicación de los archivos son fundamentales.

• ¿La ubicación de la carpeta de escaneo está escrita correctamente?
• Para ubicaciones en la nube, ¿el usuario y la contraseña son correctos? ¿La clave secreta es correcta?
• ¿El usuario actual tiene permiso para acceder a esta carpeta? Se recomienda no usar ubicaciones como Mis Documentos o una unidad de red mapeada, ya que los permisos pueden complicarse.
• ¿La integración está vigilando la carpeta correcta donde dejas los archivos?

Si la integración no puede acceder a la carpeta, probablemente fallará con un error de permisos o de acceso. Se recomienda que las carpetas de escaneo no usen una letra de unidad virtual (es decir, que no sea una unidad física) y que no estén en Mis Documentos ni en el escritorio.

También se recomienda que la carpeta de escaneo esté alojada solo en un sistema basado en Windows. Si planeas usar Unix, Linux u otro sistema operativo para alojar tu directorio de escaneo, considera usar una ubicación en la nube como FTP.

Si se trata de una carpeta de red, eleva los permisos de tu integración para que tenga acceso adecuado.

Integraciones de bases de datos

El acceso a la base de datos es clave. Verifica lo siguiente:

• ¿La base de datos está en línea?
• ¿El usuario y la contraseña son correctos?

Estos ajustes se encuentran en el cuadro de configuración de la conexión. Al igual que al solucionar una conexión de base de datos en una etiqueta, abrir este cuadro mediante el botón Configuración de Conexión a Base de Datos... te permitirá saber si la base de datos se conecta correctamente. Si no es así, aparecerá un error.

Integraciones de socket

La conectividad de red es muy importante. Si no puedes establecer una conexión, puedes empezar revisando la propia conexión.

• ¿Los puertos están abiertos?
• ¿Hay algún firewall o antivirus que pueda estar interfiriendo?
• ¿Hay algo más usando el mismo puerto?

Las integraciones requieren un puerto libre. Si hay algo más usando el puerto, la integración normalmente fallará y dirá que el puerto no está disponible. Como en otras integraciones, un mensaje de error suele indicar el problema y cómo solucionarlo.

Puntos clave

Aunque este paso puede variar según el tipo de integración, hay algunos puntos clave para solucionar problemas en todos los casos:

• Los permisos son muy importantes.
• Asegúrate siempre de que la integración tenga acceso al disparador.
• Los fallos suelen provocar un error al iniciar la integración.

Una vez que la integración ha comenzado, es momento de esperar a que llegue el disparador. Parece un paso que no requiere solución de problemas, pero ¿qué hacer si te quedas eternamente esperando? ¿Qué pasa si el disparador nunca llega? Si estás atascado en un estado de "no pasa nada", solucionar este paso puede ayudarte a descubrir por qué.

Todos los tipos de integraciones esperan a que ocurra o aparezca algo. Puede ser un archivo, datos a través de un puerto de red, un registro en una tabla o un momento específico. Todas las configuraciones para la detección del disparador están en el mismo lugar que el paso anterior, la primera subsección bajo el encabezado de Integración.

Aquí tienes algunas cosas que puedes revisar según el tipo de integración:

Integraciones de archivos

• ¿El archivo disparador se está colocando en la carpeta de escaneo indicada en la integración?
• ¿El archivo disparador coincide con el Patrón de Archivo esperado? Si la integración busca un .csv y dejas un archivo .css, el patrón no coincide.
• ¿Hay otra integración que pueda estar tomando los archivos primero?

Integraciones de bases de datos

• ¿Los datos se están insertando en la tabla correcta?
• ¿El método de detección de datos es el correcto? Si una integración espera un valor incremental y en su lugar actualizas una marca de tiempo, los métodos no coinciden.
• ¿El campo vigilado se está incrementando o se actualiza la marca de tiempo?

Integraciones de socket y servicios web

• ¿Los datos se están enviando a la dirección correcta?
• ¿Un firewall está bloqueando el puerto?

Puntos clave

• Asegúrate de que el disparador llegue al lugar correcto.
• Verifica que nada esté bloqueando o tomando el disparador antes de que se detecte.

Al igual que el paso anterior, este paso parece que debería funcionar sin problemas. A veces puede aparecer un error si hay un problema en este paso, pero otras veces el problema solo se hace evidente cuando el ciclo de integración se repite.

Esta acción implica lo que hace la integración una vez que recibe los datos. Solo dos tipos de integraciones utilizan acciones posteriores a la detección. Todos los demás tipos pueden saltarse este paso. Aquí tienes algunas cosas a revisar en las integraciones más comunes que sí tienen acciones posteriores a la detección:

Integraciones de archivos

De todos los tipos de integraciones, estas son las más "ruidosas" en este paso. Si algo sale mal con las acciones posteriores a la detección, la integración mostrará un error indicando el problema. Los problemas más comunes incluyen permisos para cambiar archivos o carpetas y rutas de archivo incorrectas.

Las acciones posteriores a la detección para una integración de archivos se muestran aquí:

Integraciones de socket

En este paso, los problemas con una integración de socket son mucho menos evidentes que con una integración de archivos. Si tienes una integración de socket relativamente tranquila, puede que no tengas problemas aquí, pero si es muy activa, puede que veas este error ocasionalmente: "Error: No se puede acceder al objeto eliminado."

Lo que sucede aquí es que el socket no se cierra después de recibir los datos, por lo que nuevos datos llegan de inmediato. La integración no está lista para recibir nuevos datos, así que no sabe cómo procesarlos y simplemente los descarta, asumiendo que son datos basura. El socket está perdiendo datos y las impresiones empezarán a fallar.

Si notas este comportamiento, revisa este artículo sobre cómo solucionarlo: Error de integración al ejecutar integración de socket.

Puntos clave

• Este paso aplica a dos integraciones en particular.
• Los errores en este paso no siempre son evidentes.

Las acciones de integración son todos los pasos que realiza tu integración para procesar e imprimir una etiqueta. Todas las acciones se muestran debajo del encabezado de acciones:

Este ejemplo es bastante sencillo ya que solo incluye una acción de impresión. Sin embargo, algunas integraciones pueden incluir varios pasos como bucles, análisis de datos, envío de mensajes o correos electrónicos, o sentencias condicionales. Aquí tienes un ejemplo más grande donde se extraen datos de un disparador usando una serie de acciones de Búsqueda y Eliminación nombradas, y luego se usan esos datos en una acción de Imprimir Documento:

Esto aumenta la complejidad de este paso y los puntos donde algo podría fallar. Lo mejor es empezar de forma sencilla. Reduce las acciones al mínimo indispensable para disminuir los pasos tanto como sea posible (generalmente solo las acciones que se usan al crear una integración nueva desde el menú Nuevo más lo mínimo necesario para procesar los datos) y comienza desde ahí.

• Elimina pasos extra. Empieza con lo mínimo necesario.
• Agrega cada paso y prueba para asegurarte de que el problema no esté en esa acción en particular.

El mayor reto en este paso es hacer pruebas. Si el problema está en un paso posterior del ciclo de integración, persistirá durante todas las pruebas. Aun así, es fundamental revisar todo en este paso. Aquí tienes problemas comunes que pueden surgir con los pasos mínimos en una integración:

Ubicación del documento

Para imprimir una etiqueta, la integración debe, por supuesto, poder abrir un documento. Si la ubicación o el nombre del documento no es válido, probablemente la integración mostrará un error indicando que hubo un problema al abrir el documento. Puedes encontrar el nombre del documento en los siguientes lugares:

• Acción Imprimir Documento: En la sección Documento de la pestaña Documento. Si el documento se determina por una variable, rastrea de dónde proviene esa variable (usualmente de un campo de base de datos, una acción de Establecer Variable o una de las acciones de Búsqueda) y asegúrate de que los datos en esa variable sean correctos.
• Acción Imprimir Script de Comando: en los datos del disparador en el parámetro /AF
• Acción Imprimir BTXML: en los datos del disparador en la etiqueta <Format>

Si no se indica ningún documento en una acción de Imprimir Documento, la integración fallará inmediatamente al intentar iniciarla, mostrando un mensaje de error sobre el documento faltante.

Nombre de la impresora

Así como no puedes imprimir sin un documento, tampoco puedes imprimir sin una impresora válida. En la mayoría de los casos, la integración mostrará un error, generalmente un error de impresora no válida o el código de error de Windows 1801 (Windows tiene problemas con esta impresora). Este último está fuera del alcance de esta guía, ya que requiere soluciones en Windows. El primero se puede encontrar en los siguientes lugares:

• Acción Imprimir Documento: En el campo Impresora de la pestaña Opciones de impresión
• Acción Imprimir Script de Comando: en los datos del disparador en el parámetro /P
• Acción Imprimir BTXML: en los datos del disparador en la etiqueta <Printer>

Si no se indica ninguna impresora, la integración usará la impresora que esté guardada con la etiqueta. Si tu integración no especifica una impresora, abre la etiqueta en BarTender Designer y ve a Archivo > Imprimir. Esa es la impresora que está usando tu integración.

A veces, una etiqueta termina imprimiéndose en una impresora diferente a la esperada o simplemente desaparece. Esto ocurre porque el sistema de redirección de impresoras entra en acción y envía el trabajo de impresión a la primera impresora disponible. Si ves este comportamiento extraño, consulta este artículo para solucionarlo: Las impresiones de la integración se envían a impresoras incorrectas o aleatorias.

Tipo de base de datos o discrepancia en el nombre del campo

Si tu integración usa una base de datos y recibe datos de una integración, debes asegurarte de que el tipo de base de datos coincida. Por ejemplo, si tu etiqueta está conectada a una base de datos de valores separados por comas (CSV), pero tu integración envía datos separados por tabulaciones o algo completamente diferente, como datos XML, esto genera una incompatibilidad entre tipos de base de datos y el documento no puede entender los datos que recibe. Esto puede causar varios errores de integración, mencionando problemas con la base de datos, los campos o datos vacíos.

Además, aunque los tipos de base de datos coincidan, si los nombres de los campos son diferentes en nombre u orden, también puede causar errores similares de integración.

Para verificar que las bases de datos coincidan correctamente, puedes hacer lo siguiente:

• Abre el archivo de la etiqueta en BarTender Designer. Ve a Archivo > Configuración de conexión de base de datos. En este diálogo puedes revisar los nombres de los campos y el tipo de base de datos conectada a tu etiqueta.
• Además, puedes encontrar el nombre de la base de datos conectada en este diálogo y abrirla en tu computadora para revisar el formato (por ejemplo, CSV vs delimitado por tabulaciones) y verificar los nombres de los campos.
• Compara la base de datos conectada con los datos incluidos en el disparador.

Si la base de datos de tu etiqueta es cualquier cosa que no sea un archivo de texto (o un archivo de Excel en BarTender 2019 R5 y posteriores), la integración siempre fallará por incompatibilidad de base de datos. Si tu etiqueta está conectada a una base de datos no compatible, debes cambiar la conexión a una compatible y reconfigurar tus objetos en la etiqueta para que apunten al nuevo campo.

La etiqueta solo tiene datos predeterminados

Esto ocurre porque la integración no está pasando los datos a la etiqueta durante la impresión. Lo más probable es que la integración no haya sido configurada para hacerlo (comportamiento predeterminado) y solo ocurre en una acción de Imprimir Documento. Aquí tienes los dos escenarios con este problema y cómo solucionarlos:

• Transferencia de información de la base de datos: La integración debe estar configurada para sobrescribir la información. Esto se encuentra en la sección de Reemplazos de base de datos de la acción Imprimir Documento en la pestaña Opciones de impresión. Debes sobrescribir la base de datos con Datos de integración o EventData para pasar los datos del disparador a la etiqueta.
• No definir fuentes de datos nombradas: Las integraciones deben saber cómo emparejar variables con fuentes de datos nombradas en la etiqueta. Si ves que faltan fuentes de datos nombradas con el mismo nombre en la pestaña Fuentes de datos nombradas, haz clic en el botón Importar configuración del documento en la pestaña Documentos y luego empareja las fuentes de datos nombradas importadas con las variables de la integración.

Puntos clave

• Para solucionar mejor este paso, reduce la cantidad de acciones al mínimo y luego agrégalas una por una para ver dónde podría estar el problema.
• Los datos suelen ser un problema común en este paso. Corregirlo aquí previene problemas en los siguientes pasos.

La parte de impresión del ciclo de integración se basa en una versión formateada de XML llamada BTXML. Contiene información del documento y de la impresora, además de cualquier dato del archivo disparador que hayas configurado para pasar a la etiqueta.

Aunque puedes crear tu propio BTXML y enviarlo a través de una integración usando la acción Imprimir BTXML, ¡no es necesario! La integración convierte automáticamente tus datos y configuraciones en la acción de impresión a BTXML.

Si ya realizaste toda la solución de problemas en los pasos anteriores, el BTXML se convertirá correctamente y puedes pasar al siguiente paso.

El último paso en el ciclo de integración, antes de que se repita, es la impresión propiamente dicha. Todo esto lo gestiona automáticamente el servicio Print Scheduler y sigue un flujo sencillo. Aquí tienes un fragmento del diagrama de flujo al inicio de este artículo:

Una vez que el script BTXML se envía al Print Scheduler desde el paso anterior del ciclo, este comienza de inmediato. El servicio se encarga de abrir el Motor de Impresión y luego interpretar qué archivo de etiqueta debe abrirse (si no está ya abierto en un motor). Una vez abierto el documento, los datos se colocan en los lugares correctos de la etiqueta si se enviaron desde la integración, ya sea mediante un reemplazo de base de datos o fuentes de datos nombradas. Después de procesar los datos, la etiqueta se envía a la impresora indicada en el BTXML o a la vinculada en la etiqueta si no se especifica ninguna.

Con todo esto gestionado automáticamente por un servicio, ¿qué pasa si algo sale mal? ¿Cómo lo solucionas? Como ya has hecho la mayor parte del trabajo en los pasos anteriores, solucionar este paso es más fácil de lo que parece.

Como se menciona en la introducción de esta guía, los Motores de Impresión usados por el servicio Print Scheduler son en realidad BarTender Designer ejecutándose como un servicio. Esto significa que puedes solucionar este paso usando el propio Designer.

Solución básica de problemas

En el momento de imprimir, un Motor de Impresión imprime automáticamente un archivo de etiqueta según las instrucciones del script BTXML. Si quisieras imitar este script, abrirías una etiqueta y vas a Archivo > Imprimir, cambias el nombre de la impresora y luego imprimes el documento. Hay algunos pasos extra que puede hacer un script BTXML, pero esta acción simple puede decirnos mucho sobre lo que está pasando en un Motor de Impresión invisible.

Abrir e imprimir el documento

El comportamiento más básico de un Motor de Impresión es abrir e imprimir los documentos. Mientras que los pasos anteriores verificaron que el documento estuviera en el lugar correcto, abrirlo comprobará que el Motor de Impresión pueda usarlo correctamente durante la impresión.

• Intenta abrir el documento. ¿Se abre o aparecen errores o mensajes?
• Si intentas imprimir el documento, ¿se imprime o aparecen errores o advertencias?

Si en cualquiera de los casos aparece un cuadro de diálogo con advertencias o errores, estos podrían estar interfiriendo con el proceso de impresión automática. La siguiente sección puede ayudarte con estos cuadros de diálogo.

Errores y cuadros de advertencia

Aunque un Motor de Impresión puede omitir la mayoría de los cuadros de diálogo, algunos hacen que la impresión se omita o falle. A veces, un Motor de Impresión no comunica correctamente esta información al registro de integración, así que revisar y estar atento a cualquier cuadro aquí puede ayudar a encontrar el problema.

Aquí tienes algunos ejemplos de cuadros de diálogo que pueden ser omitidos pero que aún podrían causar problemas en la integración:

• Cuadro de ajuste de página: Cuando una impresora tiene un tipo de papel ligeramente diferente, BarTender ajustará automáticamente la etiqueta. Si la etiqueta se ve extraña, puede deberse a una diferencia en el papel. Ajusta la etiqueta y guárdala con la impresora de la integración para evitar que aparezca este cuadro.
• Advertencia de recorte: En las primeras versiones de BarTender 2019, esta advertencia era un error que detenía la impresión. Si la impresión se detiene aquí, actualiza tu software.
• Mensaje de sustitución de fuente TrueType: este mensaje se puede desactivar en el cuadro de impresión. No se podía omitir, así que se recomienda desactivar este cuadro.

Aquí tienes algunos cuadros de diálogo que pueden hacer que la impresión se detenga y falle. También pueden aparecer en los mensajes de integración:

• Error en el cuadro de tamaño de página: Este mensaje puede aparecer mientras la integración puede cambiar automáticamente el tamaño de un documento si la plantilla está configurada a un tamaño estático o el tamaño excede las especificaciones del fabricante de tu impresora. Si esto ocurre, abre el cuadro de página yendo a Archivo > Configuración de página y revisa los detalles y configuraciones en la pestaña Página. También revisa que no haya demasiadas columnas o filas en la pestaña Diseño.
• Errores de conexión a la base de datos: Estos pueden ocurrir si un archivo de base de datos se mueve o deja de estar disponible. Restablece el vínculo usando Archivo > Configuración de conexión de base de datos y luego guarda el documento.
• La plantilla no hace referencia a campos de la base de datos: Consulta Error 3600: La plantilla no hace referencia a ningún campo de base de datos.
• Imágenes u objetos vinculados faltantes: Este error puede aparecer si las imágenes u objetos vinculados se han movido o están en una ubicación de red que ya no está disponible. BarTender no imprimirá hasta que los objetos o imágenes se vuelvan a vincular.
• Error que menciona TMP: Es probable que la etiqueta o un recurso vinculado se haya dañado. Se recomienda restaurar una copia de seguridad de la etiqueta o rehacerla.

Esta no es una lista exhaustiva, pero cubre los problemas más comunes que podrías encontrar durante la solución de problemas.

Puntos clave

• Este paso automatizado se puede revisar usando BarTender Designer.
• Los cuadros de diálogo suelen indicar cuál es el problema.

A veces, el problema no se puede encontrar directamente en el ciclo de integración. Aquí tienes algunos recursos adicionales que pueden ayudarte con situaciones diversas que no se mencionan en el artículo anterior.

General

La integración se detiene de repente

Las integraciones pueden detenerse por muchas razones, varias de las cuales se explican en el artículo anterior. La razón más común que no se menciona arriba es que el recurso de repente deja de estar disponible. Esto ocurre principalmente en integraciones de bases de datos y en integraciones de archivos que usan ubicaciones de almacenamiento en la nube. BarTender 2021 intentará reiniciar la integración cuando el recurso vuelva a estar disponible, pero las versiones anteriores simplemente detenían la integración.

Si tu integración se detiene de repente, revisa los registros para ver el error más reciente y así determinar la causa.

Integraciones de archivos

La integración funciona lentamente

Muchos factores pueden hacer que una integración de archivos funcione lentamente, pero este tipo de integración es especialmente sensible a estos factores. El tamaño de la carpeta de escaneo es importante. Como una integración de archivos depende de escanear la carpeta en busca de archivos nuevos, si la cantidad de archivos crece mucho, el escaneo tarda cada vez más a medida que se agregan más archivos a la carpeta.

Si tu integración no está configurada para eliminar o mover un archivo disparador después de procesarlo, estos archivos se irán acumulando con el tiempo. Si notas que tu integración va lenta, elimina los archivos disparadores ya procesados de la carpeta de escaneo para ver si mejora la velocidad.

Integraciones de bases de datos

Registros duplicados o impresiones múltiples

Si una integración de base de datos está escaneando una tabla y la etiqueta también está conectada a esa misma tabla, probablemente terminarás con etiquetas duplicadas. Consulta estos artículos para saber cómo solucionar esta situación y cómo configurar correctamente tu integración de base de datos y tus etiquetas:

• Se imprimen múltiples cantidades de los registros seleccionados desde una integración de base de datos 
• Imprimir documento usando disparadores de base de datos (Video - 7:27) 

La integración tarda en detectar registros

Las integraciones pueden funcionar lentamente por muchas razones, pero hay una situación particular en las integraciones de bases de datos. Una integración de base de datos escanea toda una tabla para buscar registros nuevos que coincidan con lo especificado en la sección de disparadores. Si una tabla de base de datos crece mucho, este proceso se vuelve más lento a medida que se agregan más registros, lo que genera una carga en el servidor de base de datos con cada consulta.

Se recomienda limpiar los registros no utilizados de la base de datos con un mantenimiento regular o configurar la integración para eliminar los registros después de procesarlos, para reducir la carga en la base de datos y en la integración.

Integraciones de socket

Error: No se puede acceder al objeto eliminado

Si notas que tu integración omite etiquetas, es posible que encuentres un error de "No se puede acceder al objeto eliminado" en los registros. Esto significa que el socket no se está cerrando correctamente entre trabajos. Para solucionar este problema, consulta Error de integración al ejecutar integración de socket.