weaver-e10-builder 1.6.4 → 1.6.5

package/skill-docs/references/form/layout/template/advanced.md

@@ -101,6 +101,27 @@
 
 字体、字号等独立项只修改指定部分；完整 `font` 值与这些独立项不能同时写。颜色可用 `#RGB`、`#RRGGBB` 或 `#RRGGBBAA`。只能向**没有字段组件**的单元格写静态文字或系统参数。合并范围不能覆盖字段组件、重复标记或非左上角文字；拆分按现有合并区域的左上角定位，不能拆分包含组件的区域。修改单元格样式始终保留原有的字段组件关联。完整示例见[网格配置示例](../../../../assets/form-template/style-templates-advanced-grid-example.json)。
 
+**表单标题下边框**：先用 `headerTitle: "formTitle"` 放置标题；若 `headerTitlePlacement: "content"`，双列六列网格中的标题位于第 0 行，合并范围为第 1–4 列（`spans` 中 `row: 0, col: 1, colCount: 4`）。要让蓝色下边线覆盖整个标题宽度，在 `grid.main.cells` 中对这四个列坐标逐格设置同样的 `borders.bottom`：
+
+```json
+{
+  "headerTitle": "formTitle",
+  "headerTitlePlacement": "content",
+  "grid": {
+    "main": {
+      "cells": [
+        { "row": 0, "col": 1, "borders": { "bottom": { "color": "#2F6FED", "line": "medium" } } },
+        { "row": 0, "col": 2, "borders": { "bottom": { "color": "#2F6FED", "line": "medium" } } },
+        { "row": 0, "col": 3, "borders": { "bottom": { "color": "#2F6FED", "line": "medium" } } },
+        { "row": 0, "col": 4, "borders": { "bottom": { "color": "#2F6FED", "line": "medium" } } }
+      ]
+    }
+  }
+}
+```
+
+上述坐标只适用于该六列结构；标题跨列变化时，按实际 `spans` 覆盖的列重算。只设置合并区域左上角的下边框，实际显示的线条会不完整。创建后应在目标表单核对视觉效果，不能仅以配置回读或不落库的布局数据预览判断边框已正确呈现。
+
 为标题和字段内容留出相同的左侧空隙时，在主表重复行的四个占位单元格分别写 `style.textIndent`。[基础双列完整模板](../../../../assets/form-template/style-templates-advanced-base-example.json)的 `layoutInfo.pageLayouts[0].config.workbook.Sheet1.cells` 中，第 4 行的第 1、2、3、4 列均设为 `2`，依次对应标题 1、字段 1、标题 2、字段 2。修改完整配置时，找到这四个单元格各自的 `style`，按所需缩进量调整 `textIndent`；不要把属性写到 `cellType` 中，也不要删掉 `cellType.comId`。重复行内的样式会随字段对迭代。分组名称也可另设缩进；行列坐标取决于模板结构，调整分组或字段排布后，应按实际网格重新定位。
 
 ## 二、组件设置

package/skill-docs/references/form/layout/template/easy.md

@@ -11,6 +11,8 @@ e10-cli form layout init-reviewed <objId> --easy-template <名称或ID> --previe
 
 应用会按简易模板重新生成整个布局。执行报告核对主网格列宽、行高以及标题／字段的底色和边框色；如需保留当前排版，先导出布局底稿。
 
+原生流程表单及公文流程的 PC 表格式布局可使用 `wf-form layout init-reviewed <formId> --easy-template <名称或ID>`，同样先 `--preview-only --out`，再以 `--preview @计划文件` 应用；指定非默认布局时加 `--layout-id`。
+
 ## 模板类型与新建
 
 - **预设模板：**平台提供 6 种系统模板，可预览，不可编辑。

package/skill-docs/references/form/layout/template/flow.md

@@ -6,6 +6,8 @@
 
 `form layout init-reviewed --style-template <名称|ID>` 会读取目标表单的布局类型，按已启用的流式模板列表解析和校验名称或 ID，再初始化表单布局。不同布局类型可能有同名模板，以目标表单的 `FLOW` 类型查询结果为准。
 
