Para saber más sobre los desencadenadores en general, consulte el tema Comprender los desencadenadores.

El desencadenador en la nube le permite integrar la solución NiceLabel Cloud o el Control Center en su instalación con los sistemas empresariales existentes que se ejecutan en nubes privadas o en centros de datos específicos. Si un sistema empresarial existente (p. ej.: SAP S/4HANA u Oracle NetSuite) genera una salida, una API alojada en la nube lo habilita a enviar solicitudes HTTP al desencadenador en la nube.

El desencadenador en la nube le permite imprimir localmente etiquetas cuyo contenido se origine desde los sistemas de información en la nube. Debido a que el desencadenador en la nube que se ejecuta en el servidor Automation local usa métodos estándar para acceder a los servicios basados en la nube, puede implementar la impresión local de forma segura y en un plazo eficiente.

El desencadenador en la nube permite una forma segura y transparente de integrar su impresión local de etiquetas utilizando aplicaciones que se comunican por la Internet abierta.

En comparación con el desencadenador del servidor HTTP, el desencadenador en la nube no requiere que abra ningún puerto de entrada en su firewall. El desencadenador en la nube utiliza una API de NiceLabel específica que se ejecuta en la nube. Por esta razón, el desencadenador solo requiere abrir el puerto de salida 443 o los puertos 9350-9354. En la mayoría de los casos, estos puertos ya están abiertos.

Implementación del desencadenador en la nube con Control Center en su instalación

Configurar el desencadenador en la nube en Automation Builder

Esta sección describe cómo configurar el desencadenador en la nube en Automation que se ejecuta en su servidor local.

Abra su Automation Builder. Asegúrese de que Automation Builder esté sincronizado con su Control Center. Para verificar, vaya a Archivo > Opciones > Control Center y vea si la dirección URL de su Control Center está allí.

Nota

"Paired" Automation Builder y Control Center también significa que ambas aplicaciones usan la misma clave de licencia.

Se abre la pestaña Elementos de configuración. Haga clic en Desencadenador en la nube para crear una nueva configuración para el desencadenador en la nube.

General pestaña
  1. Configure el Nombre y la Descripción para hacer que el desencadenador en la nube pueda buscar fácilmente entre otros desencadenadores.

  2. Establezca los ajustes de Comunicación del desencadenador:

    • Defina el Identificador único. Después de implementar el desencadenador, este identificador único registra el desencadenador en su Control Center. Use sólo caracteres alfa numéricos. No se permiten los caracteres especiales.

      Si está ejecutando la configuración de activación de la nube en varias computadoras, debe asegurarse de que cada computadora utilice su propio identificador único de forma automática. Para evitar duplicaciones no deseadas, inserte variables internas como parte del Identificador único. Para esto, puede usar dos variables internas:

      • ComputerName: El nombre de la computadora en la que se ejecuta la configuración.

      • SystemUserName: El nombre de usuario de Windows del usuario actualmente conectado.

      Para insertar variables internas en el Identificador único, haga clic en Insertar origen de datos y seleccione sus variables internas.

      UUID-7905238a-2b2d-69c4-9856-247bdcb0320c.png
    • Esperar a que termine la ejecución del desencadenador: El protocolo HTTP requiere que el receptor (en este caso NiceLabel Automation) envíe una respuesta numérica al remitente para indicar el estado del mensaje recibido. De manera predeterminada, NiceLabel Automation responde con el código 200. Esto indica que Automation recibió correctamente los datos, pero no da información acerca del éxito de las acciones del desencadenador.

      Esta opción especifica que un desencadenador no envía una respuesta inmediatamente después de recibir los datos, sino que espera hasta que la acción se ejecute. Luego, envía el código de respuesta indicando una ejecución de la acción exitosa. Cuando esta opción está habilitada, puede enviar un tipo de respuesta y datos personalizados (por ejemplo, la respuesta a una solicitud HTTP es una vista previa de etiqueta en formato PDF).

      Con el desencadenador en la nube, los Automation códigos de respuesta HTTP estándares relevantes integrados son:

      Código de respuesta HTTP

      Descripción

      200

      Todas las acciones ejecutadas correctamente.

      400

      No hay configuración disponible.

      500

      Se produjeron errores durante la ejecución de la acción.

      Nota

      Para enviar comentarios a Automation acerca del proceso de impresión, habilite el modo de impresión sincrónico. Para obtener más información, consulte el tema Modo de impresión sincronizada.

    • Tipo de respuesta: Especifica el tipo de mensaje de respuesta. Los tipos de medios de Internet utilizados frecuentemente (también denominados "tipos MIME" o "tipos de contenido") se predefinen en la casilla desplegable. Si su tipo de medio no está disponible en la lista, ingréselo usted mismo. Automation envía los datos de respuestas de salida como comentario, con formato en el tipo de medio definido. Variable habilita los tipos de medio variables. Si se habilita, seleccione o cree una variable que contenga el tipo de medio.

      Nota

      Si no especifica el tipo de contenido, NiceLabel Automation utilizará application/octet-stream como opción predeterminada.

    • Datos de respuesta: Especifica el contenido de su mensaje de respuesta. Algunos ejemplos de lo que puede enviar como una respuesta HTTP: mensajes de error personalizados, vista previa de etiqueta, archivos PDF generados, archivo de secuencia de impresión (archivo de cola de impresión), archivo XML con detalles del motor de impresión más la vista previa de etiqueta (codificada como cadena Base64).

      Si enviará contenido únicamente binario (como una vista previa de etiqueta o secuencia de impresión), asegúrese de seleccionar el tipo de medio compatible; por ejemplo, image/jpeg o application/octet-stream.

    • Encabezados adicionales: Le permiten definir encabezados personalizados tipo MIME para el mensaje de respuesta HTTP.

      Encontrará la sintaxis del encabezado de la respuesta y ejemplos en la sección acción Solicitud HTTP.

      Sugerencia

      Con los datos de la respuesta y los Encabezados adicionales, puede utilizar contenido fijo, una combinación de contenido fijo y variable, o contenido únicamente variable. Para insertar contenido variable, haga clic en el botón con flecha que se encuentra a la derecha del área de datos e inserte una variable de la lista. También puede crear una nueva variable que contenga los datos que desea usar. Para obtener más información, consulte la sección Usar valores compuestos.

