Работа с задачами в Sherpa Designer

На стороне Дизайнера работа с задачами осуществляется через следующие блоки палитры Оркестратора:

• Добавить задачу в очередь;

• Добавить задачи в очередь;

• Получить задачу из очереди;

• Получить список задач из очереди;

• Изменить задачу;

• Удалить задачу из очереди;

• Получить задачу.

Рассмотрим подробнее работу каждого из блоков.

При использовании блока “Добавить задачу в очередь” на панели свойств блока укажите следующие данные.

• “GUID/Имя Очереди”. (обязательное для заполнения поле);

• “Название” – название задачи (обязательное для заполнения поле);

• “Описание” – укажите описание задачи при необходимости;

• “Параметры” – укажите словарь с параметрами для задачи;

• “Отложить до” – укажите дату и время, до которых отложена задача в формате: ДД.ММ.ГГГГ часы:минуты;

• “Дедлайн” – укажите дату и время дедлайна для выполнения данной задачи в формате: ДД.ММ.ГГГГ часы:минуты. В случае если указанное время уже прошло, задача получит наивысший приоритет в очереди (т.е., когда робот получает очередную задачу из очереди в порядке приоритета, эта задача будет получена раньше, чем задачи с приоритетом “Высокий”);

• “Приоритет” – укажите, если Вам необходимо отфильтровать задачи по их приоритету, при их поступлении. При выборе любого приоритета задачи будут поступать в порядке от высокого приоритета к низкому;

• “Список тегов” – укажите список тегов задачи через точку с запятой;

• “Комментарий” – укажите комментарий задачи;

• “Время ожидания” – укажите время выполнения запроса в секундах.

На выходе Вы получите сформированные “GUID Задачи” и “Объект Задачи” типа $TaskObject. С данным объектом вы сможете работать в любом блоке, выражении, для этого воспользуйтесь подсказками в окне “Редактировать выражение” “Примеры работы с объектами задачи TaskObject”.

При использовании блока “Добавить задачи в очередь” в его свойствах на панели свойств блока укажите следующие данные.

• “GUID/Имя Очереди”. (обязательное для заполнения поле);

• “Таблица с параметрами” – укажите таблицу с параметрами, по каждой строке которой будет создана новая задача;

• “Префикс названия” – укажите префикс названий задач. Данное свойство позволяет приписывать создаваемые задачам одинаковые префиксы в названии задачи. В случае указания непустого префикса, каждая созданная данным блоком задача будет иметь название, начинающееся на этот префикс, и к нему будет приписаны текущие дата и время;

• “Индекс колонки с названием” – укажите индекс колонки с названиями задач во входной таблице;

• “Количество потоков” – укажите количество потоков создания задач. Если указано значение больше, чем 2, то процесс создания задач будет разбит на потоки.

• “Добавлять дату и время” – установите флаг, если Вам необходимо, чтобы к имени добавлялась текущая дата и время при включении;

• “Описание” – описание задач (при необходимости);

• “Отложить до” – укажите дату и время, до которых отложены задачи в формате: ДД.ММ.ГГГГ часы:минуты;

• “Дедлайн” – укажите дату и время дедлайна для выполнения задач в формате: ДД.ММ.ГГГГ часы:минуты. В случае если указанное время уже прошло, задачи получат наивысший приоритет в очереди (т.е., когда робот получает очередную задачу из очереди в порядке приоритета, эти задачи будут получены раньше, чем задачи с приоритетом “Высокий”);

• “Приоритет” – укажите, если Вам необходимо отфильтровать задачи по их приоритету, при их поступлении. При выборе любого приоритета задачи будут поступать в порядке от высокого приоритета к низкому;

• “Список тегов” – укажите список тегов задач через точку с запятой;

• “Тип параметров” – выберите типа параметров задач. Возможные значения: Hashtable (словарь) и DataTable (таблица данных с одной строкой);

• “Время ожидания” – укажите время выполнения запроса в секундах.

