Перейти до вмісту

Прочитати дані елемента

Тип вузла browser_getElement

Призначення

Читає текст, HTML або атрибут із заданою назвою з одного чи кількох знайдених елементів.

Налаштування в настільному клієнті

Налаштування вузла «Прочитати дані елемента» в настільному клієнті

Знімок екрана зроблено в англійському інтерфейсі MoreLogin Desktop V2.73.101.

Вхідні дані

Ці поля розміщуються в data.browserUi.inputs.

ПолеТип або значенняОбов'язкове за схемоюЗначення за замовчуванням під час виконанняОпис і обмеження
selectorType"selector" / "element" / "frame" (підтримує посилання на змінні)Ні"selector"Джерело елемента. Початкове значення в редакторі: "selector"
framestringНі—Змінна iframe
elementstringНі—Змінна елемента
selectorRadio"CSS" / "XPath" (підтримує посилання на змінні)Ні"CSS"Тип селектора. Початкове значення в редакторі: "CSS". Наприклад, "${locatorType}"; значення, на яке посилаються, має бути "CSS" або "XPath".
selectorstringНі—Селектор
outputRange"single" / "all" (підтримує посилання на змінні)Ні"single"Якщо збігається кілька об'єктів елементів. Початкове значення в редакторі: "single"
serialType"fixed" / "randomInterval" (підтримує посилання на змінні)Ні"fixed"Якщо збігається кілька об'єктів елементів. Початкове значення в редакторі: "fixed"
serialWorkflowNumberНі1Індекс елемента; ціле число; мінімум після розв'язання: 1. Початкове значення в редакторі: 1
serialMinWorkflowNumberНі—Мінімальний індекс; ціле число; мінімум після розв'язання: 1
serialMaxWorkflowNumberНі—Максимальний індекс; ціле число; мінімум після розв'язання: 1
type"innerText" / "innerHTML" / "attribute" (підтримує посилання на змінні)Ні"innerText"Тип вихідних даних. Початкове значення в редакторі: "innerText"
keystringНі—Назва атрибута / селектор дочірнього елемента

Вимоги до режимів і обмеження

  • Правила пошуку елемента: selectorType=selector потребує selector; frame потребує frame+selector; element потребує посилання ElementRef з попереднього вузла. serial починається з 1. randomInterval використовує serialMin/serialMax, і мінімум не може бути більшим за максимум. Вузол спочатку чекає, доки селектор знайде відповідні елементи, а потім один раз вибирає індекс: верхня межа діапазону обмежується фактичною кількістю збігів. Якщо фіксований індекс або нижня межа діапазону перевищує кількість збігів, одразу повертається ELEMENT_NOT_FOUND (reason=range, details.field має значення serial або serialMin), а зі сторінкою не виконується жодних дій. outputRange може мати лише значення single/all. type може мати лише значення innerText/innerHTML/attribute (як у редакторі; для об'єктів елементів використовуйте getElementRef, а для iframe використовуйте getFrame), і type=attribute потребує key (назви атрибута). Читайте повернуті ключі та значення як одне значення або масив відповідно до гілки. Вузол не чекає появи елемента: якщо нічого не знайдено, він одразу завершується успішно, одне значення є порожнім рядком "" (для all це []), а відсутній атрибут дорівнює "". Якщо потрібно зачекати, спочатку використайте «Дочекатися елемента».
  • Код помилки перевірки: RPA_NODE_INPUT_INVALID

Посилання у вхідних даних

ПолеДозволені форми
selectorTypeliteral, template
frameliteral, template
elementliteral, template
selectorRadioliteral, template
selectorliteral, template
outputRangeliteral, template
serialTypeliteral, template
serialliteral, numericExpression
serialMinliteral, numericExpression
serialMaxliteral, numericExpression
typeliteral, template
keyliteral, template

Вихідні дані

Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"innerText"},{"op":"eq","field":"outputRange","value":"single"}]}

Поле вихідних данихТип або значення
textstring
matchedCountnumber

Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"innerText"},{"op":"eq","field":"outputRange","value":"all"}]}

Поле вихідних данихТип або значення
textarray<string>
matchedCountnumber

Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"innerHTML"},{"op":"eq","field":"outputRange","value":"single"}]}

Поле вихідних данихТип або значення
htmlstring
matchedCountnumber

Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"innerHTML"},{"op":"eq","field":"outputRange","value":"all"}]}

Поле вихідних данихТип або значення
htmlarray<string>
matchedCountnumber

Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"attribute"},{"op":"eq","field":"outputRange","value":"single"}]}

Поле вихідних данихТип або значення
attributestring / null
matchedCountnumber

Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"attribute"},{"op":"eq","field":"outputRange","value":"all"}]}

Поле вихідних данихТип або значення
attributearray<string / null>
matchedCountnumber

Посилайтеся на опубліковані поля у форматі ${nodeId.data.field}.

Приклад JSON

Цей приклад читає текст першого елемента, що відповідає .price, у data.text. Якщо елемент завантажується асинхронно, спочатку додайте вузол «Дочекатися елемента».

{
  "id": "read_price",
  "type": "browser_getElement",
  "data": {
    "title": "Read the product price",
    "browserAction": "getElement",
    "browserUi": {
      "inputs": {
        "selectorType": "selector",
        "selectorRadio": "CSS",
        "selector": ".price",
        "outputRange": "single",
        "serialType": "fixed",
        "serial": 1,
        "type": "innerText"
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}

Назад до каталогу вузлів