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.

RunMacro robot
Tài liệu Tệp Liệt kê file/thư mục
📋 Tệp

Liệt kê file và thư mục trong RunMacro

Liệt kê file/thư mục quét một thư mục theo mẫu, lọc theo loại, có thể đệ quy, rồi lưu danh sách và số lượng vào biến.

Điều kiện cần

  • Thư mục tồn tại và đọc được.

Chế độ hỗ trợ

  • Chế độ DesktopThao tác trên hệ thống tệp cục bộ.
  • Chế độ Browser

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

Lệnh Liệt kê file và thư mục quét một thư mục và trả về danh sách các mục khớp mẫu (ví dụ *.png). Có thể lọc theo loại (file/thư mục), quét cả thư mục con, chọn định dạng kết quả và cách hiển thị đường dẫn. Kết quả và số lượng được lưu vào biến.

Khi nào nên dùng

  • Lấy danh sách file để lặp qua và xử lý từng cái.
  • Đếm số file khớp mẫu trong thư mục.
  • Duyệt cây thư mục để gom dữ liệu.

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

  • Chỉ cần kiểm tra một file có tồn tại — dùng IF File tồn tại.

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

  1. Thêm lệnh Tệp › Liệt kê file và thư mục.
  2. Nhập thư mụcmẫu (mặc định * = tất cả).
  3. Chọn loại (file/thư mục/tất cả) và có quét đệ quy không.
  4. Chọn định dạng kết quả (mỗi dòng một mục hoặc JSON) và cách hiển thị (đường dẫn đầy đủ / chỉ tên / đường dẫn tương đối).
  5. (Tùy chọn) Đổi tên biến danh sách và biến số lượng. Lưu.

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

Thư mục

Thư mục cần quét.

Mẫu (pattern)

Mẫu glob như *, *.txt. Mặc định là tất cả.

Loại

file, folder hoặc any.

Quét đệ quy

Nếu bật, quét cả thư mục con.

Định dạng kết quả

newline (mỗi mục một dòng) hoặc json (mảng JSON).

Cách hiển thị

full_path (đầy đủ), name (chỉ tên), relative_path (tương đối so với thư mục quét).

Biến danh sách / Biến số lượng

Biến nhận danh sách (mặc định directory_entries) và biến nhận số lượng (mặc định directory_entry_count).

Kết quả mong đợi

Biến danh sách chứa các mục khớp (đã sắp xếp); biến số lượng chứa tổng số.

Ví dụ thực tế

Ví dụ: lặp qua mọi ảnh PNG

  1. Liệt kê: thư mục ảnh, mẫu *.png, loại = file, cách hiển thị = đường dẫn đầy đủ.
  2. Dùng biến {directory_entries} với lệnh Loop để xử lý từng ảnh.

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

  • Danh sách rất lớn có thể tốn bộ nhớ khi lưu vào một biến.

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

Dùng định dạng "mỗi dòng một mục" để dễ lặp; dùng JSON khi cần chuyển sang lệnh khác đọc mảng.

Thông tin kiểm chứng

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