Настройки

Чтобы открыть окно конфигурации Студии, перейдите в меню Файл > Настройки.

Параметры сгруппированы по следующим категориям:

• Общие (базовые настройки):

  • Отладчик — настройка инструмента отладки.

  • Оформление — внешний вид Студии.

  • Элементы — управление элементами.

• Network:

  • Nuget — настройка разрешенных источников NuGet-пакетов.

  • Reverse-Proxy — настройки перехвата трафика.

  • Оркестратор — настройка подключения к Оркестратору.

• Инструменты:

  • Расширения — настройка расширений браузера.

• Интеграция:

  • Управляет интеграцией с SAP и приложениями на языке Java.

• Мобильные устройства:

  • Android — настройки интеграции с устройствами Android.

Общие

1. Кол-во строк журнала — максимальное количество строк, отображаемых в панели «Консоль».

2. Автосохранение процессов — определяет, нужно ли автоматически сохранять все открытые процессы во временные файлы. Доступно указание периода автосохранения в минутах.

3. Логировать в файл — определяет, нужно ли сохранять журнал Студии в файле. Пример пути к сохраненному файлу: C:\Users\UserName\AppData\Local\Primo.Primo Studio\Log. Название файла: <число месяц год час>_RobotStudio.log.

4. Отображать окно приветствия – управляет демонстрацией начальным окном Студии.

5. Режим без кода — определяет, нужно ли использовать режим Без кода (No code) по умолчанию для новых элементов.

6. Открывать последние процессы — определяет, нужно ли автоматически открывать последние открытые процессы проекта.

7. Отображать лупу — управляет отображением лупы селектора в верхнем углу экрана. Если настройка включена, то при выборе элемента управления лупа будет отображаться. Пример:

   
8. Пауза захвата — определите горячие кнопки для паузы захвата элемента управления. По умолчанию паузу вызывает комбинация клавиш Alt + F12, она длится 10 секунд. В каких ситуациях может понадобиться: например, вам нужно сформировать шаблон поиска для десктопного приложения, в котором требуется кликнуть по пункту контекстного меню. Чтобы избежать захвата названия меню (вместо его пункта), используйте сначала паузу, во время которой вы можете открыть список пунктов меню, а когда она закончится - захватывайте нужный пункт.

9. Режим Студии — выберите режим работы Студии:

   • Pro — для пользователей с опытом программирования, которым необходимо создавать комплексные бизнес-процессы для исполнения как на сервере, так и на рабочем месте, сценарии тестирования и т.д.

   • Citizen — упрощенный режим для пользователей с ограниченным опытом программирования или вовсе без него. Походит для бизнес-пользователей, которые желают автоматизировать задачи для себя и своих коллег.

10. Не показывать окно выбора режима — позволяет не отображать окно с выбором режима при каждом запуске Студии.

11. Быстрый поиск компонентов — настройка управляет параметром Быстрый поиск в шаблонах поиска десктопных приложений. Если чекбокс установлен, то по умолчанию для десктопных шаблонов будет включен быстрый поиск. На уже используемые шаблоны настройка не влияет.

12. Использовать Структуру — определяет, нужно ли показывать иерархию процесса в специальной панели «Структура». С помощью панели также можно быстро перейти к нужному элементу процесса, если дважды кликнуть на его названии. Возможные значения параметра:

    • галочка установлена — использовать структуру. Если панель не отображается, перейдите в главное меню Студии и выберите «Вид > Панели > Структура».

    • галочка снята — не использовать структуру.

    

    Панель «Структура»
13. Таймаут поиска компонента (мс) — максимальное время поиска элемента управления в малом окне «Редактора шаблона поиска». Настройка помогает избежать зависания при валидации выбранного элемента управления. По умолчанию таймаут равен 30000 миллисекунд (30 сек). Если по истечении указанного времени элемент не будет найден, то процесс поиска прервется, а пользователь увидит соответствующее сообщение:

    

    Малое окно «Редактора шаблона поиска»
14. Найти и заменить — включает функцию замены в окне «Поиск». Функция позволяет заменить найденный в проекте текст на указанное пользователем значение.

Отладчик

