weaver-e10-builder 1.6.11 → 1.6.13

package/skill-docs/references/report/drilldown-report-guide.md

@@ -40,6 +40,21 @@
 **★ 逆引用硬门禁（A0.11）**：列表数据带左父格链（引用列 ≤ 链接列）。引用右侧列 → 构建**直接抛错不落库**
 （静默失效无报错，历史血案）。要传行内任意列 → 把链接列放**最右**（demo 的「导出明细」列即最右）。
 
+### 接收端：目标报表的查询条件（强制 · 2026-11-03 实测）
+
+链接参数**不会**自动过滤目标报表。目标报表里必须有对应条件，且默认值写成「自定义 + `{参数名}`」：
+
+| 键 | 值 |
+|---|---|
+| `defaultValueType` | `"custom"` |
+| `defaultValue` / `type2DefaultValue` | `'["{searchfield002}",""]'` |
+
+- URL 的参数名 = `{…}` 里的名字（通常与条件标识 `searchfield00x` 相同）。
+- 设计器「默认值」框显示为 `(searchfield002)`，圆括号只是 UI 渲染，落库是花括号。
+- 保持「常规 / 空」→ 参数被**静默忽略**：页面能打开、不报错、数据一条不少。
+- 不带参数打开目标报表时，占位会被清空，不会残留字面量。
+- 落地后跑 `e10-cli report verify drill <来源报表> --app-id <id>` 验收；缺绑定会失败并给出修法。
+
 ## 三、能力边界（如实告知用户）
 
 | 效果 | 结论 |
@@ -56,4 +71,5 @@
 > 无限层次（订单→明细→产品）逐层建表互联。用 `e10-cli report build spec` 一次落库，回读验收 pcHreflink/orderType。
 
 **验证**：回读 `dump cells` 或 `getReportDevInfo`，核对 `pcHreflink`（占位/坐标/ASCII ?）与 `orderType`；
-渲染验证占位已替换为真实值（event-hreflink-guide §3.0，配置层正常 ≠ 运行时穿透）。
+渲染验证占位已替换为真实值（event-hreflink-guide §3.0，配置层正常 ≠ 运行时穿透）；
+接收端跑 `e10-cli report verify drill <来源报表> --app-id <id>`，确认每个 URL 参数都被目标条件的自定义默认值接住。

package/skill-docs/references/report/event-hreflink-guide.md

@@ -157,6 +157,7 @@ https://www.baidu.com/s?zclb=D7&zcmc=E7&cx={searchfield001}
 2. 链接中写 `{searchfield00x}`，预览时替换为用户当前查询值。
 3. 也可在表头 Const 的 `cellText` 中引用同一标识显示查询值。
 4. 系统参数（如 `{userid}`、`{date}`、`{year}`）亦可出现在链接中（`DynamicParamsBuilder`）。
+5. **报表跳报表时，接收端要配条件**：目标报表的查询条件必须用「自定义」默认值 `'["{searchfield00x}",""]'` 声明同名参数，否则 URL 参数被静默忽略（页面正常、数据不过滤）。参数名以 `{…}` 里为准，链接 key 必须与之一致。详见 `query-condition-api-guide.md` §5.3，落地后用 `report verify drill` 验收。
 
 示例：
 
@@ -205,6 +206,7 @@ https://www.baidu.com/s?zclb=D7&zcmc=E7&cx={searchfield001}
 - [ ] ★ **逆引用自检**：每个占位坐标都落在「该格自身 + 左/上父格链」内（引子格/旁系格 = 静默失效）
 - [ ] ★ **渲染验证**：渲染后读 `cellType.hreflink`，确认占位已替换为**真实值**（配置层看不出问题）
 - [ ] 传查询条件：`{searchfield00x}`，asNameIndex 已对齐
+- [ ] ★ 报表跳报表：目标条件的自定义默认值已声明 `{参数名}`（`report verify drill` 通过）
 - [ ] 参数名避免 `id`/`name` 等系统关键字
 - [ ] PC/H5 分端：移动需要时填 `h5Hreflink`
 - [ ] 双写 fields + workbook；`safe_report_save` / fieldToCell 不丢链接键

package/skill-docs/references/report/query-condition-api-guide.md

