weaver-e10-builder 1.6.6 → 1.6.8

package/skill-docs/references/form/guide-form-linkage.md

@@ -12,6 +12,8 @@
 
 其他模块虽可能共用表单引擎前端组件，但尚未核对对应的保存报文与接口前缀，不按以上任一模块代填。
 
+**流程绑的是 EB 卡片表单（`formTypeName` 为「ebuilder卡片」）时，走 EB 那条路。** 这时 `wf-form linkage`（原生流程表单路由）的 getConfig 只返回系统字段，业务字段一个都读不到，配置里的字段名也匹配不上；应改用 `form linkage <appId> <objId>`。定位方式：先 `e10-cli workflow info <workflowId>` —— 它给出 formId 与表单类型，并对 EB 卡片流程直接解出 `appId` / `objId`（`--json` 时在 `form.appId` / `form.objId`），可按它输出的示例命令直接执行。`wf-form linkage` 传了 `--workflow-id` 时会自行判定，遇到 EB 卡片表单会明确提示改用哪条命令和哪组 ID，不会停在「字段未找到」。
+
 非 EB 表单的简单条件与字段目标可用统一命令：
 
 ```bash
@@ -122,17 +124,23 @@ e10-cli form linkage delete <appId> <objId> <规则ID>
 | sourceFieldId | 以另一个表单字段的值作右值，走 `VARIABLE`，与常量值二选一 |
 | sourceContent | 人员、日期等结构化常量对象，直接编码为平台 `sourceContent`；与 `value/options` 二选一 |
 
-比较符：
+比较符（**只有这 7 个能真正写进联动**）：
 
-| 写法 | 含义 | 备注 |
+| 写法 | 含义 | 可接受的等价写法（命令自动归一） |
 |------|------|------|
-| `EQUAL` / `NOT_EQUAL` | 等于 / 不等于 | |
-| `CONTAIN` / `NOT_CONTAIN` | 包含 / 不包含 | |
-| `GREATER` / `LESS` / `GREATER_EQUAL` / `LESS_EQUAL` | 大于 / 小于 / 大于等于 / 小于等于 | |
-| **`NULL`** | **为空** | 也可以写 `EMPTY` / `IS_NULL`，命令会归一成平台码 |
-| **`NOT_NULL`** | **不为空** | 也可以写 `NOT_EMPTY` / `IS_NOT_NULL` |
+| `EQUAL` | 等于 | `=` `==` `EQ`；`等于` |
+| `GREATER` / `LESS` | 大于 / 小于 | `>` `<`（以及 `GT` `LT`）；`大于` / `小于` |
+| `GREATER_EQUAL` / `LESS_EQUAL` | 大于等于 / 小于等于 | `>=` `<=`（以及 `GE` `LE`）；`大于等于` / `小于等于` |
+| **`NULL`** | **为空** | `EMPTY` / `IS_NULL` / `ISNULL`；`为空` |
+| **`NOT_NULL`** | **不为空** | `NOT_EMPTY` / `NOTEMPTY` / `IS_NOT_NULL`；`不为空` |
+
+**「不等于 / 包含 / 不包含」不在联动引擎的支持范围内。** `NOT_EQUAL`、`CONTAIN`、`NOT_CONTAIN` 提交后平台一定在写库时失败（`Error updating database … NullPointerException`，EB 路由与流程表单路由、文本与数字字段都一样，已逐条验证）。需要这类判断时改用 **Boolean 公式**：
+
+```json
+{ "formula": "NOT({主表.员工姓名}==\"张三\")", "actions": [{ "prop": "hide", "fields": ["基本薪资"] }] }
+```
 
-**「为空」的算子写错，报错会指向完全无关的地方。** 平台不认 `EMPTY` 这类写法时不会说「算子不合法」，而是在写库时抛一句 `mybatis PersistenceException / Error updating database` —— 容易让人误判成字段配置问题（真实发生过：被当成「目标字段 `dataKey` 为空导致 NOT NULL」去查，而 `dataKey` 留空本身是没问题的）。用 `NULL` / `NOT_NULL`，或者写 `EMPTY` 交给命令归一。
+**未知算子与上述不支持算子都会在本地被拒绝，不会发到平台。** 平台不会说「算子不合法」，只会抛一句与配置无关的写库异常，很容易被误判成字段配置问题；命令会在提交前报出算子名、可用清单，并对「不等于 / 包含」提示改用公式。
 
 触发字段可以是主表或明细表字段，也可包含平台返回的系统字段 ID。主表触发控制明细字段时，目标整列变化；明细字段触发本表同一行的目标字段时，按行变化。明细字段触发主表或其他明细表目标时，任意一行满足即可触发。复杂值类型先从现有字段和选项读回真实 ID，不猜测。
 

package/skill-docs/references/form/layout/workflow-layout.md

@@ -23,6 +23,51 @@ e10-cli wf-form layout init-reviewed <formId> --layout-id <布局ID> --style-tem
 
 不传 `--layout-id` 时处理默认布局。当前审阅式模板应用只支持 PC；移动端仍按现有布局初始化和编辑能力操作。此命令会重建目标布局，应用后仍需检查实际页面；`templateEffectVerified` 不代表浏览器最终呈现已核对。公文流程使用同一原生流程表单 `formId` 和上述命令，其公文专属设置另行维护。
 
+修改布局名称或描述使用 `wf-form layout rename`。布局内容、引用节点和默认设置都保持不变，不需要删掉重建：
+
+```bash
+e10-cli wf-form layout rename <formId> <布局ID或名称> --name "新名称" --describe "用途说明"
+```
+
+`--name`、`--describe` 至少给一个；不传的那项保持原值。按名称定位时若同名多套会报歧义并列出 ID。**默认布局也可以改名** —— 布局列表里它的 `isSys`/`readOnly` 为 true 是平台常态，不代表不能改。原生流程表单与 eb 表关联流程的表单都适用：传 `--workflow-id`，命令按工作流自动判定走哪套接口。命令写完回读布局列表，确认名称与描述落库，且终端、布局类型、默认标记没有被一起改掉。
+
+把某套布局设为默认：
+
+```bash
+e10-cli wf-form layout set-default <formId> <布局ID或名称>
+```
+
+默认布局是**表单维度**的，PC 与移动端各自一套；终端按目标布局自身判定，不用额外指定。原生流程表单与 eb 表关联流程的表单都适用：传 `--workflow-id`，命令按工作流自动判定走哪套接口。尚未单独绑定布局的节点都读默认布局，切换后它们会一起换到新布局。目标本来就是默认时命令不做改动；写完回读确认它是默认，且同终端没有第二套默认。
+
+## 往布局里摆流程系统字段
+
+流程系统字段（提交人、流程编号、流程状态等）可以直接摆进指定布局，字段写中文名、key 或组件类型都行：
+
+```bash
+e10-cli wf-form layout add-system-field <formId> 提交人 流程编号 流程状态 --layout-id <布局ID>
+e10-cli wf-form layout add-system-field <formId> --all          # 目录里的全部字段
+```
+
+不传 `--layout-id` 就加到 PC 默认布局；`--single-row` 让新增字段各占一行。**已经在该布局里的字段自动跳过**，重复执行不会重复添加、也不会打乱原有组件顺序。写的是整份布局，完成后会回读确认新字段在、原有组件一个没少。
+
+| 字段 | key | 组件类型 | 样式 |
+|---|---|---|---|
+| 流程标题 | `REQ_REQUEST_NAME` | `FlowPageSysFieldReqName` | 可输入 |
+| 流程编号 | `REQUEST_NO` | `FlowPageSysFieldMarkReserved` | 只读 |
+| 紧急程度 | `REQUEST_LEVEL` | `FlowPageSysFieldRequestlevel` | 可输入 |
+| 密级 | `REQUEST_SECRET_LEVEL` | `FlowPageSysFieldSeclevel` | 可输入 |
+| 提交人 | `CREATE_USER` | `FlowPageSysFieldCreator` | 只读 |
+| 提交人部门 | `CREATE_DEPT` | `FlowPageSysFieldCreatorDept` | 只读 |
+| 提交人分部 | `CREATE_SUB` | `FlowPageSysFieldCreatorSubCompany` | 只读 |
+| 提交时间 | `CREATE_DATETIME` | `FlowPageSysFieldCreateTime` | 只读 |
+| 结束时间 | `FINISH_DATETIME` | `FlowPageSysFieldFinishTime` | 只读 |
+| 到期时间 | `FlowPageSysFieldExpiryTime` | `FlowPageSysFieldExpiryTime` | 可输入 |
+| 打印次数 | `PRINT_COUNT` | `FlowPageSysFieldPrintCount` | 只读 |
+| 工作流名称 / 类型 / 描述 | `WORKFLOW_NAME` / `WORKFLOW_TYPE` / `WORKFLOW_DESC` | `FlowPageSysFieldWorkflowName` / `Type` / `Desc` | 只读 |
+| 流程状态 | `FLOW_STATUS_COMP` | `FlowPageFlowStatus` | 无内容 |
+
+原生流程表单与 eb 表关联流程的表单都适用：传 `--workflow-id`，命令按工作流自动判定走哪套接口。
+
 删除指定流程表单布局使用：
 
 ```bash

