Orchestra Python API | read 方法的 sorts 參數(shù)

前言:
要使用 Orchestra Python API (下文簡稱 api) 查詢數(shù)據(jù),就需要使用 read 方法。read 方法提供豐富的過濾、聚合、排序選項(xiàng),在用戶權(quán)限范圍內(nèi)支持查詢一切實(shí)體類型,且線程安全,可放心使用。
sorts 參數(shù)支持單列排序、多列排序,是數(shù)據(jù)庫 order by 關(guān)鍵字的 API 實(shí)現(xiàn)。
正文:
sorts 參數(shù)目前支持 column、direction 關(guān)鍵字,足以滿足復(fù)雜的排序需求。
sorts 參數(shù)的一般形式如下:
column 關(guān)鍵字表示對當(dāng)前查詢結(jié)果按照給定字段進(jìn)行排序。
注意:給定字段需要滿足在圖式中 sorter 屬性的 enabled 不為 false,如果為 false 則排序無效,目前 summary 及 pivot 字段不支持排序。
direction 關(guān)鍵字表示排序的方向,有兩個(gè)可選值,分別是 asc 和 desc。
asc 表示對 name 字段升序排序,desc 表示對 name 字段降序排序。
一:下面我們看一個(gè)單列排序的例子:
該語句表示在 Task 數(shù)據(jù)表的查找結(jié)果上,按照 name 字段升序排序。
二:下面我們再看一個(gè)多列排序的例子:
該語句表示在 Task 數(shù)據(jù)表的查找結(jié)果上,按照 name 字段升序排序,name 相同則按照 id 字段降序排序。
在數(shù)據(jù)庫中執(zhí)行多列排序的排序次序與 sorts 參數(shù)中字段的順序一致。
這條語句可以很直觀地轉(zhuǎn)換成 sql 偽代碼如下:

對我們的產(chǎn)品有興趣,請聯(lián)系我們。
對我們的職位有興趣,請聯(lián)系我們。
我們的主頁:
orchestra-technology.com
API:
https://github.com/orchestra-technology/python-api.git
申請?jiān)囉茫?/strong>
service@orchestra-technology.com