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 创建的表单可以在设计器界面中继续编辑完善
|