+原生流程表单及公文流程的 PC 流式布局使用 `wf-form layout init-reviewed <formId> --style-template <名称|ID>`；先传 `--preview-only --out <计划文件>`，再传 `--preview @<计划文件>`。可用 `--layout-id` 限定非默认布局。
+
 ```bash
 e10-cli form-engine layout-template catalog --kind flow --enabled-only
 e10-cli form-engine layout-template flow get <模板ID>

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

@@ -16,7 +16,7 @@
 4. 预览或初始化接口用于核对生成结果，**不代表模板已保存**。模板保存后回读；应用到表单后再次回读表单布局，确认结构和样式生效。
 5. 模板定义布局与外观；实际表单的业务字段和字段状态来自目标表单。图片或 Excel 还原出的实际表单布局，需映射到模板规则，不能整份作为模板保存。
 
-设计高级 PC 表格式模板时，先在**模板设置**中确定结构、网格和单元格，再用 **CSS** 调整主题、组件状态和高亮；仅在需要设计器通用属性或行为设置时补充**布局样式**。同一外观尽量在一处维护，具体配置见[高级模板](advanced.md)。
+设计高级 PC 表格式模板时，以目标效果为单位统筹各层配置：先在**模板设置**中确定重复结构、网格、合并和单元格样式，再用 **CSS** 完成主题、组件状态、高亮等网格设置无法表达的视觉效果；需要设计器通用属性或行为设置时补充**布局样式**。同一外观尽量在一处维护，但一个效果需要多个层级配合时，应把这些配置一起完成。保存后既核对模板内容，也通过应用预览和实际表单检查整体效果，不能只因某一层已设置就视为完成。具体配置见[高级模板](advanced.md)。
 
 当前 CLI 支持表格式简易模板管理、高级 PC 表格式模板的新建与编辑，以及将 PC 流式布局另存为模板。先用统一目录核对模板类别、终端、启用状态与 ID：
 
@@ -41,6 +41,8 @@ e10-cli form layout init-reviewed <objId> --easy-template <简易模板名称或
 
 命令按目标布局类型解析模板，重建该布局并独立回读。显式指定模板时，预览记录模板样式指纹；执行前会重新核对模板未变。执行报告的 `saved:true` 表示布局身份、组件和配置回读通过；`templateEffectVerified:true` 进一步表示流式模板的标题及通用样式、高级表格式模板的通用字段样式及主网格列宽，或简易模板的主网格列宽、行高、标题／字段底色及边框色，与应用后的布局一致。该核对不覆盖每个单元格及 CSS 的最终浏览器呈现，重要版式仍应打开实际表单检查。
 
+原生工作流程表单（包括公文流程绑定的原生表单）可用 `wf-form layout init-reviewed <formId>` 执行同类 PC 模板的预览和应用；指定布局用 `--layout-id`，高级表格式／流式模板用 `--style-template`，简易模板用 `--easy-template`。该流程同样在保存前核对目标、模板类型、字段配置及快照，保存后回读模板效果。详见[流程表单布局](../workflow-layout.md)。
+
 `--read-only`、`--required` 等选项控制字段状态，不属于布局模板的样式设置。
 
 ## 将已有布局另存为模板

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

@@ -11,7 +11,19 @@ e10-cli wf-form layout add <formId> --name "审批节点专用布局" --layout-t
 e10-cli wf-form layout init <formId> --layout-id <布局ID>
 ```
 