На выходе Вы получите сформированный список GUID созданных задач.

При использовании блока “Получить задачу из очереди” в его свойствах на панели свойств блока укажите следующие данные.

• “GUID/Имя Очереди”. (обязательное для заполнения поле);

• “GUID задачи” – укажите, если Вам необходима конкретная задача;

• “Название задачи” – укажите название задачи, если Вам необходимо отфильтровать задачи по их названию;

• “Статус задачи” – укажите, если Вам необходимо получать задачи только с определенным статусом;

• “Приоритет задачи” – укажите, если Вам необходимо отфильтровать задачи по их приоритету при поступлении. При выборе любого приоритета задачи будут поступать в порядке от высокого приоритета к низкому.

• “Смещение” – используйте это свойство, если Вам необходимо получить из очереди не первую задачу, а n-ую по счету (5, 10 и т.д.);

• “Фильтр по тегам” – укажите теги через точку с запятой, если Вам необходимо отфильтровать задачи по ним. Если необходимо, чтобы конкретный тег присутствовал в задачи поставьте перед ним “+”, если необходимо исключить задачи с определенным тегом поставьте перед ним “-”;

• “Созданы позднее” – используйте это свойство, если Вам необходимо, чтобы в результат попали только те задачи, у которых CreatedAt больше или равно значению этого поля. Дату и время следует указывать в формате: ДД.ММ.ГГГГ часы:минуты.

• “Взять в работу” – используйте это свойство, если Вам необходимо получить задачу из очереди и сразу взять ее в работу по принципу атомарной операции. Данная опция полезна в случае, если одновременно несколько роботов заканчивают работу с предыдущей задачей и пытаются взять в работу следующую задачу из очереди. Установленный флаг “Взять в работу” гарантирует, что определенная задача будет взята в работу конкретным роботом. Если флаг не был установлен и сложилась описанная выше ситуация, то в Дизайнере появится уведомление об ошибке;

• “Перезаписывать объект параметров” – установите флаг, если Вам необходимо, чтобы уже указанный объект параметров перезаписывался. Данное свойство актуально для таблицы данных, если используется ссылка на строку этой таблицы, т.к. при включении ссылка на строку не будет потеряна;

• “Ошибка при отсутствии задач” – установите флаг, если Вам необходимо, чтобы в случае, если задача не будет найдена, была сгенерирована ошибка, иначе в свойстве “Объект задачи” возвратится пустая строка;

• “Время ожидания” – укажите время выполнения запроса в секундах.

На выходе Вы получите следующие данные:

• GUID Задачи;

• Название;

• Параметры;

• Объект задачи.

При использовании блока “Получить список задач из очереди” в его свойствах на панели свойств блока укажите следующие данные.

• “GUID/Имя Очереди”. (обязательное для заполнения поле);

• “GUID задачи” – укажите, если Вам необходима конкретная задача;

• “Название задачи” – укажите название задачи;

• “Статус задачи” – укажите, если Вам необходимо получать задачи только с определенным статусом;

• “Приоритет задачи” – укажите, если Вам необходимо отфильтровать задачи по их приоритету, при их поступлении. При выборе любого приоритета задачи будут поступать в порядке от высокого приоритета к низкому.

• “Смещение” – используйте это свойство, если Вам необходимо получить из очереди не первую задачу, а n-ую по счету (5, 10 и т.д.);

• “Максимальное количество” – укажите максимальное количество задач, которое должно возвращаться. Если параметр не указан, возвращается не больше 100 Задач.

• “Фильтр по тегам” – укажите теги через точку с запятой, если Вам необходимо отфильтровать задачи по ним. Если необходимо, чтобы конкретный тег присутствовал в задачи поставьте перед ним “+”, если необходимо исключить задачи с определенным тегом поставьте перед ним “-”;

