138 lines
3.3 KiB
Markdown
138 lines
3.3 KiB
Markdown
# 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星）
|
||
- 备注（富文本编辑器）
|
||
```
|
||
|
||
---
|
||
|
||
## 注意事项
|
||
|
||
1. **Token 有效期**：X-Access-Token 有过期时间，过期后需重新获取
|
||
2. **表单编码唯一**：同一系统中 desformCode 不能重复
|
||
3. **设计器表单 vs Online 表单**：本 skill 只处理设计器表单（desform），不涉及 Online 表单
|
||
4. **创建后可在设计器中微调**：AI 创建的表单可以在设计器界面中继续编辑完善
|