Вы просматриваете старую версию данной страницы. Смотрите текущую версию.

Сравнить с текущим просмотр истории страницы

« Предыдущий Версия 3 Следующий »

Check element existence Version 1 (Net)

Action group: XML 

Description

The action checks if the element exists in the specified XML-document. An XML-document element means a document in text format intended for storing structured data, for exchanging information between programs.

The action selects the priority way to identify the item (name or xpath), i.e. if the user selects "By name" then the name is checked, if the item is not found then the action tries to find the item by xpath.

If the user has chosen to prioritize xpath identification, the xpath check is performed first, if the item is not found, the name check is performed.

Action icon

Action parameters

Input parameters

ParameterDescription
XML-document contextContext of the open XML-document. You can open the XML-document with the "Load XML" action.
Search methodMethod according to which the XML-element will be found. There are two options available: By element name, By element's XPath. 
Element nameSpecified when selecting value "By element name" in the "Search method" field.
Element's XPathSpecified when selecting the value "By element's XPath" in the "Search method" field. It is possible to specify both the path to the element and the element itself in the field. More details in the section: Get win-element

Output parameters

Result Boolean type -  "true" if the element exists in the XML-document, or "false" if the element is not found.

Settings of parameters

Свойство

Описание

Тип

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

Обязательность заполнения поля

Параметры

Контекст 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


Special conditions of use

  1. In the action, select whether you want to search for the item by name or by XPath.
  2. If the item is not found by the selected search method, the action will return "false".
  3. IF the element is found, the action returns "true".
  4. If the search parameter (By Name or By XPath) is not filled in, and it is specified in the "Search Method" parameter, the robot will return an error.

Example of use

Task

Check the existence of a BOOK element in an XML document Text.xml


Solution

Use the "Load XML", "Check element existence" actions.

Implementation

  1. Assemble a robot scheme with the actions.


  2. Set the "Load XML" action parameter.


  3. Set the "Check element existence" action parameters.
  4. Click "Start" in the top panel.

Result

The program robot completed successfully. The element was found.

  • Нет меток