Gestión de Colas en Orchestrator

Crea y gestiona colas en Orchestrator, incluida la configuración de colas y la vinculación de colas entre carpetas.

Crear una cola

1. In the Queues page, Select Add Queue. Two options are displayed allowing you to create a new queue or to link queues from other folders.
2. Select Create a new queue. The Create Queue window is displayed.
3. En el campo Nombre, introduce un nombre para la cola.
4. En el campo Descripción, añade una descripción para la cola.
5. Si deseas que las referencias de las transacciones sean exclusivas o no, selecciona la casilla de verificación Aplicar referencias exclusivas.
6. Si desea que los datos de los elementos en cola y la salida estén cifrados en la base de datos, seleccione la casilla de verificación Almacenar en formato cifrado.
   Nota:

   • La operación de cifrado no puede deshacerse.
   • Los datos se cifran utilizando cifrado en el nivel de aplicación. Para obtener más información, consulta Cifrado en el nivel de aplicación (ALE).
   • Los valores de Datos específicos, Salida y Excepciones de procesamiento de un artículo en cola se cifran en la base de datos, protegiendo el contenido confidencial de los administradores de la base de datos. La IU de Orchestrator sigue mostrando el contenido descifrado. Para el cifrado de extremo a extremo, debes cifrar el artículo en cola antes de añadirlo a la cola.
   • Las colas existentes no pueden cifrarse. Como alternativa, puedes volver a crear la cola y seleccionar la casilla de verificación Almacenar en formato cifrado.
   • Debido al formato cifrado, los análisis de informes en los campos de la base de datos Datos específicos, Salida y Excepciones de procesamiento ya no son posibles para las nuevas colas, y los paneles correspondientes en Insights no están disponibles.
7. En la sección Reintento automático, puedes encontrar dos opciones, de la siguiente manera:
   • Elementos fallidos : si está activo, reintenta cualquier elemento de la cola que haya fallado después de crear la cola.
   • Elementos abandonados : si está activo, revela el campo Número máximo de reintentos , donde puedes establecer el número máximo de reintentos para los artículos en cola abandonados. Si está inactivo, las transacciones se abandonan tras 24 horas de inactividad.
     Nota:

     Los artículos en cola reintentados se marcan en consecuencia en la interfaz de usuario.

8. Carga un esquema JSON para cualquiera o cada uno de los datos específicos, datos de salida y datos de análisis mediante el botón Explorar correspondiente.
9. Habilita las predicciones de ANS si quieres tener un mayor control del tiempo de procesamiento de tus elementos, y si deseas evaluar qué recursos necesitas para cumplir con los plazos. Si las predicciones de SLA están habilitadas, configura los siguientes campos:
   • En el menú desplegable Proceso, selecciona el proceso que administra los elementos en cola, y luego rellena el siguiente valor de ANS. El valor máximo es 90 días.
   • Habilita el ANS de riesgo si quieres definir una zona de seguridad antes de la actual ANS, y añade el siguiente valor. El SLA de riesgo debe ser menor que el SLA.
10. Select Add. The queue is created and displayed on the Queues page, yet it is empty.

Puedes rellenar las colas utilizando Studio o en la ventana Cargar elementos . El procesamiento de elementos de una cola solo es posible mediante Studio. Para obtener más información, consulta la página Gestionar colas en Studio .

Editar colas

Puedes actualizar una configuración de cola existente, por ejemplo:

• Nombre y Descripción de la cola
• La sección Reintento automático
• El número máximo de reintentos

Editar un nombre o una descripción de cola

Para editar un nombre de cola existente en Orchestrator:

