Ресурсы#

Экран Ресурсы позволяет хранить общие реквизиты, текст и календари для сценариев Роботов. На нем представлены таблицы "Группы ресурсов" и "Ресурсы":

Здесь можно создавать Ресурсы, которые будут использоваться Роботами.

Робот или Роботы, имеющие доступ к Ресурсу, могут запросить или установить значение соответствующего Ресурса через соответствующие блоки или через API. Поддерживаемые типы Ресурсов:

  • Реквизиты (логин и пароль);
  • Текст (текстовое поле);
  • Календарь (рабочие/нерабочие дни).

Пароли ресурсов защищаются в хранилище Оркестратора. При настроенном Vault секрет может храниться в нем. Правила хранения не распространяются на выгруженный файл.

К Ресурсам Оркестратора можно обращаться из Робота, получать и устанавливать значения глобальных переменных, а также получать или устанавливать реквизиты.

Со стороны Робота можно воспользоваться Ресурсами с помощью блоков из палитры Оркестратор в Sherpa Designer.

Группа All Assets и экспорт реквизитов#

Для каждого Аккаунта используется собственная защищенная Группа ресурсов "All Assets". В ней отображаются все неудаленные Ресурсы этого Аккаунта в выбранных Папках доступа, доступных Пользователю. Каждый Ресурс отображается один раз.

При создании, импорте или добавлении Ресурса в обычную Группу ресурсов Оркестратор также добавляет его в "All Assets" этого Аккаунта. Если системной группы еще нет, она создается автоматически. После обновления Оркестратора созданные ранее Ресурсы с недостающей связью также включаются в "All Assets".

Удаление связи с обычной группой сохраняет Ресурс в "All Assets". Обычные группы показывают только включенные в них Ресурсы. Для дополнительных связей используется действие "Добавить в Группы". Переименование, удаление и ручное изменение состава системной группы недоступны. Выбор "All Assets" при создании или импорте Ресурса поддерживается.

Для просмотра Ресурсов необходимо открыть экран Ресурсы, выбрать доступные Папки доступа и группу "All Assets" в таблице "Группы ресурсов". Для экспорта без выбора строк необходимо установить нужные фильтры в таблице "Ресурсы" и нажать на кнопку "Экспорт в CSV" или "Экспорт в XLSX" над ней. В файл попадут все подходящие Ресурсы выбранной группы, включая записи на других страницах. При выборе строк экспортируются только выбранные Ресурсы с учетом текущих фильтров и прав доступа. Удаленные Ресурсы, данные другого Аккаунта и недоступных Папок доступа в файл не попадают.

Пример: Ресурс "Адрес сервиса" создан в группе "Настройки интеграции". Выберите "All Assets" и обновите список Ресурсов. Ресурс "Адрес сервиса" появится в таблице "Ресурсы", поскольку Оркестратор автоматически включил его и в "Настройки интеграции", и в "All Assets" этого Аккаунта.

Экран Ресурсы с выбранной группой All Assets и доступными Ресурсами

Экран Ресурсы. Группа All Assets содержит Ресурс из группы Настройки интеграции

При экспорте Ресурсов в CSV или XLSX пароли записываются открытым текстом, включая секреты, полученные из Vault. Файл необходимо выгружать только при необходимости. Требуется ограничить доступ к нему, хранить и передавать его защищенным способом, а после использования удалить.

Создание нового ресурса#

ОбозначениеПояснение
Перед созданием Ресурса в таблице “Ресурсы” необходимо выбрать Группу ресурсов, в которой он будет создаваться, с помощью установки флага в таблице “Группы ресурсов”.

Реквизиты#

Реквизиты включают логин и пароль. Пароль защищается в хранилище Оркестратора или подключенном Vault. Здесь можно указать срок действия пароля: по истечении даты пароль необходимо заменить. Записи с истекшим сроком действия выделяются цветом.

Для создания нового Ресурса с типом Реквизиты в таблице “Ресурсы” необходимо нажать на кнопку “Создать”, в открывшейся форме поставить флаг “Реквизиты” (если он не стоит, обычно он стоит по умолчанию) и заполнить остальные поля формы:

