Действия автоматизации пользовательского интерфейса

Внимание

Чтобы предотвратить несанкционированный доступ, Power Automate должен работать с теми же или более высокими привилегиями, что и приложения, которые он автоматизирует. Чтобы использовать действия автоматизации пользовательского интерфейса (кроме действия Использовать рабочий стол) для взаимодействия с приложениями, работающими с повышенными привилегиями, выполните Power Automate как администратор. Дополнительную информацию о выполнении Power Automate от имени администратора см. в статье Запуск Power Automate с повышенными правами.

Power Automate предоставляет различные действия по автоматизации пользовательского интерфейса, позволяющие пользователям взаимодействовать с Windows и классическими приложениями. Некоторые действия автоматизации пользовательского интерфейса требуют, чтобы вы установили элементы пользовательского интерфейса в их свойствах, чтобы указать элемент, который вы хотите обработать.

Чтобы добавить новый элемент пользовательского интерфейса, выберите Добавить элемент пользовательского интерфейса с помощью развернутого действия автоматизации пользовательского интерфейса или области элементов пользовательского интерфейса в конструкторе потоков.

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

Когда вы создаете элемент пользовательского интерфейса окна приложения, его селектор всегда имеет корневой элемент с именем :desktop.

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

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

Для разработки более динамических потоков замените операторы Равно другими операторами или регулярными выражениями. Кроме того, если значение атрибута селектора зависит от результатов предыдущих действий, используйте переменные вместо жестко заданных значений.

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

Заметка

Дополнительную информацию о разработке потоков автоматизации пользовательского интерфейса и создании пользовательских селекторов см. в статьях Автоматизация классических потоков и Создание настраиваемого селектора соответственно.

Получить сведения окна

Получает свойство окна, например заголовок или исходный текст.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Окно	Нет	Элемент пользовательского интерфейса		Окно, из которого требуется получить сведения
Свойство окна	Неприменимо	Получить заголовок окна, Получить текст окна, Получить расположение и размер окна, Получить имя процесса	Получить заголовок окна	Выберите свойство окна для извлечения
На передний план	Неприменимо	Логическое значение	Истина	Укажите, будет ли окно, содержащее элемент пользовательского интерфейса, выводиться на передний план во время выполнения. Если этот параметр отключен, действие выполняется в фоновом режиме. Обратите внимание, что не все элементы пользовательского интерфейса поддерживают отключение этого параметра. Кроме того, если выполнение действия требует прокрутки, при отключении этого параметра могут быть извлечены не все элементы.

Создаваемые переменные

Аргумент	Type	Description
WindowProperty	Общее значение	Извлеченные сведения окна.

Исключения

Исключение	Описание
Не удалось извлечь свойство окна.	Указывает на проблему при извлечении свойства окна.

Получить сведения элемента пользовательского интерфейса в окне

Получает значение атрибута элемента пользовательского интерфейса в окне.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Элемент пользовательского интерфейса	Нет	Элемент пользовательского интерфейса		Элемент пользовательского интерфейса, из которого требуется получить сведения
Имя атрибута	Да	Текстовое значение	Собственный текст	Атрибут, значение которого будет извлечено
На передний план	Неприменимо	Логическое значение	Истина	Укажите, будет ли окно, содержащее элемент пользовательского интерфейса, выводиться на передний план во время выполнения. Если этот параметр отключен, действие выполняется в фоновом режиме. Обратите внимание, что не все элементы пользовательского интерфейса поддерживают отключение этого параметра. Кроме того, если выполнение действия требует прокрутки, при отключении этого параметра могут быть извлечены не все элементы.

Создаваемые переменные

Аргумент	Type	Description
AttributeValue	Текстовое значение	Значение текста элемента пользовательского интерфейса.

Исключения

Исключение	Описание
Не удалось извлечь атрибут элемента пользовательского интерфейса.	Указывает на проблему при извлечении атрибута элемента пользовательского интерфейса.

Получить выбранные флажки в окне

Извлекает имена установленных флажков в группе флажков или состояние определенного флажка.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Элемент пользовательского интерфейса	Нет	Элемент пользовательского интерфейса		Флажок или группа флажков
Работа	Неприменимо	Получить имена выбранных флажков в группе, Получить состояние флажка	Получить имена выбранных флажков в группе	Укажите, следует ли извлечь состояние нескольких выбранных флажков или только одного
На передний план	Неприменимо	Логическое значение	Истина	Укажите, должно ли окно, содержащее элемент пользовательского интерфейса, выводиться на передний план во время выполнения. Если этот параметр отключен, действие будет выполняться в фоновом режиме. Обратите внимание, что не все элементы пользовательского интерфейса могут поддерживать отключение этого параметра. Кроме того, если выполнение действия требует прокрутки, при отключении этого параметра могут быть извлечены не все элементы.

