Автоматизация установки расширения Primo RPA Extension

Primo RPA взаимодействует с веб-браузерами Chrome, Firefox, Edge, Yandex с помощью расширения Primo RPA Extension.

Принцип работы и расположение файлов

Убедитесь, что Primo RPA Studio или Primo RPA Robot установлены на целевом компьютере.

Файлы расширений располагаются в каталоге установки Studio/Robot:

• Manifest V3 (по умолчанию, рекомендуется): \ExtensionsV3\Chrome\chrome.crx

• Manifest V2 (устаревший, см. раздел «Важные ограничения»): \Extensions\Chrome\chrome.crx

• Firefox: \Extensions\primo_rpa_extension_firefox.xpi (используется Manifest V2, так как Firefox не поддерживает V3)

Взаимодействие с браузером

Взаимодействие между роботом и браузером осуществляется через нативный исполняемый файл LTools.WebBrowser.Native.exe, расположенный в корневой папке Studio/Robot. Расширение связывается с этим файлом через:

1. Записи в реестре Windows, специфичные для каждого браузера.
2. JSON-файл конфигурации, в котором прописан путь к LTools.WebBrowser.Native.exe.

При корректной установке запуск браузера с открытым URL и активным расширением автоматически запускает LTools.WebBrowser.Native.exe. После чего происходит обмен данными между роботом и браузером: робот управляет веб-страницей, кликает по ее HTML-элементам, обновляет страницу, переходит на другие URL-адреса, выполняя другие действия согласно RPA-проекту.

Особенности автоматической установки

• Для установки не требуется интернет — достаточно один раз запустить инсталлятор от имени администратора на сервере агента.
• Это особенно важно для корпоративных и изолированных сред.

Если доступ к интернету есть, браузеры не обновляют расширение из магазинов. Всегда используется версия расширения, находящаяся в папке Studio/Robot, из которой был запущен установочный скрипт:

• \ExtensionsV3\Chrome\chrome.crx
• \Extensions\Chrome\chrome.crx

Если пользователь установит расширение вручную (через Studio или CLI) из другой папки, оно будет работать, но при следующей принудительной установке версия будет заменена системной.

Установка расширения

1. Скачайте архив InstallExtensionsGPO.zip 
2. Выберите инсталлятор:
   • _Install_BrowserExtensionsFULL_GPO_v3.bat — Manifest V3 (рекомендуется)
   • _Install_BrowserExtensionsFULL_GPO.bat — Manifest V2 (устаревший)
3. Скопируйте выбранный файл в корневую папку установки Studio/Robot (рядом с Primo.Robot.exe)
4. Запустите скрипт от имени администратора из папки Студии/Робота и дождитесь завершения установки.

Альтернативный способ запуска

Скрипт можно запустить из любой папки, указав путь к установке Studio/Robot:

C:\Scripts\_Install_BrowserExtensionsFULL_GPO_v3.bat "C:\Program Files\Primo\Primo Robot x64"

Удаление расширения

Для полного удаления расширения со всеми его следами используйте скрипт Uninstall_BrowserExtensions.bat из того же архива. Скрипт выполняет:

• удаление расширения из всех поддерживаемых браузеров;
• очистку связанных записей реестра Windows.

Порядок удаления

1. Скачайте архив InstallExtensionsGPO.zip 

2. Извлеките файл Uninstall_BrowserExtensions.bat

3. Запустите скрипт:

   • Запуск от администратора → Удаляет расширение для всех пользователей и очищает системный реестр (HKLM)
   • Запуск от обычного пользователя → Удаляет расширение только для текущего пользователя (HKCU)

Решение проблем

1. Проблема: расширение установлено, но не работает

Если расширение отображается в браузере, но не запускается:

1. Запустите Uninstall_BrowserExtensions.bat без прав администратора
2. Повторно выполните установку

2. Ошибка при установке: Установите программу 7-Zip для автоматического определения версии расширения

1. Установите 7-Zip с официального сайта ,
2. Добавьте путь к 7-Zip в системную переменную PATH
3. Повторите установку

3. Важные ограничения (Manifest V2)

После выхода Chrome 139 и Edge 139 поддержка расширений с Manifest V2 прекращена. Расширения Primo RPA Extension 1.6* и 1.8* более не работают в этих браузерах.

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