Primo Studio 23.11

Раздел содержит описание изменений для версии приложения Primo Studio 23.11, выпущенной в ноябре 2023 года.

Новые функции и улучшения

Реализован набор инструментов для разработчиков LTools.Office.SDK. Теперь можно разрабатывать свои элементы Primo для автоматизации работы с программами MS Office: Excel, Word, Outlook и Exchange. Описание работы с LTools.Office.SDK см. здесь.
Для отладчика чистого кода реализована новая версия ядра - v2. Среди ее преимуществ:
- Вместо кода для точки останова теперь используются цветовые индикаторы (см. на рисунке ниже).
- Стали видны текущие значения локальных переменных функции. Ранее, в версии v1, в панели «Вывод» отображались только текущие значения переменных класса.
- На точке останова стало возможным перейти к коду функции.
Выбрать ядро отладчика чистого кода пользователь может в окне настроек Студии. По умолчанию используется версия v1.
Добавлена библиотека Primo.Office.Pdf, содержащая элемент Чтение таблицы. Элемент позволяет автоматически извлекать табличные данные из PDF-документов.
Добавлена возможность переключения между старым и новым редактором шаблона поиска. По умолчанию в Студии используется обновленный редактор. Чтобы изменить значение:
- Перейдите в раздел Файл > Настройки > Общие > Элементы и установите чекбокс Использовать старый редактор шаблона поиска по умолчанию.
- Для единичных случаев используйте команду контекстного меню Открыть старый/новый редактор шаблона (значение зависит от редактора по умолчанию). Команда добавлена для всех элементов, содержащих свойство Шаблон поиска. Эта функция не меняет редактор по умолчанию и не приводит к очищению ранее заполненных свойств шаблона.
Для процессов RPA-проекта добавлено поле Описание. Оно доступно в форме создания/редактирования процесса и не является обязательным для заполнения.
В контекстное меню элементов добавлены команды:
- Перенести элемент в try/catch - позволяет переместить выделенный элемент в контейнер Try-Catch. Поддерживается множественный перенос элементов.
- Извлечь элемент из try/catch - извлекает элемент или элементы из Try-Cath.
Улучшена работа с вложениями при чтении сообщений из MS Exchange. Теперь вложения в виде писем стали сохраняться в свойство Attachments объекта OMailMessage. Их можно обрабатывать как файлы, сохраняя на диск для дальнейшего использования (формат *.eml).
Для элемента Чтение почты (Outlook) добавлена возможность сортировки писем. За это отвечают новые свойства:
- Сортировать - определяет, нужно ли сортировать письма по какому-либо полю. По умолчанию сортировка не используется.
- Направление - определяет направление сортировки. По умолчанию задана сортировка по возрастанию (Ascending), которую возможно изменить на сортировку по убыванию (Descending).
Для элементов Получить письма (IMAP) и Переместить в папку (IMAP) добавлены свойства:
- Использовать SSO - определяет, нужно ли использовать Secure Socket Options (SSO). Это набор параметров и настроек для обеспечения безопасной передачи данных через защищенное сокет-соединение. По умолчанию параметр отключен.
- SSO - способ указания шифрования, которое должно использоваться для соединения. Значение учитывается, если включен параметр Использовать SSO. В этом случае при подключении к почтовому серверу будет использован SSO и проигнорировано свойство SSL.
У элемента Исключение появилось свойство Переменная исключения, которое позволяет использовать для вызова уже существующее исключение. При указании переменной остальные свойства элемента можно не заполнять.
У элемента Вставка изображения (Word) появилось свойство Позиция, которое позволяет указать позицию в символах относительно искомого слова в тексте.
Улучшена работа цикла Повтор попыток (Retry) для более гибкого управления процессом. Если для цикла включено свойство Продолжить при ошибке, то при возникновении исключения в одном из элементов цикла выполнение итерации начнется заново.
Улучшен процесс добавления новой переменной на панели Переменные. Теперь, при создании переменной, ей по умолчанию присваивается тип данных String. Если требуется использовать другой тип данных, можно изменить его в соответствующем поле.
Для импортированных проектов улучшена функция проверки синтаксиса кода в значениях переменных и аргументов. Теперь, если у переменных и аргументов было заполнено значение по умолчанию, то система выполнит их проверку и подсветит возможные ошибки. Для этого в настройках Студии обязательно должен быть включен параметр Проверять синтаксис.
В Robot Runner добавлена информация о версии Runner’a, которую можно найти в разделе меню Файл > О программе.

Исправленные ошибки

Шаблон поиска (селектор)

Устранена проблема, при которой наличие спецсимволов (например, \) в селекторах приводило к их некорректной работе. В рамках исправления была добавлена поддержка экранирования спецсимволов, включая спецсимволы в заголовках окон.
Исправлена ошибка, исключавшая ввод текстовых значений в поле Index в редакторе шаблона поиска. Теперь ввод текста производится корректно, ограничение на количество символов отсутствует.
Исправлена ошибка, при которой параметры CssSelector и Index не сохранялись при редактировании.
Исправлена нестабильная работа инструмента Выбрать элемент в браузерах: он срабатывал не с первого раза.
Исправлены ошибки в работе редактора шаблонов с Internet Explorer (IE):
- не работала валидация шаблона для IE;
- не определялись свойства селектора, если элемент Клик мышью был помещен в контейнер браузера IE;
- некорректно определялся тип браузера, если из текущего шаблона попытаться перевыбрать элемент в другом браузере.

