Skip to content

Đọc dữ liệu phần tử

Loại nút browser_getElement

Chức năng

Đọ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.

Cấu hình trong ứng dụng máy tính

Cấu hình nút "Đọc dữ liệu phần tử" trong ứng dụng máy tính

Ảnh chụp từ giao diện tiếng Anh của MoreLogin Desktop V2.73.101.

Đầu vào

Các trường này nằm trong data.browserUi.inputs.

TrườngKiểu hoặc giá trịBắt buộc theo schemaGiá trị mặc định khi thực thiMô 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"
framestringKhông—Biến iframe
elementstringKhô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".
selectorstringKhô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"
serialWorkflowNumberKhông1Chỉ 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
serialMinWorkflowNumberKhông—Chỉ mục tối thiểu; số nguyên; tối thiểu sau khi phân giải: 1
serialMaxWorkflowNumberKhô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"
keystringKhông—Tên thuộc tính / bộ chọn phần tử con

Yêu cầu theo chế độ và giới hạn

  • 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

Tham chiếu đầu vào

TrườngDạng được phép
selectorTypeliteral, template
frameliteral, template
elementliteral, template
selectorRadioliteral, template
selectorliteral, template
outputRangeliteral, template
serialTypeliteral, template
serialliteral, numericExpression
serialMinliteral, numericExpression
serialMaxliteral, numericExpression
typeliteral, template
keyliteral, template

Đầu ra

Chế độ {"op":"and","rules":[{"op":"eq","field":"type","value":"innerText"},{"op":"eq","field":"outputRange","value":"single"}]}

Trường đầu raKiểu hoặc giá trị
textstring
matchedCountnumber

Chế độ {"op":"and","rules":[{"op":"eq","field":"type","value":"innerText"},{"op":"eq","field":"outputRange","value":"all"}]}

Trường đầu raKiểu hoặc giá trị
textarray<string>
matchedCountnumber

Chế độ {"op":"and","rules":[{"op":"eq","field":"type","value":"innerHTML"},{"op":"eq","field":"outputRange","value":"single"}]}

Trường đầu raKiểu hoặc giá trị
htmlstring
matchedCountnumber

Chế độ {"op":"and","rules":[{"op":"eq","field":"type","value":"innerHTML"},{"op":"eq","field":"outputRange","value":"all"}]}

Trường đầu raKiểu hoặc giá trị
htmlarray<string>
matchedCountnumber

Chế độ {"op":"and","rules":[{"op":"eq","field":"type","value":"attribute"},{"op":"eq","field":"outputRange","value":"single"}]}

Trường đầu raKiểu hoặc giá trị
attributestring / null
matchedCountnumber

Chế độ {"op":"and","rules":[{"op":"eq","field":"type","value":"attribute"},{"op":"eq","field":"outputRange","value":"all"}]}

Trường đầu raKiểu hoặc giá trị
attributearray<string / null>
matchedCountnumber

Tham chiếu các trường đã công bố dưới dạng ${nodeId.data.field}.

Ví dụ JSON

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"
      }
    }
  }
}

Quay lại danh mục nút