Compartir a través de


Acciones de colas de trabajo

Las colas de trabajo en Power Automate se pueden usar para almacenar datos relevantes para el proceso y proporcionar una forma de desacoplar procesos y automatizaciones complejos, lo que les permite comunicarse de forma asíncrona.

Las colas de trabajo pueden desempeñar un papel crucial en la mejora de la eficiencia, la escalabilidad y la resistencia de las automatizaciones y ayudan a priorizar el trabajo. Las colas de trabajo le permiten completar primero los elementos de mayor prioridad, independientemente de si los procesan trabajadores digitales, trabajadores humanos o a través de integraciones.

Nota

  • La compatibilidad a nivel de producción para el primer conjunto de acciones relacionadas con la cola de trabajos requiere la versión de escritorio 2.37 o posteriores de Power Automate.
  • Las acciones de la cola de trabajo en Power Automate para escritorio son una función premium que requiere una suscripción a Power Automate.
  • Actualmente, solo las acciones Procesar elementos de la cola de trabajos y Actualizar elementos de la cola de trabajos se pueden clasificar y permitir o restringir mediante la pérdida de datos (DLP) y pronto se implementarán otras acciones. Tenga en cuenta que las políticas de DLP no pueden restringir el uso de colas de trabajo basado en el flujo de la nube.

Procesar elementos de cola de trabajo

La acción Procesar elementos de la cola de trabajo indica al orquestador de la cola que la máquina está lista para procesar uno o más elementos de la cola de trabajo. El contexto de usuario que solicita un nuevo elemento debe tener privilegios suficientes en la cola de trabajo y en la tabla de elementos de la cola de trabajo para poder procesar las colas de trabajo.

Captura de pantalla de la acción Procesar cola de trabajo

El orquestador de colas utiliza la cola de trabajo a la que se hace referencia en la acción anterior para determinar los siguientes elementos disponibles en esa cola de trabajo que están en estado En cola. A medida que el flujo de escritorio recorre las acciones dentro del bucle Procesar elementos de la cola de trabajo que representa esta acción, puede solicitar el valor utilizando la variable que ha designado para la acción junto con la propiedad .Value. En este caso, podría llamar al valor del elemento de la cola de trabajo usando la variable %WorkQueueItem.Value%

Processworkqueueitemaction

La acción Procesar elementos de cola de trabajo requiere los siguientes argumentos.

Parámetros de entrada

Argumento Opcionales Acepta Valor predeterminado Descripción
Cola de trabajo No Text El id. de cola de trabajo de la cola de trabajo que contiene elementos para procesar

Variables producidas

Argumento Type Descripción
WorkQueueItem No Información almacenada en el elemento de la cola de trabajo que se está procesando

Excepciones

Excepción Descripción
No se ha encontrado la cola de trabajo El valor introducido en el parámetro de la cola de trabajo no es válido
No se ha podido procesar la cola de trabajo Solicitud incorrecta: error en la sintaxis de la consulta

Actualizar elemento de cola de trabajo

La acción Actualizar elemento de cola de trabajo permite a los usuarios cambiar el estado y los resultados del procesamiento del elemento de cola de trabajo seleccionado.

Captura de pantalla de la acción Actualizar cola de trabajo

Updateworkqueueitemaction

La acción Actualizar elementos de cola de trabajo requiere los siguientes argumentos.

Argumento Opcionales Acepta Valor predeterminado Descripción
Elemento de cola de trabajo No Text Variable de elemento de cola de trabajo que ha devuelto previamente el orquestador de cola
Estado No Excepción genérica procesada Procesada Actualice el elemento de la cola de trabajo que se está procesando utilizando un estado de la lista de opciones.
Notas sobre el procesamiento Text Notas de procesamiento personalizadas o valor para agregar al elemento de la cola que se está procesando.
Borrar notas de procesamiento Booleana False Cuando está habilitado, oculta y borra el campo de notas de procesamiento en esta pantalla y elimina cualquier nota de procesamiento de la base de datos que se haya capturado previamente para este elemento.

Excepciones

Argumento Description
No se ha encontrado el elemento de cola de trabajo El elemento de la cola de trabajo que se está procesando se eliminó o ya no pertenece a la cola desde la que se llamó.
Elemento de cola de trabajo en espera El elemento de la cola de trabajo que se está procesando contiene un estado de on hold en el orquestador de colas y ya no se puede actualizar.
No se ha podido actualizar el elemento de cola de trabajo El elemento de la cola de trabajo que se está actualizando ha encontrado un error inesperado. Compruebe el mensaje de error para obtener más detalles.

Agregar elemento de cola de trabajo

La acción Agregar elemento de cola de trabajo permite a los usuarios del flujo de trabajo de escritorio a introducir elementos de cola de trabajo en una cola de trabajo que se haya configurado en el portal de flujos.

Captura de pantalla de la acción Agregar elemento de cola de trabajo

