# Colas

**Colas** – es una forma de agrupar Tareas similares, así como de crear flujos de Tareas.

Las colas se pueden considerar como una forma de "almacenar una lista de datos" que necesitan ser procesados. Estas agrupaciones se utilizan para que un sistema externo (o Robots) agregue Tareas a la Cola, y otros Robots ejecuten los elementos de la Cola de Tareas, es decir, extraigan Tareas de una Cola específica y realicen Trabajos. De esta manera, un proceso de negocio largo y complejo puede ser desglosado en un conjunto de procesos simples, cada uno de los cuales será ejecutado por un Robot o un Grupo de robots.

Las Tareas se agregan a la Cola de tres maneras:

* manualmente por el Usuario a través del Orquestador;
* por un Robot utilizando el bloque “Agregar Tarea a la Cola”;
* mediante llamadas a la API.

La pantalla “Colas” contiene dos tablas: “Colas” y “Tareas”.

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-d69bce25e33d141de60ee11ee3bf0a47b3a2ae49%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(235).png?alt=media" alt=""><figcaption></figcaption></figure>

Para trabajar con las Colas, en la pantalla hay los siguientes botones:

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-4ebe2d8c9aa505faa896f2c818f9d78845b96743%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(306).png?alt=media" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="222.111083984375"></th><th width="482.888916015625"></th></tr></thead><tbody><tr><td><strong>Nombre del botón</strong></td><td><strong>Descripción</strong></td></tr><tr><td>Crear</td><td>Permite al Usuario crear una nueva Cola. Al hacer clic, se abre un formulario para ingresar los datos necesarios y configurar los parámetros de la nueva Cola.</td></tr><tr><td>Actualizar</td><td>Permite actualizar la información sobre la Cola seleccionada.</td></tr><tr><td>Eliminar seleccionado</td><td>Permite eliminar una o varias Colas seleccionadas.</td></tr><tr><td>Importar desde CSV</td><td>Permite al Usuario cargar datos sobre Colas desde un archivo en formato CSV. Al seleccionar esta opción, se abre un cuadro de diálogo para cargar el archivo con los datos necesarios.</td></tr><tr><td>Exportar a CSV</td><td>Permite guardar información sobre las Colas en un archivo en formato CSV.</td></tr><tr><td>Exportar a XLSX</td><td>Permite exportar datos sobre las Colas a un archivo en formato XLSX.</td></tr></tbody></table>

Para trabajar con las Tareas, en la pantalla hay los siguientes botones:

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-7930f290ebbf6f619fe234c39a0cd50559ef93e9%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(308).png?alt=media" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="219.55560302734375"></th><th width="484.2222900390625"></th></tr></thead><tbody><tr><td><strong>Nombre del botón</strong></td><td><strong>Descripción</strong></td></tr><tr><td>Crear</td><td>Permite al Usuario crear una nueva Tarea. Al hacer clic, se abre un formulario para ingresar los datos necesarios y configurar los parámetros de la nueva Tarea.</td></tr><tr><td>Actualizar</td><td>Permite actualizar la información sobre la Tarea seleccionada.</td></tr><tr><td>Cambiar estado</td><td><p>Permite cambiar el estado de una o varias Tareas seleccionadas. Opciones posibles:</p><ul><li>Creada;</li><li>En proceso;</li><li>Exitoso;</li><li>Fallido;</li><li>Pospuesto hasta;</li><li>Abandonada.</li></ul></td></tr><tr><td>Clonar tarea</td><td>Permite crear una copia de la Tarea seleccionada con la transferencia automática de todas sus propiedades y parámetros.</td></tr><tr><td>Eliminar seleccionado</td><td>Permite eliminar una o varias Tareas seleccionadas.</td></tr><tr><td>Importar desde CSV</td><td>Permite al Usuario cargar datos sobre Tareas desde un archivo en formato CSV. Al seleccionar esta opción, se abre un cuadro de diálogo para cargar el archivo con los datos necesarios.</td></tr><tr><td>Exportar a CSV</td><td>Permite guardar información sobre las Tareas en un archivo en formato CSV.</td></tr><tr><td>Exportar a XLSX</td><td>Permite exportar datos sobre las Tareas a un archivo en formato XLSX.</td></tr><tr><td>Mostrar diagrama</td><td>Permite visualizar datos sobre las Tareas en forma de diagrama para analizar los estados de las Tareas.</td></tr></tbody></table>

## **Creación de una nueva Cola**