№ п/пЭлемент интерфейсаОписание
1.текстовое поле “Имя”Имя Ресурса. Обязательное для заполнения поле.
2.текстовое поле "Описание"Описание Ресурса.
3.текстовое поле "Папка доступа"Папка доступа для создаваемого Ресурса.
4.Тип и содержимое Ресурса: Реквизиты
4.1.текстовое поле “Логин”Логин
4.2.текстовое поле “Пароль”Пароль
4.3.текстовое поле “Срок действия пароля”Срок действия пароля. Указывается дата окончания действия пароля в формате ДД.ММ.ГГГГ.
5.поле “Ресурс доступен”

Позволяет назначить Робота или Группу роботов, для которых будет доступен создаваемый Ресурс:

  • Все Роботы;
  • Только определенный Робот;
  • Только определенная Группа роботов.

Доступ к Ресурсам типа “Реквизиты” в Sherpa Designer#

Блоки Sherpa Designer позволяют получить или изменить логин и пароль Ресурса:

  • Для доступа к Ресурсам типа “Реквизиты” в Sherpa Designer в палитре Оркестратора используется блок “Получить учетные данные”.
  • Для редактирования учетных данных используется блок “Установить учетные данные”.

Данный функционал доступен для Роботов любого типа, как Attended, так и Unattended.

Текст#

Ресурс “Текст” представляет собой любую произвольную строку. Позволяет хранить текст, числа и другие типы Ресурсов. Ограничение на количество символов при выборе данного типа Ресурсов составляет 10 000 символов.

Для создания нового Ресурса с типом “Текст” в таблице “Ресурсы” необходимо нажать на кнопку “Создать”, в открывшейся форме поставить флаг “Текст” и заполнить остальные поля формы:

№ п/пЭлемент интерфейсаОписание
1.текстовое поле “Имя”Имя Ресурса. Обязательное для заполнения поле.
2.текстовое поле "Описание"Описание Ресурса.
3.текстовое поле "Папка доступа"Папка доступа для создаваемого Ресурса.
4.Тип и содержимое Ресурса: Текст
4.1.текстовое поле “Текст”Любой необходимый текст в произвольной форме.
5.поле “Ресурс доступен”

Позволяет назначить Робота или Группу роботов, для которых будет доступен создаваемый Ресурс:

  • Все Роботы;
  • Только определенный Робот;
  • Только определенная Группа роботов.

Доступ к Ресурсам типа “Текст” в Sherpa Designer#

Для чтения и изменения текста Ресурса используются следующие блоки Sherpa Designer:

  • Для доступа к Ресурсам типа “Текст” в Sherpa Designer в палитре Оркестратора используются блоки “Получить значение” и “Установить значение”. Из Оркестратора необходимо скопировать GUID Ресурса доступный при редактировании ранее созданного Ресурса. Далее в Дизайнере в поле “GUID/Имя Ресурса” на панели свойств необходимо вставить GUID Ресурса.

После выполнения выбранного блока в переменную “Результат” в Sherpa Designer будет передаваться значение, указанное в Оркестраторе в поле “Текст”.

Календарь#

Ресурс содержит информацию о количестве рабочих, выходных и праздничных дней. Они используются в нескольких местах:

  • в настройке Триггеров (можно указать, например, чтобы Робот не запускался в выходные дни);
  • в палитре даты и времени в блоках Sherpa Designer (например, подсчитать рабочие дни и т.п.);
  • в блоке "Получить календарь" Sherpa Designer.

Ресурс “Календарь” позволяет настраивать запуск Робота, например, только в рабочие дни, исключая выходные и праздники.

Для создания нового Ресурса с типом “Календарь” в таблице “Ресурсы” необходимо нажать на кнопку “Создать”, в открывшейся форме поставить флаг “Календарь” и заполнить остальные поля формы:

