填报表单操作文档
填报表单操作手册
本文档详细介绍安捷智用 AI 应用平台「填报表单」模块的功能和使用方法。填报表单允许用户通过可视化方式设计数据采集表单，支持拖拽组件、AI 智能生成、数据填报与管理、导入导出、公共链接分享等完整工作流。
1. 进入填报表单模块
登录平台后，在顶部导航栏点击 工作空间，然后在左侧边栏选择 填报表单即可进入模块。
填报表单模块主界面分为以下区域：
| 区域 | 说明 |
|---|---|
| 左侧树形目录 | 展示所有表单及文件夹的层级结构，支持展开/折叠 |
| 顶部操作栏 | 包含「新建文件夹」和「新建填报表单」按钮，以及搜索框 |
| 右侧内容区 | 展示选中表单的数据或操作面板 |
2. 表单管理操作
2.1 新建填报表单
- 在左侧目录树上方，点击 新建填报表单按钮。
- 系统将即时创建一个新表单，并自动生成名称（如「表单_UP3Er」）。
- 表单创建成功后，会自动在新标签页中打开表单编辑器。
提示：新建表单时无需弹窗输入名称，系统自动生成，后续可通过重命名修改。
2.2 新建文件夹
点击 新建文件夹按钮，可在当前目录下创建文件夹，用于归类管理多个表单。
2.3 右键操作菜单
在左侧目录树中，点击表单右侧的省略号图标（⋯），可弹出操作菜单：
| 操作 | 说明 |
|---|---|
| 编辑 | 打开表单编辑器，修改表单设计 |
| 重命名 | 修改表单名称 |
| 移动到 | 将表单移动到其他文件夹 |
| 复制 | 复制一份当前表单 |
| 删除 | 删除当前表单 |
3. 表单编辑器
点击表单项的「编辑」操作，或在新建表单后自动进入编辑器页面。
3.1 编辑器界面布局
编辑器分为四个主要区域：
| 区域 | 位置 | 说明 |
|---|---|---|
| 顶部工具栏 | 页面顶部 | 表单名称、AI 助手、清空/撤回/回退/导入/导出/预览/保存 |
| 左侧面板 | 左侧 | 组件库 / 大纲树 两个标签页 |
| 中央画布 | 中间 | 表单设计拖放区域 |
| 右侧属性面板 | 右侧 | 字段属性 / 显示高级 / 表单属性 |
3.2 组件库
左侧「组件库」标签页提供丰富的表单控件，按类型分为四大类：
基础控件
| 控件 | 用途 |
|---|---|
| 单行文本 | 短文本输入，如姓名、编号 |
| 多行文本 | 长文本输入，如地址、备注 |
| 数字输入 | 数值输入，支持精度设置 |
| 是否选择 | 二选一判断 |
| 下拉单选 | 从预设选项中选择一项 |
| 下拉多选 | 从预设选项中选择多项 |
| 点击多选 | 点击选择多项（标签式） |
| 点击单选 | 点击选择单项（标签式） |
| 日期 | 日期或日期时间选择 |
| 颜色选择 | 颜色值选取器 |
| 滑块 | 拖动滑块设置数值范围 |
| 开关 | 是/否切换开关 |
| 评分 | 星级评分控件 |
| 分割线 | 视觉分隔线 |
高级控件
| 控件 | 用途 |
|---|---|
| 附件上传 | 文件附件上传 |
| 图片上传 | 图片文件上传 |
布局控件
| 控件 | 用途 |
|---|---|
| 对象容器 | 嵌套容器，可放置多个字段 |
| 表格列表 | 可动态增减行的表格区域 |
业务控件
| 控件 | 用途 |
|---|---|
| 部门选择 | 选择组织部门 |
| 员工选择 | 选择员工人员 |
| 关联表单 | 关联其他表单数据 |
使用方式：从组件库中将控件拖拽到中央画布区域即可添加到表单。
3.3 大纲树
点击左侧「大纲树」标签页，可查看当前表单的字段结构概览，包含字段标题和字段名。
大纲树中的每个条目格式为：字段标题（字段名），例如「客户名称（customer_name）」。支持拖拽调整字段顺序。
4. AI 表单助手
编辑器顶部工具栏提供 AI 助手按钮，点击可打开 AI 表单助手面板。
4.1 使用 AI 生成表单
- 点击编辑器顶部的 AI 助手按钮，打开右侧 AI 面板。
- 在聊天输入框中描述您需要的表单内容，例如：
请生成一个客户信息登记表，包含客户名称、联系人、联系电话、客户类型、客户等级、行业、地址、合作开始日期、是否重点客户、备注，使用双列布局
- AI 将根据描述自动生成完整的表单结构，包括合适的控件类型、字段配置和布局。
4.2 AI 面板功能
| 功能 | 说明 |
|---|---|
| 模型选择 | 可切换不同 AI 模型（如 qwen3.6-plus） |
| 思考模式 | 开启后 AI 会展示推理思考过程 |
| 新建对话 | 开启新的 AI 对话 |
| 附件 | 支持上传附件辅助 AI 理解需求 |
关闭 AI 面板后，可查看生成的完整表单设计：
5. 字段属性配置
在设计画布中选中任意字段，右侧面板将切换为「字段属性」标签页。
5.1 基本属性
| 属性 | 说明 |
|---|---|
| 控件类型 | 显示当前字段使用的控件类型（如「单行文本」） |
| ID（字段名） | 字段的唯一标识，用于数据存储和 API 调用 |
| 标题 | 字段在表单中显示的中文名称 |
| 描述信息 | 字段的说明文字，支持富文本编辑（加粗、斜体、链接、图片等） |
| 占位提示 | 输入框内的灰色提示文字 |
| 格式 | 输入格式验证（如无限制、邮箱、手机号等） |
5.2 状态设置
| 状态 | 说明 |
|---|---|
| 普通 | 正常可编辑状态（默认） |
| 只读 | 仅显示不可编辑 |
| 隐藏 | 表单中不显示该字段 |
5.3 默认值
支持两种默认值设置方式：
- 自定义：手动输入固定默认值
- 公式编辑：通过公式动态计算默认值
5.4 扩展属性
| 属性 | 说明 |
|---|---|
| 前置标签 | 输入框前方的标签文字（如「¥」） |
| 后置标签 | 输入框后方的标签文字（如「元」） |
| 校验 | 必填验证、查重验证 |
| 字段宽度 | 1/4、1/3、1/2（半行）、整行 |
5.5 显示高级
点击「显示高级」标签页，可配置字段之间的响应器（联动逻辑），例如当某字段值变化时自动设置其他字段的值或可见性。
5.6 表单属性
点击「表单属性」标签页，可设置整体表单的属性：
| 属性 | 说明 |
|---|---|
| 展示类型 | 字段标签展示方式（列方式等） |
| 标签宽度 | 标签文字的宽度（默认 90px） |
| 表单布局 | 单列、双列、三列、四列布局 |
6. 表单预览
在编辑器中完成设计后，点击顶部工具栏的 预览按钮，可以预览表单效果。
6.1 电脑端预览
默认显示电脑端预览视图，表单按照设计的列布局展示：
6.2 手机端预览
点击预览弹窗顶部的「手机端」切换按钮，可查看手机端展示效果。手机端自动采用单列布局：
预览弹窗底部提供 取消 和 提交按钮，可模拟实际填报操作。
7. 保存表单
完成表单设计后，点击编辑器顶部工具栏的 保存按钮。保存成功后会显示绿色提示：
注意：设计过程中建议定期保存，避免数据丢失。
7.1 编辑器工具栏其他操作
| 按钮 | 说明 |
|---|---|
| 清空 | 清空当前画布上的所有字段 |
| 撤回 | 撤销上一步操作 |
| 回退 | 重做已撤销的操作 |
| 导入 | 导入表单 JSON 定义 |
| 导出 | 导出表单 JSON 定义 |
8. 表单数据管理
在列表页中点击某个表单，右侧将展示该表单的数据管理页面，包含「表单数据」标签页。
8.1 表单数据列表
数据列表以表格形式展示所有已提交的数据，包含：
- 所有自定义字段列（如：客户名称、联系人、联系电话等）
- 系统字段列：创建人、创建时间、最后更新人、最后更新时间
- 底部显示数据总数和分页信息
8.2 新增数据
- 点击工具栏中的 新增按钮。
- 弹出新增数据弹窗，显示表单中设计的所有字段。
- 填写表单数据，必填字段以红色星号（*）标记。
- 点击 提交按钮保存数据。提交成功后数据将出现在列表中。
8.3 编辑数据
- 在数据列表中，勾选需要编辑的数据行。
- 选中后，工具栏中的 编辑 和 删除按钮将被激活。
- 点击 编辑按钮，弹出编辑弹窗，显示原有数据，可修改后提交。
8.4 删除数据
- 勾选需要删除的一行或多行数据。
- 点击工具栏中的 删除按钮。
- 确认后数据将被删除。
8.5 工具栏功能
| 按钮 | 说明 |
|---|---|
| 新增 | 打开表单新增数据弹窗 |
| 导入 | 从 Excel 文件导入数据 |
| 导出 ▼ | 导出数据（选中数据 / 全部数据） |
| 编辑 | 编辑选中的数据行（需先选中） |
| 删除 | 删除选中的数据行（需先选中） |
右侧还提供：刷新、筛选、设置、列配置等快捷操作。
9. 导入 Excel 数据
点击数据管理页的 导入按钮，可通过 Excel 文件批量导入数据。
9.1 导入步骤
导入分为四个步骤：
| 步骤 | 说明 |
|---|---|
| 1. 选择 Excel | 拖拽或点击上传 Excel 文件 |
| 2. 预览数据 | 预览 Excel 中的数据内容 |
| 3. 配置表单 | 映射 Excel 列与表单字段的对应关系 |
| 4. 导入数据 | 执行导入并显示结果 |
9.2 导入模式
| 模式 | 说明 |
|---|---|
| 仅新增数据 | 只添加新数据，不影响已有数据 |
9.3 文件要求
- 支持
.xlsx和.xls格式 - 文件大小不超过 2MB
- 行数不超过 10 万行
- 列数不超过 500 列
- 可下载「标准模板」作为导入参考
10. 导出数据
点击数据管理页的 导出按钮，展开下拉菜单：
| 选项 | 说明 |
|---|---|
| 选中数据 | 仅导出当前勾选的数据行 |
| 全部数据 | 导出表单中的所有数据 |
导出文件格式为 Excel。
11. 公共链接
通过公共链接功能，可以将表单分享给外部人员填写，无需登录平台。
11.1 创建公共链接
- 在表单数据页面的顶部栏，点击 公共链接按钮。
- 弹出公共链接管理弹窗。
- 点击 新建公共链接按钮，可创建新的分享链接。
11.2 链接设置
| 属性 | 说明 |
|---|---|
| 链接地址 | 系统生成的访问链接 |
| 有效期至 | 链接有效期限（如一个月） |
| 密码保护 | 可设置访问密码 |
12. 申请发布
表单设计完成后，可申请将其发布到组织空间，供更多用户访问。
12.1 发布流程
- 在表单数据页面的顶部栏，点击 申请发布按钮。
- 弹出发布申请弹窗。
- 配置发布选项：
| 配置项 | 说明 |
|---|---|
| 终端 | 选择发布到的终端：电脑 / 手机（可多选） |
| 发布申请备注 | 填写申请备注说明 |
| 添加路径 | 自行配置发布到数据门户的目录路径 |
- 点击 确定提交发布申请。申请通过后，表单将发布到组织空间，可被目录管理员添加到数据门户目录中。
13. 表单数据页面概览
选中某个表单后，顶部导航和操作区显示如下：
| 区域 | 说明 |
|---|---|
| 面包屑导航 | 显示当前位置：填报表单 / 表单名称 |
| 公共链接 | 管理表单的公共分享链接 |
| 申请发布 | 将表单发布到组织空间 |
| 编辑 | 进入表单编辑器修改设计 |
| 表单数据标签 | 查看和管理已提交的数据 |
| 性能指示 | 显示当前数据量级别 |
附录：快捷操作一览
| 操作 | 路径 |
|---|---|
| 新建表单 | 工作空间 → 填报表单 → 新建填报表单 |
| 编辑表单设计 | 选中表单 → 右键菜单/编辑按钮 → 打开编辑器 |
| AI 生成表单 | 编辑器 → AI 助手 → 描述需求 |
| 添加字段 | 编辑器 → 组件库 → 拖拽到画布 |
| 配置字段属性 | 编辑器 → 选中字段 → 右侧属性面板 |
| 预览表单 | 编辑器 → 预览按钮 |
| 保存表单 | 编辑器 → 保存按钮 |
| 新增数据 | 表单数据页 → 新增按钮 |
| 编辑数据 | 表单数据页 → 勾选行 → 编辑按钮 |
| 删除数据 | 表单数据页 → 勾选行 → 删除按钮 |
| 导入数据 | 表单数据页 → 导入按钮 |
| 导出数据 | 表单数据页 → 导出按钮 |
| 分享表单 | 表单数据页 → 公共链接 |
| 发布表单 | 表单数据页 → 申请发布 |