飞书智能伙伴Aily之数据表

「数据表」主要用于业务数据的存储，支持读写，可用于技能中数据的查询。入口位于「技能编排」板块，开发者可以新建一张空白数据表来自定义表内字段，也可引用外部数据来源，目前支持：

新建数据表

引用飞书应用引擎共享数据

使用外部系统新建，支持两个方式（Excel 导入、飞书多维表格导入）

250px|700px|reset

使用数据表

「数据表」可被技能使用：在 Workflow 技能的「结构化数据」节点，可通过 OQL 来查询数据表

250px|700px|reset

数据表数据管理

数据表的数据分为了开发环境和线上环境，可以在每个环境的数据表详情页面去管理数据。开发环境的数据仅在应用工作台「调试预览」，不会对线上环境产生影响。

开发者可预览、操作当前数据表的数据：

新增：可通过逐条添加或批量导入添加数据，批量导入支持 Excel 或飞书多维表格。

编辑：修改某条数据记录。

删除：删除某条数据记录。

250px|700px|reset

配置说明

在「数据表」管理界面，我们可以新建并管理 4 类数据表：

系统数据表：每个应用均内置了 2 张系统「数据表」，用于存储部门或用户信息。

新建自定义数据表：直接新建空白数据表，自行设计表内字段；

使用外部系统新建：使用外部系统新建，通过 Excel 或多维表格导入字段并配置数据表。

共享数据表：引用飞书应用引擎的共享对象，在应用创建一张数据表。

（一）系统数据表

每个应用均内置了 2 张系统「数据表」，用于存储部门或用户信息。自动拉取应用可用范围内的飞书通讯录，无需开发者创建。

数据表	可见字段	备注
部门	名称、上级部门、状态、创建人、创建时间、更新人、更新时间	数据只读
用户	姓名、头像、邮箱、类型、部门、上级、启用账号密码、激活状态、账号状态、用户ID、创建人、创建时间、更新人、更新时间	数据只读

（二）新建自定义数据表

方式一新建一张空白数据表，定义字段

步骤	描述	图示
新建数据表	需要填写基本信息：数据表名称：必填，最长 100 个字符。标识：必填，系统自动生成，支持编辑，最长 100 个字符。描述：非必填。	250px\|700px\|reset
配置属性	初次进入数据表编辑器/选中数据表全局，即可配置该表属性：展示名称：用于更友好地显示或识别某条记录，例如关联某条数据表时可选择下拉框。默认为系统内置的“ID”字段，也可选择某个开启了“必填”开关的文本类型字段。搜索辅助信息：用于指定搜索数据表记录时，搜索结果下拉框中的副标题辅助信息，默认为空，可选择当前数据表任意字段，可多选。可搜索字段：可设置数据表中哪些字段的值可通过页面或 API 进行关键字匹配搜索。目前支持系统内置的“ID”字段，或者“文本”、“邮箱”或“手机号码”类型的字段。	250px\|700px\|reset
编辑字段	数据表系统字段系统字段：系统内置的字段（ID、展示名称、创建人、创建时间、更新人、更新时间），在字段名称后面显示“系统字段”的标记。系统字段不可编辑、不可删除。数据表自定义字段文本：纯文本类型的字段，支持用户设置单行文本或多行文本。整数：int64 类型的整数。浮点数：浮点数类型。日期时间：用于年/月/日时/分/秒格式的时间。手机号码：要求必须是“+86” 区号加上 11 位手机号码格式的字符串。邮箱：符合邮箱格式的字符串。选项：可设置选项值列表，支持“单选”或“多选”。布尔：只能选择“真值”或“假值”。富文本：可设置文本格式，可添加图片附件或链接。定点数：高精度数字，整数不超过 18 位、小数不超过 9 位。关联关系：用于数据表之间建立 1-1 或 N-1 的关联关系。	250px\|700px\|reset
保存/撤销	自动保存草稿：数据表编辑器中的任何变更均会自动保存到应用草稿中，需要用户手动提交后，才会真正在应用配置中生效。撤销：用户可选择撤销应用草稿中已保存的变更内容，将数据表编辑器中的内容恢复到上次提交的内容。	250px\|700px\|reset
提交	数据表编辑器中变更的内容自动保存到应用草稿中，需要用户主动提交后，才会在应用配置中生效。提交完成后可在数据表详情页查看数据表字段。如右图所示。	250px\|700px\|reset