№ п/пЭлемент интерфейсаОписание
1.текстовое поле “Имя”Имя Ресурса. Обязательное для заполнения поле.
2.текстовое поле "Описание"Описание Ресурса.
3.текстовое поле "Папка доступа"Папка доступа для создаваемого Ресурса.
4.Тип и содержимое Ресурса: Календарь
4.1.кнопка “Редактировать календарь…”Позволяет редактировать календарь. При нажатии на кнопку открывается календарь на месяц, где можно выбрать необходимые даты.
4.2.кнопка “Экспортировать календарь…”Позволяет экспортировать календарь в файл формата .json.
4.3.кнопка “Импортировать календарь…”Позволяет импортировать календарь из файла в формате .json.
5.область “Ресурс доступен”

Позволяет назначить Робота или Группу роботов, для которых будет доступен создаваемый Ресурс:

  • Все Роботы;
  • Только определенный Робот;
  • Только определенная Группа роботов.

Доступ к Ресурсам типа “Календарь” в Sherpa Designer#

Блок "Получить календарь" передает календарь из Оркестратора в сценарий Sherpa Designer.

Для доступа к ресурсам типа “Календарь” в Sherpa Designer в палитре Оркестратора используется блок “Получить календарь”:

Обязательно требуется ввести GUID/Имя Календаря, который требуется получить:

Также в палитре “Дата и время” есть блоки, которые могут воспользоваться полученным из Оркестратора Календарем для проведения различных проверок и вычислений:

  • Подсчитать рабочие дни – считает количество рабочих дней между двумя заданными датами.
  • Следующий рабочий день – возвращает следующий рабочий день, начиная с указанной даты.
  • Рабочий день – проверяет указанную дату на рабочий день.
  • Выходной день – проверяет указанную дату на выходной день.
  • Получить рабочие дни – получает рабочие дни между двумя заданными датами.
  • Получить выходные дни – получает рабочие дни между двумя заданными датами.

Ресурс доступен#

Для Ресурсов можно задать область видимости. Она может быть настроена в поле “Ресурс доступен:”

  • Все Роботы – Ресурс доступен для всех Роботов в Оркестраторе;
  • Только определенный Робот – Ресурс доступен для Робота, выбранного из выпадающего списка доступных Роботов;
  • Только определенная Группа роботов – Ресурс доступен для Роботов, выбранной из выпадающего списка Группы роботов.

Редактирование ранее созданного Ресурса#

Для просмотра и редактирования ранее созданного Ресурса необходимо выбрать его в списке и нажать на иконку . После этого откроется форма с параметрами выбранного Ресурса, в которую можно внести необходимые изменения. Помимо полей, заполняемых при создании Ресурса, при редактировании в форме указан GUID (уникальный идентификатор, присвоенный Ресурсу после его создания):

Всплывающее окно "Ресурс" в Sherpa Orchestrator 5.9.6. GUID скрыт.

Всплывающее окно "Ресурс" в Sherpa Orchestrator 5.9.6. GUID скрыт.

Данное поле нельзя отредактировать.

Создание новой Группы ресурсов#

Для создания новой Группы ресурсов необходимо нажать на кнопку “Создать” над таблицей “Группы ресурсов” и заполнить открывшуюся форму: указать имя Группы ресурсов (обязательно), описание Группы ресурсов и Папку доступа Группы ресурсов. Для сохранения созданной Группы ресурсов, после заполнения формы необходимо нажать на кнопку “ОК”. Группа ресурсов будет создана.

Редактирование ранее созданной Группы ресурсов#

Для просмотра и редактирования свойств конкретной Группы ресурсов необходимо выбрать ее в списке и нажать на иконку . После этого откроется форма с настройками выбранной Группы ресурсов, в которую можно внести необходимые изменения:

Всплывающее окно "Группы ресурсов" в Sherpa Orchestrator 5.9.6. GUID скрыт.

Всплывающее окно "Группы ресурсов" в Sherpa Orchestrator 5.9.6. GUID скрыт.

Помимо полей, заполняемых при создании Группы ресурсов, при редактировании в форме указан GUID (уникальный идентификатор, присвоенный Группе ресурсов после ее создания). Данное поле нельзя отредактировать.