Создаваемые переменные

Аргумент	Type	Description
IsChecked	Логическое значение	Состояние выбранного флажка.
SelectedCheckboxes	Списоктекстовых значений	Имена выбранных флажков в указанной группе флажков.

Исключения

Исключение	Описание
Не удалось извлечь состояние флажка.	Указывает на проблему при извлечении состояния данного флажка.

Получить выбранный переключатель в окне

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

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Элемент пользовательского интерфейса	Нет	Элемент пользовательского интерфейса		Переключатель или группа переключателей
Работа	Неприменимо	Получить имя выбранного переключателя в группе, Получить состояние переключателя	Получить имя выбранного переключателя в группе	Укажите, следует ли извлечь имя переключателя, выбранного в группе переключателей, или только состояние одного переключателя
На передний план	Неприменимо	Логическое значение	Истина	Укажите, будет ли окно, содержащее элемент пользовательского интерфейса, выводиться на передний план во время выполнения. Если этот параметр отключен, действие выполняется в фоновом режиме. Обратите внимание, что не все элементы пользовательского интерфейса поддерживают отключение этого параметра. Кроме того, если выполнение действия требует прокрутки, при отключении этого параметра могут быть извлечены не все элементы.

Создаваемые переменные

Аргумент	Type	Description
IsSelected	Логическое значение	Состояние выбранного переключателя.
SelectedRadiobutton	Текстовое значение	Выбранный переключатель в указанной группе переключателей.

Исключения

Исключение	Описание
Не удалось извлечь состояние переключателя.	Указывает на проблему при извлечении состояния данного переключателя.

Извлечь данные из окна

Извлекает данные из определенных частей окна в виде отдельных значений, списков или таблиц.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Окно	Нет	Элемент пользовательского интерфейса		Окно, из которого требуется извлечь данные
Хранить извлеченные данные в	Неприменимо	электронная таблица Excel, Переменная	электронная таблица Excel	Укажите, где требуется сохранить извлеченные данные
На передний план	Неприменимо	Логическое значение	Истина	Укажите, будет ли окно, содержащее элемент пользовательского интерфейса, выводиться на передний план во время выполнения. Если этот параметр отключен, действие выполняется в фоновом режиме. Обратите внимание, что не все элементы пользовательского интерфейса поддерживают отключение этого параметра. Кроме того, если выполнение действия требует прокрутки, при отключении этого параметра могут быть извлечены не все элементы.

Создаваемые переменные

Аргумент	Type	Description
ExcelInstance	Экземпляр Excel	Экземпляр Excel с извлеченными данными. Используйте этот экземпляр для работы с электронной таблицей (или сохраните и закройте его) с помощью выделенных действий Excel.
DataFromWindow	Общее значение	Извлеченные данные в форме таблицы данных.

Исключения

Исключение	Описание
Не удалось извлечь.	Указывает на проблему при извлечении данных из данного окна.

Сделать снимок экрана элемента пользовательского интерфейса

Делает снимок экрана элемента пользовательского интерфейса в окне.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Элемент пользовательского интерфейса	Нет	Элемент пользовательского интерфейса		Элемент пользовательского интерфейса в окне для захвата в качестве снимка экрана
Режим сохранения	Н/Д	Буфер обмена, Файл	Буфер обмена	Укажите, куда следует сохранить изображение: в файл или в буфер обмена
Image file path	Нет	Файл		Задайте полный путь для сохраняемого файла
File format	Н/Д	BMP, EMF, EXIF, GIF, JPG, PNG, TIFF, WMF	BMP	Формат файл изображения

Создаваемые переменные

Аргумент	Type	Description
ImageFile	Файл	Путь к создаваемому файлу изображения со снимком экрана

Исключения

Исключение	Описание
Не удалось извлечь элемент пользовательского интерфейса	Указывает на проблему при извлечении элемента пользовательского интерфейса
Не удалось сохранить изображение	Указывает на проблему при сохранении сделанного снимка экрана
Не удалось сделать снимок экрана элемента пользовательского интерфейса	Указывает на проблему при захвате снимка экрана элемента пользовательского интерфейса

Установить фокус на текстовом поле в окне

Устанавливает фокус на текстовое поле в окне и прокручивает окно так, чтобы поле находилось в видимой области.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Текстовое поле	Нет	Элемент пользовательского интерфейса		Текстовое поле, на которое требуется установить фокус

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Description
Не удалось установить фокус ввода на текстовое поле окна.	Указывает на проблему при установке фокуса на указанное текстовое поле веб-страницы.

Заполнить текстовое поле в окне

