批量新建视图

HAP应用密钥

HAP签名

锚点视图 ID，新创建的视图组将有序排在此视图前面；不传默认加至末尾。

视图列表

视图名称

视图类型

视图专有配置（除 table/gallery 外基本必填！）：
• kanban需要 groupField
• map需要 locationField
• hierarchy需要 relationField
• calendar需要 dates 数组
• detail需要 mode

kanban: 作为分组依据的关联字段或单选字典字段（传字段 alias 或字段 ID）

map: 定位字段（传字段 alias 或字段 ID）

hierarchy: 树形层级依赖的关联字段（传字段 alias 或字段 ID）

calendar: 包含 startField 和 endField

开始时间字段（传字段 alias 或字段 ID）

结束时间字段（传字段 alias 或字段 ID）

gantt/resource 的开始时间字段（传字段 alias 或字段 ID）

gantt/resource 的结束时间字段（传字段 alias 或字段 ID）

resource: 负责人字段（传字段 alias 或字段 ID）

detail 専用。all=左侧显示记录列表（默认）；first=不显示列表，直接显示第一条记录详情，适用于参数配置页

视图筛选器对象，用于定义视图数据的过滤条件。

filter 的根节点必须始终为 group，不能直接传 condition。即使只有一个筛选条件，也必须使用 group 包裹，并通过 children 传入 condition。

Filter 结构

Filter = {
  type: 'group' | 'condition';
  // 当 type 为 'group' 时的字段
  logic?: 'AND' | 'OR';
  children?: Filter[]; // 只能全是 group 或全是 condition，不能混合；最多两层嵌套
  // 当 type 为 'condition' 时的字段
  field?: string; // 必须传入字段 ID
  operator?: FilterOperator; // 运算符
  value?: any; // 字符串、数值、数组
}

注意事项

1. 根节点要求：filter 的根节点必须始终为 group，不能直接传 condition。即使只有一个筛选条件，也必须使用 group 包裹。
2. 嵌套限制：最多支持两层嵌套（group → group → condition）。
3. children 类型一致性：一个 group 的 children 只能全部是 group 或全部是 condition，不能混合。
4. logic 必需：当 type 为 group 时，logic 必须指定为 AND 或 OR。
5. 为空运算符：isempty / isnotempty 运算符不需要提供 value。
6. 数组值运算符：between、in、contains、concurrent、belongsto 等运算符必须使用数组值。
7. 选项型字段：单选、多选字段的筛选 value 必须传入对应 option 的 key 数组。
8. 关联记录筛选：筛选关联记录前需先查询 record_id，再以数组形式作为 value 进行筛选。
9. Collaborator / Department / Role 字段：筛选此类字段时必须使用对应实体的 id，不能直接使用名称或其他属性。
10. 示例说明：下方示例中的 field 仅用于说明结构，实际调用时必须传入真实字段 ID。

使用示例

示例 1：单个筛选条件也必须使用 group 包裹

{
  "type": "group",
  "logic": "AND",
  "children": [
    {
      "type": "condition",
      "field": "status_field_id",
      "operator": "eq",
      "value": ["1"]
    }
  ]
}

示例 2：简单筛选条件

查询所有 1 月份入职、姓“张”的职员：

{
  "type": "group",
  "logic": "AND",
  "children": [
    {
      "type": "condition",
      "field": "name_field_id",
      "operator": "startswith",
      "value": "张"
    },
    {
      "type": "condition",
      "field": "onboard_date_field_id",
      "operator": "between",
      "value": ["2025-01-01", "2025-01-31"]
    }
  ]
}

示例 3：多层筛选组

查询华北区市场部/销售部，1 月入职且姓“张”的职员：

{
  "type": "group",
  "logic": "AND",
  "children": [
    {
      "type": "group",
      "logic": "AND",
      "children": [
        {
          "type": "condition",
          "field": "name_field_id",
          "operator": "startswith",
          "value": "张"
        },
        {
          "type": "condition",
          "field": "onboard_date_field_id",
          "operator": "between",
          "value": ["2025-01-01", "2025-01-31"]
        }
      ]
    },
    {
      "type": "group",
      "logic": "OR",
      "children": [
        {
          "type": "condition",
          "field": "department_field_id",
          "operator": "contains",
          "value": ["sales_department_id", "marketing_department_id"]
        },
        {
          "type": "condition",
          "field": "region_field_id",
          "operator": "belongsto",
          "value": ["north_region_id"]
        }
      ]
    }
  ]
}

