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.

Tài liệu Luồng Thoát vòng lặp (Break)
⏹️ Luồng

Lệnh thoát vòng lặp ngay lập tức (Break) trong RunMacro

Lệnh Break thoát ngay lập tức khỏi vòng lặp đang chạy (While, For Each, Loop) và chuyển quyền thực thi xuống sau End Loop.

Điều kiện cần#

  • Lệnh Break phải nằm bên trong một khối vòng lặp hợp lệ (Loop, While hoặc For Each).
  • Thường được bao bọc bởi một khối điều kiện IF để quyết định thời điểm ngắt.

Chế độ hỗ trợ#

  • Chế độ Desktop
  • Chế độ Browser
  • RunMacro Runner

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

Lệnh Thoát vòng lặp (Break) lập tức kết thúc vòng lặp gần nhất đang chứa nó (áp dụng cho Loop N lần, While, hoặc For Each). Khi gặp lệnh Break, toàn bộ các bước còn lại trong vòng lặp bị bỏ qua và quyền điều khiển kịch bản được chuyển ngay tới dòng lệnh đầu tiên nằm phía sau lệnh End Loop (hoặc End If của vòng lặp cũ). Lệnh này là giải pháp chuẩn mực để ngắt vòng lặp sớm mà không cần nhảy nhãn Goto phức tạp.

Hình ảnh & video#

Giao diện cấu hình các trường thông số của lệnh Thoát vòng lặp (Break) trong RunMacro
Khung cấu hình các trường thông số của lệnh Thoát vòng lặp (Break) trong RunMacro.

Khi nào nên dùng#

  • Tìm kiếm trong danh sách: khi đã tìm thấy mục tiêu (ảnh, dòng chữ, dữ liệu) thì thoát vòng lặp để tiếp tục bước sau.
  • Gặp lỗi nghiêm trọng trong một lượt lặp và cần ngừng toàn bộ tiến trình lặp để bảo vệ an toàn dữ liệu.
  • Khi điều kiện dừng khẩn cấp được thỏa mãn trong thân vòng lặp While hoặc For Each.

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

  • Chỉ muốn bỏ qua lượt lặp hiện tại để sang lượt tiếp theo (hãy dùng lệnh Continue).
  • Thoát khỏi macro con quay về macro cha (hãy dùng lệnh Goto File A).

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

  1. Xác định vị trí kiểm tra điều kiện thoát bên trong thân vòng lặp.
  2. Đặt lệnh điều kiện (ví dụ: IF hoặc lệnh Tìm kiếm Hình ảnh).
  3. Bên trong nhánh đúng của điều kiện, thêm lệnh Điều khiển luồng › Thoát vòng lặp (Break).
  4. Lưu kịch bản. Khi điều kiện thỏa mãn, lệnh Break sẽ đưa luồng chạy ra ngoài vòng lặp.

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

Tự động định vị vòng lặp gần nhất#

Lệnh tự động phát hiện và thoát khỏi vòng lặp trực tiếp bao quanh nó mà không cần cấu hình tham số.

Kết quả mong đợi#

Vòng lặp dừng ngay lập tức tại vị trí gọi Break và kịch bản chạy tiếp các lệnh phía sau khối vòng lặp.

Ví dụ thực tế#

Ví dụ: Dò tìm file trong danh sách và dừng khi tìm thấy#

  1. Vòng lặp For Each duyệt từng dòng file.
  2. Lệnh IF kiểm tra: nếu {item} == "TARGET_ID".
  3. Bên trong IF: thêm lệnh Thoát vòng lặp (Break).
  4. Sau End Loop: thông báo đã tìm thấy mục tiêu thành công.

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

  • Lệnh Break chỉ có tác dụng trong phạm vi luồng thực thi cục bộ; không thể ngắt các tiến trình nền độc lập.
  • Nếu cấu trúc khối lặp bị lỗi cú pháp thiếu End Loop, runner sẽ không xác định được đích nhảy an toàn.

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

Khi có các vòng lặp lồng nhau, Break chỉ thoát khỏi vòng lặp trong cùng; vòng lặp bên ngoài vẫn tiếp tục chạy bình thường.
Chỉ đặt lệnh Break bên trong một khối vòng lặp (While, For Each, hoặc Loop); đặt bên ngoài vòng lặp sẽ bị báo lỗi ngữ cảnh.

Thông tin kiểm chứng#

  • commands/control_flow.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.