Nhập, Xuất Dữ liệu và Khởi tạo Dữ liệu mẫu trong PolyCMS cho RISE CRM
PolyCMS cho RISE CRM tích hợp đầy đủ công cụ di chuyển nội dung và khởi tạo trang mẫu nhanh tại mục PolyCMS > Tools (/polycms/tools). Quản trị viên có thể xuất và nhập tệp dữ liệu JSON có cấu trúc giữa các hệ thống RISE CRM trong một giao dịch (transaction) an toàn, hoặc khởi tạo và làm mới dữ liệu minh họa thông qua bộ Demo Data Seeder 3 chế độ (Polycms_Demo_Seeder).
Tổng quan các tab trong PolyCMS Tools
Truy cập PolyCMS > Tools từ thanh menu bên trái của RISE CRM để làm việc với 3 tab chức năng (hỗ trợ liên kết trực tiếp bằng URL hash từ v1.3.1+):
- Import / Export (
/polycms/tools#import_export): Xuất dữ liệu JSON và nhập dữ liệu JSON theo giao dịch (transactional import) cho các bảng nội dung cốt lõi. - Backup / Restore (
/polycms/tools#backup_restore): Sao lưu SQL đầy đủ và khôi phục an toàn các bảng PolyCMS. Xem chi tiết tại Sao lưu và Phục hồi Cơ sở dữ liệu. - Demo Data (
/polycms/tools#demo_data): Bộ khởi tạo, cập nhật an toàn và xóa dữ liệu mẫu 3 chế độ doPolycms_Demo_Seedervận hành.
Toàn bộ các thao tác xuất, nhập, sao lưu, phục hồi và khởi tạo dữ liệu mẫu đều yêu cầu quyền Quản trị viên RISE CRM (polycms_is_admin()).
Xuất dữ liệu định dạng JSON (JSON Export)
Tính năng JSON Export giúp bạn chuyển nội dung biên tập giữa môi trường staging và production của RISE CRM hoặc tạo bản sao lưu gọn nhẹ, dễ đọc cho bài viết và trang tĩnh.
- Mở PolyCMS > Tools và chọn tab Import / Export (
#import_export). - Tại khu vực Export Content, nhấn nút Export to JSON.
- PolyCMS tự động biên dịch tệp JSON chuẩn UTF-8 (
JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE) và tải ngay về máy theo định dạng tênpolycms_export_YYYY-MM-DD_HH-ii.json.
Phạm vi dữ liệu trong tệp JSON xuất ra
Mỗi tệp .json bao gồm mã phiên bản lược đồ version, dấu thời gian timestamp và toàn bộ bản ghi từ 4 bảng nội dung chính ({db_prefix} mặc định là rise_):
- Chuyên mục (
{db_prefix}blog_categories): Danh sách chuyên mục, slug, mô tả và quan hệ phân cấp cha-con. - Thẻ tag (
{db_prefix}blog_tags): Toàn bộ thẻ tag và slug. - Bài viết (
{db_prefix}blog_posts): Toàn bộ bài viết blog kèm nội dung, trích dẫn, slug, trạng thái xuất bản và dấu thời gian. - Trang tĩnh (
{db_prefix}blog_pages): Toàn bộ trang tĩnh kèm nội dung HTML, template hiển thị, thứ bậc trang và trạng thái.
Lưu ý rằng tệp JSON gọn nhẹ không bao gồm tùy chọn theme, tùy chọn plugin, widget, menu điều hướng hay tệp hình ảnh vật lý. Để chuyển trọn vẹn toàn bộ 19 bảng cấu hình và nội dung, hãy dùng Sao lưu và Phục hồi Cơ sở dữ liệu kết hợp sao chép thư mục files/polycms/.
Nhập dữ liệu JSON theo giao dịch (Transactional JSON Import)
Bạn có thể nhập bất kỳ tệp polycms_export_*.json nào đã xuất trước đó sang một hệ thống RISE CRM khác đang cài PolyCMS:
- Mở PolyCMS > Tools và chọn tab Import / Export.
- Tại khu vực Import Content, chọn tệp
.jsonhợp lệ đã xuất từ PolyCMS. - Nhấn Import from JSON.
- Hệ thống kiểm tra cú pháp JSON và trường
version, sau đó ghi dữ liệu chuyên mục, thẻ tag, bài viết và trang tĩnh vào cơ sở dữ liệu trong một transaction duy nhất (trans_start()/trans_complete()).
Cơ chế an toàn giao dịch và ghi đè
- Hoàn tác nguyên tử (Atomic Rollback): Nếu xảy ra bất kỳ lỗi cơ sở dữ liệu nào giữa chừng, toàn bộ giao dịch sẽ tự động hoàn tác để tránh tình trạng dữ liệu bị nhập dở dang.
- Thay thế bản ghi trùng ID: Quá trình nhập sử dụng cơ chế
REPLACEđối với các bản ghi trùng khóa chính. Hãy luôn tải trước một bản sao lưu SQL tại tab Backup / Restore trước khi nhập vào website RISE CRM đang vận hành.
Bộ khởi tạo dữ liệu mẫu (Polycms_Demo_Seeder)
Nhằm giúp bạn kiểm thử giao diện theme, menu, widget và các trang giới thiệu MTBuilder ngay lập tức, PolyCMS tích hợp sẵn Polycms_Demo_Seeder.
Tự động khởi tạo khi cài mới (Auto-Seed)
Khi PolyCMS được kích hoạt lần đầu trên một bản cài RISE CRM mới có bảng {db_prefix}blog_posts còn trống, bộ seeder sẽ tự động nạp dữ liệu khởi đầu gồm chuyên mục, thẻ tag, bài viết mẫu, menu và trang giới thiệu để website hoạt động trực quan ngay sau khi cài đặt.
Ba chế độ thủ công tại PolyCMS > Tools > Demo Data
Mở tab Demo Data (/polycms/tools#demo_data) bất cứ khi nào bạn cần tạo lại, cập nhật hoặc xóa sạch dữ liệu mẫu. Cả ba thao tác đều đi kèm hộp thoại xác nhận SweetAlert2 để phòng tránh nhấn nhầm:
| Chế độ | Nút thao tác | Cơ chế hoạt động | Khi nào nên dùng |
|---|---|---|---|
| Generate Content Template (Đặt lại toàn bộ) | Generate Data | Xóa sạch các bảng nội dung blog hiện có và nạp lại toàn bộ bộ dữ liệu mẫu từ đầu gồm chuyên mục, thẻ tag, bài viết, trang tĩnh, menu, widget và các trang mẫu MTBuilder. | Dựng nhanh môi trường thử nghiệm, xem thử giao diện theme mới hoặc trình bày bản demo cho khách hàng. Luôn sao lưu trước khi chạy. |
| Update Generate Data (Cập nhật an toàn) | Update Data | Cập nhật nội dung bài viết/trang/chuyên mục từ mẫu, bổ sung bài mới nếu có và làm mới các trang showcase MTBuilder nhưng vẫn bảo toàn hình ảnh, slug, cấu hình nổi bật và siêu dữ liệu hiện có. | Cập nhật các trang giới thiệu MTBuilder hoặc nội dung mẫu mới sau khi nâng cấp PolyCMS mà không làm mất ảnh hay siêu dữ liệu bạn đã chỉnh sửa. |
| Clear All Blog Data (Xóa toàn bộ dữ liệu Blog) | Truncate Data | Xóa vĩnh viễn dữ liệu trong các bảng blog_posts, blog_categories, blog_tags, blog_post_categories, blog_post_tags, blog_comments, blog_post_meta, blog_pages và blog_page_meta. |
Dọn sạch toàn bộ dữ liệu mẫu sau khi thử nghiệm xong giao diện để đội ngũ biên tập bắt đầu đăng bài viết chính thức từ đầu. |
Bảng lựa chọn công cụ theo kịch bản sử dụng
| Kịch bản thực tế | Công cụ phù hợp |
|---|---|
| Di chuyển bài viết, trang tĩnh, chuyên mục và thẻ tag giữa RISE CRM staging và production | JSON Export -> Transactional JSON Import |
| Tạo bản sao lưu nhanh, dung lượng nhẹ chỉ chứa văn bản nội dung | JSON Export |
| Sao lưu hoặc di chuyển toàn bộ 19 bảng CMS (gồm menu, widget, permalink, cấu hình theme và plugin) | Sao lưu và Phục hồi Cơ sở dữ liệu |
| Nạp nhanh dữ liệu minh họa và trang showcase MTBuilder cho bản demo | Demo Data -> Generate Content Template |
| Làm mới trang showcase MTBuilder nhưng giữ nguyên ảnh, slug và metadata | Demo Data -> Update Generate Data |
| Dọn sạch bài viết mẫu trước khi xuất bản website chính thức | Demo Data -> Clear All Blog Data |
Tài liệu liên quan
- Sao lưu và Phục hồi Cơ sở dữ liệu cho RISE CRM - Sao lưu tệp SQL và khôi phục an toàn các bảng PolyCMS.
- Hướng dẫn Cài đặt và Kích hoạt cho RISE CRM - Thiết lập ban đầu và cơ chế tự động khởi tạo dữ liệu mẫu.
- Trình dựng trang trực quan MTBuilder cho RISE CRM - Tùy biến các trang showcase được
Polycms_Demo_Seedertạo sẵn.