Actividad de obtención de Jitterbit MQ

Introducción

Una actividad Get de Jitterbit MQ, que utiliza su conexión Jitterbit MQ, recupera un único mensaje disponible en un Jitterbit específico cola de mensajes y está destinado a ser utilizado como fuente para proporcionar datos en una operación.

Nota

La actividad Obtener recupera un solo mensaje de un Jitterbit cola de mensajes. Para recuperar un lote de mensajes de un Jitterbit cola de mensajes, utilice la opción Obtener actividad masiva.

Crear una actividad Get de Jitterbit MQ

Se crea una instancia de una actividad Get de Jitterbit MQ desde una conexión Jitterbit MQ utilizando su tipo de actividad Obtener.

Para crear una instancia de una actividad, arrastre el tipo de actividad al tela de diseño de tela de diseño o cópielo y péguelo en él. Para obtener más información, consulte Crear una instancia de actividad o herramienta en Reutilización de componentes.

Se puede editar una actividad Get de Jitterbit MQ existente desde estas ubicaciones:

• El tela de diseño (vea menú de acciones del componente en Lienzo de diseño).
• La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestañaComponentes del panel Proyecto)

Configurar una actividad Get de Jitterbit MQ

Siga estos pasos para configurar una actividad Get de Jitterbit MQ:

• Paso 1: Ingrese un nombre y especifique la cola
  Asigne un nombre a la actividad y especifique la cola.

• Paso 2: Revisar los esquemas de datos
  Se muestran todos los esquemas de solicitud o respuesta.

Paso 1: Ingrese un nombre y especifique la cola

En este paso, asigne un nombre a la actividad y especifique la cola. A continuación, se describe cada elemento de la interfaz de usuario de este paso.

Consejo

Campos con un icono de variable soporte utilizando variables globales, variables del proyecto y variables de Jitterbit. Comience escribiendo un corchete abierto [ en el campo o haciendo clic en el ícono 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 y no debe contener barras diagonales. / 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.

  Nota

  Asegúrese de que el nombre de la cola para el ambiente especificado se haya ingresado correctamente, ya que las operaciones no fallan si se ingresa un nombre de cola no válido. En cambio, las operaciones se realizarán correctamente y messageCount Se devolverá 0.

• Reconocimiento automático: Seleccione esta opción para habilitar el reconocimiento automático de los mensajes recuperados. Esta opción genera una respuesta por cada mensaje reconocido y puede causar tiempos de procesamiento más largos. Si no se selecciona Reconocimiento automático, se realizan reconocimientos explícitos (mediante la actividad Reconocimiento) están limitados a 50 por ambiente y 500 por organización.

  Nota

  Si Reconocimiento automático no está seleccionado, los mensajes recuperados mediante la actividad Obtener deben ser reconocidos (mediante la actividad Reconocimiento) o reconocido negativamente (por la actividad NACK) antes de un tiempo de espera de 30 minutos. Una vez transcurrido este tiempo, los mensajes se seguirán recuperando mediante una actividad Obtener o Obtener actividad 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 guardar temporalmente la configuración de este paso y continuar con el siguiente. 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 los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pedirá que confirme que desea descartar los cambios.

Paso 2: Revisar los esquemas de datos

Se muestran todos los esquemas de solicitud o respuesta. A continuación, se describe cada elemento de la interfaz de usuario de este paso.

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

  Información

  Si no está utilizando la opción Reconocimiento automático (especificada en el paso 1), puedes utilizar el ackId en la respuesta de la actividad Obtener como entrada para la Actividad de reconocimiento o actividad NACK esquema de solicitud.

  El esquema de datos de respuesta consta de 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 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 que se adjuntará al mensaje (usado en la actividad Reconocer)
  isRedeliver	Se vuelve 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 conserva en el disco(2) o no persistente](1)
  expiration	El tiempo de expiración 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 ponerlo en la carga útil del mensaje)
  priority	Valor entero que va desde 0 a través de 9 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	La hora de la solicitud
  headers	Nodo que contiene cualquier encabezado de mensaje
  item	Nodo que contiene cada encabezado del 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 Refresh para regenerar esquemas desde el extremo de Jitterbit MQ. Esta acción también regenera un esquema en otras ubicaciones del proyecto donde se hace referencia al esquema, como en una transformación adyacente.

• Atrás: Haga clic para guardar temporalmente la configuración de este paso y regresar 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 cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pedirá que confirme que desea descartar los cambios.

Próximos pasos

Después de configurar una actividad Get de Jitterbit MQ, complete la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de la operación. También puede configurar los ajustes de la operación, lo que incluye la posibilidad de encadenar operaciones que se encuentren en el mismo flujo de trabajo o en flujos de trabajo diferentes.

Se puede acceder a las acciones del menú de una actividad desde el panel del proyecto y el tela de diseño. Para más detalles, consulte menú de acciones de la actividad en Conceptos básicos del conector.

Las actividades Get de Jitterbit MQ 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 destinos (solo como primera fuente)

Para utilizar la actividad con funciones de script, escriba los datos en una ubicación temporal y luego use esa ubicación temporal en la función de script.

Cuando esté listo, desplegar y ejecutar la operación y validar el comportamiento comprobando los registros de operación.