@stalfh233/omc-cli 0.5.14 → 0.5.15

package/dist/lanes/runtime-data-contract.js

@@ -38,7 +38,7 @@ export function dataSubmitDescription() {
         "Distinct from data.save: data.save persists as DRAFT; data.submit advances the record to COMPLETED (no workflow) or drives the workflow instance.",
         "**审批提交（workItemId+agree）时 `formData` 也必填，且其值会写回业务对象——勿把期望结果（如审批级别）预写进 formData，否则规则回写的真伪无法区分（2026-09-22 实测返工案例）**；只传身份参数会被拒 formData: Required。",
         `就地语义：${wire.submitInPlace}；无流程 readback 必须确认 objectId 与传入 bizObjectId 相同；无 bizObjectId 的 workflowCode 新建单 → PROCESSING + workflowInstanceId，无流程 → 该行 COMPLETED。`,
-        `既有草稿发起流程的唯一支持形状是两段式：先 data.save 带 workflowCode 暂存（${wire.workflowDraftSave}），再以返回的 workItemId 提交。`,
+        `既有草稿发起流程的唯一支持形状是两段式：先 data.save 带 workflowCode 暂存（${wire.workflowDraftSave}），再以返回的 workItemId 提交（issue#11 P6：带流程模型提交**必须**带 bizObjectId+workflowInstanceId+workItemId 三元——只带 bizObjectId 会答「流程实例无待办」、只缺 workItemId 会 50000；完整形状见 omc describe data.submit --example workflow-backed-data-submit，待办查询用 workitem.list）。`,
         `仅无 workflowCode/workItemId/workflowInstanceId 且无 bizObjectId 时保留 save→submit 便捷链（新建记录）；只要存在 workItemId 或 workflowInstanceId 就 fail-closed 拒绝（blocker submit-biz-object-id-required），零 runtime/form/submit wire。`,
         `formType 自动判定：无任何 workflowCode/workItemId/workflowInstanceId 时**先按模型自动判定**——GET workflow/isworkflow?schemaCode=true 则用 workflow/getWorkflow 解析已发布流程码并**发起流程**（formType="${wire.formTypeWorkflow}"，自动先 GET getReplayToken 注入 replayToken，否则 ${wire.replayTokenErrcode} 频繁重复提交）；模型无流程 → "${wire.formTypeNoWorkflow}"（无流程提交，走 live 已证链 ${wire.submitChain}；单发新建对象会 ${wire.typeCastErrcode}，bizObject 勿带字符串 status）或 workItemId+workflowInstanceId（审批待办，agree **顶层**通过/驳回（approval 对象里放 agree 会被静默忽略并按通过处理），**必须带 bizObjectId 指向在途单据**，否则引擎 NPE ${wire.approvalNpeErrcode}）→ "${wire.formTypeWorkflow}"。即「无流程直接提交、有流程发起流程」，不再把有流程模型的新建数据落成游离 sheet 行。`,
         "根因提示（环境相关，ticket 78 观测）：**某些环境**里模型所在应用未发布时运行时提交稳定 50000，工具会反推并拒 app-not-published。该根因非普遍规律（见 data.save 的同条提示与 docs/issues/omc-cli-findings-2026-09-19.md B17）——遇 50000 先只读核对再判断。",

package/dist/lanes/runtime-data.js

@@ -378,6 +378,65 @@ async function portalRequiredViolations(session, schemaCode, sheetCode, formData
     });
     return { requiredFields, missingRequired };
 }