—

—

—

必须传入Field ID，注意：当字段结构来自 Markdown 格式时，如果字段 ID 或中包含 '(isTitle)'，该标记仅用于表示此字段是标题字段，不属于字段 ID 的一部分。在传参时应移除 '(isTitle)'，仅保留真实字段 ID。

支持的筛选运算符：

比较运算符：

• eq：等于，例如 "Beijing" 或 ["<targetid>"]
• ne：不等于，例如 "London" 或 ["<targetid>"]
• gt：大于，例如 20 或 "2025-02-06 00:00:00"
• ge：大于等于，例如 10
• lt：小于，例如 20
• le：小于等于，例如 100
• in：是其中一个，例如 ["value1", "value2"]
• notin：不是任意一个，例如 ["value1", "value2"]
• contains：包含，例如 "Ch" 或 ["销售部", "市场部"]
• notcontains：不包含，例如 "Ch" 或 ["销售部", "市场部"]
• concurrent：同时包含，例如 ["<id1>", "<id2>"]
• belongsto：属于，例如 ["<departmentid>"]
• notbelongsto：不属于，例如 ["<departmentid>"]
• startswith：开头是，例如 "张"
• notstartswith：开头不是，例如 "李"
• endswith：结尾是，例如 "公司"
• notendswith：结尾不是，例如 "有限公司"
• between：在范围内，例如 ["2025-01-01", "2025-01-31"]
• notbetween：不在范围内，例如 ["10", "20"]

为空运算符：

• isempty：为空，不需要 value
• isnotempty：不为空，不需要 value

筛选值。根据运算符不同，可传字符串、数字或数组。

• 标量示例："Beijing"、20、"2025-02-06 00:00:00"
• 数组示例：["value1", "value2"]、["2025-01-01", "2025-01-31"]
• isempty / isnotempty：不需要传 value

特殊 AccountID（适用于 Collaborator 等成员字段筛选）：

• user-self：当前用户
• user-sub：下属
• user-workflow：工作流
• user-api：API

排序规则列表。支持多个排序字段，数组顺序表示排序优先级。非必填。

排序字段 alias 或字段 ID。

排序方式。1=升序，2=降序。

记录颜色配置，只配置用于着色的字段。

用于着色的字段引用，传字段 alias或字段 ID。仅支持 fieldType=9、11 且已开启选项标签颜色的单选字段。

快速筛选字段列表。数组顺序即显示顺序。仅支持 fieldType=2、4、7、32、33、6、8、31、9、10、11、26、27、28、29、35、36、15、16。建议选择 2-4 个最常用筛选维度；除选项字段 fieldType=9、10、11 可配置 selectionType 和 displayType 外，其他 UI 配置均由接口使用默认值。

快速筛选字段 alias 或字段 ID。

选项字段的筛选值数量，仅适用于 fieldType=9、10、11。single=单选，multiple=多选。

选项字段的显示方式，仅适用于 fieldType=9、10、11。dropdown=下拉框，tile=平铺。

在此视图中隐藏的字段列表，对记录详情生效。

表格形态（table、gantt）中显示的字段列表。不填则显示全部字段。

侧边栏筛选列表配置。设置后在视图左侧以该字段的选项值为维度显示筛选入口。

用于侧边筛选的字段 alias 或字段 ID（不能传 name）

卡片显示配置，适用于 kanban / gallery / hierarchy 以及 calendar、gantt、map、resource hover 时的卡片。所有字段均传 alias 或字段 ID，不能传 name。

卡片标题字段（所有文本类字段均可）

卡片摘要字段（Text / RichText 类型）

卡片封面字段（仅支持附件类型字段）

封面位置。top=顶部（默认），left=左侧，right=右侧。gallery 推荐 top；detail/kanban 左右均可

封面显示模式。full=铺满（默认），square=方形裁切，circle=圆形裁切。人员头像场景用 circle，产品图用 full 或 square

卡片中额外展示的字段列表，推荐 1-4 个

视图中显示的操作按钮配置。需要先调用 batch_create_custom_actions 获取自定义动作 ID，再在此引用。

打开记录详情后显示的操作按钮（自定义动作 ID 数组）

表格行/卡片上直接显示的快捷操作按钮列表

系统操作固定传: copy / print / delete / share；自定义动作传 action

type=action 时传自定义动作 ID；系统操作不传

分组配置。table / gallery / kanban 视图支持按指定字段分组显示记录。

分组依据字段的 alias 或字段 ID