Gestión de Colas en Studio

Añadir elementos a una cola

1. En la página Colas, crea una cola.
2. En Studio, crea un proyecto de automatización que, por ejemplo, recoja ciertas cifras de una hoja de cálculo de Excel y las almacene en una variable.
3. Desde el panel de Actividades, arrastra una actividad Añadir elemento de cola al panel del Diseñador.
4. En el panel Propiedades, en el campo QueueName, escribe el nombre de la cola creada en el paso 1, entre comillas.
   Nota: Los nombres de la cola no distinguen entre mayúsculas y minúsculas. Por ejemplo, "Test_QuEuE" y "Test_QuEuE" es lo mismo.
5. En la lista de Prioridad, selecciona Baja, Normal o Alta, dependiendo de la importancia de los elementos que se añaden mediante esta actividad y de la rapidez con la que quieres que se procesen.
6. (Opcional) En el campo Referencia, introduce una cadena o variable de cadena que actúe como identificador de un elemento de la cola o de un grupo de ellos. (La referencia puede utilizarse para vincular las transacciones a otras aplicaciones utilizadas dentro de un proyecto de automatización. Además, esta función te permite buscar determinadas transacciones en Orchestrator, según la referencia personalizada facilitada).
   Nota: Adicionalmente, las referencias no son compatibles con la versión 2016.2 o inferiores de Orchestrator o Robot.
