AKA Guides

AKA-Form Backend » History » Revision 6

Revision 5 (Lê Sĩ Quý, 08/30/2025 06:48 PM) → Revision 6/9 (Lê Sĩ Quý, 08/30/2025 06:51 PM)

# AKA-Form Backend 

 {{TOC}} 

 Dưới đây là danh sách các hàm bên frontend có thể gọi thông qua cơ chế [HTML Service: Communicate with Server Functions](https://developers.google.com/apps-script/guides/html/communication) 

 ## Login 

 Hàm login thực hiện việc đăng nhập hệ thống sử dụng cơ chế username/password 

 ``` javascript 
 function login(data) 
 ``` 

 - **data** là object với thuộc tính *email*    và *password* 
 - Trả về session id (string) nếu thông tin email và password hợp lệ, ngược lại trả về null 


 ## Logout 

 Hàm logoutthực hiện việc đăng nhập hệ thống sử dụng cơ chế username/password 

 ``` javascript 
 function logout(sid) 
 ``` 

 - **sid** là session id trả về bởi hàm login 
 - Trả về **true**    nếu đăng xuất thành công và ngược lại là **false** 

 ## Check Session Id 

 Hàm checkSid kiểm tra giá trị session id có hợp lệ không 

 ``` javascript 
 function checkSid(sid) 
 ``` 

 - **sid** là session id trả về bởi hàm login 
 - Trả về **true**    nếu đăng xuất thành công và ngược lại là **false** 

 ## Md5 Hash 

 Hàm md5 thực hiện việc hash sử dụng thuật toán MD5 

 ``` javascript 
 function md5(str) 
 ``` 

 - **str** là chuỗi cần hash 
 - Trả về giá trị MD5 hash của **str** 

 ## Excec Query 

 Hàm runSql việc truy vấn (tương tự hàm QUERY) trên datasource tương ứng 

 ``` javascript 
 function runSql(ds, sql) 
 ``` 

 - **ds** Datasource id cần truy vấn 
 - **sql** câu lệnh truy vấn 
 - Trả về 1 mảng các đối tượng truy vấn nếu có dữ liệu hoặc mảng rỗng nếu không có dữ liệu hoặc lỗi 

 ## Load Datasources 

 Hàm loadDatasources đọc dữ liệu của các datasource id tươgn ứng 

 ``` javascript 
 function loadDatasources(names) 
 ``` 

 - **names** Datasource id cần đọc dữ liệu, các datasource id cách nhau bằng dấu , 
 - Trả về 1 đối tượng với các thuộc tính là các datasource id và giá trị thuộc tính là mảng các giá trị tương ứng.