В данной панели настраиваются функции отладчика:

1. Тип отладчика — тип робота, который будет использоваться при отладке. Возможные значения:

   • ROBOT— значение по умолчанию. Запуск отладки будет производиться на реальном роботе, включенном в дистрибутив Студии.

   • SEQUENCE — этот тип робота предназначен только для технических специалистов Студии. При выборе этой опции отладка запустится без робота (экспериментальная настройка).

2. Закрывать робота — нужно ли автоматически закрывать робота по завершении отладки. По умолчанию робот закрывается. Бывают случаи, когда этого делать не нужно: например, если по завершении требуется просмотреть консоль робота, чтобы диагностировать проблему подключения к Студии. Когда робот не закрыт, его консоль тоже остается доступной.

3. Отображать консоль робота — нужно ли показывать консоль робота во время отладки. При выключенном чекбоксе консоль не отображается, после выполнения проекта робот автоматически закрывается. Консоль робота имеет вид:

   

   Консоль робота
4. Сворачивать Студию — определяет, сворачивать ли Студию при отладке.

5. Отображать окно консоли — нужно ли отображать во время отладки окно с консолью Студии. Это полупрозрачное окно в углу экрана, которое позволяет просматривать логи, даже если окно Студии свернуто. Пример:

   

   Консоль Студии при свернутом приложении
6. Проверять синтаксис — включает автоматическую проверку синтаксиса. Отключение настройки позволяет ускорять отладку в больших проектах.

7. Трассировка — если включена, то при запуске отладки Студия будет получать от робота дополнительную пошаговую информацию о ходе выполнения процесса. В частности, необходима для отображения значений в колонке «Текущее значение» в панелях «Переменные» и «Аргументы». Отключение настройки позволяет ускорять отладку в больших проектах.

8. Значения в реальном времени — определите, нужно ли во время отладки отображать текущие значения переменных в панелях «Переменные» и «Аргументы». Работает только совместно с трассировкой. Включение/отключение параметра не влияет на возможность просматривать переменные в панели «Вывод». Отключение настройки ускоряет отладку процессов в больших проектах.

9. Отображать вывод — при включении параметра станет доступна панель «Вывод» для подробного просмотра значений переменных. Работает только совместно с трассировкой. Чтобы панель «Вывод» отображалась, дополнительно потребуется установить точку останова на элементе, следующем после получения значения нужной переменной (-ых). По достижении точки останова на панели «Проект» появится вкладка «Вывод».

10. Приостанавливать отладку на исключении — установка отметки позволяет автоматически приостанавливать процесс, если во время отладки возникло исключение. Благодаря этому пользователь может проанализировать ошибку и вручную повторить выполнение элемента, не запуская заново весь процесс. Если отметка не установлена, то отладка процесса начнется с нуля.

11. Писать общий журнал в файл — запись журнала робота в файл. Пример пути к файлу: C:\Users\UserName\AppData\Local\Primo.Primo Studio\Log. Возможное название файла:

    • <число месяц год час>_Default_Robot.log — лог робота без отладочной информации.

    • <число месяц год час>_Default_Robot1.log— содержит данные отладки.

12. Писать пользовательский журнал — запись пользовательских событий в файл. К пользовательским событиям относятся те, что были сформированы при выполнении роботом элемента «Запись в журнал». Такой файл будет иметь в названии слово custom. Пример: <число месяц год час>_Default_Robot1_custom.log.

13. Период ожидания робота — предельный период ожидания старта робота при отладке (мс).

14. Тип робота — x64 или x86.

15. Версия ядра — v1 или v2. Вторая версия (v2) ускоряет загрузку процессов для отладки, тем самым повышая производительность на высоконагруженных процессах. Рекомендуется использовать v2 по умолчанию.

