Описание

Это действие используется для ввода текста в десктопные приложения. Например, с его помощью можно ввести какой-либо текст в текстовый редактор Блокнот. В этой статье он будет использоваться в качестве примера.

Desktop Picker

Сначала нужно выбрать элемент приложения, к которому будет применяться это действие. В данном случае мы выберем поле для ввода текста. Такой элемент можно выбрать в Studio при помощи Desktop Picker. Рассмотрим его работу.

Основной параметр здесь - Элемент приложения. Именно он определяет, какой элемент будет использоваться. Для того, чтобы задать новый элемент, откройте выпадающий список и выберите “Указать Новый Элемент”. Если какие-либо элементы уже существуют, они отобразятся в этом списке, и их можно будет выбрать.

Здесь можно указать новый элемент или выбрать существующий

Запустится Desktop Picker. Наведите курсор на элемент, который хотите выбрать. В случае, если элемент будет распознан, он подсветится красной рамкой. Нажмите Ctrl + X, не убирая курсор с элемента, чтобы выбрать его. 

После того, как Вы выберете элемент, откроется это окно. Это значит, что элемент был найден и правильно распознан. Здесь также можно задать название элемента, которое будет отображаться в Studio.

Меню Расширенные опции

Выпадающее меню содержит расширенные настройки элемента. Расширенные настройки представляют выбранный элемент в виде таблицы, содержащей его свойства и значения. Эту таблицу можно модифицировать, если требуется уточнить или скорректировать элемент. 

Кнопка “Проверить” позволяет убедиться, что элемент определен корректно. При нажатии на нее фокус сместится на окно браузера, и если выбранный элемент успешно распознается, то он подсветится желтой рамкой. После проверки можно будет увидеть одно из этих сообщений:

• Найден 1 элемент означает, что выбранный элемент успешно распознан.
• Найдено несколько элементов означает, что было найдено несколько похожих элементов. В таком случае требуется выбрать один из них или уточнить параметры в расширенных настройках.
• Элемент не найден означает, что элемент не был распознан и должен быть переопределен. Также может  потребоваться уточнить параметры в расширенных настройках.

Кнопка “Выбрать” позволяет выбрать элемент заново или выбрать другой элемент.

Чтобы сохранить элемент для дальнейшего использования в Studio, нажмите “Сохранить”.

После выбора элемента в Studio отобразится в параметре Элемент приложения его превью. 

Превью элемента

Есть и альтернативный вариант. Опция Использовать сфокусированный элемент позволяет использовать элемент в текущем открытом приложении. Например, у Вас открыто окно Блокнота, и Вы редактируете его (курсор установлен в поле ввода текста). В таком случае нет необходимости выбирать конкретный элемент, как описано выше. Текст будет вводиться непосредственно в открытое приложение.

Также можно отредактировать уже существующие элементы. Для этого нажмите на кнопку “Редактировать элемент” под его названием.

Эта кнопка позволяет отредактировать элемент или сменить его на новый

Вот что Вы увидите. Здесь можно изменить название элемента или выбрать новый элемент и заменить существующий. 

Здесь можно увидеть атрибуты текущего элемента и выбрать новый

Если нажать кнопку “Изменить элемент”, Picker снова активируется. Как только Вы выберете новый элемент, появится это окно. В нем отображены старая и новая версии. Здесь можно сохранить элемент и перезаписать старый или отменить замену.

Здесь можно сохранить новую версию элемента

Параметры

Теперь рассмотрим остальные параметры.

Основные параметры и пример вводимого текста

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

Задать значение позволяет ввести текст вручную. 

Вычислить значение позволяет использовать методы JS для динамического формирования вводимого текста.

Сохранить результат предыдущего шага использует в качестве вводимого текста результат работы предыдущего действия.

Исключения при вводе служебных символов
При вводе символов % , ^ , ( , ), { , } или + необходимо использовать фигурные скобки. Например, {%} , {^} , {(}.

Опция Использовать дополнительный синтаксис для отправки клавиш позволяет использовать различные зарезервированные символы, например, {, % для отправки определенных клавиш, таких как {ENTER} и других. Если опция не включена, любой символ в строке Значение будет обрабатываться как обыкновенный текст.

При этом кнопка “Набрать на клавиатуре” позволяет ввести клавишу или сочетание клавиш. В этом примере мы использовали сочетание клавиш  Ctrl + G.

Опция Использовать дополнительный синтаксис для отправки клавиш

Начиная с версии 5.4 стало возможным использовать опцию Отправить запрос/форму после ввода. Если она включена, то после заполнения поля ввода бот автоматически нажмет заданную клавишу или комбинацию клавиш для отправки формы. Комбинацию клавиш можно установить, открыв выпадающий список Отправить по нажатию на. Здесь содержатся следующие опции: Enter - значение по умолчанию, Ctrl + Enter, Alt + Enter. Эта функция удобная для взаимодействия с большим количеством функций интерфейса приложений. 

Опция Отправить запрос/форму после ввода

Параметр Задержка между нажатиями клавиш, мс позволяет задать время между вводом каждого последующего символа. Например, это можно использовать для симуляции ввода пользователя с клавиатуры.

Параметры Задержка до, сек и Задержка после, сек определяют, сколько времени пройдет перед или после выполнения данного действия.

Параметры Задержка до, сек и Задержка после, сек