Gestión de Colas en Orchestrator

Crear una cola

1. En la página Colas, haz clic en Añadir cola. Aparecen dos opciones que permiten crear una nueva cola o vincular colas de otras carpetas.
2. Haz clic en Crear una nueva cola. Se mostrará la ventana Crear cola.
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).
   • Solo se cifran los valores de Datos específicos y Salida de un elemento en cola. Estos valores se cifran solo en la base de datos, protegiendo así el contenido confidencial ante los administradores de la base de datos. La IU de Orchestrator sigue mostrando el contenido descifrado. Para cifrado de extremo a extremo debes cifrar el artículo en cola antes de agregarlo 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, ya no es posible realizar informes de análisis sobre los campos de la base de datos de Datos específicos y Salida, y los paneles correspondientes no están disponibles en Insights.
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. Haz clic en Añadir. La cola se crea y se muestra en la página Colas, pero está vacía.

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. In the Queues page, select the More Options button for the desired queue.
2. Select Edit . The Update Queue wizard is displayed.
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. In the Queues page, select the More Options button for the desired queue.
2. Select Edit . Next, the Update Queue wizard is displayed.
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:

A queue linked to multiple folders is marked using the icon. If the icon is not present, then the current folder is the only folder the queue resides in. Deleting it here completely removes the queue from Orchestrator. You need the Queues - Create permission in the folders where you want to add the queue (target folders) and Queues - View in the folder where the queue currently resides (original folder). If you have Queues - Edit in the target folder, you also require Queues - Edit in the original folder.

Vincular varias colas a la carpeta actual

1. En la carpeta en la que quieres vincular una cola, en la página Colas, haz clic en Añadir. Se muestran tres botones que te permiten añadir una cola, vincular colas de otras carpetas u ocultar las opciones.
2. Se muestra la ventana Vincular colas, la cual incluye una lista de todas las colas en las carpetas en las que tengas permisos de visualización en Colas.
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. Seleccionar Eliminar para la cola correspondiente para revertir el cambio o hacer clic en Salir para cancelar la operación.
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. En la página Colas, haz clic en Más acciones > Editar junto a la cola deseada. La cola se abre para editarse.
2. En el campo Etiquetas, introduce el nombre de la etiqueta. Puedes elegir una etiqueta existente o crear una nueva.
3. En el campo Propiedades (pares clave-valor), haz clic en Añadir nuevo.
4. Añade las nuevas claves y los nuevos valores. Puedes elegir las claves y/o valores existentes o puedes crear unos nuevos.
5. Cuando se haya realizado, haz clic en Actualizar. La cola se actualiza y las etiquetas recién creadas, si las hay, quedan disponibles para otros objetos.

Eliminar etiquetas de colas

Para eliminar etiquetas de una cola, sigue estos pasos:

1. En la página Colas, haz clic en Más acciones > Editar junto a la cola deseada. La cola se abre para editarse.
2. En el campo Etiquetas, haz clic en la X situada junto al nombre de la etiqueta para eliminarla. La etiqueta se elimina.
3. En el campo Propiedades (pares clave-valor), haz clic en la X situada junto a las claves y/o los valores para eliminarlos. Las claves y/o los valores se eliminan.
4. Para eliminar un par clave/valor, haz clic en el icono Eliminar correspondiente a esa entrada. El par clave/valor se elimina.
5. Cuando se haya realizado, haz clic en Actualizar. Las colas se actualizan y las etiquetas se eliminan.

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.