weaver-e10-builder 1.5.6 → 1.5.9

package/dist/services/actionflow/formula_service.js

@@ -29,11 +29,25 @@ const VALUE_TYPE_ALIASES = {
 };
 const WEBHOOK_CONTEXT_TABLES = new Set(['Params', 'Header', 'Body']);
 const SERVERLESS_CONTEXT_TABLES = new Set(['Request', 'Response']);
+const DESIGNER_FORM_CONTEXT_ROOTS = new Set(['FormData', 'ApprovalData', 'SelectParams', 'CycleParams']);
+function isComponentContextRoot(root) {
+    const value = String(root || '').trim();
+    return Boolean(value) && !DESIGNER_FORM_CONTEXT_ROOTS.has(value);
+}
+function parameterContextRoot(paramKey, componentType) {
+    const head = String(paramKey || '').split('.')[0];
+    if (componentType === 'WebHookTrigger' && WEBHOOK_CONTEXT_TABLES.has(head))
+        return head;
+    if (componentType === 'ServerlessAction' && SERVERLESS_CONTEXT_TABLES.has(head))
+        return head;
+    return '';
+}
 function isParameterContext(componentType, paramKey, tableKey = '') {
     if (componentType === 'WebHookTrigger' || componentType === 'ServerlessAction')
         return true;
     const head = String(paramKey).split('.')[0];
-    return WEBHOOK_CONTEXT_TABLES.has(String(tableKey)) || WEBHOOK_CONTEXT_TABLES.has(head)
+    return isComponentContextRoot(tableKey)
+        || WEBHOOK_CONTEXT_TABLES.has(String(tableKey)) || WEBHOOK_CONTEXT_TABLES.has(head)
         || SERVERLESS_CONTEXT_TABLES.has(String(tableKey)) || SERVERLESS_CONTEXT_TABLES.has(head);
 }
 /** 触发器上下文根节点。自定义触发的参数由 SelectParams 提供，不是普通表单数据。 */