Otro pestaña

Las opciones en la sección Comentarios del motor de impresión especifican los parámetros de comunicación que le permiten recibir comentarios del motor de impresión.

  • Impresión supervisada: Activa el modo de impresión sincronizada. Utilícela siempre que quiera enviar el estado del trabajo de impresión a una aplicación de terceros. Para obtener más información, consulte el tema Modo de impresión sincronizada.

Las opciones en la sección Procesamiento de datos especifican si quiere recortar los datos para que entren en la variable o ignorar las variables de las etiquetas faltantes. En forma predeterminada, notificará los errores e interrumpirá el proceso de impresión si intenta guardar valores muy largos en la variable de la etiqueta o intenta configurar valores para variables de etiquetas no existentes.

  • Ignorar exceso de contenido de variables: trunca los valores de datos que exceden la longitud de la variable tal lo definido en el diseñador de etiquetas para que se ajusten. Esta opción está en efecto cuando se configuran valores de variables en los filtros, desde los archivos de comandos y cuando se configuran valores de variables de desencadenadores para las variables de etiquetas del mismo nombre.

    Ejemplo 26. Ejemplo

    La variable de la etiqueta acepta 5 caracteres como máximo. Con esta opción habilitada, cualquier valor de más de cinco caracteres se trunca a los primeros cinco caracteres. Si el valor es 1234567 ignora los dígitos 6 y 7.


  • Ignorar variables de etiquetas faltantes: Al imprimir con archivos de comandos (como un archivo JOB), el proceso de impresión ignora todas las variables que están:

    • especificadas en el archivo de comandos (que usan el comando SET)

    • no definidas en la etiqueta

    Lo mismo sucede si define el área de asignación en un filtro para que extraiga todos los pares nombre-valor, pero su etiqueta contiene menos variables.

    Al configurar valores de variables de etiquetas no existentes, informo un error. Si esta opción está habilitada la impresión continúa.

Las opciones en la sección Secuencia de comandos especifican las posibilidades de las secuencias de comandos.

  • Idioma de secuencias: Selecciona el idioma de secuencias para el desencadenador. Todas las acciones Ejecutar secuencia de comandos que utiliza dentro de un solo desencadenador usan el idioma de secuencia de comandos. seleccionado.

