Giao diện

Câu hỏi thường gặp ​

Dữ liệu bị thiếu sau khi install — không đủ 63 tỉnh? ​

Kiểm tra:

  • Quá trình install có bị lỗi giữa chừng không (kiểm tra log server).
  • Collection vietnamRegions đã được tạo và có dữ liệu: query vietnamRegions:list?filter[level]=1 phải trả về 63 records.
  • Nếu thiếu, thử xóa collection vietnamRegions rồi disable/enable lại plugin để trigger install lại.

Hiệu năng với 11,000+ records — picker có chậm không? ​

Plugin dùng lazy loading: chỉ tải 63 tỉnh ban đầu, rồi tải quận/huyện khi chọn tỉnh. Mỗi lần tải chỉ vài chục đến vài trăm records, không tải toàn bộ 11,000+. Hiệu năng chấp nhận được.

Cascading picker trống — không hiển thị tỉnh nào? ​

Kiểm tra:

  • Plugin đã install thành công (collection vietnamRegions có dữ liệu).
  • Role hiện tại có quyền vietnamRegions:list (kiểm tra ACL).
  • API vietnamRegions:list trả về dữ liệu khi gọi trực tiếp.

Dữ liệu hành chính cập nhật (sáp nhập huyện, đổi tên) — làm sao update? ​

Plugin cung cấp dữ liệu tại thời điểm cài đặt. Để cập nhật:

  • Chỉnh sửa trực tiếp records trong collection vietnamRegions qua admin UI.
  • Hoặc cập nhật package vietnam-division và reinstall plugin.

Field lưu mã code — làm sao hiển thị tên đầy đủ? ​

Interface tự động dùng hàm toString để chuyển ['79', '760', '26734'] thành "Phường Bến Nghé, Quận 1, TP. Hồ Chí Minh" khi hiển thị trên table/detail.

Có thể dùng field này cho địa chỉ nước khác không? ​

Không. Plugin chỉ chứa dữ liệu hành chính Việt Nam. Cho địa chỉ nước khác, cần plugin riêng hoặc tự xây dựng collection tương tự.

Xóa tỉnh/huyện trong collection có ảnh hưởng field đã lưu không? ​

Giá trị field lưu mã code (ví dụ: ['79', '760', '26734']) — nếu xóa record tương ứng trong vietnamRegions, field vẫn giữ code nhưng toString sẽ không tìm được tên để hiển thị.

Install mất bao lâu? ​

Bulk insert 11,000+ records thường mất 5-15 giây tùy database. Chỉ chạy một lần khi install lần đầu.