Saltar al contenido

Actividad Jitterbit MQ Get

Introducción

Una actividad Jitterbit MQ Get, utilizando su conexión Jitterbit MQ, recupera un solo mensaje disponible en una cola de mensajes Jitterbit específica y está destinada a ser utilizada como fuente para proporcionar datos en una operación.

Nota

La actividad Get recupera un solo mensaje de una cola de mensajes Jitterbit. Para recuperar un lote de mensajes de una cola de mensajes Jitterbit, utiliza la actividad Get bulk.

Crear una actividad Jitterbit MQ Get

Una instancia de una actividad Jitterbit MQ Get se crea a partir de una conexión Jitterbit MQ utilizando su tipo de actividad Get.

Para crear una instancia de una actividad, arrastra el tipo de actividad al lienzo de diseño o copia el tipo de actividad y pégalo en el lienzo de diseño. Para más detalles, consulta Crear una instancia de actividad o herramienta en Reutilización de componentes.

Una actividad Jitterbit MQ Get existente se puede editar desde estas ubicaciones:

Configurar una actividad Jitterbit MQ Get

Sigue estos pasos para configurar una actividad Jitterbit MQ Get:

Paso 1: Ingresar un nombre y especificar la cola

En este paso, proporciona un nombre para la actividad y especifica la cola. Cada elemento de la interfaz de usuario de este paso se describe a continuación.

Configuración de la actividad Jitterbit MQ Get paso 1

Consejo

Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comienza escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar una lista de las variables existentes de las que elegir.

  • Nombre: Ingresa un nombre para identificar la actividad. El nombre debe ser único para cada actividad Get de Jitterbit MQ y no debe contener barras diagonales / ni dos puntos :.

  • Cola: Proporciona el nombre de la cola que contiene los mensajes a recuperar. La cola debe estar en el entorno especificado en la conexión Jitterbit MQ.

    Nota

    Asegúrate de que el nombre de la cola para el entorno especificado esté ingresado correctamente, ya que las operaciones no fallan si se ingresa un nombre de cola inválido. En su lugar, las operaciones serán exitosas y el messageCount devuelto será 0.

  • Reconocimiento automático: Selecciona para habilitar el reconocimiento automático de los mensajes recuperados. Esta opción genera una respuesta para cada mensaje reconocido y puede causar tiempos de procesamiento más largos. Si Reconocimiento automático se deja sin seleccionar, los reconocimientos explícitos (usando la actividad de reconocimiento) están limitados a 50 por entorno y 500 por organización.

    Nota

    Si Reconocimiento automático se deja sin seleccionar, los mensajes recuperados usando la actividad Get deben ser reconocidos (por la actividad de reconocimiento) o negativamente reconocidos (por la actividad NACK) antes de un tiempo de espera de 30 minutos. Una vez que haya expirado el tiempo de espera de 30 minutos, los mensajes continuarán siendo recuperados por una actividad Get o actividad de obtención masiva.

  • Guardar y salir: Si está habilitado, haga clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

  • Siguiente: Haga clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. La configuración no se guardará hasta que haga clic en el botón Finalizado en el último paso.

  • Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.

Paso 2: Revisar los esquemas de datos

Cualquier esquema de solicitud o respuesta se muestra. Cada elemento de la interfaz de usuario de este paso se describe a continuación.

Configuración de la actividad Jitterbit MQ Get paso 2

  • Esquemas de datos: Estos esquemas de datos son heredados por transformaciones adyacentes y se muestran nuevamente durante el mapeo de transformaciones.

    Information

    Si no está utilizando la opción Auto Acknowledge (especificada en paso 1), puede usar el ackId en la respuesta de la actividad Get como entrada para el esquema de solicitud de la actividad Acknowledge o la actividad NACK.

    El esquema de datos de respuesta consiste en estos nodos y campos:

    Nodo/Campo del esquema de respuesta Descripción
    messageCount El número de mensajes recuperados, ya sea 0 o 1
    messageBody El cuerpo del mensaje
    queue La cola que contiene el mensaje
    ackId El ID de reconocimiento que se utilizará en la actividad Acknowledge
    properties Nodo que contiene las propiedades del mensaje
    envelope Nodo que contiene los datos del sobre
    deliveryTag Entero del tag de entrega que se adjuntará al mensaje (utilizado en la actividad Acknowledge)
    isRedeliver Es reentregar
    appId El identificador de la aplicación que produjo el mensaje
    contentEncoding Codificación de contenido para el mensaje
    contentType El tipo de contenido del mensaje, como application/json
    correlationId El ID del mensaje correlacionado (a qué solicitud está respondiendo el mensaje)
    deliveryMode Entero que indica si el mensaje recuperado se persiste en disco (2) o es no persistente (1)
    expiration El tiempo de expiración después del cual el mensaje será eliminado (el período TTL en milisegundos según lo determinado en la configuración de la cola de mensajes)
    messageId El ID del mensaje (si las aplicaciones necesitan identificar mensajes, se recomienda que utilicen este atributo en lugar de ponerlo en la carga del mensaje)
    priority Valor entero que varía de 0 a 9 que indica la prioridad del mensaje (9 siendo la prioridad más baja)
    type Cadena que contiene el tipo de mensaje, por ejemplo, el tipo de evento o comando que representa este mensaje.
    timestamp La hora de la solicitud
    headers Nodo que contiene cualquier encabezado de mensaje
    item Nodo que contiene cada encabezado de mensaje
    name El nombre del encabezado del mensaje
    value El valor del encabezado del mensaje
  • Actualizar: Haz clic en el ícono de actualizar o en la palabra Actualizar para regenerar esquemas desde el punto final de Jitterbit MQ. Esta acción también regenera un esquema en otras ubicaciones a lo largo del proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.

  • Regresar: Haz clic para almacenar temporalmente la configuración de este paso y volver al paso anterior.

  • Terminado: Haz clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

  • Descartar Cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Siguientes pasos

Después de configurar una actividad Jitterbit MQ Obtener, completa la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de operación. También puedes configurar la configuración de la operación, que incluye la capacidad de encadenar operaciones que están en los mismos o diferentes flujos de trabajo.

Las acciones del menú para una actividad son accesibles desde el panel del proyecto y el lienzo de diseño. Para más detalles, consulta el menú de acciones de actividad en Conceptos básicos de conectores.

Las actividades Jitterbit MQ Obtener pueden ser utilizadas como fuente con estos patrones de operación:

Para utilizar la actividad con funciones de scripting, escribe los datos en una ubicación temporal y luego utiliza esa ubicación temporal en la función de scripting.

Cuando esté listo, despliegue y ejecute la operación y valide el comportamiento revisando los registros de la operación.