weaver-e10-builder 1.5.12 → 1.5.14

package/skill-docs/references/form/guide-form-archive-permission.md

@@ -85,14 +85,17 @@ e10-cli form permission archive card <workflowId> <appId> --set 1
 取值字段决定**用矩阵里的哪一列**去匹配当前用户，必需，且取值来源分两种：
 
 - **真矩阵**（`--matrix`）：值字段自动取该矩阵的值字段配置；也可用 `--matrix-value 名称` 指定其中几个。
-- **e-Builder 表单**（`--eb-form`）：取值字段是**系统值**体系，不是矩阵的值字段配置。
-  目前只有「创建者」可直接用名称指定；其余取值请用 `--matrix-value <id>:<名称>:<valueType>` 明写，
-  或用 `--matrix-value-raw '<JSON 数组>'` 整体透传（数组元素形状以设计器实际请求为准）。
+- **e-Builder 表单**（`--eb-form`）：候选来自**该表单自己的字段**（与设计器字段选择器一致）：
+  - **创建者**（系统值，`valueType=system_creator`）
+  - **人员 / 部门 / 人员范围 / 人员条件 / 人员组织**类型的字段；其中人员字段（Employee）`valueType=resource`
+  - 可直接按字段名指定，如 `--matrix-value 负责人`；其余仍可用 `<id>:<名称>:<valueType>` 明写，
+    或用 `--matrix-value-raw '<JSON 数组>'` 整体透传
 
 ### 矩阵相关的「条件」
 
 矩阵相关比另外三类多一层**条件**：拿矩阵自己的**条件列**去比「固定值」或「本表单字段」，只有命中的行才生效。
 落库是行报文里的 `matrixConditionData`（一棵条件树的 JSON 串）。
+真矩阵的条件列来自矩阵配置；**e-Builder 表单的条件列就是它自己的主表字段**（自动从字段表取）。
 
 ```bash
 # 一条：所属门店 等于 固定值
@@ -105,13 +108,30 @@ e10-cli form permission archive card <workflowId> <appId> --set 1
 --matrix-condition '{"column":"所属门店","func":"等于","value":"上海门店"}' \
 --matrix-condition '{"column":"所属门店","func":"不属于","value":"临时门店"}' \
 --matrix-condition-relation or
+
+# e-Builder 表单当矩阵：负责人 不为空
+e10-cli form permission archive add <objId> <appId> --workflow <workflowId> \
+  --target matrix --eb-form 项目任务 \
+  --matrix-value 负责人 \
+  --matrix-condition '{"column":"负责人","func":"不为空"}' \
+  --rights view
+
+# e-Builder 表单当矩阵：所属项目 = 当前记录（「当前项目信息」）
+e10-cli form permission archive add <objId> <appId> --workflow <workflowId> \
+  --target matrix --eb-form 项目任务 \
+  --matrix-value 负责人 \
+  --matrix-condition '{"column":"所属项目","func":"等于","field":"数据ID"}' \
+  --rights view
 ```
 
+> 「当前记录」用本表单的系统字段 **数据ID**（`field:"数据ID"`，即 `id=5`）表示，不要写固定值。
+> 关联列（Ebuilder）引用数据ID 是设计器实证的跨类型例外（关联列按字符串比）。
+
 | 参数 | 说明 |
 |---|---|
 | `--matrix-condition <json>` | 一条条件，**可重复**；也可 `@文件` 给一个数组。对象三件套：`column`（条件列的 id 或列名）+ `func` + 右值 |
 | `--matrix-condition-relation` | 条件之间的关系：`and`=所有（默认）/ `or`=任一 |
-| `--matrix-condition-comp-type` | 条件列的组件键。**列类型的组件键目前只实证了「部门」→`Department`**，其余类型（人员/分部/岗位/客户/项目/自定义浏览框）命令会报错要求显式给 |
+| `--matrix-condition-comp-type` | 条件列的组件键。**仅真矩阵需要**（列类型的组件键目前只实证了「部门」→`Department`，其余类型会报错要求显式给）；e-Builder 表单由字段类型自动取 |
 | `--matrix-condition-raw <json>` | 整棵树透传（不做校验），形状以设计器请求为准 |
 
 **右值三选一**：
