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 Tệp Data Source - Lấy dòng
📥 Tệp

Lấy một dòng dữ liệu từ CSV/Excel/Google Sheet (RunMacro)

Lệnh Data Source - Lấy dòng đọc một dòng từ nguồn dữ liệu (CSV, TXT, Excel, hoặc Google Sheet qua Apps Script) và gán các cột vào biến.

Điều kiện cần#

  • Đã thêm lệnh Data Source - Lấy dòng vào macro.
  • Chuẩn bị dữ liệu hoặc mục tiêu mà Data Source - Lấy dòng sẽ sử dụng.

Chế độ hỗ trợ#

  • RunMacro Runner

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

Lệnh Data Source - Lấy dòng đọc một dòng từ nguồn dữ liệu (CSV, TXT, Excel, hoặc Google Sheet qua Apps Script) và gán các cột vào biến. Có thể lấy dòng đầu, ngẫu nhiên, hoặc dòng chưa xử lý; và rẽ nhánh IF/ELSE theo có dữ liệu hay không.

Hình ảnh & video#

Giao diện cấu hình các trường thông số của lệnh Data Source - Lấy dòng trong RunMacro
Khung cấu hình các trường thông số của lệnh Data Source - Lấy dòng trong RunMacro.

Khi nào nên dùng#

  • Xử lý danh sách tài khoản/dữ liệu theo từng dòng.
  • Lấy dòng chưa xử lý (theo cột trạng thái) để chạy lần lượt.
  • Nạp dữ liệu từ Google Sheet vào biến.

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

  • Không dùng khi nhiều runner cần claim một dòng duy nhất theo cơ chế nguyên tử.

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

  1. Thêm lệnh Tệp › Data Source - Lấy dòng.
  2. Chọn nguồn (CSV/TXT/Excel/Google Sheet) và file/URL.
  3. Chọn chế độ lấy: dòng đầu / ngẫu nhiên / chưa xử lý.
  4. (Tùy chọn) đặt tiền tố biến, cột trạng thái, nhãn IF/ELSE. Lưu.

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

Nguồn + File/URL + Sheet#

Loại nguồn và vị trí dữ liệu; với Excel/Sheet có thể chỉ định tên sheet.

Chế độ lấy (đầu/ngẫu nhiên/chưa xử lý)#

Cách chọn dòng. "Chưa xử lý" dựa trên cột trạng thái và giá trị chưa dùng.

Có dòng tiêu đề (has header)#

Cho biết dòng đầu là tiêu đề cột (dùng làm tên biến) hay là dữ liệu.

Tiền tố biến + Biến dòng TXT#

Tiền tố thêm vào tên biến từ cột; với TXT, tên biến chứa cả dòng.

Cột trạng thái + Đánh dấu "đang xử lý"#

Cột theo dõi trạng thái; có thể tự đánh dấu dòng vừa lấy là "đang xử lý".

Nhãn IF/ELSE + Khi hết dữ liệu#

Có dữ liệu nhảy IF, không có nhảy ELSE; khi hết dữ liệu có thể tiếp tục hoặc dừng.

Kết quả mong đợi#

Sau khi chạy, Data Source - Lấy dòng hoàn tất thao tác đã mô tả và cung cấp kết quả cho bước tiếp theo.

Ví dụ thực tế#

Ví dụ: Lấy dòng CSV chưa xử lý#

  1. Data Source Lấy dòng, nguồn CSV, chế độ Chưa xử lý, cột trạng thái status.
  2. Các cột được gán vào biến (vd {email}).
  3. Sau khi xử lý, dùng "Đánh dấu dòng" để ghi done.

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

  • Hết dòng, filter không khớp hoặc source thay đổi có thể trả rỗng; đọc dòng không tự khóa nó cho runner khác.

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

Bộ ba Lấy dòng → xử lý → Đánh dấu dòng tạo vòng xử lý danh sách rất gọn.

Thông tin kiểm chứng#

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