@@ -45,7 +59,11 @@ export function contextRootForComponent(componentType) {
             : 'FormData';
 }
 export function contextTableNameForRoot(root) {
-    return root === 'ApprovalData' ? '流程数据' : root === 'SelectParams' ? '选择参数' : '表单数据';
+    return root === 'ApprovalData' ? '流程数据'
+        : root === 'SelectParams' ? '选择参数'
+            : root === 'CycleParams' ? '循环参数'
+                : root && isComponentContextRoot(root) ? root
+                    : '表单数据';
 }
 /**
  * 自定义触发的来源 key 只保存业务路径，不能把公式根节点混进 paramKey。
@@ -144,6 +162,204 @@ export function resolveSourceFieldLabel(paramKey, meta, fallback = '') {
     }
     return String(fallback || paramKey);
 }
+/**
+ * 查找动态赋值上下文中的原始字段对象。
+ *
+ * 表单设置组件的“依据值下级”不能用 paramKey 的最后一段代替字段 key：
+ * 前端 set-formdata 会用子节点的 paramName 作为 level=1 的选项 id，
+ * 而字段 id 只用于 frontId/节点定位。这里优先按完整 paramKey 查找，
+ * 不命中时再按字段 paramKey 做一次兼容匹配。
+ */
+function resolveContextFieldMeta(paramKey, meta) {
+    const key = String(paramKey || '').trim();
+    if (!key || !meta || typeof meta !== 'object')
+        return {};
+    const workflowId = String(meta._workflow_id || meta._event_form_id || '');
+    if (workflowId) {
+        const exact = getWorkflowContextFieldsByKey()[workflowId]?.[key];
+        if (exact && typeof exact === 'object')
+            return exact;
+        const fields = getWorkflowContextFields()[workflowId] || {};
+        const hit = Object.values(fields).find((field) => field && String(field.paramKey || '') === key);
+        if (hit && typeof hit === 'object')
+            return hit;
+    }
+    const customKey = key.replace(/^(?:FormData|ApprovalData|SelectParams)\./, '');
+    const tableToken = customKey.includes('[]')
+        ? customKey.slice(0, customKey.indexOf('[]')).split('.').filter(Boolean).pop() || ''
+        : '';
+    const fieldToken = customKey.includes('[]')
+        ? customKey.slice(customKey.indexOf('[]') + 2).split('.').filter(Boolean).pop() || ''
+        : customKey.split('.').filter(Boolean).pop() || '';
+    if (tableToken && fieldToken) {
+        const table = customTriggerTables(meta).find((candidate) => candidate && [
+            candidate.id, candidate.formId, candidate.paramName, candidate.paramKey,
+            candidate.key, candidate.showName, candidate.name,
+        ].some((value) => String(value ?? '').trim() === tableToken));
+        const field = table?.fields?.find((candidate) => candidate && [
+            candidate.id, candidate.paramName, candidate.key, candidate.fieldKey,
+            candidate.showName, candidate.name,
+        ].some((value) => String(value ?? '').trim() === fieldToken));
+        if (field && typeof field === 'object')
+            return field;
+    }
+    return {};
+}
+/**
+ * 依据值下级的业务 key：对齐 set-formdata/transSubBasisParamkey。
+ * level=1 使用子字段 paramName，而不是字段 id；没有实时元数据时保留
+ * 旧的 paramKey 尾段作为兼容兜底。
+ */
+function resolveFormSettingSubKey(paramKey, meta) {
+    const key = String(paramKey || '').trim();
+    const field = resolveContextFieldMeta(key, meta);
+    const configured = String(field.paramName || field.key || field.fieldKey || '').trim();
+    if (configured)
+        return configured;
+    const tail = key.includes('.') ? key.slice(key.lastIndexOf('.') + 1) : key;
+    return tail.replace(/\[\]$/, '');
+}
+/**
+ * ParamMappingBean 的下级 key 与 EsbFormDataDto 不同：前端
+ * transSubBasisParamkey 会先去掉依据值的 paramKey，且参数设置不去掉
+ * 下级路径中的 []；表单设置则保留 level=1 的 paramName，并对更深层级
+ * 去掉数组标记。这里只消费 API 回填的 basisParamKey/字段 paramKey。
+ */
+function resolveBasisSubKey(paramKey, basisParamKey, basisType, meta, resolved) {
+    const kind = String(basisType || '').toLowerCase();
+    const root = resolvedContextRoot(resolved, String(resolved.componentType || meta?._context_component_type || ''), '');
+    const selected = protocolParamKey(String(paramKey || ''), root, String(resolved.componentType || meta?._context_component_type || ''));
+    const basis = protocolParamKey(String(basisParamKey || ''), root, String(resolved.componentType || meta?._context_component_type || ''));
+    if (!basis || selected === basis)
+        return 'esbAssignSelf';
+    const relative = selected.startsWith(`${basis}.`) ? selected.slice(basis.length + 1) : selected;
+    if (kind.includes('param'))
+        return relative;
+    const field = resolveContextFieldMeta(paramKey, meta);
+    const firstLevel = String(field.paramName || field.key || '').trim();
+    if (firstLevel && !relative.includes('.'))
+        return firstLevel.replace(/\[\]$/, '');
+    return relative.replace(/\[\]/g, '');
+}
+/**
+ * 将预检阶段由 getComponentContext 回填的字段身份投影到公式编译上下文。
+ * 这里不创建字段身份，只搬运 API 返回的字段/分组元数据；没有 resolved
+ * 元数据时，调用方仍可保留旧的直编兼容行为，但真实生成流程会在预检阶段
+ * 先因 unresolved context 被拦截。
+ */
+export function contextMetaForReference(meta, reference, componentType = '') {
+    const resolved = reference?._resolvedContext && typeof reference._resolvedContext === 'object'
+        ? reference._resolvedContext : {};
+    const type = String(resolved.componentType || componentType || meta?._context_component_type || meta?._upstream_component_type || '');
+    const projected = {
+        ...(meta || {}),
+        ...(type ? { _context_component_type: type } : {}),
+    };
+    const copy = (key, target = key) => {
+        if (resolved[key] !== undefined && resolved[key] !== null && String(resolved[key]) !== '')
+            projected[target] = String(resolved[key]);
+    };
+    copy('tablePrimaryKey', '_context_table_primary_key');
+    copy('tableName', '_context_table_name');
+    copy('tableKey', '_context_table_key');
+    copy('paramKey', '_context_original_param_key');
+    copy('parentName', '_context_original_parent_name');
+    copy('multKey', '_context_mult_key');
+    copy('multName', '_context_mult_name');
+    copy('effectiveMultKey', '_context_effective_mult_key');
+    copy('effectiveMultName', '_context_effective_mult_name');
+    copy('allParentName', '_context_all_parent_name');
+    if (resolved.isMultCom !== undefined)
+        projected._context_is_mult_com = Boolean(resolved.isMultCom);
+    if (resolved.parentComId !== undefined && resolved.parentComId !== null)
+        projected._context_parent_com_id = String(resolved.parentComId);
+    // getComponentContext 返回的 paramKey 是分组内业务路径，例如
+    // `detailOne[].detailText`；`Body.detailOne[].detailText` 只是 CLI 用于
+    // 定位上下文分组的完整引用。不能把分组根写回 ParamBean/FormulaBean
+    // 的 config.paramKey，否则前端会把 Body 当成字段路径的一部分。
+    const selectedRaw = String(reference?.paramKey || reference?.key || resolved.paramKey || '');
+    const selectedRoot = String(resolved.tablePrimaryKey
+        || projected._context_table_primary_key
+        || parameterContextRoot(selectedRaw, type));
+    projected._context_selected_param_key = ((type === 'WebHookTrigger' || type === 'ServerlessAction')
+        || isComponentContextRoot(selectedRoot))
+        ? protocolParamKey(selectedRaw, selectedRoot, type)
+        : normalizeContextParamKey(selectedRaw, type);
+    return projected;
+}
+export function resolvedContextRoot(resolved, componentType, fallback = '') {
+    const supplied = String(resolved.tablePrimaryKey || '').trim();
+    if (supplied)
+        return supplied;
+    if (componentType === 'WebHookTrigger') {
+        const key = String(resolved.tableKey || '').trim();
+        if (WEBHOOK_CONTEXT_TABLES.has(key))
+            return key;
+    }
+    if (componentType === 'ServerlessAction') {
+        const key = String(resolved.tableKey || '').trim();
+        if (SERVERLESS_CONTEXT_TABLES.has(key))
+            return key;
+    }
+    return fallback || contextRootForComponent(componentType);
+}
+export function protocolParamKey(paramKey, root, componentType) {
+    const raw = String(paramKey || '');
+    if ((componentType === 'WebHookTrigger' && WEBHOOK_CONTEXT_TABLES.has(root))
+        || (componentType === 'ServerlessAction' && SERVERLESS_CONTEXT_TABLES.has(root))
+        || isComponentContextRoot(root)) {
+        return raw.startsWith(`${root}.`) ? raw.slice(root.length + 1) : raw;
+    }
+    return raw.replace(/^(?:FormData|ApprovalData|SelectParams)\./, '');
+}
+function customTriggerTables(meta) {
+    return meta && Array.isArray(meta._custom_trigger_data?.tableList)
+        ? meta._custom_trigger_data.tableList.filter((item) => item && typeof item === 'object')
+        : [];
+}
+function customTriggerTableLabel(table, fallback = '') {
+    return String(table?.showName || table?.name || table?.paramName || table?.key || fallback);
+}
+/**
+ * 生成表单设置 basisValue 的展示路径。
+ * parentName 是设计器展示路径，不是运行时根节点；因此 CustomTrigger
+ * 不能把 SelectParams 当成 parentName，而要从 tableList 还原“主表.明细表”。
+ */
+export function resolveFormSettingBasisParentName(paramKey, fallbackLabel, meta = null) {
+    const key = String(paramKey || '').replace(/^(?:FormData|ApprovalData|SelectParams)\./, '').trim();
+    const componentType = String(meta?._context_component_type || meta?._upstream_component_type || '');
+    if (componentType === 'CustomTrigger') {
+        const tables = customTriggerTables(meta);
+        const pathBeforeArray = key.includes('[]') ? key.slice(0, key.indexOf('[]')) : key;
+        const tableToken = pathBeforeArray.split('.').filter(Boolean).pop() || '';
+        const same = (value, token) => String(value ?? '').trim() === token;
+        const details = tables.filter((item) => !(item.isMain === true || item.isMain === 1 || String(item.isMain) === '1'))
+            .sort((left, right) => Number(left.orderNum ?? left.order ?? 0) - Number(right.orderNum ?? right.order ?? 0));
+        const numbered = /^detail(\d+)$/i.exec(tableToken);
+        const table = tables.find((item) => item
+            && [item.id, item.formId, item.paramName, item.paramKey, item.key, item.showName, item.name]
+                .some((value) => same(value, tableToken)))
+            || (numbered ? details[Number(numbered[1]) - 1] : undefined)
+            || (tables.length === 1 ? tables[0] : undefined);
+        if (table) {
+            const detailLabel = customTriggerTableLabel(table, String(fallbackLabel || tableToken));
+            const isMain = table.isMain === true || table.isMain === 1 || String(table.isMain) === '1';
+            if (isMain)
+                return detailLabel;
+            const main = tables.find((item) => item.isMain === true || item.isMain === 1 || String(item.isMain) === '1');
+            const mainLabel = customTriggerTableLabel(main);
+            return mainLabel ? `${mainLabel}.${detailLabel}[]` : `${detailLabel}[]`;
+        }
+    }
+    const field = resolveContextFieldMeta(`${key}`, meta);
+    const metadataParent = String(field.parentName || field.newParentName || '')
+        .replace(/^(?:FormData|ApprovalData|SelectParams)\./, '').trim();
+    if (metadataParent && !/^(?:FormData|ApprovalData|SelectParams)\.?$/.test(metadataParent))
+        return metadataParent;
+    const prefix = String(meta?._upstream_workflow_name || meta?._upstream_form_name || '').trim();
+    const label = String(fallbackLabel || key);
+    return prefix ? `${prefix}.${label}[]` : `${label}[]`;
+}
 const SYSTEM_ALIASES = {
     id: '数据ID', name: '标题', creator: '创建者', create_time: '创建时间',
     update_time: '最后更新时间', updater: '最后更新人', data_status: '数据状态',
@@ -667,7 +883,7 @@ export function buildPersonFormula(personRef, meta, appId = '', forSendMessage =
         const personSourceMeta = personRef._resolvedContext?.componentType === 'CustomTrigger'
             ? { ...(meta || {}), _context_component_type: 'CustomTrigger' }
             : meta;
-        child = assignFlatContextDirect(pk, disp, src, appId, ft, full, personSourceMeta, personRef._resolvedContext?.fieldId);
+        child = assignFlatContextDirect(pk, disp, src, appId, ft, full, personSourceMeta, personRef._resolvedContext?.fieldId || personRef.frontId || personRef.fieldId);
     }
     else {
         child = formulaSystemVar('{userid}');
@@ -861,7 +1077,14 @@ function buildNamedFunctionBean(ref, fieldId, fieldType, meta, appId, defaultSou
                 };
             }
         }
