weaver-e10-builder 1.2.5 → 1.5.2

package/dist/services/form-linkage-condition.js

@@ -0,0 +1,307 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { findWorkflowRow } from './workflow-info.js';
+const MODULE = 'ebuilderform';
+const ADD_PATH = '/api/ebuilder/form/form/setting/viewlinkage/add';
+/** 平台认的条件算子。`NULL`/`NOT_NULL` 即「为空」/「不为空」。 */
+export const KNOWN_OPERATORS = [
+    'EQUAL', 'NOT_EQUAL', 'CONTAIN', 'NOT_CONTAIN',
+    'GREATER', 'LESS', 'GREATER_EQUAL', 'LESS_EQUAL',
+    'NULL', 'NOT_NULL',
+];
+/**
+ * 常见等价写法 → 平台码。
+ *
+ * 收的是**别人真的会写**的那些：`EMPTY`/`IS_NULL` 是「为空」最自然的写法（也是我们
+ * 文档曾经写的），符号写法是随手写。归一之后才不会因为一个词的差别炸在写库上。
+ */
+const OPERATOR_ALIAS = {
+    '=': 'EQUAL', '==': 'EQUAL', '!=': 'NOT_EQUAL', '<>': 'NOT_EQUAL',
+    EMPTY: 'NULL', IS_NULL: 'NULL', ISNULL: 'NULL', NULL: 'NULL', '为空': 'NULL',
+    NOT_EMPTY: 'NOT_NULL', IS_NOT_NULL: 'NOT_NULL', ISNOTNULL: 'NOT_NULL',
+    NOT_NULL: 'NOT_NULL', '不为空': 'NOT_NULL', NONEMPTY: 'NOT_NULL',
+};
+/** 不带右值的算子：**不能**带 `sourceContent`。 */
+const NO_VALUE_OPERATORS = new Set(['NULL', 'NOT_NULL']);
+/** 归一算子码；未知的原样返回（交给平台判，但调用方应当据此告警）。 */
+export function normalizeOperator(operator) {
+    const raw = String(operator ?? '').trim();
+    if (!raw)
+        return 'EQUAL';
+    return OPERATOR_ALIAS[raw.toUpperCase()] || raw.toUpperCase();
+}
+/** 该算子是否需要比较值。 */
+export function operatorTakesValue(code) {
+    return !NO_VALUE_OPERATORS.has(code);
+}
+/**
+ * 造一条 `conditionDetails`。**纯函数**。
+ *
+ * 为空/不为空**不带 `sourceContent`**；其余算子一定带（值缺省写空串而不是省略键 ——
+ * 省略键会让平台在写库时缺列）。
+ */
+export function buildConditionDetail(cond) {
+    const code = normalizeOperator(cond.operator);
+    const warnings = [];
+    const detail = {
+        targetId: String(cond.fieldId), // 平台这里要字符串；数字雪花过 JSON 会丢精度
+        detailSymbol: code,
+        sourceType: 'CONSTANT',
+    };
+    if (!KNOWN_OPERATORS.includes(code)) {
+        warnings.push(`未知的条件算子 "${cond.operator}"，按原值提交；平台支持：${KNOWN_OPERATORS.join(' / ')}`);
+    }
+    if (!operatorTakesValue(code)) {
+        if (cond.value !== undefined || (Array.isArray(cond.options) && cond.options.length)) {
+            warnings.push(`算子 ${code}（为空/不为空）不带比较值，已忽略给的 value/options`);
+        }
+        return { detail, warnings };
+    }
+    detail.sourceContent = JSON.stringify({
+        formField: { id: String(cond.fieldId) },
+        ...(cond.options ? { dataOptions: cond.options } : { content: String(cond.value ?? '') }),
+    });
+    return { detail, warnings };
+}
+/** 多条件之间的关系。界面上的「任一」= `OR`、「全部」= `AND`。 */
+export const DETAIL_TYPES = ['AND', 'OR'];
+/** 拼 `viewlinkage/add` 的报文。**纯函数**，便于对照设计器实际发出的形状。 */
+export function buildLinkageAddPayload(input) {
+    const warnings = [];
+    const effect = input.effect || {
+        effectType: 'form', effectName: '当前表单', effectValue: input.formId,
+    };
+    if (input.detailType && !DETAIL_TYPES.includes(String(input.detailType).toUpperCase())) {
+        warnings.push(`detailType「${input.detailType}」不是平台取值（${DETAIL_TYPES.join(' / ')}），按原值提交`);
+    }
+    const conditionDetails = input.conditions.map((c) => {
+        const { detail, warnings: w } = buildConditionDetail(c);
+        warnings.push(...w);
+        return detail;
+    });
+    const payload = {
+        fdEffect: {
+            formId: input.formId,
+            effectModule: MODULE,
+            effectType: effect.effectType,
+            effectName: effect.effectName,
+            optionList: [{
+                    effectValue: effect.effectValue,
+                    effectName: effect.optionName || effect.effectName,
+                }],
+        },
+        condition: {
+            targetId: input.formId,
+            targetName: input.formName || '表单',
+            targetModule: MODULE,
+            conditionType: 'FIELD',
+            ...(input.detailType ? { detailType: input.detailType } : {}),
+            conditionDetails,
+            formulaId: '',
+            formulaName: '',
+        },
+        linkageDetails: input.actions.map((a) => ({
+            formId: input.formId,
+            id: '0',
+            linkageObj: 'field',
+            linkageProp: a.prop,
+            linkageShowValue: a.fields.map((f) => ({
+                dataKey: f.dataKey || '',
+                groupName: '表单字段',
+                address: f.isDetail ? '明细表' : '主表',
+                addressType: f.isDetail ? 'detail' : 'form',
+                groupId: 'formField',
+                name: f.name,
+                descType: f.fieldType || '',
+                id: String(f.fieldId),
+                content: f.name,
+                desc: f.desc || '',
+            })),
+            detailOptions: [],
+        })),
+        module: MODULE,
+        formId: input.formId,
+        refId: input.formId,
+        enableState: '1',
+        linkageName: input.name,
+        customParam: { appId: input.appId, objId: input.objId },
+    };
+    return { payload, warnings };
+}
+/**
+ * 把 `config.effect` 的写法解析成完整的生效维度。三种写法：
+ *
+ * - **不给** → 当前表单（最常见）
+ * - **`"formLayout"`** → 「表单布局」维度，布局 id 现查；⚠ 取的是 **`multipleLayoutId`**，
+ *   不是 `formLayout.id`（同一张表上这两个值相邻但不同，发错不报错、只是指向别的布局）
+ * - **对象** → 原样使用，只补缺省
+ */
+export async function resolveEffect(client, baseUrl, formId, formName, effect) {
+    const currentForm = {
+        effectType: 'form', effectName: '当前表单', effectValue: formId,
+    };
+    if (effect === undefined || effect === null || effect === '')
+        return currentForm;
+    if (typeof effect === 'string') {
+        const key = effect.trim();
+        if (key === 'form' || key === '当前表单')
+            return currentForm;
+        if (key === 'formLayout' || key === '表单布局') {
+            const lay = await client.post(`${baseUrl}/api/ebuilder/form/builder/getFormLayout`, {
+                formId, module: MODULE, customParam: {}, formTableIdList: [],
+                designerParam: { onlyLayout: false, convert: false }, form: { id: formId },
+            }, { ebbusinessid: formId });
+            // ⚠ 要的是 **multipleLayoutId**，不是 formLayout.id。同一张表上这两个值**相邻但不同**
+            // （实测某表 1316387710787854375 / …376），设计器发的是后者。发错不报错，
+            // 只是指向另一个布局，而且平台按它解析不出名字 → 回读的生效范围是个空白。
+            const layoutId = String(lay?.data?.formLayout?.multipleLayoutId || lay?.data?.formLayoutMultiple?.id || '');
+            if (!layoutId) {
+                throw new Error('取不到表单的布局 id，无法把生效维度设为「表单布局」'
+                    + `（${lay?.msg || 'getFormLayout 未返回 multipleLayoutId'}）`);
+            }
+            return {
+                effectType: 'formLayout', effectName: '表单布局', effectValue: layoutId,
+            };
+        }
+        throw new Error(`未知的生效维度「${effect}」。可用：form（当前表单）、formLayout（表单布局），`
+            + '或直接给一个 {effectType, effectName, effectValue} 对象');
+    }
+    if (!effect.effectType || !effect.effectValue) {
+        throw new Error('effect 对象至少要有 effectType 与 effectValue');
+    }
+    return {
+        effectType: String(effect.effectType),
+        effectName: String(effect.effectName || effect.effectType),
+        effectValue: String(effect.effectValue),
+        optionName: effect.optionName,
+    };
+}
+/**
+ * 「当前工作流」维度的选项显示名：**流程名 + `【V{活动版本号}】`**。
+ *
+ * 这不是拼着好看的 —— 设计器发的就是这个形状（流程叫 `11111`、报文里是 `11111【V1】`），
+ * 版本号取自流程的活动版本。取不到版本号时退回纯流程名，不编一个版本上去。
+ */
+export function workflowEffectName(name, activeVersionId) {
+    const base = String(name || '').trim();
+    const ver = activeVersionId === undefined || activeVersionId === null || activeVersionId === ''
+        ? '' : String(activeVersionId);
+    return ver ? `${base}【V${ver}】` : base;
+}
+/** 从 `quickBuild/getAllVersionInfo` 的返回里挑出活动版本的 versionId。 */
+export function activeVersionIdOf(versionRows) {
+    const rows = Array.isArray(versionRows) ? versionRows : [];
+    const active = rows.find((v) => v?.isActive === true || v?.isActive === 'true');
+    return String(active?.versionId ?? '');
+}
+/**
+ * **流程表单那条路由**的生效维度（四种）。从 `wf-form linkage` 的 action 里搬出来的 ——
+ * 函数联动同样要这四种，别再内联第二份。
+ *
+ * | 维度 | effectType | 取值 | 选项名 |
+ * |---|---|---|---|
+ * | 当前表单（缺省） | `form` | formId | `当前表单` |
+ * | 表单布局 | `formLayout` | `formLayoutMultiple.id` | 布局名 |
+ * | 当前工作流 | `workFlow` | workflowId | `流程名【V活动版本号】` |
+ * | 选择节点 | `includeNode` | nodeId | 节点名 |
+ *
+ * ⚠ 返回的 `refId` 是**这条联动挂在谁身上**，在这条路由上就是**流程 ID**；它**不等于**
+ * `optionList[0].effectValue` —— 选「选择节点」时取值是节点 ID，`refId` 仍是流程 ID。别照着取值抄。
+ */
+export async function resolveWorkflowEffect(client, baseUrl, ctx) {
+    const { formId } = ctx;
+    const workflowId = String(ctx.workflowId || '');
+    const key = String(ctx.dimension || '').trim();
+    const ebb = { ebbusinessid: formId };
+    const refId = workflowId || formId;
+    if (key === 'includeNode' || key === '选择节点') {
+        if (!workflowId) {
+            throw new Error('生效维度选「选择节点」时必须给 --workflow-id（要按它列节点，refId 也是它）');
+        }
+        const nodeKey = String(ctx.nodeKey || '').trim();
+        if (!nodeKey)
+            throw new Error('生效维度选「选择节点」时要在 config 里给 "nodeId"（或 "node" 写节点名）');
+        // 用 getNodeEditTable（与 `workflow nodes --mode list` 同一个），不是 getWorkflowNodesByWorkflowId
+        // —— 后者对刚建的流程回空，拿它查节点会全部找不到。
+        const meta = await client.get(`${baseUrl}/api/bs/workflow/pathdef/nodeBase/getNodeEditTable?workflowId=${workflowId}`);
+        const nodes = meta?.data?.data || [];
+        const hit = (Array.isArray(nodes) ? nodes : [])
+            .find((n) => String(n.id) === nodeKey || n.nodeName === nodeKey);
+        if (!hit) {
+            throw new Error(`在该流程里找不到节点「${nodeKey}」。用 \`workflow nodes ${workflowId} --mode list\` 看节点清单`);
+        }
+        return {
+            refId,
+            effect: {
+                effectType: 'includeNode', effectName: '选择节点',
+                effectValue: String(hit.id), optionName: String(hit.nodeName || hit.id),
+            },
+        };
+    }
+    if (key === 'formLayout' || key === '表单布局') {
+        const wantLayout = String(ctx.layoutId || '');
+        const layBody = {
+            formId, module: ctx.module, customParam: {}, formTableIdList: [],
+            designerParam: { onlyLayout: false, convert: false }, form: { id: formId },
+        };
+        if (wantLayout)
+            layBody.layoutMultiId = wantLayout;
+        const lay = await client.post(`${baseUrl}${ctx.route}/builder/getFormLayout`, layBody, ebb);
+        const flm = lay?.data?.formLayoutMultiple || {};
+        const layoutId = String(flm.id || '');
+        if (!layoutId) {
+            throw new Error('取不到该流程表单的布局，无法把生效维度设为「表单布局」'
+                + `（${lay?.msg || 'getFormLayout 未返回 formLayoutMultiple.id'}）`);
+        }
+        return {
+            refId,
+            effect: { effectType: 'formLayout', effectName: '表单布局', effectValue: layoutId, optionName: String(flm.name || '') },
+        };
+    }
+    if (key === 'workFlow' || key === '当前工作流') {
+        if (!workflowId) {
+            throw new Error('生效维度选「当前工作流」时必须给 --workflow-id（该维度的取值和 refId 都是流程 ID）。'
+                + '流程 ID 用 `workflow search --name <流程名>` 拿');
+        }
+        // 选项显示名带活动版本号，照设计器发出去的形状
+        const [wfRow, versions] = await Promise.all([
+            findWorkflowRow(client, baseUrl, workflowId),
+            client.get(`${baseUrl}/api/bs/workflow/pathdef/quickBuild/getAllVersionInfo?workflowId=${workflowId}`),
+        ]);
+        const optName = workflowEffectName(String(wfRow?.workflowName || ''), activeVersionIdOf(versions?.data));
+        return {
+            refId,
+            effect: { effectType: 'workFlow', effectName: '当前工作流', effectValue: workflowId, optionName: optName },
+        };
+    }
+    return {
+        refId,
+        effect: { effectType: 'form', effectName: '当前表单', effectValue: formId, optionName: '当前表单' },
+    };
+}
+/**
+ * 读 `--config`：`@` 开头当文件路径（UTF-8），否则当内联 JSON。
+ *
+ * 两个联动命令（eb 表 `form linkage add` 与工作流 `wf-form linkage`）共用 ——
+ * 前者支持 `@文件` 而后者不支持过，同一个 `--config` 两种行为，用起来会莫名其妙。
+ */
+export function readLinkageConfig(input) {
+    let raw = String(input ?? '');
+    if (raw.startsWith('@')) {
+        const filePath = raw.slice(1);
+        if (!existsSync(filePath)) {
+            throw new Error(`配置文件不存在: ${filePath}`);
+        }
+        raw = readFileSync(filePath, 'utf-8');
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch (e) {
+        throw new Error(`config JSON 解析失败: ${e.message}`);
+    }
+}
+/** 提交 `viewlinkage/add`。 */
+export async function addLinkage(client, baseUrl, appId, formId, payload) {
+    return client.post(`${baseUrl}${ADD_PATH}?apid=${appId}`, payload, { ebbusinessid: formId });
+}
+//# sourceMappingURL=form-linkage-condition.js.map

package/dist/services/form-linkage-condition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-linkage-condition.js","sourceRoot":"","sources":["../../src/services/form-linkage-condition.ts"],"names":[],"mappings":"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"}

package/dist/services/form-physical-table.d.ts

@@ -0,0 +1,115 @@
+import type { ApiClient } from '../core/client.js';
+/**
+ * 多物理表 —— 一个表单的字段分散在多张物理表上（字段数过多时的容量兜底）。
+ *
+ * 设计器里的落点是「字段管理 → **其他**」页签，与「主表」「明细表」并列。
+ *
+ * ## 与「明细表」是两根轴，别混
+ *
+ * | | 明细表（`form add-detail-table`） | **物理表（本文件）** |
+ * |---|---|---|
+ * | 建表端点 | `saveSubForm` | **`saveFormTable`** |
+ * | 标志 | `isSubForm: true` | **`isSubForm: false`** |
+ * | `tableType` | `MAIN` | **`SUBSIDIARY`** |
+ * | 语义 | 一对多业务建模 | 一个表单自己的字段拆到多张表 |
+ *
+ * ## ⚠ `id` 这个键在 `saveFormTable` 里是**表 id**
+ *
+ * 改名时传 `formTable.id` = 表记录 id；建档时不传，由平台分配。
+ * （对比：`batch/save/formField` 的 `formTableList[].id` 是 **formId**、`.formTableId` 才是表 id ——
+ * 那条路本 CLI 不再走，见下。）
+ *
+ * ## 往表里加字段**不在本文件**
+ *
+ * 加字段走 `form add-physical-field` → `services/form-field-build.ts`，机制是
+ * `saveFormFieldNew` + jsonObj 里的 `formTableId`。
+ *
+ * 曾经这里还有一条「建表时用 `batch/save/formField` + `formTableList` 连字段一起建、并靠改
+ * `formTableId` 搬字段」的路，**两个原因废弃**：
+ *   1. 改已有字段的 formTableId 被平台明确拒绝：`此字段不属于当前物理表，不能更改位置`
+ *   2. 那条路对形状不全的字段会**回 200 却静默不落库**（实测 DateTime / Attachment 等就中招）
+ *
+ * ## 抓包来源
+ *
+ * 2026-10-08，mulinquan app `1320953875231211521` / 表单 objId `1320953905305272320`，
+ * 以及自建临时表单上的实机验证（建表/改名/删表/加字段全通）。
+ */
+export declare const FIELD_MANAGE = "/api/ebuilder/form/form/field/manage";
+/** 附属物理表的 `tableType`。主物理表是 `MAIN`。 */
+export declare const SUB_TABLE_TYPE = "SUBSIDIARY";
+/** 一张物理表的标识。`formTableId` 是**表记录 id**，不是 formId。 */
+export interface FormTableRef {
+    formTableId: string;
+    /** 显示名，设计器里那排 chip 上的字（如「物理表1」）。 */
+    name: string;
+    /** 数据库表名（如 `uf_ryxxb_6_1`）。 */
+    tableName: string;
+}
+interface Scope {
+    formId: string;
+    appId: string;
+    objId: string;
+}
+/** 建表 / 改名共用的报文。**带 `formTableId` 就是改名，不带就是新建。** */
+export declare function buildSaveFormTablePayload(scope: Scope, table: {
+    name: string;
+    tableName: string;
+    formTableId?: string;
+}): any;
+/** 删表报文。`ids` 是**表 id** 的数组，不是 formId。 */
+export declare function buildDeleteFormTablePayload(scope: Scope, formTableIds: string[]): any;
+/**
+ * 从 `saveFormTable` 的响应里取新建/改名后的表 id。
+ *
+ * ⚠ **故意不认 `data.id` / `data.formTable.id`** —— 那个 `id` 在这个子系统里另有含义
+ * （在 `formTableList` 里它是 **formId**）。猜错不是报错，而是把字段**静默绑到别的表上**，
+ * 属于本项目明令避免的失败模式。只认键名明确叫 formTableId 的。
+ *
+ * 实机验证（2026-10-08，mulinquan 临时表单）：建表/改名都返回
+ *   `{"code":200,"msg":"接口返回成功","status":true,"data":{"formTableId":"..."},"fail":false}`
+ * 认不出来就返回空串，由调用方把原始响应打出来给人看。
+ */
+export declare function extractFormTableId(response: any): string;
+/** 读全量字段（扁平记录，含 `formTableId`）—— 用来回读确认字段到底落在哪张表上。 */
+export declare function readFieldRecords(client: ApiClient, baseUrl: string, appId: string, scope: Scope): Promise<any[]>;
+/** 一个表单的一张物理表。`formTableId` 是**表记录 id**（不是 formId）。 */
+export interface PhysicalTable {
+    formTableId: string;
+    /** 显示名 —— 设计器「字段管理」那排 chip 上的字。主表的这幅名字就是表单名。 */
+    name: string;
+    tableName: string;
+    /** `MAIN`（主表）或 `SUBSIDIARY`（附属物理表）。 */
+    tableType: string;
+    /** 平台内置表（如系统业务表），一般不该动。 */
+    systemTable: boolean;
+    dataCount: number;
+}
+/**
+ * 列出一个表单的**全部物理表**（含主表）—— 就是设计器「字段管理」那排 chip 的数据源。
+ *
+ * ⚠ 响应里每条记录的 `id` 键是 **formId**、`formTableId` 才是表 id（本子系统里 `id` 反复是这个陷阱，
+ * 建表响应也一样）。只读 `formTableId`。
+ *
+ * 实机验证（2026-10-08，mulinquan 表单 `1323898521989193728`）返回三条：主表(MAIN) + 表1/表2(SUBSIDIARY)，
+ * 显示名与建表时给的一致 —— 这条接口是「formTableId 建完只能靠记」那个缺口的补法。
+ */
+export declare function listFormTables(client: ApiClient, baseUrl: string, appId: string, scope: Scope): Promise<PhysicalTable[]>;
+/**
+ * `fieldId → 所在物理表`。`records` 来自 {@link readFieldRecords}（扁平记录，带 `formTableId`）。
+ *
+ * ⚠ 实测：**主表字段的记录里 `formTableId` 可能整个键都不在**（同一张主表上，走 `form create` 建的
+ * 字段没这个键、走 `saveFormFieldNew` 建的有）。附属表的字段则都带自己的表 id。
+ * 所以取不到 / 对不上任何一张已知表时**一律归主表** —— 平台不写就是「默认那张」，
+ * 比留空或编一个表名诚实。
+ */
+export declare function mapFieldsToTables(records: any[], tables: PhysicalTable[]): Record<string, PhysicalTable>;
+/** 建表（不传 formTableId）或改名（传 formTableId）。 */
+export declare function saveFormTable(client: ApiClient, baseUrl: string, appId: string, scope: Scope, table: {
+    name: string;
+    tableName: string;
+    formTableId?: string;
+}): Promise<any>;
+/** 删表。 */
+export declare function deleteFormTables(client: ApiClient, baseUrl: string, appId: string, scope: Scope, formTableIds: string[]): Promise<any>;
+export {};
+//# sourceMappingURL=form-physical-table.d.ts.map

package/dist/services/form-physical-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-physical-table.d.ts","sourceRoot":"","sources":["../../src/services/form-physical-table.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,eAAO,MAAM,YAAY,yCAAyC,CAAC;AAEnE,uCAAuC;AACvC,eAAO,MAAM,cAAc,eAAe,CAAC;AAE3C,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,KAAK;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,oDAAoD;AACpD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D,GAAG,CAcL;AAED,0CAA0C;AAC1C,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,GAAG,CAOrF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,GAAG,GAAG,MAAM,CAUxD;AAED,sDAAsD;AACtD,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAC9D,OAAO,CAAC,GAAG,EAAE,CAAC,CAahB;AAED,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAC9D,OAAO,CAAC,aAAa,EAAE,CAAC,CAiB1B;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,GACtC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAY/B;AAED,4CAA4C;AAC5C,wBAAsB,aAAa,CACjC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAC/D,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D,OAAO,CAAC,GAAG,CAAC,CAMd;AAED,UAAU;AACV,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,GACtF,OAAO,CAAC,GAAG,CAAC,CAMd"}

package/dist/services/form-physical-table.js

@@ -0,0 +1,153 @@
+/**
+ * 多物理表 —— 一个表单的字段分散在多张物理表上（字段数过多时的容量兜底）。
+ *
+ * 设计器里的落点是「字段管理 → **其他**」页签，与「主表」「明细表」并列。
+ *
+ * ## 与「明细表」是两根轴，别混
+ *
+ * | | 明细表（`form add-detail-table`） | **物理表（本文件）** |
+ * |---|---|---|
+ * | 建表端点 | `saveSubForm` | **`saveFormTable`** |
+ * | 标志 | `isSubForm: true` | **`isSubForm: false`** |
+ * | `tableType` | `MAIN` | **`SUBSIDIARY`** |
+ * | 语义 | 一对多业务建模 | 一个表单自己的字段拆到多张表 |
+ *
+ * ## ⚠ `id` 这个键在 `saveFormTable` 里是**表 id**
+ *
+ * 改名时传 `formTable.id` = 表记录 id；建档时不传，由平台分配。
+ * （对比：`batch/save/formField` 的 `formTableList[].id` 是 **formId**、`.formTableId` 才是表 id ——
+ * 那条路本 CLI 不再走，见下。）
+ *
+ * ## 往表里加字段**不在本文件**
+ *
+ * 加字段走 `form add-physical-field` → `services/form-field-build.ts`，机制是
+ * `saveFormFieldNew` + jsonObj 里的 `formTableId`。
+ *
+ * 曾经这里还有一条「建表时用 `batch/save/formField` + `formTableList` 连字段一起建、并靠改
+ * `formTableId` 搬字段」的路，**两个原因废弃**：
+ *   1. 改已有字段的 formTableId 被平台明确拒绝：`此字段不属于当前物理表，不能更改位置`
+ *   2. 那条路对形状不全的字段会**回 200 却静默不落库**（实测 DateTime / Attachment 等就中招）
+ *
+ * ## 抓包来源
+ *
+ * 2026-10-08，mulinquan app `1320953875231211521` / 表单 objId `1320953905305272320`，
+ * 以及自建临时表单上的实机验证（建表/改名/删表/加字段全通）。
+ */
+export const FIELD_MANAGE = '/api/ebuilder/form/form/field/manage';
+/** 附属物理表的 `tableType`。主物理表是 `MAIN`。 */
+export const SUB_TABLE_TYPE = 'SUBSIDIARY';
+/** 建表 / 改名共用的报文。**带 `formTableId` 就是改名，不带就是新建。** */
+export function buildSaveFormTablePayload(scope, table) {
+    return {
+        module: 'ebuilderform',
+        formTable: {
+            // ⚠ 有 id = 改名（指向已有表），没有 id = 新建。同一个键两种语义。
+            ...(table.formTableId ? { id: table.formTableId } : {}),
+            name: table.name,
+            tableName: table.tableName,
+            tableType: SUB_TABLE_TYPE,
+            form: { id: scope.formId },
+            otherProperties: '{}',
+        },
+        customParam: { appId: scope.appId, objId: scope.objId },
+    };
+}
+/** 删表报文。`ids` 是**表 id** 的数组，不是 formId。 */
+export function buildDeleteFormTablePayload(scope, formTableIds) {
+    return {
+        module: 'ebuilderform',
+        formId: scope.formId,
+        ids: formTableIds,
+        customParam: { appId: scope.appId, objId: scope.objId },
+    };
+}
+/**
+ * 从 `saveFormTable` 的响应里取新建/改名后的表 id。
+ *
+ * ⚠ **故意不认 `data.id` / `data.formTable.id`** —— 那个 `id` 在这个子系统里另有含义
+ * （在 `formTableList` 里它是 **formId**）。猜错不是报错，而是把字段**静默绑到别的表上**，
+ * 属于本项目明令避免的失败模式。只认键名明确叫 formTableId 的。
+ *
+ * 实机验证（2026-10-08，mulinquan 临时表单）：建表/改名都返回
+ *   `{"code":200,"msg":"接口返回成功","status":true,"data":{"formTableId":"..."},"fail":false}`
+ * 认不出来就返回空串，由调用方把原始响应打出来给人看。
+ */
+export function extractFormTableId(response) {
+    const candidates = [
+        response?.data?.formTableId,
+        response?.data?.formTable?.formTableId,
+        response?.formTableId,
+    ];
+    for (const c of candidates) {
+        if (c !== undefined && c !== null && String(c).trim())
+            return String(c);
+    }
+    return '';
+}
+/** 读全量字段（扁平记录，含 `formTableId`）—— 用来回读确认字段到底落在哪张表上。 */
+export async function readFieldRecords(client, baseUrl, appId, scope) {
+    const r = await client.post(`${baseUrl}${FIELD_MANAGE}/getFormFieldPage?apid=${encodeURIComponent(appId)}`, {
+        pageNo: 1,
+        pageSize: 500,
+        module: 'ebuilderform',
+        customParam: { appId: scope.appId, objId: scope.objId },
+        formFieldSearchEntity: { isDelete: 0, status: 'enable', formId: scope.formId },
+    }, { ebbusinessid: scope.formId });
+    return r?.data?.pageDatas?.result || r?.data?.data?.records || r?.data?.data || [];
+}
+/**
+ * 列出一个表单的**全部物理表**（含主表）—— 就是设计器「字段管理」那排 chip 的数据源。
+ *
+ * ⚠ 响应里每条记录的 `id` 键是 **formId**、`formTableId` 才是表 id（本子系统里 `id` 反复是这个陷阱，
+ * 建表响应也一样）。只读 `formTableId`。
+ *
+ * 实机验证（2026-10-08，mulinquan 表单 `1323898521989193728`）返回三条：主表(MAIN) + 表1/表2(SUBSIDIARY)，
+ * 显示名与建表时给的一致 —— 这条接口是「formTableId 建完只能靠记」那个缺口的补法。
+ */
+export async function listFormTables(client, baseUrl, appId, scope) {
+    const r = await client.post(`${baseUrl}${FIELD_MANAGE}/getFormAGroupList?apid=${encodeURIComponent(appId)}`, { module: 'ebuilderform', formId: scope.formId, customParam: { appId: scope.appId, objId: scope.objId } }, { ebbusinessid: scope.formId });
+    const list = r?.data?.formList || [];
+    return list
+        .filter((t) => t?.formTableId)
+        .map((t) => ({
+        formTableId: String(t.formTableId),
+        name: String(t.name ?? ''),
+        tableName: String(t.tableName ?? ''),
+        tableType: String(t.tableType ?? ''),
+        systemTable: !!t.systemTable,
+        dataCount: Number(t.dataCount ?? 0),
+    }));
+}
+/**
+ * `fieldId → 所在物理表`。`records` 来自 {@link readFieldRecords}（扁平记录，带 `formTableId`）。
+ *
+ * ⚠ 实测：**主表字段的记录里 `formTableId` 可能整个键都不在**（同一张主表上，走 `form create` 建的
+ * 字段没这个键、走 `saveFormFieldNew` 建的有）。附属表的字段则都带自己的表 id。
+ * 所以取不到 / 对不上任何一张已知表时**一律归主表** —— 平台不写就是「默认那张」，
+ * 比留空或编一个表名诚实。
+ */
+export function mapFieldsToTables(records, tables) {
+    const byTableId = new Map(tables.map((t) => [t.formTableId, t]));
+    const main = tables.find((t) => t.tableType === 'MAIN');
+    const out = {};
+    for (const r of records) {
+        const fieldId = r?.fieldId;
+        if (!fieldId)
+            continue;
+        const hit = byTableId.get(String(r.formTableId));
+        if (hit)
+            out[String(fieldId)] = hit;
+        else if (main)
+            out[String(fieldId)] = main;
+    }
+    return out;
+}
+/** 建表（不传 formTableId）或改名（传 formTableId）。 */
+export async function saveFormTable(client, baseUrl, appId, scope, table) {
+    return client.post(`${baseUrl}${FIELD_MANAGE}/saveFormTable?apid=${encodeURIComponent(appId)}`, buildSaveFormTablePayload(scope, table), { ebbusinessid: scope.formId });
+}
+/** 删表。 */
+export async function deleteFormTables(client, baseUrl, appId, scope, formTableIds) {
+    return client.post(`${baseUrl}${FIELD_MANAGE}/deleteFormTable?apid=${encodeURIComponent(appId)}`, buildDeleteFormTablePayload(scope, formTableIds), { ebbusinessid: scope.formId });
+}
+//# sourceMappingURL=form-physical-table.js.map

package/dist/services/form-physical-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-physical-table.js","sourceRoot":"","sources":["../../src/services/form-physical-table.ts"],"names":[],"mappings":"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"}