AKA Guides

# 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)

## CREATE

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

``` javascript

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

``` javascript

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

## 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.