Mẹo & Quy ước cần biết

Những quy ước bắt buộc khi đặt tên sheet, cách đọc ký hiệu kỳ thời gian trong dữ liệu, và các mẹo giúp bạn dùng VDSC Add-in trôi chảy hơn.

Quy ước đặt tên sheet

Các Ribbon Check, Submit và Publish chỉ nhận diện sheet đặt tên đúng cấu trúc. Sheet sai cấu trúc sẽ bị bỏ qua hoàn toàn — không báo lỗi.

Quy tắc	Ví dụ đúng	Ví dụ sai
Bắt đầu bằng `#`, tên IN HOA	`#DCF` · `#CONSENSUS` · `#MARKET`	`DCF` · `#dcf` · `#Dcf`
Cùng tiền tố = cùng một sản phẩm	`#COMPANYREPORT_HPG` và `#COMPANYREPORT_FPT` thuộc nhóm `COMPANYREPORT`	—
Sheet dữ liệu nền bắt đầu bằng `_`	`_INFO` · `_TRADING_D` · `_IS_Q`	—

Đừng xoá hay đổi tên các sheet _ (thường được để ẩn cho model gọn) — model định giá tham chiếu tới chúng bằng công thức. Xoá đi là model vỡ.

Ký hiệu kỳ thời gian

Dữ liệu add-in trả về dùng mã kỳ thống nhất. Tiền tố F nghĩa là dự phóng (forecast).

Ký hiệu	Ý nghĩa
`Y2025`	Năm 2025 (số liệu thực tế)
`FY2026`	Năm 2026 dự phóng
`Q2026_02`	Quý 2 năm 2026
`D2026_06_24`	Ngày 24/06/2026

Đơn vị: mọi sheet báo cáo tài chính do add-in tạo dùng đơn vị tỷ đồng.

Định nghĩa ô trong model định giá

Model định giá dựng theo khung quy chuẩn (Model-Frame) để add-in đọc được từng ô — nhờ đó Check, Submit và Model Network mới hoạt động. Muốn vậy, mọi ô tham gia vào logic của model đều phải được định nghĩa.

“Lỏng lẻo thì dễ sai phạm, phức tạp thì khó tuân thủ.” — nên bộ quy tắc chỉ gồm hai điều:

Quy tắc 1. Mọi ô trong model đều phải được định nghĩa.
Quy tắc 2. Ô nào không được định nghĩa thì không được tham gia vào logic của model.

Một ô được định nghĩa khi có tối thiểu 2 chiều: tên biến — đánh dấu bằng @, và thời gian — Y/Q/M/D (add-in đọc theo cột/dòng gần ô nhất). Ví dụ ô doanh thu năm 2025 bằng 1000 được hiểu là revenue@Y2025 = 1000; một ô công thức tham chiếu tới ô chưa định nghĩa sẽ bị cắt liên kết — vẫn giữ giá trị nhưng phát cảnh báo (đây chính là việc Check → DCF giúp bạn rà soát trước khi Submit). Càng nhiều chiều (đơn vị, phân loại, mô tả, nguồn) thì dữ liệu càng chặt chẽ; với dữ liệu nhập tay, hệ thống yêu cầu bạn khai báo biến mới ngay tại bảng mô tả biến khi Submit.

Đây là ngôn ngữ chung giữa chuyên viên phân tích và hệ thống.

Cửa sổ tiến độ

Mọi sản phẩm nặng đều chạy trong một cửa sổ tiến độ riêng, không làm treo Excel.

Theo dõi nhật ký: cửa sổ in từng bước theo thời gian thực — biết add-in đang tải dữ liệu hay đang ghi sheet.
Thu nhỏ khi chờ: bấm nút thu nhỏ để làm việc khác; xong add-in tự bật lên báo kết quả.
Dừng giữa chừng: đóng cửa sổ tiến độ (hoặc bấm [Dừng]) để huỷ — chưa có gì được lưu.
Thông báo kết quả: kết thúc luôn có hộp thoại Thành công (✓) hoặc Lỗi (✕) mô tả rõ nguyên nhân.

Kết quả & nơi lưu

Nơi xuất kết quả: chọn "File Excel mới" để có file sạch; "File Excel đang mở" để chèn sheet vào workbook hiện hành. Riêng [Model] Định giá DCF luôn tạo file mới.
Nơi lưu mặc định: Documents/VDSC_Output/.
Tên file: <sản_phẩm>_<thời_điểm>_<TÊN_USER>.<đuôi>.
Dữ liệu luôn mới: mọi sản phẩm truy xuất dữ liệu trực tiếp từ hệ thống tại thời điểm chạy — không có bộ nhớ đệm cũ.

Mẹo khác

Dashboard web tự tắt: Model Network, Check → NETWORK và Check → CONSENSUS mở dashboard trên trình duyệt — đóng tab là server tự dừng.
Excel chạy ngầm được dọn tự động: sau mỗi lần chạy, add-in tự tắt các tiến trình Excel ẩn phát sinh trong phiên — không đụng tới file bạn đang mở.
Chạy Check trước khi Submit: soát hết ô chưa định nghĩa trong model rồi mới đẩy lên database.
Gửi thử trước khi gửi chính thức: dùng Publish → Test (nhóm Testing) để kiểm tra file trước khi Publish → Send.
Xem log lỗi: chi tiết lỗi được ghi tại Documents/VDSC_Output/vdsc_errors.log — gửi kèm file này khi liên hệ hỗ trợ.