mcp-xdx-schema-ctx 1.1.9

package/dist/tools/form-tools.js

@@ -0,0 +1,715 @@
+import { z } from "zod";
+import { T, WARNING, envelope, ok, sqlPagination, topNPagination, } from "../shared.js";
+import { getTableInfo, hasCol, resolveSelect, tableExists, tryQuery, } from "../schema-compat.js";
+import { buildWhere, buildOrderBy, buildPagedQuery } from "../sql-build.js";
+/** [Col1], [Col2] ... */
+const sel = (cols) => cols.map((c) => `[${c}]`).join(", ");
+/** 子模块不可用时的统一结构 */
+function unavailable(module, tableRef, warnings) {
+    const reason = `环境库缺少 ${tableRef}`;
+    warnings.push({
+        module,
+        message: reason,
+        hint: "可改用 include=basic 只取窗体定义；或用 get_capabilities 查看本环境支持的模块",
+        fallback: "get_capabilities",
+    });
+    return { module, available: false, reason };
+}
+/**
+ * 子模块查询：先探测依赖表是否存在，再按实际列构造 SELECT。
+ * 缺表 → { available:false, reason }；缺列 → NULL 占位 + warning；查询失败 → tryQuery 降级。
+ */
+async function queryModule(module, tableRef, wanted, whereSql, warnings, orderSql = "") {
+    if (!(await tableExists(tableRef))) {
+        return unavailable(module, tableRef, warnings);
+    }
+    const rs = await resolveSelect(tableRef, wanted);
+    if (rs.missing.length > 0) {
+        warnings.push({
+            module,
+            message: `以下列在本环境库不存在，已置空: ${rs.missing.join(", ")}`,
+        });
+    }
+    const rows = await tryQuery(module, `SELECT ${rs.select} FROM ${tableRef}${whereSql}${orderSql}`, warnings);
+    return { module, available: true, items: rows };
+}
+export function registerFormTools(server) {
+    // ============================================================
+    // get_form_full
+    // ============================================================
+    server.registerTool("get_form_full", {
+        description: WARNING +
+            "\n\n【核心工具】获取窗体完整配置，串联: 窗体定义→表格规则→字段规则→按钮权限→颜色规则→联动规则→右键菜单→参照规则→按钮布局→数据源→SQL替换→数据流。支持按 include 参数选择返回模块。\n" +
+            "每个子模块独立探测依赖表：缺失时该模块返回 { module, available:false, reason } 并写入 warnings，不会因某张子表缺失导致整体失败；include=basic 永不失败。",
+        inputSchema: {
+            formId: z.string().max(128).optional().describe("窗体ID，如 SaleOrder"),
+            formName: z.string().max(200).optional().describe("窗体名称关键词"),
+            tableName: z.string().max(128).optional().describe("按关联表名查找"),
+            formType: z
+                .string()
+                .max(50)
+                .optional()
+                .describe("按FormType过滤，如 List/Edit/View"),
+            include: z
+                .string()
+                .max(200)
+                .optional()
+                .describe("返回模块，逗号分隔: basic,colors,links,menus,refers,buttons,datasource,sqlReplaces,dataflows。默认全部(all)"),
+            page: z.number().int().min(1).default(1).describe("页码"),
+            pageSize: z
+                .number()
+                .int()
+                .min(1)
+                .max(200)
+                .default(10)
+                .describe("每页数量（列表模式生效）"),
+        },
+    }, async ({ formId, formName, tableName, formType, include, page = 1, pageSize = 10, }) => {
+        const warnings = [];
+        const mods = include ? include.split(",").map((s) => s.trim()) : ["all"];
+        const has = (name) => mods.includes("all") || mods.includes(name);
+        // ---- 第一步：只查 FormSetTB（登记窗体），任何子表缺失都不影响这一步 ----
+        const formInfo = await getTableInfo(T("formDef"));
+        if (!formInfo.exists) {
+            return ok(envelope({
+                items: [],
+                pagination: null,
+                warnings: [
+                    {
+                        module: "get_form_full.basic",
+                        message: `环境库缺少 ${T("formDef")}，窗体定义不可用`,
+                        hint: "可用 get_capabilities 查看本环境支持的元数据表",
+                        fallback: "get_capabilities",
+                    },
+                ],
+            }));
+        }
+        const formSelect = await resolveSelect(T("formDef"), [
+            "FormID",
+            "FormName",
+            "LinkTable",
+            "FormType",
+            "ApiPath",
+            "ServiceType",
+        ]);
+        if (formSelect.missing.length > 0) {
+            warnings.push({
+                module: "get_form_full.basic",
+                message: `FormSetTB 缺少列，已置空: ${formSelect.missing.join(", ")}`,
+            });
+        }
+        const groups = [];
+        const safeId = formId ? formId.replace(/[^a-zA-Z0-9_]/g, "") : "";
+        if (safeId)
+            groups.push({ filters: [{ col: "FormID", op: "eq", value: safeId }] });
+        if (formName)
+            groups.push({ filters: [{ col: "FormName", op: "like", value: formName }] });
+        if (tableName)
+            groups.push({ filters: [{ col: "LinkTable", op: "eq", value: tableName }] });
+        if (formType)
+            groups.push({ filters: [{ col: "FormType", op: "eq", value: formType }] });
+        const { where, skipped } = buildWhere(formInfo.columns, groups);
+        if (skipped.length > 0) {
+            warnings.push({
+                module: "get_form_full.basic",
+                message: `以下列在本环境库不存在，条件已跳过: ${skipped.join(", ")}`,
+            });
+        }
+        const order = buildOrderBy(formInfo.columns, ["FormID"]);
+        let forms = [];
+        let pagination = null;
+        if (safeId) {
+            // 单窗体模式：不分页
+            forms = (await tryQuery("get_form_full.basic", `SELECT ${formSelect.select} FROM ${T("formDef")}${where}${order.orderBy}`, warnings));
+        }
+        else {
+            const q = buildPagedQuery({
+                table: T("formDef"),
+                cols: formSelect.present.length > 0 ? formSelect.present.map((c) => `[${c}]`) : ["[FormID]"],
+                where,
+                orderBy: order.orderBy,
+                page,
+                pageSize,
+            });
+            const cnt = await tryQuery("get_form_full.basic.count", q.countSql, warnings);
+            const total = Number(cnt[0]?.Total ?? 0);
+            forms =
+                total > 0
+                    ? (await tryQuery("get_form_full.basic", q.sql, warnings))
+                    : [];
+            pagination = sqlPagination(page, pageSize, total);
+        }
+        if (forms.length === 0) {
+            return ok(envelope({
+                items: [],
+                pagination,
+                warnings,
+                query: { formId, formName, tableName, formType, include },
+                hint: "未匹配到窗体。可用 list_forms(keyword=...) 先按中文名定位 FormID。",
+            }));
+        }
+        const result = [];
+        for (const f of forms) {
+            const fid = String(f.FormID ?? "").replace(/[^a-zA-Z0-9_]/g, "");
+            const linkTable = f.LinkTable;
+            const entry = {};
+            // --- basic 模块（永不失败）---
+            if (has("basic")) {
+                entry.form = f;
+                // 表格规则头
+                let rulePxdids = [];
+                if (await tableExists(T("formRuleHed"))) {
+                    const rs = await resolveSelect(T("formRuleHed"), [
+                        "XDID",
+                        "FormID",
+                        "MainTable",
+                        "DataSourceType",
+                        "GridType",
+                        "iPageSize",
+                        "KeyField",
+                        "ParentField",
+                        "PrimaryKeyField",
+                        "BillNoField",
+                        "ApiPath",
+                        "StyleVer",
+                        "DataSourceId",
+                        "DataSourceName",
+                    ]);
+                    const ruleHeds = await tryQuery("get_form_full.ruleHeds", `SELECT ${rs.select} FROM ${T("formRuleHed")} WHERE [FormID]='${fid}'`, warnings);
+                    rulePxdids = ruleHeds
+                        .map((r) => `'${String(r.XDID)}'`)
+                        .filter((s) => s !== "'undefined'");
+                    entry.ruleHeds = ruleHeds;
+                }
+                else {
+                    entry.ruleHeds = unavailable("ruleHeds", T("formRuleHed"), warnings);
+                }
+                // 字段规则明细
+                if (rulePxdids.length > 0 && (await tableExists(T("formRuleDet")))) {
+                    const rs = await resolveSelect(T("formRuleDet"), [
+                        "PXDID",
+                        "FieldName",
+                        "FieldDesc",
+                        "bReadOnly",
+                        "bShow",
+                        "bRequired",
+                        "bSearchField",
+                        "cControlType",
+                        "iWidth",
+                        "SummaryType",
+                        "cDataSource",
+                        "DefaultValue",
+                    ]);
+                    const showCond = hasCol((await getTableInfo(T("formRuleDet"))).columns, "bShow")
+                        ? " AND [bShow]=1"
+                        : "";
+                    entry.ruleDets = await tryQuery("get_form_full.ruleDets", `SELECT ${rs.select} FROM ${T("formRuleDet")} WHERE [PXDID] IN (${rulePxdids.join(",")})${showCond} ORDER BY [FieldName]`, warnings);
+                }
+                else {
+                    entry.ruleDets = [];
+                }
+                // 按钮状态
+                entry.buttonStates = await queryModule("buttonStates", T("formState"), [
+                    "FormID",
+                    "ButtonText",
+                    "AddState",
+                    "UpdState",
+                    "AuditState",
+                    "ViewState",
+                    "ConfirmState",
+                    "ReCheckState",
+                    "DisableState",
+                ], ` WHERE [FormID]='${fid}'`, warnings);
+                // 关联表定义 + 字段
+                if (linkTable) {
+                    if (await tableExists(T("tableDef"))) {
+                        const rs = await resolveSelect(T("tableDef"), [
+                            "TableName",
+                            "TableDesc",
+                            "TableType",
+                            "ParentTable",
+                            "Modular1",
+                            "Code",
+                            "EnglishDesc",
+                        ]);
+                        const rows = await tryQuery("get_form_full.linkTable", `SELECT ${rs.select} FROM ${T("tableDef")} WHERE [TableName]='${linkTable.replace(/'/g, "''")}'`, warnings);
+                        entry.linkTable = rows[0] ?? null;
+                    }
+                    else {
+                        entry.linkTable = unavailable("linkTable", T("tableDef"), warnings);
+                    }
+                    if (await tableExists(T("fieldDef"))) {
+                        const rs = await resolveSelect(T("fieldDef"), [
+                            "TableName",
+                            "FieldName",
+                            "FieldDesc",
+                            "FieldType",
+                            "iPrecision",
+                            "bAllowNull",
+                            "bSearchField",
+                            "cLinkTable",
+                            "cLinkField",
+                            "EnglishDesc",
+                        ]);
+                        const info = await getTableInfo(T("fieldDef"));
+                        const ord = buildOrderBy(info.columns, ["iLineNo"]).orderBy;
+                        entry.tableFields = await tryQuery("get_form_full.tableFields", `SELECT ${rs.select} FROM ${T("fieldDef")} WHERE [TableName]='${linkTable.replace(/'/g, "''")}'${ord}`, warnings);
+                    }
+                    else {
+                        entry.tableFields = unavailable("tableFields", T("fieldDef"), warnings);
+                    }
+                }
+                else {
+                    entry.linkTable = null;
+                    entry.tableFields = [];
+                }
+                // 同表关联窗体
+                entry.relatedForms = await tryQuery("get_form_full.relatedForms", `SELECT TOP 10 ${formSelect.select} FROM ${T("formDef")} WHERE [LinkTable]='${String(linkTable ?? "").replace(/'/g, "''")}' AND [FormID]!='${fid}'`, warnings);
+            }
+            // --- colors ---
+            if (has("colors")) {
+                entry.colors = await queryModule("colors", T("formRuleColor"), [
+                    "FormID",
+                    "TableName",
+                    "XDBgColor",
+                    "XDFgColor",
+                    "ColorDesc",
+                    "TempField",
+                ], ` WHERE [FormID]='${fid}'`, warnings);
+            }
+            // --- links ---
+            if (has("links")) {
+                entry.links = await queryModule("links", T("formRuleLink"), [
+                    "FormID",
+                    "TableName",
+                    "ShowField",
+                    "FieldName",
+                    "LinkForm",
+                    "LinkField",
+                    "bDoubleClick",
+                ], ` WHERE [FormID]='${fid}'`, warnings);
+            }
+            // --- menus ---
+            if (has("menus")) {
+                entry.menus = await queryModule("menus", T("formRuleMenu"), [
+                    "FormID",
+                    "TableName",
+                    "MenuName",
+                    "FieldName",
+                    "LinkForm",
+                    "LinkField",
+                    "bStop",
+                    "cVisibleState",
+                    "iFormWidth",
+                    "iFormHeight",
+                    "bDialog",
+                    "ExCondition",
+                    "Params",
+                ], ` WHERE [FormID]='${fid}'`, warnings, " ORDER BY [FormID], [iLineNo]");
+            }
+            // --- refers ---
+            if (has("refers")) {
+                if (!(await tableExists(T("formRuleReferHed")))) {
+                    entry.refers = unavailable("refers", T("formRuleReferHed"), warnings);
+                }
+                else {
+                    const rs = await resolveSelect(T("formRuleReferHed"), [
+                        "XDID",
+                        "PXDID",
+                        "ReferFormName",
+                        "ReferForm",
+                        "Condition",
+                        "Remark",
+                        "iSort",
+                        "iLineNo",
+                    ]);
+                    const refs = await tryQuery("get_form_full.refers", `SELECT TOP 20 ${rs.select} FROM ${T("formRuleReferHed")} WHERE [PXDID] IN (SELECT [XDID] FROM ${T("formRuleHed")} WHERE [FormID]='${fid}')`, warnings);
+                    const refersResult = [];
+                    for (const ref of refs) {
+                        const r = ref;
+                        const referId = String(r.XDID);
+                        refersResult.push({
+                            referInfo: r,
+                            displayFields: await queryModule("refers.displayFields", T("formRuleRefer"), [
+                                "PXDID",
+                                "ValueField",
+                                "Remark",
+                                "bReferField",
+                                "iSort",
+                                "ValueTable",
+                                "ReferForm",
+                                "ReferTable",
+                                "ReferValue",
+                                "Condition",
+                            ], ` WHERE [PXDID]='${referId}'`, warnings),
+                            cases: await queryModule("refers.cases", T("formRuleReferCase"), [
+                                "PXDID",
+                                "CaseName",
+                                "Condition",
+                                "Remark",
+                                "LinkFormName",
+                                "Params",
+                            ], ` WHERE [PXDID]='${referId}'`, warnings),
+                            filters: await queryModule("refers.filters", T("formRuleReferFilter"), [
+                                "PXDID",
+                                "FieldName",
+                                "CompareWay",
+                                "FieldValue",
+                                "Remark",
+                                "Condition",
+                                "FilterTable",
+                            ], ` WHERE [PXDID]='${referId}'`, warnings),
+                        });
+                    }
+                    entry.refers = { module: "refers", available: true, items: refersResult };
+                }
+            }
+            // --- buttons ---
+            if (has("buttons")) {
+                entry.buttons = await queryModule("buttons", T("formRuleButton"), [
+                    "FormID",
+                    "cPosition",
+                    "ButtonCaption",
+                    "XDID",
+                    "Sort",
+                ], ` WHERE [FormID]='${fid}'`, warnings, " ORDER BY [FormID], [cPosition], [Sort]");
+            }
+            // --- datasource ---
+            if (has("datasource")) {
+                entry.dataSources = await queryModule("datasource", T("formRuleDataSource"), [
+                    "ID",
+                    "Code",
+                    "Name",
+                    "ServiceType",
+                    "AssemblyName",
+                    "DataSourceXDID",
+                    "BillNoField",
+                ], "", warnings, " ORDER BY [Code]");
+            }
+            // --- sqlReplaces ---
+            if (has("sqlReplaces")) {
+                entry.sqlReplaces = await queryModule("sqlReplaces", T("formRuleSQLReplace"), [
+                    "FormID",
+                    "cAction",
+                    "OldSQL",
+                    "NewSQL",
+                    "Sort",
+                ], ` WHERE [FormID]='${fid}'`, warnings, " ORDER BY [FormID], [Sort]");
+            }
+            // --- dataflows ---
+            if (has("dataflows")) {
+                entry.dataflows = await queryModule("dataflows", T("formRuleDataFlow"), ["FormID", "FlowName", "FlowNo", "bCreated", "bStop", "ShowFilter"], ` WHERE [FormID]='${fid}'`, warnings);
+            }
+            result.push(entry);
+        }
+        // 紧凑清单：字段名并集 + 各窗体模块计数（截断后仍可读；safeJson 保留 fieldNames/summary）
+        const fieldNameSet = new Set();
+        for (const entry of result) {
+            const tf = entry.tableFields;
+            if (Array.isArray(tf)) {
+                for (const f of tf) {
+                    if (f && f.FieldName)
+                        fieldNameSet.add(String(f.FieldName));
+                }
+            }
+        }
+        const fieldNames = [...fieldNameSet].slice(0, 500);
+        const summary = result.map((entry) => {
+            const form = entry.form;
+            const modules = {};
+            for (const [k, v] of Object.entries(entry)) {
+                if (Array.isArray(v))
+                    modules[k] = v.length;
+                else if (v &&
+                    typeof v === "object" &&
+                    Array.isArray(v.items)) {
+                    modules[k] = v.items.length;
+                }
+            }
+            return {
+                formId: form?.FormID ?? null,
+                formName: form?.FormName ?? null,
+                modules,
+            };
+        });
+        return ok(envelope({
+            items: result,
+            pagination,
+            warnings,
+            query: { formId, formName, tableName, formType, include },
+            moduleStatus: mods.includes("all")
+                ? "all"
+                : mods.filter((m) => m !== "all"),
+            fieldNames,
+            summary,
+        }));
+    });
+    // ============================================================
+    // get_form（窗体存在性 — 只查 FormSetTB）
+    // ============================================================
+    server.registerTool("get_form", {
+        description: WARNING +
+            "\n\n【窗体存在性】只查询 FormSetTB 一行，永不因其它子表缺失而失败。用于把「中文窗体名 → FormID」变成正式能力。数据来源: XDWmsCommon.dbo.FormSetTB",
+        inputSchema: {
+            formId: z.string().max(128).optional().describe("窗体ID，如 FrmOutMoveEdit"),
+            formName: z.string().max(200).optional().describe("窗体名称关键词"),
+        },
+    }, async ({ formId, formName }) => {
+        const warnings = [];
+        if (!formId && !formName) {
+            return ok(envelope({
+                items: [],
+                pagination: null,
+                warnings: [
+                    {
+                        module: "get_form",
+                        message: "请至少提供 formId 或 formName",
+                    },
+                ],
+            }));
+        }
+        const info = await getTableInfo(T("formDef"));
+        if (!info.exists) {
+            return ok(envelope({
+                items: [],
+                pagination: null,
+                warnings: [
+                    {
+                        module: "get_form",
+                        message: `环境库缺少 ${T("formDef")}`,
+                        hint: "可用 get_capabilities 查看本环境支持的元数据表",
+                        fallback: "get_capabilities",
+                    },
+                ],
+            }));
+        }
+        const rs = await resolveSelect(T("formDef"), [
+            "FormID",
+            "FormName",
+            "LinkTable",
+            "FormType",
+            "ApiPath",
+            "ServiceType",
+        ]);
+        const groups = [];
+        if (formId)
+            groups.push({
+                filters: [
+                    {
+                        col: "FormID",
+                        op: "eq",
+                        value: formId.replace(/[^a-zA-Z0-9_]/g, ""),
+                    },
+                ],
+            });
+        if (formName)
+            groups.push({
+                filters: [{ col: "FormName", op: "like", value: formName }],
+            });
+        const { where, skipped } = buildWhere(info.columns, groups);
+        if (skipped.length > 0) {
+            warnings.push({
+                module: "get_form",
+                message: `以下列在本环境库不存在，条件已跳过: ${skipped.join(", ")}`,
+            });
+        }
+        const items = await tryQuery("get_form", `SELECT TOP 50 ${rs.select} FROM ${T("formDef")}${where} ORDER BY [FormID]`, warnings);
+        if (items.length === 0 && warnings.length === 0) {
+            warnings.push({
+                module: "get_form",
+                message: "未匹配到窗体（FormSetTB 中无该 FormID/名称）",
+                hint: "可用 list_forms(keyword=...) 做模糊定位",
+            });
+        }
+        return ok(envelope({
+            items,
+            pagination: topNPagination(50, items.length),
+            warnings,
+        }));
+    });
+    // ============================================================
+    // list_forms（窗体清单 — 定位 FormID 的标准入口）
+    // ============================================================
+    server.registerTool("list_forms", {
+        description: WARNING +
+            "\n\n列出环境库已登记窗体（FormID/FormName/LinkTable/FormType）。支持按中文名/表名/窗体类型过滤，SQL 端真实分页。定位 XDFormID 的标准入口。数据来源: XDWmsCommon.dbo.FormSetTB",
+        inputSchema: {
+            keyword: z.string().max(200).optional().describe("窗体名/FormID 关键词"),
+            formType: z
+                .string()
+                .max(50)
+                .optional()
+                .describe("按 FormType 过滤，如 List/Edit/View"),
+            tableName: z.string().max(128).optional().describe("按关联表名过滤"),
+            page: z.number().int().min(1).default(1).describe("页码"),
+            pageSize: z
+                .number()
+                .int()
+                .min(1)
+                .max(200)
+                .default(50)
+                .describe("每页数量"),
+        },
+    }, async ({ keyword, formType, tableName, page = 1, pageSize = 50 }) => {
+        const warnings = [];
+        const info = await getTableInfo(T("formDef"));
+        if (!info.exists) {
+            return ok(envelope({
+                items: [],
+                pagination: sqlPagination(page, pageSize, 0),
+                warnings: [
+                    {
+                        module: "list_forms",
+                        message: `环境库缺少 ${T("formDef")}`,
+                        hint: "可用 get_capabilities 查看本环境支持的元数据表",
+                        fallback: "get_capabilities",
+                    },
+                ],
+            }));
+        }
+        const rs = await resolveSelect(T("formDef"), [
+            "FormID",
+            "FormName",
+            "LinkTable",
+            "FormType",
+        ]);
+        const groups = [];
+        if (keyword) {
+            const filters = ["FormID", "FormName"]
+                .filter((c) => hasCol(info.columns, c))
+                .map((c) => ({ col: c, op: "like", value: keyword }));
+            if (filters.length > 0)
+                groups.push({ logic: "or", filters });
+        }
+        if (formType)
+            groups.push({ filters: [{ col: "FormType", op: "eq", value: formType }] });
+        if (tableName)
+            groups.push({ filters: [{ col: "LinkTable", op: "eq", value: tableName }] });
+        const { where, skipped } = buildWhere(info.columns, groups);
+        if (skipped.length > 0) {
+            warnings.push({
+                module: "list_forms",
+                message: `以下列在本环境库不存在，条件已跳过: ${skipped.join(", ")}`,
+            });
+        }
+        const order = buildOrderBy(info.columns, ["FormID"]);
+        const q = buildPagedQuery({
+            table: T("formDef"),
+            cols: rs.present.length > 0 ? rs.present.map((c) => `[${c}]`) : ["[FormID]"],
+            where,
+            orderBy: order.orderBy,
+            page,
+            pageSize,
+        });
+        const cnt = await tryQuery("list_forms.count", q.countSql, warnings);
+        const total = Number(cnt[0]?.Total ?? 0);
+        const items = total > 0 ? await tryQuery("list_forms", q.sql, warnings) : [];
+        return ok(envelope({
+            items,
+            pagination: sqlPagination(page, pageSize, total),
+            warnings,
+        }));
+    });
+    // ============================================================
+    // get_user_form_schemes
+    // ============================================================
+    server.registerTool("get_user_form_schemes", {
+        description: WARNING +
+            "\n\n查询用户的个性化窗体方案。用户可自定义字段显示、列宽、冻结列等。数据来源: XDWmsCommon.dbo.UserFormSetHedTB + UserFormSetDetTB",
+        inputSchema: {
+            formId: z.string().max(128).optional().describe("窗体ID"),
+            userId: z.string().max(50).optional().describe("用户ID"),
+            schemeName: z.string().max(200).optional().describe("方案名称"),
+            page: z.number().int().min(1).default(1).describe("页码"),
+            pageSize: z
+                .number()
+                .int()
+                .min(1)
+                .max(200)
+                .default(50)
+                .describe("每页数量"),
+        },
+    }, async ({ formId, userId, schemeName, page = 1, pageSize = 50 }) => {
+        const warnings = [];
+        if (!(await tableExists(T("userFormHed")))) {
+            return ok(envelope({
+                items: [],
+                pagination: sqlPagination(page, pageSize, 0),
+                warnings: [
+                    {
+                        module: "get_user_form_schemes",
+                        message: `环境库缺少 ${T("userFormHed")}`,
+                        hint: "可用 get_capabilities 查看本环境支持的元数据表",
+                        fallback: "get_capabilities",
+                    },
+                ],
+            }));
+        }
+        const info = await getTableInfo(T("userFormHed"));
+        const rs = await resolveSelect(T("userFormHed"), [
+            "XDID",
+            "FormId",
+            "UserId",
+            "TableName",
+            "Remark",
+            "MakeDate",
+            "EditDate",
+        ]);
+        const groups = [];
+        if (formId)
+            groups.push({ filters: [{ col: "FormId", op: "eq", value: formId }] });
+        if (userId)
+            groups.push({ filters: [{ col: "UserId", op: "eq", value: userId }] });
+        if (schemeName)
+            groups.push({
+                filters: [{ col: "TableName", op: "like", value: schemeName }],
+            });
+        const { where, skipped } = buildWhere(info.columns, groups);
+        if (skipped.length > 0) {
+            warnings.push({
+                module: "get_user_form_schemes",
+                message: `以下列在本环境库不存在，条件已跳过: ${skipped.join(", ")}`,
+            });
+        }
+        const order = buildOrderBy(info.columns, [
+            "FormId",
+            { col: "EditDate", expr: "[EditDate] DESC" },
+        ]);
+        const q = buildPagedQuery({
+            table: T("userFormHed"),
+            cols: rs.present.length > 0 ? rs.present.map((c) => `[${c}]`) : ["[XDID]"],
+            where,
+            orderBy: order.orderBy,
+            page,
+            pageSize,
+        });
+        const cnt = await tryQuery("get_user_form_schemes.count", q.countSql, warnings);
+        const total = Number(cnt[0]?.Total ?? 0);
+        const schemes = total > 0
+            ? (await tryQuery("get_user_form_schemes", q.sql, warnings))
+            : [];
+        // 明细：逐方案查询（表缺失时降级）
+        const result = [];
+        for (const s of schemes) {
+            const schemeId = String(s.XDID ?? "");
+            result.push({
+                scheme: s,
+                fieldConfigs: await queryModule("get_user_form_schemes.detail", T("userFormDet"), [
+                    "PXDID",
+                    "FiledName",
+                    "Remark",
+                    "IsShow",
+                    "Width",
+                    "Index",
+                    "SummaryType",
+                ], ` WHERE [PXDID]='${schemeId.replace(/'/g, "''")}'`, warnings, " ORDER BY [Index]"),
+            });
+        }
+        return ok(envelope({
+            items: result,
+            pagination: sqlPagination(page, pageSize, total),
+            warnings,
+        }));
+    });
+}
+//# sourceMappingURL=form-tools.js.map