Acción Addworkqueueitem

La acción Agregar elementos de cola de trabajo requiere los siguientes argumentos.

Parámetros de entrada

Argumento Opcionales Acepta Valor predeterminado Descripción
Cola de trabajo No Valor de texto El elemento de cola de trabajo al que agregar el elemento
Prioridad No Alta, Normal, Baja Normal La prioridad a la que establecer el elemento de la cola de trabajo
Asignar nombre No Valor de texto, valor numérico Id. o nombre personalizado para el nuevo elemento de cola de trabajo
Entrada No Valor de texto, valor numérico Los datos que pertenecen a la columna de valor a procesar
Caducidad Datetime El valor de fecha y hora establecido para caducar el elemento de la cola; de lo contrario, adopta el valor predeterminado si se establece uno para la cola
Notas sobre el procesamiento Valor de texto, valor numérico Notas de procesamiento personalizadas que se agregarán al nuevo elemento de la cola
Tiene id. o referencia único Valor de texto, valor numérico Cuando está habilitado, se debe proporcionar un valor que sea único dentro de esta cola. Si se deja vacío, el sistema proporciona automáticamente un valor único en el formato system-<GUID>.

Variables producidas

Argumento Type Description
WorkQueueItem No Información almacenada para el elemento de la cola de trabajo que se está agregando

Excepciones

Argumento Descripción
No se ha encontrado la cola de trabajo El valor introducido en el parámetro de la cola de trabajo no es válido
No se ha podido agregar el elemento a la cola de trabajo El elemento de la cola de trabajo no se pudo agregar a la cola de trabajo. Solicitud incorrecta: error en la sintaxis de la consulta

Volver a poner en cola el elemento con retraso

La acción Volver a poner en cola el elemento con retraso permite a los usuarios volver a agregar un elemento de la cola que se está procesando en el flujo del escritorio a su cola de origen. Además, el elemento en cola se puede retener y liberar hasta un tiempo definido.

Captura de pantalla de la acción volver a poner en cola la cola de trabajo.

Requeueworkqueueitemaction

La acción Reponer elemento en cola con retraso requiere los siguientes argumentos.

Parámetros de entrada

Argumento Opcionales Acepta Valor predeterminado Descripción
Elemento de cola de trabajo No Elemento de cola de trabajo El elemento de cola de trabajo al que agregar el elemento
Retraso hasta No Valor DateTime Normal El valor de fecha y hora aplicado para retrasar el elemento de la cola hasta
Caducidad Valor DateTime Tiempo de vencimiento personalizado para el artículo que se está solicitando
Notas sobre el procesamiento Valor de texto, valor numérico Notas de procesamiento personalizadas que se agregarán al nuevo elemento de la cola
Borrar notas de procesamiento Booleana False Cuando está habilitado, oculta y borra el campo de notas de procesamiento en esta pantalla y elimina cualquier nota de procesamiento de la base de datos que se haya capturado previamente para este elemento.

Excepciones

Argumento Description
No se ha encontrado la cola de trabajo El valor introducido en el parámetro de la cola de trabajo no es válido
No se ha encontrado el elemento de cola de trabajo El valor del elemento de la cola no es válido
No se ha podido volver a poner en cola el elemento de cola de trabajo El elemento de la cola de trabajo no se pudo agregar a la cola de trabajo. Solicitud incorrecta: error en la sintaxis de la consulta

Actualizar notas sobre el procesamiento de elementos de cola de trabajo

La acción Actualizar notas sobre el procesamiento de elementos de cola de trabajo permite a los usuarios actualizar o borrar notas de procesamiento del elemento de la cola de trabajo seleccionado sin cambiar su estado ni ninguna otra propiedad.

Captura de pantalla de la acción Actualizar notas de procesamiento de elementos de la cola de trabajo.

updateprocessingnotesaction

La acción Actualizar notas de procesamiento de elementos de la cola de trabajo requiere los siguientes argumentos.

Argumento Opcionales Acepta Valor predeterminado Description
Elemento de cola de trabajo No Text Variable de elemento de cola de trabajo que ha sido devuelta previamente por el orquestador de cola
Notas sobre el procesamiento Text Resultado o valor del procesamiento personalizado para agregar al elemento de la cola procesado
Borrar notas de procesamiento Booleana False Cuando está habilitado, oculta y borra el campo de notas de procesamiento en esta pantalla y elimina cualquier nota de procesamiento de la base de datos que se haya capturado previamente para este elemento.

Excepciones

Argumento Description
No se ha encontrado la cola de trabajo La cola de trabajo asociada con el elemento se eliminó o ya no se puede acceder a ella
No se ha encontrado el elemento de cola de trabajo El elemento de la cola de trabajo no es válido
No se pudieron anexar los resultados del procesamiento El elemento de la cola de trabajo que se está actualizando ha encontrado un error inesperado. Compruebe el mensaje de error para obtener más detalles.

Consulte también