cloud-web-corejs 1.1.0-dev.10 → 1.1.0-dev.13

package/src/components/xform/utils/dynamicSchemaUtil.js

@@ -1,361 +1,385 @@
-/**
- * 后台动态定义（表头后台字段 / 数据表格动态列）共用协议。
- *
- * 单条定义顶层字段：
- * - 通用：keyName、type、label、optionItems、required 等字段级属性、options
- * - 表头：colspan
- * - 数据表格：width、formatS（展示列）、children（多级表头）、dropdownItems（dropdown 操作列）
- *
- * 请求体：{ formData, ...extra }
- * 响应体：objx 数组，或 { fields: [] } / { columns: [] }
- */
-
-/** 顶层字段白名单 */
-export const DYNAMIC_SCHEMA_CORE_KEYS = [
-  "keyName",
-  "type",
-  "label",
-  "optionItems",
-  "options",
-];
-
-/** 字段级属性：写顶层，不写 options（与表头 dynamicFieldMixin 一致） */
-export const DYNAMIC_SCHEMA_WIDGET_FLAG_KEYS = [
-  "required",
-  "readonly",
-  "disabled",
-  "hidden",
-  "defaultValue",
-  "placeholder",
-];
-
-export const DYNAMIC_SCHEMA_TABLE_HEADER_KEYS = ["colspan"];
-
-export const DYNAMIC_SCHEMA_COLUMN_EXTRA_KEYS = [
-  "width",
-  "align",
-  "sortable",
-  "filterable",
-  "show",
-  "fixed",
-  "formatS",
-  "render",
-  "utcTransformEnabled",
-  "children",
-  "dropdownItems",
-];
-
-export const DYNAMIC_SCHEMA_OPTION_KEYS = {
-  scriptCode: ["dynamicSchemaScriptCode", "dynamicColumnScriptCode"],
-  scriptParam: ["dynamicSchemaScriptParam", "dynamicColumnScriptParam"],
-  convert: ["dynamicSchemaConvert"],
-  mode: ["dynamicSchemaMode", "dynamicColumnMode"],
-  sourceType: ["dynamicSchemaSourceType", "dynamicColumnSourceType"],
-  loadScript: ["dynamicSchemaLoadScript", "dynamicColumnLoadScript"],
-  frontendScript: ["dynamicSchemaScript", "dynamicColumnsScript"],
-};
-
-export const widgetTypeToEditFormatMap = {
-  input: "editInput",
-  number: "editNumber",
-  date: "editDate",
-  select: "editSelect",
-  vabsearch: "editSearch",
-  baseAttachment: "editAttachment",
-  status: "editStatus",
-  text: "text",
-  checkbox: "checkbox",
-  radio: "radio",
-  textarea: "textarea",
-  "script-input": "editScriptInput",
-  "a-text": "aText",
-  "a-link": "aLink",
-  button: "button",
-  dropdown: "dropdown",
-};
-
-const ACTION_COLUMN_FORMATS = new Set(["aLink", "button", "dropdown"]);
-
-const NON_DATA_EXPORT_COLUMN_FORMATS = new Set([
-  "dropdown",
-  "button",
-  "editDelete",
-  "editButton",
-  "editTreeButtonGroup",
-  "addSiblingEditRow",
-  "addChildTreeRow",
-  "moveUpRow",
-  "moveDownRow",
-  "removeTreeRow",
-]);
-
-const NON_DATA_EXPORT_WIDGET_TYPES = new Set([
-  "button",
-  "dropdown",
-  "dropdown-item",
-  "divider",
-  "search_button",
-  "save_button",
-  "reset_button",
-  "table-export-button",
-  "select-export-button",
-  "select-export-item-button",
-  "add_button",
-  "import-button",
-  "import2-button",
-  "print-button",
-  "print-detail-button",
-  "download-button",
-  "save_submit_wf_button",
-  "copy_button",
-  "compare-change-button",
-  "compare-button",
-  "compare-close-button",
-  "compare-del-button",
-]);
-
-export function buildDropdownWidgetFromDef(def, index = 0) {
-  const options = def?.options;
-  const dropdownItems = def?.dropdownItems;
-  if (!Array.isArray(dropdownItems) || !dropdownItems.length) return null;
-
-  const ts = `${Date.now()}_${index}`;
-  const widgetList = dropdownItems.map((entry, i) => ({
-    type: "dropdown-item",
-    id: `dropdownitem_${ts}_${i}`,
-    options: {
-      label: entry.label || "",
-      onClick: entry.onClick || "",
-      disabled: !!entry.disabled,
-      hidden: !!entry.hidden,
-    },
-  }));
-
-  return {
-    type: "dropdown",
-    id: `dropdown_${ts}`,
-    options: {
-      label: def.label || "操作",
-      dropdownType: options?.dropdownType || "link",
-      dropdownTrigger: options?.dropdownTrigger || "hover",
-      dropdownFlag: 1,
-    },
-    widgetList,
-  };
-}
-
-function isActionColumn(item, formatS) {
-  return isActionColumnFormat(formatS, item?.type);
-}
-
-export function isActionColumnFormat(formatS, type) {
-  if (ACTION_COLUMN_FORMATS.has(formatS)) return true;
-  return ["a-link", "button", "dropdown"].includes(type);
-}
-
-export function isNonDataExportColumn(formatS, type, options) {
-  if (NON_DATA_EXPORT_COLUMN_FORMATS.has(formatS)) return true;
-  if (NON_DATA_EXPORT_WIDGET_TYPES.has(type)) return true;
-  // a-link can either display a bound field or act as a row operation button.
-  return (formatS === "aLink" || type === "a-link")
-    && options?.isFormLabel !== true;
-}
-
-function isActionOrGroupColumn(item, formatS) {
-  if (Array.isArray(item.children) && item.children.length) return true;
-  return isActionColumn(item, formatS);
-}
-
-function buildWidgetOptions(item, formatS, label) {
-  let widgetOptions =
-    item.options && typeof item.options === "object"
-      ? { ...item.options }
-      : null;
-
-  if (widgetOptions) {
-    delete widgetOptions.dropdownItems;
-  }
-
-  DYNAMIC_SCHEMA_WIDGET_FLAG_KEYS.forEach((key) => {
-    if (item[key] !== undefined) {
-      widgetOptions = widgetOptions || {};
-      widgetOptions[key] = item[key];
-    }
-  });
-
-  if (label) {
-    widgetOptions = widgetOptions || {};
-    if (!widgetOptions.label) {
-      widgetOptions.label = label;
-    }
-  }
-
-  if (!isActionColumn(item, formatS)) {
-    widgetOptions = widgetOptions || {};
-    widgetOptions.labelHidden = true;
-  }
-
-  return widgetOptions;
-}
-
-export function getDynamicSchemaOption(options, key) {
-  if (!options) return null;
-  const keys = DYNAMIC_SCHEMA_OPTION_KEYS[key] || [];
-  for (let i = 0; i < keys.length; i++) {
-    const val = options[keys[i]];
-    if (val !== undefined && val !== null && val !== "") {
-      return val;
-    }
-  }
-  return null;
-}
-
-export function resolveDynamicSchemaExtra(paramScript, handleCustomEvent) {
-  if (!paramScript || !handleCustomEvent) return {};
-  const result = handleCustomEvent(paramScript);
-  return result && typeof result === "object" && !Array.isArray(result)
-    ? result
-    : {};
-}
-
-export function buildDynamicSchemaRequestData(
-  formModel,
-  paramScript,
-  handleCustomEvent,
-  wrapContext
-) {
-  const extra = resolveDynamicSchemaExtra(paramScript, handleCustomEvent);
-  const payload = {
-    formData: formModel || {},
-    ...extra,
-  };
-  if (!wrapContext) {
-    return payload;
-  }
-  const { formCode, formVersion, taBm, dataId } = wrapContext;
-  return {
-    formCode,
-    formVersion,
-    taBm,
-    formData: payload.formData,
-    dataId,
-    data: {
-      dataId,
-      ...payload,
-    },
-  };
-}
-
-/** 从 objx 或转换脚本结果中提取定义数组 */
-export function extractDynamicSchemaItems(source) {
-  if (!source) return [];
-  if (Array.isArray(source)) return source;
-  if (typeof source !== "object") return [];
-  if (Array.isArray(source.fields)) return source.fields;
-  if (Array.isArray(source.columns)) return source.columns;
-  return [];
-}
-
-export function resolveDynamicSchemaResponse(res, convertScript, handleCustomEvent) {
-  if (convertScript && handleCustomEvent) {
-    const result = handleCustomEvent(convertScript, ["res"], [res]);
-    return extractDynamicSchemaItems(result);
-  }
-  return extractDynamicSchemaItems(res && res.objx);
-}
-
-export function normalizeDynamicFieldKey(item) {
-  if (!item || typeof item !== "object") return undefined;
-  return item.keyName;
-}
-
-export function normalizeDynamicColumnItem(item, index) {
-  if (!item || typeof item !== "object") {
-    return null;
-  }
-
-  const keyName = normalizeDynamicFieldKey(item);
-  const label = item.label;
-  let formatS = item.formatS || null;
-  if (!formatS && item.type) {
-    formatS = widgetTypeToEditFormatMap[item.type] || item.type;
-  }
-
-  let editFormatS = null;
-  if (formatS && String(formatS).startsWith("edit")) {
-    editFormatS = formatS;
-  }
-
-  const widgetOptions = buildWidgetOptions(item, formatS, label);
-
-  let widget = null;
-  let widgetList = null;
-  if (
-    (item.type === "dropdown" || formatS === "dropdown") &&
-    Array.isArray(item.dropdownItems) &&
-    item.dropdownItems.length
-  ) {
-    widget = buildDropdownWidgetFromDef(item, index);
-    if (widget && label) {
-      widget.options.label = label;
-    }
-    if (widget?.widgetList?.length) {
-      widgetList = widget.widgetList;
-    }
-  }
-
-  if (!keyName && !isActionOrGroupColumn(item, formatS)) {
-    return null;
-  }
-
-  const isAction = isActionColumn(item, formatS);
-
-  const widgetFlags = {};
-  DYNAMIC_SCHEMA_WIDGET_FLAG_KEYS.forEach((key) => {
-    if (item[key] !== undefined) {
-      widgetFlags[key] = item[key];
-    } else if (widgetOptions?.[key] !== undefined) {
-      widgetFlags[key] = widgetOptions[key];
-    }
-  });
-
-  const children = Array.isArray(item.children)
-    ? item.children
-        .map((child, childIndex) =>
-          normalizeDynamicColumnItem(child, index * 1000 + childIndex)
-        )
-        .filter(Boolean)
-    : item.children;
-
-  return {
-    columnId: item.columnId || `${Date.now()}_${index}`,
-    type: item.type,
-    prop: keyName || undefined,
-    label,
-    width: item.width ?? 150,
-    show: item.show !== false,
-    sortable: isAction ? item.sortable === true : item.sortable !== false,
-    filterable: isAction ? item.filterable === true : item.filterable !== false,
-    ...(item.align ? { align: item.align } : {}),
-    fixed: item.fixed,
-    formatS,
-    editFormatS: editFormatS || undefined,
-    optionItems: item.optionItems,
-    widget,
-    widgetList,
-    widgetOptions,
-    children: children,
-    render: item.render,
-    utcTransformEnabled: item.utcTransformEnabled,
-    ...widgetFlags,
-  };
-}
-
-export function normalizeDynamicColumns(columns) {
-  if (!Array.isArray(columns)) {
-    return [];
-  }
-  return columns
-    .map((item, index) => normalizeDynamicColumnItem(item, index))
-    .filter(Boolean);
-}
+/**
+ * 后台动态定义（表头后台字段 / 数据表格动态列）共用协议。
+ *
+ * 单条定义顶层字段：
+ * - 通用：keyName、type、label、optionItems、required 等字段级属性、options
+ * - 表头：colspan
+ * - 数据表格：width、formatS（展示列）、children（多级表头）、dropdownItems（dropdown 操作列）
+ *
+ * 请求体：{ formData, ...extra }
+ * 响应体：objx 数组，或 { fields: [] } / { columns: [] }
+ */
+
+/** 顶层字段白名单 */
+export const DYNAMIC_SCHEMA_CORE_KEYS = [
+  "keyName",
+  "type",
+  "label",
+  "optionItems",
+  "options",
+];
+
+/** 字段级属性：写顶层，不写 options（与表头 dynamicFieldMixin 一致） */
+export const DYNAMIC_SCHEMA_WIDGET_FLAG_KEYS = [
+  "required",
+  "readonly",
+  "disabled",
+  "hidden",
+  "defaultValue",
+  "placeholder",
+];
+
+export const DYNAMIC_SCHEMA_TABLE_HEADER_KEYS = ["colspan"];
+
+export const DYNAMIC_SCHEMA_COLUMN_EXTRA_KEYS = [
+  "width",
+  "align",
+  "sortable",
+  "filterable",
+  "show",
+  "fixed",
+  "formatS",
+  "render",
+  "utcTransformEnabled",
+  "children",
+  "dropdownItems",
+];
+
+export const DYNAMIC_SCHEMA_OPTION_KEYS = {
+  scriptCode: ["dynamicSchemaScriptCode", "dynamicColumnScriptCode"],
+  scriptParam: ["dynamicSchemaScriptParam", "dynamicColumnScriptParam"],
+  convert: ["dynamicSchemaConvert"],
+  mode: ["dynamicSchemaMode", "dynamicColumnMode"],
+  sourceType: ["dynamicSchemaSourceType", "dynamicColumnSourceType"],
+  loadScript: ["dynamicSchemaLoadScript", "dynamicColumnLoadScript"],
+  frontendScript: ["dynamicSchemaScript", "dynamicColumnsScript"],
+};
+
+export const widgetTypeToEditFormatMap = {
+  input: "editInput",
+  number: "editNumber",
+  date: "editDate",
+  select: "editSelect",
+  vabsearch: "editSearch",
+  baseAttachment: "editAttachment",
+  status: "editStatus",
+  text: "text",
+  checkbox: "checkbox",
+  radio: "radio",
+  textarea: "textarea",
+  "script-input": "editScriptInput",
+  "a-text": "aText",
+  "a-link": "aLink",
+  button: "button",
+  dropdown: "dropdown",
+};
+
+const ACTION_COLUMN_FORMATS = new Set(["aLink", "button", "dropdown"]);
+
+const NON_DATA_EXPORT_COLUMN_FORMATS = new Set([
+  "dropdown",
+  "button",
+  "editDelete",
+  "editButton",
+  "editTreeButtonGroup",
+  "addSiblingEditRow",
+  "addChildTreeRow",
+  "moveUpRow",
+  "moveDownRow",
+  "removeTreeRow",
+]);
+
+const NON_DATA_EXPORT_WIDGET_TYPES = new Set([
+  "button",
+  "dropdown",
+  "dropdown-item",
+  "divider",
+  "search_button",
+  "save_button",
+  "reset_button",
+  "table-export-button",
+  "select-export-button",
+  "select-export-item-button",
+  "add_button",
+  "import-button",
+  "import2-button",
+  "print-button",
+  "print-detail-button",
+  "download-button",
+  "save_submit_wf_button",
+  "copy_button",
+  "compare-change-button",
+  "compare-button",
+  "compare-close-button",
+  "compare-del-button",
+]);
+
+export function buildDropdownWidgetFromDef(def, index = 0) {
+  const options = def?.options;
+  const dropdownItems = def?.dropdownItems;
+  if (!Array.isArray(dropdownItems) || !dropdownItems.length) return null;
+
+  const ts = `${Date.now()}_${index}`;
+  const widgetList = dropdownItems.map((entry, i) => ({
+    type: "dropdown-item",
+    id: `dropdownitem_${ts}_${i}`,
+    options: {
+      label: entry.label || "",
+      onClick: entry.onClick || "",
+      disabled: !!entry.disabled,
+      hidden: !!entry.hidden,
+    },
+  }));
+
+  return {
+    type: "dropdown",
+    id: `dropdown_${ts}`,
+    options: {
+      label: def.label || "操作",
+      dropdownType: options?.dropdownType || "link",
+      dropdownTrigger: options?.dropdownTrigger || "hover",
+      dropdownFlag: 1,
+    },
+    widgetList,
+  };
+}
+
+function isActionColumn(item, formatS) {
+  return isActionColumnFormat(formatS, item?.type);
+}
+
+export function isActionColumnFormat(formatS, type) {
+  if (ACTION_COLUMN_FORMATS.has(formatS)) return true;
+  return ["a-link", "button", "dropdown"].includes(type);
+}
+
+export function isNonDataExportColumn(formatS, type, options) {
+  if (NON_DATA_EXPORT_COLUMN_FORMATS.has(formatS)) return true;
+  if (NON_DATA_EXPORT_WIDGET_TYPES.has(type)) return true;
+  // a-link can either display a bound field or act as a row operation button.
+  return (formatS === "aLink" || type === "a-link")
+    && options?.isFormLabel !== true;
+}
+
+/**
+ * 该列导出时是否只输出空值（列本身仍保留，表头与列位置不变）。
+ *
+ * 目前只有一种：**没有配「导出类型」的附件列**。附件的内容是文件，不配导出类型就意味着
+ * 这次导出既不写图片、也没有任何有意义的文本可写；而附件列没有 filterVal，走取值兜底会
+ * 落到 getCellValue 的 vNode 挂载，为了爬一段文件名文本给每个单元格挂一次附件组件 ——
+ * 既没价值又是导出耗时的大头。
+ *
+ * 与 isNonDataExportColumn 的区别：那个是**整列剔除**（字段树里都看不到，用于操作列/
+ * 脱敏列）；这个是**列在、格空**，不改变导出文件的列结构。
+ *
+ * 注意配了导出类型（Image/Image2）的附件列不在此列 —— 即使本次导出没开 showImageAtTable、
+ * 图片最终不会写进文件，也保持原有行为不变。
+ *
+ * @param {String} formatS 列的展示格式。
+ * @param {String} type 展示组件类型。
+ * @param {String} exportType 列上配置的导出类型。
+ * @returns {Boolean}
+ */
+export function isBlankExportColumn(formatS, type, exportType) {
+  if (exportType) return false;
+  return formatS === "editAttachment" || type === "baseAttachment";
+}
+
+function isActionOrGroupColumn(item, formatS) {
+  if (Array.isArray(item.children) && item.children.length) return true;
+  return isActionColumn(item, formatS);
+}
+
+function buildWidgetOptions(item, formatS, label) {
+  let widgetOptions =
+    item.options && typeof item.options === "object"
+      ? { ...item.options }
+      : null;
+
+  if (widgetOptions) {
+    delete widgetOptions.dropdownItems;
+  }
+
+  DYNAMIC_SCHEMA_WIDGET_FLAG_KEYS.forEach((key) => {
+    if (item[key] !== undefined) {
+      widgetOptions = widgetOptions || {};
+      widgetOptions[key] = item[key];
+    }
+  });
+
+  if (label) {
+    widgetOptions = widgetOptions || {};
+    if (!widgetOptions.label) {
+      widgetOptions.label = label;
+    }
+  }
+
+  if (!isActionColumn(item, formatS)) {
+    widgetOptions = widgetOptions || {};
+    widgetOptions.labelHidden = true;
+  }
+
+  return widgetOptions;
+}
+
+export function getDynamicSchemaOption(options, key) {
+  if (!options) return null;
+  const keys = DYNAMIC_SCHEMA_OPTION_KEYS[key] || [];
+  for (let i = 0; i < keys.length; i++) {
+    const val = options[keys[i]];
+    if (val !== undefined && val !== null && val !== "") {
+      return val;
+    }
+  }
+  return null;
+}
+
+export function resolveDynamicSchemaExtra(paramScript, handleCustomEvent) {
+  if (!paramScript || !handleCustomEvent) return {};
+  const result = handleCustomEvent(paramScript);
+  return result && typeof result === "object" && !Array.isArray(result)
+    ? result
+    : {};
+}
+
+export function buildDynamicSchemaRequestData(
+  formModel,
+  paramScript,
+  handleCustomEvent,
+  wrapContext
+) {
+  const extra = resolveDynamicSchemaExtra(paramScript, handleCustomEvent);
+  const payload = {
+    formData: formModel || {},
+    ...extra,
+  };
+  if (!wrapContext) {
+    return payload;
+  }
+  const { formCode, formVersion, taBm, dataId } = wrapContext;
+  return {
+    formCode,
+    formVersion,
+    taBm,
+    formData: payload.formData,
+    dataId,
+    data: {
+      dataId,
+      ...payload,
+    },
+  };
+}
+
+/** 从 objx 或转换脚本结果中提取定义数组 */
+export function extractDynamicSchemaItems(source) {
+  if (!source) return [];
+  if (Array.isArray(source)) return source;
+  if (typeof source !== "object") return [];
+  if (Array.isArray(source.fields)) return source.fields;
+  if (Array.isArray(source.columns)) return source.columns;
+  return [];
+}
+
+export function resolveDynamicSchemaResponse(res, convertScript, handleCustomEvent) {
+  if (convertScript && handleCustomEvent) {
+    const result = handleCustomEvent(convertScript, ["res"], [res]);
+    return extractDynamicSchemaItems(result);
+  }
+  return extractDynamicSchemaItems(res && res.objx);
+}
+
+export function normalizeDynamicFieldKey(item) {
+  if (!item || typeof item !== "object") return undefined;
+  return item.keyName;
+}
+
+export function normalizeDynamicColumnItem(item, index) {
+  if (!item || typeof item !== "object") {
+    return null;
+  }
+
+  const keyName = normalizeDynamicFieldKey(item);
+  const label = item.label;
+  let formatS = item.formatS || null;
+  if (!formatS && item.type) {
+    formatS = widgetTypeToEditFormatMap[item.type] || item.type;
+  }
+
+  let editFormatS = null;
+  if (formatS && String(formatS).startsWith("edit")) {
+    editFormatS = formatS;
+  }
+
+  const widgetOptions = buildWidgetOptions(item, formatS, label);
+
+  let widget = null;
+  let widgetList = null;
+  if (
+    (item.type === "dropdown" || formatS === "dropdown") &&
+    Array.isArray(item.dropdownItems) &&
+    item.dropdownItems.length
+  ) {
+    widget = buildDropdownWidgetFromDef(item, index);
+    if (widget && label) {
+      widget.options.label = label;
+    }
+    if (widget?.widgetList?.length) {
+      widgetList = widget.widgetList;
+    }
+  }
+
+  if (!keyName && !isActionOrGroupColumn(item, formatS)) {
+    return null;
+  }
+
+  const isAction = isActionColumn(item, formatS);
+
+  const widgetFlags = {};
+  DYNAMIC_SCHEMA_WIDGET_FLAG_KEYS.forEach((key) => {
+    if (item[key] !== undefined) {
+      widgetFlags[key] = item[key];
+    } else if (widgetOptions?.[key] !== undefined) {
+      widgetFlags[key] = widgetOptions[key];
+    }
+  });
+
+  const children = Array.isArray(item.children)
+    ? item.children
+        .map((child, childIndex) =>
+          normalizeDynamicColumnItem(child, index * 1000 + childIndex)
+        )
+        .filter(Boolean)
+    : item.children;
+
+  return {
+    columnId: item.columnId || `${Date.now()}_${index}`,
+    type: item.type,
+    prop: keyName || undefined,
+    label,
+    width: item.width ?? 150,
+    show: item.show !== false,
+    sortable: isAction ? item.sortable === true : item.sortable !== false,
+    filterable: isAction ? item.filterable === true : item.filterable !== false,
+    ...(item.align ? { align: item.align } : {}),
+    fixed: item.fixed,
+    formatS,
+    editFormatS: editFormatS || undefined,
+    optionItems: item.optionItems,
+    widget,
+    widgetList,
+    widgetOptions,
+    children: children,
+    render: item.render,
+    utcTransformEnabled: item.utcTransformEnabled,
+    ...widgetFlags,
+  };
+}
+
+export function normalizeDynamicColumns(columns) {
+  if (!Array.isArray(columns)) {
+    return [];
+  }
+  return columns
+    .map((item, index) => normalizeDynamicColumnItem(item, index))
+    .filter(Boolean);
+}