@@ -125,6 +145,7 @@ e10-cli form permission archive card <workflowId> <appId> --set 1
 > ① **算子只能是「等于」**；② **字段类型必须与条件列一致** —— 部门列只能引用部门类型的字段，
 > 文本字段在设计器里根本选不到。所以「所属门店（部门）等于 [创建人部门]」成立，
 > 「所属门店（部门）等于 [名称（文本）]」和「所属门店 不等于 [创建人部门]」都会报错。
+> 例外：关联列（Ebuilder）可以引用本表单的 **数据ID**（当前记录），用于「所属项目 = 当前项目信息」这类限定。
 
 算子只有界面下拉那 6 个：**等于 / 不等于 / 属于 / 不属于 / 为空 / 不为空**（`eq` / `neq` / `aggregate` / `unaggregate` / `empty` / `nempty`）。
 其中**只有「等于」是对着真机报文核实的**，其余 5 个是按同一族条件树的码表推的 —— 内容平台会原样存下、回读也一模一样，
@@ -132,7 +153,7 @@ e10-cli form permission archive card <workflowId> <appId> --set 1
 
 两条限制：
 
-- **`--eb-form` 不能配条件** —— e-Builder 表单当矩阵用时没有条件列，给了会直接报错。
+- **e-Builder 表单也能配条件** —— 条件列取自该表单自己的主表字段，不需要 `--matrix-condition-comp-type`。
 - **右值不能引用明细表字段**（只支持主表字段）。
 
 台账那边的矩阵权限（`form list-permission --add-matrix`）**同一套参数与语义**。
@@ -143,10 +164,12 @@ e10-cli form permission archive card <workflowId> <appId> --set 1
 
 | 编号 | 别名 | 含义 |
 |---|---|---|
-| 5 | `view` / `read` | 归档查看 |
+| 5 | `view` / `read` | 归档查看（**系统必选**） |
 | 6 | `edit` / `update` | 归档编辑 |
 | 7 | `delete` | 归档删除 |
 
+> **归档查看是系统默认勾选、界面上不能取消的**。所以 `--rights` 只写 `edit delete` 时，命令会自动把 `view` 并进去（5,6,7），并在输出里提示。
+
 归档附件权限 `--file-rights`（与上面的查看/编辑/删除**互相独立**，是另一处勾选）：
 
 | 编号 | 别名 | 含义 |

package/skill-docs/references/form/guide-form-formula-functions.md

@@ -1,5 +1,16 @@
 # 字段函数公式大全（平台 funcList）
 
+## 查询当前环境的函数
+
+```bash
+e10-cli form formula functions
+e10-cli form formula functions --category 逻辑函数
+e10-cli form formula functions --scene form-view-linkage --category 逻辑函数
+e10-cli --json form formula functions
+```
+
+`functions` 实时查询当前环境的 `/api/excel/formula/funcList`；`--category` 按分类名称筛选，`--json` 输出查询结果的完整数据。配置显示属性联动的函数条件时**必须加** `--scene form-view-linkage`，按该场景的前端编辑器规则筛除未开放的函数（如 `NOTEMPTY`；可用 `NOT(ISEMPTY(...))`）。通用列表中的 `DAYS` 等函数不一定在显示属性联动场景开放；新增或修改该联动时，CLI 会用专用列表预检查函数，未列出则拒绝写入。本页是函数格式与示例的通用静态参考，实际编写公式时先按使用场景查询当前环境，再结合函数格式确认用法。
+
 > 来源：平台公式函数目录，共 **219 个函数**，11 类。写 `fields.json` 的 `formula` 或 `form formula set --expression` 时查这里。
 > 引用字段语法：`{主表.字段名}` / `{明细表名.字段名}`；**日期差用 `DAYS(开始,结束)`**（相减不生效）。
 >

package/skill-docs/references/form/guide-form-layout-incremental.md

@@ -63,6 +63,34 @@ FLOW 布局**没有** `config.workbook`（它靠 `config.flow.parent` / `nodes`
 1. 先在设计器里手工加一个同类型字段（它就成了可参照的样板），再重跑命令；
 2. 确认这张表是自己建的、不在乎版式被重排 → 显式加 `--reinit`。
 
