Tài liệu

Tài liệu RunMacro

Tạo robot đầu tiên, rồi tiến xa theo nhu cầu.

Hướng dẫn rõ ràng từng bước để tạo, chạy và cải thiện robot cho công việc máy tính lặp lại.

🧩 Smart HTML

Tự động thao tác phần tử web bằng selector (Smart HTML)

Lệnh Smart HTML thao tác trực tiếp lên phần tử web (nút, ô nhập, link...) bằng selector thông minh đã ghi lại, thay vì click theo tọa độ.

Điều kiện cần#

  • Đã thêm lệnh Smart HTML vào macro.
  • Chuẩn bị dữ liệu hoặc mục tiêu mà Smart HTML sẽ sử dụng.

Chế độ hỗ trợ#

  • Chế độ Browser

Chức năng này làm gì#

Lệnh Smart HTML thao tác trực tiếp lên phần tử web (nút, ô nhập, link...) bằng selector thông minh đã ghi lại, thay vì click theo tọa độ. Nó dò lại phần tử qua nhiều dấu hiệu (id, text, thuộc tính, cả Shadow DOM) nên ổn định kể cả khi giao diện đổi. Hỗ trợ rất nhiều hành động: click/gõ/hover, trích xuất text/thuộc tính/bảng, tích chọn, chọn dropdown, chờ và kiểm chứng.

Hình ảnh & video#

Giao diện cấu hình các trường thông số của lệnh Smart HTML trong RunMacro
Khung cấu hình các trường thông số của lệnh Smart HTML trong RunMacro.

Khi nào nên dùng#

  • Tự động hóa website chính xác theo phần tử (không lo lệch tọa độ).
  • Điền form, bấm nút, chọn dropdown trên web.
  • Trích xuất dữ liệu (text, link, bảng) từ trang.
  • Chạy nền qua Chrome/CDP mà không chiếm chuột thật.

Khi nào không nên dùng#

  • Không dùng cho ứng dụng Desktop, canvas không có DOM hữu dụng hoặc selector chưa được xác minh.

Các bước cấu hình#

  1. Dùng công cụ ghi/chọn phần tử (Extension) để lấy selector của phần tử cần thao tác.
  2. Thêm lệnh Smart HTML, chọn hành động (Click, Gõ, Trích xuất...).
  3. Chọn chế độ chạy: Auto/CDP (nền), Extension (trình duyệt đang mở), hoặc Real Mouse (chuột thật).
  4. (Với Gõ) nhập nội dung; (với Trích xuất) đặt biến kết quả. Lưu.

Giải thích từng tùy chọn#

Selector phần tử (selector profile)#

Bộ dấu hiệu nhận diện phần tử, lấy bằng công cụ chọn. RunMacro tự dò lại phần tử khi chạy.

Hành động (action)#

Click / Double/Right Click / Hover / Gõ; Trích xuất text, thuộc tính, HTML, bảng, tùy chọn; Tích/Bỏ tích; Chọn dropdown; Chờ và Kiểm chứng.

Chế độ chạy (execution mode)#

Auto/CDP chạy nền qua Chrome; Extension thao tác trên tab đang mở; Real Mouse dùng chuột thật (chỉ click/double click/right click/gõ/hover).

Nội dung (text) + Enter#

Với hành động Gõ: nội dung cần nhập; tùy chọn nhấn Enter để gửi. Hỗ trợ biến.

Thuộc tính (attribute) + Biến kết quả#

Với Trích xuất: thuộc tính cần lấy (vd href) và biến lưu kết quả.

Thời gian chờ (timeout ms)#

Thời gian tối đa chờ dò được/hiện phần tử trước khi bỏ.

Kết quả mong đợi#

Sau khi chạy, Smart HTML hoàn tất thao tác đã mô tả và cung cấp kết quả cho bước tiếp theo.

Ví dụ thực tế#

Ví dụ: Điền ô email trên web rồi bấm nút#

  1. Chọn selector ô email, thêm Smart HTML hành động Gõ, nhập email.
  2. Chọn selector nút "Tiếp tục", thêm Smart HTML hành động Click.
  3. Chế độ Auto/CDP để chạy nền.

Giới hạn và trường hợp lỗi#

  • Selector, iframe/shadow context và execution mode quyết định target; trang thay DOM có thể làm action trượt.

Mẹo & lỗi thường gặp#

Smart HTML chính xác hơn Click Chuột theo tọa độ khi làm việc với web — ưu tiên dùng cho Chrome.
Các hành động Chờ/Kiểm chứng/Trích xuất cần chế độ CDP hoặc Extension (Real Mouse chỉ click/double click/right click/gõ/hover).

Thông tin kiểm chứng#

  • commands/smart_html.py
Robot biểu tượng của RunMacro

Công việc của robot. Thời gian của bạn.

Tạo robot trong vài phút, không cần lập trình. Chạy ổn định, quản lý từ xa, chi phí rõ ràng — và bạn luôn giữ quyền kiểm soát.