-        return buildAssignBean(normalizedChild && typeof normalizedChild === 'object' ? { ...normalizedChild, _formulaArgument: true } : normalizedChild, fieldId, resolved.fieldType || formulaType, meta, appId, defaultSourceId);
+        const argumentFieldType = [
+            resolved.fieldType,
+            child?.fieldType,
+            child?.valueType,
+            formulaType,
+        ].map((value) => String(value || '').trim())
+            .find((value) => value && !/^(?:unknown|none|null|undefined)$/i.test(value)) || formulaType;
+        return buildAssignBean(normalizedChild && typeof normalizedChild === 'object' ? { ...normalizedChild, _formulaArgument: true } : normalizedChild, fieldId, argumentFieldType, meta, appId, defaultSourceId);
     });
     return formulaFunction(entry.id, entry.name, childs, formulaType, entry.excelFunc, entry.category || entry.resultType, entry.detail, appId, entry.paramSize);
 }
@@ -989,26 +1212,39 @@ export function buildAssignBean(raw, fieldId, fieldType, meta, appId, defaultSou
         }
         const wfId = String(meta._workflow_id || '');
         const resolvedKey = resolveParamKey(wfId, String(key));
-        const sourceFieldType = resolveSourceFieldType(resolvedKey, meta) || String(src.fieldType || src.valueType || 'string');
         const resolved = src && typeof src._resolvedContext === 'object' ? src._resolvedContext : {};
