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 Dừng Macro (Stop)
🛑 Luồng

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#

Giao diện cấu hình các trường thông số của lệnh Dừng Macro (Stop) trong RunMacro
Khung cấu hình các trường thông số của lệnh Dừng Macro (Stop) trong RunMacro.

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#

  1. Trong RunMacro, mở nhóm Luồng › Dừng Macro (Stop).
  2. 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.
  3. 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.
  4. Bấm Lưu.

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

Cấu hình lệnh (Command Configuration)#

Lệnh thực thi dứt khoát với độ trễ tối thiểu (delay = 0ms), phát tín hiệu dừng thực thi cho toàn bộ hệ thống RunMacro.

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#

  1. Dùng lệnh Kiểm tra file tồn tại (If File Exists) kiểm tra file Data.xlsx.
  2. 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!'.
  3. 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#

Kết hợp lệnh Stop với Ghi log (Log Message) hoặc Thông báo Telegram để luôn nắm rõ lý do kịch bản dừng lại.
Lệnh Stop sẽ kết thúc toàn bộ luồng chạy của file macro hiện tại và không tiếp tục thực thi các bước nằm phía dưới nó.

Thông tin kiểm chứng#

  • commands/control_flow.py · xác minh 2026-09-30
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.