-`wf-form layout init` 按目标布局类型重建排版；不传 `--layout-id` 则处理默认布局。需要覆盖字段只读、必填或独占一行时，可按该命令的选项设置；只调整运行时字段属性可查看 `wf-form field-prop`，它同样会经初始化保存，应先核对当前分组、排版和目标布局。删除指定流程表单布局使用：
+`wf-form layout init` 按目标布局类型重建排版；不传 `--layout-id` 则处理默认布局。需要覆盖字段只读、必填或独占一行时，可按该命令的选项设置；只调整运行时字段属性可查看 `wf-form field-prop`，它同样会经初始化保存，应先核对当前分组、排版和目标布局。
+
+应用样式模板时，优先使用审阅式命令。它按目标 PC 布局的 `FLOW`／`EXCEL` 类型解析已启用的流式或高级表格式模板；表格式简易模板使用 `--easy-template`。预览不保存，执行前会重新核对布局、字段配置及模板样式，执行后独立回读组件和可核对的模板效果：
+
+```bash
+e10-cli wf-form layout init-reviewed <formId> --layout-id <布局ID> --style-template <模板名称或ID> --preview-only --out plan.json
+e10-cli wf-form layout init-reviewed <formId> --layout-id <布局ID> --style-template <模板名称或ID> --preview @plan.json
+# PC 表格式简易模板将 --style-template 换为 --easy-template
+```
+
+不传 `--layout-id` 时处理默认布局。当前审阅式模板应用只支持 PC；移动端仍按现有布局初始化和编辑能力操作。此命令会重建目标布局，应用后仍需检查实际页面；`templateEffectVerified` 不代表浏览器最终呈现已核对。公文流程使用同一原生流程表单 `formId` 和上述命令，其公文专属设置另行维护。
+
+删除指定流程表单布局使用：
 
 ```bash
 e10-cli wf-form layout delete <formId> <布局ID>

package/skill-docs/references/form/ref-form-fields.md

@@ -107,7 +107,7 @@
 | 关联绩效 | `Performance` | `KpiFlowComponent` | 绩效选择范围 |
 | 关联报告 | `Report` | `WorkreportComponent` | 报告选择范围 |
 | 关联考勤 | `Attend` | `AttendComponent` | `attendDateType` |
-| 关联浏览 | `Browser` / `RelateBrowser` | `RelateBrowser` | 通过 `browserType` 选择浏览子类 |
+| 关联浏览类型 | `Browser` / `RelateBrowser` | `RelateBrowser` | 必须明确具体浏览类型：系统 `browserType`，或目标环境中查询到的 `browserName` |
 | 电子发票 | `EInvoice` | `EinvoiceComponent` | 发票选择配置 |
 | 行车记录 | `DrivingRecord` | `DrivingRecord` | `defaultRows` |
 | 关联公文 | `RelateODoc` | `RelateODoc` | 公文选择范围 |
@@ -115,6 +115,8 @@
 
 #### 关联类型选型
 
+**需求明确要求“关联浏览类型”时，选择 `Browser`／`RelateBrowser`，并指定具体的浏览类型。不要因为浏览源涉及 EB 表单，就自动改选 `EBuilder`。**可用系统 `browserType`，也可查询目标环境后用 `browserName` 精确选择；只写“关联浏览”尚未确定数据源。`EBuilder` 是另一种字段类型，用于需求明确要求关联某张 EB 表单的场景。创建或修改后回读字段类型；关联浏览还应核对实际 `browserType`。
+
 | 需求语义 | 选择 |
 | --- | --- |
 | 关联电子发票 | `EInvoice` |
@@ -126,7 +128,7 @@
 | 浏览工作流定义 | `RelateBrowser`，`browserType: "workflow"` |
 | 关联业务表单或 EB 表单数据 | `RelateBrowser`，`browserType: "form"` |
 
-`FormData` 表示“关联上报”，与通用关联浏览中的表单浏览不是同一配置。`EBuilder` 用于关联明确的 EB 表单；`RelateBrowser + form` 用于通用表单浏览。
+`FormData` 表示“关联上报”，与关联浏览类型中的表单浏览不是同一配置。`EBuilder` 用于关联明确的 EB 表单；`RelateBrowser + form` 是**关联浏览类型选择了 `form` 浏览源**，不是 `EBuilder` 字段。即使浏览弹窗展示的是 EB 表单数据，也应按实际字段类型与具体浏览源选择后续配置能力。
 
 #### 关联 e-builder
 
@@ -163,6 +165,8 @@
 
 #### 通用关联浏览子类
 
+先确定要浏览的具体对象，再从下表选择 `browserType`；表外的系统类型及自定义浏览框按下一节查询后用 `browserName` 选择。不要只填写 `Browser`／`RelateBrowser` 而省略浏览源。
+
 | `browserType` | 作用 | 主要配置 |
 | --- | --- | --- |
 | `workflow` | 浏览工作流定义 | 工作流范围 |
@@ -173,13 +177,23 @@
 | `hrm_sex` | 浏览人事「性别」 | — |
 | `hrmJobcall` | 浏览人事「职称」 | — |
 
-先用 `form browser-source --keyword <关键词>` 查询当前环境的浏览数据源，再用 `browserName` 精确指定结果中的名称；CLI 创建字段时查询并写入完整 `browserType`。例如在 EB 表单的 `fields.json` 中写：
+##### 任意已开放类型与自定义浏览框
+
+上表是可直接写入 `browserType` 的常用别名，并非全部浏览源。需要使用其他系统浏览类型或自定义浏览框时，先在目标环境查询：
+
+```bash
+e10-cli form browser-source --keyword "合同类型"
+```
+
+从结果中确认准确的 `name`、`module` 和 `type`，再用 `browserName` 指定**完整且精确匹配**的名称。CLI 会按当前环境查询并写入该浏览源的实际 `id/module/type`；无需为新类型修改代码，也不要猜测或复用其他环境的 ID。查询不到或结果不符合预期时，先核对环境与浏览源名称；出现同名结果时应核对 CLI 选中的来源。此操作是创建**使用该浏览源的字段**，不创建浏览源本身。
+
+例如，在 EB 表单的 `fields.json` 中写：
 
 ```json
 {"fieldName":"合同类型","componentKey":"Browser","browserName":"CLM-合同类型","multiple":false}
 ```
 
-给已有 EB 表单追加字段可用 `form add-field <objId> <appId> 合同类型 Browser --browser-name "CLM-合同类型"`；原生流程表单对应 `wf-form add-field <formId> 合同类型 Browser --browser-name "CLM-合同类型"`。名称必须精确匹配；自定义浏览框的 ID 和类型以当前环境检索结果为准。
+给已有 EB 表单追加字段可用 `form add-field <objId> <appId> 合同类型 Browser --browser-name "CLM-合同类型"`；原生流程表单对应 `wf-form add-field <formId> 合同类型 Browser --browser-name "CLM-合同类型"`。创建后回读字段或布局组件的 `browserType`，核对名称、模块和类型。
 
 修改已有 EB 字段为关联浏览时，使用 `form edit-field <objId> <appId> <fieldId> --type Browser --browser-name "社保福利项"`。已有 Browser 字段只更换数据源时可省略 `--type Browser`；也可用 `--browser-type <系统浏览类型>` 选择内置源。改类型时必须明确指定浏览源，避免落成默认浏览源。保存后回读字段类型和布局组件中的 `browserType`，确认其名称、模块和类型。
 

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

@@ -27,7 +27,7 @@ e10-cli workflow create-workflow "公文审批流程" --odoc --form-id <formId>
 ## 完整搭建顺序
 
 1. 使用 `workflow create-workflow --odoc` 创建流程并取得 `workflowId`、`formId`。
-2. 使用 `wf-form` 创建主表字段、明细表及布局，先准备公文设置要引用的标题、正文、文号、目录区分等字段。
+2. 使用 `wf-form` 创建主表字段、明细表及布局，先准备公文设置要引用的标题、正文、文号、目录区分等字段。公文流程绑定的是原生流程表单，布局新建、编辑、模板应用和布局 JS/CSS 使用[流程表单布局指南](../form/layout/workflow-layout.md)中的同一组能力；PC 模板应用可用 `wf-form layout init-reviewed` 先预览后执行。
 3. 使用通用 `workflow` 命令配置节点、操作者、出口、条件、会签、退回、超时、消息、编号及动作流。
 4. 使用 `workflow odoc setting get <workflowId>` 读取当前环境提供的公文设置分组、字段候选项、节点候选项及默认值。
 5. 按需求使用 `workflow odoc setting set` 配置公文专属内容；字段选择使用字段 ID，节点选择可使用名称或 ID。