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.

Ctrl K

🔤 Tệp

Đổi tên file hàng loạt trong RunMacro

Đổi tên hàng loạt đổi tên nhiều file theo tìm-thay, tiền tố/hậu tố, đánh số hoặc bảng ánh xạ CSV/Excel, với chế độ xem trước an toàn.

Điều kiện cần

Thư mục tồn tại; kiểu ánh xạ cần file CSV/Excel hợp lệ.

Chế độ hỗ trợ

Chế độ Desktop — Thao 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 Đổi tên hàng loạt đổi tên nhiều file trong một thư mục theo bốn cách: Tìm-thay, Thêm tiền tố/hậu tố, Đánh số thứ tự, hoặc theo bảng ánh xạ (CSV/Excel). Mặc định ở chế độ xem trước (dry run) để bạn kiểm tra trước khi đổi thật.

Khi nào nên dùng

Chuẩn hóa hàng loạt tên ảnh/tài liệu.
Đánh số thứ tự file theo mẫu.
Đổi tên theo danh sách cũ→mới trong Excel/CSV.

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

Chỉ đổi tên một file — dùng Đổi tên file/thư mục.

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

Thêm lệnh Tệp › Đổi tên hàng loạt.
Nhập thư mục và mẫu chọn file (ví dụ *.jpg).
Chọn kiểu đổi tên: tìm-thay, tiền tố/hậu tố, đánh số, hoặc ánh xạ.
Điền tham số tương ứng (từ cần tìm/thay, tiền tố, mẫu số thứ tự, hoặc file ánh xạ + cột nguồn/đích).
Chạy ở chế độ xem trước để kiểm tra, xem biến preview; khi ổn thì tắt xem trước và chạy thật. Lưu.

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

Thư mục + Mẫu

Thư mục chứa file và mẫu glob chọn file cần đổi tên. Có thể quét đệ quy.

Kiểu đổi tên

find_replace, prefix_suffix, sequence, hoặc mapping.

Tìm / Thay

Chuỗi cần tìm và chuỗi thay thế trong phần tên (khi kiểu = tìm-thay).

Tiền tố / Hậu tố

Chuỗi thêm vào đầu/cuối phần tên (khi kiểu = tiền tố/hậu tố).

Mẫu số thứ tự + Số bắt đầu

Ví dụ Photo_{counter:03} tạo Photo_001, Photo_002... (khi kiểu = đánh số).

File ánh xạ + Cột nguồn/đích + Sheet

File CSV/Excel chứa cặp tên cũ→mới; chỉ định tên cột và sheet (khi kiểu = ánh xạ).

Xem trước (dry run)

Nếu bật, chỉ lập kế hoạch và ghi vào biến preview mà không đổi tên thật.

Cách xử lý khi trùng

error (dừng nếu có lỗi/trùng) hoặc skip (bỏ qua mục lỗi).

Biến preview / Biến số lượng

Biến chứa kế hoạch JSON (mặc định batch_rename_preview) và số file sẵn sàng đổi (batch_rename_count).

Kết quả mong đợi

Ở xem trước: biến preview chứa kế hoạch. Khi chạy thật: các file được đổi tên theo kế hoạch.

Ví dụ thực tế

Ví dụ: đánh số lại toàn bộ ảnh

Đổi tên hàng loạt: thư mục ảnh, mẫu *.jpg, kiểu = đánh số, mẫu IMG_{counter:04}, bắt đầu 1.
Chạy xem trước, kiểm tra {batch_rename_preview}; ổn thì tắt xem trước và chạy thật.

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

Tên đích không hợp lệ trên Windows sẽ bị đánh dấu lỗi.
Nhiều file cùng tên đích gây xung đột.

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

Luôn chạy xem trước trước khi đổi thật. Nếu có hai file trùng tên đích, lệnh báo xung đột (collision).

Kiểu ánh xạ đọc file .csv, .xlsx hoặc .xlsm; cần đúng tên cột nguồn và đích.

Thông tin kiểm chứng

commands/filesystem.py