Orchestra Python API | read 方法的 goups 参数

前言：
要使用 Orchestra Python API （下文简称 api） 查询数据，就需要使用 read 方法。read 方法提供丰富的过滤、聚合、排序功能，在用户权限范围内支持查询一切实体类型，且线程安全，可放心使用。
开发界面展示数据时常常需要对数据分组，这就需要用到 groups 参数。

正文：

groups 参数用于对数据分组，参数包含 column，direction 关键字，以及一个待开发的 method 关键字。

注意：给定字段需要满足在图式中 grouper 属性的 enabled 不为 false，如果为 false 则排序无效，目前 summary、lambda 及 pivot 字段不支持排序。

groups 的一般形式如下：

column 关键字表示按照给定字段对查询结果排序，与 sorts 参数一致。

direction 关键字表示排序的方向，有两个可选值，分别是 asc 和 desc，与 sorts 参数一致。

未启用 groups 参数时，read 方法的返回数据结构如下：

当启用 goups 参数时，read 方法的返回数据结构的形式会有所不同：

数组元素的 display_name 表示该组名称，children 属性表示该组包含的所有任务。

下面我们举例说明，执行以下代码：

返回数据应是如下形式：

注意：pages 参数会影响 children 中任务的数量

我们的主页：

orchestra-technology.com

API：

https://github.com/orchestra-technology/python-api.git

申请试用：

service@orchestra-technology.com