Saltar al contenido

Conector JMS en Jitterbit Studio

Resumen

El conector JMS establece acceso a proveedores de JMS (Java Message Service).

El conector JMS proporciona una interfaz para crear una conexión JMS, la base utilizada para generar instancias de actividades JMS. Estas actividades, una vez configuradas, interactúan con proveedores JMS a través de la conexión.

Se accede al conector JMS desde la pestaña Endpoints y conectores del proyecto de la paleta de componentes de diseño (consulta Paleta de componentes de diseño).

Descripción general del conector

Este conector se utiliza primero para configurar una conexión JMS. Los tipos de actividad asociados a esa conexión se utilizan luego para crear instancias de actividades que se pretende utilizar como orígenes (para proporcionar datos en una operación) o destinos (para consumir datos en una operación).

En conjunto, una conexión JMS específica y sus actividades se denominan endpoint JMS:

Tipos de actividad JMS

  • Acknowledge: Envía un reconocimiento masivo de mensajes JMS y se pretende utilizar como destino en una operación.

  • Get: Recupera todos los mensajes JMS disponibles en una cola específica y se pretende utilizar como origen en una operación.

  • Consume: Consume mensajes de una cola o tema JMS y se pretende utilizar como origen en una operación.

  • Send: Envía mensajes a una cola o tema JMS y se pretende utilizar como destino en una operación.

Los endpoints creados con este conector se incluyen en reportes de uso de endpoints y cuentan hacia tu licencia.

Requisitos previos y versiones de API compatibles

Este conector se puede utilizar con agentes en la nube y agentes privados.

Los agentes descargan automáticamente la versión más reciente de este conector cuando es necesario. En agentes privados, puedes suspender estas actualizaciones con la política de organización Disable Auto Connector Update.

Se requiere un agente privado de Jitterbit en estas circunstancias:

  • Cuando se utiliza autenticación SSL/TLS para una conexión ActiveMQ.

  • Cuando se utiliza IBM MQ como proveedor JMS. Se admiten las versiones 9.2, 9.3 y 9.4 de IBM MQ. Es posible que otras versiones de IBM MQ también funcionen, pero no han sido probadas por Jitterbit.

  • Cuando se utiliza un proveedor JMS personalizado.

El conector JMS es compatible con la especificación Java Message Service 1.1.

Autenticación

El conector JMS admite tanto autenticación básica como autenticación SSL/TLS. Para utilizar SSL/TLS a fin de autenticar la conexión, el cliente JMS debe estar configurado para usar SSL/TLS y debes agregar un certificado en formato PKCS #12 al almacén de claves Java de Jitterbit (consulta agregar certificados al almacén de claves para agentes privados).

Nota

Una vez que se cumplan los requisitos previos, una conexión ActiveMQ utilizará automáticamente SSL/TLS. Para dejar de utilizar SSL/TLS en la conexión, debes eliminar el certificado del almacén de claves Java de Jitterbit. Una conexión IBM MQ requiere configuración adicional en su conexión.

Para obtener información sobre cómo configurar tu intermediario de mensajes para utilizar autenticación SSL/TLS, consulta la documentación del proveedor JMS:

Para obtener información sobre cómo obtener un certificado en formato PKCS #12, consulta la documentación del proveedor de JMS:

Solución de problemas

Si experimentas problemas con el conector JMS, se recomiendan estos pasos para la solución de problemas:

  1. Haz clic en el botón Test en la configuración de conexión para asegurar que la conexión sea exitosa y para descargar la versión más reciente del conector en el agente (a menos que uses la política de organización Disable Auto Connector Update).

  2. Revisa los registros de operación para obtener información escrita durante la ejecución de la operación.

  3. Habilita el registro de depuración de operación (para agentes en la nube o para agentes privados) para generar archivos de registro y datos adicionales.

  4. Si usas agentes privados, puedes habilitar el registro detallado del conector para este conector agregando esta entrada de configuración de registrador al archivo logback.xml de tu agente privado:

    <logger name="org.jitterbit.connector.sdkjms" level="DEBUG"/>

    Para obtener más información sobre el registro detallado del conector, consulta Registro detallado para conectores que usan agentes privados de Jitterbit.

  5. Si usas agentes privados, puedes revisar los registros del agente para obtener más información.

  6. Para consideraciones adicionales sobre la solución de problemas, consulta Solución de problemas de operación.