Actividades de tareas en cola

Queue task activities in BPMN processes: required fields for creating, updating, and resolving Orchestrator queue items, organized by activity.

Queue task activities create, update, and resolve Orchestrator queue items from a task in a BPMN process. Queue activities are accessed from the Action dropdown in a task's Properties panel. Queue activities are available in the following task types — refer to Tasks for the full list:

• Tareas de servicio
• Tareas de usuario
• Enviar tareas
• Recibir tareas
• Tareas de regla empresarial
• Tareas de script

Ciclo de vida del artículo en cola

Estado	Cómo se alcanza
Nuevo	El elemento se añade a la cola.
EnCurso	Un desencadenador de cola inicia una instancia de proceso para el elemento y la establece en EnCurso.
Correcto/Error	El proceso establece el estado final con Establecer estado de transacción.
Abandonado	Automático, si un elemento permanece en progreso durante 24 horas sin alcanzar un estado final. Si el reintento está configurado en la cola, Orchestrator clona el elemento y lo vuelve a poner en cola.

Nota:

One queue item starts exactly one BPMN process instance. A single instance consuming multiple items in a loop isn't supported in this release.

Crear artículos en cola

Añade un nuevo elemento a una cola de Orchestrator con el estado Nuevo .

Campo	Obligatorio	Descripción
Nombre de cola	Sí	La cola de Orchestrator a la que añadir el elemento.
Ruta de la carpeta	Sí	La carpeta de Orchestrator que contiene la cola.
Prioridad	No	La prioridad de procesamiento del elemento.
Fecha límite	No	La fecha y hora en la que debe procesarse el elemento.
Posponer fecha	No	La fecha y hora más tempranas en que el elemento estará disponible para su procesamiento.
Datos personalizados	No	Datos adicionales adjuntos al elemento, disponibles para el robot o proceso que lo procesa.

Crear y esperar artículos en cola

Añade un elemento a una cola y espera a que el elemento alcance un estado final antes de continuar el proceso. Utiliza los mismos campos que Crear artículos en cola.

Obtener elementos de la cola

Consulta elementos en una cola de Orchestrator sin eliminarlos de la cola o bloquearlos, para inspección de solo lectura o ramificación condicional en el estado de la cola.

Campo	Obligatorio	Descripción
Nombre de cola	Sí	La cola de Orchestrator a consultar.
Ruta de la carpeta	Sí	La carpeta de Orchestrator que contiene la cola.
Estado	No	Filtrar por estado del elemento.
Referencia	No	Filtrar por referencia de elemento.
Intervalo de fechas de creación	No	Filtra por el intervalo de fechas en el que se creó el elemento.
Prioridad	No	Filtrar por prioridad de elemento.

La actividad devuelve los 100 elementos coincidentes más recientes y un recuento total. Un filtro que coincida con más de 100 elementos devuelve una lista truncada: restrinja el filtro para ver los elementos restantes.

Esperar evento de cola

Disponible en una tarea de recepción o un evento de captura intermedio, este elemento de espera bloquea la ejecución hasta que un elemento de transacción esté disponible en una cola de Orchestrator.

Campo	Obligatorio	Descripción
Nombre de cola	Sí	La cola de Orchestrator a esperar.
Ruta de la carpeta	Sí	La carpeta de Orchestrator que contiene la cola.

Cuando un elemento se elimina de la cola, sus campos pasan a estar disponibles como salidas del proceso, con la misma forma que Obtener elementos de la cola. La espera no tiene tiempo de espera: adjunta un temporizador de límite para dejar de esperar después de una duración establecida. Este elemento es compatible con los motores de ejecución V1 y V2.

Añadir elementos de la cola de forma masiva

Añade varios elementos a una cola en un solo lote, hasta 15 000 elementos por llamada.

Campo	Obligatorio	Descripción
Nombre de cola	Sí	La cola de Orchestrator a la que añadir elementos.
Ruta de la carpeta	Sí	La carpeta de Orchestrator que contiene la cola.
Elementos	Sí	La lista de elementos que se van a añadir, hasta 15 000 por llamada.
TipoDeConfirmación	Sí	AllOrNothing rechaza todo el lote si algún elemento falla en la validación. ProcessAllIndependently añade todos los elementos válidos e informa de los fallos de forma individual.

Cuando el tipo de confirmación es ProcessAllIndependently, la actividad devuelve la lista de elementos que no se pudieron añadir.

Eliminar elementos de la cola

Elimina elementos con el estado Nuevo de una cola especificada.

Campo	Obligatorio	Descripción
Nombre de cola	Sí	La cola de Orchestrator de la que se eliminarán los elementos.
Ruta de la carpeta	Sí	La carpeta de Orchestrator que contiene la cola.
Elementos	Sí	Los elementos que se eliminarán. Solo se pueden eliminar los elementos con el estado Nuevo .

Posponer elemento de la transacción

Establece una fecha de aplazamiento y, opcionalmente, una fecha de vencimiento, para un elemento de transacción en curso y devuelve el elemento al estado Nuevo .

Campo	Obligatorio	Descripción
Fecha de aplazamiento	Sí	La fecha y hora más tempranas en que el elemento vuelve a estar disponible para su procesamiento.
Fecha límite	No	La fecha límite en la que debe procesarse el elemento.

Nota:

Posponer el elemento de transacción no se vuelve a intentar automáticamente cuando la llamada subyacente falla con un error 4xx.

Establecer progreso de la transacción

Actualiza un elemento de transacción InProgress con una cadena de estado personalizada. El estado es visible en Orchestrator.

Campo	Obligatorio	Descripción
Progreso	Sí	Una cadena de texto personalizada que describe el estado de procesamiento actual del elemento.

Establecer estado de la transacción

Establece el estado final de un elemento de transacción en Correcto o Erróneo.

Campo	Obligatorio	Descripción
Estado	Sí	Correcto o Erróneo.
Tipo de error	Condicional	Obligatorio cuando el estado es Erróneo. BusinessException o ApplicationException.
Razón del error	Condicional	Obligatorio cuando el estado es Erróneo. Una breve descripción del error.
Detalles de error	No	Información de error adicional.

Maestro Orchestrate automatically retries the task unless the underlying call fails with a 4xx error. On failure, the task returns the error code OrchestratorSetTransactionResultFailed.

Para el desencadenador que inicia un proceso desde un artículo en cola, consulta Eventos. Para obtener más información sobre las tareas, consulta Tareas en el modelado BPMN.