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

Знімок екрана зроблено в англійському інтерфейсі MoreLogin Desktop V2.73.101.
Ці поля розміщуються в data.browserUi.inputs.
| Поле | Тип або значення | Обов'язкове за схемою | Значення за замовчуванням під час виконання | Опис і обмеження |
|---|---|---|---|---|
selectorType | "selector" / "element" / "frame" (підтримує посилання на змінні) | Ні | "selector" | Джерело елемента. Початкове значення в редакторі: "selector" |
frame | string | Ні | — | Змінна iframe |
element | string | Ні | — | Змінна елемента |
selectorRadio | "CSS" / "XPath" (підтримує посилання на змінні) | Ні | "CSS" | Тип селектора. Початкове значення в редакторі: "CSS". Наприклад, "${locatorType}"; значення, на яке посилаються, має бути "CSS" або "XPath". |
selector | string | Ні | — | Селектор |
outputRange | "single" / "all" (підтримує посилання на змінні) | Ні | "single" | Якщо збігається кілька об'єктів елементів. Початкове значення в редакторі: "single" |
serialType | "fixed" / "randomInterval" (підтримує посилання на змінні) | Ні | "fixed" | Якщо збігається кілька об'єктів елементів. Початкове значення в редакторі: "fixed" |
serial | WorkflowNumber | Ні | 1 | Індекс елемента; ціле число; мінімум після розв'язання: 1. Початкове значення в редакторі: 1 |
serialMin | WorkflowNumber | Ні | — | Мінімальний індекс; ціле число; мінімум після розв'язання: 1 |
serialMax | WorkflowNumber | Ні | — | Максимальний індекс; ціле число; мінімум після розв'язання: 1 |
type | "innerText" / "innerHTML" / "attribute" (підтримує посилання на змінні) | Ні | "innerText" | Тип вихідних даних. Початкове значення в редакторі: "innerText" |
key | string | Ні | — | Назва атрибута / селектор дочірнього елемента |
- Правила пошуку елемента: 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
| Поле | Дозволені форми |
|---|---|
selectorType | literal, template |
frame | literal, template |
element | literal, template |
selectorRadio | literal, template |
selector | literal, template |
outputRange | literal, template |
serialType | literal, template |
serial | literal, numericExpression |
serialMin | literal, numericExpression |
serialMax | literal, numericExpression |
type | literal, template |
key | literal, template |
Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"innerText"},{"op":"eq","field":"outputRange","value":"single"}]}
| Поле вихідних даних | Тип або значення |
|---|---|
text | string |
matchedCount | number |
Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"innerText"},{"op":"eq","field":"outputRange","value":"all"}]}
| Поле вихідних даних | Тип або значення |
|---|---|
text | array<string> |
matchedCount | number |
Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"innerHTML"},{"op":"eq","field":"outputRange","value":"single"}]}
| Поле вихідних даних | Тип або значення |
|---|---|
html | string |
matchedCount | number |
Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"innerHTML"},{"op":"eq","field":"outputRange","value":"all"}]}
| Поле вихідних даних | Тип або значення |
|---|---|
html | array<string> |
matchedCount | number |
Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"attribute"},{"op":"eq","field":"outputRange","value":"single"}]}
| Поле вихідних даних | Тип або значення |
|---|---|
attribute | string / null |
matchedCount | number |
Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"attribute"},{"op":"eq","field":"outputRange","value":"all"}]}
| Поле вихідних даних | Тип або значення |
|---|---|
attribute | array<string / null> |
matchedCount | number |
Посилайтеся на опубліковані поля у форматі ${nodeId.data.field}.
Цей приклад читає текст першого елемента, що відповідає .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"
}
}
}
}