AKA Form - Tài Liệu Sử Dụng
User documentation
08/18/2025
- Table of contents
- AKA Form
AKA Form¶
Tài liệu này cung cấp hướng dẫn chi tiết để bắt đầu, phát triển và triển khai ứng dụng web sử dụng AKA Form. AKA Form khắc phục những hạn chế của Google Forms ví dụ như form phức tạp (quan hệ cha - con). AKA Form là 1 web app được xây dựng trên nền tảng AKA Express, là một framework web framework cho Google Apps Script web app, được thiết kế để xây dựng các ứng dụng web nhỏ gọn. Framework hỗ trợ các tính năng như routing động, quản lý trạng thái, và tích hợp API dễ dàng.
Đối tượng sử dụng:
- Người dùng Google Workspace mong muốn tạo 1 ứng dụng mà không cần backend phức tạp (PHP/NodeJS/.NET) hay database lớn như MySQL, SQL Server, Oracle..
- Bộ phận IT công ty vừa và nhỏ, mong muốn phát triển nhanh ứng dụng để kịp đáp ứng nhu cầu business
- Developer chuyên nghiệp phát triển PoC (Proof of Concept)
Bắt Đầu¶
Yêu cầu hệ thống¶
- Tài khoản Google/Google Workspace
- Trình duyệt: Chrome, Firefox, Safari (phiên bản mới nhất).
Yêu cầu kiến thức¶
Trong tài liệu này, chúng tôi giả định bạn đã có kiến thức:
- Google Spreadsheets, sử dụng các hàm cơ bản và nâng cao như ARRAYFORMULA, QUERY...
- Google Forms, thiết kế và xuất bản form
- Front-end
- Kiến thức cơ bản về HTML/CSS/Javascript
- Sử dụng Form.io Builder và có kiến thức về thư viện Form.io
- JSON (JavaScript Object Notation)
- Backend
Cài đặt¶
- Copy các file tại thư mục AKA-Form Template về Google Drive của bạn. Hiện tại AKA-Form không áp dụng cơ chế license như AKA-Bot nên có thể gọi free to use
- Trên Google Drive của bạn, mở file aka-formio-northwind spreadsheet
- Vào menu Extensions và chọn Apps Script để mở trình biên tập
- Triển khai dạng web app, theo như hướng dẫn Triển khai tập lệnh dưới dạng ứng dụng web
- Phân Quyền phù hợp với nhu cầu sử
Cấu Trúc Ứng Dụng AKA-Form¶
Sử Dụng Google Forms làm NoSQL Database¶
AKA-Form Backend¶
Xây dựng ứng dụng Northwind¶
Câu hỏi thường gặp (FAQ)¶
-
Q: Hỗ trợ những front-end framework nào?
A: Không giới hạn front-end framework, tuy nhiên cấu trúc AKA Form dựa trên page riêng lẻ nên khuyến khích sử dụng các framework nhỏ gọn. -
Q: Framework có hỗ trợ cơ chế authentication/authorization không?
A: Có, hỗ trợ authentication cơ bản (email/password). Password đươc lưu trữ dạng hash md5 (xem ví dụ login của app Northwind), các bạn set cứng email và password. Mặc định các form/page trong AKA-Form là public trừ phi bạn tùy biến logic login/authorization bằng cách sử dụng JS. -
Q: Có thể mở rộng các hàm backend không?
A: Không giới hạn back-end function, AKA-Form hỗ trợ sẵn các hàm thiết yếu. Các bạn có thể viết thêm bằng cách tạo file .gs trong Project Editor. Nhớ phải publish webapp lại với New Revision để webapp ghi nhận các hàm mới bổ sung.
Tài nguyên bổ sung¶
Ví dụ thực tế¶
Liên kết đến các dự án mẫu:
- Dự án Northwind
- Tài khoản/Mật khẩu
- admin@northwind.com/admin
- user@northwind.com/user
Lịch sử phiên bản¶
- 2025.08.17: Phiên bản hiện tại