weaver-e10-builder 1.1.3 → 1.1.5

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

@@ -1,5 +1,64 @@
 # 流程表单指南
 
+## EB 流程与原生工作流程的选择
+
+- 默认使用 EB 表单和应用内的 `workflow create`。
+- 需求明确要求“原生流程表单”“工作流程”或“流程中心建流程”时，使用 `workflow create-workflow`；其表单使用 `wf-form` 命令管理。
+- EB 与原生流程表单的资源 ID、接口前缀和布局操作不同，不可混用。EB 应用也不能直接选择表单引擎创建的原生表单。
+- 原生流程表单的字段、明细、布局、字段属性和分组分别使用 `wf-form add-field`、`add-detail-table`、`layout init|add|delete`、`field-prop`、`group`；完整参数见 `references/common/ref-cli-commands.md`。
+- EB 应用内的自由流程平台可配置，但 CLI 的 `workflow create` 暂不支持；`workflow create-workflow` 支持 `--is-free 1`。
+- 已有数据的字段可能无法删除。删除失败时保留字段定义并从布局移除；CLI 当前不提供 `wf-form delete-field`。
+
+### 原生工作流程及表单创建顺序
+
+仅在需求明确要求原生流程表单、工作流程或流程中心时使用本节。`workflow create-workflow` 返回的 `workflowId` 用于节点和流程设置，`formId` 用于全部 `wf-form` 命令；不要传 EB 表单的 objId 或 appId。
+
+#### 方式一：随工作流程自建流程表单
+
+```bash
+e10-cli workflow create-workflow "费用报销流程" --layout FLOW
+# 团队流程默认自动取创建者机构；多机构场景可显式加 --sub-company <机构ID>
+# 表格式流程表单改用 --layout EXCEL；自由流程加 --is-free 1
+```
+
+不传 `--form-id` 为自建模式。FLOW 直接创建流程及其表单；EXCEL 会先创建表格式流程表单再绑定，最终都会返回后续使用的 `formId`。
+
+#### 方式二：绑定已有原生流程表单
+
+```bash
+e10-cli workflow create-workflow "费用报销流程" --form-id <已有formId>
+```
+
+绑定模式沿用已有表单自身的布局类型，`--layout` 不负责切换已有表单布局。
+
+#### 建表与布局配置
+
+```bash
+# 1. 记录并检查创建命令返回的 formId
+e10-cli wf-form read <formId>
+
+# 2. 添加全部主表字段
+e10-cli wf-form add-field <formId> "申请人" Employee
+e10-cli wf-form add-field <formId> "报销金额" Number --precision 2
+
+# 3. 添加明细表；记录返回的 subFormId，再添加其余明细字段
+e10-cli wf-form add-detail-table <formId> "费用明细" "费用类型"
+e10-cli wf-form add-field <formId> "费用金额" Number --sub-form-id <subFormId> --precision 2
+
+# 4. 按需求配置选项、公式、联动、查重和值带出
+e10-cli wf-form field-options <formId> <fieldId> --options '[{"name":"差旅费"}]'
+e10-cli wf-form formula set <formId> --expression "..." --target <fieldId>
+
+# 5. 字段全部创建后配置分组和显示属性
+e10-cli wf-form group <formId> --groups '{"基本信息":["申请人","报销金额"]}'
+e10-cli wf-form field-prop <formId> --required 申请人 报销金额 --readonly 流程编号 --single-row 备注
+
+# 6. 回读字段与布局结果；只有需求明确要求多套布局时才 layout add
+e10-cli wf-form read <formId>
+```
+
+字段应先建全，再统一做分组和字段属性，避免反复重建布局。`add-field`、`group`、`field-prop` 内部均会按各自职责保存或重建布局，通常不需要每加一个字段都手工执行 `layout init`；只有明确需要重建默认布局时才单独使用它。多套布局用 `layout add`，删除指定附加布局用 `layout delete`。
+
 ## 流程页面 URL
 
 提交流程的页面后缀是 `/sp/workflow/flowpage/create/流程id`：