Заполняет текстовое поле в окне указанным текстом.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Текст	Нет	Элемент пользовательского интерфейса		Текстовое поле, которое требуется заполнить
Текст для заполнения	Нет	Прямой ввод зашифрованного текста или Текстовое значение		Текст для заполнения текстового поля
Имитирование действия	Неприменимо	Логическое значение	False	Программная имитация использования нажатий клавиш при заполнении текстовых полей в пользовательском интерфейсе. Этот вариант не требует, чтобы окно элемента пользовательского интерфейса было в фокусе, и оно автоматически не переместится на передний план. Обратите внимание, что этот параметр можно применить только к действию щелчка левой кнопкой мыши и не к каждому элементу пользовательского интерфейса.
Если поле не пустое	Да	Заменить текст, Добавить текст	Заменить текст	Укажите, что делать с существующим содержимым: заменять его или добавлять к нему новое.
Click before populating	Да	Щелчок левой кнопкой мыши, двойной щелчок, нет	Щелчок левой кнопкой мыши	Укажите, производится ли щелчок левой кнопкой мыши перед заполнением текстового поля.

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Description
Не удалось записать в текстовое поле.	Указывает на проблему при заполнении данного текстового поля.

Нажать кнопку в окне

Нажимает кнопку в окне.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Элемент пользовательского интерфейса	Нет	Элемент пользовательского интерфейса		Кнопка, которую требуется нажать

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Description
Не удалось нажать кнопку.	Указывает на проблему при нажатии данной кнопки.

Выбрать переключатель в окне

Выбирает переключатель в окне.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Radio button	Нет	Элемент пользовательского интерфейса		Переключатель для выбора

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Description
Не удалось выбрать элемент пользовательского интерфейса переключателя.	Указывает на проблему при выборе данного элемента пользовательского интерфейса переключателя.

Установить состояние флажка в окне

Устанавливает или снимает флажок в форме-окне.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Флажок	Нет	Элемент пользовательского интерфейса		Флажок, состояние которого требуется задать
Задать состояние флажка	Неприменимо	Установлен, Не установлен	Установлен	Указывает, будет флажок установлен или снят

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Description
Не удалось задать состояние флажка.	Указывает на проблему при задании состояния данного флажка.

Установить значение раскрывающегося списка в окне

Задает или очищает выбранные параметры для раскрывающегося списка в форме окна.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Раскрывающийся список	Нет	Элемент пользовательского интерфейса		Раскрывающийся список, значение из которого требуется задать
Работа	Неприменимо	Очистить выбранные параметры, Выбрать параметры по имени, Выбрать параметры по индексу	Очистить выбранные параметры	Укажите, следует ли выбрать значение по имени или по порядковому положению (1 2 3 ...) либо очистить выбранное значение в раскрывающемся списке.
Имена параметров	Нет	Списоктекстовых значений		Введите вариант или список вариантов для выбора в раскрывающемся списке. Вводить несколько вариантов имеет смысл только при работе со списками с множественным выбором. В случае списка с единичным выбором будет использоваться только первый вариант из указанного списка.
Использовать регулярные выражения	Неприменимо	Логическое значение	Ложь	Укажите, следует ли интерпретировать значения имен вариантов как регулярное выражение.
Индексы параметров	Нет	Списокчисловых значений		Введите индекс или список индексов для выбора в раскрывающемся списке. Вводить несколько вариантов имеет смысл только при работе со списками с множественным выбором. В случае списка с единичным выбором будет использоваться только первый вариант из указанного списка.

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Description
Не удалось выбрать данные параметры в раскрывающемся списке	Указывает на проблему при выборе данных параметров в раскрывающемся списке

Получить окно

Получает выполняемое окно для автоматизации классических приложений.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Get window	Н/Д	Конкретное окно, Окно переднего плана	Конкретное окно	Укажите, следует ли выполнять поиск с помощью селектора или окна переднего плана
Элемент пользовательского интерфейса	Нет	Элемент пользовательского интерфейса		Селектор окна для получения
Перенести окно на передний план	Неприменимо	Логическое значение	Ложь	Укажите, следует ли переводить окно на первый план автоматически после его получения.
Fail if window isn't found	Н/Д	Логическое значение	Истина	Укажите, следует ли бесконечно ждать, пока не отобразится окно, или выдать ошибку, если окно не отобразится в течение заданного периода времени.
Время ожидания	Нет	Числовое значение		Время ожидания в секундах.

Создаваемые переменные

Аргумент	Type	Description
WindowTitle	Текстовое значение	Заголовок окна переднего плана.
AutomationWindow	Экземпляр окна	Определенный экземпляр окна для использования с последующими действиями автоматизации пользовательского интерфейса.

Исключения

Исключение	Описание
Не удалось получить окно.	Указывает на проблему при получении окна.

Установить фокус на окно

