Cài đặt và sử dụng

Cài đặt

Plugin @digiforce-nc/plugin-action-duplicate thường được cài sẵn. Nếu chưa có, kích hoạt qua Plugin Manager.

Plugin hoạt động hoàn toàn ở client — server chỉ có stub, logic nhân bản sử dụng core API resource.get() và resource.create().

Thêm action Duplicate

Action Duplicate được thêm vào table row (menu ngữ cảnh từng dòng):

1. Mở Schema Editor trên block Table.
2. Vào Configure row actions → chọn Duplicate.
3. Lưu schema.

Hai chế độ nhân bản

Chế độ	Mô tả	Khi nào dùng
Quick duplicate	Gọi resource.get() → resource.create() ngay lập tức	Nhân bản nhanh, không cần sửa
Copy into form	Gọi resource.get() → mở form pre-filled → user sửa → submit	Cần điều chỉnh trước khi tạo

Quick duplicate

1. Nhấn Duplicate trên row.
2. Hệ thống gọi resource.get() với isTemplate: true để lấy dữ liệu sạch (loại bỏ field hệ thống).
3. Gọi resource.create() với dữ liệu vừa lấy.
4. Bảng tự refresh, hiển thị bản ghi mới.

Copy into form

1. Nhấn Copy into form trên row.
2. Hệ thống lấy dữ liệu bản ghi gốc.
3. Mở form tạo mới, pre-fill dữ liệu từ bản ghi gốc.
4. User chỉnh sửa field (nếu cần) rồi nhấn Submit.
5. Bản ghi mới được tạo.

Chọn field sao chép

Trong Schema Settings của action, designer cấu hình field nào được sao chép:

Loại field	Mặc định	Ghi chú
Field thường (text, number, ...)	Sao chép	Có thể bỏ qua
Field hệ thống (id, createdAt, updatedAt)	Bỏ qua	Luôn bị loại bỏ
Relation field	Tùy cấu hình	Sao chép FK hoặc bỏ qua
Auto-increment	Bỏ qua	Hệ thống tự gán giá trị mới

Tùy chỉnh

Trong Schema Settings của action Duplicate:

• Chọn chế độ mặc định (quick / copy into form)
• Chọn field được sao chép
• Đổi tiêu đề nút
• Thêm linkage rules