7. (Opcionalmente) En el campo Plazo, añade una fecha que indique que el artículo en cola puede procesarse antes de esa fecha.
8. (Opcionalmente) En el campo Posponer, añade una fecha que indique que el artículo en cola solo puede procesarse después de esa fecha.
9. Junto al campo ItemInformation, haz clic en el botón Navegar. Se mostrará la ventana ItemInformation, que te permite añadir datos a cada elemento de la cola creado.
   
   

   

   
   

   Nota: El valor de los argumentos de cadena añadidos en la ventana ItemInformation no puede contener los siguientes caracteres: [y" "
10. Haz clic en Crear Argumento. Se creará un nuevo argumento en blanco.
11. Cambia el nombre del argumento por algo más sugerente para tus necesidades.
12. Cambia el Tipo de argumento a lo que necesites. Por ejemplo, si quieres almacenar valores numéricos de las transacciones, selecciona Int32.
13. En el campo Valor, introduce el valor que quieres añadir a los elementos de la cola o una variable que utilices para almacenar un valor específico.
14. Haz clic en Aceptar. Tus ajustes se guardarán.
    Nota: Coloca este tipo de proyectos de automatización en un bucle. De lo contrario, solo se crea y se rellena un elemento en Orchestrator.

Los datos añadidos en la ventana ItemInformation en Studio se muestran en la ventana Detalles del elemento, en Datos específicos, en Orchestrator. Todos los elementos añadidos a las colas tienen el estado establecido como Nuevo.

Conseguir elementos de una cola y cambiar su estado

1. En Orchestrator, piensa que tienes una cola poblada de elementos.
2. En Studio, desde el panel Actividades, arrastra una actividad Obtener elemento de transacción al panel Diseñador.
3. En el panel Propiedades, en el campo QueueName, escribe el nombre de la cola poblada de Orchestrator, entre comillas.
   Nota: Los nombres de la cola no distinguen entre mayúsculas y minúsculas. Por ejemplo, "New_QueUe" y "new_queue" son lo mismo.
4. Crea una variable QueueItem. Esta variable almacena el primer elemento de una cola, según su prioridad y plazo. Cuando se coloca en un bucle, el Robot itera a través de todos los elementos de la cola. Después de que un elemento de la cola pase por esta actividad NO se procesa, y el estado del elemento cambia a En curso.
5. En el campo TransactionItem, introduce la variable QueueItem creada anteriormente.
6. Desde el panel Actividades, arrastra una actividad Decisión en la actividad Obtener elemento de transacción.
7. Crea tus requisitos de automatización. Por ejemplo, añade los elementos de la transacción a una hoja de cálculo de Excel y envía correos electrónicos con esta información.
8. En el panel Propiedades, en el campo Condición, escribe una condición (por ejemplo, el elemento de la cola está vacío) en función de la cual puede cambiar el estado del elemento.
9. Desde el panel Actividades arrastra una actividad Establecer estado de transacción y conéctala a la sección Falso de la actividad Decisión. Ninguno de los elementos que pasan a través de esta actividad cumplen la condición añadida en el paso 7.
10. En el panel Propiedades, en la lista desplegable Estado, selecciona Exitoso. Este estado se aplica a todos los elementos de la cola que pasan por esta actividad.
11. En el campo TransactionItem, introduce la variable QueueItem utilizada en el paso 5.
12. (Opcional) Haz clic en el botón Examinar junto al campo Análisis e introduce los datos que quieres que se muestren en la ventana Detalles del elemento, en el campo Análisis.
13. (Opcional) Haz clic en el botón Examinar junto al campo Salida e introduce los datos que quieres que se muestren en la ventana Detalles del elemento, en el campo Salida.
    Nota: Esta información solo se muestra si el elemento de la cola se procesa con éxito.
14. Arrastra otra actividad Establecer estado de transacción al panel Diseñador y conéctala a la sección Verdadero de la actividad Decisión. Todos los elementos que pasan a través de esta actividad cumplen la condición añadida en el paso 7.
15. En el panel Propiedades, en el campo Estado, selecciona Fallido. Este estado se aplica a todos los elementos de la cola que pasan por esta actividad.
16. En el campo TransactionItem, introduce la variable QueueItem utilizada en el paso 5.
17. En la lista ErrorType selecciona Empresa o Aplicación, en función de la condición que hayas puesto en la actividad Decisión. Por ejemplo, un elemento de cola vacío podría ser una excepción de la aplicación, mientras que un valor de la transacción es menor que un valor estándar podría ser una excepción empresarial. Para obtener más información sobre esta opción, consulta el artículo Excepciones de empresa vs. excepciones de aplicación.
18. En el campo Razón, escribe una cadena para explicar por qué se activó la excepción. Una vez ejecutado el proyecto, se muestra esta información en la ventana Detalles del elemento.
19. Conecta ambos Establecer el estado de la transacción a la actividad Obtener elemento de la transacción. Esto crea un bucle y te permite iterar a través de todos los elementos de la cola. Un proyecto de automatización básico debería tener el aspecto que se muestra en la siguiente captura de pantalla.
    
    

    

    
    

    Una asignación de las propiedades en la actividad Establecer estado de la transacción (a la izquierda) y sus campos correspondientes en la ventana Detalles del elemento en Orchestrator.

    
    

    

    
    

Para recuperar datos específicos de un elemento de la cola, se puede utilizar la función SpecificContent(). Escribe entre comillas el nombre del argumento que se ha utilizado para añadir información a la cola.

Por ejemplo, la captura de pantalla anterior muestra el Valor de un campo de una actividad Asignar. Permite recuperar el valor atribuido a un elemento de la cola (que aparece en la ventana Detalles del elemento en la ventana Datos específicos en Orchestrator) y asignarlo a una variable de cadena, para poder procesarlo posteriormente.

En la captura de pantalla anterior:

• transItem: es una variable QueueItem utilizada para almacenar elementos de transacción.
• .SpecificContent: es la función que recupera la información de los elementos de la transacción.
• ("transactionID"): es el nombre del argumento que se añadió en la ventana ItemInformation para rellenar los elementos de la cola con datos. El nombre del argumento también se muestra en la ventana Detalles del elemento, en Datos específicos, en Orchestrator.
• .ToString: es una función utilizada para convertir el ID de la cola, que inicialmente era un entero, en una cadena.

Posponer un elemento de la transacción

1. En Orchestrator, piensa que tienes una cola poblada con múltiples elementos.
2. En Studio, considera que ya tienes una actividad Obtener elemento de transacción que itera a través de todos los elementos de la cola.
3. Desde el panel Actividades, arrastra una actividad Decisión al flujo de trabajo. La actividad te permite hacer una decisión empresarial, en la que posponer algunos elementos en cola. Por ejemplo, si el valor de una factura es mayor a 3000€, puedes posponer su pago.
4. Desde el panel Actividades, arrastra una actividad Posponer elemento de transacción a la sección Verdadero de la Decisión. Esto significa que todos los elementos en cola que cumplen la condición colocada en la actividad Decisión se posponen en según tus configuraciones.
5. En el campo TransactionItem, introduce la variable QueueItem utilizada en la actividad Obtener transacción.
6. En el campo Aplazar, añade la fecha a partir de la cual se puede procesar este elemento.
7. En el campo Plazo, añade la fecha antes de la que debe procesarse este elemento.

   Las propiedades Fecha límite y Posponer añaden una nueva prioridad a los elementos en cola. Por ejemplo, un elemento en cola con fecha límite hoy a las 7 p. m. y tiene una prioridad Media y se procesará antes que un elemento sin fecha límite pero cono prioridad Alta.

   Nota: Modificar el plazo de un elemento de la cola o posponerlo cambia su estado a nuevo.

Añadir un progreso personalizado

1. En Orchestrator, considera que tienes una cola poblada con muchos elementos (millones) con el estado En curso.
2. En Studio, considera que ya tienes una actividad Obtener elemento de transacción que recorre todos los elementos de la cola y utiliza una variable QueueItem.
3. En el panel Actividades, arrastra una actividad Establecer progreso de transacción al panel Diseñador.
4. En la propiedad TransactionItem de la actividad, introduce la variable QueueItem.
5. En la propiedad Progreso, añade una cadena personalizada para describir el progreso alcanzado aquí, como por ejemplo "BeforeFirstDecision". Esto te permite saber que el elemento ha sido recuperado de la base de datos de Orchestrator. Si tu proyecto de automatización se bloquea en este punto durante la ejecución, un elemento tiene este estado y se muestra en la columna Progreso.
   Nota: Los estados de progreso personalizados solo se muestran mientras un elemento tiene el estado en Progreso.

El resto del proyecto de automatización se puede configurar como se ha explicado arriba.

Por ejemplo, en el siguiente ejemplo de flujo de trabajo se establece el estado de cada elemento como Correcto o Erróneo de forma automática, dependiendo de cómo se diseñe la secuencia del Cuerpo de la transacción :

• No hacer nada,interrumpiro continuar: los resultados son correctos
• Lanzar excepción : resultados como fallidos (error de la aplicación)
• Lanzar BusinessRuleException: los resultados como Failed (error de negocio)
• Establecer estado de la transacción : resultados como el estado que establezca
• Posponer elemento de transacción : resultados como nuevo

• Debería detenerse : si detiene el flujo de trabajo desde Orchestrator, el flujo de trabajo existe durante el bucle después de que se complete la transacción actual.

  El flujo de trabajo se repite para cada elemento de la cola automáticamente y establece el estado de transacción correspondiente.

  En caso de interrupción o si la cola está vacía, el flujo de trabajo existe en el bucle.

  
  

  

  
  

Descarga el flujo de trabajo archivado y utilízalo como referencia.