Активирует и переводит на передний план определенное окно.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Find window mode	Н/Д	По элементу пользовательского интерфейса окна, По экземпляру/дескриптору окна, По заголовку и/или классу	По элементу пользовательского интерфейса окна	Укажите, следует ли выполнять поиск окна с помощью элемента пользовательского интерфейса или сочетания заголовка/класса окна
Окно	Нет	Элемент пользовательского интерфейса		Элемент пользовательского интерфейса окна
Заголовок окна	Да	Текстовое значение		Заголовок окна. Подстановочные знаки могут быть использованы, такие как "?" или "*".
Window instance	Нет	Числовое значение		Экземпляр или дескриптор окна, на которое требуется установить фокус.
Window class	Да	Текстовое значение		Если имеется два окна с одинаковым заголовком, класс окна может помочь их различить. В этом случае введите класс окна для использования.

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Description
Окно не найдено.	Указывает, что данное окно не найдено.
Невозможно установить фокус на окно.	Указывает на проблему при установке фокуса на данное окно.
Невозможно выполнить действие, связанное с окном, в неинтерактивном режиме	Указывает на проблему при выполнении действия, связанного с окном, в неинтерактивном режиме.

Установить состояние окна

Восстанавливает, разворачивает или сворачивает определенное окно.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Find window mode	Н/Д	По элементу пользовательского интерфейса окна, По экземпляру/дескриптору окна, По заголовку и/или классу	По элементу пользовательского интерфейса окна	Укажите, следует ли выполнять поиск окна с помощью элемента пользовательского интерфейса или сочетания заголовка/класса окна
Окно	Нет	Элемент пользовательского интерфейса		Элемент пользовательского интерфейса окна
Заголовок окна	Да	Текстовое значение		Заголовок окна. Подстановочные знаки могут быть использованы, такие как "?" или "*".
Window instance	Нет	Числовое значение		Экземпляр или дескриптор окна, состояние которого требуется задать.
Window class	Да	Текстовое значение		Если имеется два окна с одинаковым заголовком, класс окна может помочь их различить. В этом случае введите класс окна для использования.
Window state	Н/Д	Восстановлено, Развернуто, Свернуто	Восстановлено	Выберите состояние окна для отображения.

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Description
Окно не найдено.	Указывает, что данное окно не найдено.
Невозможно задать состояние окна.	Указывает на проблему при задании состояния данного окна.
Невозможно выполнить действие, связанное с окном, в неинтерактивном режиме	Указывает на проблему при выполнении действия, связанного с окном, в неинтерактивном режиме.

Задать видимость окна

Показывает скрытое окно или скрывает отображаемое окно.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Find window mode	Н/Д	По элементу пользовательского интерфейса окна, По экземпляру/дескриптору окна, По заголовку и/или классу	По элементу пользовательского интерфейса окна	Укажите, следует ли выполнять поиск окна с помощью элемента пользовательского интерфейса или сочетания заголовка/класса окна
Окно	Нет	Элемент пользовательского интерфейса		Элемент пользовательского интерфейса окна
Заголовок окна	Да	Текстовое значение		Заголовок окна. Подстановочные знаки могут быть использованы, такие как "?" или "*".
Window instance	Нет	Числовое значение		Экземпляр или дескриптор окна, видимость которого требуется задать.
Window class	Да	Текстовое значение		Если имеется два окна с одинаковым заголовком, класс окна может помочь их различить. В этом случае введите класс окна для использования.
Visibility	Н/Д	Видимый, Скрытый	Скрытый	Выберите состояние видимости окна.

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Description
Окно не найдено.	Указывает, что данное окно не найдено.
Невозможно задать видимость окна.	Указывает на проблему при задании видимости данного окна.
Невозможно выполнить действие, связанное с окном, в неинтерактивном режиме	Указывает на проблему при выполнении действия, связанного с окном, в неинтерактивном режиме.

Переместить окно

Задает положение определенного окна.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Find window mode	Н/Д	По элементу пользовательского интерфейса окна, По экземпляру/дескриптору окна, По заголовку и/или классу	По элементу пользовательского интерфейса окна	Укажите, следует ли выполнять поиск окна с помощью элемента пользовательского интерфейса или сочетания заголовка/класса окна
Окно	Нет	Элемент пользовательского интерфейса		Элемент пользовательского интерфейса окна
Заголовок окна	Да	Текстовое значение		Заголовок окна. Подстановочные знаки могут быть использованы, такие как "?" или "*".
Window instance	Нет	Числовое значение		Экземпляр или дескриптор окна для перемещения.
Window class	Да	Текстовое значение		Если имеется два окна с одинаковым заголовком, класс окна может помочь их различить. В этом случае введите класс окна для использования.
Position X	Нет	Числовое значение		Положение окна по оси X.
Position Y	Нет	Числовое значение		Положение окна по оси Y.

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Description
Окно не найдено.	Указывает, что данное окно не найдено.
Невозможно переместить окно.	Указывает на проблему при перемещении данного окна.
Невозможно выполнить действие, связанное с окном, в неинтерактивном режиме	Указывает на проблему при выполнении действия, связанного с окном, в неинтерактивном режиме.

