Official translation unavailable. Translate this page with Google:

Información de nivel de producto

Requiere una suscripción a NiceLabel Cloud.

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

Lea más sobre NiceLabel Label Cloud aquí.

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.

Al implementar el desencadenador en la nube, tiene dos opciones:

Ambas opciones son iguales en términos de las funcionalidades que ofrecen. Elija la opción de su preferencia en función de la infraestructura de la que dispone.

Implementación del desencadenador en la nube con NiceLabel Cloud

Etapas de implementación de NiceLabel Cloud

Para habilitar la impresión de etiquetas local utilizando el desencadenador en la nube implementado en NiceLabel Cloud, debe establecer cooperación entre usuarios con tres roles: un usuario que configure el desencadenador en la nube en el servidor Automation local (desarrollador), un usuario que configure el desencadenador en la nube en el NiceLabel Cloud y un usuario que lleve a cabo la suscripción en el Portal de desarrolladores.

UUID-4a7834ab-e9e3-d7ac-d0fd-c550f1520e0e.png
  1. El desarrollador configura e implementa la configuración del desencadenador en la nube en el servidor Automationlocal utilizando Automation Builder y Automation Manager.

    Nota

    NiceLabel Automationdebe haber iniciado sesión en el NiceLabel Cloud.

  2. El NiceLabel Cloud administrador le permite al integrador externo acceder al desencadenador en la nube en Control Center. Una vez hecho esto, el NiceLabel Cloud administrador envía al integrador externo la clave del integrador correspondiente.

  3. El integrador externo se une al Portal de desarrolladores para integrar al sistema empresarial del cliente y el NiceLabel Cloud.

    Nota

    El Portal de desarrolladores hospeda la API exclusiva llamada Desencadenador en la nube. Esta API sirve como punto de interconexión entre los eventos que se producen en el sistema empresarial del cliente y la Automation configuración que se ejecuta localmente.

    Nota

    El término "externo" significa que la función de este usuario es llevar a cabo la suscripción en el Portal de desarrolladores. La suscripción creada autentica al integrador. Los integradores externos no necesariamente son colaboradores externos. Pueden ser integradores internos que pertenezcan al equipo de desarrollo de la compañía.

    El integrador externo realiza las siguientes acciones en el Portal de desarrolladores:

    1. Iniciar sesión en el Portal de desarrolladores. Antes de iniciar sesión por primera vez, el integrador también debe finalizar el procedimiento de inscripción.

    2. Crear una suscripción para la API del desencadenador en la nube.

    3. Conectar la suscripción con la clave del integrador. Así es como la suscripción por tiene acceso a los desencadenadores en la nube del cliente.

      Para conocer más detalles, consulte la sección Configurar la NiceLabel Cloud API en el Portal de desarrolladores.

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.

  1. Abra su Automation Builder. Asegúrese de que Automation Builder haya iniciado sesión en NiceLabel Cloud. Diríjase a Archivo > Acerca de > NiceLabel CloudCuenta para confirmar que ha iniciado sesión.

  2. 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.

  3. Configure el Nombre y la Descripción para hacer que el desencadenador en la nube pueda buscar fácilmente entre otros desencadenadores.

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

    • Defina el Identificador único. Después de implementar el desencadenador, este identificador único se necesita para llamarlo.

      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.

      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.

  5. 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. Diríjase a su nube Control Center. Abra el explorador y escriba:

    https://<yourlabelcloudname>.onnicelabel.com/dashboard.
  2. Vaya a Aplicaciones > Integraciones en la nube.

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

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

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

  6. Haga clic en Guardar.

  7. Dirija el integrador externo al Portal de desarrolladores. Envíe la siguiente información al integrador externo:

    • Enlace a la NiceLabel Cloud API de : https://developerportal.onnicelabel.com/

    • La clave del integrador (ver paso 5).

    • El identificador único del desencadenador. Puede encontrar este Identificador único en la configuración de Automationdel desencadenador en la nube (ver paso 4 en la sección). Configurar el desencadenador en la nube en Automation Builder.

    Nota

    El integrador externo necesita la clave para autenticarse para llamar al desencadenador en la nube del cliente.

Nota

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

Crear suscripción en el Portal de desarrolladores

Después de recibir la información requerida de parte del administrador deNiceLabel Cloud, el integrador externo primero debe inscribirse en el Portal de desarrolladores y crear suscripciones (para cada cliente) para llamar a los desencadenadores. Las llamadas de estos desencadenadores se originan en los sistemas de información basados en la nube de los clientes.

Nota

Si no ve el correo electrónico del Portal de desarrolladores en su Bandeja de entrada, revise su carpeta de correo no deseado.

Nota

Los clientes son empresas que ejecutan configuraciones de desencadenadores en la nube que reciben los datos de sistemas de información externos.

Nota

