Conexión JMS

Introducción

Una conexión JMS, creada utilizando el conector JMS, establece acceso a proveedores de JMS. Una vez que se configura una conexión, se pueden crear instancias de actividades JMS asociadas con esa conexión para ser utilizadas como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Crear o editar una conexión JMS

Una nueva conexión JMS se crea utilizando el conector JMS desde una de estas ubicaciones:

• La pestaña Puntos finales y conectores del proyecto en la paleta de componentes de diseño (ver Paleta de componentes de diseño).
• La página de Puntos finales globales (ver Crear un punto final global en Puntos finales globales).

Una conexión JMS existente se puede editar desde estas ubicaciones:

• La pestaña Puntos finales y conectores del proyecto en la paleta de componentes de diseño (ver Paleta de componentes de diseño).
• La pestaña Componentes en el panel del proyecto (ver Menú de acciones de componentes en Pestaña de componentes del panel del proyecto).
• La página de Puntos finales globales (ver Editar un punto final global en Puntos finales globales).

Configurar una conexión JMS

Cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión JMS se describe a continuación.

La interfaz utilizada en la configuración de conexión JMS depende del Proveedor JMS seleccionado:

• Active MQ

• IBM MQ

• Personalizado

Active mq

Cuando se selecciona Active MQ como el Proveedor JMS, se presenta la interfaz descrita a continuación.

• Nombre de conexión: Ingrese un nombre para identificar la conexión. El nombre debe ser único para cada conexión JMS y no debe contener barras diagonales / ni dos puntos :. Este nombre también se utiliza para identificar el punto final JMS, que se refiere tanto a una conexión específica como a sus actividades.

• Proveedor JMS: Desde el menú, seleccione Active MQ.

• Fábrica inicial JNDI: Ingrese la fábrica inicial JNDI (Java Naming and Directory Interface).

• URL del proveedor: Ingrese la URL de conexión que se utilizará.

• Nombre de fábrica: Ingrese el nombre de la fábrica de conexión.

• Configuraciones opcionales: Haga clic para expandir una configuración adicional opcional:

  • Usar búsqueda JNDI: Seleccione para interactuar solo con colas y temas existentes especificados en una actividad. Cuando se selecciona esta opción, y la cola o tema especificado no existe, se devuelve un error por parte de la actividad. Opcionalmente, cuando esta configuración está habilitada, puede habilitar Crear destino si la búsqueda falla en la actividad de envío para crear una nueva cola o tema con el nombre especificado cuando no existe uno.

    Cuando no está seleccionada (por defecto), la actividad no verifica la existencia de una cola o tema, y se completará con éxito independientemente de si el mensaje se envió correctamente a la cola o tema especificado.

• Usar Autenticación: Seleccione para autenticar la conexión utilizando autenticación básica. Cuando se selecciona, estos campos se vuelven disponibles:

  -   **Nombre de usuario:** Ingrese el nombre de usuario para el proveedor de JMS.
  
  -   **Contraseña:** Ingrese la contraseña para el proveedor de JMS.
  
  !!! note "Nota"
      Para usar autenticación SSL/TLS con ActiveMQ, SSL debe estar configurado para el cliente JMS y un certificado debe ser agregado al almacén de claves de Java de Jitterbit (como se describe en [prerequisites](/es/integration-studio/design/connectors/jms/#prerequisites-and-supported-api-versions)). Una vez que se hayan cumplido los requisitos previos, la conexión utilizará automáticamente la autenticación SSL/TLS. Para descontinuar la autenticación SSL/TLS, debe eliminar el certificado del almacén de claves de Java de Jitterbit.
  

• Probar: Haga clic para verificar la conexión utilizando la configuración proporcionada. Cuando se prueba la conexión, la última versión del conector es descargada por el(los) agente(s) en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la Desactivar Actualización Automática del Conector política de organización.

• Guardar Cambios: Haga clic para guardar y cerrar la configuración de la conexión.

• Descartar Cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrar la configuración sin guardar. Un mensaje le pide que confirme que desea descartar los cambios.

• Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulte Component dependencies, deletion, and removal). Un mensaje le pide que confirme que desea eliminar la conexión.

IBM MQ

Cuando se selecciona IBM MQ como el Proveedor JMS, se presenta la interfaz descrita a continuación.

• Nombre de conexión: Ingrese un nombre para identificar la conexión. El nombre debe ser único para cada conexión JMS y no debe contener barras diagonales / ni dos puntos :. Este nombre también se utiliza para identificar el punto final JMS, que se refiere tanto a una conexión específica como a sus actividades.

• Proveedor JMS: Desde el menú, seleccione IBM MQ.

• URL del proveedor: Ingrese la URL de conexión que se utilizará.

• Administrador de colas: Ingrese el nombre del administrador de colas.

• Canal: Ingrese el canal conectado al administrador de colas especificado.

• Puerto: Ingrese el puerto al que está conectado el canal.

• Configuraciones opcionales: Haga clic para expandir configuraciones opcionales adicionales:

  • Usar búsqueda JNDI: Seleccione para interactuar solo con colas y temas existentes especificados en una actividad. Cuando se selecciona esta opción, y la cola o tema especificado no existe, se devuelve un error por parte de la actividad. Opcionalmente, cuando esta configuración está habilitada, puede habilitar la opción Crear destino si la búsqueda falla en la actividad de envío para crear una nueva cola o tema con el nombre especificado cuando no existe uno.

    Cuando no está seleccionada (por defecto), la actividad no verifica la existencia de una cola o tema, y se completará con éxito independientemente de si el mensaje se envió con éxito a la cola o tema especificado.

  • Usar autenticación: Seleccione para autenticar la conexión utilizando autenticación básica. Cuando se selecciona, estos campos se vuelven disponibles:

    • Nombre de usuario: Ingrese el nombre de usuario para el proveedor JMS.

    • Contraseña: Ingrese la contraseña para el proveedor JMS.

  • Usar SSL: Seleccione para autenticar la conexión utilizando el cliente de Capa de Conexión Segura (SSL). Cuando se selecciona, se presentan los campos a continuación.

    Importante

    Al usar esta opción, SSL debe estar configurado para el cliente JMS y se debe agregar un certificado al almacén de claves de Java de Jitterbit (como se describe en prerrequisitos).

    • Cifrado SSL: Ingrese el SSL CipherSpec. Para más información sobre los CipherSpecs de IBM MQ, consulte la documentación de IBM MQ.

    • Protocolo de seguridad: Desde el menú, seleccione el protocolo de seguridad a utilizar, uno de TLS, TLSv1.0, TLSv1.1 o TLSv1.2. Para más información, consulte la documentación de IBM MQ.

• Probar: Haga clic para verificar la conexión utilizando la configuración proporcionada. Cuando se prueba la conexión, la última versión del conector es descargada por el(los) agente(s) en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la política de organización Deshabilitar actualización automática del conector.

• Guardar cambios: Haga clic para guardar y cerrar la configuración de la conexión.

• Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrar la configuración sin guardar. Un mensaje le pide que confirme que desea descartar los cambios.

• Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulte Dependencias de componentes, eliminación y remoción). Un mensaje le pide que confirme que desea eliminar la conexión.