（三）使用外部系统新建，导入 Excel/多维表格

Excel 数据导入

可基于 Excel 表来创建数据表并同时导入数据，也可将 Excel 数据导入到已存在的数据表中。

下方为“导入 Excel 数据到已有数据表”的步骤：

步骤	描述	图示
使用外部系统新建，选择 Excel 导入	选择数据源类型：通过 Excel 导入	250px\|700px\|reset
匹配字段关系	选择要导入的 Excel 工作表选择列表头所在行和数据开始行选择要导入哪些 Excel 列，以及和数据表字段的匹配关系 AI 默认会按照名称、类型进行智能匹配匹配不上的 Excel 列可手工选择	250px\|700px\|reset
提交导入	若存在导入失败的记录，可通过下载Excel来查看错误信息，按照错误信息来修改后，可再次上传导入

多维表格数据导入

可基于多维表格来新建数据表，并同时导入数据作为开发环境的测试数据，也可将多维表格数据导入已存在的数据表中。

（1）下方为“基于多维表格创建数据表”的步骤：

步骤	描述	图示
选择通过飞书多维表格导入	在「数据表」新建界面，点击「使用外部系统新建」，选择通过飞书多维表格导入。	250px\|700px\|reset
选择要导入的数据	选择多维表格文档：下拉中展示了有访问权限的多维表格文档。选择数据表：选择要导入的多维表格数据表。设置需要同步的具体字段唯一字段：默认勾选“记录ID” 勾选要导入的字段，可编辑数据表的字段类型、字段名称	250px\|700px\|reset
设置同步任务	目前只支持“仅同步一次”，即：任务启动运行后会立即进行一次数据同步。	250px\|700px\|reset
设置数据表基本信息	自动拉取填充，可编辑修改：名称标识描述	250px\|700px\|reset

（2）下方为“导入多维表格数据到已有数据表”的步骤：

步骤	描述	图示
操作入口	进入对应数据表的详情页面，点击「测试数据」中的「导入」按钮。	250px\|700px\|reset
选择要导入的数据	导入方式选择：通过飞书多维表格导入。选择多维表格文档：下拉中展示了有访问权限的多维表格文档。选择数据表：选择要导入的多维表格数据表。设置需要同步的具体字段唯一字段：默认勾选“记录ID” 勾选要导入的字段，可编辑数据表的字段类型、字段名称	250px\|700px\|reset
提交导入任务	多维表格导入任务是异步执行的。提交后，可在数据表的详情页面右上角更多操作菜单栏的「数据同步历史」中查看数据导入任务执行状态。	250px\|700px\|reset 250px\|700px\|reset

（三）共享数据表

飞书应用引擎的应用可将某些对象设置成「引用对象」，其他应用便可申请引用。

飞书应用引擎的「引用对象」功能说明，可查看：跨应用共享对象

引用飞书应用引擎共享数据，AI 应用中的数据表可进行数据读写。逻辑如下：

建立引用：建立 AI 应用中的数据表与飞书应用引擎共享对象的元数据映射关系

数据读写：数据存储在飞书应用引擎原应用中，读写数据时通过托管访问授权来访问原应用中的线上数据

下方为“引用飞书应用引擎的共享对象，在 AI 应用创建数据表”的步骤：

步骤	描述	图示
申请引用共享对象	选择对象：选择应用可选择应用内允许共享的对象以及支持圈选对象中需要共享的字段。设置数据范围：目前用户可共享该对象全部数据。按指定规则筛选择共享数据的能力当前暂未开放。填写申请理由并提交申请。	250px\|700px\|reset
源应用审批引用申请	源应用的所有者或管理员可aPaaS应用管理的「数据管理」页面看到引用申请工单。查看工单详情并审批。	250px\|700px\|reset
查看共享数据表	提交申请后可在数据表列表查看该对象，状态为“审核中”，当飞书应用引擎中该应用的管理员审批通过后，接收到申请已通过的相关消息推送。数据表类型为共享，不允许添加字段、删除字段。允许编辑字段的基本信息。	250px\|700px\|reset

注意事项：

应用数据在开发环境并不互通。即在 AI 应用的开发环境中，不能通过"共享"类型的数据表，来访问飞书应用引擎的开发环境中的应用数据。

飞书智能伙伴Aily之数据表

先进团队，先用飞书