+/** 提交面：formData 里出现任何非空人员字段值即返回（issue#10：两种形状都可能 50000，可靠链路是提交省略）。 */
+async function staffFieldsPresent(session, schemaCode, formData) {
+    const STAFF_TYPES = new Set([50, 51, 52]);
+    let rows;
+    try {
+        rows = wireRows((await wireCall(session, { path: ENDPOINTS.fieldList, query: { schemaCode, isPublish: "true" } })).data);
+    }
+    catch {
+        return [];
+    }
+    const staffCodes = new Set();
+    for (const row of rows) {
+        const type = Number(row.type ?? row.propertyType);
+        const code = String(row.code ?? row.propertyCode ?? "");
+        if (code && STAFF_TYPES.has(type))
+            staffCodes.add(code);
+    }
+    const out = [];
+    for (const [code, value] of Object.entries(formData)) {
+        if (!staffCodes.has(code))
+            continue;
+        if (value === null || value === undefined || value === "")
+            continue;
+        if (Array.isArray(value) && value.length === 0)
+            continue;
+        out.push({ code, got: Array.isArray(value) ? `array[${value.length}]` : typeof value });
+    }
+    return out;
+}
+/** save 面（无 submit）：人员字段只接受对象数组 [{id,type,name}]——字符串/字符串数组会 50000（issue#10 A）。 */
+async function staffStringShapeViolations(session, schemaCode, formData) {
+    const STAFF_TYPES = new Set([50, 51, 52]);
+    let rows;
+    try {
+        rows = wireRows((await wireCall(session, { path: ENDPOINTS.fieldList, query: { schemaCode, isPublish: "true" } })).data);
+    }
+    catch {
+        return [];
+    }
+    const staffCodes = new Set();
+    for (const row of rows) {
+        const type = Number(row.type ?? row.propertyType);
+        const code = String(row.code ?? row.propertyCode ?? "");
+        if (code && STAFF_TYPES.has(type))
+            staffCodes.add(code);
+    }
+    const out = [];
+    for (const [code, value] of Object.entries(formData)) {
+        if (!staffCodes.has(code))
+            continue;
+        if (value === null || value === undefined || value === "")
+            continue;
+        if (typeof value === "string")
+            out.push({ code, got: "string" });
+        else if (Array.isArray(value) && value.every((entry) => typeof entry === "string"))
+            out.push({ code, got: `string[${value.length}]` });
+    }
+    return out;
+}
 /**
  * The platform dispatches each CHILD_TABLE(8) row on the form-save path by its
  * `rowStatus` (BizObjectUpdateModel.convertBizObjectOpItem): "Added" → insert,
@@ -980,6 +1039,7 @@ export function registerRuntimeDataLane(tools) {
         formData: runtimeFormDataArg,
         workflowCode: z.string().optional().describe("portal draft-save shape: create the row AND a DRAFT workflow instance + start workItem (finishStart=FALSE); submit later via data.submit with the returned workItemId. formData must NOT carry an id — in-place workflow start has no REST surface in 8.6.26"),
         submit: z.boolean().optional().describe("true=保存后立即直提（无流程模型 DRAFT→COMPLETED，触发 Create 规则）；与 workflowCode 互斥。**按业务约定正式数据优先直接 data.submit（无 id=新建并提交一调完成）——本参数是便捷别名，save 的定位是草稿/暂存**"),
+        allowStaffOnSubmit: z.boolean().optional().describe("submit:true 时显式允许携带人员字段（issue#10：人员字段提交面两种形状都可能 50000，可靠链路是 save 落库后提交时省略；个别平台构建接受提交面携带，自担风险）"),
         ...readbackProjectionArgs,
     }, async (session, args) => {
         // F-A (self-audit): the combo used to be silently ignored (the workflow
@@ -995,22 +1055,34 @@ export function registerRuntimeDataLane(tools) {
         const rawSaveData = args.formData;
         const saveIsUpdate = typeof rawSaveData.id === "string" && rawSaveData.id.trim().length > 0;
         const formData = (await prepareRuntimeFormData(session, args.schemaCode, rawSaveData, { isUpdate: saveIsUpdate })).formData;
-        // issue#9 C1（用户实测最高优先）：data.submit 有 submit-person-field-shape 等
-        // 写前 gate，data.save 同类形状错误裸奔——对象数组人员字段在 save 面直落
-        // 平台 50000（UserBizField.fillClientContent），同类失败重复 3 次还引发
-        // 「环境不可写」误判。save 面共用同一 gate（注意：save 草稿面接受对象数组
-        // ——只有 submit:true 直提路径才必须字符串 id，见 hazards 通道分叉条）。
-        if (args.submit === true) {
-            const staffShapedSave = await personFieldShapeViolations(session, args.schemaCode, formData).catch(() => []);
-            if (staffShapedSave.length > 0)
+        // issue#9 C1 + issue#10 勘误：提交面（submit:true / data.submit）的人员字段
+        // 两种已知形状都不安全——对象数组有历史 50000 证据（UserBizField.fillClientContent，
+        // 本闸拦截），字符串 id 数组在 8.6.41 实测同样 50000（#10 D）。可靠链路只有一条：
+        // data.save 人员字段用对象数组 [{id,type,name}] 落库 → 提交时**省略人员字段**（值已持久化）。
+        if (args.submit === true && args.allowStaffOnSubmit !== true) {
+            const staffOnSubmit = await staffFieldsPresent(session, args.schemaCode, formData).catch(() => []);
+            if (staffOnSubmit.length > 0)
                 throw new ToolRefusalError({
                     status: "refused",
                     blocker: "submit-person-field-shape",
                     schemaCode: args.schemaCode,
-                    fields: staffShapedSave,
-                    message: `data.save submit:true 的人员字段形状错误：${staffShapedSave.map((entry) => `${entry.code}(${entry.got})`).join("、")}。` +
-                        `提交面只接受字符串 id（"<用户id>" 或 ["<id1>","<id2>"]）；对象数组 [{id,type,name}] 会触发平台 UserBizField.fillClientContent 断言 50000。` +
-                        `两条出路：①改成字符串 id 数组重提；②本字段留对象数组、去掉 submit:true 先存草稿，再 data.submit（两步法，草稿面接受对象数组）。`,
+                    fields: staffOnSubmit,
+                    message: `提交携带了人员字段：${staffOnSubmit.map((entry) => `${entry.code}(${entry.got})`).join("、")}。提交面的两种形状都不安全（对象数组触发 UserBizField.fillClientContent 50000；字符串 id 在 8.6.41 实测同样 50000——issue#10 复现矩阵）。` +
+                        `可靠链路：data.save 时人员字段用对象数组 [{"id":"<userId>","type":3,"name":"<名>"}]（type:3=用户/1=部门）落库，提交（submit:true / data.submit）时**省略人员字段**——值已持久化，提交只推进流程。` +
+                        `确要在提交携带人员字段（个别平台构建接受），显式带 allowStaffOnSubmit:true 自担。`,
+                });
+        }
+        // issue#10 A：save 面的字符串 id 才是错误形状（对象数组才是正解 B）——
+        // 裸字符串/字符串数组在 save 面直落平台换一个无诊断的 50000，fail-closed。
+        if (args.submit !== true) {
+            const staffStringSave = await staffStringShapeViolations(session, args.schemaCode, formData).catch(() => []);
+            if (staffStringSave.length > 0)
+                throw new ToolRefusalError({
+                    status: "refused",
+                    blocker: "save-person-field-shape",
+                    schemaCode: args.schemaCode,
+                    fields: staffStringSave,
+                    message: `data.save 的人员字段用了字符串 id：${staffStringSave.map((entry) => `${entry.code}(${entry.got})`).join("、")}——save 面的正确形状是对象数组 [{"id":"<userId>","type":3,"name":"<名>"}]（type:3=用户/1=部门；issue#10 实测矩阵：字符串 id 50000、对象数组成功）。读回值 [{id,type,name,…}] 可直接回写。`,
                 });
         }
         if (typeof args.workflowCode === "string" && args.workflowCode.trim()) {
@@ -1313,6 +1385,7 @@ export function registerRuntimeDataLane(tools) {
         bizObjectId: z.string().optional().describe("existing record id; REQUIRED for workItem approval submits (formType=1 + workItemId) — the submit's bizObject must reference the in-flight record or the engine NPEs (DataChangeHandlerImpl.changeBizObject)"),
         agree: z.boolean().optional(),
         allowChildRowAppend: z.boolean().optional().describe("默认 false：审批提交（带 workItemId/workflowInstanceId）时 formData 含子表数组会被拒——平台按追加插行，每次提交重复一份。确实要追加子行时才置 true。"),
+        allowStaffOnSubmit: z.boolean().optional().describe("默认 false：提交携带人员字段会被拒（issue#10：两种形状都可能 50000；可靠链路=save 落库后提交省略人员字段）。个别平台构建接受提交面携带时置 true 自担。"),
         approval: z.record(z.string(), z.unknown()).optional(),
         runMode: z.string().optional(),
         isSimulative: z.boolean().optional(),
@@ -1396,18 +1469,23 @@ export function registerRuntimeDataLane(tools) {
         // ——写成对象会让 UserBizField.fillClientContent 断言失败，平台只回 50000。
         // 读写不对称且 schema 无法表达（formData 是 additionalProperties），所以在
         // 写前按已发布字段类型做一次浅校验，把这类形状错误变成一条指名道姓的拒绝。
-        const staffShaped = await personFieldShapeViolations(session, args.schemaCode, formData).catch(() => []);
-        if (staffShaped.length > 0)
-            throw new ToolRefusalError({
-                status: "refused",
-                blocker: "submit-person-field-shape",
-                schemaCode: args.schemaCode,
-                fields: staffShaped,
-                message: `这些人员字段的取值是对象/数组：${staffShaped.map((entry) => `${entry.code}(${entry.got})`).join("、")}。` +
-                    `人员字段**写入只接受字符串 id**（多个用逗号或数组的字符串 id）——读回来是 \`[{id,type,name,fullDepartment,…}]\`，` +
-                    `把读回值原样写回会让平台 UserBizField.fillClientContent 断言失败、只回 50000 服务异常。` +
-                    `写成 "\"<用户id>\"" 或 ["<id1>","<id2>"]。`,
-            });
+        // issue#10（8.6.41 复现矩阵 + 本仓 1.1.25 复验）：旧提示方向反了——
+        // "写入只接受字符串 id"会让调用者按提示改成字符串数组，然后平台 50000
+        // （submit 面 D）。提交面两种已知形状都不安全，可靠链路只有：save 时用
+        // 对象数组落库 → 提交时省略人员字段（值已持久化）。
+        if (args.allowStaffOnSubmit !== true) {
+            const staffShaped = await staffFieldsPresent(session, args.schemaCode, formData).catch(() => []);
+            if (staffShaped.length > 0)
+                throw new ToolRefusalError({
+                    status: "refused",
+                    blocker: "submit-person-field-shape",
+                    schemaCode: args.schemaCode,
+                    fields: staffShaped,
+                    message: `提交携带了人员字段：${staffShaped.map((entry) => `${entry.code}(${entry.got})`).join("、")}。提交面的两种形状都可能 50000（对象数组触发 UserBizField.fillClientContent 断言；字符串 id 数组在 8.6.41/1.1.25 均实测 50000——issue#10 复现矩阵）。` +
+                        `可靠链路：data.save 时人员字段用对象数组 [{"id":"<userId>","type":3,"name":"<名>"}]（type:3=用户/1=部门）落库，提交时**省略人员字段**——值已持久化，提交只推进流程。` +
+                        `确要在提交携带人员字段（个别平台构建接受），显式带 allowStaffOnSubmit:true 自担。`,
+                });
+        }
         const validation = await portalRequiredViolations(session, args.schemaCode, sheetCode, args.formData).catch(() => ({ requiredFields: [], missingRequired: [] }));
         // Directive: a workflow-backed model's submit must START the workflow, not
         // merely save a sheet row. When the caller names no workflow params, detect

package/dist/lanes/workflow.js

@@ -286,6 +286,21 @@ function templateActivityCodes(template) {
  * template instead of believing the flow is running. WARN-level messages are
  * returned as evidence but do not block (live: `{Creator}` answers 401062 WARN).
  */
