多维表格中添加子记录

在多维表格中添加子记录，本质上是通过在子记录和父记录之间设置单向或双向关联字段来实现的。子记录会通过关联字段，映射至父记录，从而建立联系。本文档介绍如何通过 OpenAPI，在多维表格数据表中为一个记录添加子记录。

前提条件

你已创建了一个多维表格，且在多维表格中，已有一条记录作为父记录。

流程说明

添加子记录的整体流程如下所示：

1. 调用新增字段接口，在多维表格中创建一个单向或双向关联字段，用于建立记录之间的关联关系。了解什么是单向或双向字段，参考飞书帮助中心文档：使用多维表格单向关联字段、使用多维表格双向关联字段。
2. 调用查询记录接口，获取已有的父记录的 ID。
3. 调用新增记录接口，新增一条记录作为子记录，并确保该记录关联了已有的父记录。
4. 调用列出字段接口，获取“单向关联字段”的字段 ID。
5. 调用更新视图接口，将 hierarchy_config 参数中的 field_id 设为“单向关联字段”的字段 ID，以更新表格视图的层级结构样式。

操作步骤

本小节以如下的一条记录为例，介绍如何为该记录添加子记录。

1. 调用新增字段接口，在多维表格数据表中创建一个单向关联字段，用于建立记录之间的关联关系。请求体如下所示：

   {
     "field_name": "单向关联字段",
     "property": {
       "multiple": true,
       "table_id": "tblY2ha8xGSabcef"
     },
     "type": 18
   }

   若调用成功，多维表格将呈现如下效果：

   

2. 调用查询记录接口，获取已有的父记录的 ID。请求体为空即可：

   {}

   若调用成功，接口将返回如下结构数据，其中 rec9k8PAbR 即为父记录的 ID。

   {
     "code": 0,
     "data": {
       "has_more": false,
       "items": [
         {
           "fields": {
             "单向关联字段": {},
             "文本": [
               {
                 "text": "父记录",
                 "type": "text"
               }
             ]
           },
           "record_id": "rec9k8PAbR"   // 父记录 ID
         },
         {
           "fields": {
             "单向关联字段": {}
           },
           "record_id": "recb9nHBYR"
         },
         {
           "fields": {
             "单向关联字段": {}
           },
           "record_id": "recwG1hh0g"
         },
         {
           "fields": {
             "单向关联字段": {}
           },
           "record_id": "recBlfgGRO"
         },
         {
           "fields": {
             "单向关联字段": {}
           },
           "record_id": "recKZHTepH"
         },
         {
           "fields": {
             "单向关联字段": {}
           },
           "record_id": "recDZXc9fs"
         },
         {
           "fields": {
             "单向关联字段": {}
           },
           "record_id": "recX9dPV90"
         },
         {
           "fields": {
             "单向关联字段": {}
           },
           "record_id": "rec6cq2RIk"
         },
         {
           "fields": {
             "单向关联字段": {}
           },
           "record_id": "recuK6kUA1"
         },
         {
           "fields": {
             "单向关联字段": {}
           },
           "record_id": "recLjQD5Eo"
         }
       ],
       "total": 10
     },
     "msg": "success"
   }

3. 调用新增记录接口，新增一条记录作为子记录，并确保该记录关联了已有的父记录。请求体示例如下所示：

   {
     "fields": {
       "单向关联字段": [
         "rec9k8PAbR"
       ],
       "文本": "子记录"
     }
   }

   若调用成功，子记录将出现在数据表末尾，效果如下所示：

   

4. 调用列出字段接口，获取“单向关联字段”的字段 ID。若调用成功，接口将返回如下结构数据，其中 fldfASqam8 即为“单向关联字段”的字段 ID。

   {
     "code": 0,
     "data": {
       "has_more": false,
       "items": [
         {
           "field_id": "fldplsqa97",
           "field_name": "文本",
           "is_hidden": false,
           "is_primary": true,
           "property": null,
           "type": 1,
           "ui_type": "Text"
         },
         {
           "field_id": "fldfASqam8",   // 单向关联字段的字段 ID
           "field_name": "单向关联字段",
           "is_hidden": false,
           "is_primary": false,
           "property": {
             "multiple": true,
             "table_id": "tblmyHKpQG3k1kSD",
             "table_name": "数据表"
           },
           "type": 18,
           "ui_type": "SingleLink"
         }
       ],
       "page_token": "fldfASqam8",
       "total": 2
     },
     "msg": "success"
   }

5. 调用更新视图接口，参考如下请求示例，将 hierarchy_config 参数中的 field_id 设为“单向关联字段”的字段 ID，以更新表格视图的层级结构样式。

   {
     "property": {
       "hierarchy_config": {
         "field_id": "fldfASqam8"
       }
     },
     "view_name": "表格"
   }

   若调用成功，子记录位置将位于父记录之下，最终效果如下所示：