Xuất báo cáo dữ liệu#

Mục tiêu: Tạo file xuất (CSV/XLSX) từ Dashboard để phục vụ họp, phân tích offline hoặc chia sẻ với team.

Mục tiêu#

Mở dialog Xuất dữ liệu Dashboard và chọn format/entity.
Tạo job export async và theo dõi tiến trình.
Tải file hoàn thành từ trang Exports.

Điều kiện tiên quyết#

Đã đăng nhập Dashboard.
Đã áp dụng filter (khuyến nghị): file xuất sẽ áp cùng filter bạn đang xem.

Các bước thực hiện#

1. Mở dialog Xuất#

Ở header trên cùng, bấm nút Xuất dữ liệu (icon Download).
Dialog Xuất dữ liệu Dashboard mở ra với mô tả:

"Chọn định dạng file và các loại dữ liệu cần xuất"

2. Chọn định dạng file#

Trong mục Định dạng xuất:

XLSX (mặc định) — Excel, mở trực tiếp trong Excel/Google Sheets với format đẹp.
CSV — text thuần, phù hợp import vào tool khác (SQL, Python pandas, etc.).

Chọn theo nhu cầu.

3. Chọn dữ liệu cần xuất#

Trong mục Dữ liệu cần xuất, tick 1 hoặc nhiều entity:

Entity	Nội dung
Thử thách	Danh sách thử thách với các chỉ số tổng
Bài đăng	Từng bài dự thi, status, views, engagement
Influencer	Danh sách Influencer với phí quảng cáo
Thanh toán	Giao dịch thanh toán (yêu cầu role phù hợp)

⚠️ Bắt buộc tick ít nhất 1. Nếu không, dialog báo: "Vui lòng chọn ít nhất một loại dữ liệu".

4. Xem lại bộ lọc đang áp dụng#

Dialog hiển thị các filter hiện tại:

Các thử thách đã chọn
Các Influencer đã chọn
Khoảng thời gian (DD/MM/YYYY)

Nếu chưa chọn filter nào, bạn thấy: "Chưa chọn bộ lọc" → nghĩa là file sẽ xuất toàn bộ dữ liệu theo entity (có thể rất lớn).

5. Submit#

Bấm Xác nhận.
Dialog đóng.
Thông báo hiện:
- "Dữ liệu đang được tạo"
- "Bạn có thể tải về tại trang Quản lý dữ liệu"
Có nút Tải file đã tạo — click để chuyển sang trang Exports.

6. Theo dõi trạng thái#

Vào menu Exports ở sidebar. Bảng lịch sử các job:

Cột	Ý nghĩa
Tên file	File name + format
Loại	Entity đã chọn
Trạng thái	Đang chờ / Đang xử lý / Hoàn thành / Thất bại
Tạo bởi	User
Tạo lúc	Ngày/giờ
Hành động	Nút Tải về (khi Hoàn thành)

7. Tải file#

Khi trạng thái chuyển thành Hoàn thành, bấm Tải về → file được tải xuống máy.

Chi tiết từng bước#

Async job — tại sao không tải ngay?#

Export lớn (vài nghìn records) tốn thời gian query + build file. Thay vì bắt user chờ, hệ thống:

Tạo job async → trả response ngay.
Worker backend chạy ở background.
Khi xong, file sẵn sàng tải.

Thời gian ước lượng:

< 1000 records: vài giây
1000–10 000: 10–60 giây
10 000: có thể vài phút

Áp dụng filter cho export#

File xuất áp dụng cùng bộ lọc bạn đang áp dụng ở Dashboard. Nếu muốn xuất khác, đổi filter trước, áp dụng, rồi mở dialog export.

Giới hạn số job#

Mỗi user có thể có vài job đang chạy cùng lúc. Nếu quá nhiều, báo lỗi "Quota exceeded" — chờ job cũ xong.

File được lưu bao lâu?#

File lưu trên server trong thời gian giới hạn (thường 7–30 ngày). Sau đó bị xóa tự động. Download về máy nếu cần lưu lâu.

Lỗi thường gặp#

1. Dialog báo "Vui lòng chọn ít nhất một loại dữ liệu"#

→ Chưa tick entity nào. Tick ít nhất 1 rồi submit.

2. Job ở trạng thái "Thất bại"#

Nguyên nhân có thể:

Dữ liệu quá lớn → relax filter, chia nhỏ period.
Lỗi backend → thử lại sau vài phút. Nếu liên tục fail, report Admin.
Quyền → entity "Thanh toán" cần role nhất định.

3. File tải về trống/không đúng dữ liệu#

Filter đã áp dụng khi tạo job. Không giống filter hiện tại trên Dashboard.
Mỗi export là snapshot tại thời điểm tạo, không tự update.

4. Không thấy nút "Tải về"#

→ Job chưa ở trạng thái Hoàn thành. Chờ thêm hoặc refresh trang.

5. Download file nhưng mở không được#

File XLSX → mở bằng Excel/Google Sheets/Numbers.
File CSV → mở bằng Excel (chọn UTF-8 để không lỗi font tiếng Việt).
Nếu file hỏng → tạo lại job.

Câu hỏi thường gặp (FAQ)#

File xuất có chứa tất cả cột trên Dashboard không?

File xuất thường đầy đủ hơn Dashboard UI (nhiều cột phụ). Cấu trúc cột được định sẵn cho từng entity.

Xuất dữ liệu có tính phí không?

Không tính phí tiền. Nhưng mỗi job chiếm tài nguyên server, nên hệ thống giới hạn số job/user.

File có mã hóa không?

File không mã hóa. Không share file chứa dữ liệu nhạy cảm (thanh toán, demographics cá nhân) cho người ngoài tổ chức.

Tôi có thể schedule export định kỳ không?

Hiện tại chưa. Phải tạo job thủ công mỗi lần.

Dữ liệu "Thanh toán" export được gì?

Danh sách giao dịch liên quan đến Influencer trong filter. Không phải dữ liệu kế toán nội bộ TCB.

File có hỗ trợ tiếng Việt có dấu không?

Có. Cả XLSX và CSV dùng UTF-8. Nếu CSV mở lỗi font, mở Excel → Data → From Text → chọn UTF-8.

Liên kết liên quan#

Tham khảo SRS: brand-portal/10-exports