Cada integrador puede llamar a varios desencadenadores en la nube con una sola suscripción.

  1. Abra su explorador y vaya a https://developerportal.onnicelabel.com/

  2. Para completar el procedimiento inscripción, siga las instrucciones en pantalla. Una vez que haga clic en Inscribirse, recibirá un correo electrónico de confirmación. Haga clic en el vínculo de confirmación para activar su cuenta en el Portal de desarrolladores.

  3. Abra la pestaña Productos y haga clic en Label Cloud. La página a la que accederá contiene sus API y sus suscripciones existentes.

  4. Haga clic en Agregar suscripción. Se abre la página Suscribirse al producto.

    Nota

    Puede crear múltiples suscripciones. Sin embargo, para un solo cliente se puede usar una sola suscripción. Es por esta razón que recomienda que NiceLabel incluya el nombre del cliente en el Nombre de suscripción, por ejemplo Cliente de ejemplo de desencadenador en la nube.

  5. Escriba el Nombre de suscripción.

  6. Haga clic en Confirmar. La suscripción recién creada queda disponible en Productos > Label Cloud.

  7. Cuando vuelva a estar en la página de Label Cloud, haga clic en la Developer Sign Up API v1.

  8. Haga clic en Probar. Se abre la página de API.

    UUID-233e0250-4199-27da-0968-e7275329f997.png
  9. Inserte la Clave del integrador del de la nube del clienteControl Center.

  10. Haga clic en Enviar.

    • La respuesta es: Subscription <your subscription key> successfully associated with integrator key <integrator key value>.

    Nota

    Recibió la clave del integrador de parte del NiceLabel Cloud administrador. La clave se ve así: 979d7be5df2b473193ac5519f94cd901

    Ejemplo 26. Ejemplo

    Al pasar la clave de integración como parámetro de consulta, la URL se ve así: https://labelcloudapi.onnicelabel.com/SignUpApi/DeveloperSignup?integratorKey=979d7be5df2b473193ac5519f94cd901.


    Una vez que haga esta llamada usando la URL como se muestra en el ejemplo, la operación DeveloperSignup une la suscripción con el cliente asignado. Así es como el integrador se autentica cuando llama al desencadenador en la nube que se ejecuta enAutomation del cliente.

    Las suscripciones conectadas también son visibles en el Control Center en la nube. Compruebe si el integrador externo ha conectado su suscripción en Aplicaciones > Integraciones en la nube. La integración en la nube debe tener suscrito el estado Desarrollador [nombre, dirección de correo electrónico].

Llamada al desencadenador en la nube (implementación en NiceLabel Cloud)

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 el identificador únicoMyCloudTrigger, llame a esta URL:

https://labelcloudapi.onnicelabel.com/TriggerApi/CloudTrigger/MyCloudTrigger

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 de API deben incluir estos dos encabezados:

  • Versión de API es la versión de la API que está usando. Actualmente, la única versión de API disponible es v1.

  • Ocp-Apim-Subscription-Key es la clave que identifica su suscripción.

Probar llamadas a CloudTrigger

Para familiarizarse con la forma en que funcionan las llamadas a CloudTrigger, el Portal de desarrolladores le permite probar dichas llamadas.

Antes de que pueda hacer esta llamada, debe establecer una Automation configuración que se esté ejecutando.

  1. Abra el Portal de desarrolladores, abra la pestaña Productos y haga clic en Label Cloud.

  2. Seleccione Cloud Trigger API v1.

  3. Crear un ejemplo de métodos GET o POST. Haga clic en el vínculo correspondiente.

    • Una vez que selección el método, haga clic en Probar . Se abre una nueva página. El triggerID ya está agregado en los Parámetros de consulta.

    • En el campo Valor, copie y pegue el triggerID que recibe del desarrollador de la configuración de Automation. Este es el Identificador único del desencadenador. El Identificador único está disponible en Automation Builder > Configuración el desencadenador > General.

      UUID-b2a4eb67-50bc-91d5-4b8c-709a50ee1587.png
  4. En Autorización, seleccione la clave de suscripción. Debido a que usted ya tiene al menos una suscripción definida, la lista desplegable ya contiene la clave para la suscripción definida. Seleccione esta clave - ya sea primaria o secundaria.

  5. Haga clic en Enviar.

    • El estado de respuesta es 200 OK.

Verifique rápidamente si el desencadenador en la nube funciona

Una vez que haya configurado la API de su NiceLabel Cloud en el Portal de desarrolladores, puede realizar una configuración simple en Automation Builder para verificar si el desencadenador en la nube funciona. Si el desencadenador funciona, recibirá el mensaje "Trigger works ok" (El desencadenador funciona correctamente) en la página API del desencadenador en la nube después de hacer clic en Probar.

  1. Abra Automation Builder y cree una nueva configuración. Asegúrese de que Automation Manager esté conectado a NiceLabel Cloud.

  2. Agregue un nuevo Desencadenador en la nube.

  3. Defina el Nombre y la Descripción, y establezca el Identificador único. En este caso, usemos el TestCloudTrigger Identificador único.

  4. Habilite Esperar a que termine la ejecución del desencadenador. Esto le permite rastrear las respuestas del desencadenador.

    • Seleccione text/plain como Tipo de respuesta.

    • Defina los Datos de respuesta. Esto es lo que recibe si el desencadenador funciona. Utilicemos la siguiente cadena: "Trigger works ok." (El desencadenador funciona correctamente.)

    • Defina los Encabezados adicionales. Use el formato Heading:Value.

  5. Implemente la configuración.

  6. Abra el Portal de desarrolladores y vaya a la página Cloud Trigger API v1.

  7. Haga clic en Probar.

  8. Pegue TestCloudTrigger en el campo triggerID. Haga clic en Enviar.

    • El contenido de la respuesta incluye la confirmación: "Trigger works ok." (El desencadenador funciona correctamente.)

      UUID-7a2db5bb-633b-5b19-e8f2-16e863b1d8b3.png

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.

  1. 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.

  2. 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.

  3. Configure el Nombre y la Descripción para hacer que el desencadenador en la nube pueda buscar fácilmente entre otros desencadenadores.

  4. 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.

  5. 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.

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.

Ejemplo 27. Ejemplo

Integrator-Key: 9d59d7d444da412b8acfb488a01bb632