История страницы
Проверить существование
...
элемента Версия 1 (Net)
Группа действий: XML
...
Описание
Действие проверяет существование элемента в указанном XML-документе. Под элементом XML-документа подразумевается документ в текстовом формате, предназначенным для хранения структурированных данных, для обмена информацией между программами.
Действие выбирает приоритетный способ идентификации элемента (имя или xpath), т.е. если пользователь выбрал значение "По имени", то происходит проверка по имени, если элемент не нашелся, то действие пробует найти элемент по xpath.
Если пользователь выбрал приоритетный способ идентификации по xpath, то сперва происходит проверка по xpath, если элемент не нашелся, то выполняется проверка по имени.
Иконка действия
Параметры
Входные параметры
Контекст XML-документа - контекст открытого XML-документа. Открыть XML-документ можно с помощью с действия "Открыть" (группа "XML").
Способ поиска - способ по которому будет найден XML-элемент. Доступны 2 варианта: по имени XML-элемента, по XPath XML-элемента.
Имя XML-элемента - заполняется при выборе значения "по имени XML-элемента" в поле "Способ поиска".
XPath XML-элемента - заполняется при выборе значения "по XPath XML-элемента" в поле "Способ поиска". В поле возможно указать, как путь к элементу, так и сам элемент. Подробнее в разделе: Получение win-элемента
Выходные параметры
Логический тип - «true», если элемент содержится в XML-документе, или «false», если элемент не найден.
Настройки
Параметры и их настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | ||||
Контекст XML-документа | XML-документ, в котором будет проверяться существование элемента | |||
Robin.XML | Контекст XML | Да | |
Способ поиска | Параметр устанавливает способ поиска элемента |
Robin.String | По имени XML-элемента | Да | |
Имя элемента | Имя элемента, который необходимо проверить на существование. Если в поле |
"Способ поиска" выбран поиск по имени, это поле обязательно должно быть заполнено. Если выбран другой способ поиска, значение в этом поле не будет учитываться |
Robin.String | BOOK | Нет | |
XPath элемента | Путь к элементу, который необходимо проверить на существование. Если в поле |
"Способ поиска" выбран поиск по XPath, это поле обязательно должно быть заполнено. Если выбран другой способ поиска, значение в этом поле не будет учитываться |
Robin.String | msctls_statusbar32[1035,8]/text[2,1182]*Notepad++ | Нет | ||
| Результаты | ||||
Результат | Действие вернет | |||
"true", если элемент содержится в XML-документе, или |
"false", если элемент не найден |
Robin.Boolean | true |
Особые условия использования
- В действии необходимо выбрать способ поиска элемента - по имени или по XPath.
- Если элемент не найден по выбранному способу поиска- действие вернет "false".
- Если элемент найден, действие возвращает "true".
- Если не заполнен параметр поиска (По имени или По XPath), а он указан в параметре "Способ поиска", то робот вернет ошибку.
Пример использования
Задача
Проверить : проверить существование элемента BOOK в XML-документе Text.xml.
Решение
Воспользоваться действиями "Открыть", "Проверить существование элемента".
Реализация
- Собрать схему робота, состоящую из действий :
- .
- Настроить параметр действия "Открыть".
- Настроить параметры действия "Проверить существование элемента".
- Нажать на кнопку "Старт" в верхней панели.
Результат
Программный робот отработал успешно. Элемент найден. 
Обзор
Инструменты контента