+/**
+ * workflow.publish 高频拒绝码 → 可执行含义（issue#11 P1：401041/401053 码面文案
+ * 与触发场景错位，用户靠 5 组二分才定位）。全 93 码表见
+ * engine-api-guide/references/EngineErrCode.md（工作流段，自 ErrorCode 反编译）。
+ */
+const WORKFLOW_PUBLISH_CODE_HINTS = Object.freeze({
+    "401026": "审批节点未绑定表单：sheetCode 置为模型默认表单槽位",
+    "401041": "多人节点参与者写成了 {Originator}——多人节点请用角色/函数表达式；发起/填写节点才可用 {Originator}",
+    "401053": "发起/填写节点的参与者类型不能是多人（MULTI_PARTICIPANT）",
+    "401047": "「上一活动参与者」函数只能接在单个用户活动节点之后",
+    "401048": "驳回-上一步：上一步必须是单用户活动节点",
+    "401052": "发起节点不允许配置「驳回到开始」",
+    "401057": "同意出口不能为空或 0/0%",
+    "401027": "存在孤立节点（未接入 START→END 链路）",
+});
 function workflowValidationErrors(data) {
     if (!Array.isArray(data))
         return [];
@@ -306,7 +321,7 @@ function assertWorkflowWriteAccepted(performed, tool, workflowCode) {
         blocker: "workflow-publish-invalid",
         workflowCode,
         validationErrors: errors,
-        message: `${tool}: 平台以 ValidateMessage[] 拒绝（errcode 0 但不落库）：${errors.map((error) => `${error.errCode} ${error.errContent}`).join("；")}。常见根因：审批(PARTICIPANT)节点的 sheetCode 为空（=模型默认表单槽位，通常等于 schemaCode；401026 WORKFLOW_ACTIVITY_NO_SHEET——工具已自动回填，仍报则检查端点是否漏），或新增节点未接入链路（END 无入边）。修正模板后重试，不要反复 publish`,
+        message: `${tool}: 平台以 ValidateMessage[] 拒绝（errcode 0 但不落库）：${errors.map((error) => `${error.errCode} ${error.errContent}${WORKFLOW_PUBLISH_CODE_HINTS[String(error.errCode)] ? `（${WORKFLOW_PUBLISH_CODE_HINTS[String(error.errCode)]}）` : ""}`).join("；")}。常见根因：审批节点的 sheetCode 为空（401026，工具已自动回填）；新增节点未接入链路（END 无入边）；**多人节点参与者写成 {Originator}**（1.1.25 隔离矩阵实证：MULTI_PARTICIPANT+{Originator} 报 401041——该码文案"否决出口节点编码不能为空"在此场景具误导性，issue#11 P1；发起/填写节点须 SINGLE，多人报 401053）。修正模板后重试，不要反复 publish`,
     });
 }
 /**

package/dist/path-projection.js

@@ -39,14 +39,37 @@ export function projectJsonPath(value, path) {
         const base = projectJsonPath(value, before);
         if (base.missed)
             return base;
-        const array = base.value;
-        if (!Array.isArray(array))
-            return { missed: true, at: before || "$", available: `该层不是数组（是 ${array === null ? "null" : typeof array}）；选择器 [${key}=${expected}] 需要数组` };
-        const readKey = (entry) => (entry !== null && typeof entry === "object" ? String(entry[key] ?? "") : "");
-        const index = array.findIndex((entry) => readKey(entry) === expected);
+        // issue#11 P7：工作流模板的 activities/rules 是「index → 条目」的**对象**，
+        // 不是数组；条目键名还常是 activityCode/nodeCode 而非 code。按键选择器因此
+        // 也要认 dict 容器与常见键别名，否则 workflow 节点只能靠下标猜。
+        const KEY_ALIASES = ["code", "activityCode", "nodeCode", "ruleCode", "propertyCode", "name"];
+        const readKey = (entry) => {
+            if (entry === null || typeof entry !== "object")
+                return "";
+            const record = entry;
+            const direct = record[key];
+            if (direct !== undefined && direct !== null && String(direct) !== "")
+                return String(direct);
+            for (const alias of KEY_ALIASES) {
+                const value = record[alias];
+                if (value !== undefined && value !== null && String(value) !== "")
+                    return String(value);
+            }
+            return "";
+        };
+        const entries = Array.isArray(base.value)
+            ? base.value
+            : base.value !== null && typeof base.value === "object"
+                ? Object.values(base.value)
+                : [];
+        if (entries.length === 0 && !Array.isArray(base.value)) {
+            const shaped = base.value === null ? "null" : typeof base.value;
+            return { missed: true, at: before || "$", available: `该层不是数组/对象（是 ${shaped}）；选择器 [${key}=${expected}] 需要数组或 index→条目 对象` };
+        }
+        const index = entries.findIndex((entry) => readKey(entry) === expected);
         if (index < 0)
-            return { missed: true, at: `${before}[${key}=${expected}]`, available: `数组长度 ${array.length}；${key} 的候选值：${[...new Set(array.map(readKey))].slice(0, 12).join("、") || "（无）"}` };
-        return after === "" ? { missed: false, value: array[index] } : projectJsonPath(array[index], after);
+            return { missed: true, at: `${before}[${key}=${expected}]`, available: `条目数 ${entries.length}；候选值（${key}/别名）：${[...new Set(entries.map(readKey).filter((value) => value !== ""))].slice(0, 16).join("、") || "（无）"}` };
+        return after === "" ? { missed: false, value: entries[index] } : projectJsonPath(entries[index], after);
     }
     const normalized = path
         .trim()
@@ -121,7 +144,7 @@ function argvValues(args, name) {
     return values;
 }
 /** Shared wording for every projection miss, so all three faces teach the same syntax. */
