Работа с чистым кодом
Last updated
Last updated
Студия предоставляет возможность разрабатывать сценарии автоматизации в режиме чистого кода - Pure code. Для этого при создании сценария - или, иначе, процесса - выберите тип Только код (1) и укажите язык программирования (2).
По умолчанию используется язык С#, но вместо него вы можете выбрать Python или JavaScript. После создания процесса откроется редактор кода для работы с элементами:
На панели Элементы найдите нужный компонент и перетащите в редактор кода - будет создан образец для его вызова.
В разделах, посвященных описанию элементов, как правило, можно найти подраздел Только код - он содержит примеры использования элементов в чистом коде. См. пример для элемента Получить значение:
Чтобы вызвать другой процесс, перетащите соответствующий файл процесса из панели проекта в код.
Код поддерживает аргументы - переменные для обмена данными между процессами. Работа с ними не отличается от других типов процессов. Для работы с аргументами также можно использовать методы GetArgument и SetArgument глобальной переменной wf.
В коде появится строка вызова точки останова:
‼️ В языках Python и JavaScript последний параметр отвечает за номер строки точки останова.
Обращаем внимание, что в версии Студии 23.11 для отладчика чистого кода реализована версия ядра v2. Среди ее преимуществ:
Вместо кода для точки останова теперь используются цветовые индикаторы (см. на рисунке ниже).
Стали видны текущие значения локальных переменных функции. В версии ядра v1 в панели Вывод отображаются только текущие значения переменных класса.
На точке останова стало возможным перейти к коду функции.
Выбрать ядро отладчика чистого кода можно в окне настроек Студии. По умолчанию используется версия v1.
🔸 Если вы меняете версию ядра, обязательно перезагрузите Студию. 🔸 Если вы меняете ядро в проектах, где были использованы точки останова, заданные кодом (v1), удалите их и установите новые (v2). Это поможет избежать проблем совместимости. 🔸 Нельзя использовать неинициализированные переменные с отладчиком
v2.
Добавьте точку останова к нужному элементу и примените команду Отладить процесс.
На панели Элементы/Проект вызовите контекстное меню и выберите пункт Закрытые панели.
Нажмите появившуюся кнопку Вывод, чтобы отобразить панель.
Перейдите на панель Вывод, нажав соответствующую кнопку внизу.
Просмотрите состояния переменных на момент остановки выполнения кода.
Если в панели Вывод отображаются неверные данные - например, с прошлой отладки в режиме последовательности - просто нажмите кнопку Обновить.
Начиная с версии Primo RPA Studio 1.24.6, добавлена кнопка Пауза для процессов типа Чистый код. Это функция дает возможность прервать выполнение процесса в требуемый момент, что повышает точность управления.
В зависимости от выбранного языка, правила оформления и работа с кодом будут отличаться. Например, в языке C# будет создана специальная переменная __debug, отвечающая за работу с отладчиком.
Также в языках присутствуют следующие ограничения:
В языке Python в панели Переменные отображаются только переменные, имена которых начинаются с символа подчеркивания.
Язык JavaScript не поддерживает отображения переменных и панели Наблюдение.
Панель Наблюдение работает только с видимыми переменными.
На странице Learning доступен RPA-проект PureCode. Он содержит примеры использования элементов в процессах с типом Только код. В проекте находятся 3 подпапки - С, JS, Python - они соответствуют выбранному языку при создании процесса.
Как открыть проект:
Скачайте архив со всеми обучающими материалами по ссылке: Скачать архив Learning.
Распакуйте архив, запустите Студию и откройте проект из папки PureCode (файл project.ltp).
Просмотрите README.md, чтобы ознакомиться с содержанием проекта, после чего откройте интересующий процесс.
В меню редактора кода находятся кнопки - используйте их, чтобы создать шаблон поиска элемента управления. При необходимости отредактировать шаблон, выделите его в коде и также используйте одну из этих кнопок.
Нажмите в меню редактора кнопку .
