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.
   • 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án activos, reintenta cualquier artículo en cola que falle después de crear la cola.
   • Elementos abandonados: si están activos, revela el campo N.º máximo de reintentos, donde puedes establecer el número máximo de reintentos para artículos en cola abandonados. Si están inactivas, las transacciones se abandonan después de 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 colas utilizando Studio o la ventana Cargar elementos. Solo se pueden procesar elementos desde una cola utilizando Studio. Para obtener más información, consulta la página Administrar 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, haz clic en el botón Más opciones para la cola deseada.
2. Haz clic en 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 tanto, NEW_QueueName y new_queuename son duplicados.
4. En el campo Descripción, actualiza la descripción de la cola.
5. Haz clic en 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 el botón Más opciones para la cola deseada.
2. Selecciona 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. Las transacciones fallidas existentes no se vuelven a intentar. Solo se vuelven a intentar las transacciones que hayan fallado tras haber establecido el nuevo valor.

2. Los 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 del 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. 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. Haz clic en Enlace desde otras carpetas. 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.
   
   

   

   
   
4. Haz clic en 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.
   
   

   

   
   
5. Haz clic en Eliminar en la cola correspondiente para deshacer los cambios, o bien haz clic en Salir para cancelar la operación.
6. Haz clic en Vincular si quieres enlazar las colas seleccionadas y la carpeta actual. Las colas se muestran en la página Colas.
   
   

   

   
   

Vincular una cola a varias carpetas

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

   1: Panel izquierdo que muestra todas las carpetas en las que se te han concedido permisos de Visualización de las colas. 2 - El estado actual de la cola, en el que se muestra el número de carpetas en las que reside actualmente y sus nombres. 3: Las carpetas en las que debe añadirse la cola según tu selección en el panel izquierdo. 4: Las carpetas de las que se eliminará la cola.

   
   

   

   
   
3. Haz clic en Actualizar. Se mostrará una ventana de confirmación.
4. Haz clic en Cancelar si quieres anular los cambios o en 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

En la página Colas, haz clic en Más acciones > Ver transacciones. Se mostrará así la página Transacciones, que solo contendrá los elementos de la cola indicada.

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.

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

Para supervisar una cola, haz clic en el botón Más acciones y luego Supervisar cola. Alternativamente, selecciónala en el widget de Descripción general de colas (Supervisión > Colas).

Ten en cuenta que la supervisión de una cola requiere que tu usuario tenga permisos de visualización en Colas y en Supervisión. Además, se necesita Editar en Supervisión para deshabilitar los errores del widget Error de transmisión en la página Supervisión > Colas.

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 un activo que existe en varias carpetas, este solo se elimina de la carpeta en la que tiene lugar la operación. No se elimina automáticamente 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.

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.