Изменить размер окна

Задает размер определенного окна.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Find window mode	Н/Д	По элементу пользовательского интерфейса окна, По экземпляру/дескриптору окна, По заголовку и/или классу	По элементу пользовательского интерфейса окна	Укажите, следует ли выполнять поиск окна с помощью элемента пользовательского интерфейса или сочетания заголовка/класса окна
Окно	Нет	Элемент пользовательского интерфейса		Элемент пользовательского интерфейса окна
Заголовок окна	Да	Текстовое значение		Заголовок окна. Подстановочные знаки могут быть использованы, такие как "?" или "*".
Window instance	Нет	Числовое значение		Экземпляр или дескриптор окна для изменения размера.
Window class	Да	Текстовое значение		Если имеется два окна с одинаковым заголовком, класс окна может помочь их различить. В этом случае введите класс окна для использования
Width	Нет	Числовое значение		Новая ширина в пикселях.
Height	Нет	Числовое значение		Новая высота в пикселях.

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Description
Окно не найдено.	Указывает, что данное окно не найдено.
Невозможно изменить размер окна.	Указывает на проблему при изменении размера окна.
Невозможно выполнить действие, связанное с окном, в неинтерактивном режиме	Указывает на проблему при выполнении действия, связанного с окном, в неинтерактивном режиме.

Закрыть окно

Закрывает определенное окно.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Find window mode	Н/Д	По элементу пользовательского интерфейса окна, По экземпляру/дескриптору окна, По заголовку и/или классу	По элементу пользовательского интерфейса окна	Укажите, следует ли выполнять поиск окна с помощью элемента пользовательского интерфейса или сочетания заголовка/класса окна
Окно	Нет	Элемент пользовательского интерфейса		Элемент пользовательского интерфейса окна
Заголовок окна	Да	Текстовое значение		Заголовок окна. Подстановочные знаки могут быть использованы, такие как "?" или "*".
Window instance	Нет	Числовое значение		Экземпляр или дескриптор окна, которое требуется закрыть.
Window class	Да	Текстовое значение		Если имеется два окна с одинаковым заголовком, класс окна может помочь их различить. В этом случае введите класс окна для использования.

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Description
Окно не найдено.	Указывает, что данное окно не найдено.
Невозможно закрыть окно.	Указывает на проблему при закрытии данного окна.
Невозможно выполнить действие, связанное с окном, в неинтерактивном режиме	Указывает на проблему при выполнении действия, связанного с окном, в неинтерактивном режиме.

Если окно содержит

Помечает начало условного блока действий в зависимости от того, существует ли определенный блок текста или элемент пользовательского интерфейса в окне.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Check if window	Н/Д	Содержит элемент пользовательского интерфейса, Не содержит элемента пользовательского интерфейса, Содержит текст, Не содержит текста	Содержит элемент пользовательского интерфейса	Проверьте, существует ли определенный текст или элемент пользовательского интерфейса в окне.
Check UI element state	Н/Д	Логическое значение	Ложь	Проверьте, включен или отключен ли определенный элемент пользовательского интерфейса
Текст	Нет	Текстовое значение		Текст, который требуется проверить
Элемент пользовательского интерфейса	Нет	Элемент пользовательского интерфейса		Элемент пользовательского интерфейса, наличие которого требуется проверить
Окно	Нет	Элемент пользовательского интерфейса		Окно, которое следует проверить на наличие текста
Состояние	Неприменимо	Включено, Отключено	Включено	Состояние элемента пользовательского интерфейса, которое требуется проверить.

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Это действие не включает никаких исключений.

Ожидать содержимое окна

Приостанавливает выполнение автоматизации до тех пор, пока определенный блок текста или элемент пользовательского интерфейса не появится или не исчезнет в окне.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Wait until window	Н/Д	Содержит элемент пользовательского интерфейса, Не содержит элемента пользовательского интерфейса, Содержит текст, Не содержит текста	Содержит элемент пользовательского интерфейса	Следует ли ждать отображения определенного текста или элемента пользовательского интерфейса в окне.
Check UI element state	Н/Д	Логическое значение	Ложь	Проверьте, включен или отключен ли определенный элемент пользовательского интерфейса
Текст	Нет	Текстовое значение		Текст, который требуется проверить
Элемент пользовательского интерфейса	Нет	Элемент пользовательского интерфейса		Элемент пользовательского интерфейса, наличие которого требуется проверить
Окно	Нет	Элемент пользовательского интерфейса		Окно, которое следует проверить на наличие текста
Состояние	Неприменимо	Включено, Отключено	Включено	Состояние элемента пользовательского интерфейса, которое требуется проверить.

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Description
Сбой ожидания содержимого окна.	Указывает, что произошел сбой операции ожидания.