Las opciones en la sección Guardar datos recibidos especifican los comandos disponibles para los datos recibidos por el desencadenador.

  • Guardar datos recibidos por el desencadenador en el archivo: Habilite esta opción y guarde los datos recibidos por el desencadenador. La opción Variable habilita un nombre de archivo variable. Seleccione una variable que contenga la ruta y el nombre de archivo.

  • Al guardar datos recibidos por el desencadenador en el archivo: Habilite esta opción para guardar los datos en el desencadenador sólo si se produce un error durante la ejecución de la acción. Puede activar esta opción para mantener los datos que causaron el problema listos para resolver el problema más adelante.

    Nota

    Asegúrese de habilitar el soporte para impresión supervisada. De lo contrario, no puede detectar errores durante la ejecución. Para obtener más información, consulte el tema Modo de impresión sincronizada.

    Nota

    guarda los datos recibidos en un archivo temporal. Este archivo temporal se elimina inmediatamente después de que se completa la ejecución del desencadenador. La variable interna DataFileName hace referencia a ese nombre de archivo. Para obtener más información, consulte el tema Variables internas.

Seguridad pestaña
  • Bloquear y cifrar desencadenador: Habilita la protección del desencadenador. Si lo habilita, el desencadenador queda bloqueado y usted ya no puede editarlo. Esto cifra las acciones. Únicamente el usuario que tenga una contraseña puede desbloquear el desencadenador y modificarlo.

Disparador de inicio

Implemente e inicie el desencadenador en Automation Manager. El desencadenador en la nube ahora supervisa las solicitudes entrantes.

Nota

Si su configuración requiere mayor disponibilidad y escalabilidad, puede implementar múltiples desencadenadores en la nube idénticos. Para esto, instale múltiples instancias de Automation, e implemente los desencadenadores en la nube en ellos. Si los desencadenadores en la nube implementados comparten el mismo Identificador único, el equilibrador de carga integrado en NiceLabel Cloud distribuye automáticamente la carga detrás entre ellos.

Configurar acceso al desencadenador en la nube para el integrador externo

Nota

Para configurar el acceso del integrador al desencadenador en la nube, debe tener el privilegio de Gestionar integraciones en la nube en Control Center en la nube. Consulte la Control Centerguía del usuario para conocer detalles sobre cómo administrar los privilegios de usuario.

  1. Vaya a Aplicaciones > Integraciones en la nube.

  2. Haga clic en +Agregar. Esto abre la página Integradores de desencadenador.

  3. Escriba el Nombre del integrador que está agregando actualmente.

    UUID-48984233-2f5c-3b15-04d2-a284439f7360.png
  4. Copie la Clave.

  5. Haga clic en Guardar.

Nota

Para conocer más detalles, lea la sección Desencadenadores en la nube de su Control Center guía del usuario.

Llamada al desencadenador en la nube (implementación en el sitio)

Este paso garantiza que las salidas de los sistemas empresariales externos ejecuten correctamente desencadenadores en la nube que se ejecutan localmente. Este es el propósito de la operación CloudTrigger. En la URL de la llamada, especifique el nombre del desencadenador al que está llamando.

Para llamar al desencadenador con su identificador único MyCloudTrigger, llame a esta URL:

https://<YourServerName>/epm/api/trigger/<MyCloudTriggerID>

Nota

La URL puede comenzar con "http" o "https", dependiendo de cómo configure su Control Center durante la instalación. Consulte la guía de instalación de Control Center, las secciones Configurar el sitio web y el almacenamiento para obtener más detalles.

Para cada evento (salida) en el sistema empresarial externo, llame a la URL como se muestra en el ejemplo. Cada llamada ejecuta el desencadenador en la nube que se ejecuta en el servidor localAutomation.

Todas las llamadas deben incluir el encabezado llamado Integrator-Key.

Nota

Puede obtener la Clave del integrador en su Control Center. Consulte el tema «Configuración de cuentas en el Portal de desarrolladores», del tema Integraciones en la nube.

Ejemplo 27. Ejemplo

Integrator-Key: 9d59d7d444da412b8acfb488a01bb632