weaver-e10-builder 1.5.16 → 1.6.0

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

@@ -0,0 +1,56 @@
+# 表单布局样式模板
+
+## 分类
+
+| 布局 | 模板 | 终端 | 文档 |
+| --- | --- | --- | --- |
+| 表格式 `EXCEL` | 简易模板 | PC | [简易模板](easy.md) |
+| 表格式 `EXCEL` | 高级模板 | PC、移动 | [高级模板](advanced.md) |
+| 流式 `FLOW` | 流式模板 | PC、移动 | [流式模板](flow.md) |
+
+## 创建、编辑与应用的公共规则
+
+1. 先确定目标表单的**布局类型和终端**。模板名称可能相同，ID 只在所属布局类型与终端下使用；应用前按目标类型查询并校验。
+2. 按模板类别使用对应的原生数据模型。简易模板是参数配置；高级表格式模板是设计器文档；流式模板另有接口和结构，不能仅改 `layoutType` 互相转换。
+3. 编辑时先读取完整模板，再合并目标修改，保留未修改的结构、组件、样式、标记和关联 ID。新建时使用有效底稿，设置名称与设计内容。
+4. 预览或初始化接口用于核对生成结果，**不代表模板已保存**。模板保存后回读；应用到表单后再次回读表单布局，确认结构和样式生效。
+5. 模板定义布局与外观；实际表单的业务字段和字段状态来自目标表单。图片或 Excel 还原出的实际表单布局，需映射到模板规则，不能整份作为模板保存。
+
+设计高级 PC 表格式模板时，先在**模板设置**中确定结构、网格和单元格，再用 **CSS** 调整主题、组件状态和高亮；仅在需要设计器通用属性或行为设置时补充**布局样式**。同一外观尽量在一处维护，具体配置见[高级模板](advanced.md)。
+
+当前 CLI 支持表格式简易模板管理、高级 PC 表格式模板的新建与编辑，以及将 PC 流式布局另存为模板。先用统一目录核对模板类别、终端、启用状态与 ID：
+
+```bash
+e10-cli form-engine layout-template catalog
+e10-cli form-engine layout-template catalog --kind advanced --name 清新绿 --enabled-only
+```
+
+`--kind` 可取 `easy`、`advanced`、`flow`、`all`。`enabled` 对简易模板为 `null`，表示该类列表不提供启停状态；`--enabled-only` 不列出简易模板。目录只查询 PC 模板。各类模板的新增、编辑、导入范围以对应的分类文档为准。
+
+自定义高级 PC 表格式模板支持批量启用、禁用和删除；自定义简易模板支持批量删除。实际 PC 流式布局可通过 `form layout save-as-template` 另存其样式为流式模板。系统模板不能修改或删除，具体命令见各分类文档。
+
+将模板应用于已有 eBuilder 表单时，先预览初始化范围，再按原预览执行。高级 PC 表格式模板和 PC 流式模板使用 `--style-template`；表格式 PC 简易模板使用 `--easy-template`，两个选项互斥：
+
+```bash
+e10-cli form layout init-reviewed <objId> --style-template <模板名称或ID> --preview-only --out template-plan.json
+e10-cli form layout init-reviewed <objId> --style-template <模板名称或ID> --preview @template-plan.json
+
+e10-cli form layout init-reviewed <objId> --easy-template <简易模板名称或ID> --preview-only --out easy-plan.json
+e10-cli form layout init-reviewed <objId> --easy-template <简易模板名称或ID> --preview @easy-plan.json
+```
+
+命令按目标布局类型解析模板，重建该布局并独立回读。显式指定模板时，预览记录模板样式指纹；执行前会重新核对模板未变。执行报告的 `saved:true` 表示布局身份、组件和配置回读通过；`templateEffectVerified:true` 进一步表示流式模板的标题及通用样式、高级表格式模板的通用字段样式及主网格列宽，或简易模板的主网格列宽、行高、标题／字段底色及边框色，与应用后的布局一致。该核对不覆盖每个单元格及 CSS 的最终浏览器呈现，重要版式仍应打开实际表单检查。
+
+`--read-only`、`--required` 等选项控制字段状态，不属于布局模板的样式设置。
+
+## 将已有布局另存为模板
+
+
+需要复用一套实际 **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`。业务字段和布局组件不会一起保存。表格式布局不能用这条命令直接另存；模板的其他操作见[布局样式模板总览](template-guide.md)。

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

@@ -0,0 +1,44 @@
+# 流程表单布局与节点独立布局
+
+流程表单可以有多套 FLOW 或 EXCEL 布局。**表单布局**决定字段和组件怎样排列；**节点绑定**决定某个流程节点使用哪一套布局。节点字段权限另行决定显示、只读和必填状态，不因绑定布局而自动替代。这里说明两者的选择路径；节点绑定的完整规则见[流程节点独立布局](../../workflow/guide-workflow-node-layout.md)。
+
+## 管理流程表单自己的布局
+
+已有原生流程表单可按 `formId` 新增一套布局。`--layout-type` 选择 FLOW 或 EXCEL，`--terminal-type` 选择 PC 或 MOBILE；均应按实际需求明确填写。新增不会覆盖原布局，命令返回新 `layoutId`。
+
+```bash
+e10-cli wf-form layout add <formId> --name "审批节点专用布局" --layout-type EXCEL --terminal-type PC
+e10-cli wf-form layout init <formId> --layout-id <布局ID>
+```
+
+`wf-form layout init` 按目标布局类型重建排版；不传 `--layout-id` 则处理默认布局。需要覆盖字段只读、必填或独占一行时，可按该命令的选项设置；只调整运行时字段属性可查看 `wf-form field-prop`，它同样会经初始化保存，应先核对当前分组、排版和目标布局。删除指定流程表单布局使用：
+
+```bash
+e10-cli wf-form layout delete <formId> <布局ID>
+```
+
+删除前确认它是否被节点使用，以及 PC／移动端各自的引用关系。布局类型在新建时确定；需要另一种类型，应新增对应布局。
+
+## 为节点选择布局
+
+先查工作流现有布局及节点当前引用，再绑定目标布局：
+
+```bash
+e10-cli workflow node layout list <workflowId> --terminal PC
+e10-cli workflow node layout get <workflowId> <nodeId>
+e10-cli workflow node layout bind <workflowId> <nodeId> --layout-id <布局ID> --terminal PC
+```
+
+一个节点在同一终端同时只使用一套布局。绑定另一套时，原绑定会被摘除；解绑后回落表单默认布局，而不是没有布局。PC 与移动端的引用关系分别维护。要让节点回到默认布局：
+
+```bash
+e10-cli workflow node layout unbind <workflowId> <nodeId> --terminal PC
+```
+
+也可由 `workflow node layout create` 创建节点专用布局：默认复制来源布局，可用 `--from` 指定来源；`--empty` 才创建空白布局。复制会沿用来源的实际布局类型；若需要从 FLOW 换为 EXCEL，使用空白方式新建，再按目标类型初始化，不能把来源 FLOW 结构当作 EXCEL。`create --init --fields ...` 或 `workflow node layout init <workflowId> <布局ID> --fields ...` 只在该布局放指定字段，不删除表单字段，也不改其他布局。具体参数与验收见[节点布局指南](../../workflow/guide-workflow-node-layout.md)。
+
+## 修改布局内容与代码
+
+确定 `formId`、布局 ID、终端后，可用[布局查询和局部编辑](inspect-edit.md)或[完整布局文档](document.md)处理支持的实际布局内容；按[代码块指南](code-block/code-block-guide.md)选择 `wf-form code layout read/set` 或 `preview/apply` 写 JS/CSS。模板应用、初始化与已审阅编辑的适用范围按各专题核对，不要将 EB 专用命令直接换前缀用于流程表单。
+
+节点上的显示、编辑和必填条件另读[节点字段权限](../../workflow/guide-workflow-node-layout.md)；依据字段值动态变化的显示属性读[表单显示属性联动](../guide-form-linkage.md)。