Если изображение

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

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
If image	Н/Д	существует, не существует	существует	Следует ли проверить наличие или отсутствие выбранного изображения
Изображение	Нет	Списокизображений		Изображения, существование которых проверяет действие
Искать изображение на	Н/Д	Весь экран, Только окно переднего плана	Весь экран	Указывает, нужно ли искать указанное изображение только в окне переднего плана или на всем видимом экране. Ни один из вариантов не найдет изображение, если оно не четко видно на экране
Search mode	Н/Д	Искать по всему экрану или находящемуся на переднем плане окну, Искать в указанной подобласти экрана или находящегося на переднем плане окне	Искать по всему экрану или находящемуся на переднем плане окну	Следует ли сканировать весь экран (или окно) для поиска предоставленного текста или только его определенную подобласть.
Find all images in the list	Н/Д	Логическое значение	Ложь	Проверьте, существуют ли все изображения в списке.
X1	Да	Числовое значение		Начальная координата X подобласти для поиска заданного текста
X2	Да	Числовое значение		Конечная координата X подобласти для поиска заданного текста
Y1	Да	Числовое значение		Начальная координата Y подобласти для поиска заданного текста
Y2	Да	Числовое значение		Конечная координата Y подобласти для поиска заданного текста
Tolerance	Да	Числовое значение	10	Укажите, насколько искомое изображение может отличаться от изначально выбранного изображения
Алгоритм сопоставления изображений	Неприменимо	Базовый, Расширенный	Обычный	Какой алгоритм будет использоваться при поиске изображения

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Description
Невозможно проверить изображение в неинтерактивном режиме	Указывает, что изображение невозможно идентифицировать в неинтерактивном режиме.
Недопустимые координаты подобласти	Указывает, что координаты заданной подобласти недопустимы.

Использовать рабочий стол

Выполняет операции, связанные с рабочим столом и панелью задач.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Элемент пользовательского интерфейса	Нет	Элемент пользовательского интерфейса		Элемент пользовательского интерфейса, который требуется щелкнуть
Click type	Неприменимо	Щелчок левой кнопкой мыши, Щелчок правой кнопкой мыши, Двойной щелчок	Щелчок левой кнопкой мыши	Тип щелчка для выполнения
Launch new application when left-clicking on the taskbar	Н/Д	Логическое значение	Истина	Если для этого параметра задано значение "Истина", он гарантирует, что будет создано новое окно приложения при нажатии левой кнопкой мыши соответствующего значка на панели быстрого запуска, т. е. панели задач Windows 7 или выше. Снимите этот флажок, чтобы перевести на передний план уже запущенный экземпляр приложения.

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Description
Не удалось выполнить операцию панели задач.	Указывает, что произошел сбой операции панели задач.

Выбрать вкладку в окне

Выбирает вкладку из группы вкладок.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Tab	Нет	Элемент пользовательского интерфейса		Вкладка для выбора

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Description
Не удалось выбрать вкладку.	Указывает на проблему при выборе данной вкладки.

Ожидать изображение

Это действие ожидает, пока на экране или в окне переднего плана не появится определенное изображение.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Wait for image to	Н/Д	Отобразить, Скрыть	Отобразить	Укажите, следует ли ждать отображения или скрытия изображений
Изображение которого следует ожидать	Нет	Списокизображений		Изображения, существование которых проверяет действие
Искать изображение на	Н/Д	Весь экран, Только окно переднего плана	Весь экран	Указывает, нужно ли искать указанное изображение только в окне переднего плана или на всем видимом экране. Ни один из вариантов не найдет изображение, если оно не четко видно на экране
Search mode	Н/Д	Искать по всему экрану или находящемуся на переднем плане окну, Искать в указанной подобласти экрана или находящегося на переднем плане окне	Искать по всему экрану или находящемуся на переднем плане окну	Следует ли сканировать весь экран (или окно) для поиска предоставленного текста или только его определенную подобласть.
Wait for all images	Н/Д	Логическое значение	Ложь	Следует ли ждать отображения (скрытия) всех изображений в списке или только одного из них.
X1	Да	Числовое значение		Начальная координата X подобласти для поиска заданного текста
X2	Да	Числовое значение		Конечная координата X подобласти для поиска заданного текста
Y1	Да	Числовое значение		Начальная координата Y подобласти для поиска заданного текста
Y2	Да	Числовое значение		Конечная координата Y подобласти для поиска заданного текста
Tolerance	Да	Числовое значение	10	Укажите, насколько искомое изображение может отличаться от изначально выбранного изображения
Алгоритм сопоставления изображений	Неприменимо	Базовый, Расширенный	Обычный	Какой алгоритм будет использоваться при поиске изображения
Сбой с ошибкой времени ожидания	Неприменимо	Логическое значение	False	Укажите, должно ли действие ждать бесконечно или завершаться сбоем по прошествии заданного периода времени