Para crear una nueva Cola, es necesario hacer clic en el botón “Crear” en la tabla “Colas” y completar el formulario que aparece:

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-7e8fc8be9fa1f5afbb7ed64963f9d445a2199abf%2F2025-04-19_21-16-34.png?alt=media" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="57"></th><th width="283.22222900390625"></th><th width="380.77783203125"></th></tr></thead><tbody><tr><td><strong>No.</strong></td><td><strong>Elemento de la interfaz</strong></td><td><strong>Descripción</strong></td></tr><tr><td>1.</td><td>campo de texto “Nombre”</td><td>Nombre de la Cola. Campo obligatorio.</td></tr><tr><td>2.</td><td>campo de texto “Descripción”</td><td>Descripción de la Cola.</td></tr><tr><td>3.</td><td>campo de texto “Carpeta de acceso”</td><td>Permite especificar la Carpeta de acceso para la Cola que se está creando.</td></tr><tr><td>4.</td><td>campo de texto “Cambiar a estado 'Abandonada' las tareas que estén en estado 'Creada' más de la cantidad de minutos especificada”</td><td>Permite especificar la cantidad de minutos después de la cual una Tarea en estado <strong>Creada</strong> será cambiada a estado <strong>Abandonada</strong>.</td></tr><tr><td>5.</td><td>campo de texto “Cambiar a estado 'Abandonada', las tareas que estén en estado 'En proceso' más de la cantidad de minutos especificada”</td><td>Permite especificar la cantidad de minutos después de la cual una Tarea en estado <strong>En proceso</strong> será cambiada a estado <strong>Abandonada</strong>.</td></tr><tr><td>6.</td><td>flag “Cambio automático de estado de la tarea, que está<br>'En proceso' a 'Fallido (Aplicación)', si el Trabajo relacionado ha cambiado a estado 'Fallido/Detenido/Interrumpido'”</td><td>Permite activar la función de cambio automático de estado de la Tarea de <strong>En proceso</strong> a <strong>Fallido</strong> <strong>(Aplicación)</strong>, si el Trabajo relacionado ha cambiado a estado <strong>Fallido</strong>/<strong>Detenido</strong>/<strong>Interrumpido</strong>.</td></tr><tr><td>7.</td><td>flag “Reintento automático de tareas en estado Fallido (Aplicación)”</td><td>Permite activar la función de reintento automático de Tareas que están en estado <strong>Fallido (Aplicación)</strong>.</td></tr><tr><td>8.</td><td>flag “Reintento automático de tareas en estado Fallido (Negocio)”</td><td>Permite activar la función de reintento automático de Tareas que están en estado <strong>Fallido (Negocio)</strong>.</td></tr><tr><td>9.</td><td>flag “Reintento automático de tareas en estado Abandonada”</td><td>Permite activar la función de reintento automático de Tareas que están en estado <strong>Abandonada</strong>.</td></tr><tr><td>10.</td><td>campo de texto “Número máximo de reintentos”</td><td>Permite especificar el número máximo de reintentos de las Tareas.</td></tr><tr><td>11.</td><td>flag “Prohibir la adición de tareas con nombres duplicados”</td><td>Permite activar la función de prohibir la adición a la Cola de Tareas con nombres duplicados.</td></tr></tbody></table>

## **Edición de una Cola creada previamente**

Para ver y editar las propiedades de una Cola específica, es necesario seleccionarla en la lista y hacer clic en el ícono ![](https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-690447737878822a051c1768d4d44828fa21d624%2F2025-03-19_21-36-15.png?alt=media). Después de esto, se abrirá un formulario con la configuración de la Cola, en el que se pueden realizar los cambios necesarios:

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-6f2b560e795580eb80183e4a878be86119e7861f%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(241).png?alt=media" alt=""><figcaption></figcaption></figure>

Además de los campos que se completan al crear la Cola, al editar se indica el **GUID** (identificador único asignado a la Cola después de su creación) en el campo "GUID de registro". Este campo no se puede editar.

## **Creación de una nueva Tarea**

Para crear una nueva Tarea, es necesario hacer clic en el botón “Crear” en la tabla “Tareas” y completar el formulario que aparece:

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-bab00cea23cd56dd276c6ff4d3f1b326b61d012c%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(309).png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Para que aparezca una lista de Tareas en la tabla “Tareas”, es necesario activar el flag en una de las Colas.
{% endhint %}

El formulario contiene los siguientes elementos:

<table data-header-hidden><thead><tr><th width="56"></th><th width="195"></th><th></th></tr></thead><tbody><tr><td><strong>№ p/p</strong></td><td><strong>Elemento de interfaz</strong></td><td><strong>Descripción</strong></td></tr><tr><td>1.</td><td>campo de texto “Nombre”</td><td>Nombre de la Tarea. Campo obligatorio.</td></tr><tr><td>2.</td><td>campo de texto “Descripción”</td><td>Descripción de la Tarea.</td></tr><tr><td>3.</td><td>campo de texto “Comentario”</td><td>Comentario sobre la Tarea.</td></tr><tr><td>4.</td><td>campo “Prioridad”</td><td><p>Prioridad de ejecución de la Tarea. Opciones posibles:</p><ul><li>Baja;</li><li>Normal;</li><li>Alta;</li><li>Plazo.</li></ul></td></tr><tr><td>5.</td><td>campo de texto “Etiquetas”</td><td>Etiquetas de la Tarea.</td></tr><tr><td>6.</td><td>campo de texto “Repeticiones”</td><td>Cantidad de repeticiones de ejecución de la Tarea.</td></tr></tbody></table>

## **Edición de una Tarea creada anteriormente**

Para ver y editar las propiedades de una Tarea específica, es necesario seleccionarla en la lista y hacer clic en el ícono ![](https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-690447737878822a051c1768d4d44828fa21d624%2F2025-03-19_21-36-15.png?alt=media). Después de esto, se abrirá un formulario con la configuración de la Tarea, donde se pueden realizar los cambios necesarios:

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-7c5f9d816fea2a507619d5a92eb0e346a59e5783%2F2025-04-19_21-32-53.png?alt=media" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="55"></th><th width="208"></th><th width="483.7777099609375"></th></tr></thead><tbody><tr><td><strong>№ p/p</strong></td><td><strong>Elemento de interfaz</strong></td><td><strong>Descripción</strong></td></tr><tr><td>1.</td><td>campo de texto “GUID”</td><td>Identificador único asignado a la Tarea después de su creación. Este campo no se puede editar.</td></tr><tr><td>2.</td><td>campo de texto “Estado”</td><td><p>Estado de la Tarea. Opciones posibles:</p><ul><li>Creado;</li><li>En proceso;</li><li>Exitoso;</li><li>Fallido (Aplicación);</li><li>Fallido (Negocio);</li><li>Pospuesto hasta;</li><li>Abandonado.</li></ul></td></tr><tr><td>3.</td><td>campo “Pospuesto hasta”</td><td><p>Fecha y hora hasta la cual se ha pospuesto la Tarea en el formato: DD.MM.AAAA horas:minutos.<br></p><p>Al llegar la fecha y hora “Pospuesto hasta”, la Tarea se considera según su prioridad y se ejecuta en orden de Cola.</p></td></tr><tr><td>4.</td><td>campo “Plazo”</td><td>Fecha y hora del plazo para la ejecución de esta Tarea.</td></tr><tr><td>5.</td><td>campo “Creado”</td><td>Fecha y hora en que se creó la Tarea. Este campo no se puede editar.</td></tr><tr><td>6.</td><td>campo “Actualizado”</td><td>Fecha y hora en que se actualizó la Tarea. Este campo no se puede editar.</td></tr></tbody></table>

## **Parámetros de la Tarea**

Para las Tareas ya creadas están disponibles los “Parámetros de la tarea”. Para abrir el formulario de parámetros, es necesario hacer clic en el ícono ![](https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-82771284993ac0f983a8e7b7d7e2e79bf3ef7afb%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20\(313\).png?alt=media). Para especificar los parámetros de la Tarea, hay tres tipos de datos disponibles:

* **Texto**;
* **Tabla**;
* **Tabla hash**.

El tipo de datos **Texto** permite guardar el texto necesario como parámetro de la Tarea en el campo de texto destinado para ello:

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-556b207271bb4aa817572021f3fc50c1dffc58b3%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(311).png?alt=media" alt=""><figcaption></figcaption></figure>

El tipo de datos **Tabla** permite crear y guardar una tabla como parámetro de la Tarea en el editor de tablas destinado para ello:

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-3e68ff83cf73ca7563b03a0f06294bd257691828%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(312).png?alt=media" alt=""><figcaption></figcaption></figure>

El tipo de datos **Tabla hash** permite crear y guardar una tabla hash (especificar pares clave-valor) como parámetro de la Tarea en los campos destinados para ello, donde el parámetro es la clave:

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-6dc9a36516c571a9eb3afa96b00bcc0a26f2dadb%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(310).png?alt=media" alt=""><figcaption></figcaption></figure>

[El trabajo con Tareas en Sherpa Designer se describe aquí.](https://docs.sherparpa.ru/es/sherpa-rpa/sherpa-orchestrator/rabota-v-sherpa-orchestrator/nachalo-raboty-v-sherpa-orchestrator/sozdanie-zadachi-v-orkestratore/rabota-s-zadachami-v-sherpa-designer)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sherparpa.ru/es/sherpa-rpa/sherpa-orchestrator/rabota-v-sherpa-orchestrator/ekrany/ocheredi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