@@ -809,6 +809,35 @@ function inferQueryDisplay(text, fieldMeta) {
 2. 默认值 → 填 `{thismonth}`、`{date}` 等（设计器存为 JSON 数组）
 3. 日期区间 + **启用选项** ON → 21 项快捷按钮（§四）
 
+### 5.3 跨报表传参：目标条件的默认值（报表跳报表 · 2026-11-03 实测）
+
+来源报表把参数拼在钻取地址上：
+
+```text
+/sp/edc/report/view/<目标报表>?searchfield002=13261367755986572676
+```
+
+目标报表**不会**按参数名自动过滤。要接住它，目标报表的查询条件必须把参数名写进「自定义默认值」：
+
+| 键 | 值 |
+|---|---|
+| `defaultValueType` | `"custom"` |
+| `defaultValue` | `'["{searchfield002}",""]'` |
+| `type2DefaultValue` | 同上；`type1DefaultValue` 置空 |
+
+设计器「默认值」框里显示成 `(searchfield002)` —— **圆括号只是 UI 渲染，落库必须是花括号**。
+
+运行时：
+
+- 请求里带同名字段 → `handleDefaultValue` 变成传入值（如 `["江苏EBU一部",""]`），报表按它过滤；
+- 不带 / 传空 → 占位清空成 `["",""]`，直接打开报表不过滤。
+
+⚠️ 条件保持「常规 / 空」时，URL 参数会被**静默忽略**：页面能打开、不报错、数据一条不少。这是钻取不过滤最常见的原因。
+
+- **参数名以 `{…}` 里的名字为准**，链接的 key 必须与它一致；通常就是条件标识 `searchfield00x`。
+- 日期区间用 `{searchfield001_start}` / `{searchfield001_end}`，URL 参数名同名。
+- 体检：`e10-cli report verify drill <来源报表> --app-id <id>` —— 扫来源链接、读目标条件，缺绑定直接失败并给出修法。
+
 ---
 
 ## 六、EBU 报表示例（三条高级搜索 + 数据集行级筛选）

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

@@ -0,0 +1,26 @@
+# 流程布局系统字段、签字意见、拟签控件
+
+在从图片/文字形成布局和建字段计划之前，对每个控件调用 `workflow layout-component classify --data '{"title":"...","description":"该控件自身的描述"}'`。
+必须先分流，再创建普通字段；`createPhysicalField:false` 的结果禁止送入 form/wf-form 物理字段新增命令。不能把相邻“拟签意见”标题或整页描述复制为每个控件的描述。
+
+- 提交人、提交人分部、提交人部门、提交时间、结束时间（需求图中蓝色区域所指类别）仅描述明确带“流程系统字段”才识别为系统字段，不依赖截图像素颜色。
+- 工作流名称、工作流类型、工作流描述、流程标题、流程编号、紧急程度、密级、流程状态、签字意见：描述与标题对应时默认系统控件。
+- “不使用”“不作为流程系统字段”等否定说明优先，返回 custom-field（这不是隐藏布局的 display=false）。
+- 意见输入框识别为 FlowPageSignInput，不是拟签，也不是 NodeRequestLog。
+- 拟签意见/拟签控件仅按自身描述识别 FlowPageDraftOpinion；1级审批、领导审批等标题本身不能推断为拟签。
+
+已有布局的真实类型按 comp.type 判定，不因标题相同就把已有自定义字段转为系统字段。
+`form layout describe` 的 workflowComponents 会独立输出系统/签字/拟签组件，普通字段列表不再混入这些组件。
+
+```bash
+e10-cli workflow layout-component classify --data '{"title":"提交人","description":"提交人（流程系统字段）"}'
+e10-cli workflow layout-component get <workflowId> --layout-id <layoutMultiId>
+e10-cli workflow layout-component ensure-draft <workflowId> --layout-id <layoutMultiId> --title '拟签意见' --description '拟签控件' --row 16 --col 3
+# 新建返回 widgetId 后按现有能力修改业务配置
+e10-cli workflow draft-opinion update <workflowId> --widget-id <widgetId> --data '{"opinionType":"1"}'
+```
+
+ensure-draft：仅原生流程独立EXCEL布局，位置为0起始；先查当前终端页面，已有同标题拟签则复用并校验业务记录，不修改位置/配置；重名阻断。缺失才读取程序默认配置、分配业务ID、插入组件并保存，不创建物理字段。不要通过clone复制他人的widgetId或直接复制拟签config。
+现有范围：系统字段本次补识别与查询；不提供系统字段自动插入。拟签新增支持PC/MOBILE中存在的EXCEL页；FLOW及EB桥接新增尚未接入，明确报错。创建后高级配置复用draft-opinion，人员范围子弹窗限制仍适用。
+
+节点意见控件现已接入：描述包含节点意见/流转意见/意见放表单且指定节点范围，识别为NodeRequestLog；缺范围返回requiresConfirmation，不建字段。使用独立 workflow node-opinion 命令，详见[guide-node-opinion.md](guide-node-opinion.md)。

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

@@ -0,0 +1,58 @@
+# 节点意见 / 流转意见 / 意见放表单
+
+命令组：`e10-cli workflow node-opinion`。与拟签 draft-opinion、签字意见输入框不同：这是展示已有流转意见的 NodeRequestLog 控件，不创建物理表字段。
+
+## 布局识别与创建
+
+截图/模板先逐单元格调用 `workflow layout-component classify --data '{"title":"审批意见","description":"节点意见：1级审批，2级审批"}'`。
+结果 `createPhysicalField:false` 不允许送入普通建字段命令。只有描述明确包含节点意见/流转意见/意见放表单/意见展示控件时才分流；没有节点范围返回 requiresConfirmation=true，必须询问用户，禁止猜测全部节点。节点完整名称或字符串ID唯一匹配，缺失/重名停止，由用户确认。
+
+```bash
+e10-cli workflow node-opinion nodes <workflowId>
+e10-cli workflow node-opinion get <workflowId> --layout-id <layoutMultiId>
+e10-cli workflow node-opinion ensure <workflowId> --layout-id <layoutMultiId> --title '审批意见' --description '节点意见：1级审批，2级审批' --row 17 --col 0
+```
+
+row/col从0开始。已有同名控件唯一时复用并合并描述/显式参数，位置不移动；不存在才创建。仅支持原生工作流独立EXCEL布局，PC/MOBILE须实际有对应页面；不会隐式复制默认布局。不覆盖已有单元格。单个当前流程节点自动使用单节点身份nodeId_<ID>，页面显示节点实际名称；多个节点、主子流程或全部节点使用通用控件。已有单节点控件不能改成其他节点/主子流程；应创建通用控件。
+
+描述可用分号附加：`自定义设置；最后一次意见；2栏；不显示空意见；意见按批次分组；操作时间正序；显示内容：处理意见，操作人；意见显示范围：本部门`。
+显示范围描述支持本部门/本分部/本人，保存后独立添加该过滤行，已有同类型行不重复添加；复杂组织范围用range命令。未识别的附加描述停止，要求明确为参数。图外说明同样按这些参数转换，不能遗漏后直接宣称全部识别。
+
+## 配置修改
+
+```bash
+e10-cli workflow node-opinion schema <workflowId>
+e10-cli workflow node-opinion update <workflowId> --layout-id <layoutMultiId> --component-id <布局组件UUID> --data @patch.json
+```
+
+允许字段：
+- title、isHideTitle：布局标题/隐藏标题。
+- workflowOption：0当前、1主流程、2子流程，可使用中文选项；selectedWfid：真实关联流程ID（get返回mainWorfklowIds/subWorfklowIds）。切换主子流程须显式指定节点范围；关联不存在则停止。
+- nodescopeType：0全部、1选择、2排除、3自由节点；nodeScopeBrowser：完整节点名或ID数组。指定数组自动使用选择模式，排除需显式nodescopeType=2。
+- patternOption：0指定节点、1分组左右结构、2分组上下结构；selectedPattern：-1节点、-2部门、-3分部。意见模板分组(-4)暂不支持切换，已有配置仍保留。
+- isDefaultConfig：1读取当前参与身份节点的默认格式，0自定义；修改格式字段必须明确选择0。
+- viewTypeSelect：0全部操作类型、1选择、2排除；viewTypeDto：操作类型名称或ID数组，以schema/实际返回为准。
+- selectFormat：0默认格式、1自定义格式；viewContents：显示内容中文名或ID数组；showDesc/signShowDesc：设计器富文本JSON对象或JSON字符串，保留value/json结构。
+- showType：0每人每节点最后一次意见、1全部；showColumn：1—4；notShowEmpty、isGroup：布尔值。
+- showorder：按顺序排列的`[{"id":"4","order":"desc"}]`；1人员显示顺序、2安全级别、3操作类型、4操作时间、5节点。单节点不能按节点排序。groupOrderType：分组排序0正序、1倒序、2时间正序、3时间倒序。
+
+创建未指定项读程序默认值。修改先读取业务配置及布局，只合并指定部分。componentId、componentKey、业务表id不能互换。重复保存仍核对原控件和业务配置，不只验证HTTP成功。
+
+## 意见显示范围
+
+```bash
+e10-cli workflow node-opinion range-schema <workflowId>
+e10-cli workflow node-opinion range-get <workflowId> --layout-id <layoutId> --component-id <uuid>
+e10-cli workflow node-opinion range-add <workflowId> --layout-id <layoutId> --component-id <uuid> --data '{"objtype":"本部门"}'
+e10-cli workflow node-opinion range-update <workflowId> --layout-id <layoutId> --component-id <uuid> --rule-id <范围行ID> --data '{"objtype":"本分部"}'
+e10-cli workflow node-opinion range-delete <workflowId> --layout-id <layoutId> --component-id <uuid> --rule-id <范围行ID>
+```
+
+类型按range-schema真实选项，支持本部门/本分部等相对类型，指定人员person、部门dept、分部subDept、角色role、岗位job使用真实ID数组；rolelevel、joblevel、joblevelBrowser、seclevel按当前类型和服务端schema适用性校验。此场景不提供relationship。新增读默认值，修改保留未指定项，验证新行后才删除被替换旧行；其他行必须保留。range-get不初始化空范围，首次range-add会初始化scene=11并核对receiverRangeKey回写。
+
+## 节点默认显示格式
+
+- `node-default-get/update <workflowId> --node-id <id> [--data JSON]`：viewTypeSelect、viewType（类型名/ID数组）、showType、showColumn、notShowEmpty、isGroup。
+- `node-content-get/update <workflowId> --node-id <id> [--data JSON]`：selectFormat、viewContents（内容名/ID数组）、showDesc、signShowDesc。
+
+默认格式影响读取该节点默认设置的控件；不自动同步其他节点。当前参与身份节点的默认值，不等于意见范围第一节点的默认值。

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

@@ -235,6 +235,44 @@ e10-cli workflow node sign <wf> <node> --select "退回,加签"    # 指定操
 新增 `--data` 局部修改隐藏输入框、必须签批签名、意见列表类型/范围、隐藏空意见及反馈。拟签使用 `workflow draft-opinion`；节点转发使用 `workflow node forward-setting`。完整参数和话术见 [拟签、转发与签字意见指南](guide-opinion-settings.md)。
 
 
+### 节点批量设置（字段权限 / 退回 / 签字意见）
+
+同一套配置要落到多个节点时，不要逐节点循环命令——把「节点 × 配置」写成一张表，一次跑完。
+
+```bash
+e10-cli workflow node batch <workflowId> --spec nodes.json              # 预演
+e10-cli workflow node batch <workflowId> --spec nodes.json --apply      # 落库 + 统一回读
+e10-cli workflow node batch <workflowId> --spec nodes.json --only fp    # 只跑字段权限
+```
+
+```json
+{
+  "nodes": [
+    {
+      "nodes": ["会签-文电处", "会签-办公室"],
+      "enable-modify-form": true,
+      "field-permission": {
+        "审批意见": "required",
+        "内部备注": "hidden",
+        "金额": { "access": "readonly", "required": false }
+      },
+      "reject": { "rejectType": "free", "rejectRemind": "none", "submitType": "step", "custom": true },
+      "sign": { "allRequired": true }
+    }
+  ]
+}
+```
+
+- `nodes` 写节点名称或 ID；重名节点必须改用 ID。
+- 字段名在主表与明细表重复时（例如两处「备注」），必须写字段 ID；写名称会报歧义并列出候选 `名称(ID)`。
+- 字段权限三态：`hidden`（自动只读）/ `readonly` / `editable` / `required`；未点名的字段原样保留。
+- `reject` 键名与 `node-reject set` 一致；`sign` 与 `node sign` 的 `--all-required` / `--none-required` / `--select` / `--data` 一致。
+- `allRequired` / `noneRequired` **只接受 `true`**：「全部不必填」用 `noneRequired: true`；写 `allRequired: false` 会明确报错（false 既不等于「按操作类型」，也不等于「全部不必填」，不做猜测）。
+- `enable-modify-form` 的当前值读自 `displayLayoutForm.data.allowModify`，会出现在预演差异里，落库后统一回读断言。
+- 全部节点先规划再落库；某个节点某一段失败不影响其他节点。末尾统一回读，不一致会点名到节点 + 字段 + 键。
+- 重复执行幂等：已达标时零写入。
+
+
 ### 节点提交校验
 
 ```bash
@@ -636,3 +674,8 @@ e10-cli workflow base file-set <workflowId> --async-delete 0
 - `workflow base after-submit-display`：自定义开关、PC/移动端显示类型、流程图停留、自定义页面地址。
 - `workflow base comment-set`：自定义与评论开关独立，关联事项范围、附件目录、显示方式、回复位置、默认展开。
 - 初始化和修改均先读取程序默认/已有配置、仅合并指定项、保存后回读。详见 [提交后显示与评论指南](guide-after-submit-comment.md)。
+
+### 布局业务控件识别与拟签创建
+从布局描述建字段前，先按[业务控件识别指南](guide-layout-components.md)执行 `workflow layout-component classify`；系统字段、签字意见输入框和拟签不得作为物理字段创建。`ensure-draft` 查询已有拟签，缺失才新增，返回 widgetId 后复用 `draft-opinion`。
+
+节点意见/流转意见/意见放表单控件参见 [guide-node-opinion.md](guide-node-opinion.md)：先识别节点范围，再用 workflow node-opinion 创建或修改；缺范围必须确认，不创建物理字段。

package/skill-docs/references/form/guide-ebuilder-scope.md

@@ -1,82 +0,0 @@
-# 关联浏览数据范围设置（浏览数据定义 → 数据范围）
-
-配置表单中 EBuilder 关联字段的**数据范围设置**——决定关联浏览弹窗里**哪些被关联数据可选**（如关联客户时只选"客户状态=启用"的客户）。对应设计器「浏览数据定义 → 数据范围设置」面板。
-
-走平台 `browserDataScope` 接口（selectPage 读 / batchSave 写+清），设计器能识别、浏览时生效。
-
-## 命令
-
-```bash
-# 读取已设数据范围
-e10-cli form ebuilder-scope get <源objId> <appId> <EBuilder字段fieldId>
-
-# 设置数据范围：被关联数据须满足条件才可选
-e10-cli form ebuilder-scope set <源objId> <appId> <EBuilder字段fieldId> \
-  --rules @scope-rules.json --logic and
-
-# 清空
-e10-cli form ebuilder-scope clear <源objId> <appId> <EBuilder字段fieldId>
-```
-
-- `<源objId>`：含关联浏览字段的表单 objId
-- `<appId>`：应用 ID
-- `<EBuilder字段fieldId>`：关联浏览字段的 fieldId（`form read` 获取，类型为 Ebuilder）
-- `--logic and|or`：多规则关系（默认 `and`）
-- `--fill-null`：关联字段为空时是否填充（默认关闭）
-
-## 规则格式
-
-```json
-[
-  {"field":"客户状态","operator":"eq","value":"启用"},
-  {"field":"客户名称","operator":"like","value":"上海"}
-]
-```
-
-| 字段 | 说明 |
-|------|------|
-| `field` | 目标表单字段名或 fieldId（CLI 自动解析） |
-| `operator` | `eq`(等于)/`neq`(不等于)/`like`(包含)/`isnull`(为空)/`notnull`(不为空) |
-| `value` | 选项类用**选项名**，CLI 自动解析 valueKey；文本/数字/日期用字面值。`isnull`/`notnull` 不需要 value |
-
-> 选项类字段（Select/Radio/CheckBox）：`value` 填选项名，CLI 自动反查目标表该字段的选项、解析出 valueKey，填 `selectValue`/`customBrowserValue`/`config.options`。选项名必须在目标表选项中存在，否则报错并列出可选值。
-
-## 示例
-
-**关联客户只选启用状态**（典型场景：客户状态=启用才可选）：
-
-```bash
-e10-cli form ebuilder-scope set <源objId> <appId> <EBuilder字段fieldId> \
-  --rules '[{"field":"客户状态","operator":"eq","value":"启用"}]'
-```
-
-**多条件**（启用且名称含上海）：
-
-```bash
-e10-cli form ebuilder-scope set <源objId> <appId> <EBuilder字段fieldId> \
-  --rules '[{"field":"客户状态","operator":"eq","value":"启用"},{"field":"客户名称","operator":"like","value":"上海"}]' \
-  --logic and
-```
-
-**清空恢复全部可选**：
-
-```bash
-e10-cli form ebuilder-scope clear <源objId> <appId> <EBuilder字段fieldId>
-```
-
-## 验证
-
-- `set` 命令保存后自动回读校验规则数是否一致
-- 设计器打开「数据范围设置」面板应显示所设条件
-- 关联浏览时被关联数据应按条件过滤（不满足的不可选）
-
-## 与旧 `ebuilder-filter` 的区别
-
-| | `ebuilder-scope`（推荐） | `ebuilder-filter`（已废弃，保留兼容） |
-|---|---|---|
-| 接口 | `browserDataScope`（数据范围专用） | 字段布局 `filterParams` |
-| 设计器识别 | ✅ | ❌ |
-| 浏览时生效 | ✅ | 不保证 |
-| 用途 | 关联浏览筛选 | 旧机制，已被 scope 取代 |
-
-> ⚠️ `ebuilder-filter` 的旧配置不保证被设计器识别；新建关联浏览筛选一律用 `ebuilder-scope`。