Создаваемые переменные

Аргумент	Type	Description
X	Числовое значение	Координата X точки, в которой текст найден на экране. Если поиск текста выполнялся в окне переднего плана, это значение указывается относительно левого верхнего угла окна.
Y	Числовое значение	Координата Y точки, в которой текст найден на экране. Если поиск текста выполнялся в окне переднего плана, это значение указывается относительно левого верхнего угла окна.

Исключения

Исключение	Описание
Сбой ожидания изображения.	Указывает, что произошел сбой операции ожидания.
Невозможно проверить изображение в неинтерактивном режиме	Указывает, что изображение невозможно идентифицировать в неинтерактивном режиме.
Недопустимые координаты подобласти	Указывает, что координаты заданной подобласти недопустимы

Навести указатель мыши на элемент пользовательского интерфейса в окне

Позволяет навести мышь на любой элемент пользовательского интерфейса в окне.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Элемент пользовательского интерфейса	Нет	Элемент пользовательского интерфейса		Выберите элемент пользовательского интерфейса в окне для наведения указателя

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Description
Не удалось навести указатель на элемент.	Указывает, что наведение на элемент не удалось

Щелкнуть элемент пользовательского интерфейса в окне

Щелчок по любому элементу пользовательского интерфейса окна.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Элемент пользовательского интерфейса	Нет	Элемент пользовательского интерфейса		Элемент пользовательского интерфейса, на котором следует выполнить щелчок
Click type	Неприменимо	Щелчок левой кнопкой мыши, Щелчок правой кнопкой мыши, Двойной щелчок, Щелчок средней кнопкой мыши, Левая кнопка вниз, Левая кнопка вверх, Правая кнопка вниз, Правая кнопка вверх	Щелчок левой кнопкой мыши	Тип щелчка для выполнения
Имитирование действия	Неприменимо	Логическое значение	False	Укажите, следует ли имитировать перемещение курсора мыши над элементом перед щелчком. Этот вариант не требует, чтобы окно элемента пользовательского интерфейса было в фокусе, и оно автоматически не переместится на передний план. Обратите внимание, что этот параметр можно применить только к действию щелчка левой кнопкой мыши и не к каждому элементу пользовательского интерфейса.
Mouse position relative to UI element	Неприменимо	Вверху слева, Вверху в центре, Вверху справа, Посередине слева, Посередине в центре, Посередине справа, Внизу слева, Внизу в центре, Внизу справа	Посередине в центре	Укажите, в какой раздел элемента пользовательского интерфейса будет перемещен указатель мыши перед щелчком.
Offset X	Да	Текстовое значение	0	Смещение мыши вправо в пикселях
Offset Y	Да	Текстовое значение	0	Смещение мыши вниз в пикселях

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Description
Не удалось щелкнуть.	Указывает на сбой щелчка.

Выбрать пункт меню в окне

Выбирает пункт меню окна.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Элемент пользовательского интерфейса	Нет	Элемент пользовательского интерфейса		Пункт меню, который следует выбрать

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Description
Не удалось выбрать пункт.	Указывает на проблему при выборе данного пункта меню.

Перетащить элемент пользовательского интерфейса в окне

Перетаскивает элемент пользовательского интерфейса в окне.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Элемент пользовательского интерфейса для перетаскивания	Нет	Элемент пользовательского интерфейса		Элемент пользовательского интерфейса для перетаскивания
Элемент пользовательского интерфейса, на который следует перетащить	Нет	Элемент пользовательского интерфейса		Элемент пользовательского интерфейса для переноса
Click type	Неприменимо	Щелчок левой кнопкой мыши, Щелчок правой кнопкой мыши	Щелчок левой кнопкой мыши	Укажите, какую кнопку мыши следует использовать для нажатия и удержания при перетаскивании элемента пользовательского интерфейса в требуемое положение
Mouse down offset X	Да	Текстовое значение	0	Смещение указателя мыши вниз, которое будет использоваться для перетаскивания элемента пользовательского интерфейса на определенное количество пикселей вправо.
Mouse down offset Y	Да	Текстовое значение	0	Смещение указателя мыши вниз, которое будет использоваться для перетаскивания элемента пользовательского интерфейса на определенное количество пикселей вниз.
Mouse down position relative to drag-target UI element	Н/Д	Вверху слева, Вверху в центре, Вверху справа, Посередине слева, Посередине в центре, Посередине справа, Внизу слева, Внизу в центре, Внизу справа	Посередине в центре	Укажите, в какой раздел элемента пользовательского интерфейса нужно переместить мышь перед щелчком
Mouse up offset X	Да	Текстовое значение	0	Смещение указателя мыши вверх, которое будет использоваться для перетаскивания элемента пользовательского интерфейса на определенное количество пикселей вправо.
Mouse up offset Y	Да	Текстовое значение	0	Смещение указателя мыши вверх, которое будет использоваться для перетаскивания элемента пользовательского интерфейса на определенное количество пикселей вниз.
Mouse up position relative to drop-target UI element	Н/Д	Вверху слева, Вверху в центре, Вверху справа, Посередине слева, Посередине в центре, Посередине справа, Внизу слева, Внизу в центре, Внизу справа	Посередине в центре	Укажите, в какой раздел элемента пользовательского интерфейса нужно переместить мышь после щелчка

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Description
Элемент пользовательского интерфейса для перетаскивания не найден.	Указывает, что элемент пользовательского интерфейса для перетаскивания не найден.
Элемент пользовательского интерфейса места переноса не найден.	Указывает, что элемент пользовательского интерфейса места переноса не найден.
Не удалось перетащить.	Указывает на проблему при перетаскивании указанного элемента пользовательского интерфейса