1. En la página Colas , selecciona Más opciones para la cola deseada.
2. Seleccionar Editar . Se mostrará el asistente Actualizar cola .
3. En el campo Nombre, introduce el nuevo nombre para la cola seleccionada.
   Nota:

   • Asegúrate de introducir un nombre único. Si ya existe una cola con el mismo nombre en tu tenant, saltará el siguiente mensaje de error: The name <QueueName> is already used. (#1001).
   • El nombre no distingue entre mayúsculas y minúsculas. Por lo tanto, NEW_QueueName y new_queuename son duplicados.
4. En el campo Descripción, actualiza la descripción de la cola.
5. Selecciona Actualizar.
   Importante:

   Asegúrate de actualizar el nombre de la cola en los flujos de trabajo correspondientes en Studio. Debes hacerlo manualmente, ya que no hay ninguna forma de actualizar el nombre de la cola en Studio.

Cambiar las opciones de Reintento automático

Para cambiar las opciones en la sección Reintento automático para una cola existente:

1. En la página Colas , selecciona Más opciones para la cola deseada.
2. Seleccionar Editar . A continuación, se muestra el asistente Actualizar cola .
3. En la sección Reintento automático, selecciona la opción que necesitas.
4. Selecciona Actualizar.

Configurar un Número Máximo de Reintentos

Elementos abandonados: casilla de verificación seleccionada

Si seleccionaste la opción Elementos abandonados, se muestra el campo N.º máximo de reintentos.

Introduce un valor en el rango 1-50 como el número de reintentos de la transacción fallida.

Importante

1. No se vuelven a intentar las transacciones fallidas existentes. Solo se vuelven a intentar las transacciones que fallan después de establecer el nuevo valor.
2. Las reintentos manuales no se incluyen en el número máximo de reintentos establecidos para los artículos en cola. En tales casos, en la API, RetryNumber es 0 y AncestorId es null.

Además, cada artículo en cola apunta, a través del campo Key, al artículo en cola original de una cadena de reintentos.

Se incluyen los siguientes campos:

• ManualRetryNumber: la cantidad de reintentos manuales de un artículo en cola
• ManualAncestorId: el ID del artículo en cola que se ha vuelto a intentar manualmente
• ManualAncestorUniqueKey: el GUID único global del artículo en cola que se ha vuelto a intentar manualmente
• UniqueKey: el GUID único global de cualquier artículo en cola (diferente para cada reintento, manual o automático)
• AncestorUniqueKey: el GUID único global del artículo en cola que se ha vuelto a intentar automáticamente
• RetryNumber: la cantidad de reintentos automáticos de un artículo en cola
• AncestorId: el ID del artículo en cola que se ha vuelto a intentar automáticamente
• Key: el GUID del artículo en cola inicial de una cadena de reintentos

El objetivo es tener una trazabilidad completa de los reintentos de artículos en cola.

3. Los artículos en cola reintentados y eliminados no participan en las comprobaciones de referencia únicas. Por ello, recomendamos que no elimines un artículo en cola inicial de una cadena de reintentos, ya que esto impide la validación de referencias únicas. Sin embargo, si el artículo en cola inicial ha sido recogido por la retención de datos, esta validación se sigue realizando.

Digamos que tienes una lista de transacciones fallidas que se vuelven a intentar una vez. El valor actual de Número máximo de reintentos es 2. Actualiza el valor a 3 y las transacciones fallidas se vuelven a intentar dos veces más en lugar de una.

Elementos abandonados: casilla de verificación no seleccionada

Si no seleccionaste la opción Elementos abandonados, el campo N.º máximo de reintentos está oculto.

No se está volviendo a intentar ninguna transacción.

Administrar enlaces de cola

Compartir colas entre carpetas permite iniciar trabajos en varias carpetas sin rediseñar los flujos de trabajo en Studio cuando los procesos subyacentes están destinados a la misma cola. Vincular una cola a una carpeta hace que la cola y todos los objetos asociados a ella, como los elementos de la cola, estén disponibles en esa carpeta.

Nota:

Las colas vinculadas a varias carpetas se marca mediante el icono . Si el icono no está presente, entonces la carpeta actual es la única en la que reside la cola. Al eliminarla aquí, la cola se eliminará por completo de Orchestrator. Necesitas el permiso de Colas: Crear en las carpetas donde quieres añadir la cola (carpetas de destino) y Colas: Visualizar en la carpeta donde reside actualmente la cola (carpeta original). Si tienes Colas: Editar en la carpeta de destino, también necesitas Colas: Editar en la carpeta original.

Vincular varias colas a la carpeta actual

1. In the folder you want to link a queue to, on the Queues page, Select Add. Three buttons are displayed allowing you to add a queue, link queues from other folders, or hide the options.
2. Select Link from other folders. The Link Queues window is displayed showing a list of all queues in the folders in which you have View permissions on Queues.
3. En la sección Seleccionar colas, selecciona una o varias colas de la lista.

Figura 1. Seleccionar cola

4. Selecciona Continuar. Te dirigirás a la sección Validación de la carpeta. Aquí puedes ver las carpetas a las que las colas están vinculadas. Si existen varias carpetas se muestran sus nombres.

Figura 2. Validación de carpeta

5. Select Remove for the corresponding queue to revert the change or Select Exit to cancel the operation.
6. Seleccionar Enlace si deseas crear el enlace entre las colas que has seleccionado y la carpeta actual. Las colas se muestran en la página Colas.

Figura 3. Página de colas

Vincular una cola a varias carpetas

1. Dirígete a una carpeta en la que reside la cola a vincular.
2. Selecciona Más acciones > Administrar enlaces en la cola deseada para abrir la ventana Administrar enlaces. Se mostrará la ventana Administrar enlaces en la cola.

Figura 4. Página Gestionar enlaces de cola

3. Selecciona Actualizar. Aparecerá una ventana de confirmación.
4. Seleccionar Cancelar si deseas abortar los cambios o Continuar para que los cambios surtan efecto. Las operaciones se reflejan en Orchestrator según tus cambios.

Desvincular colas de las carpetas

Se pueden desvincular colas de las carpetas de forma similar a la operación de vinculación. Dirígete a las áreas de gestión de enlaces presentadas en los procedimientos anteriores y elimina las conexiones entre una determinada cola y una determinada carpeta.

Alternativamente, puedes eliminar una cola con la función Eliminar.

Importante:

Al eliminar una cola que existe en varias carpetas, esta solo se elimina de la carpeta en la que tiene lugar la operación. No se elimina también de las demás carpetas.Para eliminar por completo una cola, debes eliminar todos los enlaces existentes. No puedes desvincular una cola de una carpeta en las siguientes situaciones:

• el SLA de la cola ha sido deshabilitado en esa carpeta;
• un desencadenador de cola está adjuntado en la cola.

Mostrar transacciones

In the Queues page, click More Actions > View Transactions. The Transactions page is displayed, containing only the items from the indicated queue.

Mostrar solicitudes de revisión

En la página Colas, haz clic en Solicitudes de revisión para mostrar todos los elementos asignados para su revisión al usuario conectado actualmente. La página permite cambios de estado y gestionar información de los elementos.

Mostrar el gráfico de colas

Para ver el gráfico de una cola específica, haz clic en el botón Más acciones y luego Ver gráfico.

Un gráfico de líneas muestra la evolución del estado de las transacciones durante un tiempo determinado. Se puede cambiar el periodo de tiempo (última hora, día, semana, 30 días), y se puede ver el tiempo medio de ejecución y el número máximo de reintentos.

Figura 5. Gráfico de cola

Cargar elementos a una cola utilizando un archivo CSV

Más detalles sobre cargar elementos de la cola mediante un archivo CSV aquí.

Supervisar una cola

To monitor a queue, click the corresponding More Actions button and then Monitor Queue. Alternatively, select it from the Queues Overview widget (Monitoring > Queues).

Note that monitoring a queue requires your user to have View permissions on Queues and on Monitoring. Additionally, Edit on Monitoring is required in order to disable errors from the Error Feed widget on the Monitoring > Queues page.

Añadir etiquetas a colas

Nota:

Para añadir etiquetas existentes a colas, necesitas los permisos Editar en Colas y Ver en Etiquetas. Para añadir etiquetas nuevas a colas, necesitas los permisos Editar en Colas y Crear en Etiquetas.

Nota:

• Cada cola puede tener como máximo un millón de pares clave/valor.
• Las etiquetas y las propiedades de clave/valor están limitadas a 256 caracteres.
• Los nombres de etiquetas no pueden contener estos caracteres: <, >, %, &, \)\), ?, /, :

