Action CRUD tự sinh

Hệ thống sinh năm action CRUD cho một bảng dựa trên cấu trúc bảng, thay cho việc viết tay năm câu SQL gần giống nhau. Mọi giá trị trong SQL sinh ra đều là param (bind); tên bảng và tên cột được bọc theo đúng cú pháp của PostgreSQL hoặc MySQL.

Thao tác thực tế

Từ sơ đồ quan hệ, chọn bảng sản phẩm và chọn các thao tác CRUD cần tạo thành action.

Vai trò cần có

Cần vai trò Editor trở lên ở môi trường đang chọn, và data source SQL phải có config ở môi trường đó. Chế độ Chọn người và nhóm (chọn người và group được chạy) cần vai trò Admin.

Sinh action từ một bảng

1. Vào Xây dựng > Bảng & sơ đồ, chọn data source.
2. Bấm Tạo action CRUD trên bảng cần dùng, ở tab Bảng hoặc trên khung bảng ở tab Sơ đồ quan hệ.
3. Kiểm tra Tiền tố slug. Slug của từng action được ghép từ tiền tố này. Slug là mã dùng để gọi action từ view và không đổi được sau khi publish.
4. Chọn các thao tác cần sinh. Mỗi thao tác có Tên action sửa được và nút Xem SQL để đọc trước câu lệnh sẽ được lưu.
5. Chọn Môi trường áp dụng. Mặc định là mọi môi trường trừ production.
6. Chọn Ai được chạy (xem bên dưới).
7. Tuỳ chọn bật Tạo kèm view và Publish ngay (xem bên dưới).
8. Bấm nút tạo (Tạo N action hoặc Tạo N action và view). Nếu Publish ngay được bật hoặc có chọn môi trường production, hệ thống yêu cầu xác nhận trước khi tạo.

Các thao tác

Thao tác	Action sinh ra
Danh sách	Lấy nhiều dòng: ô tìm (chuỗi con, không phân biệt hoa thường, trên các cột chữ), lọc theo cột, chọn cột và chiều sắp xếp, phân trang (mặc định 50 dòng một trang).
Xem một dòng	Lấy đúng một dòng theo khoá chính.
Thêm	Thêm một dòng mới. Cột có giá trị mặc định hoặc cột sinh tự động do DB tự điền.
Sửa	Sửa một dòng theo khoá chính. Ô để trống giữ nguyên giá trị cũ.
Xoá	Xoá một dòng theo khoá chính.

Các thao tác Xem một dòng, Sửa và Xoá yêu cầu bảng có khoá chính. Với database view (không phải bảng), chỉ có thao tác Danh sách. Khi một thao tác không sinh được, hộp thoại ghi rõ lý do, ví dụ bảng không có khoá chính hoặc có cột bắt buộc thuộc kiểu không nhập được từ form (nhị phân, hình học).

Ghi chú

Ở thao tác Sửa, ô để trống có nghĩa là giữ nguyên giá trị, nên form không đặt được một cột về NULL. Nếu cần, sửa SQL của action trước khi publish.

Ai được chạy

• Chỉ bạn và người có vai trò cao hơn (mặc định): action được đặt ở chế độ restricted. Quyền chạy được cấp cho người tạo, admin của project (nếu người tạo là editor) và owner của tổ chức, tính tại thời điểm tạo. Người khác cần được cấp quyền ở thẻ quyền của từng action.
• Mọi thành viên project: ai vào được môi trường đều chạy được, kể cả action ghi dữ liệu.
• Chọn người và nhóm (chỉ admin): chọn thành viên và group. Người tạo luôn có trong danh sách.

Tạo kèm view

Tuỳ chọn này bật sẵn khi có thao tác Danh sách. Hệ thống tạo thêm một view nháp dùng chính các action vừa sinh, với hai bố cục:

• Quản lý: bảng có tìm kiếm, lọc theo cột, sắp xếp, phân trang; xem, thêm, sửa, xoá từng dòng.
• Tra cứu: bảng có tìm kiếm, lọc, sắp xếp, phân trang và xem chi tiết; không ghi dữ liệu.

Sau khi view được publish, người có quyền chạy các action mở view ở mục Màn hình. Xem Dựng view.

Đọc lại và publish

Mặc định, mọi thứ được tạo ở dạng nháp và chưa ai chạy được. Nhờ vậy, action ghi (sửa, xoá) không chạy được khi chưa có người đọc lại SQL.

1. Ở màn hình kết quả, bấm Mở trên từng action để xem lại câu SQL và các ô nhập.
2. Sửa nếu cần (tên, nhãn param, SQL), sau đó bấm Publish. Publish chạy đủ các bước kiểm tra như với action viết tay.
3. Nếu có tạo view, publish các action trước, sau đó mở view và bấm Publish.
4. Vào Chạy action để chạy thử, hoặc mở màn hình bằng Mở màn hình.

Publish ngay

Tuỳ chọn Publish ngay (tắt sẵn) lần lượt publish từng action rồi đến view, qua đủ các bước kiểm tra như khi làm thủ công. Với action ghi, điều đó có nghĩa action chạy được ngay mà chưa ai đọc lại SQL. Mục nào không qua bước kiểm tra sẽ ở lại dạng nháp và được liệt kê để sửa.

Xem thêm

• Tạo action: chỉnh param, transformer, version.
• Dựng view
• Chạy action