Развернуть/свернуть узел дерева в окне

Разворачивает или сворачивает узел древовидного представления в окне.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Элемент пользовательского интерфейса	Нет	Элемент пользовательского интерфейса		Узел дерева, который требуется развернуть/свернуть
Путь с папками	Да	Текстовое значение		Разделенный косой чертой путь, состоящий из имен папок, который ведет к узлу дерева, который требуется развернуть или свернуть.
Use regular expressions	Н/Д	Логическое значение	Ложь	Укажите, следует ли интерпретировать каждое имя папки в пути как регулярное выражение.
Operation	Н/Д	Развернуть, Свернуть	Развернуть	Укажите, следует ли развернуть или свернуть узел дерева.

Заметка

Механизм регулярных выражений Power Automate — .NET. Дополнительную информацию о регулярных выражениях см. в статье Язык регулярных выражений — краткий справочник.

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Description
Не удалось задать данное состояние для узла дерева.	Указывает на проблему при задании данного состояния для узла дерева.

Если окно

Это действие помечает начало условного блока действий в зависимости от того, открыто ли окно или установлен ли на нем фокус (окно переднего плана).

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Get window	Н/Д	По элементу пользовательского интерфейса окна, По экземпляру/дескриптору окна, По заголовку и/или классу	По элементу пользовательского интерфейса окна	Укажите, следует ли выполнять поиск окна с помощью элемента пользовательского интерфейса или сочетания заголовка/класса окна.
Window title	Да	Текстовое значение		Заголовок окна. Могут использоваться подстановочные знаки, такие как «?» или «*».
Окно	Нет	Элемент пользовательского интерфейса		Элемент пользовательского интерфейса окна
Экземпляр окна	Нет	Числовое значение		Экземпляр или дескриптор окна, которое требуется проверить
Window class	Да	Текстовое значение		Если имеется два окна с одинаковым заголовком, класс окна может помочь их различить. В этом случае введите класс окна для использования.
Check if window	Н/Д	Открыто, Не открыто, С фокусом, Без фокуса	Открыто	Состояние окна, которое требуется проверить.

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Это действие не включает никаких исключений.

Ожидать окно

Приостанавливает выполнение или обработку до тех пор, пока определенное окно не откроется, закроется, получит или потеряет фокус.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Description
Find window	Н/Д	По элементу пользовательского интерфейса окна, По экземпляру/дескриптору окна, По заголовку и/или классу	По элементу пользовательского интерфейса окна	Укажите, следует ли выполнять поиск окна с помощью элемента пользовательского интерфейса или сочетания заголовка/класса окна.
Window title	Да	Текстовое значение		Заголовок окна. Могут использоваться подстановочные знаки, такие как «?» или «*».
Окно	Нет	Элемент пользовательского интерфейса		Элемент пользовательского интерфейса окна
Экземпляр окна	Нет	Числовое значение		Экземпляр или дескриптор окна, которое требуется проверить
Window class	Да	Текстовое значение		Если имеется два окна с одинаковым заголовком, класс окна может помочь их различить. В этом случае введите класс окна для использования
Wait for window to	Н/Д	Открыть, Закрыть, Получить фокус, Потерять фокус	Открытые	Следует ли ждать открытия окна, закрытия окна, установки фокуса на окно (то есть окно становится окном переднего плана) или потери фокуса окном (то есть окно перестает быть окном переднего плана).
Focus window after it opens	Н/Д	Логическое значение	Ложь	Перевод окна на передний план после его открытия, чтобы последующие действия выполнялись с этим окном.

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Description
Невозможно установить фокус на окно.	Указывает на проблему при установке фокуса на данное окно.
Сбой ожидания окна.	Указывает, что произошел сбой операции ожидания.
Невозможно выполнить действие, связанное с окном, в неинтерактивном режиме	Указывает на проблему при выполнении действия, связанного с окном, в неинтерактивном режиме.