@kengic/vue 0.30.1-beta.96 → 0.31.0

package/util/kg.util.tsx

@@ -1,2997 +0,0 @@
-import { ____DEBUG____, ____ERROR____, KgCoreUtil } from '@kengic/core.core';
-import { doKgWorkStation } from '@kengic/core.react';
-import { Modal, notification, Select } from 'ant-design-vue';
-import { ModalFuncProps } from 'ant-design-vue/lib/modal/Modal';
-import dayjs, { Dayjs } from 'dayjs';
-import { cloneDeep, isArray, isNil, isObjectLike, last, reduce } from 'lodash-es';
-import { inject, toRaw, unref } from 'vue';
-import { RouteLocationNormalizedLoaded } from 'vue-router';
-import { useKgVar, useKgWarehouse } from '../component';
-import { pinia, useKg } from '../config';
-import {
-    IKgVarButtonModalProperties,
-    IKgVarConfigControlControlProperties,
-    IKgVarProfileDetailProperties,
-    KG,
-    KG__DYNAMIC_PARAM,
-    KG__DYNAMIC_PARAM_HASH,
-    KG__VAR_BUTTON__TYPE,
-    KG__VAR_CONFIG_POSSIBILITY__VALUE_DATA_TYPE,
-    KG_APP,
-    KG_APP_PREFIX,
-    KG_APPS,
-    KG_TMP_MENU_ID__BUSINESS_MANAGER,
-    KG_TMP_MENU_ID__DATA_MANAGER,
-    KG_TMP_MENU_ID__PDA,
-    KG_TMP_MENU_ID__SYS,
-    KG_TMP_MENU_ID__WCS,
-} from '../model';
-import { Menu } from '../project/src/router/types';
-
-/**
- * 工具方法.
- */
-export class KgUtil {
-    /**
-     * 将 JSON 字符串转换为 JSON 对象, 如果转化失败, 则返回空对象.
-     *
-     * @param str JSON 字符串.
-     */
-    public static tryParseJSON = KgCoreUtil.tryParseJSON;
-
-    /**
-     * 获取一个 UUID.
-     *
-     * @param param.prefix 前缀, 默认为 ''.
-     * @return UUID.
-     */
-    public static uuid = KgCoreUtil.uuid;
-
-    /**
-     * 下载文件.
-     * @param data 文件数据.
-     * @param fileName 文件名称, 包含后缀.
-     * @param contentType <p>文件类型. 如果为空, 则根据文件名的后缀自动设置.</p>
-     *                    <ul>
-     *                        <li>XLS:  <code>application/vnd.ms-excel</code></li>
-     *                        <li>XLSX: <code>application/vnd.openxmlformats-officedocument.spreadsheetml.sheet</code></li>
-     *                    </ul>
-     */
-    public static downloadFile = KgCoreUtil.downloadFile;
-
-    /**
-     * 根据'文件大小数值'获取'文件大小文本'.
-     * @param size 文件大小数值.
-     */
-    public static getFileSize = KgCoreUtil.getFileSize;
-
-    /**
-     * BASE64 转换为 BLOB.
-     * @param base64 base64 字符串.
-     * @param contentType 文件类型.
-     * @param sliceSize 分块大小.
-     */
-    public static base64toBlob = KgCoreUtil.base64toBlob;
-
-    /**
-     * 显示全局遮罩.
-     */
-    public static showLoading = KgCoreUtil.showLoading;
-
-    /**
-     * 隐藏全局遮罩.
-     */
-    public static hideLoading = KgCoreUtil.hideLoading;
-
-    /**
-     * <p>使用 lodash 的 snakeCase() 将字符串转换为 snake_case 的命名方式, 并且去掉数字前面的下划线.</p>
-     *
-     * @param value 转换前的字符串.
-     * @return 转换后的字符串.
-     */
-    public static snakeCase = KgCoreUtil.snakeCase;
-
-    /**
-     * <p>处理请求参数.</p>
-     * <ul>
-     *     <li>删除无用属性,</li>
-     *     <li>日期转换为字符串,</li>
-     *     <li>解析动态属性, 比如「仓库号」等等,</li>
-     * </ul>
-     *
-     * @param params 请求参数.
-     * @param formID 界面标识.
-     * @param $dayjs dayjs.
-     */
-    public static parseParams(params: Record<string, any> | null | undefined, formID?: string | null, $dayjs?: typeof dayjs): Record<string, any> {
-        let _params = cloneDeep(toRaw(unref(params ?? {})));
-
-        if (!_params || !isObjectLike(_params)) {
-            return _params ?? {};
-        }
-
-        // 处理后的参数,
-        const resultParams: Record<string, any> = isArray(_params) ? [] : {};
-
-        // 有 formID 参数, 表示是 DDA 页面的查询
-        if (formID) {
-            Object.keys(_params)
-                .sort()
-                .forEach((key) => {
-                    const value = _params[key];
-
-                    switch (true) {
-                        // 辅助属性, 用于业务逻辑, 不必传给接口, 删除
-                        case key.endsWith('_obj') || ['__KG_IS_INIT__'].includes(key): {
-                            resultParams[key] = undefined;
-                            delete resultParams[key];
-                            break;
-                        }
-
-                        // 日期
-                        case !!$dayjs && $dayjs.isDayjs(value): {
-                            resultParams[key] = this.parseParamsFromDayjs({ formID: formID, isPad: true, key: key, value: value });
-                            break;
-                        }
-
-                        // 日期范围
-                        case !!$dayjs && isArray(value) && value.length === 2 && $dayjs.isDayjs(value[0]) && $dayjs.isDayjs(value[1]): {
-                            resultParams[key] = undefined;
-
-                            const _leftValue = value[0] as Dayjs;
-                            const _rightValue = value[1] as Dayjs;
-
-                            // 左侧日期的字符串
-                            let _leftStringValue = this.parseParamsFromDayjs({ formID: formID, key: key, value: _leftValue });
-
-                            // 右侧日期的字符串
-                            let _rightStringValue = '';
-
-                            switch (true) {
-                                // 左侧日期为空
-                                case !_leftStringValue: {
-                                    _rightStringValue = this.parseParamsFromDayjs({ formID: formID, isPad: true, key: key, value: _rightValue });
-                                    break;
-                                }
-
-                                // 日期格式为 YYYY-MM-DD HH:mm:ss
-                                case /\d\d-\d\d-\d\d \d\d:\d\d:\d\d/.test(_leftStringValue): {
-                                    if (_rightValue.isValid()) {
-                                        _rightStringValue = _rightValue.add(1, 'second').format('YYYY-MM-DD HH:mm:ss');
-                                    }
-                                    break;
-                                }
-
-                                // 日期格式为 YYYY-MM-DD
-                                case /\d\d-\d\d-\d\d/.test(_leftStringValue): {
-                                    _leftStringValue = `${_leftStringValue} 00:00:00`;
-                                    if (_rightValue.isValid()) {
-                                        _rightStringValue = _rightValue.add(1, 'day').format('YYYY-MM-DD 00:00:00');
-                                    }
-                                    break;
-                                }
-
-                                // 日期格式为 HH:mm:ss
-                                case /\d\d:\d\d:\d\d/.test(_leftStringValue): {
-                                    _leftStringValue = `1900-01-01 ${_leftStringValue}`;
-                                    if (_rightValue.isValid()) {
-                                        _rightStringValue = _rightValue.add(1, 'second').format('1900-01-01 HH:mm:ss');
-                                    }
-                                    break;
-                                }
-                            }
-
-                            resultParams[`${key}_begin`] = _leftStringValue;
-                            resultParams[`${key}_end`] = _rightStringValue;
-
-                            break;
-                        }
-
-                        // object, array
-                        case isObjectLike(value): {
-                            resultParams[key] = this.parseParams(value, formID, $dayjs);
-                            break;
-                        }
-
-                        // string
-                        case typeof value === 'string': {
-                            resultParams[key] = this.parseParamsFromString({ $dayjs: $dayjs, formID: formID, value: value, varName: key });
-                            break;
-                        }
-
-                        // number, boolean, null, undefined
-                        default: {
-                            resultParams[key] = value ?? null;
-                            break;
-                        }
-                    }
-                });
-
-            return resultParams;
-        }
-        // 无 formID 参数, 表示是非 DDA 页面的查询
-        else {
-            Object.keys(_params)
-                .sort()
-                .forEach((key) => {
-                    const value = _params[key];
-
-                    switch (true) {
-                        // 辅助属性, 用于业务逻辑, 不必传给接口, 删除
-                        case key.endsWith('_obj'): {
-                            resultParams[key] = undefined;
-                            delete resultParams[key];
-                            break;
-                        }
-
-                        // 日期
-                        case !!$dayjs && $dayjs.isDayjs(value):
-                            resultParams[key] = this.parseParamsFromDayjs({ key: key, value: value });
-                            break;
-
-                        // 日期范围
-                        case !!$dayjs && isArray(value) && value.length === 2 && $dayjs.isDayjs(value[0]) && $dayjs.isDayjs(value[1]):
-                            resultParams[key] = undefined;
-                            resultParams[`${key}_begin`] = this.parseParamsFromDayjs({ key: key, value: value[0] });
-                            resultParams[`${key}_end`] = this.parseParamsFromDayjs({ key: key, value: value[1] });
-                            break;
-
-                        // object, array
-                        case isObjectLike(value):
-                            resultParams[key] = this.parseParams(value, null, $dayjs);
-                            break;
-
-                        // string
-                        case typeof value === 'string':
-                            resultParams[key] = this.parseParamsFromString({ $dayjs: $dayjs, value: value });
-                            break;
-
-                        // number, boolean, null, undefined
-                        default:
-                            resultParams[key] = value ?? null;
-                            break;
-                    }
-                });
-
-            return resultParams;
-        }
-    }
-
-    /**
-     * 处理请求参数: 解析字符串类型的参数值.
-     *
-     * <ol>
-     *     <li>替换动态参数, '动态参数'需要被替换成实际的值, 动态参数定义参考 {@link KG__DYNAMIC_PARAM }.</li>
-     * </ol>
-     *
-     * @param param.$dayjs dayjs.
-     * @param param.formID 界面标识.
-     * @param param.value 参数的原始值.
-     * @param param.varName 变量名称.
-     */
-    private static parseParamsFromString(param: { $dayjs?: typeof dayjs; formID?: string | null; value: string; varName?: string | null }): any {
-        const { formID, $dayjs, value, varName } = param ?? {};
-
-        if (typeof value !== 'string') {
-            return value;
-        }
-
-        const kg = useKg();
-        const kgVar = formID ? useKgVar(formID) : null;
-
-        // 去除首尾空格,
-        let _value: string = value.trim();
-
-        // 替换动态参数
-        _value = (() => {
-            switch (true) {
-                case _value.includes(KG__DYNAMIC_PARAM.EMPTY_STRING):
-                    return _value.replaceAll(KG__DYNAMIC_PARAM.EMPTY_STRING, '');
-
-                case _value.includes(KG__DYNAMIC_PARAM.WAREHOUSE):
-                    return _value.replaceAll(KG__DYNAMIC_PARAM.WAREHOUSE, useKgWarehouse().warehouse.value?.whId ?? '');
-
-                case _value.includes(KG__DYNAMIC_PARAM.WORK_STATION):
-                    return _value.replaceAll(KG__DYNAMIC_PARAM.WORK_STATION, doKgWorkStation().workStation?.devcod ?? '');
-
-                case _value.includes(KG__DYNAMIC_PARAM.WORK_AREA):
-                    return _value.replaceAll(KG__DYNAMIC_PARAM.WORK_AREA, doKgWorkStation().workStationArea?.wrkare ?? '');
-
-                case _value.includes(KG__DYNAMIC_PARAM.LOCALE):
-                    return _value.replaceAll(KG__DYNAMIC_PARAM.LOCALE, kg.locale?.value ?? '');
-
-                case _value.includes(KG__DYNAMIC_PARAM.NOW): {
-                    if ($dayjs) {
-                        return _value.replaceAll(KG__DYNAMIC_PARAM.NOW, $dayjs().format('YYYY-MM-DD HH:mm:ss'));
-                    }
-
-                    return _value;
-                }
-
-                case _value.includes(KG__DYNAMIC_PARAM.USER):
-                    return _value.replaceAll(KG__DYNAMIC_PARAM.USER, kg.useUserStore?.(pinia)?.userInfo?.username ?? '');
-
-                case _value.includes(KG__DYNAMIC_PARAM.ROW): {
-                    if (kgVar && varName) {
-                        return _value.replaceAll(KG__DYNAMIC_PARAM.ROW, kgVar.kgTable.selectedRow.value?.[varName]);
-                    }
-
-                    return _value;
-                }
-
-                default: {
-                    const execResult: RegExpExecArray | null = /(.*)?({(.*)?})(.*)?/.exec(_value);
-
-                    if (!execResult) {
-                        return _value;
-                    }
-
-                    // 去掉首尾的 {}, 例如 `WAREHOUSE`,
-                    const key = execResult[2].slice(1, -1);
-
-                    switch (true) {
-                        // 如果参数值以':query'结尾, 表示这个参数的值需要从 url 中的查询参数中获取,
-                        case key.endsWith(':query'): {
-                            return ((kg.router?.currentRoute as unknown as RouteLocationNormalizedLoaded)?.query[key.slice(0, -6)] as any) ?? '';
-                        }
-                    }
-                    break;
-                }
-            }
-
-            return _value;
-        })();
-
-        // 替换包含特殊字符的动态参数,
-        _value = (() => {
-            let result = _value;
-
-            if (_value) {
-                Object.keys(KG__DYNAMIC_PARAM_HASH).forEach((dynamicParamKey) => {
-                    const dynamicParamValue = KG__DYNAMIC_PARAM_HASH[dynamicParamKey as keyof typeof KG__DYNAMIC_PARAM_HASH];
-                    if (_value.includes(dynamicParamValue)) {
-                        result = result.replaceAll(dynamicParamValue, KG__DYNAMIC_PARAM[dynamicParamKey as keyof typeof KG__DYNAMIC_PARAM]);
-                    }
-                });
-            }
-
-            return result;
-        })();
-
-        return _value;
-    }
-
-    /**
-     * 处理请求参数: 解析 Dayjs 类型的参数值.
-     *
-     * @param param.formID 界面标识.
-     * @param param.isPad 是否补齐日期格式. 即将 `YYYY-MM-DD` 补齐为 `YYYY-MM-DD 00:00:00`, 将 `HH:mm:ss` 补齐为 `1900-01-01 HH:mm:ss`.
-     * @param param.key 属性名.
-     * @param param.value 参数的原始值.
-     */
-    private static parseParamsFromDayjs(param: { formID?: string | null; isPad?: boolean; key: string; value: any }): string {
-        const { key, value, formID, isPad } = param;
-
-        if (!value || !value.isValid()) {
-            return '';
-        }
-
-        if (!formID) {
-            return value.format('YYYY-MM-DD HH:mm:ss');
-        }
-
-        const kgVar = useKgVar(formID);
-
-        // 控件类型
-        const controlType: string | null = (() => {
-            switch (true) {
-                case kgVar.kgTable.isRetrieving.value || kgVar.kgTable02.isRequesting:
-                    return kgVar.getVarConfigControl({ buttonType: KG__VAR_BUTTON__TYPE.SEARCH, varName: key })?.ctrl_typ ?? KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_DATETIME;
-
-                default: {
-                    // 如果没有当前按钮, 则使用查询按钮, TODO LT 这个主要是由于多个界面公用查询条件时这个问题导致的,
-                    if (!kgVar.kgButton.currentButton) {
-                        return kgVar.getVarConfigControl({ buttonType: KG__VAR_BUTTON__TYPE.SEARCH, varName: key })?.ctrl_typ ?? KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_DATETIME;
-                    }
-
-                    return kgVar.getVarConfigControl({ varName: key })?.ctrl_typ ?? KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_DATETIME;
-                }
-            }
-        })();
-
-        if (!controlType) {
-            ____ERROR____(`KgUtil.parseParamsFromDayjs | 控件类型没有找到 | ${formID} | ${key}`);
-            return value;
-        }
-
-        switch (controlType) {
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_DATE:
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_DATE_RANGE:
-                if (isPad) {
-                    return value.format('YYYY-MM-DD 00:00:00');
-                }
-
-                return value.format('YYYY-MM-DD');
-
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_TIME:
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_TIME_RANGE:
-                if (isPad) {
-                    return value.format('1900-01-01 HH:mm:ss');
-                }
-
-                return value.format('HH:mm:ss');
-
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_DATETIME:
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_DATETIME_RANGE:
-                return value.format('YYYY-MM-DD HH:mm:ss');
-        }
-
-        return value;
-    }
-
-    /**
-     * <p>确认弹窗.</p>
-     * <p>设置了多个属性的默认值, 简化使用.</p>
-     * <p>https://www.antdv.com/components/modal</p>
-     *
-     * @param props
-     */
-    public static confirm(props: IKgVarButtonModalProperties): ModalFunc {
-        const kg = useKg();
-
-        const modalRef = Modal.confirm({
-            autoFocusButton: null,
-            cancelButtonProps: {
-                ...{
-                    // 通过设置样式, 隐藏取消按钮
-                    class: props.kgHideCancelButton === true ? 'kg-invisible' : '',
-                },
-                disabled: false,
-                ...(props.cancelButtonProps ?? {}),
-            },
-            cancelText: kg.t('kg.cancel', {}, '取消'),
-            centered: true,
-            closable: false,
-            content: kg.t('kg.confirmDelete', {}, '确认删除 ?'),
-            iconType: 'warning',
-            keyboard: false,
-            okButtonProps: {
-                danger: true,
-                ...(props.okButtonProps ?? {}),
-            },
-            okText: kg.t('kg.ok', {}, '确定'),
-            title: kg.t('kg.confirm', {}, '确认'),
-            ...props,
-        });
-
-        // 确认按钮显示加载状态, 取消按钮禁用, 表示正在执行操作
-        // @ts-ignore
-        modalRef.showLoading = () => {
-            // @ts-ignore
-            modalRef.update((props: ModalFuncProps) => {
-                const _props = cloneDeep(props);
-                _props.okButtonProps!.loading = true;
-                _props.cancelButtonProps!.disabled = true;
-                return _props;
-            });
-        };
-
-        // @ts-ignore
-        modalRef.hideLoading = () => {
-            // @ts-ignore
-            modalRef.update((props: ModalFuncProps) => {
-                const _props = cloneDeep(props);
-                _props.okButtonProps!.loading = false;
-                _props.cancelButtonProps!.disabled = false;
-                return _props;
-            });
-        };
-
-        return modalRef as ModalFunc;
-    }
-
-    /** @deprecated 已弃用, 请使用 {@link KgUtil.throwNotFormValidationError()} 方法. */
-    public static throwIfNotFormError(e: any): void {
-        if (isObjectLike(e) && 'errorFields' in e && 'outOfDate' in e && 'values' in e) {
-            return;
-        }
-
-        throw e;
-    }
-
-    /**
-     * <p>如果不是表单验证错误, 则直接抛出该错误.</p>
-     * <p>如果是表单验证错误, 则弹框提示表单验证失败消息.</p>
-     *
-     * @param param.error 错误对象.
-     * @param param.formID 界面标识. 通过界面标识可以显示对应字段的翻译, 否则只能显示对应字段的变量名称.
-     * @param param.isShowFormValidationErrorMessage 是否弹框提示表单验证失败消息. 默认为 true.
-     */
-    public static throwNotFormValidationError(param: {
-        error:
-            | {
-                  errorFields: Array<{ errors: Array<string>; name: Array<string>; warnings: Array<any> }>;
-                  outOfDate: boolean;
-                  values: Record<string, any>;
-              }
-            | any;
-        formID?: string;
-        isShowFormValidationErrorMessage?: boolean;
-    }): void {
-        const { formID, error, isShowFormValidationErrorMessage = true } = param ?? {};
-
-        if (isObjectLike(error) && 'errorFields' in error && 'outOfDate' in error && 'values' in error) {
-            if (isShowFormValidationErrorMessage) {
-                const kg = useKg();
-
-                const kgVar = formID ? useKgVar(formID) : null;
-
-                notification.error({
-                    message: () => (
-                        <>
-                            <span>{kg.t('kg.formValidationFail')}:</span>
-
-                            <div style={{ alignItems: 'center', display: 'flex', justifyContent: 'center', marginTop: '8px' }}>
-                                <div style={{ marginRight: '6px' }}>{error.errorFields?.map((i: any) => i.errors.map((j: string, index: number) => <div>{index === 0 ? (kgVar ? kgVar.t(i.name?.[0]).value : i.name?.[0]) : ' '}:</div>))}</div>
-
-                                <div style={{ flex: '1 1 0%', minWidth: '0px' }}>{error.errorFields?.map((i: any) => i.errors.map((j: string) => <div style={{ color: '#ED6F6F' }}>{j}</div>))}</div>
-                            </div>
-                        </>
-                    ),
-                });
-            }
-
-            return;
-        }
-
-        throw error;
-    }
-
-    /**
-     * 将值转换为 Dayjs 对象.
-     * @param value 值.
-     */
-    public static toDayjs(value: any): Dayjs | undefined {
-        if (value === undefined) {
-            return undefined;
-        }
-
-        // 注入由项目提供的 dayjs 实例, 否则调用 isDayjs() 结果不对
-        const $dayjs = inject('$dayjs', dayjs);
-
-        const date = $dayjs(value);
-        if (date?.isValid()) {
-            return date;
-        } else {
-            return undefined;
-        }
-    }
-
-    /**
-     * 判断当前登录用户是否是管理员.
-     * @return {} 如果当前登录用户是管理员则返回 true, 否则返回 false.
-     */
-    public static isAdminUser(): boolean {
-        const kg = useKg();
-
-        if (kg.useUserStore?.(pinia)?.getUserInfo?.username === 'admin') {
-            return true;
-        }
-
-        return false;
-    }
-
-    /**
-     * 判断某个模块是否具有访问权限.
-     * @param app 模块.
-     * @return {} 如果模块具有访问权限则返回 true, 否则返回 false.
-     */
-    public static isAppAuthenticated(app: string | null | undefined): boolean {
-        if (!app) {
-            ____DEBUG____(`KgUtil | isAppAuthenticated() | 模块为空.`, { app });
-            return false;
-        }
-
-        const kg = useKg();
-        const paths = kg.usePermissionStore?.(pinia)?.getBackMenuList?.map((i) => i.path);
-
-        if (paths?.some((i) => KgUtil.isPathInApp(i, app))) {
-            return true;
-        }
-
-        return false;
-    }
-
-    /**
-     * 判断某个地址是否具有访问权限.
-     *
-     * @param path 地址.
-     * @return {} 如果地址具有访问权限则返回 true, 否则返回 false.
-     */
-    public static isPathAuthenticated(path: string | null | undefined): boolean {
-        if (!path) {
-            ____DEBUG____(`KgUtil | isPathAuthenticated() | 地址为空.`, { path });
-            return false;
-        }
-
-        if (KgUtil.isAdminUser()) {
-            return true;
-        }
-
-        const kg = useKg();
-        const menus = kg.usePermissionStore?.(pinia)?.getBackMenuList;
-
-        ____DEBUG____(`KgUtil | isPathAuthenticated() | 菜单列表.`, { path, menus });
-        if (KgUtil.getMenuByPath(menus, path)) {
-            return true;
-        }
-
-        return false;
-    }
-
-    /**
-     * 获取权限策略.
-     * @param permissionCode 权限编码.
-     * @return {} 权限策略.
-     */
-    public static getPermissionType(permissionCode: string | null | undefined): number | null {
-        if (!permissionCode) {
-            return null;
-        }
-
-        const kg = useKg();
-        const permissionStore = kg.usePermissionStore?.(pinia);
-        const permission = permissionStore?.authList?.find((i) => i.action === permissionCode);
-
-        const type = Number(permission?.type);
-        if (type !== 1 && type !== 2) {
-            return null;
-        }
-
-        return type;
-    }
-
-    /**
-     * 根据菜单地址地址获取菜单.
-     *
-     * @param menus 菜单列表.
-     * @param path 菜单地址.
-     * @return {} 如果能找到某个菜单的地址等于传入的地址, 则返回该菜单, 否则返回 null.
-     */
-    public static getMenuByPath(menus: Array<Menu> | null | undefined, path: string): Menu | null {
-        if (!menus) {
-            return null;
-        }
-
-        for (let menu of menus) {
-            // 不显示的菜单不做匹配
-            if (!menu.hideMenu && menu.path === path) {
-                return menu;
-            }
-
-            if (menu.children?.length) {
-                const childMenu = KgUtil.getMenuByPath(menu.children, path);
-                if (childMenu) {
-                    return childMenu;
-                }
-            }
-        }
-
-        return null;
-    }
-
-    /**
-     * 获取第一个类型为叶子节点的菜单, 即第一个没有下级菜单的菜单, 即第一个拥有页面的菜单.
-     * 如果参数 app 不为空, 表示只在该模块的菜单中找; 否则在所有的菜单中找.
-     * @param app 模块.
-     * @return {} 如果能找到, 则返回该菜单, 否则返回 null.
-     */
-    public static getFirstLeafMenu(app?: string | null): Menu | null {
-        const kg = useKg();
-        const menus = kg.usePermissionStore?.(pinia)?.getBackMenuList;
-
-        if (!menus) {
-            return null;
-        }
-
-        const _getFirstLeafMenu = (_menus: Array<Menu>): Menu | null => {
-            for (let menu of _menus) {
-                if (app && !KgUtil.isPathInApp(menu.path, app)) {
-                    continue;
-                }
-
-                if ((menu?.children?.length ?? 0) > 0) {
-                    return _getFirstLeafMenu(menu.children!);
-                } else {
-                    return menu ?? null;
-                }
-            }
-
-            return null;
-        };
-
-        return _getFirstLeafMenu(menus);
-    }
-
-    /**
-     * 翻译菜单标题.
-     *
-     * @param menus 菜单列表, 树形结构.
-     */
-    public static translateMenus(menus: Array<Menu> | null | undefined): Array<Menu> {
-        if (!menus) {
-            return [];
-        }
-
-        const kg = useKg();
-
-        menus.forEach((menu: Menu) => {
-            if (menu.title) {
-                menu.title$raw = menu.title;
-                menu.title = kg.t(menu.title);
-            }
-
-            //
-            if (menu.meta?.title) {
-                menu.meta.title$raw = menu.meta.title;
-
-                if (menu.title) {
-                    menu.meta.title = menu.title;
-                } else {
-                    menu.meta.title = kg.t(menu.meta.title);
-                }
-            }
-
-            //
-            if (menu.name) {
-                menu.name$raw = menu.name;
-
-                if (menu.title) {
-                    menu.name = menu.title;
-                } else {
-                    menu.name = kg.t(menu.name);
-                }
-            }
-
-            //
-            if (menu.slotTitle) {
-                menu.slotTitle$raw = menu.slotTitle;
-
-                if (menu.title) {
-                    menu.slotTitle = menu.title;
-                } else {
-                    menu.slotTitle = kg.t(menu.slotTitle);
-                }
-            }
-
-            KgUtil.translateMenus(menu.children!);
-        });
-
-        return menus;
-    }
-
-    /**
-     * <p>转换菜单列表.</p>
-     * <ol>
-     *     <li>根据模块分组,</li>
-     * </ol>
-     * @param menus 菜单列表, 树形结构.
-     */
-    public static transformMenus(menus: Array<Menu> | null | undefined): Array<Menu> {
-        if (!menus) {
-            return [];
-        }
-
-        const kg = useKg();
-
-        // 菜单的某些属性值是错误的, 需要先修复它们,
-        const fixMenus = (_menus: Array<Menu>) => {
-            _menus.forEach((_menu) => {
-                // 属性 key 和 value 必须一样,
-                if (_menu.key && _menu.key !== _menu.value) {
-                    _menu.value = _menu.key;
-                }
-
-                if (_menu.children) {
-                    fixMenus(_menu.children);
-                }
-            });
-        };
-
-        fixMenus(menus);
-
-        // 模块菜单:通用属性
-        const menuProperties = {
-            parentId: '',
-            app: null,
-            perms: null,
-            permsType: null,
-            icon: 'NULL',
-            component: '',
-            componentName: '',
-            url: '',
-            redirect: null,
-            menuType: 0,
-            isLeaf: false,
-            route: false,
-            keepAlive: false,
-            description: null,
-            delFlag: 0,
-            createBy: null,
-            createTime: null,
-            updateBy: null,
-            updateTime: null,
-            alwaysShow: false,
-            hidden: false,
-            status: null,
-            internalOrExternal: false,
-            leaf: false,
-        };
-
-        // 模块菜单:数据管理
-        const menuDataManager: Menu = {
-            children: [],
-            id: KG_TMP_MENU_ID__DATA_MANAGER,
-            key: KG_TMP_MENU_ID__DATA_MANAGER,
-            name: kg.option.appTitle?.[KG_APP.WMS_DATA_MANAGER] ?? '数据管理',
-            slotTitle: kg.option.appTitle?.[KG_APP.WMS_DATA_MANAGER] ?? '数据管理',
-            sortNo: 1,
-            title: kg.option.appTitle?.[KG_APP.WMS_DATA_MANAGER] ?? '数据管理',
-            ...menuProperties,
-            url: KG_APP_PREFIX.WMS_DATA_MANAGER,
-            value: KG_TMP_MENU_ID__DATA_MANAGER,
-        };
-
-        // 模块菜单:仓库管理
-        const menuBusinessManager: Menu = {
-            children: [],
-            id: KG_TMP_MENU_ID__BUSINESS_MANAGER,
-            key: KG_TMP_MENU_ID__BUSINESS_MANAGER,
-            name: kg.option.appTitle?.[KG_APP.WMS_BUSINESS_MANAGER] ?? '仓库管理',
-            slotTitle: kg.option.appTitle?.[KG_APP.WMS_BUSINESS_MANAGER] ?? '仓库管理',
-            sortNo: 2,
-            title: kg.option.appTitle?.[KG_APP.WMS_BUSINESS_MANAGER] ?? '仓库管理',
-            ...menuProperties,
-            url: KG_APP_PREFIX.WMS_BUSINESS_MANAGER,
-            value: KG_TMP_MENU_ID__BUSINESS_MANAGER,
-        };
-
-        // 模块菜单:WCS
-        const menuWCS: Menu = {
-            children: [],
-            id: KG_TMP_MENU_ID__WCS,
-            key: KG_TMP_MENU_ID__WCS,
-            name: kg.option.appTitle?.[KG_APP.WCS] ?? 'WCS',
-            slotTitle: kg.option.appTitle?.[KG_APP.WCS] ?? 'WCS',
-            sortNo: 3,
-            title: kg.option.appTitle?.[KG_APP.WCS] ?? 'WCS',
-            ...menuProperties,
-            url: KG_APP_PREFIX.WCS,
-            value: KG_TMP_MENU_ID__WCS,
-        };
-
-        // 模块菜单:系统配置
-        const menuSys: Menu = {
-            id: KG_TMP_MENU_ID__SYS,
-            key: KG_TMP_MENU_ID__SYS,
-            title: kg.option.appTitle?.[KG_APP.SYS] ?? '系统配置',
-            name: kg.option.appTitle?.[KG_APP.SYS] ?? '系统配置',
-            slotTitle: kg.option.appTitle?.[KG_APP.SYS] ?? '系统配置',
-            sortNo: 4,
-            children: [],
-            ...menuProperties,
-            url: KG_APP_PREFIX.SYS,
-            value: KG_TMP_MENU_ID__SYS,
-        };
-
-        // 模块:PDA
-        const menuPDA: Menu = {
-            id: KG_TMP_MENU_ID__PDA,
-            key: KG_TMP_MENU_ID__PDA,
-            value: KG_TMP_MENU_ID__PDA,
-            title: 'PDA',
-            name: 'PDA',
-            slotTitle: 'PDA',
-            sortNo: 5,
-            children: [],
-            ...menuProperties,
-        };
-
-        menus.forEach((menu: Menu) => {
-            switch (true) {
-                case menu.app === 'PDA':
-                    menu.parentId = KG_TMP_MENU_ID__PDA;
-                    menuPDA.children!.push(menu);
-                    break;
-
-                case KgUtil.isPathInApp(menu.url, KG_APP.WMS_DATA_MANAGER):
-                    menu.parentId = KG_TMP_MENU_ID__DATA_MANAGER;
-                    menuDataManager.children!.push(menu);
-                    break;
-
-                case KgUtil.isPathInApp(menu.url, KG_APP.WMS_BUSINESS_MANAGER):
-                    menu.parentId = KG_TMP_MENU_ID__BUSINESS_MANAGER;
-                    menuBusinessManager.children!.push(menu);
-                    break;
-
-                case KgUtil.isPathInApp(menu.url, KG_APP.WCS):
-                    menu.parentId = KG_TMP_MENU_ID__WCS;
-                    menuWCS.children!.push(menu);
-                    break;
-
-                case KgUtil.isPathInApp(menu.url, KG_APP.SYS):
-                    menu.parentId = KG_TMP_MENU_ID__SYS;
-                    menuSys.children!.push(menu);
-                    break;
-            }
-        });
-
-        let _menus: Array<Menu> = [];
-
-        // 如果某个模块下面没有菜单, 则不显示这个模块,
-        if (menuDataManager.children?.length ?? 0 > 0) {
-            _menus.push(menuDataManager);
-        }
-
-        if (menuBusinessManager.children?.length ?? 0 > 0) {
-            _menus.push(menuBusinessManager);
-        }
-
-        if (menuWCS.children?.length ?? 0 > 0) {
-            _menus.push(menuWCS);
-        }
-
-        if (menuSys.children?.length ?? 0 > 0) {
-            _menus.push(menuSys);
-        }
-
-        if (menuPDA.children?.length ?? 0 > 0) {
-            _menus.push(menuPDA);
-        }
-
-        // 排序
-        const sortMenus = (_menus: Array<Menu>) => {
-            _menus.sort((x, y) => Number(x?.sortNo ?? 0) - Number(y?.sortNo ?? 0));
-
-            _menus.forEach((_menu) => {
-                if (_menu.children) {
-                    sortMenus(_menu.children);
-                }
-            });
-        };
-
-        sortMenus(_menus);
-
-        return _menus;
-    }
-
-    /**
-     * 判断某个路径是否属于某个模块.
-     * @param path 路径.
-     * @param app 模块.
-     */
-    public static isPathInApp(path: string | null | undefined, app: string | null): boolean {
-        if (!path || !app) {
-            return false;
-        }
-
-        // 一些特殊地址, 不属于任何的模块
-        const SPECIAL_PATHS = ['/home'];
-
-        switch (app) {
-            case KG_APP.WMS_DATA_MANAGER:
-                return path.startsWith(KG_APP_PREFIX.WMS_DATA_MANAGER);
-
-            case KG_APP.WMS_BUSINESS_MANAGER:
-                return path.startsWith(KG_APP_PREFIX.WMS_BUSINESS_MANAGER);
-
-            case KG_APP.WCS:
-                return path.startsWith(KG_APP_PREFIX.WCS);
-
-            case KG_APP.SYS:
-                return path.startsWith(KG_APP_PREFIX.SYS) || (!SPECIAL_PATHS.includes(path) && !path.startsWith(KG_APP_PREFIX.WMS_DATA_MANAGER) && !path.startsWith(KG_APP_PREFIX.WMS_BUSINESS_MANAGER) && !path.startsWith(KG_APP_PREFIX.WCS));
-
-            default:
-                throw new Error(`未知模块: ${app}`);
-        }
-    }
-
-    /**
-     * 根据地址获取模块.
-     * @param path 地址.
-     * @return {} 地址所属模块.
-     */
-    public static getAppByPath(path: string | null | undefined): string | null {
-        const app = KG_APPS.find((app) => KgUtil.isPathInApp(path, app));
-        if (app) {
-            return app;
-        }
-
-        return null;
-    }
-
-    /**
-     * 获取模块的首页地址.
-     * @param app 模块.
-     * @return {} 该模块的首页地址.
-     * @throws {} 如果模块无法识别, 会报错.
-     */
-    public static getAppIndexPath(app: string): string {
-        const kg = useKg();
-
-        let path = '';
-
-        switch (app) {
-            case KG_APP.WMS_DATA_MANAGER:
-                path = kg.option.appIndex?.[KG_APP.WMS_DATA_MANAGER] || `${KG_APP_PREFIX.WMS_DATA_MANAGER}/index`;
-                break;
-
-            case KG_APP.WMS_BUSINESS_MANAGER:
-                path = kg.option.appIndex?.[KG_APP.WMS_BUSINESS_MANAGER] || `${KG_APP_PREFIX.WMS_BUSINESS_MANAGER}/index`;
-                break;
-
-            case KG_APP.WCS:
-                path = kg.option.appIndex?.[KG_APP.WCS] || `${KG_APP_PREFIX.WCS}/index`;
-                break;
-
-            case KG_APP.SYS:
-                path = kg.option.appIndex?.[KG_APP.SYS] || `${KG_APP_PREFIX.SYS}/index`;
-                break;
-
-            default:
-                throw new Error(`未知模块: ${app}`);
-        }
-
-        return path;
-    }
-
-    /**
-     * <p>将 JSON 字符串形式的参数 `'{"foo":1,"bar":2}'` 转换为对象形式的参数 `{ "foo": 1, "bar": 2 }`.</p>
-     *
-     * @param params JSON 字符串形式的参数.
-     * @return {} 参数对象.
-     */
-    public static parseRequestParamsToJSON(params: string | null | undefined): Record<string, any> {
-        let paramsJSON: Record<string, any> = {};
-
-        if (!params) {
-            return paramsJSON;
-        }
-
-        const _params = decodeURIComponent(params);
-
-        try {
-            paramsJSON = JSON.parse(_params);
-        } catch {
-            ____ERROR____('KgUtil.parseRequestParamsToJSON() | 参数格式错误, 必须是一个 JSON 字符串.', { params: _params });
-        }
-
-        return paramsJSON;
-    }
-
-    /**
-     * <p>根据控件类型, 将表单控件的值转换为合法的值.</p>
-     *
-     * @param param.$dayjs dayjs.
-     * @param param.buttonVarName 「变量配置:表单控件」所属的按钮的变量名称.
-     * @param param.formID 界面标识.
-     * @param param.isParseDynamicParam 是否替换动态参数. 默认为 true.
-     * @param param.oldValue 转换之前的值.
-     * @param param.varName 变量名称.
-     * @return {} 转换之后的值.
-     */
-    public static transformVarSubmitDetailValue(param: { $dayjs: typeof dayjs; buttonVarName: string | null | undefined; formID: string; isParseDynamicParam?: boolean; oldValue: any; varName: string }): any {
-        const { formID, varName, $dayjs, oldValue, isParseDynamicParam = true, buttonVarName } = param ?? {};
-
-        const kgVar = useKgVar(formID);
-
-        let _value0 = toRaw(unref(isParseDynamicParam ? KgUtil.parseParamsFromString({ value: oldValue, formID: formID, varName: varName, $dayjs: $dayjs }) : oldValue));
-
-        const varConfigControl = kgVar.getVarConfigControl({ buttonVarName: buttonVarName, varName: varName });
-        if (!varConfigControl) {
-            return _value0;
-        }
-
-        // 表单控件类型
-        const controlType = varConfigControl.ctrl_typ || KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.INPUT;
-
-        switch (controlType) {
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.INPUT:
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.INPUT_PASSWORD:
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.TEXT_AREA: {
-                if (isNil(_value0)) {
-                    return null;
-                }
-
-                return String(_value0);
-            }
-
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.INPUT_NUMBER: {
-                if (isNil(_value0)) {
-                    return undefined;
-                }
-
-                const _value = Number(_value0);
-
-                if (Number.isNaN(_value)) {
-                    // prettier-ignore
-                    ____ERROR____(`| 控件的值非法 | ${controlType} 控件的值必须为数字类型.`, { formID: formID, varName: varName, value: _value0 });
-                    return undefined;
-                }
-
-                return _value;
-            }
-
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.CHECKBOX: {
-                if (isNil(_value0)) {
-                    return 0;
-                }
-
-                const controlProperties = KgCoreUtil.tryParseJSON<IKgVarConfigControlControlProperties['CHECKBOX']>(varConfigControl.ctrl_prop);
-
-                if (controlProperties.dataType === 'BOOLEAN') {
-                    // 转换为布尔类型的值,
-                    const _value = (() => {
-                        if (_value0 === true || _value0 === 1 || _value0 === '1') {
-                            return true;
-                        }
-
-                        if (_value0 === false || _value0 === 0 || _value0 === '0') {
-                            return false;
-                        }
-
-                        if (typeof _value0 === 'string' && _value0.toUpperCase() === 'TRUE') {
-                            return true;
-                        }
-
-                        if (typeof _value0 === 'string' && _value0.toUpperCase() === 'FALSE') {
-                            return false;
-                        }
-
-                        return undefined;
-                    })();
-
-                    if (isNil(_value)) {
-                        // prettier-ignore
-                        ____ERROR____(`| 控件的值非法 | ${controlType} 控件的值必须为 true 或 false.`, { formID: formID, value: _value0, varName: varName });
-                        return undefined;
-                    }
-
-                    return _value;
-                } else {
-                    const _value = Number(_value0);
-
-                    if (Number.isNaN(_value) || ![0, 1].includes(_value)) {
-                        // prettier-ignore
-                        ____ERROR____(`| 控件的值非法 | ${controlType} 控件的值必须为 0 或 1.`, { formID: formID, value: _value0, varName: varName });
-                        return undefined;
-                    }
-
-                    return _value;
-                }
-            }
-
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.SWITCH: {
-                if (isNil(_value0)) {
-                    return 0;
-                }
-
-                const controlProperties = KgCoreUtil.tryParseJSON<IKgVarConfigControlControlProperties['SWITCH']>(varConfigControl.ctrl_prop);
-
-                if (controlProperties.dataType === 'BOOLEAN') {
-                    // 转换为布尔类型的值,
-                    const _value = (() => {
-                        if (_value0 === true || _value0 === 1 || _value0 === '1') {
-                            return true;
-                        }
-
-                        if (_value0 === false || _value0 === 0 || _value0 === '0') {
-                            return false;
-                        }
-
-                        if (typeof _value0 === 'string' && _value0.toUpperCase() === 'TRUE') {
-                            return true;
-                        }
-
-                        if (typeof _value0 === 'string' && _value0.toUpperCase() === 'FALSE') {
-                            return false;
-                        }
-
-                        return undefined;
-                    })();
-
-                    if (isNil(_value)) {
-                        // prettier-ignore
-                        ____ERROR____(`| 控件的值非法 | ${controlType} 控件的值必须为 true 或 false.`, { formID: formID, value: _value0, varName: varName });
-                        return undefined;
-                    }
-
-                    return _value;
-                } else {
-                    const _value = Number(_value0);
-
-                    if (Number.isNaN(_value) || ![0, 1].includes(_value)) {
-                        // prettier-ignore
-                        ____ERROR____(`| 控件的值非法 | ${controlType} 控件的值必须为 0 或 1.`, { formID: formID, value: _value0, varName: varName });
-                        return undefined;
-                    }
-
-                    return _value;
-                }
-            }
-
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_TIME: {
-                if (isNil(_value0) || _value0.trim() === '') {
-                    return undefined;
-                }
-
-                const date = $dayjs(`1900-01-01 ${_value0}`);
-                if (date?.isValid()) {
-                    return date;
-                } else {
-                    // prettier-ignore
-                    ____ERROR____(`| 控件的值非法 | ${controlType} 控件的值必须为时间类型.`, { formID: formID, varName: varName, value: _value0 });
-                    return undefined;
-                }
-            }
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_DATE:
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_DATETIME:
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_WEEK:
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_MONTH:
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_YEAR: {
-                if (isNil(_value0)) {
-                    return undefined;
-                }
-
-                const date = $dayjs(_value0);
-                if (date?.isValid()) {
-                    return date;
-                } else {
-                    // prettier-ignore
-                    ____ERROR____(`| 控件的值非法 | ${controlType} 控件的值必须为日期类型.`, { formID: formID, varName: varName, value: _value0 });
-                    return undefined;
-                }
-            }
-
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.SELECT_MULTIPLE:
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.CHECKBOX_GROUP: {
-                if (isNil(_value0)) {
-                    return [];
-                }
-
-                try {
-                    let datas = _value0;
-                    if (typeof datas === 'string') {
-                        datas = JSON.parse(_value0);
-                    }
-
-                    if (!isArray(datas)) {
-                        // prettier-ignore
-                        ____ERROR____(`| 控件的值非法 | ${controlType} 控件的值必须为数组类型.`, { formID: formID, varName: varName, value: _value0 });
-                        return undefined;
-                    }
-
-                    const varConfigPossibility = kgVar.getVarConfigPossibility({ varName: varName });
-
-                    switch (varConfigPossibility?.val_data_type) {
-                        case KG__VAR_CONFIG_POSSIBILITY__VALUE_DATA_TYPE.NUMBER: {
-                            const _value = datas.map((i) => Number(i));
-
-                            if (_value.some((i) => Number.isNaN(_value))) {
-                                // prettier-ignore
-                                ____ERROR____(`| 控件的值非法 | ${controlType} 控件的值必须为 number 数组类型.`, { VarConfigPossibility: varConfigPossibility, formID: formID, value: _value0, varName: varName });
-                                return undefined;
-                            }
-
-                            return _value;
-                        }
-
-                        case KG__VAR_CONFIG_POSSIBILITY__VALUE_DATA_TYPE.BOOLEAN:
-                            return datas.map((i) => Boolean(i));
-
-                        case KG__VAR_CONFIG_POSSIBILITY__VALUE_DATA_TYPE.STRING:
-                            return datas.map((i) => String(i));
-
-                        case KG__VAR_CONFIG_POSSIBILITY__VALUE_DATA_TYPE.DEFAULT:
-                            return datas;
-
-                        default:
-                            return datas;
-                    }
-                } catch (e) {
-                    // prettier-ignore
-                    ____ERROR____(`| 控件的值非法 | ${controlType} 控件的值必须为数组类型.`, { formID: formID, value: _value0, varName: varName });
-                    return undefined;
-                }
-            }
-
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.SELECT: {
-                if (isNil(_value0)) {
-                    return undefined;
-                }
-
-                const varConfigPossibility = kgVar.getVarConfigPossibility({ varName: varName });
-
-                switch (varConfigPossibility?.val_data_type) {
-                    case KG__VAR_CONFIG_POSSIBILITY__VALUE_DATA_TYPE.NUMBER: {
-                        const _value = Number(_value0);
-
-                        if (Number.isNaN(_value)) {
-                            // prettier-ignore
-                            ____ERROR____(`| 控件的值非法 | ${controlType} 控件的值必须为数字类型.`, { VarConfigPossibility: varConfigPossibility, formID: formID, value: _value0, varName: varName });
-                            return undefined;
-                        }
-
-                        return _value;
-                    }
-
-                    case KG__VAR_CONFIG_POSSIBILITY__VALUE_DATA_TYPE.BOOLEAN: {
-                        if (_value0 === true || _value0 === 1 || _value0 === '1') {
-                            return true;
-                        }
-
-                        if (_value0 === false || _value0 === 0 || _value0 === '0') {
-                            return false;
-                        }
-
-                        if (typeof _value0 === 'string' && _value0.toUpperCase() === 'TRUE') {
-                            return true;
-                        }
-
-                        if (typeof _value0 === 'string' && _value0.toUpperCase() === 'FALSE') {
-                            return false;
-                        }
-
-                        return Boolean(_value0);
-                    }
-
-                    case KG__VAR_CONFIG_POSSIBILITY__VALUE_DATA_TYPE.STRING: {
-                        return String(_value0);
-                    }
-
-                    case KG__VAR_CONFIG_POSSIBILITY__VALUE_DATA_TYPE.DEFAULT: {
-                        return _value0;
-                    }
-                }
-
-                break;
-            }
-
-            default: {
-                return _value0;
-            }
-        }
-    }
-
-    /**
-     * 计算某个列表数据的文本.
-     *
-     * <p>
-     *     labelColumn 可以是一个 JS 表达式, 组件库会解析该表达式, 并得到真正的值. 比如表达式 \`${row.id}\` 表示获取该行的 id 列的值. 表达式中可以使用下列变量:
-     *     <ul>
-     *         <li>row: 表示该行数据,</li>
-     *     </ul>
-     * </p>
-     *
-     * @param row 该行数据.
-     * @param labelColumn 文本对应的字段或者表达式.
-     * @param valueColumn 数据对应的字段或者表达式.
-     */
-    public static evaluateVarConfigPossibilityLabel(row: any, labelColumn: string, valueColumn: string): string {
-        if (!row || !isObjectLike(row) || !labelColumn || typeof labelColumn !== 'string' || typeof valueColumn !== 'string') {
-            return '';
-        }
-
-        const labelExpression = (() => {
-            // 如果以 `${ 开头并且以 }` 结尾, 表示是一个 javascript 的模板字符串, 直接解析,
-            // 否则, 表示是一个简单的字段名, 需要先拼接成模板字符串, 再解析,
-
-            if (labelColumn.startsWith('`${') || labelColumn.endsWith('}`')) {
-                if (!labelColumn.startsWith('`${') || !labelColumn.endsWith('}`')) {
-                    // prettier-ignore
-                    ____ERROR____(`KgUtil.evaluateVarConfigPossibilityLabel() | 获取列表数据文本失败, 表达式的格式错误: ${labelColumn}.`, { labelColumn: labelColumn, row: row });
-                    console.error(`KgUtil.evaluateVarConfigPossibilityLabel() | 获取列表数据文本失败, 表达式的格式错误: ${labelColumn}.`);
-                    return '`${null}`';
-                }
-                return labelColumn;
-            } else {
-                return '`${row.' + labelColumn + '}`';
-            }
-        })();
-
-        let valueExpression = (() => {
-            // 如果以 `${ 开头并且以 ` 结尾, 表示是一个 javascript 的模板字符串, 直接解析,
-            // 否则, 表示是一个简单的字段名, 需要先拼接成模板字符串, 再解析,
-
-            if (valueColumn.startsWith('`${') || valueColumn.endsWith('`')) {
-                if (!valueColumn.startsWith('`${') || !valueColumn.endsWith('`')) {
-                    // prettier-ignore
-                    ____ERROR____(`KgUtil.evaluateVarConfigPossibilityLabel() | 获取列表数据失败, 表达式的格式错误: ${valueColumn}.`, { valueColumn: valueColumn, row: row });
-                    console.error(`KgUtil.evaluateVarConfigPossibilityLabel() | 获取列表数据失败, 表达式的格式错误: ${valueColumn}.`);
-                    return '`${null}`';
-                }
-                return valueColumn;
-            } else {
-                return '`${row.' + valueColumn + '}`';
-            }
-        })();
-
-        // 如果描述列有值, 则返回描述列的值, 如果描述列没有值, 则返回数据列的值,
-        const expression = '`${' + `(${labelExpression.slice(3, -2)}) ?? (${valueExpression.slice(3, -2)}) ?? '' ` + '}`';
-        // prettier-ignore
-        ____DEBUG____('KgUtil.evaluateVarConfigPossibilityLabel() | 获取列表数据文本.', { expression: expression, labelColumn: labelColumn, labelExpression: labelExpression, row: row });
-
-        try {
-            return eval(expression);
-        } catch {
-            ____ERROR____('KgUtil.evaluateVarConfigPossibilityLabel() | 获取列表数据文本失败.', { expression: expression, labelColumn: labelColumn, row: row });
-        }
-
-        return '';
-    }
-
-    /**
-     * 根据控件类型, 将任意的高级查询操作符(可能非法)转换为合法的值.
-     *
-     * @param param.formID 界面标识.
-     * @param param.value 原始的高级查询操作符.
-     * @param param.varName 变量名称.
-     * @return {} 转换后的合法的值.
-     */
-    public static transformFormItemDynamicQueryOperator(param: { formID: string; value: string | null | undefined; varName: string }): string {
-        const { formID, value, varName } = param ?? {};
-
-        const kgVar = useKgVar(formID);
-
-        const varConfigControl = kgVar.getVarConfigControl({ buttonType: KG__VAR_BUTTON__TYPE.SEARCH, varName: varName });
-
-        /**
-         * 没有 VarConfigControl 数据时, 默认的控件类型为 {@link KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.INPUT}
-         */
-        const _ctrl_typ = varConfigControl?.ctrl_typ || KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.INPUT;
-
-        switch (_ctrl_typ) {
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.INPUT: {
-                switch (value) {
-                    case KG.DYNAMIC_QUERY_OPERATOR__EQ:
-                    case KG.DYNAMIC_QUERY_OPERATOR__NE:
-                    case KG.DYNAMIC_QUERY_OPERATOR__LT:
-                    case KG.DYNAMIC_QUERY_OPERATOR__LTE:
-                    case KG.DYNAMIC_QUERY_OPERATOR__GT:
-                    case KG.DYNAMIC_QUERY_OPERATOR__GTE:
-                    case KG.DYNAMIC_QUERY_OPERATOR__START_WITH:
-                    case KG.DYNAMIC_QUERY_OPERATOR__END_WITH:
-                    case KG.DYNAMIC_QUERY_OPERATOR__CONTAIN:
-                    case KG.DYNAMIC_QUERY_OPERATOR__EMPTY:
-                    case KG.DYNAMIC_QUERY_OPERATOR__NOT_EMPTY:
-                        return value;
-
-                    default:
-                        return KG.DYNAMIC_QUERY_OPERATOR__EQ;
-                }
-            }
-
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.INPUT_PASSWORD:
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.TEXT_AREA: {
-                switch (value) {
-                    case KG.DYNAMIC_QUERY_OPERATOR__EQ:
-                    case KG.DYNAMIC_QUERY_OPERATOR__NE:
-                    case KG.DYNAMIC_QUERY_OPERATOR__START_WITH:
-                    case KG.DYNAMIC_QUERY_OPERATOR__END_WITH:
-                    case KG.DYNAMIC_QUERY_OPERATOR__CONTAIN:
-                    case KG.DYNAMIC_QUERY_OPERATOR__EMPTY:
-                    case KG.DYNAMIC_QUERY_OPERATOR__NOT_EMPTY:
-                        return value;
-
-                    default:
-                        return KG.DYNAMIC_QUERY_OPERATOR__EQ;
-                }
-            }
-
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.INPUT_NUMBER:
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_DATE:
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_TIME:
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_DATETIME:
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_WEEK:
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_MONTH:
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_YEAR: {
-                switch (value) {
-                    case KG.DYNAMIC_QUERY_OPERATOR__EQ:
-                    case KG.DYNAMIC_QUERY_OPERATOR__NE:
-                    case KG.DYNAMIC_QUERY_OPERATOR__LT:
-                    case KG.DYNAMIC_QUERY_OPERATOR__LTE:
-                    case KG.DYNAMIC_QUERY_OPERATOR__GT:
-                    case KG.DYNAMIC_QUERY_OPERATOR__GTE:
-                    case KG.DYNAMIC_QUERY_OPERATOR__EMPTY:
-                    case KG.DYNAMIC_QUERY_OPERATOR__NOT_EMPTY:
-                        return value;
-
-                    default:
-                        return KG.DYNAMIC_QUERY_OPERATOR__EQ;
-                }
-            }
-
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.CHECKBOX:
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.SWITCH:
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.SELECT:
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.RADIO_GROUP: {
-                switch (value) {
-                    case KG.DYNAMIC_QUERY_OPERATOR__EQ:
-                    case KG.DYNAMIC_QUERY_OPERATOR__NE:
-                    case KG.DYNAMIC_QUERY_OPERATOR__EMPTY:
-                    case KG.DYNAMIC_QUERY_OPERATOR__NOT_EMPTY:
-                        return value;
-
-                    default:
-                        return KG.DYNAMIC_QUERY_OPERATOR__EQ;
-                }
-            }
-
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.CHECKBOX_GROUP:
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.SELECT_MULTIPLE: {
-                switch (value) {
-                    case KG.DYNAMIC_QUERY_OPERATOR__EMPTY:
-                    case KG.DYNAMIC_QUERY_OPERATOR__NOT_EMPTY:
-                        return value;
-
-                    default:
-                        return KG.DYNAMIC_QUERY_OPERATOR__IN;
-                }
-            }
-
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_DATE_RANGE:
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_TIME_RANGE:
-            case KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_DATETIME_RANGE: {
-                switch (value) {
-                    case KG.DYNAMIC_QUERY_OPERATOR__EMPTY:
-                    case KG.DYNAMIC_QUERY_OPERATOR__NOT_EMPTY:
-                        return value;
-
-                    default:
-                        return KG.DYNAMIC_QUERY_OPERATOR__BETWEEN;
-                }
-            }
-
-            default: {
-                return KG.DYNAMIC_QUERY_OPERATOR__EQ;
-            }
-        }
-    }
-
-    /**
-     * 根据控件类型获取高级查询操作符的下拉列表.
-     * @param controlType 控件类型.
-     */
-    public static getDynamicQueryOperatorSelectOptions(controlType: string | null | undefined): any {
-        const kg = useKg();
-
-        let _controlType = KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.INPUT;
-
-        if (!!controlType) {
-            _controlType = controlType;
-        }
-
-        return (
-            <>
-                {[
-                    KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.INPUT,
-                    KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.INPUT_PASSWORD,
-                    KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.INPUT_NUMBER,
-                    KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.TEXT_AREA,
-                    KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_DATE,
-                    KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_TIME,
-                    KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_DATETIME,
-                    KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_WEEK,
-                    KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_MONTH,
-                    KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_YEAR,
-                    KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.CHECKBOX,
-                    KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.SWITCH,
-                    KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.SELECT,
-                    KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.RADIO_GROUP,
-                ].includes(_controlType) && (
-                    <>
-                        <Select.Option value={KG.DYNAMIC_QUERY_OPERATOR__EQ}>
-                            <span
-                                class="code"
-                                title={kg.t('kg.KgSearchConfigModal.EQ-desc')}
-                            >
-                                {kg.t('kg.KgSearchConfigModal.EQ')}
-                            </span>
-                            <span class="desc">{kg.t('kg.KgSearchConfigModal.EQ-desc')}</span>
-                        </Select.Option>
-                        <Select.Option value={KG.DYNAMIC_QUERY_OPERATOR__NE}>
-                            <span
-                                class="code"
-                                title={kg.t('kg.KgSearchConfigModal.NE-desc')}
-                            >
-                                {kg.t('kg.KgSearchConfigModal.NE')}
-                            </span>
-                            <span class="desc">{kg.t('kg.KgSearchConfigModal.NE-desc')}</span>
-                        </Select.Option>
-                    </>
-                )}
-
-                {[
-                    KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.INPUT,
-                    KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.INPUT_NUMBER,
-                    KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_DATE,
-                    KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_TIME,
-                    KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_DATETIME,
-                    KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_WEEK,
-                    KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_MONTH,
-                    KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_YEAR,
-                ].includes(_controlType) && (
-                    <>
-                        <Select.Option value={KG.DYNAMIC_QUERY_OPERATOR__GT}>
-                            <span
-                                class="code"
-                                title={kg.t('kg.KgSearchConfigModal.GT-desc')}
-                            >
-                                {kg.t('kg.KgSearchConfigModal.GT')}
-                            </span>
-                            <span class="desc">{kg.t('kg.KgSearchConfigModal.GT-desc')}</span>
-                        </Select.Option>
-                        <Select.Option value={KG.DYNAMIC_QUERY_OPERATOR__GTE}>
-                            <span
-                                class="code"
-                                title={kg.t('kg.KgSearchConfigModal.GTE-desc')}
-                            >
-                                {kg.t('kg.KgSearchConfigModal.GTE')}
-                            </span>
-                            <span class="desc">{kg.t('kg.KgSearchConfigModal.GTE-desc')}</span>
-                        </Select.Option>
-                        <Select.Option value={KG.DYNAMIC_QUERY_OPERATOR__LT}>
-                            <span
-                                class="code"
-                                title={kg.t('kg.KgSearchConfigModal.LT-desc')}
-                            >
-                                {kg.t('kg.KgSearchConfigModal.LT')}
-                            </span>
-                            <span class="desc">{kg.t('kg.KgSearchConfigModal.LT-desc')}</span>
-                        </Select.Option>
-                        <Select.Option value={KG.DYNAMIC_QUERY_OPERATOR__LTE}>
-                            <span
-                                class="code"
-                                title={kg.t('kg.KgSearchConfigModal.LTE-desc')}
-                            >
-                                {kg.t('kg.KgSearchConfigModal.LTE')}
-                            </span>
-                            <span class="desc">{kg.t('kg.KgSearchConfigModal.LTE-desc')}</span>
-                        </Select.Option>
-                    </>
-                )}
-
-                {[KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.INPUT, KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.INPUT_PASSWORD, KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.TEXT_AREA].includes(_controlType) && (
-                    <>
-                        <Select.Option value={KG.DYNAMIC_QUERY_OPERATOR__START_WITH}>
-                            <span
-                                class="code"
-                                title={kg.t('kg.KgSearchConfigModal.START_WITH-desc')}
-                            >
-                                {kg.t('kg.KgSearchConfigModal.START_WITH')}
-                            </span>
-                            <span class="desc">{kg.t('kg.KgSearchConfigModal.START_WITH-desc')}</span>
-                        </Select.Option>
-                        <Select.Option value={KG.DYNAMIC_QUERY_OPERATOR__END_WITH}>
-                            <span
-                                class="code"
-                                title={kg.t('kg.KgSearchConfigModal.END_WITH-desc')}
-                            >
-                                {kg.t('kg.KgSearchConfigModal.END_WITH')}
-                            </span>
-                            <span class="desc">{kg.t('kg.KgSearchConfigModal.END_WITH-desc')}</span>
-                        </Select.Option>
-                        <Select.Option value={KG.DYNAMIC_QUERY_OPERATOR__CONTAIN}>
-                            <span
-                                class="code"
-                                title={kg.t('kg.KgSearchConfigModal.CONTAIN-desc')}
-                            >
-                                {kg.t('kg.KgSearchConfigModal.CONTAIN')}
-                            </span>
-                            <span class="desc">{kg.t('kg.KgSearchConfigModal.CONTAIN-desc')}</span>
-                        </Select.Option>
-                    </>
-                )}
-
-                {[KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.CHECKBOX_GROUP, KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.SELECT_MULTIPLE].includes(_controlType) && (
-                    <>
-                        <Select.Option value={KG.DYNAMIC_QUERY_OPERATOR__IN}>
-                            <span
-                                class="code"
-                                title={kg.t('kg.KgSearchConfigModal.IN-desc')}
-                            >
-                                {kg.t('kg.KgSearchConfigModal.IN')}
-                            </span>
-                            <span class="desc">{kg.t('kg.KgSearchConfigModal.IN-desc')}</span>
-                        </Select.Option>
-                    </>
-                )}
-
-                {[KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_DATE_RANGE, KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_TIME_RANGE, KG.VAR_CONFIG_CONTROL.CONTROL_TYPE.DATE_DATETIME_RANGE].includes(_controlType) && (
-                    <>
-                        <Select.Option value={KG.DYNAMIC_QUERY_OPERATOR__BETWEEN}>
-                            <span
-                                class="code"
-                                title={kg.t('kg.KgSearchConfigModal.BETWEEN-desc')}
-                            >
-                                {kg.t('kg.KgSearchConfigModal.BETWEEN')}
-                            </span>
-                            <span class="desc">{kg.t('kg.KgSearchConfigModal.BETWEEN-desc')}</span>
-                        </Select.Option>
-                    </>
-                )}
-
-                <Select.Option value={KG.DYNAMIC_QUERY_OPERATOR__EMPTY}>
-                    <span
-                        class="code"
-                        title={kg.t('kg.KgSearchConfigModal.EMPTY-desc')}
-                    >
-                        {kg.t('kg.KgSearchConfigModal.EMPTY')}
-                    </span>
-                    <span class="desc">{kg.t('kg.KgSearchConfigModal.EMPTY-desc')}</span>
-                </Select.Option>
-
-                <Select.Option value={KG.DYNAMIC_QUERY_OPERATOR__NOT_EMPTY}>
-                    <span
-                        class="code"
-                        title={kg.t('kg.KgSearchConfigModal.NOT_EMPTY-desc')}
-                    >
-                        {kg.t('kg.KgSearchConfigModal.NOT_EMPTY')}
-                    </span>
-                    <span class="desc">{kg.t('kg.KgSearchConfigModal.NOT_EMPTY-desc')}</span>
-                </Select.Option>
-            </>
-        );
-    }
-
-    /**
-     * 如果属性值是动态参数值 {@link KG__DYNAMIC_PARAM}, 则给属性值的花括号里面的前后加上特殊字符 #, 防止它被解析成实际的值.
-     *
-     * @param params
-     */
-    public static insertHashToDynamicQueryParams(params: any): void {
-        if (!params) {
-            return;
-        }
-
-        if (!isObjectLike(params)) {
-            return;
-        }
-
-        Object.keys(params).forEach((key) => {
-            const value = params[key];
-
-            if (value && typeof value === 'string') {
-                Object.keys(KG__DYNAMIC_PARAM).forEach((dynamicParamKey) => {
-                    const dynamicParamValue = KG__DYNAMIC_PARAM[dynamicParamKey as keyof typeof KG__DYNAMIC_PARAM];
-                    if (value.includes(dynamicParamValue)) {
-                        params[key] = params[key].replaceAll(dynamicParamValue, KG__DYNAMIC_PARAM_HASH[dynamicParamKey as keyof typeof KG__DYNAMIC_PARAM_HASH]);
-                    }
-                });
-            }
-        });
-    }
-
-    //region 组装查询语句
-    //----------------------------------------------------------------------------------------------------
-    /**
-     * <p>获取查询请求相关的请求头.</p>
-     * <p>根据查询条件拼接 SQL 语句片段.</p>
-     * <p>根据查询参数拼接 SQL, 格式如下: `WHERE ... ORDER BY ...`, 每一个片段会单独作为一个属性返回.</p>
-     * <ul>
-     *     <li>如果 dynamicQueryOperatorModel 传值, 表示直接使用传入的 dynamicQueryOperatorModel 作为高级查询操作符.</li>
-     *     <li>如果 dynamicQueryOperatorModel 没有传值, 但是 formID 传值, 表示通过变量配置获取高级查询操作符.</li>
-     * </ul>
-     *
-     * @param param.$dayjs dayjs.
-     * @param param.dynamicQueryOperatorModel 各个字段的高级查询操作符.
-     * @param param.formID 界面标识.
-     * @param param.kgSearchFormID 查询条件的界面标识.
-     * @param param.params 请求参数.
-     */
-    public static getQueryHeaders(param: {
-        $dayjs: typeof dayjs;
-        dynamicQueryOperatorModel: Record<string, any> | null | undefined;
-        formID: string | null | undefined;
-        kgSearchFormID: string | null | undefined;
-        params: Record<string, any> | null | undefined;
-    }) {
-        const { kgSearchFormID, formID, dynamicQueryOperatorModel, $dayjs } = param ?? {};
-
-        if (!kgSearchFormID && !dynamicQueryOperatorModel) {
-            throw new Error('参数 kgSearchFormID 和 dynamicQueryOperatorModel 不能同时为空, 至少有一个必须传值.');
-        }
-
-        let paramRecord = cloneDeep(toRaw(unref(param.params ?? {})));
-
-        // 参数不是一个对象,
-        if (!paramRecord || !isObjectLike(paramRecord)) {
-            return { operatorObjectJSON: '', orderBySql: '', sql: '', whereObjectJSON: '', whereSql: '', whereSql01: '', whereSql02: '', whereSql03: '', whereSql04: '', whereSql05: '' };
-        }
-
-        // 特殊字段, 这些特殊字段的值不做处理, 保持原样
-        const SPECIAL_KEY_LIST = ['pageNo', 'pageSize', 'column', 'order'];
-
-        const kg = useKg();
-        const kgVar = formID ? useKgVar(formID) : null;
-        const kgSearchKgVar = kgSearchFormID ? useKgVar(kgSearchFormID) : null;
-
-        const _dynamicQueryOperatorModel = dynamicQueryOperatorModel ?? kgSearchKgVar?.kgSearch?.dynamicQueryOperatorModel?.value;
-
-        // 该对象中, 每一个 key 表示字段名, 每一个 value 表示该字段对应的 SQL 片段,
-        const paramRecord$QueryWhereSql: Record<string, any> = {};
-        // 该对象中, 每一个 key 表示字段名, 每一个 value 表示该字段对应的解析后的值,
-        const paramRecord$QueryObject: Record<string, any> = {};
-
-        for (const key of Object.keys(paramRecord).sort()) {
-            // 特殊属性, 不放进 WHERE SQL 中
-            if (SPECIAL_KEY_LIST.includes(key)) {
-                continue;
-            }
-
-            // 辅助属性, 用于业务逻辑, 不放进 WHERE SQL 中,
-            if (key.endsWith('_obj')) {
-                continue;
-            }
-
-            const varProfileDetail = kgSearchFormID ? kgSearchKgVar?.store?.getVarProfileDetail(kgSearchFormID, key) : null;
-
-            const key01 = (() => {
-                // 字段名称转换为下划线命名方式(snake_case)
-                if (kgSearchFormID && varProfileDetail?.use_underscore_when_dynamic_query_flag !== 0) {
-                    return key
-                        .split('.')
-                        .map((i: string) => KgUtil.snakeCase(i))
-                        .join('.');
-                }
-
-                return key;
-            })();
-            const value = paramRecord[key];
-            const operator: string = (() => {
-                // 未启用高级查询时, 操作符始终是「等于」,
-                if (kg.option.KgSearch?.dynamicQuery?.on !== true || (kgSearchFormID && kgSearchKgVar?.kgSearch?.currentVarProfileMaster?.value?.dyn_flg !== 1)) {
-                    return KG.DYNAMIC_QUERY_OPERATOR__EQ;
-                }
-
-                return _dynamicQueryOperatorModel?.[key] ?? KG.DYNAMIC_QUERY_OPERATOR__EQ;
-            })();
-
-            switch01: switch (true) {
-                //region 日期
-                //----------------------------------------------------------------------------------------------------
-                case !!$dayjs && $dayjs.isDayjs(value): {
-                    let _stringValue = '';
-
-                    const _value = value as Dayjs;
-                    _stringValue = kgSearchFormID
-                        ? KgUtil.parseParamsFromDayjs({
-                              formID: kgSearchFormID,
-                              key: key,
-                              value: _value,
-                          })
-                        : _value.format('YYYY-MM-DD HH:mm:ss');
-
-                    switch (operator) {
-                        case KG.DYNAMIC_QUERY_OPERATOR__NE: {
-                            let _leftStringValue = _stringValue;
-                            let _rightStringValue = '';
-
-                            switch (true) {
-                                // YYYY-MM-DD HH:mm:ss
-                                case /\d\d-\d\d-\d\d \d\d:\d\d:\d\d/.test(_leftStringValue): {
-                                    _rightStringValue = _value.add(1, 'second').format('YYYY-MM-DD HH:mm:ss');
-                                    break;
-                                }
-
-                                // YYYY-MM-DD
-                                case /\d\d-\d\d-\d\d/.test(_leftStringValue): {
-                                    _leftStringValue = `${_leftStringValue} 00:00:00`;
-                                    _rightStringValue = _value.add(1, 'day').format('YYYY-MM-DD 00:00:00');
-                                    break;
-                                }
-
-                                // HH:mm:ss
-                                case /\d\d:\d\d:\d\d/.test(_leftStringValue): {
-                                    _leftStringValue = _value.format('1900-01-01 HH:mm:ss');
-                                    _rightStringValue = _value.add(1, 'second').format('1900-01-01 HH:mm:ss');
-                                    break;
-                                }
-
-                                default: {
-                                    throw new Error('KgUtil.parseParamsForDynamicQuery() | 日期格式有误.');
-                                }
-                            }
-
-                            _stringValue = `(("${key01}" < '${_leftStringValue}') OR ("${key01}" >= '${_rightStringValue}'))`;
-
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__LT: {
-                            let _leftStringValue = _stringValue;
-
-                            switch (true) {
-                                // YYYY-MM-DD HH:mm:ss
-                                case /\d\d-\d\d-\d\d \d\d:\d\d:\d\d/.test(_leftStringValue): {
-                                    break;
-                                }
-
-                                // YYYY-MM-DD
-                                case /\d\d-\d\d-\d\d/.test(_leftStringValue): {
-                                    _leftStringValue = `${_leftStringValue} 00:00:00`;
-                                    break;
-                                }
-
-                                // HH:mm:ss
-                                case /\d\d:\d\d:\d\d/.test(_leftStringValue): {
-                                    _leftStringValue = `1900-01-01 ${_leftStringValue}`;
-                                    break;
-                                }
-
-                                default: {
-                                    throw new Error('KgUtil.parseParamsForDynamicQuery() | 日期格式有误.');
-                                }
-                            }
-
-                            _stringValue = `("${key01}" < '${_leftStringValue}')`;
-
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__LTE: {
-                            let _leftStringValue = _stringValue;
-                            let _rightStringValue = '';
-
-                            switch (true) {
-                                // YYYY-MM-DD HH:mm:ss
-                                case /\d\d-\d\d-\d\d \d\d:\d\d:\d\d/.test(_leftStringValue): {
-                                    _rightStringValue = _value.add(1, 'second').format('YYYY-MM-DD HH:mm:ss');
-                                    break;
-                                }
-
-                                // YYYY-MM-DD
-                                case /\d\d-\d\d-\d\d/.test(_leftStringValue): {
-                                    _rightStringValue = _value.add(1, 'day').format('YYYY-MM-DD 00:00:00');
-                                    break;
-                                }
-
-                                // HH:mm:ss
-                                case /\d\d:\d\d:\d\d/.test(_leftStringValue): {
-                                    _rightStringValue = _value.add(1, 'second').format('1900-01-01 HH:mm:ss');
-                                    break;
-                                }
-
-                                default: {
-                                    throw new Error('KgUtil.parseParamsForDynamicQuery() | 日期格式有误.');
-                                }
-                            }
-
-                            _stringValue = `("${key01}" < '${_rightStringValue}')`;
-
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__GT: {
-                            let _leftStringValue = _stringValue;
-                            let _rightStringValue = '';
-
-                            switch (true) {
-                                // YYYY-MM-DD HH:mm:ss
-                                case /\d\d-\d\d-\d\d \d\d:\d\d:\d\d/.test(_leftStringValue): {
-                                    _rightStringValue = _value.add(1, 'second').format('YYYY-MM-DD HH:mm:ss');
-                                    break;
-                                }
-
-                                // YYYY-MM-DD
-                                case /\d\d-\d\d-\d\d/.test(_leftStringValue): {
-                                    _rightStringValue = _value.add(1, 'day').format('YYYY-MM-DD 00:00:00');
-                                    break;
-                                }
-
-                                // HH:mm:ss
-                                case /\d\d:\d\d:\d\d/.test(_leftStringValue): {
-                                    _rightStringValue = _value.add(1, 'second').format('1900-01-01 HH:mm:ss');
-                                    break;
-                                }
-
-                                default: {
-                                    throw new Error('KgUtil.parseParamsForDynamicQuery() | 日期格式有误.');
-                                }
-                            }
-
-                            _stringValue = `("${key01}" >= '${_rightStringValue}')`;
-
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__GTE: {
-                            let _leftStringValue = _stringValue;
-
-                            switch (true) {
-                                // YYYY-MM-DD HH:mm:ss
-                                case /\d\d-\d\d-\d\d \d\d:\d\d:\d\d/.test(_leftStringValue): {
-                                    break;
-                                }
-
-                                // YYYY-MM-DD
-                                case /\d\d-\d\d-\d\d/.test(_leftStringValue): {
-                                    _leftStringValue = `${_leftStringValue} 00:00:00`;
-                                    break;
-                                }
-
-                                // HH:mm:ss
-                                case /\d\d:\d\d:\d\d/.test(_leftStringValue): {
-                                    _leftStringValue = `1900-01-01 ${_leftStringValue}`;
-                                    break;
-                                }
-
-                                default: {
-                                    throw new Error('KgUtil.parseParamsForDynamicQuery() | 日期格式有误.');
-                                }
-                            }
-
-                            _stringValue = `("${key01}" >= '${_leftStringValue}')`;
-
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__EMPTY: {
-                            _stringValue = `("${key01}" IS NULL OR (TRIM(CONVERT(VARCHAR(MAX), "${key01}")) = ''))`;
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__NOT_EMPTY: {
-                            _stringValue = `(NOT ("${key01}" IS NULL OR (TRIM(CONVERT(VARCHAR(MAX), "${key01}")) = '')))`;
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__EQ:
-                        default: {
-                            let _leftStringValue = _stringValue;
-                            let _rightStringValue = '';
-
-                            switch (true) {
-                                // YYYY-MM-DD HH:mm:ss
-                                case /\d\d-\d\d-\d\d \d\d:\d\d:\d\d/.test(_leftStringValue): {
-                                    _rightStringValue = _value.add(1, 'second').format('YYYY-MM-DD HH:mm:ss');
-                                    break;
-                                }
-
-                                // YYYY-MM-DD
-                                case /\d\d-\d\d-\d\d/.test(_leftStringValue): {
-                                    _leftStringValue = `${_leftStringValue} 00:00:00`;
-                                    _rightStringValue = _value.add(1, 'day').format('YYYY-MM-DD 00:00:00');
-                                    break;
-                                }
-
-                                // HH:mm:ss
-                                case /\d\d:\d\d:\d\d/.test(_leftStringValue): {
-                                    _leftStringValue = `1900-01-01 ${_leftStringValue}`;
-                                    _rightStringValue = _value.add(1, 'second').format('1900-01-01 HH:mm:ss');
-                                    break;
-                                }
-
-                                default: {
-                                    throw new Error('KgUtil.parseParamsForDynamicQuery() | 日期格式有误.');
-                                }
-                            }
-
-                            _stringValue = `(("${key01}" >= '${_leftStringValue}') AND ("${key01}" < '${_rightStringValue}'))`;
-
-                            break;
-                        }
-                    }
-
-                    paramRecord$QueryWhereSql[key] = _stringValue;
-
-                    break;
-                }
-                //endregion
-
-                //region 日期范围
-                //----------------------------------------------------------------------------------------------------
-                case !!$dayjs && isArray(value) && value.length === 2 && $dayjs.isDayjs(value[0]) && $dayjs.isDayjs(value[1]): {
-                    let _stringValue = '';
-
-                    switch (operator) {
-                        case KG.DYNAMIC_QUERY_OPERATOR__EMPTY: {
-                            _stringValue = `("${key01}" IS NULL OR (TRIM(CONVERT(VARCHAR(MAX), "${key01}")) = ''))`;
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__NOT_EMPTY: {
-                            _stringValue = `(NOT ("${key01}" IS NULL OR (TRIM(CONVERT(VARCHAR(MAX), "${key01}")) = '')))`;
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__BETWEEN:
-                        default: {
-                            const _leftValue = value[0] as Dayjs;
-                            const _rightValue = value[1] as Dayjs;
-
-                            // 左侧日期的字符串
-                            let _leftStringValue = KgUtil.parseParamsFromDayjs({ formID: kgSearchFormID, key: key, value: _leftValue });
-                            // 右侧日期的字符串
-                            let _rightStringValue = '';
-
-                            switch (true) {
-                                // 左侧日期为空
-                                case !_leftStringValue: {
-                                    _rightStringValue = KgUtil.parseParamsFromDayjs({ formID: kgSearchFormID, isPad: true, key: key, value: _rightValue });
-                                    break;
-                                }
-
-                                // 日期格式为 YYYY-MM-DD HH:mm:ss
-                                case /\d\d-\d\d-\d\d \d\d:\d\d:\d\d/.test(_leftStringValue): {
-                                    if (_rightValue.isValid()) {
-                                        _rightStringValue = _rightValue.add(1, 'second').format('YYYY-MM-DD HH:mm:ss');
-                                    }
-                                    break;
-                                }
-
-                                // 日期格式为 YYYY-MM-DD
-                                case /\d\d-\d\d-\d\d/.test(_leftStringValue): {
-                                    _leftStringValue = `${_leftStringValue} 00:00:00`;
-                                    if (_rightValue.isValid()) {
-                                        _rightStringValue = _rightValue.add(1, 'day').format('YYYY-MM-DD 00:00:00');
-                                    }
-                                    break;
-                                }
-
-                                // 日期格式为 HH:mm:ss
-                                case /\d\d:\d\d:\d\d/.test(_leftStringValue): {
-                                    _leftStringValue = `1900-01-01 ${_leftStringValue}`;
-                                    if (_rightValue.isValid()) {
-                                        _rightStringValue = _rightValue.add(1, 'second').format('1900-01-01 HH:mm:ss');
-                                    }
-                                    break;
-                                }
-                            }
-
-                            if (_leftStringValue) {
-                                _stringValue += (() => {
-                                    switch (kg.option.dbType!) {
-                                        case KG.DB_TYPE.DM:
-                                        case KG.DB_TYPE.MYSQL:
-                                        case KG.DB_TYPE.ORACLE:
-                                        case KG.DB_TYPE.POSTGRESQL:
-                                        case KG.DB_TYPE.SQLITE:
-                                            return `("${key01}" >= '${_leftStringValue}')`;
-
-                                        case KG.DB_TYPE.SQLSERVER:
-                                        default:
-                                            return `("${key01}" >= N'${_leftStringValue}')`;
-                                    }
-                                })();
-                            }
-
-                            if (_rightStringValue) {
-                                if (_stringValue) {
-                                    _stringValue += ' AND ';
-                                }
-
-                                _stringValue += (() => {
-                                    switch (kg.option.dbType!) {
-                                        case KG.DB_TYPE.DM:
-                                        case KG.DB_TYPE.MYSQL:
-                                        case KG.DB_TYPE.ORACLE:
-                                        case KG.DB_TYPE.POSTGRESQL:
-                                        case KG.DB_TYPE.SQLITE:
-                                            return `("${key01}" < '${_rightStringValue}')`;
-
-                                        case KG.DB_TYPE.SQLSERVER:
-                                        default:
-                                            return `("${key01}" < N'${_rightStringValue}')`;
-                                    }
-                                })();
-                            }
-                            break;
-                        }
-                    }
-
-                    paramRecord$QueryWhereSql[key] = _stringValue;
-
-                    break;
-                }
-                //endregion
-
-                //region array
-                //----------------------------------------------------------------------------------------------------
-                case Array.isArray(value): {
-                    let _stringValue = '';
-
-                    switch (operator) {
-                        case KG.DYNAMIC_QUERY_OPERATOR__EMPTY: {
-                            _stringValue = `("${key01}" IS NULL OR (TRIM(CONVERT(VARCHAR(MAX), "${key01}")) = ''))`;
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__NOT_EMPTY: {
-                            _stringValue = `(NOT ("${key01}" IS NULL OR (TRIM(CONVERT(VARCHAR(MAX), "${key01}")) = '')))`;
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__IN:
-                        default: {
-                            if (value.length === 0) {
-                                paramRecord$QueryWhereSql[key] = undefined;
-                                break switch01;
-                            }
-
-                            const _value = value
-                                .map((i: any) =>
-                                    (() => {
-                                        switch (kg.option.dbType!) {
-                                            case KG.DB_TYPE.DM:
-                                            case KG.DB_TYPE.MYSQL:
-                                            case KG.DB_TYPE.ORACLE:
-                                            case KG.DB_TYPE.POSTGRESQL:
-                                            case KG.DB_TYPE.SQLITE:
-                                                return `'${String(i)}'`;
-
-                                            case KG.DB_TYPE.SQLSERVER:
-                                            default:
-                                                return `N'${String(i)}'`;
-                                        }
-                                    })(),
-                                )
-                                .join(', ');
-
-                            _stringValue = `("${key01}" IN (${_value}))`;
-                            break;
-                        }
-                    }
-
-                    paramRecord$QueryWhereSql[key] = _stringValue;
-                    break;
-                }
-                //----------------------------------------------------------------------------------------------------
-                //endregion
-
-                //region object
-                //----------------------------------------------------------------------------------------------------
-                case isObjectLike(value): {
-                    ____ERROR____('不支持的参数类型.', { value });
-                    throw new Error('不支持的参数类型.');
-                }
-                //----------------------------------------------------------------------------------------------------
-                //endregion
-
-                //region string
-                //----------------------------------------------------------------------------------------------------
-                case typeof value === 'string': {
-                    let _stringValue = '';
-
-                    _stringValue = KgUtil.parseParamsFromString({ $dayjs: $dayjs, formID: formID, value: value, varName: key });
-
-                    switch (operator) {
-                        case KG.DYNAMIC_QUERY_OPERATOR__NE: {
-                            // 空白字符
-                            if (value.trim() === '') {
-                                paramRecord$QueryWhereSql[key] = undefined;
-                                break switch01;
-                            }
-
-                            _stringValue = (() => {
-                                switch (kg.option.dbType!) {
-                                    case KG.DB_TYPE.DM:
-                                    case KG.DB_TYPE.MYSQL:
-                                    case KG.DB_TYPE.ORACLE:
-                                    case KG.DB_TYPE.POSTGRESQL:
-                                    case KG.DB_TYPE.SQLITE:
-                                        return `("${key01}" <> '${_stringValue}')`;
-
-                                    case KG.DB_TYPE.SQLSERVER:
-                                    default:
-                                        return `("${key01}" <> N'${_stringValue}')`;
-                                }
-                            })();
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__LT: {
-                            // 空白字符
-                            if (value.trim() === '') {
-                                paramRecord$QueryWhereSql[key] = undefined;
-                                break switch01;
-                            }
-
-                            _stringValue = (() => {
-                                switch (kg.option.dbType!) {
-                                    case KG.DB_TYPE.DM:
-                                    case KG.DB_TYPE.MYSQL:
-                                    case KG.DB_TYPE.ORACLE:
-                                    case KG.DB_TYPE.POSTGRESQL:
-                                    case KG.DB_TYPE.SQLITE:
-                                        return `("${key01}" < '${_stringValue}')`;
-
-                                    case KG.DB_TYPE.SQLSERVER:
-                                    default:
-                                        return `("${key01}" < N'${_stringValue}')`;
-                                }
-                            })();
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__LTE: {
-                            // 空白字符
-                            if (value.trim() === '') {
-                                paramRecord$QueryWhereSql[key] = undefined;
-                                break switch01;
-                            }
-
-                            _stringValue = (() => {
-                                switch (kg.option.dbType!) {
-                                    case KG.DB_TYPE.DM:
-                                    case KG.DB_TYPE.MYSQL:
-                                    case KG.DB_TYPE.ORACLE:
-                                    case KG.DB_TYPE.POSTGRESQL:
-                                    case KG.DB_TYPE.SQLITE:
-                                        return `("${key01}" <= '${_stringValue}')`;
-
-                                    case KG.DB_TYPE.SQLSERVER:
-                                    default:
-                                        return `("${key01}" <= N'${_stringValue}')`;
-                                }
-                            })();
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__GT: {
-                            // 空白字符
-                            if (value.trim() === '') {
-                                paramRecord$QueryWhereSql[key] = undefined;
-                                break switch01;
-                            }
-
-                            _stringValue = (() => {
-                                switch (kg.option.dbType!) {
-                                    case KG.DB_TYPE.DM:
-                                    case KG.DB_TYPE.MYSQL:
-                                    case KG.DB_TYPE.ORACLE:
-                                    case KG.DB_TYPE.POSTGRESQL:
-                                    case KG.DB_TYPE.SQLITE:
-                                        return `("${key01}" > '${_stringValue}')`;
-
-                                    case KG.DB_TYPE.SQLSERVER:
-                                    default:
-                                        return `("${key01}" > N'${_stringValue}')`;
-                                }
-                            })();
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__GTE: {
-                            // 空白字符
-                            if (value.trim() === '') {
-                                paramRecord$QueryWhereSql[key] = undefined;
-                                break switch01;
-                            }
-
-                            _stringValue = (() => {
-                                switch (kg.option.dbType!) {
-                                    case KG.DB_TYPE.DM:
-                                    case KG.DB_TYPE.MYSQL:
-                                    case KG.DB_TYPE.ORACLE:
-                                    case KG.DB_TYPE.POSTGRESQL:
-                                    case KG.DB_TYPE.SQLITE:
-                                        return `("${key01}" >= '${_stringValue}')`;
-
-                                    case KG.DB_TYPE.SQLSERVER:
-                                    default:
-                                        return `("${key01}" >= N'${_stringValue}')`;
-                                }
-                            })();
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__START_WITH: {
-                            // 空白字符
-                            if (value.trim() === '') {
-                                paramRecord$QueryWhereSql[key] = undefined;
-                                break switch01;
-                            }
-
-                            _stringValue = (() => {
-                                switch (kg.option.dbType!) {
-                                    case KG.DB_TYPE.DM:
-                                    case KG.DB_TYPE.MYSQL:
-                                    case KG.DB_TYPE.ORACLE:
-                                    case KG.DB_TYPE.POSTGRESQL:
-                                    case KG.DB_TYPE.SQLITE:
-                                        return `("${key01}" LIKE '${_stringValue}%')`;
-
-                                    case KG.DB_TYPE.SQLSERVER:
-                                    default:
-                                        return `("${key01}" LIKE N'${_stringValue}%')`;
-                                }
-                            })();
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__END_WITH: {
-                            // 空白字符
-                            if (value.trim() === '') {
-                                paramRecord$QueryWhereSql[key] = undefined;
-                                break switch01;
-                            }
-
-                            _stringValue = (() => {
-                                switch (kg.option.dbType!) {
-                                    case KG.DB_TYPE.DM:
-                                    case KG.DB_TYPE.MYSQL:
-                                    case KG.DB_TYPE.ORACLE:
-                                    case KG.DB_TYPE.POSTGRESQL:
-                                    case KG.DB_TYPE.SQLITE:
-                                        return `("${key01}" LIKE '%${_stringValue}')`;
-
-                                    case KG.DB_TYPE.SQLSERVER:
-                                    default:
-                                        return `("${key01}" LIKE N'%${_stringValue}')`;
-                                }
-                            })();
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__CONTAIN: {
-                            // 空白字符
-                            if (value.trim() === '') {
-                                paramRecord$QueryWhereSql[key] = undefined;
-                                break switch01;
-                            }
-
-                            _stringValue = (() => {
-                                switch (kg.option.dbType!) {
-                                    case KG.DB_TYPE.DM:
-                                    case KG.DB_TYPE.MYSQL:
-                                    case KG.DB_TYPE.ORACLE:
-                                    case KG.DB_TYPE.POSTGRESQL:
-                                    case KG.DB_TYPE.SQLITE:
-                                        return `("${key01}" LIKE '%${_stringValue}%')`;
-
-                                    case KG.DB_TYPE.SQLSERVER:
-                                    default:
-                                        return `("${key01}" LIKE N'%${_stringValue}%')`;
-                                }
-                            })();
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__EMPTY: {
-                            _stringValue = `("${key01}" IS NULL OR (TRIM(CONVERT(VARCHAR(MAX), "${key01}")) = ''))`;
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__NOT_EMPTY: {
-                            _stringValue = `(NOT ("${key01}" IS NULL OR (TRIM(CONVERT(VARCHAR(MAX), "${key01}")) = '')))`;
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__EQ:
-                        default: {
-                            // 空白字符
-                            if (value.trim() === '') {
-                                paramRecord$QueryWhereSql[key] = undefined;
-                                break switch01;
-                            }
-
-                            _stringValue = (() => {
-                                switch (kg.option.dbType!) {
-                                    case KG.DB_TYPE.DM:
-                                    case KG.DB_TYPE.MYSQL:
-                                    case KG.DB_TYPE.ORACLE:
-                                    case KG.DB_TYPE.POSTGRESQL:
-                                    case KG.DB_TYPE.SQLITE:
-                                        return `("${key01}" = '${_stringValue}')`;
-
-                                    case KG.DB_TYPE.SQLSERVER:
-                                    default:
-                                        return `("${key01}" = N'${_stringValue}')`;
-                                }
-                            })();
-                            break;
-                        }
-                    }
-
-                    paramRecord$QueryWhereSql[key] = _stringValue;
-
-                    break;
-                }
-                //----------------------------------------------------------------------------------------------------
-                //endregion
-
-                //region number
-                //----------------------------------------------------------------------------------------------------
-                case typeof value === 'number': {
-                    let _stringValue = '';
-
-                    switch (operator) {
-                        case KG.DYNAMIC_QUERY_OPERATOR__NE: {
-                            _stringValue = `("${key01}" <> ${value})`;
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__LT: {
-                            _stringValue = `("${key01}" < ${value})`;
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__LTE: {
-                            _stringValue = `("${key01}" <= ${value})`;
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__GT: {
-                            _stringValue = `("${key01}" > ${value})`;
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__GTE: {
-                            _stringValue = `("${key01}" >= ${value})`;
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__EMPTY: {
-                            _stringValue = `("${key01}" IS NULL OR (TRIM(CONVERT(VARCHAR(MAX), "${key01}")) = ''))`;
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__NOT_EMPTY: {
-                            _stringValue = `(NOT ("${key01}" IS NULL OR (TRIM(CONVERT(VARCHAR(MAX), "${key01}")) = '')))`;
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__EQ:
-                        default: {
-                            _stringValue = `("${key01}" = ${value})`;
-                            break;
-                        }
-                    }
-
-                    paramRecord$QueryWhereSql[key] = _stringValue;
-
-                    break;
-                }
-                //----------------------------------------------------------------------------------------------------
-                //endregion
-
-                //region boolean
-                //----------------------------------------------------------------------------------------------------
-                case typeof value === 'boolean': {
-                    let _stringValue = '';
-
-                    switch (operator) {
-                        case KG.DYNAMIC_QUERY_OPERATOR__NE: {
-                            _stringValue = (() => {
-                                switch (kg.option.dbType!) {
-                                    case KG.DB_TYPE.DM:
-                                    case KG.DB_TYPE.MYSQL:
-                                    case KG.DB_TYPE.ORACLE:
-                                    case KG.DB_TYPE.POSTGRESQL:
-                                    case KG.DB_TYPE.SQLITE:
-                                        return `("${key01}" <> ${value ? 'TRUE' : 'FALSE'})`;
-
-                                    case KG.DB_TYPE.SQLSERVER:
-                                    default:
-                                        return `("${key01}" <> ${value ? 1 : 0})`;
-                                }
-                            })();
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__EMPTY: {
-                            _stringValue = `("${key01}" IS NULL OR (TRIM(CONVERT(VARCHAR(MAX), "${key01}")) = ''))`;
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__NOT_EMPTY: {
-                            _stringValue = `(NOT ("${key01}" IS NULL OR (TRIM(CONVERT(VARCHAR(MAX), "${key01}")) = '')))`;
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__EQ:
-                        default: {
-                            _stringValue = (() => {
-                                switch (kg.option.dbType!) {
-                                    case KG.DB_TYPE.DM:
-                                    case KG.DB_TYPE.MYSQL:
-                                    case KG.DB_TYPE.ORACLE:
-                                    case KG.DB_TYPE.POSTGRESQL:
-                                    case KG.DB_TYPE.SQLITE:
-                                        return `("${key01}" = ${value ? 'TRUE' : 'FALSE'})`;
-
-                                    case KG.DB_TYPE.SQLSERVER:
-                                    default:
-                                        return `("${key01}" = ${value ? 1 : 0})`;
-                                }
-                            })();
-                            break;
-                        }
-                    }
-
-                    paramRecord$QueryWhereSql[key] = _stringValue;
-
-                    break;
-                }
-                //----------------------------------------------------------------------------------------------------
-                //endregion
-
-                //region null, undefined
-                //----------------------------------------------------------------------------------------------------
-                default: {
-                    let _stringValue = '';
-
-                    switch (operator) {
-                        case KG.DYNAMIC_QUERY_OPERATOR__EMPTY: {
-                            _stringValue = `("${key01}" IS NULL OR (TRIM(CONVERT(VARCHAR(MAX), "${key01}")) = ''))`;
-                            break;
-                        }
-
-                        case KG.DYNAMIC_QUERY_OPERATOR__NOT_EMPTY: {
-                            _stringValue = `(NOT ("${key01}" IS NULL OR (TRIM(CONVERT(VARCHAR(MAX), "${key01}")) = '')))`;
-                            break;
-                        }
-
-                        default: {
-                            _stringValue = value;
-                            break;
-                        }
-                    }
-
-                    paramRecord$QueryWhereSql[key] = _stringValue;
-
-                    break;
-                }
-                //----------------------------------------------------------------------------------------------------
-                //endregion
-            }
-        }
-
-        const whereSqlSegment: string = reduce(
-            paramRecord$QueryWhereSql,
-            (sql, value, key) => {
-                const varProfileDetail = kgSearchFormID ? kgSearchKgVar?.store?.getVarProfileDetail(kgSearchFormID, key) : null;
-                const varProfileDetail$Props = KgCoreUtil.tryParseJSON<IKgVarProfileDetailProperties>(varProfileDetail?.props);
-
-                // 要排除的属性, 不放进到 WHERE SQL 中
-                if (varProfileDetail?.exclude_from_where_sql_flag === 1) {
-                    return sql;
-                }
-
-                // 不属于当前 WHERE 查询语句,
-                if (varProfileDetail$Props.whereSqlName && varProfileDetail$Props.whereSqlName !== 'WHERE') {
-                    return sql;
-                }
-
-                // 如果一个属性, 不在查询字段中, 但是在表格配置的查询参数中, 则该属性不放进到 WHERE SQL 中,
-                // 这种属性通常是直接传给后端接口用作逻辑处理, 不是简单的查询条件,
-                if (!varProfileDetail && Object.keys(KgUtil.parseRequestParamsToJSON(kgVar?.varGridConfig?.value?.cmd_prm ?? '')).includes(key)) {
-                    return sql;
-                }
-
-                if (!value) {
-                    return sql;
-                }
-
-                return `${sql} AND ${value}`;
-            },
-            '',
-        );
-
-        const whereSqlSegment01: string = reduce(
-            paramRecord$QueryWhereSql,
-            (sql, value, key) => {
-                const varProfileDetail = kgSearchFormID ? kgSearchKgVar?.store?.getVarProfileDetail(kgSearchFormID, key) : null;
-                const varProfileDetail$Props = KgCoreUtil.tryParseJSON<IKgVarProfileDetailProperties>(varProfileDetail?.props);
-
-                // 要排除的属性, 不放进到 WHERE SQL 中
-                if (varProfileDetail?.exclude_from_where_sql_flag === 1) {
-                    return sql;
-                }
-
-                // 不属于当前 WHERE 查询语句,
-                if (varProfileDetail$Props.whereSqlName !== 'WHERE01') {
-                    return sql;
-                }
-
-                // 如果一个属性, 不在查询字段中, 但是在表格配置的查询参数中, 则该属性不放进到 WHERE SQL 中,
-                // 这种属性通常是直接传给后端接口用作逻辑处理, 不是简单的查询条件,
-                if (!varProfileDetail && Object.keys(KgUtil.parseRequestParamsToJSON(kgVar?.varGridConfig?.value?.cmd_prm ?? '')).includes(key)) {
-                    return sql;
-                }
-
-                if (!value) {
-                    return sql;
-                }
-
-                return `${sql} AND ${value}`;
-            },
-            '',
-        );
-
-        const whereSqlSegment02: string = reduce(
-            paramRecord$QueryWhereSql,
-            (sql, value, key) => {
-                const varProfileDetail = kgSearchFormID ? kgSearchKgVar?.store?.getVarProfileDetail(kgSearchFormID, key) : null;
-                const varProfileDetail$Props = KgCoreUtil.tryParseJSON<IKgVarProfileDetailProperties>(varProfileDetail?.props);
-
-                // 要排除的属性, 不放进到 WHERE SQL 中
-                if (varProfileDetail?.exclude_from_where_sql_flag === 1) {
-                    return sql;
-                }
-
-                // 不属于当前 WHERE 查询语句,
-                if (varProfileDetail$Props.whereSqlName !== 'WHERE02') {
-                    return sql;
-                }
-
-                // 如果一个属性, 不在查询字段中, 但是在表格配置的查询参数中, 则该属性不放进到 WHERE SQL 中,
-                // 这种属性通常是直接传给后端接口用作逻辑处理, 不是简单的查询条件,
-                if (!varProfileDetail && Object.keys(KgUtil.parseRequestParamsToJSON(kgVar?.varGridConfig?.value?.cmd_prm ?? '')).includes(key)) {
-                    return sql;
-                }
-
-                if (!value) {
-                    return sql;
-                }
-
-                return `${sql} AND ${value}`;
-            },
-            '',
-        );
-
-        const whereSqlSegment03: string = reduce(
-            paramRecord$QueryWhereSql,
-            (sql, value, key) => {
-                const varProfileDetail = kgSearchFormID ? kgSearchKgVar?.store?.getVarProfileDetail(kgSearchFormID, key) : null;
-                const varProfileDetail$Props = KgCoreUtil.tryParseJSON<IKgVarProfileDetailProperties>(varProfileDetail?.props);
-
-                // 要排除的属性, 不放进到 WHERE SQL 中
-                if (varProfileDetail?.exclude_from_where_sql_flag === 1) {
-                    return sql;
-                }
-
-                // 不属于当前 WHERE 查询语句,
-                if (varProfileDetail$Props.whereSqlName !== 'WHERE03') {
-                    return sql;
-                }
-
-                // 如果一个属性, 不在查询字段中, 但是在表格配置的查询参数中, 则该属性不放进到 WHERE SQL 中,
-                // 这种属性通常是直接传给后端接口用作逻辑处理, 不是简单的查询条件,
-                if (!varProfileDetail && Object.keys(KgUtil.parseRequestParamsToJSON(kgVar?.varGridConfig?.value?.cmd_prm ?? '')).includes(key)) {
-                    return sql;
-                }
-
-                if (!value) {
-                    return sql;
-                }
-
-                return `${sql} AND ${value}`;
-            },
-            '',
-        );
-
-        const whereSqlSegment04: string = reduce(
-            paramRecord$QueryWhereSql,
-            (sql, value, key) => {
-                const varProfileDetail = kgSearchFormID ? kgSearchKgVar?.store?.getVarProfileDetail(kgSearchFormID, key) : null;
-                const varProfileDetail$Props = KgCoreUtil.tryParseJSON<IKgVarProfileDetailProperties>(varProfileDetail?.props);
-
-                // 要排除的属性, 不放进到 WHERE SQL 中
-                if (varProfileDetail?.exclude_from_where_sql_flag === 1) {
-                    return sql;
-                }
-
-                // 不属于当前 WHERE 查询语句,
-                if (varProfileDetail$Props.whereSqlName !== 'WHERE04') {
-                    return sql;
-                }
-
-                // 如果一个属性, 不在查询字段中, 但是在表格配置的查询参数中, 则该属性不放进到 WHERE SQL 中,
-                // 这种属性通常是直接传给后端接口用作逻辑处理, 不是简单的查询条件,
-                if (!varProfileDetail && Object.keys(KgUtil.parseRequestParamsToJSON(kgVar?.varGridConfig?.value?.cmd_prm ?? '')).includes(key)) {
-                    return sql;
-                }
-
-                if (!value) {
-                    return sql;
-                }
-
-                return `${sql} AND ${value}`;
-            },
-            '',
-        );
-
-        const whereSqlSegment05: string = reduce(
-            paramRecord$QueryWhereSql,
-            (sql, value, key) => {
-                const varProfileDetail = kgSearchFormID ? kgSearchKgVar?.store?.getVarProfileDetail(kgSearchFormID, key) : null;
-                const varProfileDetail$Props = KgCoreUtil.tryParseJSON<IKgVarProfileDetailProperties>(varProfileDetail?.props);
-
-                // 要排除的属性, 不放进到 WHERE SQL 中
-                if (varProfileDetail?.exclude_from_where_sql_flag === 1) {
-                    return sql;
-                }
-
-                // 不属于当前 WHERE 查询语句,
-                if (varProfileDetail$Props.whereSqlName !== 'WHERE05') {
-                    return sql;
-                }
-
-                // 如果一个属性, 不在查询字段中, 但是在表格配置的查询参数中, 则该属性不放进到 WHERE SQL 中,
-                // 这种属性通常是直接传给后端接口用作逻辑处理, 不是简单的查询条件,
-                if (!varProfileDetail && Object.keys(KgUtil.parseRequestParamsToJSON(kgVar?.varGridConfig?.value?.cmd_prm ?? '')).includes(key)) {
-                    return sql;
-                }
-
-                if (!value) {
-                    return sql;
-                }
-
-                return `${sql} AND ${value}`;
-            },
-            '',
-        );
-
-        //region WHERE
-        //----------------------------------------------------------------------------------------------------
-        let whereSql: string = `WHERE (1 = 1)${whereSqlSegment}`.replaceAll('(1 = 1) AND ', '');
-        let whereSql01: string = `WHERE (1 = 1)${whereSqlSegment01}`.replaceAll('(1 = 1) AND ', '');
-        let whereSql02: string = `WHERE (1 = 1)${whereSqlSegment02}`.replaceAll('(1 = 1) AND ', '');
-        let whereSql03: string = `WHERE (1 = 1)${whereSqlSegment03}`.replaceAll('(1 = 1) AND ', '');
-        let whereSql04: string = `WHERE (1 = 1)${whereSqlSegment04}`.replaceAll('(1 = 1) AND ', '');
-        let whereSql05: string = `WHERE (1 = 1)${whereSqlSegment05}`.replaceAll('(1 = 1) AND ', '');
-        //----------------------------------------------------------------------------------------------------
-        //endregion
-
-        //region ORDER BY
-        //----------------------------------------------------------------------------------------------------
-        let orderBySql = '';
-
-        {
-            // 如果没有指定排序的列, 则默认根据下面这些字段进行排序, 如果这些字段都不存在, 则根据主键进行排序,
-            if (!paramRecord.column) {
-                switch (true) {
-                    case !!kgVar?.currentVarGridDetails.value?.find((i) => last((i.var_nam ?? '').split('.')) === 'insDt'):
-                        paramRecord.column = 'insDt';
-                        paramRecord.order = 'desc';
-                        break;
-
-                    case !!kgVar?.currentVarGridDetails.value?.find((i) => last((i.var_nam ?? '').split('.')) === 'ins_dt'):
-                        paramRecord.column = 'ins_dt';
-                        paramRecord.order = 'desc';
-                        break;
-
-                    case !!kgVar?.currentVarGridDetails.value?.find((i) => last((i.var_nam ?? '').split('.')) === 'insdt'):
-                        paramRecord.column = 'insdt';
-                        paramRecord.order = 'desc';
-                        break;
-
-                    case !!kgVar?.currentVarGridDetails.value?.find((i) => last((i.var_nam ?? '').split('.')) === 'adddte'):
-                        paramRecord.column = 'adddte';
-                        paramRecord.order = 'desc';
-                        break;
-
-                    case !!kgVar?.currentVarGridDetails.value?.find((i) => last((i.var_nam ?? '').split('.')) === 'moddte'):
-                        paramRecord.column = 'moddte';
-                        paramRecord.order = 'desc';
-                        break;
-
-                    case !!kgVar?.currentVarGridDetails.value?.find((i) => last((i.var_nam ?? '').split('.')) === 'createTime'):
-                        paramRecord.column = 'createTime';
-                        paramRecord.order = 'desc';
-                        break;
-
-                    case !!kgVar?.currentVarGridDetails.value?.find((i) => last((i.var_nam ?? '').split('.')) === 'create_time'):
-                        paramRecord.column = 'create_time';
-                        paramRecord.order = 'desc';
-                        break;
-
-                    case !!kgVar?.currentVarGridDetails.value?.find((i) => last((i.var_nam ?? '').split('.')) === 'modifyTime'):
-                        paramRecord.column = 'modifyTime';
-                        paramRecord.order = 'desc';
-                        break;
-
-                    case !!kgVar?.currentVarGridDetails.value?.find((i) => last((i.var_nam ?? '').split('.')) === 'modify_time'):
-                        paramRecord.column = 'modify_time';
-                        paramRecord.order = 'desc';
-                        break;
-
-                    default:
-                        paramRecord.column = kgVar?.kgTable?.id?.value;
-                        break;
-                }
-            }
-
-            const _column = (() => {
-                // 转换为下划线命名方式
-                if (kgVar?.varGridConfig.value?.convert_sort_field_to_under_score_flg === 1) {
-                    return paramRecord.column
-                        .split('.')
-                        .map((i: string) => KgUtil.snakeCase(i))
-                        .join('.');
-                }
-
-                return paramRecord.column;
-            })();
-
-            if (_column) {
-                orderBySql = `ORDER BY "${_column}"`;
-
-                switch (true) {
-                    case (paramRecord.order || '').trim().toUpperCase() === 'ASC': {
-                        orderBySql += ' ASC';
-                        break;
-                    }
-
-                    case (paramRecord.order || '').trim().toUpperCase() === 'DESC': {
-                        orderBySql += ' DESC';
-                        break;
-                    }
-                }
-
-                orderBySql = orderBySql.trim();
-            }
-        }
-        //----------------------------------------------------------------------------------------------------
-        //endregion
-
-        return {
-            /**
-             * 查询操作符对象的 JSON 字符串.
-             */
-            operatorObjectJSON: encodeURIComponent(JSON.stringify(_dynamicQueryOperatorModel ?? {})),
-
-            /**
-             * ORDER BY SQL.
-             */
-            orderBySql: encodeURIComponent(orderBySql),
-
-            /**
-             * <p>查询字段的 WHERE 片段对象的 JSON 字符串.</p>
-             * <p>该对象中, 每一个 key 表示字段名, 每一个 value 表示该字段对应的 SQL 片段</p>
-             */
-            whereObjectJSON: encodeURIComponent(JSON.stringify(paramRecord$QueryWhereSql ?? {})),
-
-            /**
-             * WHERE SQL.
-             */
-            whereSql: encodeURIComponent(whereSql),
-
-            /**
-             * WHERE SQL.
-             */
-            whereSql01: encodeURIComponent(whereSql01),
-
-            /**
-             * WHERE SQL.
-             */
-            whereSql02: encodeURIComponent(whereSql02),
-
-            /**
-             * WHERE SQL.
-             */
-            whereSql03: encodeURIComponent(whereSql03),
-
-            /**
-             * WHERE SQL.
-             */
-            whereSql04: encodeURIComponent(whereSql04),
-
-            /**
-             * WHERE SQL.
-             */
-            whereSql05: encodeURIComponent(whereSql05),
-        };
-    }
-    //----------------------------------------------------------------------------------------------------
-    //endregion
-}
-
-export type ModalFunc = {
-    destroy: () => void;
-    update: (configUpdate: ModalFuncProps | ((prevConfig: ModalFuncProps) => ModalFuncProps)) => void;
-    showLoading(): void;
-    hideLoading(): void;
-};