16. Отладчик чистого кода — позволяет выбрать ядро робота-отладчика: v1 или v2. Параметр добавлен в версии 1.23.11.

    Если вы изменяете ядро отладчика:

    • Обязательно перезагрузите Студию.

    • Если вы меняете ядро в проектах, где были использованы точки останова, заданные кодом (v1), удалите их и установите новые (v2). Это поможет избежать проблем совместимости.

    • Помните, что с отладчиком v2 нельзя использовать неинициализированные переменные.

    Преимущества отладчика v2:

    • Вместо кода для точки останова используются цветовые индикаторы (см. на рисунке ниже).

    

    • На остановке можно просмотреть текущие значения локальных переменных функции. В версии v1, в панели «Вывод», видны только текущие значения переменных класса.

    • На остановке можно перейти к коду функции.

    • Имеется возможность удалить все точки останова из процесса по кнопке Убрать все точки останова на вкладке «Отладка».

Оформление

1. Тема — выбор цветовой палитры Студии.

2. Язык — выбор языка интерфейса. После изменения потребуется перезапуск Студии.

3. Отображать вертикальные заголовки — отображать вертикальные заголовки контейнеров последовательности.

4. Отображать нумерацию — управляет автонумерацией элементов в процессе. Элементы нумеруются только в последовательностях. По умолчанию отметка установлена - автонумерация включена. Чтобы просматривать номер элемента не только в процессе, но и в панели «Консоль», необходимо добавить в таблицу консоли столбец «Номер». Для этого щелкните правой кнопкой мыши по строке с названиями столбцов и выберите в контекстном меню пункт «Показать выбор колонок». В окне диалога установите отметку напротив столбца «Номер».

5. Стиль главного меню — определяет, как отображать главное меню: как ленту либо как панель (устаревшее).

6. Последовательность — при измении настроек потребуется переоткрыть вкладку последовательности:

   • Высота вставки — по умолчанию 40;

   • Отступ от элемента — по умолчанию 5;

   • Отступ контейнера — по умолчанию 20.

Элементы

1. Скрывать Поколение 1 — установка чекбокса позволяет скрыть в панели «Элементы» компоненты, относящиеся к группам «Поколение 1». Поколение 1 - набор устаревших элементов для браузера и рабочего стола. Их скрытие сделает панель элементов визуально чище.

2. Отключить логирование у новых элементов — управляет автоматическим логированием новых элементов, добавляемых в проект. Параметр позволяет массово изменить значение свойства Отключить логирование у новых элементов:

   • если чекбокс установлен, то общее свойство Отключить логирование по умолчанию будет активным - запись логов выполнения элемента осуществляться не будет;

   • если чекбокс снят, то свойство Отключить логирование по умолчанию будет выключено.

   Изменение чекбокса не требует перезагрузки Студии.

3. Использовать старый редактор шаблона поиска по умолчанию — определяет, какой редактор шаблона поиска (селектора) нужно использовать по умолчанию в Студии. Если галочка установлена, то используется старый. Если снята — обновленный (значение по умолчанию). Изменение состояния параметра не требует перезагрузки Студии. Обращаем внимание, что новый редактор шаблона доступен с версии Студии 23.9.

Network

Nuget

Вкладка предназначена для подключения собственных источников NuGet-пакетов. Подробнее работа с вкладкой описана здесь.

В частности, в качестве источника возможно указать локальный сервер NuGet, который входит в комплект поставки Оркестратора.

Reverse-Proxy

Настройки работы с сетью перехватчика трафика:

1. Порт — порт, используемый перехватчиком.

2. Авторегистрация, как системного Proxy — при старте перехвата перехватчик автоматически устанавливается в качестве Proxy-сервера системы.

3. Перехватывать SSL — признак перехвата и расшифровки пакетов SSL/TLS.

4. Перехватывать входящий трафик — признак перехвата ответов на запросы.

Подключение к Оркестратору

Настройки подключения Студии к Оркестратору (недоступно для версии Community).

1. Откройте Студию и перейдите в меню Настройки.

2. Выберите раздел Network и далее — Оркестратор.

3. В выпадающем списке Тип выберите вариант подключения: Primo — для стандартного подключения с указанием:

   • Адрес сервера Оркестратора.

   • Тенант пользователя.

   • Логин пользователя.

   • Пароль пользователя.

4. Нажмите кнопку Проверка, чтобы убедиться, что подключение успешно.

5. Нажмите ОК для сохранения настроек.

Индикатор состояния соединения всегда можно найти в правом нижнем углу главного окна Студии:

