View
... 2026-2-4 大约 3 分钟
# View
视图信息：
| 参数名 | 类型 | 描述 |
|---|---|---|
| viewID | string | 视图 ID |
| viewTitle | string | 视图标题 |
| viewType | integer(ViewType) | 视图类型 |
| property | json(ViewProperty) | 视图属性 |
# ViewType
视图类型：
| 数值 | 英文 | 描述 |
|---|---|---|
| 0 | unknown | 未知类型视图，传递该值不合法 |
| 1 | VIEW_TYPE_GRID | 网格视图 |
| 2 | VIEW_TYPE_KANBAN | 看板视图 |
| 3 | VIEW_TYPE_GALLERY | 画册视图 |
| 4 | VIEW_TYPE_GANTT | 甘特视图 |
| 5 | VIEW_TYPE_CALENDAR | 日历视图 |
# ViewProperty
视图属性：
| 参数名 | 类型 | 必传 | 描述 |
|---|---|---|---|
| autoSort | bool | 否 | 记录变更后自动重新排序 |
| sortSpec | Json | 否 | 排序设置 |
| filterSpec | Json | 否 | 过滤设置 |
| groupSpec | Json | 否 | 分组设置 |
| fieldVisibility | map<string, bool> | 否 | key为字段ID, value为布尔值表示是否显示 |
| frozenFieldCount | int32 | 否 | 冻结列数量，从首列开始 |
# SortSpec
| 参数名 | 类型 | 必传 | 描述 |
|---|---|---|---|
| sortInfos | json array | 否 | 参与排序的字段列表 |
| sortInfos.fieldId | string | 是 | 字段id |
| sortInfoes.desc | bool | 否 | 是否降序 |
# GroupSpec
| 参数名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| groups | json array | 否 | 参与分组的字段列表 |
| groups.fieldId | string | 是 | 字段id |
| groups.desc | bool | 否 | 是否降序 |
# FilterSpec
| 参数名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| conjunction | string | 是 | 多个conditions之间是以and(CONJUNCTION_AND)还是or(CONJUNCTION_OR)进行组合 |
| conditions | json array | 是 | 判断条件 |
# Condition
- 不同字段类型支持的筛选不同，需要根据智能表格不同字段类型实际支持的筛选条件进行组合
| 参数名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| fieldId | string | 是 | 字段ID |
| operator | string | 是 | 判断类型。见Operator |
| stringValue.value | string[] | 否 | 文本、网址、电话、邮箱、地理位置、关联、单选、多选等列类型使用。关联列为记录ID；选项列为选项ID；其它为文本值 |
| numberValue.value | double | 否 | 数字、进度列类型使用 |
| boolValue.value | bool | 否 | 复选框列类型使用 |
| userValue.value | string[] | 否 | 人员、创建人、最后编辑人列类型使用，值为成员ID |
| dateTime_value | json(FilterDataTimeValue) | 否 | 日期、创建时间、最后编辑时间列类型使用 |
# Operator
| 筛选值判断操作类型 | 说明 |
|---|---|
| OPERATOR_UNKNOWN | 未知 |
| OPERATOR_IS | 等于 |
| OPERATOR_IS_NOT | 不等于 |
| OPERATOR_CONTAINS | 包含 |
| OPERATOR_DOES_NOT_CONTAIN | 不包含 |
| OPERATOR_IS_GREATER | 大于 |
| OPERATOR_IS_GREATER_OR_EQUAL | 大于或等于 |
| OPERATOR_IS_LESS | 小于 |
| OPERATOR_IS_LESS_OR_EQUAL | 小于或等于 |
| OPERATOR_IS_EMPTY | 为空 |
| OPERATOR_IS_NOT_EMPTY | 不为空 |
# FilterDataTimeValue
| 参数名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| type | string | 是 | 日期类型。见 DateTimeType |
| value | string[] | 是 | 具体日期值，type 为具体日期或具体日期范围时必填 |
# DateTimeType
| 日期值类型 | 说明 |
|---|---|
| DATE_TIME_TYPE_DETAIL_DATE | 具体时间 |
| DATE_TIME_TYPE_DETAIL_DATE_RANGE | 具体时间范围 |
| DATE_TIME_TYPE_TODAY | 今天 |
| DATE_TIME_TYPE_TOMORROW | 明天 |
| DATE_TIME_TYPE_YESTERDAY | 昨天 |
| DATE_TIME_TYPE_CURRENT_WEEK | 本周 |
| DATE_TIME_TYPE_LAST_WEEK | 上周 |
| DATE_TIME_TYPE_CURRENT_MONTH | 本月 |
| DATE_TIME_TYPE_THE_PAST_7_DAYS | 过去 7 天内 |
| DATE_TIME_TYPE_THE_NEXT_7_DAYS | 接下来 7 天内 |
| DATE_TIME_TYPE_LAST_MONTH | 上月 |
| DATE_TIME_TYPE_THE_PAST_30_DAYS | 过去 30 天内 |
| DATE_TIME_TYPE_THE_NEXT_30_DAYS | 接下来 30 天内 |
# GanttViewProperty
| 参数名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| startDateFieldId | string | 是 | 时间条起点字段ID，只允许日期类型(FIELD_TYPE_DATE_TIME)的字段ID |
| endDateFieldId | string | 是 | 时间条终点字段ID，只允许日期类型(FIELD_TYPE_DATE_TIME)的字段ID |
# CalendarViewProperty
| 参数名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| startDateFieldId | string | 是 | 时间条起点字段ID，只允许日期类型(FIELD_TYPE_DATE_TIME)的字段ID |
| endDateFieldId | string | 是 | 时间条终点字段ID，只允许日期类型(FIELD_TYPE_DATE_TIME)的字段ID |