openxiangda-skill-kit 2.3.89 → 2.3.92

package/skills/openxiangda-v2/references/workflow-events.md

@@ -496,8 +496,11 @@ return <WorkflowSubmissionPage workflowCode="reinstatement" variant="mobile" for
 
 初值仅在当前匹配的发起合同内应用到未触碰字段，每字段一次；后到资料和父组件重新渲染
 不会覆盖已填写或手动清空的内容。日期和范围使用canonical值，标准页通过原codec转换。
-`fieldState`读取canonical值，`required`只能增加校验，不能撤销原必填或隐藏原必填字段；
+条件隐藏同步也读取表单当前值，避免预填或联动刚写入的来源行被旧显隐投影清空。
+`fieldState`读取canonical值，`required`只能增加校验，不能撤销原必填；
 可选字段隐藏时清为`hiddenValue`或undefined，提交也使用同一投影，不发送旧材料/人员。
+
+必填字段也可以隐藏，但必须提供非null/undefined的规范`hiddenValue`，例如表单外已经选定的业务对象。0与false是有效输入；平台仍核验类型、必填和授权，应用须重新核验对象。未提供值时表单继续阻断。
 初值或规则引用范围外字段会阻断表单。`intro`只提供页面说明，不拥有身份、授权或提交。
 资料加载/失败或业务资格提示可传`preparation`内容，它仅阻断尚未提交的表单；原请求查询
 及已接受命令的展示优先于该提示。应用应始终挂载标准页，避免当前资格变化遮蔽原结果恢复。
@@ -511,6 +514,10 @@ return <WorkflowSubmissionPage workflowCode="reinstatement" variant="mobile" for
 联动；PC/手机规则一致。异常保留输入并阻断新提交，下一次成功输入可恢复，原提交结果
 查询及已接受命令仍优先。异步资料读取放准备阶段，服务器仍校验资格和业务不变量。
 
+对已有台账等来源固定的子表，可以传 `subtableFixedRows: ['existingPositions']`，关闭新增、删除和导入，并保留允许字段的编辑、上传和分页。此项仅限制页面操作；业务动作仍须后台重读来源，核验行集合与来源版本，不能把它作为数据授权或防篡改守卫。
+
+当只读来源标识或版本需要发给后台核对时，使用 `subtableReadonlyInputFields: { existingPositions: ['ledgerId', 'ledgerRevision'] }`。字段必须属于当前操作的子表白名单；这些值仅在页面只读，仍是未经信任的输入，后台必须重读并执行版本／集合守卫。不得与同字段的 `subtableReadonlyFields` 混用，后者会省略派生输入。
+
 具名owned新建表单可传`subtableReadonlyFields: { lines: ['employeeNumber'] }`，
 把当前子行的派生值显示为只读，并从提交输入排除。表名与字段必须属于当前sealed
 owned闭包；配置错误会拒绝新表单。值仍可供应用联动展示，Server应重新计算可信值。
@@ -620,6 +627,31 @@ outbox容量等事务故障会回滚，处理器按原键核对后重交，不
 等待处理器的失败从原事件管理受控重放，保留原执行键。普通详情只显示安全状态
 摘要；原输入、输出和外部回执不放入普通时间线。
 
+### 在固定步骤内写入业务数据 {#step-data-transaction}
+
+审批中途需要更新台账时，使用 `reconciled-effect` 动作，并在固定 `handler` 上声明
+`dataTransaction: true`。编译器自动要求 `workflow.step-data-transaction@1.0.0`，
+标记进入签名处理器合同；旧具名版本不可直接改变，增加新版本时保留原实现。
+
+在已验证并领取的事件处理器内，注入 `OpenXiangdaApplicationDataApiService`。
+`reconcile` 先调用 `resolveWorkflowStepData()`：`committed` 用原事务结果重建固定
+`output/receipt`，`not_observed` 返回 `not-executed`，响应未知或失败保留原执行键。
+`handle` 调用 `commitWorkflowStepData({ guards, operations })`。执行ID从事件上下文
+取得，应用不传人、角色、下一节点或幂等键。每个 execution 只允许一个 Native 事务，
+内容不同返回冲突；普通事务不能使用保留的 `workflow-step:` 键。
+
+计划必须包含流程 subject 的 `record-match` 或 `record-assert` guard，其 `revision`
+等于事件数据的固定 `dataRevision`。Native 继续强制来源读取权限、目标写入权限和
+CAS；此接口不能直接修改流程 subject，任务补填仍使用原任务页面。数据计划遵循
+Native 的2016操作、2MiB限制，不支持 decimalReservation 或排队命令。复用原应用
+`data:read/data:write/data:transaction` 权限，不额外授予全校数据读取。
+
+平台先取得环境围栏、实例和步骤锁，再检查有效投递/领取租约，最后执行数据计划。
+业务行、数据事件、Native回执和步骤的回执引用一起提交；任一行失败或租约过期全部
+回滚。取消先取得锁时拒绝新写；数据先提交后取消、换阶段或换Head，resolve仍恢复
+同一原回执。原回执缺失时明确拒绝，不能以未知结果为由重新写入。步骤输出和后续
+流转继续由原事件回执处理，晚拒绝不自动撤销已写台账；补偿属于应用显式业务规则。
+
 ## 代码任务页面与补填 {#task-page-submit}
 
 需要办理人补填时，在定义的 `taskPages` 声明命名页面，审批节点以
@@ -1096,3 +1128,18 @@ nodes: {
 自动协商 `workflow.correction-business-command@1.0.0`，无需额外开启功能。
 本人标量补正支持 Native 写入，owned 子表补正仍不支持；原已成功结果先于当前资料重验
 恢复，不因日期推移或资料后来停用而被误报为失败。接入方法见[后端](backend.md#correction-business-command)。
+
+具名来源行需要展示原资源的材料时，表单可提供 `fileResourceCodes: { [fileId]: resourceCode }`。PC/手机按来源选择 Native 附件读取入口；这是展示提示，平台仍检查当前用户对每个原文件的权限。新上传保留声明的目标资源，提交后台仍须验证来源并使用原复制回执，不能直接绑定另一资源文件。
+
+角色绑定 `app_role` / `app_role_in_scope` 可声明 `selectedInputPath`，从固定代码步骤输出或流程事实中读取人员数组（用户ID或 `{ value, label }`）。平台按当前角色和范围重新核验，再按输入顺序保留其职责出处。越权、失效或重复人员整体拒绝；缺值阻断，只有显式 `[]` 可以消费节点已声明的无人策略。不可与 `routing`、`candidateField`、`inputPath` 混用。编译器要求 `workflow.role-input-selection@1.0.0`；该路径属于代码定义，不是管理员可改的连接或条件。
+
+### 申请人补正中的非流转子表
+
+固定 `correction` 任务可以包含一层 owned 子表，只要这些子表不在
+`subject.factProjection` 中。页内的 `subtable.create/delete/reorder` 和子字段
+白名单、只读、必填及模型 `minRows/maxRows` 仍生效。使用原任务的
+`key/state/values/id/revision` 编辑，不把新建申请的 `data` 行结构套到原行。
+平台把父子修改与 `resubmit` 放在同一授权、版本校验和事务中，应用的业务重提
+只需重核自身业务不变量，不能另写一次子行。投影为流程事实的子表暂不支持此
+补正形式，仍返回 `WORKFLOW_CORRECTION_OWNED_FACTS_UNSUPPORTED`；不能通过
+移除真实流转事实来绕过。原返回、重走首节点、职责和原命令恢复规则保持。