# Trabajo con Tareas en Sherpa Designer
En el lado del Diseñador, el trabajo con Tareas se realiza a través de los siguientes bloques de la paleta del Orquestador:
* **Agregar Tarea a la Cola;**
* **Agregar Tareas a la Cola;**
* **Obtener Tarea de la Cola;**
* **Obtener lista de Tareas de la Cola;**
* **Modificar Tarea;**
* **Eliminar Tarea de la Cola;**
* **Obtener Tarea;**
* **Obtener Tarea por defecto.**
Veamos más de cerca el funcionamiento de cada uno de los bloques.
## Agregar Tarea a la Cola
Al utilizar el bloque “**Agregar tarea a la cola**” en el panel de propiedades del bloque, indique los siguientes datos:
* “**GUID/Nombre de la Cola**” (campo obligatorio);
* “**Nombre\***” – nombre de la Tarea (campo obligatorio);
* “**Descripción**” – indique la descripción de la Tarea si es necesario;
* “**Parámetros**” – indique un diccionario con los parámetros para la Tarea;
* “**Posponer hasta**” – indique la fecha y hora hasta las cuales se pospone la Tarea en el formato: DD.MM.AAAA horas:minutos;
* “**Fecha límite**” – indique la fecha y hora de la fecha límite para la ejecución de esta Tarea en el formato: DD.MM.AAAA horas:minutos. En caso de que el tiempo indicado ya haya pasado, la Tarea recibirá la máxima prioridad en la Cola\
(es decir, cuando el Robot recibe la siguiente Tarea de la Cola por orden de prioridad, esta Tarea será recibida antes que las Tareas con prioridad “Alta”);
* “**Prioridad**” – indique si necesita filtrar las Tareas por su prioridad al llegar. Al seleccionar cualquier prioridad, las Tareas llegarán en orden de alta a baja prioridad;
* “**Lista de etiquetas**” – indique la lista de etiquetas de la Tarea separadas por punto y coma;
* “**Comentario**” – indique un comentario sobre la Tarea;
* “**Tiempo de espera**” – indique el tiempo de ejecución de la solicitud en segundos.
Al final, obtendrá el “**GUID de la Tarea**” y el “**Objeto de la Tarea**” del tipo $TaskObject. Con este objeto podrá trabajar en cualquier bloque, expresión, para ello utilice las sugerencias en la ventana [“Editar expresión”](https://docs.sherparpa.ru/es/sherpa-rpa/sherpa-designer/rabota-v-sherpa-designer/paneli-svoistv-i-peremennykh-i-rabota-s-nimi/panel-svoistv)“Ejemplos de trabajo con objetos de tarea TaskObject”.
## Agregar Tareas a la Cola
Al utilizar el bloque “**Agregar tareas a la cola**” en sus propiedades en el panel de propiedades del bloque, indique los siguientes datos:
* “**GUID/Nombre de la Cola**” (campo obligatorio);
* “**Tabla con parámetros**” – indique la tabla con parámetros, por cada fila de la cual se creará una nueva Tarea;
* “**Prefijo del nombre**” – indique el prefijo de los nombres de las Tareas. Al establecer un prefijo no vacío, cada Tarea creada por este bloque recibirá un nombre que comienza con el prefijo indicado. Si no se indica un prefijo, las tareas se nombrarán en orden, y su identificación en la lista puede ser difícil;
* “**Índice de la columna con el nombre**” – indique el índice de la columna con los nombres de las Tareas en la tabla de entrada;
* “**Número de hilos**” – indique el número de hilos para la creación de Tareas. Si se indica un valor mayor que 2, el proceso de creación de Tareas se dividirá en hilos.
* “**Agregar fecha y hora**” – marque la casilla si necesita que se agregue la fecha y hora actuales al nombre al activarse;
* “**Descripción**” – descripción de las Tareas (si es necesario);
* “**Posponer hasta**” – indique la fecha y hora hasta las cuales se posponen las Tareas en el formato: DD.MM.AAAA horas:minutos;
* “**Fecha límite**” – indique la fecha y hora de la fecha límite para la ejecución de las Tareas en el formato: DD.MM.AAAA horas:minutos. En caso de que el tiempo indicado ya haya pasado, las Tareas recibirán la máxima prioridad en la Cola (es decir, cuando el Robot recibe la siguiente Tarea de la Cola por orden de prioridad, estas Tareas serán recibidas antes que las Tareas con prioridad “Alta”);
* “**Prioridad**” – indique si necesita filtrar las Tareas por su prioridad al llegar. Al seleccionar cualquier prioridad, las Tareas llegarán en orden de alta a baja prioridad;
* “**Lista de etiquetas**” – indique la lista de etiquetas de las Tareas separadas por punto y coma;
* “**Tipo de parámetros**” – seleccione el tipo de parámetros de las Tareas. Valores posibles: Hashtable (diccionario) y DataTable (tabla de datos con una fila);
* “**Tiempo de espera**” – indique el tiempo de ejecución de la solicitud en segundos.
Al final, obtendrá una lista de GUID de las Tareas creadas.
## Obtener Tarea de la Cola
Al utilizar el bloque “**Obtener tarea de la cola**” en sus propiedades en el panel de propiedades del bloque, indique los siguientes datos:
* “**GUID/Nombre de la Cola**” (campo obligatorio);
* “**GUID de la tarea**” – indique si necesita una Tarea específica;
* “**Nombre de la tarea**” – indique el nombre de la Tarea si necesita filtrar las Tareas por su nombre;
* “**Estado de la tarea**” – indique si necesita recibir Tareas solo con un estado específico;
* “**Prioridad de la tarea**” – indique si necesita filtrar las Tareas por su prioridad al llegar. Al seleccionar cualquier prioridad, las Tareas llegarán en orden de alta a baja prioridad;
* “**Desplazamiento**” – utilice esta propiedad si necesita obtener de la cola no la primera Tarea, sino la n-ésima en la cuenta (5, 10, etc.);
* “**Filtro por etiquetas**” – indique etiquetas separadas por punto y coma si necesita filtrar las Tareas por ellas. Si necesita que una etiqueta específica esté presente en la Tarea, coloque un “+” delante de ella, si necesita excluir Tareas con una etiqueta específica, coloque un “-” delante de ella;
* “**Creado después**” – utilice esta propiedad si necesita que en el resultado solo se incluyan aquellas Tareas cuya CreatedAt sea mayor o igual al valor de este campo. La fecha y hora deben indicarse en el formato: DD.MM.AAAA horas:minutos;
* “**Tomar en trabajo**” – utilice esta propiedad si necesita obtener una Tarea de la Cola y tomarla inmediatamente en trabajo como una operación atómica. Esta opción es útil en caso de que varios Robots terminen de trabajar con la Tarea anterior y intenten tomar la siguiente Tarea de la Cola. La opción “Tomar en trabajo” garantiza que una Tarea específica será tomada en trabajo por un Robot específico. Si la opción no se ha activado y se ha dado la situación descrita anteriormente, aparecerá una notificación de error en el Diseñador;
* “**Sobrescribir objeto de parámetros**” – marque la casilla si necesita que el objeto de parámetros ya indicado sea sobrescrito. Esta propiedad es relevante para la tabla de datos, si se utiliza una referencia a una fila de esta tabla, ya que al activarse la referencia a la fila no se perderá;
* “**Error al no encontrar tareas**” – marque la casilla si necesita que en caso de que no se encuentre la Tarea, se genere un error. De lo contrario, en la propiedad "Objeto de tarea" se devolverá una cadena vacía;
* “**Tiempo de espera**” – indique el tiempo de ejecución de la solicitud en segundos.
Al final, obtendrá los siguientes datos:
* **GUID de la Tarea;**
* **Nombre;**
* **Parámetros;**
* **Objeto de la tarea.**
## Obtener lista de Tareas de la Cola
Al utilizar el bloque “**Obtener lista de tareas de la cola**” en sus propiedades en el panel de propiedades del bloque, indique los siguientes datos:
* “**GUID/Nombre de la Cola**” (campo obligatorio);
* “**GUID de la tarea**” – indique si necesita una Tarea específica;
* “**Nombre de la tarea**” – indique el nombre de la Tarea;
* “**Estado de la tarea**” – indique si necesita recibir Tareas solo con un estado específico;\* “**Prioridad de la tarea**” – indique si necesita filtrar las Tareas por su prioridad al recibirlas. Al seleccionar cualquier prioridad, las Tareas se recibirán en orden de alta a baja prioridad.
* “**Desplazamiento**” – utilice esta propiedad si necesita obtener de la Cola no la primera tarea, sino la n-ésima (5, 10, etc.);
* “**Cantidad máxima**” – indique la cantidad máxima de Tareas que debe devolverse. Si no se especifica este parámetro, no se devolverán más de 100 Tareas;
* “**Filtro por etiquetas**” – indique las etiquetas separadas por punto y coma si necesita filtrar las Tareas por ellas. Si es necesario que una etiqueta específica esté presente en la Tarea, colóquele un “+” delante; si necesita excluir Tareas con una etiqueta específica, colóquele un “-” delante;
* “**Creado después**” – utilice esta propiedad si necesita que en el resultado solo se incluyan aquellas Tareas cuya CreatedAt sea mayor o igual al valor de este campo. La fecha y hora deben indicarse en el formato: DD.MM.AAAA horas:minutos;
* “**Tomar en trabajo**” – utilice esta propiedad si necesita obtener una Tarea de la Cola y tomarla inmediatamente en trabajo como una operación atómica. Al usar el bloque “Obtener lista de tareas de la cola”, no se recomienda utilizar esta función;
* “**Tiempo de espera**” – indique el tiempo de ejecución de la solicitud en segundos;
* “**Error al no encontrar tareas**” – establezca la bandera si necesita que, en caso de que no se encuentre la lista de Tareas, se genere un error; de lo contrario, se devolverá una lista vacía.
Como resultado, obtendrá los siguientes datos:
* **Lista de GUID de tareas;**
* **Lista de nombres de tareas;**
* **Lista de objetos de tareas;**
* **Cantidad de tareas.**
## Modificar Tarea
Al usar el bloque “**Modificar tarea**” en sus propiedades en el panel de propiedades del bloque, indique los siguientes datos:
* “**GUID/Nombre de la Tarea**” (campo obligatorio);
* “**Nombre**” – indique el nombre de la Tarea. En caso de que en el campo “GUID/Nombre de la Tarea” se indique el nombre de la Tarea, este campo debe dejarse vacío;
* “**Estado**” – indique si necesita obtener la Tarea solo con un estado específico;
* “**Parámetros**” – indique un diccionario con parámetros para la Tarea;
* “**Prioridad**” – indique si necesita filtrar las Tareas por su prioridad al recibirlas. Al seleccionar cualquier prioridad, las Tareas se recibirán en orden de alta a baja prioridad;
* “**Posponer hasta**” – indique la fecha y hora hasta las cuales se ha pospuesto la Tarea en el formato: DD.MM.AAAA horas:minutos;
* “**Fecha límite**” – indique la fecha y hora de la fecha límite para la ejecución de esta Tarea en el formato: DD.MM.AAAA horas:minutos. En caso de que el tiempo indicado ya haya pasado, la Tarea recibirá la máxima prioridad en la Cola\
(es decir, cuando el Robot recibe la siguiente Tarea de la Cola en orden de prioridad, esta Tarea será recibida antes que las Tareas con prioridad “Alta”);
* “**Lista de etiquetas**” – indique la lista de etiquetas de la Tarea separadas por punto y coma;
* “**Comentario**” – indique el comentario de la Tarea;
* “**Tiempo de espera**” – indique el tiempo de ejecución de la solicitud en segundos.
## Eliminar Tarea de la Cola
Al usar el bloque “Eliminar tarea de la cola” en sus propiedades en el panel de propiedades del bloque, indique los siguientes datos:
* “**GUID/Nombre de la Cola**” (campo obligatorio);
* “**GUID de la tarea**” – indique si necesita una Tarea específica;
* “**Nombre de la tarea**” – indique el nombre de la Tarea;
* “**Estado de la tarea**” – indique si necesita recibir Tareas solo con un estado específico;
* “**Prioridad de la tarea**” – indique si necesita filtrar las Tareas por su prioridad al recibirlas. Al seleccionar cualquier prioridad, las Tareas se recibirán en orden de alta a baja prioridad;
* “**Filtro por etiquetas**” – indique las etiquetas separadas por punto y coma si necesita filtrar las Tareas por ellas. Si es necesario que una etiqueta específica esté presente en la Tarea, colóquele un “+” delante; si necesita excluir Tareas con una etiqueta específica, colóquele un “-” delante;
* “**Tiempo de espera**” – indique el tiempo de ejecución de la solicitud en segundos.
Como resultado, obtendrá el GUID de la Tarea eliminada.
## Obtener Tarea
Al usar el bloque “**Obtener tarea**” en sus propiedades en el panel de propiedades del bloque, indique los siguientes datos:
* “**GUID/Nombre de la Tarea**” (campo obligatorio);
* “**Tiempo de espera**” – indique el tiempo de ejecución de la solicitud en segundos.
Como resultado, obtendrá los siguientes datos:
* **Objeto de tarea;**
* **GUID de la tarea;**
* **Nombre de la tarea;**
* **Parámetros de la tarea;**
* **Prioridad de la tarea;**
* **Estado de la tarea;**
* **Cantidad de repeticiones de la tarea;**
* **Fecha de creación de la tarea;**
* **Fecha de modificación de la tarea;**
* **Tarea pospuesta hasta;**
* **Fecha límite de la tarea;**
* **Etiquetas de la tarea.**
## Obtener Tarea por defecto
El bloque “**Obtener tarea por defecto**” obtiene la Tarea asignada al trabajo actual que está realizando el Robot:
Como resultado, obtendrá los siguientes datos:
* **GUID de la Tarea;**
* **Nombre;**
* **Parámetros;**
* **Objeto de tarea.**
---
# 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/nachalo-raboty-v-sherpa-orchestrator/sozdanie-zadachi-v-orkestratore/rabota-s-zadachami-v-sherpa-designer.md?ask=
```
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.
.png?alt=media)