Получить из очереди по ID

Peek queue by ID

Компонент позволяет получить элемент очереди обмена данными по его идентификатору (ID). Полученный из Оркестратора элемент сохраняется в переменную. Переменная может быть разных типов — строка, объект или DataTable. Выбор переменной осуществляется на ваше усмотрение.

Существует разница между «получением» элемента и его «извлечением» из очереди. При получении элемента его статус не меняется. При извлечении – другие роботы больше не смогут взять ваш элемент в работу. Только ваш робот будет иметь право изменять состояние извлеченного элемента или удалять его из очереди. Чтобы робот не просто получил, а извлек элемент из очереди, установите в свойствах компонента чекбокс Занимать. Извлекать возможно только элементы в статусе New. Подробнее о статусах элемента см. здесь.

Перед началом работы с компонентом убедитесь, что настроена связь Студии и Оркестратора.

Свойства

Символ * в названии свойства указывает на обязательность заполнения. Описание общих свойств см. в разделе Свойства элемента.

Свойство	Тип	Описание	Пример
Процесс:
Очередь*	String	Название очереди в Оркестраторе, чувствительно к регистру	"Queue name"
ID*	Guid	ID элемента очереди Оркестратора, указывается в виде переменной
Таймаут	Int32	Лимит времени операции (мс). Если по истечении лимита операция не выполнена, робот закончит работу с ошибкой. С версии 1.24.8 таймаут по умолчанию составляет 30000(30 секунд).
Занимать	Boolean	По умолчанию флаг НЕАКТИВЕН. Определяет, нужно ли занимать отфильтрованные записи. Если установлен, то в ответе вернутся только те значения, которые можно сразу же изъять из очереди, чтобы далее с ними работал ваш робот
Вывод:
Элемент	LTools.Enterprise.Model.QueueItem	Переменная для хранения элемента очереди в виде объекта
Таблица	DataTable	Переменная для хранения полученных данных в табличном виде
Результат	String	Переменная для хранения полученных данных в строковом виде

Только код

Ниже приведен пример использования элемента в процессе с типом Только код (Pure code):

C#

object ret = LTools.Enterprise.OrchestratorApp.PeekQueueById(wf, "queue", id, false);

Python

ret = LTools.Enterprise.OrchestratorApp.PeekQueueById(wf, "queue", id, false)

JavaScript

var ret = _lib.LTools.Enterprise.OrchestratorApp.PeekQueueById(wf, "queue", id, false);

Дополнительно

• Изменить статус в очереди — присваивает элементу финальный статус обработки.

• Удалить из очереди — удаляет элемент из очереди.