RunMacroTà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.
Chờ phần tử Desktop xuất hiện hoặc biến mất (Smart Desktop Wait) trong RunMacro
Smart Desktop Wait là lệnh đồng bộ thời gian thông minh trong RunMacro, tạm dừng cho đến khi phần tử UI xuất hiện, biến mất hoặc sẵn sàng bấm qua Windows UI Automation thay vì dùng Delay cố định.
Điều kiện cần#
- Phần tử cần theo dõi có thể nhận diện được qua công cụ Chỉ điểm phần tử.
Chế độ hỗ trợ#
- Chế độ Desktop — Thăm dò trạng thái phần tử qua UIA polling ngầm không chiếm CPU.
Chức năng này làm gì#
Lệnh Smart Desktop Wait tạm dừng quy trình thực thi một cách thông minh cho đến khi một đối tượng giao diện người dùng đạt được trạng thái mong muốn thông qua Microsoft UI Automation. Các chế độ chờ bao gồm: Xuất hiện (Appear), Biến mất (Vanish) (ví dụ: vòng xoay loading hoặc thanh tiến trình lưu file biến mất), Sẵn sàng bấm (Đã bật), hoặc Bị vô hiệu hóa (Đã tắt). Cơ chế thăm dò chu kỳ 150ms cực nhẹ CPU, giúp kịch bản luôn chạy với tốc độ tối đa ngay khi giao diện sẵn sàng mà không cần dùng các lệnh Delay cố định gây lãng phí thời gian.
Hình ảnh & video#
Khi nào nên dùng#
- Chờ phần mềm ERP hoặc kế toán tải xong dữ liệu bảng trước khi click nút xuất file.
- Chờ cửa sổ popup in ấn hoặc hộp thoại lưu tệp hiển thị hoàn chỉnh trên màn hình.
- Chờ thanh tiến trình lưu file (Progress Bar) hoặc biểu tượng đang tải (Loading) biến mất hoàn toàn.
- Chờ nút 'Xác nhận thanh toán' chuyển từ màu xám (Đã tắt) sang màu xanh (Đã bật) sau khi điền đủ thông tin.
Khi nào không nên dùng#
- Chờ phần tử trên trang web trình duyệt (dùng Smart HTML Wait).
- Chờ một khoảng thời gian cố định nghỉ giải lao (dùng Delay).
Các bước cấu hình#
- Trong RunMacro, chọn nhóm Luồng › Smart Desktop Wait.
- Bấm 🎯 Chỉ điểm phần tử (Pick Element) và chọn phần tử cần theo dõi trên màn hình.
- Chọn Chế độ chờ (Wait Mode): Xuất hiện (appear), Biến mất (vanish), Sẵn sàng bấm (enabled), hoặc Vô hiệu hóa (disabled).
- Nhập Thời gian chờ tối đa (Timeout sec) (mặc định 30 giây).
- Chọn hành vi tại Khi quá thời gian (On Timeout): Dừng kịch bản (stop), Nhảy tới nhãn (goto), hoặc Tiếp tục (continue).
- Nếu chọn nhảy nhãn, nhập tên nhãn tại ô Nhãn khi Timeout (ví dụ:
lbl_xu_ly_that_bai). - Bấm Lưu.
Giải thích từng tùy chọn#
Kết quả mong đợi#
Macro tiếp tục thực thi ngay lập tức tại thời điểm phần tử đạt đúng trạng thái mong muốn.
Ví dụ thực tế#
Ví dụ: Chờ biểu tượng đang lưu file biến mất rồi mới đóng phần mềm#
- Thêm lệnh Smart Desktop Wait sau bước bấm 'Lưu file'.
- Chỉ điểm vào thanh trạng thái 'Đang lưu dữ liệu...'.
- Chọn Chế độ chờ: Biến mất (vanish) với thời gian chờ 60 giây.
- Khi thanh lưu biến mất, quy trình tiếp tục ngay lập tức để thực hiện bước đóng phần mềm an toàn.
Giới hạn và trường hợp lỗi#
- Nếu cửa sổ bị thu nhỏ xuống Taskbar (Minimized), một số thuộc tính UIA có thể không cập nhật cho đến khi cửa sổ được khôi phục.
Mẹo & lỗi thường gặp#
Thông tin kiểm chứng#
commands/smart_desktop_wait.py· xác minh 2026-09-30
