@kengic/vue 0.30.1-beta.82 → 0.30.1-beta.85

package/component/KgVar/KgVar.store.ts

@@ -0,0 +1,2966 @@
+import { ____DEBUG____, ____ERROR____, ____WARN_____, KgCoreUtil } from '@kengic/core.core';
+import { findIndex, findLastIndex, flatten, isArray, isNil, set, sortBy, uniq, values } from 'lodash-es';
+import { defineStore } from 'pinia';
+import { computed, ref, unref, watch } from 'vue';
+import { API } from '../../api';
+import {
+    VarButton,
+    VarButtonConfig,
+    VarChildDetail,
+    VarConfigControl,
+    VarConfigDescription,
+    VarConfigInput,
+    VarConfigLookup,
+    VarConfigPossibility,
+    VarConfigTip,
+    VarDda,
+    VarGridConfig,
+    VarGridDetail,
+    VarGridMasterDTO,
+    VarProfileConfig,
+    VarProfileDetail,
+    VarProfileMasterDTO,
+    VarSubmitConfig,
+    VarSubmitDetail,
+    VarVariable,
+} from '../../api/WMS/models';
+import { useKg } from '../../config';
+import {
+    IKgVarGridDetailDisplayTypeProperties,
+    IKgVarSubmitConfigProperties,
+    KG,
+    KG__API_METHOD,
+    KG__SPAN,
+    KG__VAR_BUTTON__COLOR,
+    KG__VAR_BUTTON__EXPORT_EXCEL_SUFFIX,
+    KG__VAR_BUTTON__TYPE,
+    KG__VAR_BUTTON_CONFIG__DISPLAY_TYPE,
+    KG__VAR_CONFIG_INPUT__DATA_TYPE,
+    KG__VAR_CONFIG_INPUT__VALIDATION_TYPE,
+    KG__VAR_CONFIG_POSSIBILITY__DATA_SOURCE_TYPE,
+    KG__VAR_CONFIG_POSSIBILITY__VALUE_DATA_TYPE,
+    KG__VAR_CONFIG_TIP__PLACEMENT,
+    KG__VAR_GRID_CONFIG__OPERATION_ON_ROW_CLICK,
+    KG__VAR_GRID_DETAIL__ALIGN,
+    KG__VAR_SUBMIT_CONFIG__DISPLAY_TYPE,
+    KG__VAR_SUBMIT_CONFIG__LABEL_COLUMN_UNIT,
+    KG__VAR_SUBMIT_CONFIG__LAYOUT,
+    KG_CUSTOM_LEVEL,
+    IKgStoreDefinition,
+} from '../../model';
+import { KgUtil } from '../../util';
+import { SUBMIT_DEFAULT_LABEL_COL_FOR_PX, SUBMIT_DEFAULT_LABEL_COL_FOR_SPAN, SUBMIT_DEFAULT_LAYOUT, SUBMIT_DEFAULT_MIN_WIDTH, SUBMIT_DEFAULT_WIDTH } from '../KgSubmit';
+import { KG_TABLE_TD_DEFAULT_WIDTH } from '../KgTable';
+import { FORM_ID__SEARCH__VAR_PROFILE_MASTER } from '../KgVarConfig/KgVarConfig.model';
+import { emit, IKgVar$EventListenerParameter$onAfterRequest, IKgVar$EventListenerParameter$onBeforeRequest } from './KgVar.event';
+import { IUseKgVar, useKgVar } from './KgVar.hooks';
+import { IKgProps, IKgSlots } from './KgVar.model';
+
+const DEFAULT_PAGE_SIZES = '[10, 20, 50, 100]';
+const DEFAULT_PAGE_SIZE = 10;
+
+//region 转换数据
+//----------------------------------------------------------------------------------------------------
+
+//region 查询条件配置
+//----------------------------------------------------------------------------------------------------
+export function transformVarProfileConfig(varProfileConfig: VarProfileConfig | null | undefined): VarProfileConfig | null {
+    if (!varProfileConfig) {
+        return null;
+    }
+
+    //region 设置默认的值
+    //----------------------------------------------------------------------------------------------------
+    if (isNil(varProfileConfig.vis_flg)) {
+        varProfileConfig.vis_flg = 0;
+    }
+    if (isNil(varProfileConfig.available_flg)) {
+        varProfileConfig.available_flg = 1;
+    }
+    if (isNil(varProfileConfig.resizable_flg)) {
+        varProfileConfig.resizable_flg = 1;
+    }
+    if (isNil(varProfileConfig.show_config_button_flag)) {
+        varProfileConfig.show_config_button_flag = 1;
+    }
+    if (isNil(varProfileConfig.props)) {
+        varProfileConfig.props = '{}';
+    }
+    //----------------------------------------------------------------------------------------------------
+    //endregion
+
+    return varProfileConfig;
+}
+//----------------------------------------------------------------------------------------------------
+//endregion
+
+//region 表格配置
+//----------------------------------------------------------------------------------------------------
+export function transformVarGridConfig(varGridConfig: VarGridConfig | null | undefined): VarGridConfig | null {
+    if (!varGridConfig) {
+        return null;
+    }
+
+    const A = KG__VAR_GRID_CONFIG__OPERATION_ON_ROW_CLICK.A;
+    const B = KG__VAR_GRID_CONFIG__OPERATION_ON_ROW_CLICK.B;
+    const C = KG__VAR_GRID_CONFIG__OPERATION_ON_ROW_CLICK.C;
+
+    //region 设置默认的值
+    //----------------------------------------------------------------------------------------------------
+    if (isNil(varGridConfig.available_flg)) {
+        varGridConfig.available_flg = 1;
+    }
+    if (isNil(varGridConfig.aut_load_flg)) {
+        varGridConfig.aut_load_flg = 0;
+    }
+    if (isNil(varGridConfig.mult_flg)) {
+        varGridConfig.mult_flg = 0;
+    }
+    if (isNil(varGridConfig.show_check_column_flg)) {
+        varGridConfig.show_check_column_flg = 0;
+    }
+    if (isNil(varGridConfig.check_first_row_after_retrieve)) {
+        varGridConfig.check_first_row_after_retrieve = 0;
+    }
+    if (isNil(varGridConfig.show_bottom_border_flg)) {
+        varGridConfig.show_bottom_border_flg = 0;
+    }
+    if (isNil(varGridConfig.show_bottom_left_flg)) {
+        varGridConfig.show_bottom_left_flg = 1;
+    }
+    if (isNil(varGridConfig.show_bottom_right_flg)) {
+        varGridConfig.show_bottom_right_flg = 1;
+    }
+    if (isNil(varGridConfig.operation_on_row_click)) {
+        varGridConfig.operation_on_row_click = B;
+    }
+    if (isNil(varGridConfig.convert_sort_field_to_under_score_flg)) {
+        varGridConfig.convert_sort_field_to_under_score_flg = 0;
+    }
+    if (isNil(varGridConfig.id_clm)) {
+        varGridConfig.id_clm = 'id';
+    }
+    if (isNil(varGridConfig.pg_size_opts)) {
+        varGridConfig.pg_size_opts = DEFAULT_PAGE_SIZES;
+    }
+    if (isNil(varGridConfig.pg_size_opt)) {
+        varGridConfig.pg_size_opt = 10;
+    }
+    if (isNil(varGridConfig.expand_accordion_flg)) {
+        varGridConfig.expand_accordion_flg = 1;
+    }
+    if (isNil(varGridConfig.props)) {
+        varGridConfig.props = '{}';
+    }
+    //----------------------------------------------------------------------------------------------------
+    //endregion
+
+    //region 验证数据是否合法
+    //----------------------------------------------------------------------------------------------------
+    //region operation_on_row_click
+    //----------------------------------------------------------------------------------------------------
+    if (![A, B, C].includes(Number(varGridConfig.operation_on_row_click))) {
+        ____ERROR____(`| 数据有误 | var_grid_config.operation_on_row_click 为非法值「${varGridConfig.operation_on_row_click}」, 改为使用默认值 ${1}. 合法的值为 ${A}, ${B}, ${C}.`, {
+            VarGridConfig: varGridConfig,
+        });
+
+        varGridConfig.operation_on_row_click = B;
+    }
+    //endregion
+
+    //region pg_size_opts
+    //----------------------------------------------------------------------------------------------------
+    try {
+        let pageSizeOptions: Array<number> = JSON.parse(varGridConfig.pg_size_opts);
+
+        switch (true) {
+            // 必须是个数组
+            case !isArray(pageSizeOptions):
+            // 至少含有一个数组元素
+            case pageSizeOptions.length < 1:
+            // 数组元素必须都是数字
+            case pageSizeOptions.some((i: any) => Number.isNaN(Number(i)) || Math.floor(Number(i)) <= 0): {
+                ____ERROR____(`| 数据有误 | var_grid_config.pg_size_opts 非法, 改为使用默认值 ${DEFAULT_PAGE_SIZES}.`, {
+                    VarGridConfig: varGridConfig,
+                });
+
+                varGridConfig.pg_size_opts = DEFAULT_PAGE_SIZES;
+
+                break;
+            }
+
+            default:
+                pageSizeOptions = sortBy(uniq(pageSizeOptions.map((i) => Math.floor(i))));
+                varGridConfig.pg_size_opts = JSON.stringify(pageSizeOptions);
+
+                //region pg_size_opt
+                //----------------------------------------------------------------------------------------------------
+                if (!varGridConfig.pg_size_opt) {
+                    varGridConfig.pg_size_opt = pageSizeOptions[0];
+                }
+
+                varGridConfig.pg_size_opt = Number(varGridConfig.pg_size_opt);
+
+                switch (true) {
+                    // 不是数字
+                    case Number.isNaN(varGridConfig.pg_size_opt):
+                    // 不在 pg_size_opts 列表中
+                    case !pageSizeOptions.includes(varGridConfig.pg_size_opt): {
+                        ____ERROR____(`| 数据有误 | var_grid_config.pg_size_opt 非法, 改为使用默认值 ${DEFAULT_PAGE_SIZE}.`, { VarGridConfig: varGridConfig });
+
+                        varGridConfig.pg_size_opt = DEFAULT_PAGE_SIZE;
+
+                        break;
+                    }
+                }
+                //endregion
+
+                break;
+        }
+    } catch (e) {
+        ____ERROR____(`| 数据有误 | var_grid_config.pg_size_opts 非法, 改为使用默认值 ${DEFAULT_PAGE_SIZES}.`, {
+            VarGridConfig: varGridConfig,
+        });
+
+        varGridConfig.pg_size_opts = DEFAULT_PAGE_SIZES;
+        varGridConfig.pg_size_opt = DEFAULT_PAGE_SIZE;
+    }
+    //endregion
+    //----------------------------------------------------------------------------------------------------
+    //endregion
+
+    return varGridConfig;
+}
+//----------------------------------------------------------------------------------------------------
+//endregion
+
+//region 表格视图
+//----------------------------------------------------------------------------------------------------
+export function transformVarGridMasters(varGridMasters?: Array<VarGridMasterDTO> | null): Array<VarGridMasterDTO> {
+    if (!varGridMasters) {
+        return [];
+    }
+
+    return varGridMasters.map((varGridMaster) => {
+        //region 设置默认的值
+        //----------------------------------------------------------------------------------------------------
+        if (isNil(varGridMaster.def_flg)) {
+            varGridMaster.def_flg = 0;
+        }
+        if (isNil(varGridMaster.props)) {
+            varGridMaster.props = '{}';
+        }
+        //----------------------------------------------------------------------------------------------------
+        //endregion
+
+        varGridMaster.varGridDetails = transformVarGridDetails(varGridMaster.varGridDetails);
+
+        return varGridMaster;
+    });
+}
+//----------------------------------------------------------------------------------------------------
+//endregion
+
+//region 父子界面
+//----------------------------------------------------------------------------------------------------
+export function transformVarChildDetails(varChildDetails: Array<VarChildDetail> | null | undefined): Array<VarChildDetail> {
+    if (!varChildDetails) {
+        return [];
+    }
+
+    return varChildDetails.map((varChildDetail) => {
+        //region 设置默认的值
+        //----------------------------------------------------------------------------------------------------
+        if (isNil(varChildDetail.props)) {
+            varChildDetail.props = '{}';
+        }
+        //----------------------------------------------------------------------------------------------------
+        //endregion
+
+        return varChildDetail;
+    });
+}
+//----------------------------------------------------------------------------------------------------
+//endregion
+
+//region 查询条件视图
+//----------------------------------------------------------------------------------------------------
+export function transformVarProfileMasters(varProfileMasters?: Array<VarProfileMasterDTO> | null): Array<VarProfileMasterDTO> {
+    if (!varProfileMasters) {
+        return [];
+    }
+
+    return varProfileMasters.map((varProfileMaster) => {
+        //region 设置默认的值
+        //----------------------------------------------------------------------------------------------------
+        if (isNil(varProfileMaster.dyn_flg)) {
+            varProfileMaster.dyn_flg = 0;
+        }
+        if (isNil(varProfileMaster.def_flg)) {
+            varProfileMaster.def_flg = 0;
+        }
+        if (isNil(varProfileMaster.props)) {
+            varProfileMaster.props = '{}';
+        }
+        //----------------------------------------------------------------------------------------------------
+        //endregion
+
+        varProfileMaster.varProfileDetails = transformVarProfileDetails(varProfileMaster.varProfileDetails);
+
+        return varProfileMaster;
+    });
+}
+//----------------------------------------------------------------------------------------------------
+//endregion
+
+//region 提交表单配置
+//----------------------------------------------------------------------------------------------------
+export function transformVarSubmitConfigs(varSubmitConfigs?: Array<VarSubmitConfig> | null): Array<VarSubmitConfig> {
+    if (!varSubmitConfigs) {
+        return [];
+    }
+
+    const HORIZONTAL = KG__VAR_SUBMIT_CONFIG__LAYOUT.HORIZONTAL;
+    const VERTICAL = KG__VAR_SUBMIT_CONFIG__LAYOUT.VERTICAL;
+
+    const SPAN = KG__VAR_SUBMIT_CONFIG__LABEL_COLUMN_UNIT.SPAN;
+    const PX = KG__VAR_SUBMIT_CONFIG__LABEL_COLUMN_UNIT.PX;
+
+    const DRAWER = KG__VAR_SUBMIT_CONFIG__DISPLAY_TYPE.DRAWER;
+    const MODAL = KG__VAR_SUBMIT_CONFIG__DISPLAY_TYPE.MODAL;
+    const TABLE = KG__VAR_SUBMIT_CONFIG__DISPLAY_TYPE.TABLE;
+    const INLINE = KG__VAR_SUBMIT_CONFIG__DISPLAY_TYPE.INLINE;
+
+    return varSubmitConfigs.map((varSubmitConfig) => {
+        //region 设置默认的值
+        //----------------------------------------------------------------------------------------------------
+        if (isNil(varSubmitConfig.min_width)) {
+            varSubmitConfig.min_width = SUBMIT_DEFAULT_MIN_WIDTH;
+        }
+        if (isNil(varSubmitConfig.max_width)) {
+            varSubmitConfig.max_width = null;
+        }
+        if (isNil(varSubmitConfig.dft_width)) {
+            varSubmitConfig.dft_width = SUBMIT_DEFAULT_WIDTH;
+        }
+        if (isNil(varSubmitConfig.layout)) {
+            varSubmitConfig.layout = SUBMIT_DEFAULT_LAYOUT;
+        }
+        if (isNil(varSubmitConfig.label_col_unit)) {
+            varSubmitConfig.label_col_unit = PX;
+        }
+        if (isNil(varSubmitConfig.display_type)) {
+            varSubmitConfig.display_type = MODAL;
+        }
+        if (isNil(varSubmitConfig.resizable_flg)) {
+            varSubmitConfig.resizable_flg = 1;
+        }
+        if (isNil(varSubmitConfig.fullscreen_flg)) {
+            varSubmitConfig.fullscreen_flg = 1;
+        }
+        if (isNil(varSubmitConfig.dft_fullscreen_flg)) {
+            varSubmitConfig.dft_fullscreen_flg = 0;
+        }
+        if (isNil(varSubmitConfig.responsive_flg)) {
+            varSubmitConfig.responsive_flg = 1;
+        }
+        if (isNil(varSubmitConfig.set_id_to_null_flag)) {
+            varSubmitConfig.set_id_to_null_flag = 0;
+        }
+        if (isNil(varSubmitConfig.props)) {
+            varSubmitConfig.props = '{}';
+        }
+
+        if (varSubmitConfig.layout === HORIZONTAL) {
+            switch (varSubmitConfig.label_col_unit) {
+                case PX: {
+                    if (isNil(varSubmitConfig.label_col)) {
+                        varSubmitConfig.label_col = SUBMIT_DEFAULT_LABEL_COL_FOR_PX;
+                    }
+                    break;
+                }
+
+                case SPAN: {
+                    if (isNil(varSubmitConfig.label_col)) {
+                        varSubmitConfig.label_col = SUBMIT_DEFAULT_LABEL_COL_FOR_SPAN;
+                    }
+                }
+            }
+        }
+        //----------------------------------------------------------------------------------------------------
+        //endregion
+
+        //region 验证数据是否合法
+        //----------------------------------------------------------------------------------------------------
+        //region min_width
+        //----------------------------------------------------------------------------------------------------
+        switch (true) {
+            // 不是数字, 则使用默认值
+            case Number.isNaN(Number(varSubmitConfig.min_width)): {
+                varSubmitConfig.min_width = SUBMIT_DEFAULT_MIN_WIDTH;
+                break;
+            }
+
+            // 超出范围, 则使用默认值
+            case Number(varSubmitConfig.min_width) < SUBMIT_DEFAULT_MIN_WIDTH: {
+                varSubmitConfig.min_width = SUBMIT_DEFAULT_MIN_WIDTH;
+                break;
+            }
+        }
+        //endregion
+
+        //region max_width
+        //----------------------------------------------------------------------------------------------------
+        switch (true) {
+            // 属性值不是数字, 则使用默认值
+            case !isNil(varSubmitConfig.max_width) && Number.isNaN(Number(varSubmitConfig.max_width)): {
+                varSubmitConfig.max_width = null;
+                break;
+            }
+
+            // 超出范围, 则使用默认值
+            case !isNil(varSubmitConfig.max_width) && Number(varSubmitConfig.max_width) < Number(varSubmitConfig.min_width): {
+                varSubmitConfig.max_width = Number(varSubmitConfig.min_width);
+                break;
+            }
+        }
+        //endregion
+
+        //region dft_width
+        //----------------------------------------------------------------------------------------------------
+        switch (true) {
+            // 不是数字, 则使用默认值
+            case Number.isNaN(Number(varSubmitConfig.dft_width)): {
+                varSubmitConfig.dft_width = SUBMIT_DEFAULT_WIDTH;
+                break;
+            }
+
+            // 超出范围, 则使用默认值
+            case Number(varSubmitConfig.dft_width) < varSubmitConfig.min_width! || (!isNil(varSubmitConfig.max_width) && Number(varSubmitConfig.dft_width) > varSubmitConfig.max_width): {
+                varSubmitConfig.dft_width = SUBMIT_DEFAULT_WIDTH;
+                break;
+            }
+        }
+        //endregion
+
+        //region layout
+        //----------------------------------------------------------------------------------------------------
+        if (![VERTICAL, HORIZONTAL, 'inline'].includes(varSubmitConfig.layout)) {
+            ____ERROR____(`| 数据有误 | var_submit_config.layout 非法, 改为使用默认值 ${SUBMIT_DEFAULT_LAYOUT}.`, {
+                VarSubmitConfig: varSubmitConfig,
+            });
+
+            varSubmitConfig.layout = SUBMIT_DEFAULT_LAYOUT;
+        }
+        //endregion
+
+        //region label_col_unit
+        //----------------------------------------------------------------------------------------------------
+        switch (true) {
+            case ![SPAN, PX].includes(varSubmitConfig.label_col_unit as any): {
+                ____ERROR____(`| 数据有误 | var_submit_config.label_col_unit 非法, 改为使用默认值 ${PX}.`, {
+                    VarSubmitConfig: varSubmitConfig,
+                });
+
+                varSubmitConfig.label_col_unit = PX;
+
+                break;
+            }
+        }
+        //endregion
+
+        //region display_type
+        //----------------------------------------------------------------------------------------------------
+        if (![DRAWER, MODAL, TABLE, INLINE].includes(varSubmitConfig.display_type as any)) {
+            ____ERROR____(`| 数据有误 | var_submit_config.display_type 非法, 合法的值为 ${[DRAWER, MODAL, TABLE, INLINE]}, 改为使用默认值 ${MODAL}.`, {
+                VarSubmitConfig: varSubmitConfig,
+            });
+
+            varSubmitConfig.display_type = MODAL;
+        }
+        if ([INLINE].includes(varSubmitConfig.display_type as any)) {
+            const props = KgCoreUtil.tryParseJSON<IKgVarSubmitConfigProperties>(varSubmitConfig.props);
+            if (!props.displayType?.INLINE?.target) {
+                set(props, `displayType.INLINE.target`, `.kg-submit--default-inline-target[kg-form-id="${varSubmitConfig.frm_id}"]`);
+                varSubmitConfig.props = JSON.stringify(props);
+            }
+
+            varSubmitConfig.resizable_flg = 0;
+            varSubmitConfig.fullscreen_flg = 0;
+            varSubmitConfig.dft_fullscreen_flg = 1;
+        }
+        //----------------------------------------------------------------------------------------------------
+        //endregion
+
+        //region label_col
+        //----------------------------------------------------------------------------------------------------
+        if (varSubmitConfig.layout === HORIZONTAL) {
+            switch (varSubmitConfig.label_col_unit) {
+                case PX: {
+                    switch (true) {
+                        case Number.isNaN(Number(varSubmitConfig.label_col)) || Number(varSubmitConfig.label_col) <= 0: {
+                            ____ERROR____(`| 数据有误 | var_submit_config.label_col 非法, 改为使用默认值 ${SUBMIT_DEFAULT_LABEL_COL_FOR_PX}.`, {
+                                VarSubmitConfig: varSubmitConfig,
+                            });
+
+                            varSubmitConfig.label_col = SUBMIT_DEFAULT_LABEL_COL_FOR_PX;
+
+                            break;
+                        }
+
+                        default: {
+                            varSubmitConfig.label_col = Number(varSubmitConfig.label_col);
+                            break;
+                        }
+                    }
+
+                    break;
+                }
+
+                case SPAN: {
+                    switch (true) {
+                        case Number.isNaN(Number(varSubmitConfig.label_col)) || Number(varSubmitConfig.label_col) > 24 || Number(varSubmitConfig.label_col) < 1: {
+                            ____ERROR____(`| 数据有误 | var_submit_config.label_col 非法, 改为使用默认值 ${SUBMIT_DEFAULT_LABEL_COL_FOR_SPAN}.`, {
+                                VarSubmitConfig: varSubmitConfig,
+                            });
+
+                            varSubmitConfig.label_col = SUBMIT_DEFAULT_LABEL_COL_FOR_SPAN;
+
+                            break;
+                        }
+
+                        default: {
+                            // 取整
+                            varSubmitConfig.label_col = Math.floor(Number(varSubmitConfig.label_col));
+                            break;
+                        }
+                    }
+                }
+            }
+        }
+        //endregion
+        //----------------------------------------------------------------------------------------------------
+        //endregion
+
+        return varSubmitConfig;
+    });
+}
+//----------------------------------------------------------------------------------------------------
+//endregion
+
+//region 提交表单字段
+//----------------------------------------------------------------------------------------------------
+export function transformVarSubmitDetails(varSubmitDetails?: Array<VarSubmitDetail> | null): Array<VarSubmitDetail> {
+    if (!varSubmitDetails) {
+        return [];
+    }
+
+    const kg = useKg();
+
+    varSubmitDetails.map((varSubmitDetail) => {
+        //region 设置默认的值
+        //----------------------------------------------------------------------------------------------------
+        if (isNil(varSubmitDetail.srtseq)) {
+            varSubmitDetail.srtseq = 0;
+        }
+        if (isNil(varSubmitDetail.required_flag)) {
+            varSubmitDetail.required_flag = 0;
+        }
+        if (isNil(varSubmitDetail.key_flg)) {
+            varSubmitDetail.key_flg = 0;
+        }
+        if (isNil(varSubmitDetail.enable_flag)) {
+            varSubmitDetail.enable_flag = 1;
+        }
+        if (isNil(varSubmitDetail.visible_flag)) {
+            varSubmitDetail.visible_flag = 1;
+        }
+        if (isNil(varSubmitDetail.props)) {
+            varSubmitDetail.props = '{}';
+        }
+        //----------------------------------------------------------------------------------------------------
+        //endregion
+
+        return varSubmitDetail;
+    });
+
+    //region 验证数据是否合法
+    //----------------------------------------------------------------------------------------------------
+    varSubmitDetails.map((varSubmitDetail) => {
+        if (
+            !isNil(varSubmitDetail.width) &&
+            !new Array(24)
+                .fill(0)
+                .map((value, index) => index + 1)
+                .includes(Number(varSubmitDetail.width))
+        ) {
+            ____ERROR____('| 数据有误 | VarSubmitDetail.width 必须为 [1, 24] 之间的整数.', { VarSubmitDetail: varSubmitDetail });
+        }
+
+        return varSubmitDetail;
+    });
+    //----------------------------------------------------------------------------------------------------
+    //endregion
+
+    //region visible_flag
+    //----------------------------------------------------------------------------------------------------
+    varSubmitDetails.forEach((varSubmitDetail) => {
+        // 在「查询条件视图」界面中, 当未启用高级查询时, 隐藏 dyn_flg 字段,
+        if (varSubmitDetail.frm_id === FORM_ID__SEARCH__VAR_PROFILE_MASTER && varSubmitDetail.var_nam === 'dyn_flg' && kg.option.KgSearch?.dynamicQuery?.on !== true) {
+            varSubmitDetail.visible_flag = 0;
+        }
+    });
+    //endregion
+
+    return varSubmitDetails;
+}
+//----------------------------------------------------------------------------------------------------
+//endregion
+
+//region 按钮
+//----------------------------------------------------------------------------------------------------
+export function transformVarButtons(varButtons?: Array<VarButton> | null): Array<VarButton> {
+    if (!varButtons) {
+        return [];
+    }
+
+    return varButtons.map((varButton) => {
+        //region 设置默认的值
+        //----------------------------------------------------------------------------------------------------
+        switch (varButton.typ) {
+            case KG__VAR_BUTTON__TYPE.SEARCH: {
+                if (isNil(varButton.icon)) {
+                    varButton.icon = 'ant-design:search-outlined';
+                }
+                if (isNil(varButton.primary_flg)) {
+                    varButton.primary_flg = 1;
+                }
+                if (isNil(varButton.color)) {
+                    varButton.color = KG__VAR_BUTTON__COLOR.BLUE;
+                }
+                if (isNil(varButton.cmd_method)) {
+                    varButton.cmd_method = KG__API_METHOD.GET;
+                }
+                if (isNil(varButton.dis_no_select_flg)) {
+                    varButton.dis_no_select_flg = 0;
+                }
+                if (isNil(varButton.dis_mult_select_flg)) {
+                    varButton.dis_mult_select_flg = 0;
+                }
+                if (isNil(varButton.reload_all_after_done_flg)) {
+                    varButton.reload_all_after_done_flg = 0;
+                }
+                if (isNil(varButton.re_select_after_reload_flg)) {
+                    varButton.re_select_after_reload_flg = 1;
+                }
+                break;
+            }
+
+            case KG__VAR_BUTTON__TYPE.CREATE: {
+                if (isNil(varButton.icon)) {
+                    varButton.icon = 'ant-design:plus-outlined';
+                }
+                if (isNil(varButton.primary_flg)) {
+                    varButton.primary_flg = 1;
+                }
+                if (isNil(varButton.color)) {
+                    varButton.color = KG__VAR_BUTTON__COLOR.BLUE;
+                }
+                if (isNil(varButton.cmd_method)) {
+                    varButton.cmd_method = KG__API_METHOD.POST;
+                }
+                if (isNil(varButton.dis_no_select_flg)) {
+                    varButton.dis_no_select_flg = 0;
+                }
+                if (isNil(varButton.dis_mult_select_flg)) {
+                    varButton.dis_mult_select_flg = 0;
+                }
+                if (isNil(varButton.reload_all_after_done_flg)) {
+                    varButton.reload_all_after_done_flg = 1;
+                }
+                if (isNil(varButton.re_select_after_reload_flg)) {
+                    varButton.re_select_after_reload_flg = 1;
+                }
+                break;
+            }
+
+            case KG__VAR_BUTTON__TYPE.UPDATE: {
+                if (isNil(varButton.icon)) {
+                    varButton.icon = 'ant-design:edit-outlined';
+                }
+                if (isNil(varButton.primary_flg)) {
+                    varButton.primary_flg = 0;
+                }
+                if (isNil(varButton.color)) {
+                    varButton.color = KG__VAR_BUTTON__COLOR.BLUE;
+                }
+                if (isNil(varButton.cmd_method)) {
+                    varButton.cmd_method = KG__API_METHOD.POST;
+                }
+                if (isNil(varButton.dis_no_select_flg)) {
+                    varButton.dis_no_select_flg = 1;
+                }
+                if (isNil(varButton.dis_mult_select_flg)) {
+                    varButton.dis_mult_select_flg = 1;
+                }
+                if (isNil(varButton.reload_all_after_done_flg)) {
+                    varButton.reload_all_after_done_flg = 1;
+                }
+                if (isNil(varButton.re_select_after_reload_flg)) {
+                    varButton.re_select_after_reload_flg = 1;
+                }
+                break;
+            }
+
+            case KG__VAR_BUTTON__TYPE.COPY: {
+                if (isNil(varButton.icon)) {
+                    varButton.icon = 'ant-design:copy-outlined';
+                }
+                if (isNil(varButton.primary_flg)) {
+                    varButton.primary_flg = 0;
+                }
+                if (isNil(varButton.color)) {
+                    varButton.color = KG__VAR_BUTTON__COLOR.BLUE;
+                }
+                if (isNil(varButton.cmd_method)) {
+                    varButton.cmd_method = KG__API_METHOD.POST;
+                }
+                if (isNil(varButton.dis_no_select_flg)) {
+                    varButton.dis_no_select_flg = 1;
+                }
+                if (isNil(varButton.dis_mult_select_flg)) {
+                    varButton.dis_mult_select_flg = 1;
+                }
+                if (isNil(varButton.reload_all_after_done_flg)) {
+                    varButton.reload_all_after_done_flg = 1;
+                }
+                if (isNil(varButton.re_select_after_reload_flg)) {
+                    varButton.re_select_after_reload_flg = 1;
+                }
+                break;
+            }
+
+            case KG__VAR_BUTTON__TYPE.DELETE: {
+                if (isNil(varButton.icon)) {
+                    varButton.icon = 'ant-design:delete-outlined';
+                }
+                if (isNil(varButton.primary_flg)) {
+                    varButton.primary_flg = 0;
+                }
+                if (isNil(varButton.color)) {
+                    varButton.color = KG__VAR_BUTTON__COLOR.RED;
+                }
+                if (isNil(varButton.cmd_method)) {
+                    varButton.cmd_method = KG__API_METHOD.POST;
+                }
+                if (isNil(varButton.dis_no_select_flg)) {
+                    varButton.dis_no_select_flg = 1;
+                }
+                if (isNil(varButton.dis_mult_select_flg)) {
+                    varButton.dis_mult_select_flg = 0;
+                }
+                if (isNil(varButton.reload_all_after_done_flg)) {
+                    varButton.reload_all_after_done_flg = 1;
+                }
+                if (isNil(varButton.re_select_after_reload_flg)) {
+                    varButton.re_select_after_reload_flg = 0;
+                }
+                break;
+            }
+
+            case KG__VAR_BUTTON__TYPE.IMPORT: {
+                if (isNil(varButton.icon)) {
+                    varButton.icon = 'ant-design:upload-outlined';
+                }
+                if (isNil(varButton.primary_flg)) {
+                    varButton.primary_flg = 0;
+                }
+                if (isNil(varButton.color)) {
+                    varButton.color = KG__VAR_BUTTON__COLOR.BLUE;
+                }
+                if (isNil(varButton.cmd_method)) {
+                    varButton.cmd_method = KG__API_METHOD.POST;
+                }
+                if (isNil(varButton.dis_no_select_flg)) {
+                    varButton.dis_no_select_flg = 0;
+                }
+                if (isNil(varButton.dis_mult_select_flg)) {
+                    varButton.dis_mult_select_flg = 0;
+                }
+                if (isNil(varButton.reload_all_after_done_flg)) {
+                    varButton.reload_all_after_done_flg = 1;
+                }
+                if (isNil(varButton.re_select_after_reload_flg)) {
+                    varButton.re_select_after_reload_flg = 1;
+                }
+                break;
+            }
+
+            case KG__VAR_BUTTON__TYPE.EXPORT: {
+                if (isNil(varButton.icon)) {
+                    varButton.icon = 'ant-design:download-outlined';
+                }
+                if (isNil(varButton.primary_flg)) {
+                    varButton.primary_flg = 0;
+                }
+                if (isNil(varButton.color)) {
+                    varButton.color = KG__VAR_BUTTON__COLOR.BLUE;
+                }
+                if (isNil(varButton.cmd_method)) {
+                    varButton.cmd_method = KG__API_METHOD.GET;
+                }
+                if (isNil(varButton.dis_no_select_flg)) {
+                    varButton.dis_no_select_flg = 0;
+                }
+                if (isNil(varButton.dis_mult_select_flg)) {
+                    varButton.dis_mult_select_flg = 0;
+                }
+                if (isNil(varButton.reload_all_after_done_flg)) {
+                    varButton.reload_all_after_done_flg = 0;
+                }
+                if (isNil(varButton.re_select_after_reload_flg)) {
+                    varButton.re_select_after_reload_flg = 0;
+                }
+                break;
+            }
+
+            case KG__VAR_BUTTON__TYPE.OTHER: {
+                if (isNil(varButton.icon)) {
+                    varButton.icon = 'ant-design:info-circle-outlined';
+                }
+                if (isNil(varButton.primary_flg)) {
+                    varButton.primary_flg = 0;
+                }
+                if (isNil(varButton.color)) {
+                    varButton.color = KG__VAR_BUTTON__COLOR.BLUE;
+                }
+                if (isNil(varButton.cmd_method)) {
+                    varButton.cmd_method = KG__API_METHOD.POST;
+                }
+                if (isNil(varButton.dis_no_select_flg)) {
+                    varButton.dis_no_select_flg = 1;
+                }
+                if (isNil(varButton.dis_mult_select_flg)) {
+                    varButton.dis_mult_select_flg = 1;
+                }
+                if (isNil(varButton.reload_all_after_done_flg)) {
+                    varButton.reload_all_after_done_flg = 1;
+                }
+                if (isNil(varButton.re_select_after_reload_flg)) {
+                    varButton.re_select_after_reload_flg = 1;
+                }
+                break;
+            }
+        }
+
+        if (isNil(varButton.export_excel_suffix)) {
+            varButton.export_excel_suffix = KG__VAR_BUTTON__EXPORT_EXCEL_SUFFIX.XLS;
+        }
+        if (isNil(varButton.srtseq)) {
+            varButton.srtseq = 0;
+        }
+        if (isNil(varButton.available_flag)) {
+            varButton.available_flag = 1;
+        }
+        if (isNil(varButton.show_modal_flg)) {
+            varButton.show_modal_flg = 0;
+        }
+        if (isNil(varButton.show_success_message_flg)) {
+            varButton.show_success_message_flg = 1;
+        }
+        if (isNil(varButton.props)) {
+            varButton.props = '{}';
+        }
+        //----------------------------------------------------------------------------------------------------
+        //endregion
+
+        //region 验证数据是否合法
+        //----------------------------------------------------------------------------------------------------
+        if (![KG__VAR_BUTTON__EXPORT_EXCEL_SUFFIX.XLS, KG__VAR_BUTTON__EXPORT_EXCEL_SUFFIX.XLSX].includes(varButton.export_excel_suffix as any)) {
+            ____ERROR____(`| 数据有误 | var_button.export_excel_suffix 的值必须为 ${KG__VAR_BUTTON__EXPORT_EXCEL_SUFFIX.XLS} 或 ${KG__VAR_BUTTON__EXPORT_EXCEL_SUFFIX.XLS}.`, { VarButton: varButton });
+
+            varButton.export_excel_suffix = KG__VAR_BUTTON__EXPORT_EXCEL_SUFFIX.XLS;
+        }
+        //----------------------------------------------------------------------------------------------------
+        //endregion
+
+        return varButton;
+    });
+}
+//----------------------------------------------------------------------------------------------------
+//endregion
+
+//region 变量配置:列表数据
+//----------------------------------------------------------------------------------------------------
+export function transformVarConfigPossibilities(varConfigPossibilities: Array<VarConfigPossibility> | null | undefined): Array<VarConfigPossibility> {
+    if (!varConfigPossibilities) {
+        return [];
+    }
+
+    const API = KG__VAR_CONFIG_POSSIBILITY__DATA_SOURCE_TYPE.API;
+    const SQL = KG__VAR_CONFIG_POSSIBILITY__DATA_SOURCE_TYPE.SQL;
+
+    const DEFAULT = KG__VAR_CONFIG_POSSIBILITY__VALUE_DATA_TYPE.DEFAULT;
+    const STRING = KG__VAR_CONFIG_POSSIBILITY__VALUE_DATA_TYPE.STRING;
+    const NUMBER = KG__VAR_CONFIG_POSSIBILITY__VALUE_DATA_TYPE.NUMBER;
+    const BOOLEAN = KG__VAR_CONFIG_POSSIBILITY__VALUE_DATA_TYPE.BOOLEAN;
+
+    return varConfigPossibilities.map((varConfigPossibility) => {
+        //region 设置默认的值
+        //----------------------------------------------------------------------------------------------------
+        if (isNil(varConfigPossibility.data_source_type)) {
+            varConfigPossibility.data_source_type = API;
+        }
+        if (isNil(varConfigPossibility.val_data_type)) {
+            varConfigPossibility.val_data_type = DEFAULT;
+        }
+        if (isNil(varConfigPossibility.cmd_method)) {
+            varConfigPossibility.cmd_method = KG__API_METHOD.GET;
+        }
+        if (isNil(varConfigPossibility.props)) {
+            varConfigPossibility.props = '{}';
+        }
+        //----------------------------------------------------------------------------------------------------
+        //endregion
+
+        //region 验证数据是否合法
+        //----------------------------------------------------------------------------------------------------
+        if (![API, SQL].includes(varConfigPossibility.data_source_type as any)) {
+            ____ERROR____(`| 数据有误 | VarConfigPossibility.data_source_type 的值必须为 ${API} 或 ${SQL}.`, {
+                VarConfigPossibility: varConfigPossibility,
+            });
+
+            varConfigPossibility.data_source_type = API;
+        }
+
+        if (![DEFAULT, STRING, NUMBER, BOOLEAN].includes(varConfigPossibility.val_data_type as any)) {
+            ____ERROR____(`| 数据有误 | VarConfigPossibility.val_data_type 的值必须为 ${DEFAULT} 或 ${STRING} 或 ${NUMBER} 或 ${BOOLEAN} 或 null.`, {
+                VarConfigPossibility: varConfigPossibility,
+            });
+
+            varConfigPossibility.val_data_type = DEFAULT;
+        }
+        //----------------------------------------------------------------------------------------------------
+        //endregion
+
+        return varConfigPossibility;
+    });
+}
+//----------------------------------------------------------------------------------------------------
+//endregion
+
+//region 变量配置:表单控件
+//----------------------------------------------------------------------------------------------------
+export function transformVarConfigControls(varConfigControls: Array<VarConfigControl> | null | undefined): Array<VarConfigControl> {
+    if (!varConfigControls) {
+        return [];
+    }
+
+    return varConfigControls.map((varConfigControl) => {
+        //region 设置默认的值
+        //----------------------------------------------------------------------------------------------------
+        if (isNil(varConfigControl.ctrl_typ)) {
+            varConfigControl.ctrl_typ = KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.INPUT;
+        }
+        if (isNil(varConfigControl.props)) {
+            varConfigControl.props = '{}';
+        }
+        //----------------------------------------------------------------------------------------------------
+        //endregion
+
+        return varConfigControl;
+    });
+}
+//----------------------------------------------------------------------------------------------------
+//endregion
+
+//region 变量配置:查找弹窗
+//----------------------------------------------------------------------------------------------------
+export function transformVarConfigLookups(varConfigLookups: Array<VarConfigLookup> | null | undefined): Array<VarConfigLookup> {
+    if (!varConfigLookups) {
+        return [];
+    }
+
+    return varConfigLookups.map((varConfigLookup) => {
+        //region 设置默认的值
+        //----------------------------------------------------------------------------------------------------
+        if (isNil(varConfigLookup.mult_flg)) {
+            varConfigLookup.mult_flg = 0;
+        }
+        if (isNil(varConfigLookup.props)) {
+            varConfigLookup.props = '{}';
+        }
+        //----------------------------------------------------------------------------------------------------
+        //endregion
+
+        return varConfigLookup;
+    });
+}
+//----------------------------------------------------------------------------------------------------
+//endregion
+
+//region 变量配置:文本提示
+//----------------------------------------------------------------------------------------------------
+export function transformVarConfigTips(varConfigTips: Array<VarConfigTip> | null | undefined): Array<VarConfigTip> {
+    if (!varConfigTips) {
+        return [];
+    }
+
+    return varConfigTips.map((varConfigTip) => {
+        //region 设置默认的值
+        //----------------------------------------------------------------------------------------------------
+        if (isNil(varConfigTip.placement)) {
+            varConfigTip.placement = KG__VAR_CONFIG_TIP__PLACEMENT.RIGHT;
+        }
+        if (isNil(varConfigTip.props)) {
+            varConfigTip.props = '{}';
+        }
+        //----------------------------------------------------------------------------------------------------
+        //endregion
+
+        return varConfigTip;
+    });
+}
+//----------------------------------------------------------------------------------------------------
+//endregion
+
+//region 变量配置:表单输入验证
+//----------------------------------------------------------------------------------------------------
+export function transformVarConfigInputs(varConfigInputs: Array<VarConfigInput> | null | undefined): Array<VarConfigInput> {
+    if (!varConfigInputs) {
+        return [];
+    }
+
+    return varConfigInputs.map((varConfigInput) => {
+        //region 设置默认的值
+        //----------------------------------------------------------------------------------------------------
+        if (isNil(varConfigInput.data_type)) {
+            varConfigInput.data_type = KG__VAR_CONFIG_INPUT__DATA_TYPE.ANY;
+        }
+        if (isNil(varConfigInput.validation_type)) {
+            varConfigInput.validation_type = KG__VAR_CONFIG_INPUT__VALIDATION_TYPE.OPTIONS;
+        }
+        if (isNil(varConfigInput.min_include_flg)) {
+            varConfigInput.min_include_flg = 1;
+        }
+        if (isNil(varConfigInput.max_include_flg)) {
+            varConfigInput.max_include_flg = 1;
+        }
+        if (isNil(varConfigInput.props)) {
+            varConfigInput.props = '{}';
+        }
+        //----------------------------------------------------------------------------------------------------
+        //endregion
+
+        return varConfigInput;
+    });
+}
+//----------------------------------------------------------------------------------------------------
+//endregion
+
+//region 按钮配置
+//----------------------------------------------------------------------------------------------------
+export function transformVarButtonConfig(varButtonConfig: VarButtonConfig | null | undefined): VarButtonConfig | null {
+    if (!varButtonConfig) {
+        return null;
+    }
+
+    const DEFAULT = KG__VAR_BUTTON_CONFIG__DISPLAY_TYPE.DEFAULT;
+    const SELECT = KG__VAR_BUTTON_CONFIG__DISPLAY_TYPE.SELECT;
+
+    //region 设置默认的值
+    //----------------------------------------------------------------------------------------------------
+    if (isNil(varButtonConfig.display_type)) {
+        varButtonConfig.display_type = DEFAULT;
+    }
+    if (isNil(varButtonConfig.available_flg)) {
+        varButtonConfig.available_flg = 1;
+    }
+    if (isNil(varButtonConfig.props)) {
+        varButtonConfig.props = '{}';
+    }
+    //----------------------------------------------------------------------------------------------------
+    //endregion
+
+    //region 验证数据是否合法
+    //----------------------------------------------------------------------------------------------------
+    if (![DEFAULT, SELECT].includes(varButtonConfig.display_type as any)) {
+        ____ERROR____(`| 数据有误 | var_button_config.display_type 非法, 合法的值为 ${[DEFAULT, SELECT]}, 改为使用默认值 ${DEFAULT}.`, {
+            VarButtonConfig: varButtonConfig,
+        });
+
+        varButtonConfig.display_type = DEFAULT;
+    }
+    //----------------------------------------------------------------------------------------------------
+    //endregion
+
+    return varButtonConfig;
+}
+//----------------------------------------------------------------------------------------------------
+//endregion
+
+//region 表格视图明细
+//----------------------------------------------------------------------------------------------------
+/**
+ * 处理 VarGridDetail 数据.
+ *
+ * @param varGridDetails 原始数据.
+ */
+export function transformVarGridDetails(varGridDetails?: Array<VarGridDetail> | null): Array<VarGridDetail> {
+    if (!varGridDetails) {
+        return [];
+    }
+
+    let _varGridDetails = varGridDetails.map((varGridDetail) => {
+        //region 设置默认的值
+        //----------------------------------------------------------------------------------------------------
+        if (isNil(varGridDetail.srtseq)) {
+            varGridDetail.srtseq = 0;
+        }
+        if (isNil(varGridDetail.ord_flg)) {
+            varGridDetail.ord_flg = 0;
+        }
+        if (isNil(varGridDetail.ord)) {
+            varGridDetail.ord = -1;
+        }
+        if (isNil(varGridDetail.filter_flag)) {
+            varGridDetail.filter_flag = 0;
+        }
+        if (isNil(varGridDetail.width)) {
+            varGridDetail.width = '120';
+        }
+        if (isNil(varGridDetail.vis_flg)) {
+            varGridDetail.vis_flg = 1;
+        }
+        if (isNil(varGridDetail.fix_left_flg)) {
+            varGridDetail.fix_left_flg = 0;
+        }
+        if (isNil(varGridDetail.fix_right_flg)) {
+            varGridDetail.fix_right_flg = 0;
+        }
+        if (isNil(varGridDetail.ellipsis_flg)) {
+            varGridDetail.ellipsis_flg = 0;
+        }
+        if (isNil(varGridDetail.align)) {
+            varGridDetail.align = KG__VAR_GRID_DETAIL__ALIGN.LEFT;
+        }
+        if (isNil(varGridDetail.props)) {
+            varGridDetail.props = '{}';
+        }
+        //----------------------------------------------------------------------------------------------------
+        //endregion
+
+        return varGridDetail;
+    });
+
+    //region fix_left_flg, fix_right_flg
+    //----------------------------------------------------------------------------------------------------
+    // 固定到左侧的列可能有很多个, 这里找的是最右边的那个,
+    const maxIndexOfFixToLeft = findLastIndex(_varGridDetails, (i) => i.fix_left_flg === 1);
+
+    // 固定到右侧的列可能有很多个, 这里找的是最左边的那个,
+    const minIndexOfFixToRight = findIndex(_varGridDetails, (i) => i.fix_right_flg === 1);
+
+    // 根据 ant-design-vue 组件库的要求,
+    // 当某一列固定到左侧时, 它左边的所有列都必须固定到左侧,
+    // 当某一列固定到右侧时, 它右边的所有列都必须固定到右侧,
+    _varGridDetails.forEach((varGridDetail, index) => {
+        if (maxIndexOfFixToLeft !== -1 && index < maxIndexOfFixToLeft) {
+            varGridDetail.fix_left_flg = 1;
+        }
+
+        if (minIndexOfFixToRight !== -1 && index > minIndexOfFixToRight) {
+            varGridDetail.fix_right_flg = 1;
+        }
+    });
+
+    // 不允许同时固定到左侧和右侧, 如果存在这种数据, 则只保留固定到左侧,
+    _varGridDetails.forEach((varGridDetail) => {
+        if (varGridDetail.fix_left_flg === 1 && varGridDetail.fix_right_flg === 1) {
+            ____ERROR____('| 数据有误 | var_grid_detail.fix_left_flg 和 var_grid_detail.fix_right_flg 不能同时为 1, var_grid_detail.fix_right_flg 将被设为 0.', {
+                VarGridDetail: varGridDetail,
+            });
+
+            varGridDetail.fix_right_flg = 0;
+        }
+    });
+    //endregion
+
+    //region width
+    //----------------------------------------------------------------------------------------------------
+    _varGridDetails.forEach((varGridDetail) => {
+        // width 只能是大于 0 的数值或者 'auto'
+        if (varGridDetail.width !== null && varGridDetail.width !== undefined && varGridDetail.width !== 'auto' && (Number.isNaN(Number(varGridDetail.width)) || Number(varGridDetail.width) < 0)) {
+            ____ERROR____(`| 数据有误 | var_grid_detail.width 只能是大于 0 的数值或者 'auto', 改为使用默认值 ${KG_TABLE_TD_DEFAULT_WIDTH}.`, {
+                VarGridDetail: varGridDetail,
+            });
+
+            varGridDetail.width = String(KG_TABLE_TD_DEFAULT_WIDTH);
+        }
+    });
+    //endregion
+
+    return _varGridDetails;
+}
+//----------------------------------------------------------------------------------------------------
+//endregion
+
+//region 查询条件视图明细
+//----------------------------------------------------------------------------------------------------
+export function transformVarProfileDetails(varProfileDetails?: Array<VarProfileDetail> | null): Array<VarProfileDetail> {
+    if (!varProfileDetails) {
+        return [];
+    }
+
+    return varProfileDetails.map((varProfileDetail) => {
+        //region 设置默认的值
+        //----------------------------------------------------------------------------------------------------
+        if (isNil(varProfileDetail.srtseq)) {
+            varProfileDetail.srtseq = 0;
+        }
+        if (isNil(varProfileDetail.use_underscore_when_dynamic_query_flag)) {
+            varProfileDetail.use_underscore_when_dynamic_query_flag = 1;
+        }
+        if (isNil(varProfileDetail.exclude_from_where_sql_flag)) {
+            varProfileDetail.exclude_from_where_sql_flag = 0;
+        }
+        if (isNil(varProfileDetail.props)) {
+            varProfileDetail.props = '{}';
+        }
+        //----------------------------------------------------------------------------------------------------
+        //endregion
+
+        //region 验证数据是否合法
+        //----------------------------------------------------------------------------------------------------
+        //----------------------------------------------------------------------------------------------------
+        //endregion
+
+        return varProfileDetail;
+    });
+}
+//----------------------------------------------------------------------------------------------------
+//endregion
+
+//region 给所有没有「提交表单字段」的「查询条件视图明细」创建一个默认的「提交表单字段」
+//----------------------------------------------------------------------------------------------------
+/**
+ * 给所有没有「提交表单字段」的「查询条件视图明细」创建一个默认的「提交表单字段」.
+ *
+ * @param varGridMasters 「查询条件视图」列表.
+ * @param varSubmitDetails 「提交表单字段」列表.
+ * @param varButtons 「按钮」列表.
+ */
+export function createDefaultVarSubmitDetailsForVarProfileDetails(varGridMasters: Array<VarProfileMasterDTO>, varSubmitDetails: Array<VarSubmitDetail>, varButtons: Array<VarButton>) {
+    // 找到「查询按钮」的变量名
+    const searchButtonVname = varButtons.find((i) => i.typ === KG__VAR_BUTTON__TYPE.SEARCH)?.var_nam;
+    if (!searchButtonVname) {
+        return;
+    }
+
+    varGridMasters.forEach((varGridMaster) => {
+        varGridMaster.varProfileDetails?.forEach((varProfileDetail) => {
+            const varSubmitDetail = varSubmitDetails.find(
+                (varSubmitDetail) => varSubmitDetail.button_var_name === searchButtonVname && varSubmitDetail.var_nam === varProfileDetail.var_nam && varSubmitDetail.prf_var_nam === varProfileDetail.prf_var_nam,
+            );
+            if (!varSubmitDetail) {
+                // 没有「提交表单字段」, 则创建一个默认的,
+                varSubmitDetails.push({
+                    button_var_name: searchButtonVname,
+                    cust_lvl: KG_CUSTOM_LEVEL.L10,
+                    default_value: null,
+                    enable_flag: 1,
+                    frm_id: varProfileDetail.frm_id,
+                    grp_nam: null,
+                    id: KgUtil.uuid(),
+                    key_flg: 0,
+                    placeholder: null,
+                    prf_var_nam: varProfileDetail.prf_var_nam,
+                    required_flag: 0,
+                    section: null,
+                    srtseq: varProfileDetail.srtseq,
+                    var_nam: varProfileDetail.var_nam,
+                    visible_flag: 1,
+                    width: KG__SPAN._6,
+                });
+            }
+        });
+    });
+}
+//----------------------------------------------------------------------------------------------------
+//endregion
+
+//----------------------------------------------------------------------------------------------------
+//endregion
+
+export interface UseKgVarStoreGetters {
+    /**
+     * 获取当前「表格视图」的主键.
+     */
+    getCurrentVarGridMasterID: (fid: string | null | undefined) => string | null;
+
+    /**
+     * 获取当前的「查询条件」.
+     */
+    getCurrentVarProfileMaster: (fid: string | null | undefined) => VarProfileMasterDTO | null;
+
+    /** 获取当前 VarProfileMaster 的 ID. */
+    getCurrentVarProfileMasterID: (fid: string | null | undefined) => string | null;
+
+    getIsRequestedMap: Record<string, boolean>;
+
+    /**
+     * 获取界面层级.
+     */
+    getLevel: (fid: string | null | undefined) => number;
+
+    getParentKgVar: (fid: string | null | undefined) => IUseKgVar | null;
+
+    getProps: (fid: string | null | undefined) => IKgProps | null;
+
+    getSlots: (fid: string | null | undefined) => IKgSlots | null;
+
+    /**
+     * 和 varName 获取 VarButton.
+     */
+    getVarButton: (fid: string | null | undefined, varName: string | null | undefined) => VarButton | null;
+
+    getVarButtonConfig: (fid: string | null | undefined) => VarButtonConfig | null;
+
+    getVarButtonConfigMap: Record<string, VarButtonConfig | null>;
+
+    getVarButtonCopy: (fid: string | null | undefined) => VarButton | null;
+
+    getVarButtonCreate: (fid: string | null | undefined) => VarButton | null;
+
+    getVarButtonDelete: (fid: string | null | undefined) => VarButton | null;
+
+    getVarButtonMap: Record<string, Array<VarButton>>;
+
+    getVarButtonSearch: (fid: string | null | undefined) => VarButton | null;
+
+    getVarButtonUpdate: (fid: string | null | undefined) => VarButton | null;
+
+    getVarButtons: (fid: string | null | undefined) => Array<VarButton>;
+
+    getVarChildDetails: (fid: string | null | undefined) => Array<VarChildDetail>;
+
+    getVarConfigControl: (fid: string | null | undefined, param: { buttonType?: KG__VAR_BUTTON__TYPE; buttonVarName?: string | null; varName: string | null | undefined }) => VarConfigControl | null;
+
+    getVarConfigInput: (fid: string | null | undefined, varName: string | null | undefined) => VarConfigInput | null;
+
+    getVarConfigLookup: (fid: string | null | undefined, varName: string | null | undefined) => VarConfigLookup | null;
+
+    getVarConfigPossibility: (fid: string | null | undefined, param: { varName: string | null | undefined }) => VarConfigPossibility | null;
+
+    getVarConfigTip: (fid: string | null | undefined, varName: string | null | undefined) => VarConfigTip | null;
+
+    getVarDda: (fid: string | null | undefined) => VarDda | null;
+
+    /**
+     * 获取'表格配置'.
+     */
+    getVarGridConfig: (fid: string | null | undefined) => VarGridConfig | null;
+
+    /** 获取所有的 VarGridConfig. */
+    getVarGridConfigMap: Record<string, VarGridConfig | null>;
+
+    getVarGridDetail: (fid: string | null | undefined, param: { varName: string | null | undefined }) => VarGridDetail | null;
+
+    /**
+     * 获取当前的「表格视图明细」列表.
+     */
+    getVarGridDetailList: (fid: string | null | undefined) => Array<VarGridDetail> | null;
+
+    /**
+     * 获取当前的「表格视图」.
+     */
+    getVarGridMaster: (fid: string | null | undefined) => VarGridMasterDTO | null;
+
+    /**
+     * 获取 VarGridMaster 列表.
+     */
+    getVarGridMasters: (fid: string | null | undefined) => Array<VarGridMasterDTO> | null;
+
+    getVarProfileConfig: (fid: string | null | undefined) => VarProfileConfig | null;
+
+    /**
+     * 和 varName 获取当前 VarProfileMaster 下的某个 VarProfileDetail.
+     */
+    getVarProfileDetail: (fid: string | null | undefined, varName: string | null | undefined) => VarProfileDetail | null;
+
+    getVarProfileMasterMap: Record<
+        string,
+        {
+            varProfileMasters: Array<VarProfileMasterDTO> | null;
+            /** 当前选中的 VarProfileMaster ID. */
+            currentVarProfileMasterID: string | null;
+        }
+    >;
+
+    /**
+     * 获取 VarProfileMasterDTO 列表.
+     */
+    getVarProfileMasters: (fid: string | null | undefined) => Array<VarProfileMasterDTO> | null;
+
+    getVarSubmitConfigMap: Record<string, Array<VarSubmitConfig>>;
+
+    getVarSubmitDetailMap: Record<string, Array<VarSubmitDetail>>;
+
+    getVarVariables: (fid: string | null | undefined) => Array<VarVariable>;
+
+    /**
+     * 获取当前视图下可显示的 VarGridDetail 列表.
+     */
+    getVisibleVarGridDetailList: (fid: string | null | undefined) => Array<VarGridDetail> | null;
+
+    /**
+     * 获取当前视图下可显示的 VarGridDetail 的宽度之和.
+     */
+    getVisibleVarGridDetailListTotalWidth: (fid: string | null | undefined) => number | null;
+
+    isCopyingRequesting: (fid: string | null | undefined) => boolean | null;
+
+    isCreatingRequesting: (fid: string | null | undefined) => boolean | null;
+
+    isDeletingRequesting: (fid: string | null | undefined) => boolean | null;
+
+    isOtherRequesting: (fid: string | null | undefined) => boolean | null;
+
+    /** 变量配置是否查询完成. */
+    isRequested: (fid: string | null | undefined) => boolean;
+
+    isRetrieving: (fid: string | null | undefined) => boolean | null;
+
+    isRetrievingVarGridMaster: (fid: string | null | undefined) => boolean | null;
+
+    isRetrievingVarProfileMaster: (fid: string | null | undefined) => boolean | null;
+
+    isUpdatingRequesting: (fid: string | null | undefined) => boolean | null;
+    t: (fid: string | null | undefined, varName: string | null | undefined) => string;
+}
+
+export interface IUseKgVarStoreActions {
+    createVarConfigControl(varConfigControl: VarConfigControl): void;
+    createVarConfigDescription(varConfigDescription: VarConfigDescription): void;
+    createVarConfigPossibility(varConfigPossibility: VarConfigPossibility): void;
+
+    /**
+     * <p>离开一个界面, 即销毁一个界面.</p>
+     * <p>删除它的变量配置数据.</p>
+     *
+     * @param fid 界面标识.
+     */
+    dispose(fid: string): void;
+
+    /**
+     * 拖拽排序 VarGridDetail 列表.
+     * @param fid 界面标识.
+     * @param fromVarName 被拽起的变量名称
+     * @param toVarName 被放下的变量名称.
+     */
+    dragSortCurrentVarGridDetails(fid: string | null | undefined, fromVarName: string | null | undefined, toVarName: string | null | undefined): void;
+
+    /**
+     * 进入一个界面. 同一个界面不允许进入多次.
+     * @param param.fid 界面标识.
+     * @param param.level 界面层级.
+     */
+    init(param: { formID: string; level: number }): Promise<void>;
+
+    /**
+     * 修改 VarButton 的部分属性.
+     *
+     * @param fid 界面标识.
+     * @param param
+     * @param param.varName 变量名称.
+     * @param param.properties 要修改的部分属性.
+     */
+    patchVarButton(fid: string | null | undefined, param: { properties: VarButton; varName: string | null | undefined }): Promise<void>;
+
+    /**
+     * 修改「表格配置」的部分属性.
+     *
+     * @param fid 界面标识.
+     * @param param
+     * @param param.properties 要修改的部分属性.
+     */
+    patchVarGridConfig(fid: string | null | undefined, param: { properties: VarGridConfig }): Promise<void>;
+
+    /**
+     * 修改当前的「表格视图明细」的部分属性.
+     *
+     * @param fid 界面标识.
+     * @param param
+     * @param param.varName 变量名称.
+     * @param param.properties 要修改的部分属性.
+     */
+    patchVarGridDetail(fid: string | null | undefined, param: { properties: VarGridDetail; varName: string | null | undefined }): Promise<void>;
+
+    /**
+     * 修改当前的「表格视图」的部分属性.
+     *
+     * @param fid 界面标识.
+     * @param param
+     * @param param.properties 要修改的部分属性.
+     */
+    patchVarGridMaster(fid: string | null | undefined, param: { properties: VarGridMasterDTO }): Promise<void>;
+
+    /**
+     * 修改 VarConfigPossibility 的接口参数 cmd_prm 的部分属性.
+     * @param fid 界面标识.
+     * @param varName 变量名称
+     * @param properties 要修改的部分属性.
+     */
+    patchVarPossibilityCommandParameter(fid: string | null | undefined, varName: string | null | undefined, properties: Record<string, any>): Promise<void>;
+
+    /**
+     * 修改 VarProfileDetail 的部分属性.
+     *
+     * @param fid 界面标识.
+     * @param varName 变量名称.
+     * @param properties 要修改的部分属性.
+     */
+    patchVarProfileDetail(fid: string, varName: string | null | undefined, properties: VarProfileDetail): Promise<void>;
+
+    /**
+     * 查询所有变量配置.
+     *
+     * @param fid 界面标识.
+     * @param param 参数.
+     * @param param.isForceRequest 是否强制查询. 默认为 false, 即如果该界面的变量配置已经查询过了, 则不再查询; 否则, 重新查询所有变量配置.
+     */
+    requestAll(fid: string | null | undefined, param?: { isForceRequest?: boolean }): Promise<void>;
+
+    /**
+     * 设置当前「表格视图」的 ID.
+     *
+     * @param fid 界面标识.
+     * @param currentVarGridMasterID 当前选择的表格视图的 ID.
+     */
+    setCurrentVarGridMasterID(fid?: string | null, currentVarGridMasterID?: string | null): Promise<void>;
+
+    /**
+     * 设置当前选择的查询条件的 ID.
+     * @param fid 界面标识.
+     * @param currentVarProfileMasterID 当前选择的查询条件的 ID.
+     */
+    setCurrentVarProfileMasterID(fid?: string | null, currentVarProfileMasterID?: string | null): Promise<void>;
+
+    setIsCopyingRequesting(fid: string, value: boolean): void;
+
+    setIsCreatingRequesting(fid: string, value: boolean): void;
+
+    setIsDeletingRequesting(fid: string, value: boolean): void;
+
+    setIsOtherRequesting(fid: string, value: boolean): void;
+
+    setIsUpdatingRequesting(fid: string, value: boolean): void;
+    setProps(fid: string, value: IKgProps): void;
+    setSlots(fid: string, value: IKgSlots): void;
+
+    /**
+     * 设置某个「变量配置:列表数据」.
+     *
+     * @param fid 界面标识.
+     * @param varName 变量名称
+     * @param varConfigPossibility 配置.
+     */
+    setVarPossibility(fid: string | null | undefined, varName: string | null | undefined, varConfigPossibility: VarConfigPossibility): void;
+
+    /**
+     * 设置查询字段是否启用.
+     * @param fid 界面标识.
+     * @param varName 变量名称.
+     * @param enable 是否启用.
+     */
+    setVarProfileDetailEnable(fid: string, varName: string | null | undefined, enable: number): void;
+}
+
+// @ts-ignore
+export const useKgVarStore: IKgStoreDefinition<UseKgVarStoreGetters, IUseKgVarStoreActions> = defineStore('KgVar', () => {
+    //region STATE
+    //----------------------------------------------------------------------------------------------------
+    /** 正在复制: 正在调用接口. */
+    const isCopyingRequestingMap = ref<Record<string, boolean>>({});
+
+    /** 正在创建: 正在调用接口. */
+    const isCreatingRequestingMap = ref<Record<string, boolean>>({});
+
+    /** 正在删除: 正在调用接口. */
+    const isDeletingRequestingMap = ref<Record<string, boolean>>({});
+
+    /** 其他按钮: 正在调用接口. */
+    const isOtherRequestingMap = ref<Record<string, boolean>>({});
+
+    /** 所有变量配置是否查询完成. */
+    const isRequestedMap = ref<Record<string, boolean>>({});
+
+    /**
+     * 正在查询所有变量配置.
+     */
+    const isRequestingAllMap = ref<Record<string, boolean>>({});
+
+    /** 正在查询「表格视图」. */
+    const isRetrievingVarGridMasterMap = ref<Record<string, boolean>>({});
+
+    /** 正在查询「查询条件视图」. */
+    const isRetrievingVarProfileMasterMap = ref<Record<string, boolean>>({});
+
+    /** 正在更新: 正在调用接口. */
+    const isUpdatingRequestingMap = ref<Record<string, boolean>>({});
+
+    /**
+     * 界面层级.
+     */
+    const levelRecord$ = ref<Record<string, number>>({});
+    const propsRecord$ = ref<Record<string, IKgProps>>({});
+    const slotsRecord$ = ref<Record<string, IKgSlots>>({});
+    const varButtonConfigRecord$ = ref<Record<string, VarButtonConfig | null>>({});
+    const varButtonListRecord$ = ref<Record<string, Array<VarButton>>>({});
+    const varChildDetailListRecord$ = ref<Record<string, Array<VarChildDetail>>>({});
+    const varConfigControlRecord$ = ref<Record<string, Array<VarConfigControl>>>({});
+    const varConfigDescriptionListRecord$ = ref<Record<string, Array<VarConfigDescription>>>({});
+    const varConfigInputListRecord$ = ref<Record<string, Array<VarConfigInput>>>({});
+    const varConfigLookupListRecord$ = ref<Record<string, Array<VarConfigLookup>>>({});
+    const varConfigPossibilityListRecord$ = ref<Record<string, Array<VarConfigPossibility>>>({});
+    const varConfigTipListRecord$ = ref<Record<string, Array<VarConfigTip>>>({});
+    const varDdaRecord$ = ref<Record<string, VarDda | null>>({});
+    const varGridConfigRecord$ = ref<Record<string, VarGridConfig | null>>({});
+    const varGridMasterRecord$ = ref<
+        Record<
+            string,
+            {
+                varGridMasters: Array<VarGridMasterDTO> | null;
+                /** 当前「表格视图」主键. */
+                currentVarGridMasterID: string | null;
+            }
+        >
+    >({});
+    const varProfileConfigRecord$ = ref<Record<string, VarProfileConfig | null>>({});
+    const varProfileMasterRecord$ = ref<
+        Record<
+            string,
+            {
+                varProfileMasters: Array<VarProfileMasterDTO> | null;
+                /** 当前「查询条件视图」主键. */
+                currentVarProfileMasterID: string | null;
+            }
+        >
+    >({});
+    const varSubmitConfigListRecord$ = ref<Record<string, Array<VarSubmitConfig>>>({});
+    const varSubmitDetailListRecord$ = ref<Record<string, Array<VarSubmitDetail>>>({});
+    const varVariableListRecord$ = ref<Record<string, Array<VarVariable> | null>>({});
+    //----------------------------------------------------------------------------------------------------
+    //endregion
+
+    //region GETTERS
+    //----------------------------------------------------------------------------------------------------
+    const getCurrentVarGridMasterID = computed<(fid: string | null | undefined) => string | null>(() => {
+        return (fid) => {
+            return varGridMasterRecord$.value[fid ?? '']?.currentVarGridMasterID ?? null;
+        };
+    });
+
+    const getCurrentVarProfileMaster = computed<(fid: string | null | undefined) => VarProfileMasterDTO | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            // 如果 prf_frm_id 有值, 表示表格用的是其他界面的查询条件,
+            // 否则, 表示表格用的是自己界面的查询条件,
+            const kgSearchFid = getVarGridConfig.value(fid)?.prf_frm_id || fid;
+
+            const varProfileMaster = varProfileMasterRecord$.value[kgSearchFid];
+
+            return varProfileMaster?.varProfileMasters?.find((i) => i.id === varProfileMaster?.currentVarProfileMasterID) ?? null;
+        };
+    });
+
+    const getCurrentVarProfileMasterID = computed<(fid: string | null | undefined) => string | null>(() => {
+        return (fid) => {
+            return varProfileMasterRecord$.value[fid ?? '']?.currentVarProfileMasterID ?? null;
+        };
+    });
+
+    const getIsRequestedMap = computed<Record<string, boolean>>(() => {
+        return isRequestedMap.value;
+    });
+
+    const getVarSubmitConfigMap = computed<Record<string, Array<VarSubmitConfig>>>(() => {
+        return varSubmitConfigListRecord$.value;
+    });
+
+    const getVarSubmitDetailMap = computed<Record<string, Array<VarSubmitDetail>>>(() => {
+        return varSubmitDetailListRecord$.value;
+    });
+
+    const getLevel = computed<(fid: string | null | undefined) => number>(() => {
+        return (fid) => {
+            return levelRecord$.value[fid ?? ''] ?? 0;
+        };
+    });
+
+    const getParentKgVar = computed<(fid: string | null | undefined) => IUseKgVar | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            const varChildDetail = flatten([...values(varChildDetailListRecord$.value)]).find((i) => i.child_form_id === fid);
+            if (!varChildDetail) {
+                return null;
+            }
+
+            return useKgVar(varChildDetail.frm_id);
+        };
+    });
+
+    const getProps = computed<(fid: string | null | undefined) => IKgProps | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            return propsRecord$.value[fid] ?? null;
+        };
+    });
+
+    const getSlots = computed<(fid: string | null | undefined) => IKgSlots | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            return slotsRecord$.value[fid] ?? null;
+        };
+    });
+
+    const getVarButton = computed<(fid: string | null | undefined, varName: string | null | undefined) => VarButton | null>(() => {
+        return (fid, varName) => {
+            if (!fid || !varName) {
+                return null;
+            }
+
+            return varButtonListRecord$.value[fid]?.find((i) => i.var_nam === varName) ?? null;
+        };
+    });
+
+    const getVarButtonConfigMap = computed<Record<string, VarButtonConfig | null>>(() => {
+        return varButtonConfigRecord$.value;
+    });
+
+    const getVarButtonConfig = computed<(fid: string | null | undefined) => VarButtonConfig | null>(() => {
+        return (fid) => {
+            const kgVar = useKgVar(fid);
+
+            return kgVar.store.getVarButtonConfigMap[fid ?? ''] ?? null;
+        };
+    });
+
+    const getVarButtonCopy = computed<(fid: string | null | undefined) => VarButton | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            return varButtonListRecord$.value[fid]?.find((i) => i.typ === KG__VAR_BUTTON__TYPE.COPY) ?? null;
+        };
+    });
+
+    const getVarButtonCreate = computed<(fid: string | null | undefined) => VarButton | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            return varButtonListRecord$.value[fid]?.find((i) => i.typ === KG__VAR_BUTTON__TYPE.CREATE) ?? null;
+        };
+    });
+
+    const getVarButtonDelete = computed<(fid: string | null | undefined) => VarButton | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            return varButtonListRecord$.value[fid]?.find((i) => i.typ === KG__VAR_BUTTON__TYPE.DELETE) ?? null;
+        };
+    });
+
+    const getVarButtonMap = computed<Record<string, Array<VarButton>>>(() => {
+        return varButtonListRecord$.value;
+    });
+
+    const getVarButtonUpdate = computed<(fid: string | null | undefined) => VarButton | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            return varButtonListRecord$.value[fid]?.find((i) => i.typ === KG__VAR_BUTTON__TYPE.UPDATE) ?? null;
+        };
+    });
+
+    const getVarButtonSearch = computed<(fid: string | null | undefined) => VarButton | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            // 首先尝试获取自己界面的查询按钮,
+            // 如果没有, 则可能使用的是其他界面的查询按钮,
+
+            let buttons = getVarButtonMap.value[fid];
+            let button = buttons?.find((i) => i.typ === KG__VAR_BUTTON__TYPE.SEARCH) ?? null;
+
+            if (!button) {
+                const kgSearchFid = getVarGridConfig.value(fid)?.prf_frm_id;
+                if (kgSearchFid) {
+                    buttons = getVarButtonMap.value[kgSearchFid];
+                    button = buttons?.find((i) => i.typ === KG__VAR_BUTTON__TYPE.SEARCH) ?? null;
+                }
+            }
+
+            return button;
+        };
+    });
+
+    const getVarButtons = computed<(fid: string | null | undefined) => Array<VarButton>>(() => {
+        return (fid) => {
+            if (!fid) {
+                return [];
+            }
+
+            return varButtonListRecord$.value[fid]?.sort((x, y) => x.srtseq! - y.srtseq!) ?? [];
+        };
+    });
+
+    const getVarChildDetails = computed<(fid: string | null | undefined) => Array<VarChildDetail>>(() => {
+        return (fid) => {
+            if (!fid) {
+                return [];
+            }
+
+            const varChildDetails = varChildDetailListRecord$.value[fid]?.sort((x, y) => x.sort! - y.sort!) ?? [];
+
+            return varChildDetails;
+        };
+    });
+
+    const getVarConfigControl = computed<(fid: string | null | undefined, param: { buttonType?: KG__VAR_BUTTON__TYPE; buttonVarName?: string | null; varName: string | null | undefined }) => VarConfigControl | null>(() => {
+        return (fid, param) => {
+            if (!fid) {
+                return null;
+            }
+
+            if (!isRequested.value(fid)) {
+                return null;
+            }
+
+            const { buttonType, buttonVarName, varName } = param ?? {};
+
+            const kgVar = useKgVar(fid);
+
+            let _buttonVname = buttonVarName;
+
+            // 如果参数 buttonType 和 buttonVarName 都为 undefined, 表示获取的是「当前按钮」的「变量配置:表单控件」,
+            if (buttonType === undefined && buttonVarName === undefined) {
+                // 「当前按钮」为空,
+                //    可能是正在设置「当前按钮」, 此时不做处理,
+                //    可能是忘了设置「当前按钮」, 需要检查代码中是不是忘了设置「当前按钮」,
+                if (!kgVar.kgButton.currentButton) {
+                    ____WARN_____(`${fid} | KgVar.store.getVarConfigControl() | 「当前按钮」为空.`, { formID: fid, param: param });
+
+                    return null;
+                }
+
+                _buttonVname = kgVar.kgButton.currentButton?.var_nam;
+            }
+
+            const varConfigControls = varConfigControlRecord$.value[fid] ?? [];
+
+            // 根据按钮的变量名称过滤,
+            if (_buttonVname !== undefined) {
+                return varConfigControls.find((i) => i.button_var_name === _buttonVname && i.var_nam === varName) ?? null;
+            }
+
+            // 必须传参
+            if (_buttonVname === undefined && (buttonType === KG__VAR_BUTTON__TYPE.IMPORT || buttonType === KG__VAR_BUTTON__TYPE.IMPORT_TEMPLATE || buttonType === KG__VAR_BUTTON__TYPE.EXPORT || buttonType === KG__VAR_BUTTON__TYPE.OTHER)) {
+                ____ERROR____(`${fid} | KgVar.store.getVarConfigControl() | 参数 param.buttonVarName 不能为空.`, { formID: fid, param: param });
+                return null;
+            }
+
+            // 必须传参
+            if (_buttonVname === undefined && buttonType === undefined) {
+                ____ERROR____(`${fid} | KgVar.store.getVarConfigControl() | 参数 param.buttonType 为 undefined 时, 参数 param.buttonVarName 不能为空.`, { formID: fid, param: param });
+                return null;
+            }
+
+            // 根据按钮的类型获取按钮, 再根据按钮的变量名称过滤,
+            if (_buttonVname === undefined && buttonType !== undefined) {
+                const button = varButtonListRecord$.value[fid]?.find((i) => i.typ === buttonType);
+                if (!button) {
+                    ____DEBUG____(`${fid} | KgVar.store.getVarConfigControl() | 类型为「${buttonType}」的按钮不存在.`, { formID: fid, param: param });
+                    return null;
+                }
+
+                return varConfigControls.find((i) => i.button_var_name === button?.var_nam && i.var_nam === varName) ?? null;
+            }
+
+            return null;
+        };
+    });
+
+    const getVarConfigInput = computed<(fid: string | null | undefined, varName: string | null | undefined) => VarConfigInput | null>(() => {
+        return (fid, vname) => {
+            if (!fid || !vname) {
+                ____ERROR____('fid 或 vname 为空.');
+                return null;
+            }
+
+            const varConfigInputs = varConfigInputListRecord$.value[fid];
+            return varConfigInputs?.find((i) => i.var_nam === vname) ?? null;
+        };
+    });
+
+    const getVarConfigLookup = computed<(fid: string | null | undefined, varName: string | null | undefined) => VarConfigLookup | null>(() => {
+        return (fid, vname) => {
+            if (!fid || !vname) {
+                ____ERROR____('fid 或 vname 为空.');
+                return null;
+            }
+
+            const varConfigLookups = varConfigLookupListRecord$.value[fid];
+            return varConfigLookups?.find((i) => i.var_nam === vname) ?? null;
+        };
+    });
+    const getVarConfigPossibility = computed<(fid: string | null | undefined, param: { varName: string | null | undefined }) => VarConfigPossibility | null>(() => {
+        return (fid, param) => {
+            const { varName } = param ?? {};
+
+            if (!fid || !varName) {
+                ____ERROR____('fid 或 varName 为空.');
+                return null;
+            }
+
+            return varConfigPossibilityListRecord$.value[fid]?.find((i) => i.var_nam === varName) ?? null;
+        };
+    });
+    const getVarConfigTip = computed<(fid: string | null | undefined, varName: string | null | undefined) => VarConfigTip | null>(() => {
+        return (fid, vname) => {
+            if (!fid || !vname) {
+                ____ERROR____('fid 或 vname 为空.');
+                return null;
+            }
+
+            const varConfigTips = varConfigTipListRecord$.value[fid];
+            return varConfigTips?.find((i) => i.var_nam === vname) ?? null;
+        };
+    });
+    const getVarDda = computed<(fid: string | null | undefined) => VarDda | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            return varDdaRecord$.value[fid] ?? null;
+        };
+    });
+    const getVarGridConfig = computed<(fid: string | null | undefined) => VarGridConfig | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            return varGridConfigRecord$.value[fid] ?? null;
+        };
+    });
+    const getVarGridConfigMap = computed<Record<string, VarGridConfig | null>>(() => {
+        return varGridConfigRecord$.value;
+    });
+    const getVarGridDetail = computed<(fid: string | null | undefined, param: { varName: string | null | undefined }) => VarGridDetail | null>(() => {
+        return (fid, param) => {
+            const { varName } = param ?? {};
+
+            if (!fid || !varName) {
+                // prettier-ignore
+                ____ERROR____('KgVar.store.getVarGridDetail() | fid 或 param.varName 为空.', { formID: fid, param: param });
+                return null;
+            }
+
+            return getVarGridMaster.value(fid)?.varGridDetails?.find((i) => i.var_nam === varName) ?? null;
+        };
+    });
+    const getVarGridDetailList = computed<(fid: string | null | undefined) => Array<VarGridDetail> | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            return getVarGridMaster.value(fid)?.varGridDetails?.sort((x, y) => x.srtseq! - y.srtseq!) ?? null;
+        };
+    });
+    const getVarGridMaster = computed<(fid: string | null | undefined) => VarGridMasterDTO | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            const varGridMaster = varGridMasterRecord$.value[fid];
+            return varGridMaster?.varGridMasters?.find((i) => i.id === varGridMaster?.currentVarGridMasterID) ?? null;
+        };
+    });
+    const getVarGridMasters = computed<(fid: string | null | undefined) => Array<VarGridMasterDTO> | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            return varGridMasterRecord$.value[fid]?.varGridMasters ?? null;
+        };
+    });
+    const getVarProfileConfig = computed<(fid: string | null | undefined) => VarProfileConfig | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            return varProfileConfigRecord$.value[fid] ?? null;
+        };
+    });
+    const getVarProfileDetail = computed<(fid: string | null | undefined, varName: string | null | undefined) => VarProfileDetail | null>(() => {
+        return (fid, vname) => {
+            if (!fid || !vname) {
+                return null;
+            }
+
+            return getCurrentVarProfileMaster.value(fid)?.varProfileDetails?.find((i) => i.var_nam === vname) ?? null;
+        };
+    });
+
+    const getVarProfileMasterMap = computed<
+        Record<
+            string,
+            {
+                varProfileMasters: Array<VarProfileMasterDTO> | null;
+                /** 当前选中的 VarProfileMaster ID. */
+                currentVarProfileMasterID: string | null;
+            }
+        >
+    >(() => {
+        return varProfileMasterRecord$.value;
+    });
+
+    const getVarProfileMasters = computed<(fid: string | null | undefined) => Array<VarProfileMasterDTO> | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            return varProfileMasterRecord$.value[fid]?.varProfileMasters ?? null;
+        };
+    });
+    const getVarVariables = computed<(fid: string | null | undefined) => Array<VarVariable>>(() => {
+        return (fid) => {
+            if (!fid) {
+                return [];
+            }
+
+            return varVariableListRecord$.value[fid] ?? [];
+        };
+    });
+    const getVisibleVarGridDetailList = computed<(fid: string | null | undefined) => Array<VarGridDetail> | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            return (
+                getVarGridMaster
+                    .value(fid)
+                    ?.varGridDetails?.filter((i) => i.vis_flg === 1)
+                    ?.sort((x, y) => x.srtseq! - y.srtseq!) ?? null
+            );
+        };
+    });
+    const getVisibleVarGridDetailListTotalWidth = computed<(fid: string | null | undefined) => number | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            return getVisibleVarGridDetailList.value(fid)?.reduce((sum, i) => sum + (i.width === 'auto' ? KG_TABLE_TD_DEFAULT_WIDTH : Number(i.width) || KG_TABLE_TD_DEFAULT_WIDTH), 0) ?? null;
+        };
+    });
+    const isCopyingRequesting = computed<(fid: string | null | undefined) => boolean | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            return isCopyingRequestingMap.value[fid] ?? null;
+        };
+    });
+    const isCreatingRequesting = computed<(fid: string | null | undefined) => boolean | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            return isCreatingRequestingMap.value[fid] ?? null;
+        };
+    });
+    const isDeletingRequesting = computed<(fid: string | null | undefined) => boolean | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            return isDeletingRequestingMap.value[fid] ?? null;
+        };
+    });
+    const isOtherRequesting = computed<(fid: string | null | undefined) => boolean | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            return isOtherRequestingMap.value[fid] ?? null;
+        };
+    });
+    const isRequested = computed<(fid: string | null | undefined) => boolean>(() => {
+        return (fid) => {
+            if (!fid) {
+                return false;
+            }
+
+            return isRequestedMap.value[fid] ?? false;
+        };
+    });
+    const isRetrieving = computed<(fid: string | null | undefined) => boolean | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            return isRequestingAllMap.value[fid] ?? null;
+        };
+    });
+    const isRetrievingVarGridMaster = computed<(fid: string | null | undefined) => boolean | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            return isRetrievingVarGridMasterMap.value[fid] ?? null;
+        };
+    });
+    const isRetrievingVarProfileMaster = computed<(fid: string | null | undefined) => boolean | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            return isRetrievingVarProfileMasterMap.value[fid] ?? null;
+        };
+    });
+    const isUpdatingRequesting = computed<(fid: string | null | undefined) => boolean | null>(() => {
+        return (fid) => {
+            if (!fid) {
+                return null;
+            }
+
+            return isUpdatingRequestingMap.value[fid] ?? null;
+        };
+    });
+
+    /**
+     * 翻译变量.
+     */
+    const t$$ = computed<(fid: string | null | undefined, varName: string | null | undefined) => string>(() => {
+        return (fid, varName) => {
+            if (!fid || !varName) {
+                return '';
+            }
+
+            // 变量配置数据尚未加载完成, 则显示加载提示,
+            const varConfigDescriptionList = varConfigDescriptionListRecord$.value[fid];
+            if (!varConfigDescriptionList) {
+                return '';
+            }
+
+            // 变量配置数据已经加载完成, 但是没有该变量的翻译配置数据, 则显示变量名,
+            const varConfigDescription = varConfigDescriptionList.find((i) => i.var_nam === varName);
+            if (!varConfigDescription) {
+                return varName;
+            }
+
+            return varConfigDescription.var_text ?? varName;
+        };
+    });
+
+    //----------------------------------------------------------------------------------------------------
+    //endregion
+
+    //region ACTIONS
+    //----------------------------------------------------------------------------------------------------
+
+    function createVarConfigControl(varConfigControl: VarConfigControl): void {
+        if (!varConfigControl?.frm_id) {
+            return;
+        }
+
+        const fid = varConfigControl.frm_id;
+
+        // 如果配置已经存在, 则不允许重复添加,
+        if (varConfigControlRecord$.value[fid]?.find((i) => i.frm_id === fid && i.var_nam === varConfigControl.var_nam && i.locale_id === varConfigControl.locale_id && i.cust_lvl === varConfigControl.cust_lvl)) {
+            return;
+        }
+
+        varConfigControlRecord$.value[fid] = [...(varConfigControlRecord$.value[fid] ?? []), ...transformVarConfigControls([varConfigControl])];
+    }
+
+    function createVarConfigPossibility(varConfigPossibility: VarConfigPossibility): void {
+        if (!varConfigPossibility?.frm_id) {
+            return;
+        }
+
+        const fid = varConfigPossibility.frm_id;
+
+        // 如果配置已经存在, 则不允许重复添加,
+        if (varConfigPossibilityListRecord$.value[fid]?.find((i) => i.frm_id === fid && i.var_nam === varConfigPossibility.var_nam && i.locale_id === varConfigPossibility.locale_id && i.cust_lvl === varConfigPossibility.cust_lvl)) {
+            return;
+        }
+
+        varConfigPossibilityListRecord$.value[fid] = [...(varConfigPossibilityListRecord$.value[fid] ?? []), ...transformVarConfigPossibilities([varConfigPossibility])];
+    }
+
+    function dispose(fid: string): void {
+        delete isCopyingRequestingMap.value[fid];
+        delete isCreatingRequestingMap.value[fid];
+        delete isDeletingRequestingMap.value[fid];
+        delete isOtherRequestingMap.value[fid];
+        delete isRequestedMap.value[fid];
+        delete isRequestingAllMap.value[fid];
+        delete isRetrievingVarGridMasterMap.value[fid];
+        delete isRetrievingVarProfileMasterMap.value[fid];
+        delete isUpdatingRequestingMap.value[fid];
+        delete levelRecord$.value[fid];
+    }
+
+    function dragSortCurrentVarGridDetails(fid: string | null | undefined, fromVarName: string | null | undefined, toVarName: string | null | undefined): void {
+        if (!fid || !fromVarName || !toVarName || fromVarName === toVarName) {
+            return;
+        }
+
+        const currentVarGridDetails = getVarGridDetailList.value(fid);
+        if (!currentVarGridDetails) {
+            return;
+        }
+
+        const fromIndex = currentVarGridDetails.findIndex((i) => i.var_nam === fromVarName);
+        const toIndex = currentVarGridDetails.findIndex((i) => i.var_nam === toVarName);
+        if (fromIndex === -1 || toIndex === -1) {
+            return;
+        }
+
+        const fromVarGridDetail = currentVarGridDetails.find((i) => i.var_nam === fromVarName)!;
+
+        const newCurrentVarGridDetails: Array<VarGridDetail> = [];
+        currentVarGridDetails.forEach((value, index) => {
+            // 往前拖
+            if (fromIndex > toIndex) {
+                if (index < toIndex) {
+                    newCurrentVarGridDetails.push(value);
+                } else if (index === toIndex) {
+                    newCurrentVarGridDetails.push(fromVarGridDetail);
+                    newCurrentVarGridDetails.push(value);
+                } else if (index > toIndex && index !== fromIndex) {
+                    newCurrentVarGridDetails.push(value);
+                }
+            }
+            // 往后拖
+            else if (fromIndex < toIndex) {
+                if (index < fromIndex) {
+                    newCurrentVarGridDetails.push(value);
+                } else if (index === fromIndex) {
+                } else {
+                    if (index === toIndex) {
+                        newCurrentVarGridDetails.push(value);
+                        newCurrentVarGridDetails.push(fromVarGridDetail);
+                    } else {
+                        newCurrentVarGridDetails.push(value);
+                    }
+                }
+            }
+        });
+
+        newCurrentVarGridDetails.forEach((value, index) => {
+            value.srtseq = index + 1;
+        });
+
+        getVarGridMaster.value(fid)!.varGridDetails = newCurrentVarGridDetails;
+    }
+
+    async function init(param: { formID: string; level: number }): Promise<void> {
+        const { formID, level } = param ?? {};
+
+        if (levelRecord$.value[formID]) {
+            ____ERROR____('不支持多个界面使用同一个界面标识(fid).', { fid: formID });
+            return;
+        }
+
+        levelRecord$.value[formID] = level;
+
+        await requestAll(param.formID);
+    }
+
+    function patchVarButton(fid: string | null | undefined, param: { properties: VarButton; varName: string | null | undefined }): Promise<void> {
+        const { varName, properties } = param ?? {};
+
+        if (!fid || !varName || !properties) {
+            return Promise.resolve();
+        }
+
+        return new Promise((resolve, reject) => {
+            // 等待变量配置数据查询完成
+            const stopWatch = watch(
+                () => isRequestedMap.value[fid],
+                (isRequested) => {
+                    if (!isRequested) {
+                        return;
+                    }
+
+                    setTimeout(() => {
+                        stopWatch();
+
+                        const varButton = getVarButton.value(fid, varName);
+                        if (!varButton) {
+                            ____ERROR____(`${fid} | KgVar.store.patchVarButton() | VarButton 为空.`, { formID: fid, varName: varName });
+                            return resolve();
+                        }
+
+                        Object.entries(properties).forEach(([key, newValue]) => {
+                            if (key in varButton) {
+                                const oldValue = (varButton as any)[key];
+                                if (oldValue !== newValue) {
+                                    (varButton as any)[key] = newValue;
+                                }
+                            }
+                        });
+
+                        resolve();
+                    });
+                },
+                { immediate: true },
+            );
+        });
+    }
+
+    function patchVarGridConfig(fid: string, param: { properties: VarGridConfig }): Promise<void> {
+        if (!fid) {
+            return Promise.resolve();
+        }
+
+        const { properties } = param ?? {};
+
+        return new Promise((resolve) => {
+            // 等待变量配置数据查询完成
+            const stopWatch = watch(
+                () => isRequestedMap.value[fid],
+                (isRequested) => {
+                    if (!isRequested) {
+                        return;
+                    }
+
+                    setTimeout(() => {
+                        stopWatch();
+
+                        const varGridConfig = getVarGridConfig.value(fid);
+                        if (!varGridConfig) {
+                            ____ERROR____(`${fid} | kgVar.patchVarGridConfig() | VarGridConfig 为空.`, { formID: fid });
+                            return resolve();
+                        }
+
+                        Object.entries(properties).forEach(([key, value]) => {
+                            if (key in varGridConfig) {
+                                (varGridConfig as any)[key] = value;
+                            }
+                        });
+
+                        resolve();
+                    });
+                },
+                { immediate: true },
+            );
+        });
+    }
+
+    function patchVarGridDetail(fid: string | null | undefined, param: { properties: VarGridDetail; varName: string | null | undefined }): Promise<void> {
+        const { varName, properties } = param ?? {};
+
+        if (!fid || !varName) {
+            return Promise.resolve();
+        }
+
+        return new Promise((resolve) => {
+            // 等待变量配置数据查询完成
+            const stopWatch = watch(
+                () => isRequestedMap.value[fid],
+                (isRequested) => {
+                    if (!isRequested) {
+                        return;
+                    }
+
+                    setTimeout(() => {
+                        stopWatch();
+
+                        const varGridDetail = getVarGridDetail.value(fid, { varName: varName });
+                        if (!varGridDetail) {
+                            return resolve();
+                        }
+
+                        Object.entries(properties).forEach(([key, value]) => {
+                            if (key in varGridDetail) {
+                                (varGridDetail as any)[key] = value;
+                            }
+                        });
+
+                        resolve();
+                    });
+                },
+                { immediate: true },
+            );
+        });
+    }
+
+    function patchVarGridMaster(fid: string | null | undefined, param: { properties: VarGridMasterDTO }): Promise<void> {
+        const { properties } = param ?? {};
+
+        if (!fid) {
+            return Promise.resolve();
+        }
+
+        return new Promise((resolve) => {
+            // 等待变量配置数据查询完成
+            const stopWatch = watch(
+                () => isRequestedMap.value[fid],
+                (isRequested) => {
+                    if (!isRequested) {
+                        return;
+                    }
+
+                    setTimeout(() => {
+                        stopWatch();
+
+                        const varGridMasterDTO = getVarGridMaster.value(fid);
+                        if (!varGridMasterDTO) {
+                            return resolve();
+                        }
+
+                        Object.entries(properties).forEach(([key, value]) => {
+                            if (key in varGridMasterDTO) {
+                                (varGridMasterDTO as any)[key] = value;
+                            }
+                        });
+
+                        resolve();
+                    });
+                },
+                { immediate: true },
+            );
+        });
+    }
+
+    function patchVarPossibilityCommandParameter(fid: string | null | undefined, varName: string | null | undefined, properties: Record<string, any>): Promise<void> {
+        if (!fid || !varName) {
+            return Promise.resolve();
+        }
+
+        return new Promise((resolve, reject) => {
+            const stopWatch = watch(
+                () => getVarConfigPossibility.value(fid, { varName: varName }),
+                (varConfigPossibility) => {
+                    if (varConfigPossibility) {
+                        setTimeout(() => stopWatch(), 0);
+
+                        // 查出旧的参数
+                        let cmd_prm = JSON.parse(varConfigPossibility.cmd_prm ?? '{}');
+                        // 设置新的参数
+                        Object.entries(properties).forEach(([key, value]) => {
+                            cmd_prm[key] = value;
+                        });
+                        varConfigPossibility.cmd_prm = JSON.stringify(cmd_prm);
+
+                        varConfigPossibilityListRecord$.value[fid] = varConfigPossibilityListRecord$.value[fid]!;
+
+                        resolve();
+                    }
+                },
+                { immediate: true },
+            );
+        });
+    }
+
+    function patchVarProfileDetail(fid: string, varName: string | null | undefined, properties: VarProfileDetail): Promise<void> {
+        if (!fid || !varName) {
+            return Promise.resolve();
+        }
+
+        return new Promise((resolve, reject) => {
+            // 等待变量配置数据查询完成
+            const stopWatch = watch(
+                () => isRequestedMap.value[fid],
+                (isRequested) => {
+                    if (!isRequested) {
+                        return;
+                    }
+
+                    setTimeout(() => {
+                        stopWatch();
+
+                        const varProfileDetail = getVarProfileDetail.value(fid, varName);
+                        if (!varProfileDetail) {
+                            ____ERROR____(`${fid} | KgVar.store.patchVarProfileDetail() | VarProfileDetail 为空.`, { formID: fid, varName: varName });
+                            return resolve();
+                        }
+
+                        // 记录属性是否真正发生了变更, 有可能新值和旧值是一样的, 这种情况下就不需要真正地更新数据,
+                        let isChange = false;
+
+                        Object.entries(properties).forEach(([key, newValue]) => {
+                            if (key in varProfileDetail) {
+                                const oldValue = (varProfileDetail as any)[key];
+                                if (oldValue !== newValue) {
+                                    (varProfileDetail as any)[key] = newValue;
+                                    isChange = true;
+                                }
+                            }
+                        });
+
+                        if (!isChange) {
+                            return resolve();
+                        }
+
+                        const varProfileMaster = getCurrentVarProfileMaster.value(fid);
+                        if (!(varProfileMaster && varProfileMaster.varProfileDetails)) {
+                            return resolve();
+                        }
+
+                        const newVarProfileDetails = [...varProfileMaster.varProfileDetails];
+                        newVarProfileDetails.splice(varProfileMaster.varProfileDetails.indexOf(varProfileDetail), 1, { ...varProfileDetail });
+                        varProfileMaster.varProfileDetails = newVarProfileDetails;
+
+                        resolve();
+                    });
+                },
+                { immediate: true },
+            );
+        });
+    }
+
+    async function requestAll(fid: string | null | undefined, param?: { isForceRequest?: boolean }): Promise<void> {
+        if (!fid) {
+            return;
+        }
+
+        if (isRequestingAllMap.value[fid]) {
+            ____DEBUG____(`${fid} | KgVar.store.requestAll() | 正在查询, 不许重复查询.`);
+            return;
+        }
+
+        const { isForceRequest = false } = param ?? {};
+
+        const kg = useKg();
+
+        try {
+            // 尚未查询过, 或者强制查询, 则查询,
+            if (isRequestedMap.value[fid] !== true || isForceRequest) {
+                isRequestingAllMap.value[fid] = true;
+
+                KgUtil.showLoading();
+
+                const kgVar$EventListenerParameter$onBeforeRequest: IKgVar$EventListenerParameter$onBeforeRequest = { id: fid, mock: undefined };
+                await emit<IKgVar$EventListenerParameter$onBeforeRequest>({
+                    event: 'onBeforeRequest',
+                    id: fid,
+                    parameter: kgVar$EventListenerParameter$onBeforeRequest,
+                });
+
+                const {
+                    varButtons,
+                    varButtonConfig,
+                    varChildDetails,
+                    varConfigControls,
+                    varConfigDescriptions,
+                    varConfigInputs,
+                    varConfigLookups,
+                    varConfigPossibilities,
+                    varConfigTips,
+                    varDda,
+                    varGridConfig,
+                    varGridMasters,
+                    varProfileConfig,
+                    varProfileMasters,
+                    varSubmitConfigs,
+                    varSubmitDetails,
+                    varVariables,
+                } = await API.WMS.VarController.GetAll(
+                    {
+                        data: {
+                            frm_id: (() => {
+                                let _formID = fid;
+
+                                // 如果界面标识的格式为 `CLONE[AAA]TO[BBB]`, 表示这个界面的真实的界面标识为 BBB, 并且它的所有配置数据要从 AAA 这个界面克隆而来,
+                                // 因此这里需要查询 AAA 界面的配置数据,
+
+                                const regExp = /CLONE\[(.*)?]TO\[(.*)?]/;
+                                if (regExp.test(fid)) {
+                                    _formID = regExp.exec(fid)?.[1] ?? '';
+                                }
+
+                                if (!_formID) {
+                                    throw new Error(`错误的界面标识:${fid}`);
+                                }
+
+                                return _formID;
+                            })(),
+                        },
+                    },
+                    { mock: kgVar$EventListenerParameter$onBeforeRequest.mock },
+                );
+
+                const _varButtons = transformVarButtons(varButtons?.map((i) => ({ ...i, frm_id: fid })));
+                const _varButtonConfig = transformVarButtonConfig({ ...(varButtonConfig ?? {}), frm_id: fid });
+                const _varChildDetails = transformVarChildDetails(varChildDetails?.map((i) => ({ ...i, frm_id: fid })));
+                const _varDda = varDda ? ({ ...(varDda ?? null), frm_id: fid } as VarDda) : null;
+                const _varConfigControls = transformVarConfigControls(varConfigControls?.map((i) => ({ ...i, frm_id: fid })));
+                const _varConfigDescriptions = (varConfigDescriptions ?? [])?.map((i) => ({ ...i, frm_id: fid }));
+                const _varConfigInputs = transformVarConfigInputs(varConfigInputs?.map((i) => ({ ...i, frm_id: fid })));
+                const _varConfigLookups = transformVarConfigLookups(varConfigLookups?.map((i) => ({ ...i, frm_id: fid })));
+                const _varConfigPossibilities = transformVarConfigPossibilities(varConfigPossibilities?.map((i) => ({ ...i, frm_id: fid })));
+                const _varConfigTips = transformVarConfigTips(varConfigTips?.map((i) => ({ ...i, frm_id: fid })));
+                const _varGridConfig = transformVarGridConfig({ ...(varGridConfig ?? {}), frm_id: fid });
+                const _varGridMasters = transformVarGridMasters(varGridMasters?.map((i) => ({ ...i, frm_id: fid, varGridDetails: i.varGridDetails?.map((i) => ({ ...i, frm_id: fid })) })));
+                const _varProfileConfig = transformVarProfileConfig(varProfileConfig);
+                const _varProfileMasters = transformVarProfileMasters(varProfileMasters?.map((i) => ({ ...i, frm_id: fid, varProfileDetails: i.varProfileDetails?.map((i) => ({ ...i, frm_id: fid })) })));
+                const _varSubmitConfigs = transformVarSubmitConfigs(varSubmitConfigs?.map((i) => ({ ...i, frm_id: fid })));
+                const _varSubmitDetails = transformVarSubmitDetails(varSubmitDetails?.map((i) => ({ ...i, frm_id: fid })));
+                const _varVariables = (varVariables ?? [])?.map((i) => ({ ...i, frm_id: fid }));
+
+                const currentVarProfileMasterID =
+                    (
+                        varProfileMasters?.find((i) => i.id === getCurrentVarProfileMasterID.value(fid)) ||
+                        varProfileMasters?.find((i) => i.def_flg === 1) ||
+                        varProfileMasters?.find((i) => i.cust_lvl === KG_CUSTOM_LEVEL.L0) ||
+                        varProfileMasters?.find(() => true)
+                    )?.id ?? null;
+
+                const currentVarGridMasterID =
+                    (
+                        varGridMasters?.find((i) => i.id === getCurrentVarGridMasterID.value(fid)) ||
+                        varGridMasters?.find((i) => i.def_flg === 1) ||
+                        varGridMasters?.find((i) => i.cust_lvl === KG_CUSTOM_LEVEL.L0) ||
+                        varGridMasters?.find(() => true)
+                    )?.id ?? null;
+
+                createDefaultVarSubmitDetailsForVarProfileDetails(_varGridMasters, _varSubmitDetails, _varButtons);
+
+                varButtonListRecord$.value[fid] = _varButtons;
+                varButtonConfigRecord$.value[fid] = _varButtonConfig;
+                varChildDetailListRecord$.value[fid] = _varChildDetails;
+                varConfigControlRecord$.value[fid] = _varConfigControls;
+                varConfigDescriptionListRecord$.value[fid] = _varConfigDescriptions;
+                varConfigInputListRecord$.value[fid] = _varConfigInputs;
+                varConfigLookupListRecord$.value[fid] = _varConfigLookups;
+                varConfigPossibilityListRecord$.value[fid] = _varConfigPossibilities;
+                varConfigTipListRecord$.value[fid] = _varConfigTips;
+                varDdaRecord$.value[fid] = _varDda;
+                varGridConfigRecord$.value[fid] = _varGridConfig;
+                varGridMasterRecord$.value[fid] = { varGridMasters: _varGridMasters, currentVarGridMasterID: currentVarGridMasterID };
+                varProfileConfigRecord$.value[fid] = _varProfileConfig;
+                varProfileMasterRecord$.value[fid] = { varProfileMasters: _varProfileMasters, currentVarProfileMasterID: currentVarProfileMasterID };
+                varSubmitConfigListRecord$.value[fid] = _varSubmitConfigs;
+                varSubmitDetailListRecord$.value[fid] = _varSubmitDetails;
+                varVariableListRecord$.value[fid] = _varVariables;
+
+                await Promise.all([setCurrentVarGridMasterID(fid, getCurrentVarGridMasterID.value(fid)), setCurrentVarProfileMasterID(fid, getCurrentVarProfileMasterID.value(fid))]);
+
+                // 获取系统描述数据
+                const codeNames = uniq(
+                    getVarGridDetailList
+                        .value(fid)
+                        ?.map((i) => {
+                            const properties = KgCoreUtil.tryParseJSON<IKgVarGridDetailDisplayTypeProperties['DESC']>(i.display_type_properties);
+
+                            // 描述组名为空, 或者延迟请求,
+                            if (!properties.description?.codeName || properties.description?.isDefer === true) {
+                                return null;
+                            }
+
+                            return properties.description?.codeName;
+                        })
+                        ?.filter((i) => !!i) ?? [],
+                );
+                for (let codeName of codeNames) {
+                    kg.requestDescriptionList({ codeName: codeName });
+                }
+
+                isRequestedMap.value[fid] = true;
+
+                await emit<IKgVar$EventListenerParameter$onAfterRequest>({
+                    event: 'onAfterRequest',
+                    id: fid,
+                    parameter: { formID: fid },
+                });
+            }
+        } catch (e) {
+            throw e;
+        } finally {
+            isRequestingAllMap.value[fid] = false;
+            KgUtil.hideLoading();
+        }
+    }
+
+    async function setCurrentVarGridMasterID(fid?: string | null, currentVarGridMasterID?: string | null): Promise<void> {
+        if (!fid) {
+            return;
+        }
+
+        const varGrid = varGridMasterRecord$.value[fid];
+        if (!varGrid) {
+            return;
+        }
+
+        const varGridMaster = varGrid.varGridMasters?.find((i) => i.id === currentVarGridMasterID);
+        if (!varGridMaster) {
+            return;
+        }
+
+        if (!varGridMaster.varGridDetails?.length) {
+            // 若 VarGridDetail 为空, 则调用接口加载数据
+
+            isRetrievingVarGridMasterMap.value[fid] = true;
+            try {
+                const varGridMasterDTO = await API.WMS.VarGridMasterController.QueryByID({
+                    params: { id: varGridMaster.id! },
+                });
+                varGridMaster.varGridDetails = varGridMasterDTO?.varGridDetails ?? [];
+                varGrid.currentVarGridMasterID = currentVarGridMasterID ?? null;
+            } catch (e) {
+                throw e;
+            } finally {
+                isRetrievingVarGridMasterMap.value[fid] = false;
+            }
+        } else {
+            varGrid.currentVarGridMasterID = currentVarGridMasterID ?? null;
+        }
+    }
+
+    async function setCurrentVarProfileMasterID(fid?: string | null, currentVarProfileMasterID?: string | null): Promise<void> {
+        if (!fid) {
+            return;
+        }
+
+        const varProfileMaster = varProfileMasterRecord$.value[fid];
+        if (!varProfileMaster) {
+            return;
+        }
+
+        const currentVarProfileMaster = varProfileMaster.varProfileMasters?.find((i) => i.id === currentVarProfileMasterID);
+        if (!currentVarProfileMaster) {
+            return;
+        }
+
+        varProfileMaster.currentVarProfileMasterID = currentVarProfileMasterID ?? null;
+    }
+
+    function setIsCopyingRequesting(fid: string, value: boolean): void {
+        isCopyingRequestingMap.value[fid] = unref(value);
+    }
+
+    function setIsCreatingRequesting(fid: string, value: boolean): void {
+        isCreatingRequestingMap.value[fid] = unref(value);
+    }
+
+    function setIsDeletingRequesting(fid: string, value: boolean): void {
+        isDeletingRequestingMap.value[fid] = unref(value);
+    }
+
+    function setIsOtherRequesting(fid: string, value: boolean): void {
+        isOtherRequestingMap.value[fid] = unref(value);
+    }
+
+    function setIsUpdatingRequesting(fid: string, value: boolean): void {
+        isUpdatingRequestingMap.value[fid] = unref(value);
+    }
+
+    function setProps(fid: string, value: IKgProps): void {
+        propsRecord$.value[fid] = unref(value);
+    }
+
+    function setSlots(fid: string, value: IKgSlots): void {
+        slotsRecord$.value[fid] = unref(value);
+    }
+
+    function setVarPossibility(fid: string | null | undefined, varName: string | null | undefined, varConfigPossibility: VarConfigPossibility): void {
+        if (!fid || !varName) {
+            return;
+        }
+        const oldVarConfigPossibility = getVarConfigPossibility.value(fid, { varName: varName });
+        if (!oldVarConfigPossibility) {
+            return;
+        }
+
+        Object.assign(oldVarConfigPossibility, varConfigPossibility);
+
+        varConfigPossibilityListRecord$.value[fid] = varConfigPossibilityListRecord$.value[fid]!;
+    }
+
+    function setVarProfileDetailEnable(fid: string, varName: string | null | undefined, enable: number): void {
+        if (!fid || !varName) {
+            return;
+        }
+
+        const stopWatch = watch(
+            () => getVarProfileDetail.value(fid, varName),
+            (varProfileDetail) => {
+                if (varProfileDetail) {
+                    setTimeout(() => stopWatch(), 0);
+
+                    const varSubmitDetail = varSubmitDetailListRecord$.value[fid]?.find((i) => i.frm_id === fid && i.var_nam === varName && i.prf_var_nam === varProfileDetail.prf_var_nam);
+
+                    if (varSubmitDetail) {
+                        varSubmitDetail.enable_flag = enable;
+                    }
+                }
+            },
+            { immediate: true },
+        );
+    }
+
+    function createVarConfigDescription(varConfigDescription: VarConfigDescription): void {
+        if (!varConfigDescription?.frm_id) {
+            return;
+        }
+
+        const fid = varConfigDescription.frm_id;
+
+        // 如果配置已经存在, 则不允许重复添加,
+        if (varConfigDescriptionListRecord$.value[fid]?.find((i) => i.frm_id === fid && i.var_nam === varConfigDescription.var_nam && i.locale_id === varConfigDescription.locale_id && i.cust_lvl === varConfigDescription.cust_lvl)) {
+            return;
+        }
+
+        varConfigDescriptionListRecord$.value[fid] = [...(varConfigDescriptionListRecord$.value[fid] ?? []), varConfigDescription];
+    }
+
+    //----------------------------------------------------------------------------------------------------
+    //endregion
+
+    return {
+        createVarConfigControl: createVarConfigControl,
+        createVarConfigDescription: createVarConfigDescription,
+        createVarConfigPossibility: createVarConfigPossibility,
+        dispose: dispose,
+        dragSortCurrentVarGridDetails: dragSortCurrentVarGridDetails,
+        getCurrentVarGridMasterID: getCurrentVarGridMasterID,
+        getCurrentVarProfileMaster: getCurrentVarProfileMaster,
+        getCurrentVarProfileMasterID: getCurrentVarProfileMasterID,
+        getIsRequestedMap: getIsRequestedMap,
+        getLevel: getLevel,
+        getParentKgVar: getParentKgVar,
+        getProps: getProps,
+        getSlots: getSlots,
+        getVarButton: getVarButton,
+        getVarButtonConfig: getVarButtonConfig,
+        getVarButtonConfigMap: getVarButtonConfigMap,
+        getVarButtonCopy: getVarButtonCopy,
+        getVarButtonCreate: getVarButtonCreate,
+        getVarButtonDelete: getVarButtonDelete,
+        getVarButtonMap: getVarButtonMap,
+        getVarButtonSearch: getVarButtonSearch,
+        getVarButtonUpdate: getVarButtonUpdate,
+        getVarButtons: getVarButtons,
+        getVarChildDetails: getVarChildDetails,
+        getVarConfigControl: getVarConfigControl,
+        getVarConfigInput: getVarConfigInput,
+        getVarConfigLookup: getVarConfigLookup,
+        getVarConfigPossibility: getVarConfigPossibility,
+        getVarConfigTip: getVarConfigTip,
+        getVarDda: getVarDda,
+        getVarGridConfig: getVarGridConfig,
+        getVarGridConfigMap: getVarGridConfigMap,
+        getVarGridDetail: getVarGridDetail,
+        getVarGridDetailList: getVarGridDetailList,
+        getVarGridMaster: getVarGridMaster,
+        getVarGridMasters: getVarGridMasters,
+        getVarProfileConfig: getVarProfileConfig,
+        getVarProfileDetail: getVarProfileDetail,
+        getVarProfileMasterMap: getVarProfileMasterMap,
+        getVarProfileMasters: getVarProfileMasters,
+        getVarSubmitConfigMap: getVarSubmitConfigMap,
+        getVarSubmitDetailMap: getVarSubmitDetailMap,
+        getVarVariables: getVarVariables,
+        getVisibleVarGridDetailList: getVisibleVarGridDetailList,
+        getVisibleVarGridDetailListTotalWidth: getVisibleVarGridDetailListTotalWidth,
+        init: init,
+        isCopyingRequesting: isCopyingRequesting,
+        isCopyingRequestingMap: isCopyingRequestingMap,
+        isCreatingRequesting: isCreatingRequesting,
+        isCreatingRequestingMap: isCreatingRequestingMap,
+        isDeletingRequesting: isDeletingRequesting,
+        isDeletingRequestingMap: isDeletingRequestingMap,
+        isOtherRequesting: isOtherRequesting,
+        isOtherRequestingMap: isOtherRequestingMap,
+        isRequested: isRequested,
+        isRequestedMap: isRequestedMap,
+        isRequestingAllMap: isRequestingAllMap,
+        isRetrieving: isRetrieving,
+        isRetrievingVarGridMaster: isRetrievingVarGridMaster,
+        isRetrievingVarGridMasterMap: isRetrievingVarGridMasterMap,
+        isRetrievingVarProfileMaster: isRetrievingVarProfileMaster,
+        isRetrievingVarProfileMasterMap: isRetrievingVarProfileMasterMap,
+        isUpdatingRequesting: isUpdatingRequesting,
+        isUpdatingRequestingMap: isUpdatingRequestingMap,
+        levelMap$: levelRecord$,
+        patchVarButton: patchVarButton,
+        patchVarGridConfig: patchVarGridConfig,
+        patchVarGridDetail: patchVarGridDetail,
+        patchVarGridMaster: patchVarGridMaster,
+        patchVarPossibilityCommandParameter: patchVarPossibilityCommandParameter,
+        patchVarProfileDetail: patchVarProfileDetail,
+        propsMap$: propsRecord$,
+        requestAll: requestAll,
+        setCurrentVarGridMasterID: setCurrentVarGridMasterID,
+        setCurrentVarProfileMasterID: setCurrentVarProfileMasterID,
+        setIsCopyingRequesting: setIsCopyingRequesting,
+        setIsCreatingRequesting: setIsCreatingRequesting,
+        setIsDeletingRequesting: setIsDeletingRequesting,
+        setIsOtherRequesting: setIsOtherRequesting,
+        setIsUpdatingRequesting: setIsUpdatingRequesting,
+        setProps: setProps,
+        setSlots: setSlots,
+        setVarPossibility: setVarPossibility,
+        setVarProfileDetailEnable: setVarProfileDetailEnable,
+        slotsMap$: slotsRecord$,
+        t: t$$,
+        varButtonConfigMap$: varButtonConfigRecord$,
+        varButtonMap$: varButtonListRecord$,
+        varChildDetailMap$: varChildDetailListRecord$,
+        varConfigControlMap$: varConfigControlRecord$,
+        varConfigDescriptionListMap$: varConfigDescriptionListRecord$,
+        varConfigInputMap$: varConfigInputListRecord$,
+        varConfigLookupMap$: varConfigLookupListRecord$,
+        varConfigPossibilityMap$: varConfigPossibilityListRecord$,
+        varConfigTipMap$: varConfigTipListRecord$,
+        varDdaMap$: varDdaRecord$,
+        varGridConfigMap$: varGridConfigRecord$,
+        varGridMasterMap$: varGridMasterRecord$,
+        varProfileConfigMap$: varProfileConfigRecord$,
+        varProfileMasterMap$: varProfileMasterRecord$,
+        varSubmitConfigMap$: varSubmitConfigListRecord$,
+        varSubmitDetailMap$: varSubmitDetailListRecord$,
+        varVariableMap$: varVariableListRecord$,
+    };
+});