Автоматизация установки расширения
Primo RPA взаимодействует с веб-браузерами Chrome, Firefox, Edge, Yandex с помощью расширения Primo RPA Extension.
Автоматизация установки расширения основана на применении групповой политики управления расширениями браузеров. В данном разделе приводится пример эмуляции использования групповых политик, примененных для сервера агента — компьютера, на котором работает программа Primo RPA Robot. Использование данных скриптов, после согласования с системным администратором сервера, позволит упростить процедуру развертывания расширения на сервере Windows.
Перед началом работы
Установите на компьютере программы Primo RPA Studio или Primo RPA Robot. Устанавливаемое расширение расположено в папке \Extensions
(\ExtensionsV3) этих программ.
Для браузеров Chrome, Edge и Yandex используется файл расширения:
\Extensions\Chrome\chrome.crx
— расширение на базе манифеста V2.\ExtensionsV3\Chrome\chrome.crx
— расширение на базе манифеста V3.
Для браузера Firefox — файл \Extensions\primo_rpa_extension_firefox.xpi
.
Студия и робот взаимодействуют с браузером и его расширением через файл LTools.WebBrowser.Native.exe
. Он находится в папке с программами Primo RPA Studio и Primo RPA Robot. Расширение связывается с этим файлом через:
- реестр Windows, соответствующий браузеру и его плагину;
- и файл json, в котором указан путь к
LTools.WebBrowser.Native.exe
.
Если связь установлена корректно, то запуск браузера с непустым URL при включенном расширении автоматически запускает LTools.WebBrowser.Native.exe
. После чего происходит обмен данными между роботом и браузером: робот управляет веб-страницей, кликает по ее HTML-элементам, обновляет страницу, переходит на другие URL-адреса, в общем, выполняет все действия в соответствии с запущенным RPA-проектом.
Особенности установки
Для автоматизированной установки расширения не нужен интернет, достаточно запустить инсталлятор один раз от имени администратора на сервере агента, что важно при работе в корпоративных изолированных средах.
Если у вас есть доступ к интернету, то автообновление Google не будет обновлять расширение до версии из Магазина Chrome — будет использоваться всегда та версия, которая находится в папке Студии/Робота, откуда был запущен скрипт установки (файлы \Extensions\Chrome\chrome.crx
или \ExtensionsV3\Chrome\chrome.crx
).
Если какой-либо пользователь желает использовать свою версию расширения из другой папки Студии, то ручная установка из командной строки или установка из интерфейса Студии также будет работать. Чтобы изменить версию на принудительно назначенную, см. п.1 в подразделе Решение проблем.
Установка расширения
-
Скачайте InstallExtensionsGPO.zip
-
Выберите инсталлятор:
_Install_BrowserExtensionsFULL_GPO.bat
— Primo RPA Extension на базе манифеста V2._Install_BrowserExtensionsFULL_GPO_v3.bat
— Primo RPA Extension на базе манифеста V3.
-
В зависимости от выбранного манифеста, скопируйте файл инсталлятора в корневую папку с программой Студии/Робота. Например, в папку
C:\Program Files\Primo\Primo Studio
(рядом с файломPrimo.Robot.exe
). -
Запустите от имени администратора из папки Студии/Робота и дождитесь, когда скрипт выполнится.
Альтернативный способ запуска:
Запустите инсталлятор от имени администратора из любой папки, но при этом укажите аргумент пути до установки Студии/Робота. Пример:
C:\Scripts\_Install_BrowserExtensionsFULL_GPO.bat “C:\Program Files\Primo\Primo Robot x64”
Удаление расширения
Файл Uninstall_BrowserExtensions.bat
выполняет полное удаление расширения:
- Удаляет расширение из всех поддерживаемых браузеров (Chrome, Edge, Firefox, Yandex)
- Очищает записи в реестре Windows
Порядок удаления:
- Скачайте архив InstallExtensionsGPO.zip
- Извлеките файл
Uninstall_BrowserExtensions.bat
- Запустите скрипт:
Запуск от администратора:
- Удаляет расширение из всех браузеров в режиме “Для всех пользователей”
- Очищает системные записи в реестре (HKLM)
- Удаляет общие файлы расширения
Запуск от обычного пользователя:
- Удаляет расширение только для текущего пользователя
- Очищает записи в реестре текущего пользователя (HKCU)
- Не затрагивает установки других пользователей
Расширения, установленные другими пользователями в режиме “Для текущего пользователя”, не будут удалены даже при запуске от администратора.
Решение проблем
Внимание. Поскольку данные скрипты являются эмуляцией использования групповых политик браузеров Chrome\Edge\Yandex\Firefox, то их запуск должен быть согласован с системным администратором сервера, если в среде были использованы свои корпоративные политики браузеров. Каждый скрипт содержит поясняющие комментарии, чтобы их можно было легко адаптировать под свою схему работы с ранее назначенными расширениями браузеров.
1. Проблема: расширение установлено, но не работает
Если браузер показывает установленное расширение, но LTools.WebBrowser.Native.exe
не запускается, выполните деинсталляцию обычным пользователем через Uninstall_BrowserExtensions.bat
(без прав администратора) и переустановите расширение. Это устранит конфликты от предыдущих установок.
2. Ошибка при установке: Установите программу 7-Zip для автоматического определения версии расширения
При появлении сообщения о необходимости 7-Zip установите архиватор с официального сайта , добавьте его в системный PATH и повторите установку. Это необходимо для корректной распаковки файлов расширения.
3. Важные ограничения
После 8 августа 2025 года с выходом Chrome 139 и Edge 139 поддержка расширений с Manifest V2 в этих браузерах будет полностью прекращена. Это означает, что версии “Primo RPA Extension” 1.6* и 1.8* перестанут работать в Chrome и Edge.