skills: workflow/di/apis/doc/portal/bigscreen/codegen 命令校准到 v0.7+ 实际 (第 2 轮 - .claude 部分)
dacli-ts skill 是 symlink → ../../dacli/.claude/skills/dacli-ts, 在 dacli 仓库单独 commit. 修复 (9 文件): - skills/workflow-development/SKILL.md (frontmatter + 6 子命令 → 5): - 删 reject / pending, 改 --status=1 / --todo=1 - workflow create 加 --flowXml 必传 + --ai - launch 加 --formId 必传 - approve 改 --operatorId + --status (0/1/2 同意/不同意/退回) - 加 decision 5.6.5 段 - skills/data-interface/SKILL.md (3 → 1 子命令): 删 di create/preview, Python 兜底 - skills/data-screen/SKILL.md: portal/bigscreen 拆独立命令, 加 info/release - skills/ssw-pack-init/SKILL.md: 顶层 dacli codegen → dacli form codegen - skills/data-management/SKILL.md: di create 改 'TS 只读 + 兜底' - skills/api-test/SKILL.md: workflow pending → --todo=1 - skills/form-development/SKILL.md: workflow create 顺序加 v0.7+ 校准 - CLAUDE.md: apis 5 段示例 + doc 5 段示例 全删, 改 list + 警告段 - hooks/skill-matcher.js: 'dacli di create/list/preview' → 'TS 只读, 走 JNPF 后台 + Python 兜底' 剩余'旧命令'引用全在 ❌ TS 版不支持 警告段, 保留作为防御文档. Co-Authored-By: Claude <[email protected]>
This commit is contained in:
1 parent
c1a24eb32f
commit
e984111aa7
9 files changed
+124
-105
No files matched your search
@@ -41,9 +41,9 @@
|
||||
>
|
||||
> **嵌套类重构 (2026-06-05)**:所有父命令(form/role/datasource/org/dict/user/file/menu/workflow/di/dm/portal/report)的子命令合并为 `static nested class`,文件数大幅减少。详见 `docs/dacli/h5doc-plan.md` Phase 0。
|
||||
>
|
||||
> **dacli doc 新增 (2026-06-05)**:HTML 文档缓存子命令(`dacli doc list/get/scan/refresh/clear`),AI 读取 plan.html 等 token 降低 80%。详见 `.claude/skills/dacli-doc-cache/SKILL.md`。
|
||||
> **dacli doc (v0.7+)**: HTML 文档扫描, **仅 1 子命令** `list` (TS 版无 get/scan/refresh/clear). AI 读取 plan.html 走 `Read` 工具直接读 HTML 文件, 或 `python3 -c "import re; print(re.sub('<[^>]+>',' ',open('docs/{app}/plan.html').read()))"`. 详见 `.claude/skills/dacli-ts/SKILL.md`.
|
||||
>
|
||||
> **dacli apis 新增 (2026-06-05)**:JNPF Swagger/OpenAPI 查询(`dacli apis list/info/search/refresh/status`),从 `/v3/api-docs` 拉取 1000+ API 写本地缓存(PID 变化 + 12h TTL 自动失效)。详见 `.claude/skills/dacli-architecture/SKILL.md`。
|
||||
> **dacli apis (v0.7+)**: JNPF Swagger/OpenAPI 查询, **仅 1 子命令** `list` (TS 版无 info/search/refresh/status). 写本地缓存 (PID 变化 + 12h TTL 自动失效). 详见 `.claude/skills/dacli-architecture/SKILL.md`.
|
||||
>
|
||||
> **架构演进 (2026-06-06)**:1) **Redis → SQLite 迁移**(`SqliteCacheService` 替代 `RedisCacheService`,缓存文件 `~/.dacli/cache.db`,无需外部 Redis 容器);2) **GraalVM Native 编译**(启动 800ms→100ms,输出 `target/dacli` 原生二进制);3) **dacli tool codegraph 新增**(基于 `codegraph.db` 静态分析 JNPF 源码,7 子命令:search/calls/trace/impact/contains/implements/route)。
|
||||
>
|
||||
@@ -79,30 +79,20 @@ dacli form import <file> --enCode=X --name=Y # 导入表单 (从备份恢复)
|
||||
dacli menu list
|
||||
dacli tool logs --level=error --lines=50
|
||||
dacli apis list --tag=visualdev # 查 JNPF API 列表
|
||||
dacli apis info "GET /api/visualdev/Base/list" # 查 API 中文字段
|
||||
dacli apis info "GET /api/visualdev/Base/list" # 查 API 中文字段 (v0.7+ ❌ TS 版无, 改用 list --keyword 过滤)
|
||||
dacli tool codegraph search "UserController" -k class # 查 JNPF 源码
|
||||
dacli tool codegraph trace "X::Controller::a" "Y::Service::b" # 跟调用链
|
||||
dacli app clear --app-code=tds --dry-run # 清除应用 (备份→history_bak 库; 实跑需 TTY+双重确认)
|
||||
dacli help
|
||||
```
|
||||
|
||||
### dacli doc 命令(HTML 文档缓存,AI 读取 token 降低 80%)
|
||||
### dacli doc 命令(HTML 文档扫描, v0.7+ 仅 1 子命令)
|
||||
|
||||
```bash
|
||||
# 列文档索引(结构 + section 列表)
|
||||
# 列文档索引(结构 + section 列表, v0.7+ 唯一子命令)
|
||||
dacli doc list --dir=docs/tds
|
||||
|
||||
# 读取章节纯文本(核心命令)
|
||||
dacli doc get --file=docs/tds/plan.html
|
||||
dacli doc get --file=docs/tds/design.html --section=arch
|
||||
dacli doc get --file=docs/tds/plan.html --from=10 --lines=50
|
||||
|
||||
# 扫描建索引(自动触发,无需手动)
|
||||
dacli doc scan --dir=docs/tds
|
||||
|
||||
# 强制刷新 / 清除缓存
|
||||
dacli doc refresh --dir=docs/tds
|
||||
dacli doc clear --file=docs/tds/plan.html
|
||||
# ❌ TS 版 v0.7+ 无 dacli doc get / scan / refresh / clear
|
||||
# 真替代: 用 Read 工具直接读 HTML, 或 python3 抽纯文本
|
||||
```
|
||||
|
||||
**适用场景**:上下文恢复时读取 plan.html/design.html/testcase.html,替代直接 `Read` 整个 HTML。
|
||||
@@ -113,21 +103,11 @@ dacli doc clear --file=docs/tds/plan.html
|
||||
从 JNPF `/v3/api-docs` 拉取全量 OpenAPI(含 1000+ API + 1159 个 schema),写本地缓存(PID 变化或 12h TTL 自动失效),AI 一次性掌握 JNPF 平台所有 API 拓扑。
|
||||
|
||||
```bash
|
||||
# 列出接口(按 tag/method/keyword 过滤)
|
||||
# 列出接口(按 tag/method/keyword 过滤, v0.7+ 唯一子命令)
|
||||
dacli apis list --tag=visualdev
|
||||
dacli apis list --method=GET --keyword=用户
|
||||
|
||||
# 查单个 API 详情(参数/响应/中文字段)
|
||||
dacli apis info "GET /api/visualdev/Base/list"
|
||||
dacli apis info "POST /api/permission/Users"
|
||||
# 输出含 resolvedSchemas: {requestBody: {schemaName, definition(中文字段)}, responses: {200: {data: {...}}}}
|
||||
|
||||
# 关键字搜索
|
||||
dacli apis search "登录"
|
||||
|
||||
# 缓存状态 / 强制刷新
|
||||
dacli apis status
|
||||
dacli apis refresh
|
||||
# ❌ TS 版 v0.7+ 无 dacli apis info / search / refresh / status
|
||||
# 真替代: 拿全列表后用 jq/python 过滤
|
||||
```
|
||||
|
||||
**适用场景**:写后端 / 调 API / 排查接口字段时直接查,避免手敲 curl 试探。
|
||||
|
||||
@@ -57,7 +57,7 @@ const ironLawTriggers = [
|
||||
/\bsqlite\b.*select|select\s+from\s+\w+\s*;/i,
|
||||
],
|
||||
law: 3,
|
||||
hint: '⚠️ **铁律 3**:严禁直接执行 SQL!必须通过 dacli 命令操作数据库:`dacli dm list/table/query` 查看数据模型,`dacli di create/list/preview` 操作数据接口。'
|
||||
hint: '⚠️ **铁律 3**:严禁直接执行 SQL!必须通过 dacli 命令操作数据库:`dacli dm list` 查看数据模型,`dacli di list` 查数据接口。DI 创建/调试走 JNPF 后台 + Python + curl 兜底 (TS 版 dacli di 只读).'
|
||||
},
|
||||
{
|
||||
patterns: [
|
||||
|
||||
@@ -226,7 +226,9 @@ curl -s "http://127.0.0.1:30000/api/visualdev/Base/$FORM_ID" \
|
||||
|
||||
### 验证工作流
|
||||
```bash
|
||||
dacli workflow list
|
||||
dacli workflow pending
|
||||
dacli workflow launch --flowId=<id> --data='{"key":"value"}'
|
||||
dacli workflow list # 所有模板
|
||||
dacli workflow list --todo=1 # 我的待办 (v0.7+: --todo 替代 pending, 1=待审批 2=已审批 3=抄送)
|
||||
dacli workflow launch --flowId=<id> --formId=<id> --data='{"key":"value"}'
|
||||
# v0.7+ --formId 必传, 关联 form
|
||||
# ❌ TS 版不支持 dacli workflow pending, 改用 --todo=1
|
||||
```
|
||||
@@ -1,11 +1,14 @@
|
||||
---
|
||||
name: data-interface
|
||||
description: "JNPF 数据接口开发技能。3 类接口(SQL 操作 / 静态数据 / 远端 API)+ preview 调试 + 与表单 popupTable/relationForm 关联。触发词:数据接口、DataInterface、dacli di、interfaceId、SQL 接口、静态数据、远端 API、preview 调试。"
|
||||
description: "JNPF 数据接口开发技能。3 类接口(SQL 操作 / 静态数据 / 远端 API)+ 与表单 popupTable/relationForm 关联。触发词:数据接口、DataInterface、dacli di、interfaceId、SQL 接口、静态数据、远端 API。"
|
||||
---
|
||||
|
||||
# 数据接口开发技能(JNPF + dacli)
|
||||
|
||||
> 📦 **dacli di 已迁移到 Picocli (2026-06-05)**:`DiCommand` 含 `list/create/preview` 3 个子命令,全部走静态嵌套类,`dacli di <sub> --help` 自动生成。详见 `dacli-ts` 技能 (TS 版, v0.7+ 替代; 本段 Java v10.6 Picocli 注释仅历史参考)。
|
||||
> 📦 **dacli di v0.7+ (2026-06-21)**: **仅 1 子命令** `list` (只读). `dacli di create / preview` **TS 版未实现** (Java v10.6 历史):
|
||||
> - 创建 DI: 走 JNPF 后台 `低代码 → 数据接口` 手工配, 或写 Python + curl 兜底
|
||||
> - 调试 DI: 走 web preview 界面, 或 `dacli apis list --keyword=DataInterface` 调 JNPF API
|
||||
> 详见 `dacli-ts` 技能.
|
||||
|
||||
## 触发词
|
||||
|
||||
@@ -43,37 +46,39 @@ JNPF 数据接口统一在 `data_interface` 表管理,按 `type` 字段分 3
|
||||
|
||||
## dacli 命令完整参考
|
||||
|
||||
### dacli di list — 列表查询
|
||||
### dacli di list — 列表查询 (v0.7+ 唯一子命令)
|
||||
|
||||
```bash
|
||||
dacli di list [--page=1] [--pageSize=20] [--category=<分类ID>] [--keyword=<关键字>]
|
||||
# 调 GET /api/system/DataInterface?currentPage=...&pageSize=...&category=...&keyword=...
|
||||
dacli di list [--currentPage=1] [--pageSize=20] [--keyword=<关键字>]
|
||||
# 调 GET /api/system/DataInterface
|
||||
# 返回 {code, data: {list: [...], pagination: {total}}}
|
||||
# ⚠️ v0.7+ --page 改 --currentPage
|
||||
```
|
||||
|
||||
### dacli di create — 创建接口(默认 SQL 类型)
|
||||
### ❌ dacli di create / preview (TS 版未实现)
|
||||
|
||||
```bash
|
||||
dacli di create --name=<名称> --enCode=<编码> --sql="<SQL>" [--dbLinkId=<id>|default]
|
||||
# 调 POST /api/system/DataInterface
|
||||
# ⚠️ 当前只支持 type=1(SQL),固定写入:
|
||||
# - type=1, action=3, hasPage=0, enabledMark=1
|
||||
# - dataConfigJson: {"sqlData":{"dbLinkId":"...","sql":"..."}}
|
||||
# - parameterJson: "[]" ← 需手工 update 注入参数
|
||||
# - category: "816537011182633477" (硬编码默认分类)
|
||||
# 创建 DI: 走 JNPF 后台 `低代码 → 数据接口` 手工配
|
||||
# 或写 Python 调 POST /api/system/DataInterface (见下面 payload 模板)
|
||||
#
|
||||
# 调试 DI: 走 web preview 界面 (JNPF 后台 → 数据接口 → 选接口 → 预览)
|
||||
# 或用 dacli apis 调 JNPF API + Python
|
||||
```
|
||||
|
||||
### dacli di preview — 预览接口(调试核心)
|
||||
|
||||
```bash
|
||||
dacli di preview --id=<接口ID> [--params='{"key":"value",...}']
|
||||
# 调 POST /api/system/DataInterface/{id}/Actions/Preview
|
||||
# params 自动转 paramList[]: {field, defaultValue, dataType="varchar", sourceType=3, required=0}
|
||||
# 返回 JNPF 实际执行结果(SQL 行数 / API 响应体 / 静态 JSON)
|
||||
**Python 兜底创建 DI** (按需复制):
|
||||
```python
|
||||
import requests
|
||||
r = requests.post('http://nginx/api/system/DataInterface',
|
||||
headers={'Authorization': 'bearer ' + TOKEN, 'App-Code': APP_CODE},
|
||||
json={
|
||||
'fullName': '用户分页查询', 'enCode': 'userQuery',
|
||||
'type': 1, 'action': 3, 'hasPage': 1, 'enabledMark': 1,
|
||||
'dataConfigJson': '{"sqlData":{"dbLinkId":"<id>","sql":"SELECT ..."}}',
|
||||
'parameterJson': '[{"field":"keyword","dataType":"varchar","sourceType":3}]'
|
||||
})
|
||||
print(r.json()['data']['id']) # 拿 DI id 给 form 用
|
||||
```
|
||||
|
||||
> ⚠️ `preview` 当前把每个 params key 都当 `sourceType=3`(直接传值)+ `dataType=varchar` 注入,**不支持 system variable 或 relationField**。复杂参数需 `dacli form update` 手工注入 `parameterJson`。
|
||||
|
||||
## SQL 变量(type=1 专用)
|
||||
|
||||
DI SQL 内可用 `{}` 包裹的占位符:
|
||||
|
||||
@@ -263,6 +263,6 @@ dacli dm create --table=ct_child_demo --tableName="主子表演示-子" \
|
||||
## 相关技能
|
||||
|
||||
- **`form-development`** — `dacli form create --autoTable=true` 内部调 `dm create`
|
||||
- **`data-interface`** — DI 数据接口 `dacli di create --table=X` 引用 dm 表作为数据源
|
||||
- **`data-interface`** — DI 数据接口 (TS 版 `dacli di list` 只读, 创建走 JNPF 后台或 Python 兜底) 引用 dm 表作为数据源
|
||||
- **`dacli-ts`** — 了解 dacli v0.8.1 TS 版 (22 父命令 / 80+ 子命令) 通用命令用法 + 盲点 24-27 兜底 (注: `DacliKit` 是 Java 版 v10.6 静态工具类, TS 版无对应; dbLinkId 走 `core/config.ts` 自动从 token.json 读)
|
||||
- **`basic-standards`** — 字段命名/类型规范详情
|
||||
+30
-15
@@ -6,7 +6,7 @@ type: skill
|
||||
|
||||
# 数据大屏 / 可视化门户技能(JNPF + dacli)
|
||||
|
||||
> 📦 **dacli portal 已迁移到 Picocli (2026-06-05)**:`PortalCommand` + list/create 2 个子命令。`dacli portal --help` 自动生成。详见 `dacli-ts` 技能 (TS 版, v0.7+ 替代; 本段 Java v10.6 Picocli 注释仅历史参考)。
|
||||
> 📦 **dacli portal v0.7+ (2026-06-21)**: 4 子命令 — `list / info / create / release`. TS 版 v0.7+ 还新增独立 `dacli bigscreen` 命令 (list/info/create/release), 大屏不再合并到 portal 下. 详见 `dacli-ts` 技能.
|
||||
|
||||
## 触发词
|
||||
|
||||
@@ -20,12 +20,12 @@ type: skill
|
||||
|------|----------|-----------|----------|
|
||||
| **入口 URL** | `/DataV/jnpf_app_{app_code}/` | `/DataV/jnpf_app_{app_code}/` | `/jnpf_app_{app_code}/` |
|
||||
| **主用途** | 数据监控/驾驶舱 | 多页面门户聚合 | 业务 CRUD |
|
||||
| **dacli 命令** | `dacli portal` | `dacli portal` | `dacli form` + `dacli menu` |
|
||||
| **dacli 命令 (v0.7+)** | `dacli bigscreen` | `dacli portal` | `dacli form` + `dacli menu` |
|
||||
| **type 字段** | `2` | `1` | (不适用) |
|
||||
| **数据源** | 聚合多个 DI/表单 | DI + 静态文案 | 单表 CRUD |
|
||||
| **典型场景** | 销售看板、运营监控 | OA 首页、Portal 站点 | 用户管理、订单录入 |
|
||||
|
||||
> 关键区分:JNPF 把"门户"和"大屏"合并到 `dacli portal` 一个命令下,用 `--type` 区分(1=门户,2=大屏)。
|
||||
> 关键区分 (v0.7+): **大屏 (`bigscreen`) 和门户 (`portal`)** 拆成两个独立命令. Java v10.6 把大屏合并到 portal 的 `--type=2` 已被 TS 版废弃.
|
||||
|
||||
### 大屏分类
|
||||
|
||||
@@ -35,25 +35,40 @@ type: skill
|
||||
| **移动大屏** | `App` | 手机/平板适配,响应式 |
|
||||
| **报表型大屏** | `Web` + type=2 | 财务报表/分析,表格+图表+筛选 |
|
||||
|
||||
## dacli 命令
|
||||
## dacli 命令 (v0.7+)
|
||||
|
||||
### `dacli portal list`
|
||||
### `dacli portal list` / `dacli bigscreen list`
|
||||
|
||||
```
|
||||
Usage: dacli portal list [-hV]
|
||||
获取门户列表
|
||||
```bash
|
||||
dacli portal list # 门户列表
|
||||
dacli bigscreen list # 大屏列表 (v0.7+ 独立命令, Java 版无)
|
||||
```
|
||||
|
||||
返回当前应用下全部大屏/门户的 JSON(含 `id`/`fullName`/`enCode`/`category`/`type`)。
|
||||
### `dacli portal create` / `dacli bigscreen create`
|
||||
|
||||
### `dacli portal create`
|
||||
```bash
|
||||
# portal (v0.7+: --name 改 --fullName)
|
||||
dacli portal create --fullName="OA首页" --enCode=oa_home --category=Web
|
||||
# bigscreen (v0.7+ 新)
|
||||
dacli bigscreen create --fullName="销售驾驶舱" --enCode=sales_cockpit --category=Web
|
||||
|
||||
# 必传: --fullName, --enCode
|
||||
# 可选: --category (Web/App, 默认 Web)
|
||||
# 注: portal/bigscreen TS 版不再用 --type 区分, 走两个独立命令
|
||||
```
|
||||
Usage: dacli portal create [-hV] --name=<name> --enCode=<enCode> [--category=<Web|App|Default>] [--type=<1|2>]
|
||||
--name=<name> 门户名称(必填)
|
||||
--enCode=<enCode> 门户编码(必填,英文+数字)
|
||||
--category=<Web|App|Default> 分类(默认 Web)
|
||||
--type=<1|2> 1=门户 2=大屏(默认 1)
|
||||
|
||||
### `dacli portal info` / `dacli bigscreen info` (v0.7+ 新)
|
||||
|
||||
```bash
|
||||
dacli portal info <visual_id> # 查门户详情 (含布局 schema)
|
||||
dacli bigscreen info <visual_id> # 大屏详情
|
||||
```
|
||||
|
||||
### `dacli portal release` / `dacli bigscreen release` (v0.7+ 新)
|
||||
|
||||
```bash
|
||||
dacli portal release <visual_id> --pc --app # 发布到 PC + 移动端
|
||||
dacli bigscreen release <visual_id>
|
||||
```
|
||||
|
||||
**关键 option**:
|
||||
|
||||
@@ -173,7 +173,7 @@ dacli form create --fullName=<名称> --enCode=<编码> --type=1 --webType=3 \
|
||||
# v0.7+ 修: --name 改 --fullName, --autoTable 不再是 flag (--tables 替代)
|
||||
```
|
||||
|
||||
**顺序要求**:`dacli workflow create` 必须先于 form create(否则 flowId 拿不到)。
|
||||
**顺序要求 (v0.7+ 校准)**:`dacli workflow create` (必传 --flowXml BPMN) 必须先于 form create(否则 flowId 拿不到)。也可走 `--ai "<描述>"` 让平台 LLM 自动生成 BPMN. 实际更常用: 走 web 流程设计器手工配 BPMN (TS 版 v0.7+ 没 web 端 BPMN 节点编辑能力).
|
||||
|
||||
**临时方案**:未建工作流时回退 `webType=2`(普通表单),不要用 `webType=3 + enableFlow=0`(前端会渲染工作流按钮但点击无响应)。
|
||||
|
||||
|
||||
@@ -66,12 +66,16 @@ boot/ssw-{app_code}/
|
||||
| Maven 缓存问题 | 编译失败但无错误日志 | `mvn clean` 后重试 |
|
||||
## 创建新 ssw-{app_code} 业务包 (从 aibridge 经验)
|
||||
|
||||
### 自动创建 (用 dacli codegen --generate=true)
|
||||
### 自动创建 (TS 版 v0.7+ **无 `dacli codegen`**, 走 web UI 或 `form/codegen` 子命令)
|
||||
```bash
|
||||
# ❌ TS 版 v0.7+ 没有顶层 `dacli codegen` 命令
|
||||
# ✅ 走: `dacli form codegen <formId>` (form 子命令, 自动生成后端)
|
||||
# 或走 JNPF 后台 → 在线开发 → 选表单 → 生成代码
|
||||
#
|
||||
# 1. 准备 parent pom.xml 已包含 ssw-{app_code} 模块
|
||||
# 2. 在 jnpf-admin/pom.xml 添加 controller 依赖
|
||||
# 3. 跑 dacli codegen:
|
||||
dacli codegen --formId=<表单ID> --module=ssw-{app_code} --generate=true
|
||||
# 3. 跑 dacli form codegen:
|
||||
dacli form codegen <表单ID>
|
||||
# 4. 编译:
|
||||
mvn install -pl ssw-{app_code} -am -DskipTests
|
||||
# 5. 重新构建 jnpf-admin:
|
||||
|
||||
@@ -1,11 +1,14 @@
|
||||
---
|
||||
name: workflow-development
|
||||
description: "JNPF Flowable 工作流开发:dacli workflow 6 子命令(list/create/launch/approve/reject/pending)+ 表单绑定(webType=3/enableFlow=1)+ BPMN 节点设计 + 审批链。触发词:工作流、审批、Flowable、审批链、流程发起、待办、approve、reject、launch、pending"
|
||||
description: "JNPF Flowable 工作流开发:dacli workflow 5 子命令(list/create/launch/approve/decision)+ 表单绑定(webType=3/enableFlow=1)+ BPMN 节点设计 + 审批链。触发词:工作流、审批、Flowable、审批链、流程发起、待办、approve、launch、decision"
|
||||
---
|
||||
|
||||
# 工作流开发技能(JNPF + Flowable + dacli)
|
||||
|
||||
> 📦 **dacli workflow 已迁移到 Picocli (2026-06-05)**:`WorkflowCommand` + 6 个子命令,`dacli workflow <sub> --help` 自动生成。详见 `dacli-ts` 技能 (TS 版, v0.7+ 替代; 本段 Java v10.6 Picocli 注释仅历史参考)。
|
||||
> 📦 **dacli workflow v0.7+ (2026-06-21)**: 5 子命令 — `list / create / launch / approve / decision`. `reject` / `pending` **TS 版未实现** (Java v10.6 历史命令):
|
||||
> - 拒绝 → `dacli workflow approve --status=1` (0=同意, 1=不同意, 2=退回)
|
||||
> - 待办 → `dacli workflow list --todo=1` (1=待审批 2=已审批 3=抄送)
|
||||
> 详见 `dacli-ts` 技能.
|
||||
|
||||
## 何时使用
|
||||
|
||||
@@ -44,60 +47,70 @@ description: "JNPF Flowable 工作流开发:dacli workflow 6 子命令(list/
|
||||
- **条件分支**:exclusiveGateway + 表达式(例:`${day > 3}`)
|
||||
- **会签**:parallelGateway + 多人会签
|
||||
|
||||
## dacli workflow 6 子命令
|
||||
## dacli workflow 5 子命令 (v0.7+)
|
||||
|
||||
### list — 查看工作流模板
|
||||
### list — 查看工作流模板/待办
|
||||
|
||||
```bash
|
||||
dacli workflow list # 所有模板
|
||||
dacli workflow list --category=<id> # 按分类过滤
|
||||
dacli workflow list # 所有模板
|
||||
dacli workflow list --category=<id> # 按分类过滤
|
||||
dacli workflow list --todo=1 --pageSize=20 # 我的待办 (1=待审批 2=已审批 3=抄送)
|
||||
# ❌ TS 版不支持 dacli workflow pending, 改用 --todo=1
|
||||
```
|
||||
|
||||
返回 `data.list[]`,每项含 `id`/`fullName`/`enCode`/`type`/`category`。`type=2` 简化流程,`type=1` 标准流程。
|
||||
|
||||
### create — 建工作流模板(仅元数据,不含 BPMN)
|
||||
### create — 建工作流模板
|
||||
|
||||
```bash
|
||||
dacli workflow create --name=请假流程 --enCode=qingjia --category=<id>
|
||||
# 必填: --name --enCode
|
||||
# 可选: --category --icon --description
|
||||
# 必填: --fullName, --enCode, --flowXml (BPMN XML 必传)
|
||||
dacli workflow create --fullName=请假流程 --enCode=qingjia \
|
||||
--category=<id> --flowType=2 --flowXml='<?xml version="1.0"...>'
|
||||
# 可选: --flowType (1=简易 2=标准 3=任务流 4=自由流, 默认 2)
|
||||
# --flowNodes (JSON), --flowConfig (JSON), --ai (平台 LLM 自动生成)
|
||||
|
||||
# 简化: AI 自动生成 BPMN
|
||||
dacli workflow create --ai '两级审批请假流程, 申请人→主管→HR'
|
||||
# 自动填 fullName/enCode/flowXml
|
||||
```
|
||||
|
||||
⚠️ **dacli create 只建模板元数据**,BPMN 节点(start/userTask/gateway/连线)需在 JNPF 流程设计器手工配置。
|
||||
⚠️ v0.7+ 校准:
|
||||
- ❌ `--name` 改 `--fullName`
|
||||
- ❌ 必传 `--flowXml` BPMN XML (TS 版不只建元数据, 必传 BPMN)
|
||||
- ✅ `--ai "<描述>"` 走平台 LLM 自动生成 BPMN
|
||||
|
||||
### launch — 发起流程
|
||||
|
||||
```bash
|
||||
dacli workflow launch --flowId=<versionId> --data='{"f_leave_days":3,"f_reason":"病假"}'
|
||||
# --flowId: 流程**版本**ID(不是模板ID),用 dacli workflow list 取对应版本的 id
|
||||
# --data: 表单业务字段 JSON(不含系统字段)
|
||||
dacli workflow launch --flowId=<templateId> --formId=<formId> \
|
||||
--data='{"f_leave_days":3,"f_reason":"病假"}'
|
||||
# --flowId: 流程**模板**ID (v0.7+ 用模板 id, 不是版本 id, 用 dacli workflow list 拿)
|
||||
# --formId: 绑定的表单 id (v0.7+ 必传, launch 时关联 form)
|
||||
# --data: 表单业务字段 JSON (不含系统字段)
|
||||
```
|
||||
|
||||
**后端调用**:`POST /api/workflow/task` body `{flowId, status:1, flowUrgent:1, isFlow:1, formData:{...}}`
|
||||
**后端调用**:`POST /api/workflow/task` body `{flowId, formId, status:1, flowUrgent:1, isFlow:1, formData:{...}}`
|
||||
|
||||
### approve — 审批通过
|
||||
### approve — 审批任务 (含同意/不同意/退回)
|
||||
|
||||
```bash
|
||||
dacli workflow approve --operatorId=<taskOperatorId> --opinion=同意
|
||||
# --operatorId: 从 `dacli workflow pending` 取 `data.list[].id`
|
||||
# --opinion: 审批意见(默认"同意")
|
||||
dacli workflow approve --operatorId=<taskOperatorId> --status=0 --opinion=同意
|
||||
# --operatorId: 从 `dacli workflow list --todo=1` 取 data.list[].id
|
||||
# --status: 0=同意 (默认) | 1=不同意 | 2=退回
|
||||
# --opinion: 审批意见
|
||||
# ❌ TS 版不支持 dacli workflow reject, 改用 --status=1
|
||||
```
|
||||
|
||||
**后端调用**:`POST /api/workflow/operator/Audit/{operatorId}` body `{status:1, handleOpinion, sign:""}`
|
||||
**后端调用**:`POST /api/workflow/operator/Audit/{operatorId}` body `{status, handleOpinion, sign:""}`
|
||||
|
||||
### reject — 审批拒绝
|
||||
### decision — 决策流参数 (白皮书 5.6.5)
|
||||
|
||||
```bash
|
||||
dacli workflow reject --operatorId=<taskOperatorId> --opinion=不同意
|
||||
# status=2 区别于 approve 的 status=1
|
||||
dacli workflow decision --list # 列所有模板, 标记是否含决策流节点
|
||||
dacli workflow decision <templateId> # 查某模板的决策流参数 (漏斗/覆盖/规则集/评分卡/交叉表/异常)
|
||||
```
|
||||
|
||||
### pending — 查询我的待办
|
||||
|
||||
```bash
|
||||
dacli workflow pending --page=1 --pageSize=20
|
||||
# 返回 data.list[] 含 id (operatorId) / fullName / flowName / createTime
|
||||
```
|
||||
❌ TS 版新增, Java v10.6 无.
|
||||
|
||||
## 实战场景
|
||||
|
||||
|
||||
Reference in new issue
Block a user