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.
Dừng hoàn toàn quy trình thực thi (Stop Macro) trong RunMacro
Stop Command là lệnh dừng hoàn toàn và an toàn quy trình thực thi macro ngay lập tức trong RunMacro, giải phóng tài nguyên và ghi nhận kết thúc kịch bản.
Điều kiện cần#
- Được chèn vào vị trí cần dừng trong danh sách lệnh macro.
Chế độ hỗ trợ#
- Chế độ Desktop — Dừng toàn bộ luồng desktop và giải phóng các hook bàn phím chuột.
- Chế độ Browser — Dừng quy trình điều khiển trình duyệt CDP an toàn.
- RunMacro Runner — Cập nhật trạng thái Stopped trong RunMacro Runner.
Chức năng này làm gì#
Lệnh Dừng Macro (Stop Command) ngay lập tức ra tín hiệu kết thúc quy trình thực thi kịch bản (đặt cờ stop_requested = True trong ngữ cảnh thực thi). Runner sẽ dừng chạy toàn bộ các lệnh tiếp theo, hủy bỏ các tiến trình chờ, ngắt kết nối an toàn với các cổng điều khiển Win32/CDP và ghi nhận trạng thái kết thúc trong nhật ký thực thi (log). Lệnh được sử dụng để kết thúc workflow bình thường hoặc làm điểm thoát khẩn cấp khi gặp lỗi không thể khắc phục.
Hình ảnh & video#

Khi nào nên dùng#
- Đặt ở cuối kịch bản chính để báo hiệu hoàn thành toàn bộ công việc và đóng quy trình một cách dứt khoát.
- Đặt ở nhánh xử lý lỗi (Else block) khi phát hiện dữ liệu đầu vào không hợp lệ hoặc thiếu tệp quan trọng.
- Thoát khỏi vòng lặp vô hạn khi đã đạt được điều kiện dừng cụ thể.
- Dừng kịch bản ngay khi phát hiện tài khoản bị khóa hoặc có cảnh báo bảo mật nguy hiểm.
Khi nào không nên dùng#
- Tạm dừng một lát để người dùng xác nhận rồi chạy tiếp (hãy dùng lệnh Pause hoặc Wait Hotkey).
- Tạm dừng vài giây chờ tải (dùng Delay hoặc Smart Wait).
Các bước cấu hình#
- Trong RunMacro, mở nhóm Luồng › Dừng Macro (Stop).
- Nhấp chọn để chèn lệnh vào vị trí mong muốn trong danh sách các bước kịch bản.
- Lệnh Stop không yêu cầu cấu hình tham số phức tạp; khi kích hoạt sẽ dừng thực thi ngay lập tức.
- Bấm Lưu.
Giải thích từng tùy chọn#
Kết quả mong đợi#
Quy trình macro dừng lại tức thời và chuyển sang trạng thái sẵn sàng cho lượt chạy mới.
Ví dụ thực tế#
Ví dụ: Dừng macro ngay nếu không tìm thấy tệp đầu vào Excel#
- Dùng lệnh Kiểm tra file tồn tại (If File Exists) kiểm tra file
Data.xlsx. - Tại nhánh không tìm thấy tệp, hiển thị hộp thoại thông báo Hiện thông báo (Show Message) 'Thiếu file dữ liệu!'.
- Chèn ngay lệnh Dừng Macro (Stop) để kết thúc an toàn mà không chạy tiếp các bước lỗi phía sau.
Giới hạn và trường hợp lỗi#
- Lệnh dừng kịch bản hiện tại; nếu gọi qua file cha cần kiểm soát luồng kết quả trả về.
Mẹo & lỗi thường gặp#
Thông tin kiểm chứng#
commands/control_flow.py· xác minh 2026-09-30
RunMacro