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:
- El lienzo de diseño (consulta Menú de acciones de componentes en Lienzo de diseño).
- La pestaña Componentes del panel del proyecto (consulta Menú de acciones de componentes en Pestaña de componentes del panel del proyecto).
Configurar una actividad Jitterbit MQ Get
Sigue estos pasos para configurar una actividad Jitterbit MQ Get:
-
Paso 1: Ingresa un nombre y especifica la cola
Proporciona un nombre para la actividad y especifica la cola. -
Paso 2: Revisar los esquemas de datos
Se muestran los esquemas de solicitud o respuesta.
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.
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.
-
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
o1
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
a9
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:
- Patrón de transformación
- Patrón de archivo de dos objetivos (como la primera fuente únicamente)
- Patrón de archivo HTTP de dos objetivos (como la primera fuente únicamente)
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.