Puedes aplicar etiquetas a una cola tanto al crear una como al editar una ya existente. Para añadir etiquetas a una cola al editarla, sigue estos pasos:

1. From the Queues page, Select More Actions > Edit next to the desired queue. The queue is opened for editing.
2. En el campo Etiquetas, introduce el nombre de la etiqueta. Puedes elegir una etiqueta existente o crear una nueva.
3. On the Properties (key-value pairs) field, Select Add new.
4. Añade las nuevas claves y los nuevos valores. Puedes elegir las claves y/o valores existentes o puedes crear unos nuevos.
5. When done, Select Update. Your queue is updated and the newly created tags, if any, become available for other objects.

Eliminar etiquetas de colas

Para eliminar etiquetas de una cola, sigue estos pasos:

1. From the Queues page, Select More Actions > Edit next to the desired queue. The queue is opened for editing.
2. On the Labels field, Select the X adjacent to the name of the label to remove it. The label is removed.
3. On the Properties (key-value pairs) field, Select the X adjacent to the keys and/or values to remove them. The keys and/or values are removed.
4. To delete a key/value pair Select the Remove icon corresponding to that entry. The key/value pair is removed.
5. When done, Select Update. Your queues is updated and tags are removed.

Eliminar una cola

Para eliminar una cola, haz clic en el botón Más acciones correspondiente y luego en Eliminar.