+        const resolvedFieldTypeCandidate = [
+            resolved.fieldType,
+            resolved.rawField?.paramType,
+            resolved.rawField?.componentKey,
+            src.fieldType,
+            src.valueType,
+            fieldType,
+        ].map((value) => String(value || '').trim())
+            .find((value) => value && !/^(?:unknown|none|null|undefined)$/i.test(value)) || '';
+        const resolvedFieldType = String(resolvedFieldTypeCandidate);
+        const sourceFieldType = resolvedFieldType || resolveSourceFieldType(resolvedKey, meta) || 'string';
         // 批量新增的普通字段映射与函数参数使用不同的前端协议：前者是 type=10/sub，
         // 而函数里的明细字段必须是带索引子节点的 type=3 上下文引用。
         if (resolvedKey.includes('[].')) {
             const detailLabel = String(src?.detailLabel || src?.parentName || '');
             const workflowName = String(meta._upstream_workflow_name || '');
             if (src?._formulaArgument) {
+                const basisParamKey = String(src?.basisParamKey || src?.basisValue?.paramKey || '').trim();
+                const basisType = String(src?.basisType || src?.config?.basisType || '');
+                if (basisParamKey) {
+                    return assignBasisFormulaArgument(resolvedKey, String(label), String(sourceId), appId, String(sourceFieldType || fieldType || 'string'), basisParamKey, basisType || 'formSetting', contextMetaForReference(meta, src, sourceComponent), resolved);
+                }
                 // 查询结果是一层数组（formId[].fieldId），不能套用流程明细的
                 // workflowId.detailId[].fieldId 解析器。
                 if (/^[^\.\[]+\[\]\.[^\.\[]+$/.test(resolvedKey)) {
                     return formulaIndexedQueryResultArgument(resolvedKey, String(label), String(sourceId), appId, String(sourceFieldType || fieldType || 'string'), detailLabel || '表单数据');
                 }
-                return formulaIndexedWorkflowDetailArgument(resolvedKey, String(label), String(sourceId), appId, String(sourceFieldType || fieldType || 'string'), detailLabel, sourceComponent === 'CustomTrigger'
-                    ? { ...(meta || {}), _context_component_type: sourceComponent, _upstream_component_type: sourceComponent }
-                    : meta, sourceComponent === 'CustomTrigger'
+                return formulaIndexedWorkflowDetailArgument(resolvedKey, String(label), String(sourceId), appId, String(sourceFieldType || fieldType || 'string'), detailLabel, contextMetaForReference(meta, src, sourceComponent), sourceComponent === 'CustomTrigger'
                     ? String(resolved.fieldId || resolveCustomTriggerFormulaFrontId(resolvedKey, resolved, meta))
-                    : src?._resolvedContext?.fieldId);
+                    : src?._resolvedContext?.fieldId, resolved);
             }
-            const child = assignFlatEsbChild(resolvedKey, String(label), String(sourceId), appId, String(sourceFieldType || fieldType || 'string'), undefined, detailLabel, workflowName, sourceComponent);
+            const child = assignFlatEsbChild(resolvedKey, String(label), String(sourceId), appId, String(sourceFieldType || fieldType || 'string'), undefined, detailLabel, workflowName, sourceComponent, contextMetaForReference(meta, src, sourceComponent), resolved, String(src?.basisParamKey || src?.basisValue?.paramKey || ''), String(src?.basisType || src?.config?.basisType || 'formSetting'));
             attachEsbAssign(child, meta, String(sourceId));
             return child;
         }
@@ -1344,18 +1580,18 @@ export function assignFlatContextDirect(paramKey, fieldLabel, sourceId, appId, f
     const componentType = String(meta?._context_component_type || meta?._upstream_component_type || '');
     const contextRoot = String(meta?._context_table_primary_key || contextRootForComponent(componentType));
     const parameterContext = isParameterContext(componentType, requestedPkey, contextRoot);
-    const parameterTable = WEBHOOK_CONTEXT_TABLES.has(contextRoot)
+    const parameterTable = parameterContext
         ? contextRoot
         : WEBHOOK_CONTEXT_TABLES.has(requestedPkey.split('.')[0])
             ? requestedPkey.split('.')[0]
-            : componentType === 'ServerlessAction' && SERVERLESS_CONTEXT_TABLES.has(contextRoot)
-                ? contextRoot
-                : SERVERLESS_CONTEXT_TABLES.has(requestedPkey.split('.')[0])
-                    ? requestedPkey.split('.')[0]
-                    : componentType === 'ServerlessAction' ? 'Response' : 'Body';
+            : SERVERLESS_CONTEXT_TABLES.has(requestedPkey.split('.')[0])
+                ? requestedPkey.split('.')[0]
+                : componentType === 'ServerlessAction' ? 'Response' : 'Body';
+    const apiParamKey = String(meta?._context_original_param_key || '').trim();
     const pkey = parameterContext
-        ? ((WEBHOOK_CONTEXT_TABLES.has(requestedPkey.split('.')[0]) || SERVERLESS_CONTEXT_TABLES.has(requestedPkey.split('.')[0]))
-            ? requestedPkey : `${parameterTable}.${requestedPkey}`)
+        ? (apiParamKey
+            ? protocolParamKey(apiParamKey, parameterTable, componentType)
+            : protocolParamKey(requestedPkey, parameterTable, componentType))
         : requestedPkey.replace(/^(?:FormData|ApprovalData|SelectParams)\./, '');
     const multPath = resolveFrontendMultPath(pkey, parentName || `表单数据.${fieldLabel}`, meta);
     const currentPkey = multPath.paramKey;
@@ -1407,11 +1643,14 @@ export function assignFlatContextDirect(paramKey, fieldLabel, sourceId, appId, f
     const valuePrefix = parameterContext ? '' : `${prefix}.`;
     const tableName = String(meta?._context_table_name || (parameterContext ? parameterTable : contextTableNameForRoot(prefix)));
     const sourceComponent = resolvedSourceComponent;
-    const valueParamKey = parameterContext ? currentPkey : addContextTableKey(currentPkey, meta);
-    const allValueParamKey = parameterContext ? multPath.allParamKey : addContextTableKey(multPath.allParamKey, meta);
-    const fieldInfoParamKey = String(meta?._context_original_param_key || pkey);
+    const valueParamKey = parameterContext ? `${parameterTable}.${currentPkey}` : addContextTableKey(currentPkey, meta);
+    const allValueParamKey = parameterContext ? `${parameterTable}.${multPath.allParamKey}` : addContextTableKey(multPath.allParamKey, meta);
+    const fieldInfoParamKey = parameterContext
+        ? protocolParamKey(String(meta?._context_original_param_key || pkey), parameterTable, componentType)
+        : String(meta?._context_original_param_key || pkey);
     const result = {
         formulaType: fieldType, name: String(fieldLabel), businessId: appId || '', id: fid,
+        paramType: fieldType,
         source: src, type: '3', value: `${valuePrefix}${valueParamKey}`,
         frontId, paramKey: currentPkey, parentName: pname, childs: [],
         config: {
@@ -1438,48 +1677,138 @@ function directContextMeta(meta, sourceComponent, sourceRef) {
     const resolved = sourceRef?._resolvedContext && typeof sourceRef._resolvedContext === 'object'
         ? sourceRef._resolvedContext : {};
     return {
-        ...(meta || {}),
+        ...contextMetaForReference(meta, sourceRef, sourceComponent),
         _context_component_type: sourceComponent,
         ...(['WebHookTrigger', 'ServerlessAction'].includes(sourceComponent) ? {
-            _context_table_primary_key: String(resolved.tablePrimaryKey || resolved.tableKey || ''),
-            _context_table_name: String(resolved.tableName || ''),
+            _context_table_primary_key: String(resolved.tablePrimaryKey || resolved.tableKey || meta?._context_table_primary_key || ''),
+            _context_table_name: String(resolved.tableName || meta?._context_table_name || ''),
         } : {}),
     };
 }
-function assignFlatEsbChild(paramKey, fieldLabel, sourceId, appId, fieldType = 'string', detailParamKey = '', detailLabel = '', workflowName = '', componentType = 'ApproveTrigger') {
+function assignFlatEsbChild(paramKey, fieldLabel, sourceId, appId, fieldType = 'string', detailParamKey = '', detailLabel = '', workflowName = '', componentType = 'ApproveTrigger', meta = null, resolvedContext = null, basisParamKey = '', basisType = 'formSetting') {
     const fid = genSfId();
     const src = String(sourceId) || '0';
-    const contextRoot = contextRootForComponent(componentType);
-    const tableName = contextTableNameForRoot(contextRoot);
-    const tailPart = paramKey.includes('.') ? paramKey.slice(paramKey.lastIndexOf('.') + 1) : paramKey;
-    const subId = tailPart.replace(/\[\]$/, '');
-    const detailPk = detailParamKey || (paramKey.includes('[]') ? paramKey.slice(0, paramKey.indexOf('[]')) + '[]' : '');
+    const resolved = resolvedContext && typeof resolvedContext === 'object' ? resolvedContext : {};
+    const sourceComponent = String(resolved.componentType || componentType || 'ApproveTrigger');
+    // EsbFormDataDto/CustSetFormDto 的依据值下级协议使用表单设置根；
+    // 只有 API 已回填 tablePrimaryKey 时才采用来源组件的实际参数根。
+    const contextRoot = resolvedContextRoot(resolved, sourceComponent, sourceComponent === 'CustomTrigger'
+        ? 'SelectParams'
+        : parameterContextRoot(paramKey, sourceComponent) || 'FormData');
+    const sourceMeta = contextMetaForReference(meta, { paramKey, _resolvedContext: resolved }, sourceComponent);
+    const rawField = resolved.rawField && typeof resolved.rawField === 'object' ? resolved.rawField : {};
+    const rawDetailPk = detailParamKey || basisParamKey || (paramKey.includes('[]') ? paramKey.slice(0, paramKey.indexOf('[]')) + '[]' : '');
+    const subId = basisParamKey
+        ? resolveBasisSubKey(paramKey, basisParamKey, basisType, sourceMeta, resolved)
+        : String(rawField.paramName || rawField.key || resolveFormSettingSubKey(paramKey, sourceMeta));
+    const detailPk = protocolParamKey(rawDetailPk, contextRoot, sourceComponent);
     const detailVal = `${contextRoot}.${detailPk}`;
-    const parentName = workflowName ? `${workflowName}.${fieldLabel}[]` : `${fieldLabel}[]`;
+    const resolvedParentName = String(resolved.parentName || '').trim();
+    const basisParentName = resolvedParentName.includes('[]')
+        ? resolvedParentName.slice(0, resolvedParentName.indexOf('[]') + 2)
+        : '';
+    const parentName = basisParentName || resolveFormSettingBasisParentName(detailPk, detailLabel || fieldLabel, sourceMeta);
+    const basisPathMeta = { ...sourceMeta, _context_original_parent_name: parentName };
+    const path = resolveFrontendMultPath(detailPk, parentName, basisPathMeta);
     const subName = workflowName ? `${workflowName}.${fieldLabel}` : String(fieldLabel);
-    const allName = workflowName && detailLabel ? `${workflowName}.${detailLabel}[]` : parentName;
+    const allName = path.allParentName || (workflowName && detailLabel ? `${workflowName}.${detailLabel}[]` : parentName);
+    const currentParamKey = path.paramKey.startsWith(`${contextRoot}.`)
+        ? path.paramKey
+        : `${contextRoot}.${path.paramKey}`;
+    const allParamKey = path.allParamKey.startsWith(`${contextRoot}.`)
+        ? path.allParamKey
+        : `${contextRoot}.${path.allParamKey}`;
+    const apiParamKey = String(resolved.paramKey
+        || sourceMeta._context_original_param_key
+        || protocolParamKey(paramKey, contextRoot, sourceComponent));
     return {
         id: fid, name: String(fieldLabel), value: subId, type: '10', fieldType, formulaType: fieldType,
+        paramType: fieldType,
         applicationId: appId || '',
         config: {
-            paramKey: String(paramKey), basisType: 'formSetting', switchType: 'sub', level: 1,
+            paramKey: apiParamKey, basisType: String(basisType || 'formSetting'), switchType: 'sub', level: 1,
             id: subId, source: src, formulaVersion: 'V1', value: detailVal,
             config: {
-                paramKey: detailPk, isMultCom: false, comType: componentType, switchType: 'assign', parentComId: 0,
+                paramKey: path.paramKey, isMultCom: Boolean(resolved.isMultCom), comType: sourceComponent, switchType: 'assign', parentComId: 0,
                 fieldInfo: { paramKey: detailPk, tablePrimaryKey: contextRoot },
-                tableName, paramType: fieldType, parentName, multName: '', multKey: '',
+                tableName: String(resolved.tableName || contextTableNameForRoot(contextRoot)), paramType: fieldType,
+                parentName: path.parentName || parentName, multName: path.multName, multKey: path.multKey,
                 multTypeObj: {
-                    allName, currentName: subName,
-                    currentParamKey: paramKey.startsWith(`${contextRoot}.`) ? String(paramKey) : `${contextRoot}.${paramKey}`,
-                    allParamKey: detailVal,
+                    allName, currentName: path.parentName || subName,
+                    currentParamKey, allParamKey,
                 },
-                comId: src, newParentName: parentName,
+                comId: src, newParentName: path.allParentName || parentName,
             },
             originValue: subId, content: String(fieldLabel),
         },
         childs: [], parentId: '0',
     };
 }
+/**
+ * 函数参数中的表单设置依据值下级。
+ *
+ * set-formdata/common assignment 的 Basis.onClick 会把这类引用保存为
+ * type=10，并把 value 写成 detailBasis.<detailTable>.<field>；它不是函数
+ * 编辑器为普通上下文字段生成的 type=3 + 第 0 行索引节点。
+ */
+function assignBasisFormulaArgument(paramKey, fieldLabel, sourceId, appId, fieldType, basisParamKey, basisType, meta, resolvedContext = {}) {
+    const fid = genSfId();
+    const sourceComponent = String(resolvedContext.componentType || meta?._context_component_type || meta?._upstream_component_type || 'ApproveTrigger');
+    const contextRoot = resolvedContextRoot(resolvedContext, sourceComponent, sourceComponent === 'CustomTrigger'
+        ? 'SelectParams'
+        : parameterContextRoot(paramKey, sourceComponent) || 'FormData');
+    const selectedParamKey = protocolParamKey(String(paramKey), contextRoot, sourceComponent);
+    const selectedBasisKey = protocolParamKey(String(basisParamKey), contextRoot, sourceComponent);
+    const relative = selectedParamKey.startsWith(`${selectedBasisKey}.`)
+        ? selectedParamKey.slice(selectedBasisKey.length + 1)
+        : selectedParamKey;
+    const basisToken = selectedBasisKey
+        .split('.')
+        .filter(Boolean)
+        .pop()
+        ?.replace(/\[\]$/, '') || '';
+    const baseType = String(resolvedContext.baseType
+        || (selectedBasisKey.includes('[]') ? 'detailBasis' : 'mainBasis'));
+    const basisValue = `${baseType}.${basisToken}.${relative.replace(/\[\]/g, '')}`;
+    const parentName = String(resolvedContext.parentName
+        || meta?._context_original_parent_name
+        || fieldLabel);
+    const fieldId = String(resolvedContext.fieldId
+        || resolvedContext.rawField?.id
+        || resolvedContext.rawField?.paramId
+        || '');
+    const multKey = String(resolvedContext.multKey || meta?._context_mult_key || '');
+    const comId = String(resolvedContext.comId || meta?._context_com_id || sourceId || '0');
+    return {
+        id: fid,
+        name: String(fieldLabel),
+        value: basisValue,
+        type: '10',
+        fieldType,
+        formulaType: fieldType,
+        paramType: fieldType,
+        applicationId: appId || '',
+        frontId: fieldId ? normalizeNumericFrontId(fieldId, '依据值下级 FormulaBean.frontId') : undefined,
+        config: {
+            basisType: String(basisType || 'formSetting'),
+            paramKey: selectedParamKey,
+            paramType: fieldType,
+            parentName,
+            source: String(sourceId || '0'),
+            frontId: fieldId || undefined,
+            value: contextRoot,
+            config: { multKey, comId, paramType: fieldType },
+            fieldInfo: {
+                paramKey: selectedParamKey,
+                tablePrimaryKey: contextRoot,
+                baseType,
+            },
+            formulaVersion: 'V1',
+        },
+        childs: [],
+        parentId: '0',
+    };
+}
 /**
  * 函数中的流程明细字段引用。
  *
@@ -1487,24 +1816,39 @@ function assignFlatEsbChild(paramKey, fieldLabel, sourceId, appId, fieldType = '
  * 选中“明细[0].字段”后保存的真实结构是 type=3：value 的 [] 被一个 type=1
  * 索引子节点 position 替换。缺少这个索引节点时，设计器只会把字段名渲染成红字。
  */
-function formulaIndexedWorkflowDetailArgument(paramKey, fieldLabel, sourceId, appId, fieldType = 'string', detailLabel = '', meta = {}, resolvedFrontId = '') {
+function formulaIndexedWorkflowDetailArgument(paramKey, fieldLabel, sourceId, appId, fieldType = 'string', detailLabel = '', meta = {}, resolvedFrontId = '', resolvedContext = {}) {
     const fid = genSfId();
-    const match = String(paramKey).match(/^([^\.]+)\.([^\.\[]+)\[\]\.([^\.\[]+)$/);
-    if (!match)
+    const sourceComponent = String(resolvedContext.componentType || meta?._context_component_type || meta?._upstream_component_type || 'ApproveTrigger');
+    const parameterRoot = (sourceComponent === 'WebHookTrigger' || sourceComponent === 'ServerlessAction')
+        ? String(resolvedContext.tablePrimaryKey || resolvedContext.tableKey || meta?._context_table_primary_key || parameterContextRoot(paramKey, sourceComponent) || '')
+        : '';
+    const normalizedParamKey = parameterRoot
+        ? protocolParamKey(String(paramKey), parameterRoot, sourceComponent)
+        : String(paramKey).replace(/^(?:FormData|ApprovalData|SelectParams)\./, '');
+    const workflowDetailMatch = normalizedParamKey.match(/^([^\.]+)\.([^\.\[]+)\[\]\.([^\.\[]+)$/);
+    const parameterDetailMatch = normalizedParamKey.match(/^([^\.\[]+)\[\]\.([^\.\[]+)$/);
+    if (!workflowDetailMatch && !parameterDetailMatch)
         throw new Error(`[formula] 明细函数参数 paramKey 不合法: ${paramKey}`);
-    const [, workflowId, detailId, detailFieldId] = match;
-    const detailName = String(getWorkflowDetailNames()[workflowId]?.[detailId] || detailLabel || detailId);
+    const workflowId = workflowDetailMatch?.[1] || parameterDetailMatch?.[1] || '';
+    const detailId = workflowDetailMatch?.[2] || '';
+    const detailFieldId = workflowDetailMatch?.[3] || parameterDetailMatch?.[2] || '';
+    const detailName = parameterDetailMatch
+        ? String(resolvedContext.parentName || detailLabel || workflowId).split('[]')[0]
+        : String(getWorkflowDetailNames()[workflowId]?.[detailId] || detailLabel || detailId);
     const workflowName = String(meta?._upstream_workflow_name || '');
-    const sourceComponent = String(meta?._context_component_type || meta?._upstream_component_type || 'ApproveTrigger');
-    const parentName = alignContextParentName(paramKey, `${workflowName ? `${workflowName}.` : ''}${detailName}[].${fieldLabel}`, fieldLabel, meta, { componentType: sourceComponent });
+    const parentName = alignContextParentName(normalizedParamKey, resolvedContext.parentName
+        || meta?._context_original_parent_name
+        || `${workflowName ? `${workflowName}.` : ''}${detailName}[].${fieldLabel}`, fieldLabel, meta, { componentType: sourceComponent });
     const index = formulaFixed('0', 'string');
     index.name = '0';
     index.position = genSfId();
     index.parentId = fid;
-    const contextRoot = contextRootForComponent(sourceComponent);
-    const tableName = contextTableNameForRoot(contextRoot);
-    const contextValue = `${contextRoot}.${workflowId}.${detailId}[${index.position}].${detailFieldId}`;
-    const allParamKey = `${contextRoot}.${paramKey}`;
+    const contextRoot = parameterRoot || contextRootForComponent(sourceComponent);
+    const tableName = parameterRoot
+        ? String(resolvedContext.tableName || meta?._context_table_name || contextRoot)
+        : contextTableNameForRoot(contextRoot);
+    const contextValue = `${contextRoot}.${normalizedParamKey.replace('[]', `[${index.position}]`)}`;
+    const allParamKey = `${contextRoot}.${normalizedParamKey}`;
     return {
         formulaType: fieldType,
         name: String(fieldLabel),
@@ -1515,18 +1859,18 @@ function formulaIndexedWorkflowDetailArgument(paramKey, fieldLabel, sourceId, ap
         applicationId: appId || '',
         value: contextValue,
         frontId: normalizeNumericFrontId(sourceComponent === 'CustomTrigger' ? resolvedFrontId : (resolvedFrontId || detailFieldId), '流程明细 FormulaBean.frontId'),
-        paramKey: String(paramKey),
+        paramKey: normalizedParamKey,
         parentName,
         childs: [index],
         config: {
-            paramKey: String(paramKey),
+            paramKey: normalizedParamKey,
             isMultCom: false,
             comType: sourceComponent,
             switchType: 'assign',
             parentComId: 0,
             parentName,
             formulaVersion: 'V1',
-            fieldInfo: { paramKey: String(paramKey), tablePrimaryKey: contextRoot },
+            fieldInfo: { paramKey: normalizedParamKey, tablePrimaryKey: contextRoot },
             tableName,
             paramType: fieldType,
             multName: '',
@@ -1625,7 +1969,7 @@ export function attachEsbAssign(bean, meta, fallbackSource = '') {
         esbWid = String(Date.now()).slice(0, 13);
     bean.esbAssign = { wId: esbWid, textarea: false, withoutDftNum: true };
 }
-export function buildSettingEntry(fieldId, assignment, fieldType = 'Text', meta = {}, appId = '', defaultSourceId = '', operate = 'OPERATE_EQUAL', componentType = '', detailMode = false, assignmentMode = '') {
+export function buildSettingEntry(fieldId, assignment, fieldType = 'Text', meta = {}, appId = '', defaultSourceId = '', operate = 'OPERATE_EQUAL', componentType = '', detailMode = false, assignmentMode = '', preserveTextarea = false) {
     if (!meta || typeof meta !== 'object')
         meta = {};
     const rawValue = assignment && typeof assignment === 'object' ? (assignment.value ?? assignment) : assignment;
@@ -1682,7 +2026,7 @@ export function buildSettingEntry(fieldId, assignment, fieldType = 'Text', meta
             if (realDtl)
                 detailLabel = realDtl;
             const workflowName = String(meta._upstream_workflow_name || '');
-            flat = assignFlatEsbChild(pkeyFull, subLabel, String(src), appId, ft, undefined, detailLabel, workflowName, sourceComponent);
+            flat = assignFlatEsbChild(pkeyFull, subLabel, String(src), appId, ft, undefined, detailLabel, workflowName, sourceComponent, contextMetaForReference(meta, ref, sourceComponent), ref?._resolvedContext || {}, String(ref?.basisParamKey || ref?.basisValue?.paramKey || ''), String(ref?.basisType || ref?.config?.basisType || 'formSetting'));
             switchT = 'sub';
             attachEsbAssign(flat, meta, String(src));
             return {
@@ -1696,8 +2040,8 @@ export function buildSettingEntry(fieldId, assignment, fieldType = 'Text', meta
         else if (assignmentMode === 'direct' && operate === 'OPERATE_EQUAL') {
             const workflowId = String(meta._workflow_id || '');
             const paramKeyFull = resolveParamKey(workflowId, String(key));
-            const directMeta = directContextMeta(meta, sourceComponent, src);
-            flat = assignFlatContextDirect(paramKeyFull, String(label || key), String(src), appId, 'string', String(meta._upstream_workflow_name || ''), directMeta, ref?._resolvedContext?.fieldId);
+            const directMeta = directContextMeta(meta, sourceComponent, ref);
+            flat = assignFlatContextDirect(paramKeyFull, String(label || key), String(src), appId, ft, String(meta._upstream_workflow_name || ''), directMeta, ref?._resolvedContext?.fieldId || ref?.frontId || ref?.fieldId);
             switchT = 'assign';
         }
         else if (assignmentMode === 'nested' && operate === 'OPERATE_EQUAL') {
@@ -1743,8 +2087,8 @@ export function buildSettingEntry(fieldId, assignment, fieldType = 'Text', meta
                         directParent = `${formName}.${label || pkey}`;
                     else
                         directParent = `表单数据.${label || key}`;
-                    const directMeta = directContextMeta(meta, sourceComponent, src);
-                    flat = assignFlatContextDirect(pkey, String(label || key), String(src), appId, ft, directParent, directMeta, ref?._resolvedContext?.fieldId);
+                    const directMeta = directContextMeta(meta, sourceComponent, ref);
+                    flat = assignFlatContextDirect(pkey, String(label || key), String(src), appId, ft, directParent, directMeta, ref?._resolvedContext?.fieldId || ref?.frontId || ref?.fieldId);
                     switchT = 'assign';
                 }
                 else {
@@ -1763,14 +2107,15 @@ export function buildSettingEntry(fieldId, assignment, fieldType = 'Text', meta
             if (!srcName)
                 srcName = String(meta._upstream_form_name || '');
             const directParent = srcName ? `${srcName}.${label || key}` : `表单数据.${label || key}`;
-            const directMeta = directContextMeta(meta, sourceComponent, src);
-            flat = assignFlatContextDirect(pkey, String(label || key), String(src), appId, ft, directParent, directMeta, ref?._resolvedContext?.fieldId);
+            const directMeta = directContextMeta(meta, sourceComponent, ref);
+            flat = assignFlatContextDirect(pkey, String(label || key), String(src), appId, ft, directParent, directMeta, ref?._resolvedContext?.fieldId || ref?.frontId || ref?.fieldId);
             switchT = 'assign';
         }
     }
     else if (kind === 'system_variable') {
         const key = ref && typeof ref === 'object' ? (ref.key ?? '{userid}') : '{userid}';
-        flat = assignFlatSystemVar(String(key), appId, ft);
+        const systemVar = assignFlatSystemVar(String(key), appId, ft);
+        flat = preserveTextarea ? formulaContainerString([systemVar], '', appId) : systemVar;
         switchT = 'assign';
     }
     else if (kind === 'fixed') {
@@ -1809,7 +2154,13 @@ export function buildSettingEntry(fieldId, assignment, fieldType = 'Text', meta
         switchT = 'fixvalue';
     }
     else if (kind === 'constant' || kind === 'variable' || kind === 'transform' || kind === 'formula' || kind === 'function' || kind === 'query_result') {
-        const bean = unwrapDynamicTextarea(buildAssignBean(assignment, fieldId, fieldType, meta, appId, defaultSourceId), `字段 ${fieldId} 的动态赋值`);
+        const builtBean = buildAssignBean(assignment, fieldId, fieldType, meta, appId, defaultSourceId);
+        // HRM 表单组件的前端 ActionEbDlg 会把文本类动态赋值保存为
+        // textarea(type=8) + 一个子 FormulaBean；普通 e-builder 动作仍使用
+        // 展平后的 FormulaBean，避免改变其他组件的既有协议。
+        const bean = preserveTextarea
+            ? (builtBean?.type === '8' ? builtBean : formulaContainerString([builtBean], '', appId))
+            : unwrapDynamicTextarea(builtBean, `字段 ${fieldId} 的动态赋值`);
         const flatId = bean.id || assignId;
         flat = Object.fromEntries(Object.entries(bean).filter(([k]) => !['configObject', 'childs', 'parentId', 'sortWeight', 'position'].includes(k)));
         if (bean.childs)