• “Созданы позднее” – используйте это свойство, если Вам необходимо, чтобы в результат попали только те задачи, у которых CreatedAt больше или равно значению этого поля. Дату и время следует указывать в формате: ДД.ММ.ГГГГ часы:минуты.

• “Взять в работу” – используйте это свойство, если Вам необходимо получить задачу из очереди и сразу взять ее в работу по принципу атомарной операции. При использовании блока “Получить список задач из очереди” не рекомендуется использовать данную функцию.

• “Время ожидания” – укажите время выполнения запроса в секундах;

• “Ошибка при отсутствии задач” – установите флаг, если Вам необходимо, чтобы в случае, если список задач не будет найден, была сгенерирована ошибка, иначе возвратится пустой список.

На выходе Вы получите следующие данные:

• Список GUID задач;

• Список названий задач;

• Список объектов задач;

• Количество задач.

При использовании блока “Изменить задачу” в его свойствах на панели свойств блока укажите следующие данные.

• “GUID/Имя Задачи”. (обязательное для заполнения поле);

• “Название” – укажите название задачи. В случае, если в поле “GUID/Имя Задачи” указано имя задачи, данное поле следует оставить пустым;

• “Статус” – укажите, если Вам необходимо получить задачу только с определенным статусом;

• “Параметры” – укажите словарь с параметрами для задачи;

• “Приоритет” – укажите, если Вам необходимо отфильтровать задачи по их приоритету, при их поступлении. При выборе любого приоритета задачи будут поступать в порядке от высокого приоритета к низкому.

• “Отложить до” – укажите дату и время, до которых отложена задача в формате: ДД.ММ.ГГГГ часы:минуты;

• “Дедлайн” – укажите дату и время дедлайна для выполнения данной задачи в формате: ДД.ММ.ГГГГ часы:минуты. В случае если указанное время уже прошло, задача получит наивысший приоритет в очереди (т.е., когда робот получает очередную задачу из очереди в порядке приоритета, эта задача будет получена раньше, чем задачи с приоритетом “Высокий”);

• “Список тегов” – укажите список тегов задачи через точку с запятой;

• “Комментарий” – укажите комментарий задачи;

• “Время ожидания” – укажите время выполнения запроса в секундах.

При использовании блока “Удалить задачу из очереди” в его свойствах на панели свойств блока укажите следующие данные.

• “GUID/Имя Очереди”. (обязательное для заполнения поле);

• “GUID задачи” – укажите, если Вам необходима конкретная задача;

• “Название задачи”;

• “Статус задачи” – укажите, если Вам необходимо получать задачи только с определенным статусом;

• “Приоритет задачи” – укажите, если Вам необходимо отфильтровать задачи по их приоритету, при их поступлении. При выборе любого приоритета задачи будут поступать в порядке от высокого приоритета к низкому.

• “Фильтр по тегам” – укажите теги через точку с запятой, если Вам необходимо отфильтровать задачи по ним. Если необходимо, чтобы конкретный тег присутствовал в задачи поставьте перед ним “+”, если необходимо исключить задачи с определенным тегом поставьте перед ним “-”;

• “Время ожидания” – укажите укажите время выполнения запроса в секундах.

На выходе Вы получите GUID удаленной задачи.

При использовании блока “Получить задачу” в его свойствах на панели свойств блока укажите следующие данные.

• “GUID/Имя Задачи”. (обязательное для заполнения поле);

• “Время ожидания” – укажите укажите время выполнения запроса в секундах.

На выходе Вы получите следующие данные:

• Объект задачи;

• GUID задачи;

• Имя задачи;

• Параметры задачи;

• Приоритет задачи;

• Статус задачи;

• Количество повторов задачи;

• Дата создания задачи;

• Дата изменения задачи;

• Задача отложена до;

• Дедлайн задачи;

• Теги задачи.

Блок “Получить задачу по умолчанию” получает задачу, заданную текущей работой, которую выполняет робот.

На выходе Вы получите следующие данные:

• GUID Задачи;

• Название;

• Параметры;

• Объект задачи.