Custom

Cuando se selecciona Custom (Agente Privado Solo) como el proveedor de JMS, se presenta la interfaz descrita a continuación.

• Nombre de conexión: Ingresa un nombre para identificar la conexión. El nombre debe ser único para cada conexión de JMS y no debe contener barras diagonales / ni dos puntos :. Este nombre también se utiliza para identificar el punto final de JMS, que se refiere tanto a una conexión específica como a sus actividades.

• Proveedor de JMS: Desde el menú, selecciona Custom (Agente Privado Solo).

  Nota

  Esta opción ha sido confirmada para funcionar con los proveedores de JMS JBoss EAP, Oracle WebLogic y GlassFish. Se espera que otros proveedores de JMS funcionen, pero no han sido probados por Jitterbit.

• Fábrica inicial de JNDI: Ingresa la fábrica inicial de JNDI (Java Naming and Directory Interface).

• URL del proveedor: Ingresa la URL de conexión que se utilizará.

• Nombre de fábrica: Ingresa el nombre de la fábrica de conexión.

• Agente Privado Solo: Cuando se selecciona, muestra la tabla de Configuración adicional del proveedor, que se utiliza para agregar propiedades de configuración adicionales como pares clave-valor que se enviarán con cada solicitud de actividad:

  • Agregar: Agrega una fila a la tabla. Ingresa un par clave-valor para cada propiedad.
  • Enviar: Guarda el par clave-valor en la tabla. Visible al pasar el cursor sobre una fila en modo de edición.
  • Descartar: Descarta una nueva fila o cualquier edición realizada en una fila existente. Visible al pasar el cursor sobre una fila en modo de edición.
  • Editar: Permite editar un par clave-valor existente. Visible al pasar el cursor sobre una fila existente.
  • Eliminar: Elimina la fila de la tabla. Visible al pasar el cursor sobre una fila existente.
  • Limpiar todo: Elimina todas las filas de la tabla.

  Importante

  Los campos en la tabla Configuración adicional del proveedor muestran el ícono de variable solo en modo de edición. Para que los valores de variable de estos campos se llenen en tiempo de ejecución, la versión del agente debe ser al menos 10.75 / 11.13.

  Los campos en la tabla Configuración adicional del proveedor no admiten el uso de variables para pasar JSON sin procesar. Si su caso de uso no admite definir JSON sin procesar en los campos directamente, escape el contenido JSON antes de pasarlo con una variable. Por ejemplo, escapar {"success": "true"}; se convierte en {\"success\": \"true\"};.

• Configuraciones opcionales: Haga clic para expandir una configuración adicional opcional:

  • Usar autenticación: Seleccione para autenticar la conexión utilizando autenticación básica. Cuando se selecciona, estos campos se vuelven disponibles:

    • Nombre de usuario: Ingrese el nombre de usuario para el proveedor JMS.

    • Contraseña: Ingrese la contraseña para el proveedor JMS.

• Probar: Haga clic para verificar la conexión utilizando la configuración proporcionada. Cuando se prueba la conexión, la última versión del conector es descargada por el(los) agente(s) en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la Desactivar actualización automática del conector política de organización.

• Guardar cambios: Haga clic para guardar y cerrar la configuración de la conexión.

• Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrar la configuración sin guardar. Un mensaje le pide que confirme que desea descartar los cambios.

• Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (ver Dependencias de componentes, eliminación y remoción). Un mensaje le pide que confirme que desea eliminar la conexión.

Próximos pasos

Después de que se ha creado una conexión JMS, se coloca un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se utilizarán como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Las acciones del menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulta los menús de acciones en Conceptos básicos de conectores.

Estos tipos de actividad están disponibles:

• Reconocer: Envía un reconocimiento masivo de mensajes JMS y está destinado a ser utilizado como un destino en una operación.

• Obtener: Recupera todos los mensajes JMS disponibles en una cola específica y está destinado a ser utilizado como una fuente en una operación.

• Consumir: Consume mensajes de una cola o tema JMS y está destinado a ser utilizado como una fuente en una operación.

• Enviar: Envía mensajes a una cola o tema JMS y está destinado a ser utilizado como un destino en una operación.