Actividad Jitterbit MQ Obtener en Masa
Introducción
Una actividad Jitterbit MQ Obtener en Masa, utilizando su conexión Jitterbit MQ, recupera un lote de mensajes disponibles en una cola de mensajes específica de Jitterbit y está destinada a ser utilizada como fuente para proporcionar datos en una operación.
Nota
La actividad Obtener en Masa recupera un lote de mensajes de una cola de mensajes de Jitterbit. Para recuperar un solo mensaje de una cola de mensajes de Jitterbit, utiliza la actividad Obtener.
Crear una actividad Jitterbit MQ Obtener en Masa
Una instancia de una actividad Jitterbit MQ Obtener en Masa se crea a partir de una conexión Jitterbit MQ utilizando su tipo de actividad Obtener en Masa.
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 Obtener en Masa 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 Obtener en Masa
Sigue estos pasos para configurar una actividad Jitterbit MQ Obtener en Masa:
-
Paso 1: Ingresa un nombre y especifica configuraciones
Proporciona un nombre para la actividad y especifica configuraciones. -
Paso 2: Revisar los esquemas de datos
Se muestran los esquemas de solicitud o respuesta.
Paso 1: Ingresar un nombre y especificar configuraciones
En este paso, proporciona un nombre para la actividad y especifica configuraciones. 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 Bulk 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
. -
Tamaño del Lote: Ingresa el tamaño del lote. Puedes ingresar un valor entre
1
y10000
. -
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 mediante la actividad Get Bulk 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 seguirán siendo recuperados por una actividad Get Bulk o actividad Get.
-
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.
Nota
Los datos suministrados en una transformación tienen prioridad sobre la configuración de la actividad.
Los esquemas de datos de respuesta consisten en estos nodos y campos:
Nodo/Campo del esquema de respuesta Descripción messageCount
El número de mensajes recuperados messages
Nodo que contiene los mensajes item
Nodo que contiene cada mensaje messageBody
El cuerpo del mensaje queue
La cola que contiene el mensaje ackId
El ID de reconocimiento que se utilizará en la actividad de reconocimiento 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 de reconocimiento) 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
indicando 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
El tiempo 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.
Próximos pasos
Después de configurar una actividad Jitterbit MQ Obtener en Masa, completa la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de operación. También puedes configurar los ajustes de la operación, que incluyen 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 en Masa se pueden utilizar 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 usar 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.