Расширение браузера

Исправлена проблема, связанная с работой расширения браузера после переустановки или обновления Студии.

Отладка и панель «Вывод»

Исправлена ошибка, когда режим отладки не прекращался при закрытии RPA-проекта через меню Файл > Закрыть проект.
Исправлена ошибка, которая не позволяла изменить текущие значения переменных в панели Вывод во время приостановки отладки на исключении.
Исправлена ошибка с неработающим предпросмотром значений словаря (Dictionary) в панели Вывод, если один из элементов пустой (null).
Внесены исправления в работу отладки. Теперь, если включена настройка Приостанавливать отладку на исключении и возникло исключение в элементе IF-Else, то функция Повтор шага не прекращает процесс, а возобновляет его с места, где произошло исключение.

Зависимости

Исправлена некорректная установка зависимости из NuGet. Ранее, при выборе не последней версии зависимости и ее установке, в окне Управление зависимостями, на вкладке Студия, отображалась последняя версия. После исправления этой ошибки отображается выбранная версия зависимости.
Исправлена ошибка, при которой невозможно было обновить версию установленной зависимости из окна Управление зависимостями.

Работа элементов

Исправлена ошибка в элементе Отправить сообщение (Outlook): ранее не сохранялся текст основного письма при ответе на него.
Исправлена ошибка, из-за которой переменные и их значения не сохранялись в элементе Множественное присвоение при сохранении процесса и его последующем открытии.
Внесены исправления для элемента Завершить приложение. Теперь он корректно работает как при присоединении по заголовку окна, так и при присоединении по имени процесса.
Исправлены следующие ошибки в работе элемента Try-Catch:
- при отладке и включенной настройке Останавливать отладку на исключении процесс не приостанавливался на элементе Исключение в блоке Try;
- не всегда выполнялся блок Finally;
- при выполнении элемента Выход из процесса в Try-Catch вместо выхода из процесса происходило бесконечное цикличное выполнение блока Finally;
- в консоли отображалась ошибка «Завершение последовательности из-за исключения» почти после каждого исключения в блоках Try-Catch.
Исправлена проблема с обновлением скриншота в окне элемента Клик мышью, когда выбор элемента производился через редактор шаблона поиска.
Исправлена проблема, связанная с зависанием на элементе Извлечь архив. Ошибка выявлялась на некоторых итерациях этого элемента, в то время как на других итерациях разархивирование происходило за считанные секунды.
Исправлена ошибка в работе элемента Параллельные потоки: ранее, при возникновении исключений внутри веток, происходило дублирование действий и логов в консоли.
Исправлена ошибка в работе элемента Раскладка: не выполнялась смена языка при выборе горячей клавиши Alt Shift.
Устранено зависание процесса при выполнении элемента Ссылка на процесс в версии Студии 23.9.501.
Устранена проблема, когда не работали элементы Получить письма (IMAP) и Переместить в папку (IMAP) с указанным портом 143 и снятой галочкой в свойстве SSL. Свойства данных элементов были доработаны (см. пункт 7 в «Новых функциях»).

Другие исправления

Исправлена ошибка, приводившая к потере изменений в текущем проекте при создании нового проекта.
Устранено зависание процесса с типом Только код (Pure code), если в нем была установлена точка остановки.
Устранена проблема, когда не удавалось запустить процессы с типом Только код (Pure code), если в настройках Студии для отладчика чистого кода была выбрана версия ядра v2.
Исправлена нестабильная работа поиска в панели Элементы.
Исправлена логика перехода к найденному элементу из окна поиска (Ctrl+F) в Студии. Ранее переход осуществлялся без автоматического позиционирования на найденном элементе, в результате чего пользователю приходилось использовать прокрутку рабочей области, чтобы его увидеть. Теперь позиционирование работает, за исключением случаев, когда элементы находятся в свернутых контейнерах.
Исправлено неправильное поведение при копировании и перетаскивании элементов, которое зависело от порядка нажатия клавиши Ctrl. Теперь копирование и перетаскивание работают корректно, независимо от последовательности нажатия Ctrl.
В процессе с типом Последовательность исправлена ошибка, когда при перемещении нескольких элементов комбинацией Ctrl + левая кнопка мыши переносился только один элемент.
В последовательностях исправлена ошибка, когда при попытке перетащить элементы мышкой (drag-and-drop), они не переносились.
Исправлена ошибка «Ссылка на объект не указывает на экземпляр объекта», которая возникала при использовании функции Закомментировать для элементов, находящихся в разных контейнерах.
Исправлена ошибка, которая возникала при использовании функции Раскомментировать для элементов, не находящихся в комментарии. Данная функция в контекстном меню отображалась для них ошибочно.

Где найти

Скачать дистрибутив Primo RPA Studio Enterprise .

Скачать дистрибутив Primo RPA Robot :

Primo RPA Robot 1.23.11 - предназначен для установки на локальной рабочей станции. Выступает в роли цифрового ассистента пользователя. Дистрибутив поставляется в разрядности x64 и x86.
Primo RPA Robot Orchestrator 1.23.11 - предназначен для автоматической установки Оркестратором. Дистрибутив поставляется в разрядности x64 и x86.