AKA-Form Backend¶

• Table of contents
• AKA-Form Backend
  • CREATE
  • UPDATE
  • DELETE
  • Login
  • Logout
  • Check Session Id
  • Md5 Hash
  • Excec Query
  • Load Datasources

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

CREATE¶

Tạo mới đối tượng document của form

function create(formId, doc, sessionId)

• formId Form id
• doc đối tượng document thường là trích xuất từ FormIO submission, thuộc tính bắt buộc là Document chứa đối tượng cần lưu
• sessionId Session id
• Trả về document id (string) nếu lưu thành công và ngược lại là null

UPDATE¶

Cập nhật đối tượng document của form

function update(id, formId, doc, oldDoc, sessionId)

• id Documentid
• formId Form id
• doc đối tượng document thường là trích xuất từ FormIO submission, thuộc tính bắt buộc là Document chứa đối tượng cần lưu
• oldDoc tùy chọn, sử dụng trong trường hợp lưu Spreadsheet dạng flat
• sessionId Session id
• Trả về document id (string) nếu lưu thành công và ngược lại là null

DELETE¶

Xóa mềm đối tượng document bằng cách bật cờ IsDeleted = 1

function remove(id, formId, sessionId)

• id Documentid
• formId Form id
• sessionId Session id
• Trả về document id (string) nếu lưu thành công và ngược lại là null

Login¶

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

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

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

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

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

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

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.