Alternativamente, selecciónala en la página Colas y haz clic en Eliminar. La cola ya no se muestra en la página Colas.

Importante:

Al eliminar una cola que existe en varias carpetas, esta solo se elimina de la carpeta en la que tiene lugar la operación. No se elimina también de las demás carpetas.Para eliminar por completo una cola, debes eliminar todos los enlaces existentes.

Nota:

Después de eliminar una cola, los elementos de transacción asignados que pertenecen a la cola ya no son visibles en la página Solicitudes de revisión.

Cómo grabar transacciones en cola fallidas

Puedes grabar transacciones en cola fallidas asociadas a un proceso que tenga la opción de grabación habilitada. Esto ayuda a identificar y solucionar problemas que provocan fallos, y ayuda en la supervisión y auditoría.

Esta opción está habilitada en el nivel de proceso, desde la sección Grabación del trabajo de la pestaña Configuración adicional.

Figura 6. Configuración adicional para la grabación de trabajos

Si un proceso que contiene una cola falla, su ejecución se graba y está disponible en Orchestrator en los siguientes lugares:

• En el nivel de cola, haciendo clic en Abrir grabación en el menú contextual de la cola afectada. Esta opción no está activa si:
  • la cola está asociada a un proceso cuya ejecución no ha fallado.
  • la opción Grabar y almacenar transacciones de cola fallidas no se ha habilitado para el proceso al que está asociada esa cola.
• En el nivel de transacción, haciendo clic en Abrir grabación en la ventana Ver detalles de la transacción afectada.

Duración de la grabación

La duración máxima de una grabación es de 3 minutos y se aplica a los últimos momentos de la ejecución.

La duración mínima de grabación es de 10 segundos. Si el procesamiento de una transacción tarda menos de 10 segundos, la grabación podría incluir también otras transacciones.