3.3 KiB
3.3 KiB
jeecg-aiform 使用指南
快速开始
1. 自然语言描述表单
直接告诉 AI 你需要什么表单：
帮我创建一个请假申请表单，包含：
- 姓名（必填）
- 请假类型（事假/病假/年假，单选）
- 开始日期
- 结束日期
- 请假天数
- 请假原因
- 附件
2. 提供连接信息
AI 会要求你提供：
- 后端地址：如
https://boot3.jeecg.com/jeecgboot - X-Access-Token：从浏览器 F12 → Network → 任意请求的 Headers 中复制
3. 确认后自动创建
AI 会展示表单摘要（字段列表、控件类型），确认后自动调用 API 创建。
多种描述方式
以下描述方式都会触发 AI 表单生成：
| 描述方式 | 示例 |
|---|---|
| 直接说创建表单 | "创建一个员工信息表单" |
| 描述字段需求 | "我需要一个表单，有姓名、手机号、地址" |
| 描述业务场景 | "做一个采购单，包含采购明细子表" |
| 简短指令 | "AI设计表单：报销申请" |
| 英文指令 | "generate a leave application form" |
支持的控件类型
基础字段
- 单行文本、多行文本、数字、整数、金额
选择字段
- 单选框、多选框、下拉选择、下拉树
日期时间
- 日期选择器、时间选择器、日期范围
交互控件
- 开关、评分、滑块、颜色选择器
上传控件
- 图片上传、文件上传
联系方式
- 手机、邮箱
富文本
- 富文本编辑器、Markdown 编辑器
高级字段
- 省市级联动、地图、定位、条码、自动编号、文本组合
人员组织
- 用户选择、部门选择、岗位选择、组织角色
关联控件
- 关联记录、他表字段、汇总
布局控件
- 设计子表（明细表）
修改已有表单
如果要修改已创建的表单：
修改表单 xxx，增加一个"审批意见"多行文本字段
需要提供表单 ID 或编码。
常见场景示例
员工信息登记
创建员工信息登记表单：姓名(必填)、工号(必填)、手机、邮箱、部门、入职日期、备注、头像照片
请假申请
做一个请假申请表单：
- 申请人（用户选择，默认当前登录人）
- 请假类型（单选：事假/病假/年假/调休）
- 开始日期、结束日期
- 请假天数（整数）
- 请假原因（多行文本，必填）
- 附件
采购申请（带子表）
创建采购申请单：
主表字段：采购标题(必填)、采购部门、采购日期、总金额、备注
子表明细：物品名称、规格型号、数量(整数)、单价(金额)、小计(金额)
客户信息管理
创建客户信息表单：
- 客户名称(必填)、联系人、手机、邮箱 — 前两个一行两字段
- 所在地区（省市级联动）
- 客户类型（下拉：潜在客户/意向客户/成交客户）
- 客户等级（评分，5星）
- 备注（富文本编辑器）
注意事项
- Token 有效期：X-Access-Token 有过期时间，过期后需重新获取
- 表单编码唯一：同一系统中 desformCode 不能重复
- 设计器表单 vs Online 表单：本 skill 只处理设计器表单（desform），不涉及 Online 表单
- 创建后可在设计器中微调：AI 创建的表单可以在设计器界面中继续编辑完善