Просмотреть исходный

Проверить существование элемента / Check for the existence of an element

Группа действий: XML

Описание

Действие проверяет существование элемента в указанном XML-документе.

Выбирается приоритетный способ идентификации (имя или xpath), т.е. если пользователь выбрал значение "По имени", то происходит проверка по имени, если элемент не нашелся, то действие пробует найти элемент по xpath.
Если пользователь выбрал приоритетный способ идентификации по xpath, то сперва происходит проверка по xpath, если элемент не нашелся, то выполняется проверка по имени.

Параметры

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

Контекст XML-документа - контекст открытого XML-документа. Открыть XML-документ можно с помощью с действия "Открыть" (группа "XML").
Способ поиска - способ по которому будет найден XML-элемент. Доступны 2 варианта: по имени XML-элемента, по XPath XML-элемента.

Имя XML-элемента - заполняется при выборе значения "по имени XML-элемента" в поле "Способ поиска".
XPath XML-элемента - заполняется при выборе значения "по XPath XML-элемента" в поле "Способ поиска".

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

Логический тип - «true», если элемент содержится в XML-документе, или «false», если элемент не найден.

Настройки

Свойство	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Контекст XML-документа	XML-документ, в котором будет проверяться существование элемента.	Robin.XML	Контекст XML	Да
Способ поиска	Параметр устанавливает способ поиска элемента.	Robin.String	По имени XML-элемента	Да
Имя элемента	Имя элемента, который необходимо проверить на существование. Если в поле «Способ поиска» выбран поиск по имени, это поле обязательно должно быть заполнено. Если выбран другой способ поиска, значение в этом поле не будет учитываться.	Robin.String	BOOK	Нет
XPath элемента	Путь к элементу, который необходимо проверить на существование. Если в поле «Способ поиска» выбран поиск по XPath, это поле обязательно должно быть заполнено. Если выбран другой способ поиска, значение в этом поле не будет учитываться.	Robin.String		Нет
Результаты
Результат	Действие вернет «true», если элемент содержится в XML-документе, или «false», если элемент не найден.	Robin.Boolean	true

Особые условия использования

В действии необходимо выбрать способ поиска элемента - по имени или по XPath.
Если элемент не найден по выбранному способу поиска- действие вернет "false".
Если элемент найден, действие возвращает "true".
Если не заполнен параметр поиска(По имени или По XPath), а он указан в параметре "Способ поиска", то робот вернет ошибку.

Пример использования

Задача: проверить существование элемента BOOK в XML-документе Text.xml

Решение: воспользоваться действиями "Открыть", "Проверить существование элемента".

Реализация:

Собрать схему робота, состоящую из действий:
Настроить параметр действия "Открыть".
Настроить параметры действия "Проверить существование элемента".
Нажать на кнопку "Старт" в верхней панели.

Результат:

Программный робот отработал успешно. Элемент найден.