📗 Ghi Excel (write_excel)

Nhóm palette: Logic · type: write_excel · cổng: 1 vào · 1 ra · chỉ .xlsx / .xlsm (openpyxl)

Mục đích

Ghi Excel. Bắt buộc đóng file trong Excel trước khi ghi (PermissionError). Không hỗ trợ .xls cũ.

Từng setting

Ô trên Properties	Key	Mặc định	Ý nghĩa / cách dùng
Delay sau (ms)	`delay_after_ms`	10	Chờ thêm sau khi node chạy xong rồi mới sang node kế. Dùng để UI kịp hiện, ảnh kịp load. Không có ở node `note`, `end`, `delay_random`, `start`.
Đường dẫn	`file_path`	C:\output.xlsx	Không đuôi → thêm .xlsx. Tự tạo file/sheet.
Chế độ ghi	`mode`	append_row	UI: append_row / write_cell (data cũ cell được map write_cell).
Sheet	`sheet`	Sheet1	Tên hoặc số thứ tự 1-based. Ghi: không có thì tạo sheet mới.
(append) Nội dung hàng	`content (append)`	—	Cột cách nhau `\|` hoặc tab. vd `user\|pass\|ok`
(write_cell) Cột	`column`	A	`A`/`B` hoặc số `1`=A.
(write_cell) Hàng	`row`	1	Số (1,2,…) hoặc text / `{bien}` — tìm hàng có cột A khớp (ưu tiên đúng chuỗi, rồi không phân biệt hoa thường). Ví dụ hàng `{app_title}`.
(write_cell) Giá trị	`content (write_cell)`	—	Template.

Ví dụ thực tế

A. Log farm — append_row: {app_title}|{ocr_text}|{http_status}
B. Ghi vàng vào đúng acc — Cột A = tên cửa sổ (trùng {app_title}). write_cell cột B, hàng {app_title}, giá trị {ocr_text}.
C. Ô cố định — column C, row 2 = ô C2.

Lưu ý

Đóng Excel · không .xlsKhông hỗ trợ .xls cũ. write_cell không hiện ô cell A1 trên UI — dùng column+row. Engine vẫn đọc cell nếu có trong data cũ. Append: hàng mới = sau hàng “có dữ liệu” cuối + 1. Ô trống cuối hàng bị trim khi đọc ngược.

Công thức Excel: ghi giá trị thô, không evaluate. Đọc mặc định data_only=False — thấy công thức chứ không kết quả đã tính (trừ khi Excel đã tính và lưu).

📗 Ghi Excel (write_excel)

Nhóm palette: Logic · type: write_excel · cổng: 1 vào · 1 ra · chỉ .xlsx / .xlsm (openpyxl)

Mục đích

Ghi Excel. Bắt buộc đóng file trong Excel trước khi ghi (PermissionError). Không hỗ trợ .xls cũ.

Từng setting

Ô trên Properties	Key	Mặc định	Ý nghĩa / cách dùng
Delay sau (ms)	`delay_after_ms`	10	Chờ thêm sau khi node chạy xong rồi mới sang node kế. Dùng để UI kịp hiện, ảnh kịp load. Không có ở node `note`, `end`, `delay_random`, `start`.
Đường dẫn	`file_path`	C:\output.xlsx	Không đuôi → thêm .xlsx. Tự tạo file/sheet.
Chế độ ghi	`mode`	append_row	UI: append_row / write_cell (data cũ cell được map write_cell).
Sheet	`sheet`	Sheet1	Tên hoặc số thứ tự 1-based. Ghi: không có thì tạo sheet mới.
(append) Nội dung hàng	`content (append)`	—	Cột cách nhau `\|` hoặc tab. vd `user\|pass\|ok`
(write_cell) Cột	`column`	A	`A`/`B` hoặc số `1`=A.
(write_cell) Hàng	`row`	1	Số (1,2,…) hoặc text / `{bien}` — tìm hàng có cột A khớp (ưu tiên đúng chuỗi, rồi không phân biệt hoa thường). Ví dụ hàng `{app_title}`.
(write_cell) Giá trị	`content (write_cell)`	—	Template.

Ví dụ thực tế

A. Log farm — append_row: {app_title}|{ocr_text}|{http_status}
B. Ghi vàng vào đúng acc — Cột A = tên cửa sổ (trùng {app_title}). write_cell cột B, hàng {app_title}, giá trị {ocr_text}.
C. Ô cố định — column C, row 2 = ô C2.

Lưu ý

Công thức Excel: ghi giá trị thô, không evaluate. Đọc mặc định data_only=False — thấy công thức chứ không kết quả đã tính (trừ khi Excel đã tính và lưu).