weaver-e10-builder 1.6.0 → 1.6.5

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。

package/skill-docs/assets/sample/readme.js

@@ -1,8 +0,0 @@
-const routes = [
-  {
-    fileName: "xxx.js",
-    className: "xxx",
-  }
-];
-
-export default routes;