package/skill-docs/references/workflow/guide-workflow-node-layout.md

@@ -2,7 +2,7 @@
 
 > **命令**：`e10-cli workflow node layout list | get | bind | unbind | create`
 > **同族功能**：`e10-cli workflow node field-permission`（节点字段权限）
-> **相关**：`wf-form layout add` / `wf-form layout delete`（表单自己的多套布局）
+> **相关**：`wf-form layout add` / `wf-form layout rename` / `wf-form layout delete`（表单自己的多套布局）
 
 表单布局的新增、初始化与节点引用如何衔接，先读[流程表单布局与节点独立布局](../form/layout/workflow-layout.md)；本篇保留节点绑定的详细规则。
 
@@ -101,7 +101,8 @@ e10-cli workflow node layout init <workflowId> <布局ID> --fields 报销单号
 字段名写错会**直接报错并列出可用字段**，不会闷头建出一套空布局。
 `--list-fields` 可以先看清单。
 
-删除布局用 `wf-form layout delete <formId> <layoutId>`。
+删除布局用 `wf-form layout delete <formId> <layoutId>`；只改名称或描述用 `wf-form layout rename <formId> <布局ID或名称> --name <新名>`，不必删掉重建。
+换默认布局用 `wf-form layout set-default <formId> <布局ID或名称>`（PC / 移动端各一套，未单独绑定布局的节点跟着切换）。
 
 ---