Jitterbit MQ (Beta) Obtener Actividad¶
Introducción¶
Una actividad Jitterbit MQ (Beta) Get, utilizando su conexión Jitterbit MQ (Beta), recupera un solo mensaje disponible en un Jitterbit cola de mensajes específico y está destinado a ser utilizado como fuente para proporcionar datos en una operación.
Nota
La actividad Obtener recupera un solo mensaje de una cola de mensajes Jitterbit. Para recuperar un lote de mensajes de una cola de mensajes de Jitterbit, use Obtener actividad masiva.
Este conector se publica actualmente como una versión beta. Para proporcionar comentarios sobre errores y mejoras, comuníquese con su Gerente de Éxito del Cliente (CSM).
Crear una Actividad de Obtención de Jitterbit MQ (Beta)¶
Se crea una instancia de una actividad Jitterbit MQ (Beta) Get a partir de una conexión de Jitterbit MQ (Beta) utilizando su tipo de actividad Get.
Para crear una instancia de una actividad, arrastre el tipo de actividad al tela de diseño o copie el tipo de actividad y péguelo en el tela de diseño. Para obtener más información, consulte Creación de una instancia de actividad en Reutilización de componentes.
Una actividad Get existente de Jitterbit MQ (Beta) se puede editar desde estas ubicaciones:
- El tela de diseño (vea Menú de acciones de componentes en Tela de Diseño).
- La pestaña Componentes del panel del proyecto (vea Menú de acciones de componentes en Ficha Componentes del panel Proyecto).
Configurar una Actividad de Obtención de Jitterbit MQ (Beta)¶
Siga estos pasos para configurar una actividad Get de Jitterbit MQ (Beta):
-
Paso 1: Introduzca un nombre y especifique la cola
Proporcione un nombre para la actividad y especifique la cola. -
Paso 2: revisar los esquemas de datos
Se muestra cualquier esquema de solicitud o respuesta.
Paso 1: Ingrese un Nombre y Especifique la Cola¶
En este paso, proporcione un nombre para la actividad y especifique la cola. Cada elemento de la interfaz de usuario de este paso se describe a continuación.
Consejo
Campos con un icono de variable admite el uso de variables globales, variables del proyecto, y variables de jitterbit. Comience escribiendo un corchete abierto
[
en el campo o haciendo clic en el icono de variable para mostrar una lista de las variables existentes para elegir.
-
Nombre: Introduzca un nombre para identificar la actividad. El nombre debe ser único para cada actividad Get de Jitterbit MQ (Beta) y no debe contener barras inclinadas
/
o dos puntos:
. -
Cola: Proporcione el nombre de la cola que contiene los mensajes que se recuperarán. La cola debe estar en el ambiente especificado en la conexión Jitterbit MQ (Beta).
-
Reconocimiento automático: Seleccione 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 no se selecciona, los reconocimientos explícitos (utilizando la Actividad de reconocimiento) están limitadas a 50 por ambiente y 500 por organización.
Nota
Si Reconocimiento automático no se selecciona, los mensajes recuperados usando la actividad Obtener deben ser reconocidos (mediante la Actividad de reconocimiento) o reconocido negativamente (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 Get o Get Bulk activity.
-
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 para este paso y continuar con el próximo paso. La configuración no se guardará hasta que haga clic en el botón Terminado en el último paso.
-
Descartar cambios: Después de realizar los 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¶
Se muestra cualquier esquema de solicitud o respuesta. 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 de nuevo durante mapeo de transformación.
Información
Si no está utilizando la opción Reconocimiento automático (especificada en paso 1), puede utilizar el
ackId
en la respuesta de la actividad Obtener como entrada para la Actividad de reconocimiento o actividad NACK el esquema de solicitud.El esquema de datos de respuesta consta de estos nodos y campos:
Nodo/campo de 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 usará en la Actividad de reconocimiento properties
Nodo que contiene las propiedades del mensaje envelope
Nodo que contiene los datos del sobre deliveryTag
Entero de la etiqueta de entrega para adjuntar al mensaje (usado en la Actividad de reconocimiento) isRedeliver
es volver a entregar 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 responde el mensaje) deliveryMode
Entero que indica si el mensaje recuperado se guarda en el disco ( 2
) o no persistente (1
)expiration
El tiempo de caducidad después del cual se eliminará el mensaje (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 incluirlo en la carga útil del mensaje) priority
Valor entero que va desde 0
a través de9
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 momento de la solicitud headers
Nodo que contiene encabezados de mensajes 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 icono de actualización
o la palabra Actualizar para regenerar esquemas desde el extremo de Jitterbit MQ (Beta). Esta acción también regenera un esquema en otras ubicaciones del proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.
-
Atrás: Haga clic para almacenar temporalmente la configuración de este paso y volver al paso anterior.
-
Terminado: Haga clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.
-
Descartar cambios: Después de realizar los 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.
Próximos Pasos¶
Después de configurar una actividad Jitterbit MQ (Beta) Get, complete la configuración de la operación agregando y configurando otras actividades, transformaciones o secuencias de comandos como pasos de la operación. También puede configurar los ajustes de operación, que incluyen la capacidad de encadenar operaciones que se encuentran en el mismo flujos de trabajo o en uno diferente.
Se puede acceder a las acciones de menú para una actividad desde el panel del proyecto y el tela de diseño. Para obtener más información, consulte Menú de acciones de actividad en Conceptos básicos del conector.
Las actividades Get de Jitterbit MQ (Beta) se pueden usar como fuente con estos patrones de operación:
- Patrón de transformación
- Patrón de archivo de dos objetivos (solo como primera fuente)
- Patrón de archivo HTTP de dos objetivos (solo como primera fuente)
Un caso de uso típico es usar una actividad Jitterbit MQ (Beta) Get en el Patrón de transformación. En este ejemplo, la actividad Jitterbit MQ (Beta) Get genera una estructura de respuesta que recibe la transformación (Get Response), que luego se escribe en una variable mediante una actividad Variable Write (Write Get Response) y luego se registra un mensaje mediante el secuencia de comandos Write to Operation Log:
Para usar la actividad con funciones de secuencias de comandos, escriba los datos en una ubicación temporal y luego use esa ubicación temporal en la función de secuencias de comandos.
Cuando esté listo, desplegar y ejecutar la operación y validar el comportamiento comprobando los registros de operación.