Loại nút browser_getElement
Đọc văn bản, HTML hoặc một thuộc tính theo tên từ một hoặc nhiều phần tử khớp.

Ảnh chụp từ giao diện tiếng Anh của MoreLogin Desktop V2.73.101.
Các trường này nằm trong data.browserUi.inputs.
| Trường | Kiểu hoặc giá trị | Bắt buộc theo schema | Giá trị mặc định khi thực thi | Mô tả và giới hạn |
|---|---|---|---|---|
selectorType | "selector" / "element" / "frame" (hỗ trợ tham chiếu biến) | Không | "selector" | Nguồn phần tử. Giá trị ban đầu trong trình chỉnh sửa: "selector" |
frame | string | Không | — | Biến iframe |
element | string | Không | — | Biến phần tử |
selectorRadio | "CSS" / "XPath" (hỗ trợ tham chiếu biến) | Không | "CSS" | Loại bộ chọn. Giá trị ban đầu trong trình chỉnh sửa: "CSS". Ví dụ, "${locatorType}"; giá trị được tham chiếu phải là "CSS" hoặc "XPath". |
selector | string | Không | — | Bộ chọn |
outputRange | "single" / "all" (hỗ trợ tham chiếu biến) | Không | "single" | Khi có nhiều đối tượng phần tử khớp. Giá trị ban đầu trong trình chỉnh sửa: "single" |
serialType | "fixed" / "randomInterval" (hỗ trợ tham chiếu biến) | Không | "fixed" | Khi có nhiều đối tượng phần tử khớp. Giá trị ban đầu trong trình chỉnh sửa: "fixed" |
serial | WorkflowNumber | Không | 1 | Chỉ mục phần tử; số nguyên; tối thiểu sau khi phân giải: 1. Giá trị ban đầu trong trình chỉnh sửa: 1 |
serialMin | WorkflowNumber | Không | — | Chỉ mục tối thiểu; số nguyên; tối thiểu sau khi phân giải: 1 |
serialMax | WorkflowNumber | Không | — | Chỉ mục tối đa; số nguyên; tối thiểu sau khi phân giải: 1 |
type | "innerText" / "innerHTML" / "attribute" (hỗ trợ tham chiếu biến) | Không | "innerText" | Kiểu đầu ra. Giá trị ban đầu trong trình chỉnh sửa: "innerText" |
key | string | Không | — | Tên thuộc tính / bộ chọn phần tử con |
- Quy tắc định vị: selectorType=selector yêu cầu selector; frame yêu cầu frame+selector; element yêu cầu một tham chiếu ElementRef từ nút trước đó. serial bắt đầu từ 1. randomInterval dùng serialMin/serialMax, và giá trị tối thiểu không được lớn hơn giá trị tối đa. Trước tiên, nút chờ selector khớp với các phần tử, sau đó chọn chỉ mục một lần: cận trên của khoảng bị giới hạn ở số phần tử khớp thực tế. Nếu chỉ mục cố định hoặc cận dưới của khoảng lớn hơn số phần tử khớp, ELEMENT_NOT_FOUND (reason=range, details.field là serial hoặc serialMin) được trả về ngay lập tức và trang không bị tác động. outputRange chỉ có thể là single/all. type chỉ có thể là innerText/innerHTML/attribute (giống trình chỉnh sửa; dùng getElementRef cho đối tượng phần tử và getFrame cho iframe), và type=attribute yêu cầu key (tên thuộc tính). Đọc các khóa và giá trị trả về dưới dạng một giá trị đơn hoặc một mảng tùy theo nhánh. Nút không chờ phần tử xuất hiện: nếu không tìm thấy gì, nút thành công ngay lập tức, giá trị đơn là chuỗi rỗng "" (all là []), và thuộc tính bị thiếu là "". Nếu cần chờ, hãy dùng "Chờ phần tử" trước.
- Mã lỗi xác thực:
RPA_NODE_INPUT_INVALID
| Trường | Dạng được phép |
|---|---|
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 |
Chế độ {"op":"and","rules":[{"op":"eq","field":"type","value":"innerText"},{"op":"eq","field":"outputRange","value":"single"}]}
| Trường đầu ra | Kiểu hoặc giá trị |
|---|---|
text | string |
matchedCount | number |
Chế độ {"op":"and","rules":[{"op":"eq","field":"type","value":"innerText"},{"op":"eq","field":"outputRange","value":"all"}]}
| Trường đầu ra | Kiểu hoặc giá trị |
|---|---|
text | array<string> |
matchedCount | number |
Chế độ {"op":"and","rules":[{"op":"eq","field":"type","value":"innerHTML"},{"op":"eq","field":"outputRange","value":"single"}]}
| Trường đầu ra | Kiểu hoặc giá trị |
|---|---|
html | string |
matchedCount | number |
Chế độ {"op":"and","rules":[{"op":"eq","field":"type","value":"innerHTML"},{"op":"eq","field":"outputRange","value":"all"}]}
| Trường đầu ra | Kiểu hoặc giá trị |
|---|---|
html | array<string> |
matchedCount | number |
Chế độ {"op":"and","rules":[{"op":"eq","field":"type","value":"attribute"},{"op":"eq","field":"outputRange","value":"single"}]}
| Trường đầu ra | Kiểu hoặc giá trị |
|---|---|
attribute | string / null |
matchedCount | number |
Chế độ {"op":"and","rules":[{"op":"eq","field":"type","value":"attribute"},{"op":"eq","field":"outputRange","value":"all"}]}
| Trường đầu ra | Kiểu hoặc giá trị |
|---|---|
attribute | array<string / null> |
matchedCount | number |
Tham chiếu các trường đã công bố dưới dạng ${nodeId.data.field}.
Ví dụ này đọc văn bản của phần tử đầu tiên khớp với .price vào data.text. Hãy thêm nút "Chờ phần tử" trước nếu phần tử được tải bất đồng bộ.
{
"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"
}
}
}
}