+## 追加明细表：默认增量放进布局
+
+给已有表单加明细子表用 `e10-cli form add-detail-table`。**默认会把这明细表放进现有布局**，和加字段一样不重建：
+
+```bash
+e10-cli form add-detail-table <objId> <appId> "费用明细" "费用类型"
+```
+
+- 子表必须是**有字段**的（命令会顺带建首字段）；空子表平台不返回，放不进布局。
+- 只想建表、布局自己排：加 `--no-place`。
+- `--init` 是另一条路：整表重建（换样式模板、重排位置），只在布局本来就是自己建的、不在乎版式时用。
+
+实现上不碰原布局的 initLayout：复制一套临时布局 → 在副本上让平台生成明细容器与子字段组件 → 摘出这一块 → 删除副本 → 合并进原布局。原布局里已有的行列、合并格、样式都保留，明细表落在主表字段下方。
+
+放好之后，往这张明细里加字段照常用：
+
+```bash
+e10-cli form add-field <objId> <appId> "金额" Number --sub-form-id <subFormId>
+```
+
+已经建好、但还没进布局的明细表（例如当时用了 `--no-place`），单独放进去：
+
+```bash
+e10-cli form layout add-detail-table <objId> <appId> <subFormId|明细表名>
+```
+
+命令幂等：已经在布局里时直接提示，不重复添加。FLOW 布局也支持（明细字段挂在容器内的 `InternalContainer` 画布下）。
+
 ## 哪些 id 可以自己生成，哪些必须由平台发号
 
 这一条最容易踩：**编一个 id 不会报错**，而是在之后某个看不出来的环节静默失效。

package/skill-docs/references/form/guide-form-layout-planning.md

@@ -67,6 +67,17 @@ e10-cli form layout read <objId>
 
 创建后需要调整局部位置或显示属性时，使用 `form layout` 下的移动、只读和必填设置命令；具体参数通过 `form layout --help` 查询。
 
+## 将已有布局另存为模板
+
+需要复用一套实际 **PC 流式布局**的样式时，先确定其布局 ID，再执行：
+
+```bash
+e10-cli form layout save-as-template <objId> --view-id <布局ID> --name <模板名>
+e10-cli form layout save-as-template <流程表单formId> --module workflow --view-id <布局ID> --name <模板名>
+```
+
+此操作从指定布局读取 `formStyle` 并创建流式样式模板，默认禁用；需要立即可选用时加 `--enabled`。业务字段和布局组件不会一起保存。表格式布局不能用这条命令直接另存；模板的其他操作见[布局样式模板总览](form-template/style-templates.md)。
+
 ## 图片与 Excel 源样式还原
 
 明确要求保留原样表的合并、留白、尺寸、静态文字和样式时，使用[源样式还原指南](guide-form-layout-source.md)。字段解析、创建及业务配置仍由 CLI 完成；布局模块在全部字段补写和归组结束后，将源网格绑定到已存在的字段与组件，编译 pageLayouts，再单次保存并独立回读。

package/skill-docs/references/form/guide-form-layout-source.md

@@ -199,6 +199,10 @@ LayoutSpec 可增加 details，必须使用真实 subFormId。anchor 是主表
 
 保留明细系统配置、按钮和结构行。只把源字段标题和值样式投影到既有明细列，并按源尺寸调整业务列及相关行；字段 ID、dataKey 和业务选项等保持原样。
 
+明细的 `columnCount` 表示逻辑列容量，`columns` 表示显式列配置，平台可能省略尾部默认列，因此两者不必相等。例如 6 个业务字段加 2 个系统列，允许 `columnCount=10`、`columns.length=8`；原生容量与默认列表示原样保留，不增加业务字段凑数，也不擅自填充无引用的列配置。数字字符串容量可兼容读取；单元格和合并范围必须位于容量内，实际承载业务字段的列必须有可用的列配置。缺系统控件、越界、业务列配置缺失仍会阻断，不能简单放开校验或缩小容量绕过。
+
+“八类标准系统控件”指按钮、勾选、序号等不同系统控件类型，不是要求 8 个业务字段。明细值区域是可重复展示数据的模板，不限制运行态只能一条记录。截图中的多条示例数据需与字段/布局分开确认；未绑定静态内容的保护继续保留，真实业务记录应另外处理数据，不能直接删除或新增字段冒充。
+
 ## 与创建命令衔接
 
 独立建好字段后执行还原，是推荐的可审阅路径。需要串联时，form create 支持：