-const PATH_MISS_HINT = "路径未命中（这一层没有该段）。可用写法：点式 a.b、下标 a[0]、切片 a[0:6]、数组映射 items[].fields.x、按键选择 rules[code=Create]（返回第一个匹配项）。available 是该层真实存在的键。";
+const PATH_MISS_HINT = "路径未命中（这一层没有该段）。可用写法：点式 a.b、下标 a[0]、切片 a[0:6]、数组映射 items[].fields.x、按键选择 rules[code=Create] 或 data.activities[code=A1]（数组与 index→条目对象都支持；键名可省 activityCode/nodeCode 等别名；返回第一个匹配项）。available 是该层真实存在的键。";
 /**
  * `call --extract/--extract-keys`: resolve paths inside the result's own
  * artifact (or inside the result object when the tool returned no artifact).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stalfh233/omc-cli",
-  "version": "0.5.14",
+  "version": "0.5.15",
   "description": "CloudPivot 8.6 configuration capability CLI — governed, fail-closed, coverage-manifest bounded.",
   "type": "module",
   "bin": {
@@ -52,9 +52,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@stalfh233/omc-fake-platform": "0.5.14",
+    "@stalfh233/omc-fake-platform": "0.5.15",
     "commander": "14.0.3",
-    "omc-core": "0.5.14",
+    "omc-core": "0.5.15",
     "proper-lockfile": "4.1.2",
     "write-file-atomic": "6.0.0",
     "zod": "^3.23.8",

package/skills/omc-write-hazards.md

@@ -39,7 +39,7 @@ omc help omc-write-hazards
 - `propertyEmpty` 默认 `false`。模型层保持可空；必填、只读、可见性在表单和流程节点配置。
 - 无映射关联单选 `WORK_SHEET` 使用 `mappings: ""`，不要用 `"[]"`。`"[]"` 是非空字符串，设计器会显示“已设置”，但弹窗没有映射行。
 - 有映射时传非空 JSON 数组字符串，并在 draft/published 两面读回。
-- **人员字段形状随通道分叉（2026-11-02 用户实测）**：save/update 面=[{id,type,name}]（type：用户 3/部门 1）；**submit 面**（data.submit 或 save+submit:true）=**字符串 id 数组** ["<id>"]——对象数组+submit 触发平台 UserBizField.fillClientContent 断言 50000（OMC 预检会拦）；一次提交人员字段被拒就改「先存草稿再 submit」两步。其余：单选(9)=id 串；多选(11)=分号串。
+- **人员字段形状（issue#10，8.6.41+1.1.25 双验）**：save/update 只认对象数组 `[{id,type,name}]`（type：用户 3/部门 1）——字符串/字符串数组 50000；提交面两种形状都 50000。可靠链路=save 对象数组落库 → 提交**省略人员字段**。OMC 双闸已修正（提交带 allowStaffOnSubmit 放行）。单选(9)=id 串；多选(11)=分号串。
 - **`mappings` 由表单运行时在用户选择时套用**，服务端 `data.save` **不会**自动回填映射目标字段。API 侧要自己写被映射字段，否则读回为空——别把它误判成“映射配置失败”。
 - **关联映射的事实源在字段行 `options.mappings`，不在表单控件属性**（真机 2026-10-14 实证：改表单 attributes 里的映射会被平台按字段重算覆盖、回读不生效）。改映射走：`field.update` 按完整 options 提交（只改 mappings，其余键原值保留）→ `field.publish` → `form.draft`（**rebuild:false**，保留现有布局与在线JS）重存 → `form.publish` → 回读核对。**别用 cascadeRepublish 刷带布局/在线JS 的表单**：rebuild 会清空设计器公式（已做写前拒绝）。
 - **运行时写值的最小形状**（组合出错只会得到一个不透明的 `50000`/NPE，逐一最小化再合）：单选关联(9) → id 字符串 `"<id>"`；**多选关联(11) → 分号串 `"<id1>;<id2>"`**；**人员/组织(50/51/60/61) → `[{"id":"<id>","type":3,"name":"<名>"}]`，`type` 必填且为整数**（缺/非整数 → `BizField.parseFromClient` 拆箱 NPE→50000；用户=3、部门=1）；日期(3) → 字符串 `"2026-09-30 10:00:00"`；子表(8) → 行对象数组 `[{"<子列code>":<值>, ...}]`。先各写一条最小行通过，再组合。