Нажатие на индикатор предоставляет быстрый доступ к настройкам подключения.

Подключение Студии к Оркестратору с использованием AD авторизации:

1. Откройте Студию и перейдите в меню Настройки.

2. Выберите раздел Network и далее — Оркестратор.

3. В выпадающем списке Тип выберите вариант подключения:

   • Windows — для подключения через учетную запись Windows с использованием AD авторизации. Функция доступна с версии 1.24.10

4. Укажите нужный Адрес сервера Оркестратора

5. Нажмите кнопку Проверка, чтобы убедиться, что подключение успешно.

6. Нажмите ОК для сохранения настроек.

Если вы используете AD авторизацию, убедитесь, что группы Active Directory (AD) добавлены в системные роли, такие как Robot или Studio, для выполнения операций через Оркестратор.

Интеграция

AI

Для настройки интеграции с AI:

1. Скачайте плагин Primo.AI.Plugin.dll и добавьте его в папку Студии. Пример:

   
2. Перезагрузите Студию, чтобы в настройках появился раздел Интеграция > AI.

3. Перейдите в настройки, включите чекбокс Использовать AI и выберите языковую модель:

   • Sber GPT — интеграция с GigaChat, значение по умолчанию.

   • Yandex GPT.

   

   Настройка активирует поддержку чата AI — в меню Студии отобразится кнопка AI запрос.

   
4. Укажите оставшиеся параметры для выбранной AI.

   🔹 О том, как получить токен и прочие данные, см. в разделе Интеграция с AI.

   Sber GPT:

   • Token — токен доступа для работы с GPT. Токен действует в течение 30 минут с момента выпуска.

   • Key — токен доступа для работы с GPT. То же значение, что и в поле выше.

   • Time-out — предельное время ожидания ответа GigaChat в миллисекундах. По умолчанию 20000 (20 сек).

   • Creativity — творческая составляющая ответа. Число от 0 до 1. Чем выше значение, тем более непредсказуемым будет результат выполнения запроса. По умолчанию 0.5.

   Yandex GPT:

   • Folder ID — идентификатор каталога в Yandex Cloud.

   • Token — IAM-токен для работы с GPT. Время жизни IAM-токена — не больше 12 часов, но рекомендуется запрашивать его чаще.

   • Time-out — предельное время ожидания ответа Yandex GPT в миллисекундах. По умолчанию 20000 (20 сек).

   • Max Lenght — максимальная длина пары «запрос-ответ» в символах. По умолчанию 4000. Значение не должно превышать 4700 символов.

   • Creativity — творческая составляющая ответа. Число от 0 до 1. Чем выше значение, тем более непредсказуемым будет результат выполнения запроса. По умолчанию 0.5.

   • Chat name — по умолчанию Primo User.

Java

Настройки для интеграции с плагином Java. Убедитесь, что плагин установлен.

• Подробный поиск — поиск элементов управления в приложениях Java.

SAP

Инспектор SAP:

• Тайм-аут — предельное время ожидания подключения в миллисекундах. По умолчанию 10000.

• х64 — архитектура приложения SAP.

Инструменты

Расширения

Раздел предназначен для установки расширений браузеров и плагинов.

Процесс установки подробнее описан в следующих статьях:

• Установка расширений и плагинов из командной строки;

• Ручная установка расширений и плагинов из интерфейса Студии;

• Автоматическая установка расширений для браузеров.

При установке браузерных расширений для Chrome, Edge, Yandex возможно выбрать версию Манифеста, с которым взаимодействует расширение:

• При установке чекбокса Использовать манифест V3 будет установлено расширение на базе последней 3-й версии Манифеста.

• При отключенном чекбоксе (состояние по умолчанию) будет установлено стандартное расширение на базе 2-й версии Манифеста.

Переход на расширение, работающее с Манифестом V3, возможно осуществить до июня 2025 года. На данный момент установить расширение на базе Манифеста V3 можно только вручную, без использования скриптов.

Мобильные устройства

Android

Настройки интеграции с мобильными устройствами на базе Android:

• Путь к ADB — путь к папке установки Android Device Bridge.