foggy-data-viewer 1.0.1-beta.39 → 1.0.1-beta.40

package/README.md

@@ -149,6 +149,20 @@ function handlePageChange(page: number, pageSize: number) {
 
 `DataTableWithSearch` 在 `schema + fetchData` 服务端查询模式下默认 `localFilter=false`：列头筛选仍会提交给 `fetchData`，但返回数据不会再被前端二次过滤，避免聚合字段、派生字段、字典展示字段被简单本地比较误删。需要纯前端过滤时，可显式设置 `localFilter=true` 或 `schema.localFilter=true`。
 
+### DataTableWithSearch tableInstanceId 默认查询配置
+
+`schema + fetchData` 模式支持按 `tableInstanceId` 加载默认查询配置。默认查询配置只负责默认展示列、排序、分页和筛选；`requiredRuntimeColumns`、`lockedColumns` 由 TM/QM 产出的 `TableSchema` 提供。
+
+```vue
+<DataTableWithSearch
+  :schema="{ ...tableSchema, qmModel: 'TicketQueryModel', tableInstanceId: 'ticket-list' }"
+  :fetch-data="fetchTickets"
+  :default-query-config-scope="{ userId: currentUser.id, tenantId: currentTenant.id, roleIds: currentRoleIds }"
+/>
+```
+
+后端可通过 `foggy.data-viewer.table-defaults.system/tenants/roles` 配置 fallback；用户默认配置仍可通过 `listPreset` 覆盖。`requiredRuntimeColumns` 只会追加到 `fetchData(params).columns`，不会显示为普通列。
+
 ### DataTable Events
 
 | 事件名 | 参数 | 说明 |

package/dist/api/listPreset.d.ts

@@ -3,6 +3,7 @@ export interface ListPresetScope {
     userId: string;
     model: string;
     businessKey?: string;
+    tableInstanceId?: string;
 }
 export interface SaveListPresetRequest {
     title: string;

package/dist/api/tableDefaultQueryConfig.d.ts

@@ -0,0 +1,2 @@
+import type { TableDefaultQueryConfig, TableDefaultQueryConfigScope } from '@/types';
+export declare function getTableDefaultQueryConfig(scope: TableDefaultQueryConfigScope): Promise<TableDefaultQueryConfig | null>;

package/dist/components/DataTableWithSearch.vue.d.ts

@@ -1,4 +1,4 @@
-import type { EnhancedColumnSchema, SliceRequestDef, FilterOption, TableSchema, FetchDataParams, FetchDataResult, OrderRequestDef, QueryHooks, MemberQueryRequest, MemberQueryResponse, CellCopyConfig, QueryMode, ListViewState, ListPresetConfig, TableDensity, SearchHooks } from '@/types';
+import type { EnhancedColumnSchema, SliceRequestDef, FilterOption, TableSchema, FetchDataParams, FetchDataResult, OrderRequestDef, QueryHooks, MemberQueryRequest, MemberQueryResponse, CellCopyConfig, QueryMode, ListViewState, ListPresetConfig, TableDensity, SearchHooks, TableDefaultQueryConfig, TableDefaultQueryConfigScope, TableDefaultQueryConfigLoadOptions } from '@/types';
 import type { QueryPanelExpose, QuerySchema } from './QueryPanel.vue';
 /**
  * DataTableWithSearch 组件
@@ -63,8 +63,16 @@ interface Props {
     showQueryPanel?: boolean;
     /** QM 模型名称（远程成员加载所需） */
     qmModel?: string;
+    /** 同一 QM 下的业务表格实例标识 */
+    tableInstanceId?: string;
     /** 远程维度成员加载器 */
     filterMemberLoader?: (request: MemberQueryRequest) => Promise<MemberQueryResponse>;
+    /** 已解析的表格实例默认查询配置 */
+    defaultQueryConfig?: TableDefaultQueryConfig | null;
+    /** 默认查询配置自动加载作用域 */
+    defaultQueryConfigScope?: TableDefaultQueryConfigLoadOptions;
+    /** 自定义默认查询配置加载器 */
+    defaultQueryConfigLoader?: (scope: TableDefaultQueryConfigScope) => Promise<TableDefaultQueryConfig | null>;
     /** 启用保存查询功能 */
     enableSavedQuery?: boolean;
     /** 自定义列表配置 */
@@ -86,6 +94,9 @@ interface DataTableExpose {
     clearSelection: (options?: ClearSelectionOptions) => void;
 }
 declare function clearSelectionState(options?: ClearSelectionOptions): void;
+declare function applyTableDefaultQueryConfig(config: TableDefaultQueryConfig, options?: {
+    reload?: boolean;
+}): void;
 declare function searchQueryPanel(): void;
 declare function resetQueryPanel(): void;
 declare function getListViewState(): ListViewState;
@@ -168,6 +179,8 @@ declare const __VLS_component: import("vue").DefineComponent<Props, {
     getListViewState: typeof getListViewState;
     /** 应用列表视图状态（用于加载自定义列表） */
     applyListViewState: typeof applyListViewState;
+    /** 应用表格实例默认查询配置 */
+    applyTableDefaultQueryConfig: typeof applyTableDefaultQueryConfig;
     /** 重置列表视图状态 */
     resetListViewState: typeof resetListViewState;
     /** 获取当前查询状态（用于保存查询） */

package/dist/components/composables/useTableQuery.d.ts

@@ -24,6 +24,7 @@ export interface UseTableQueryReturn {
     currentOrderBy: ReturnType<typeof ref<OrderRequestDef[]>>;
     currentSlice: ReturnType<typeof ref<SliceRequestDef[]>>;
     currentColumns: ReturnType<typeof ref<string[]>>;
+    currentTableInstanceId: ReturnType<typeof ref<string | undefined>>;
     loadData: (trigger?: QueryTrigger) => Promise<void>;
     refresh: () => Promise<void>;
     reload: () => Promise<void>;
@@ -31,6 +32,7 @@ export interface UseTableQueryReturn {
     setSort: (orderBy: OrderRequestDef[]) => void;
     setSlice: (slice: SliceRequestDef[]) => void;
     setColumns: (columns: string[]) => void;
+    setTableInstanceId: (tableInstanceId?: string) => void;
     addHook: <N extends QueryHookName>(name: N, fn: HookFnMap[N]) => () => void;
     removeHook: <N extends QueryHookName>(name: N, fn: HookFnMap[N]) => void;
 }

package/dist/index.d.ts

@@ -26,4 +26,5 @@ export { saveQuery, listSavedQueries, getSavedQuery, updateSavedQuery, deleteSav
 export type { SavedQueryDef, SaveQueryRequest, QueryVisibility } from './api/savedQuery';
 export { listPresets, getDefaultListPreset, createListPreset, getListPreset, updateListPreset, deleteListPreset, setDefaultListPreset, clearDefaultListPreset } from './api/listPreset';
 export type { ListPresetScope, SaveListPresetRequest, UpdateListPresetRequest } from './api/listPreset';
-export type { ColumnSchema, EnhancedColumnSchema, TableConfig, TableSchema, CellRenderContext, CellRenderFn, GlobalColumnRenderContext, GlobalColumnMatchFn, GlobalColumnRenderFn, GlobalColumnRenderer, GlobalColumnRenderResolution, CellCopyConfig, QueryMode, ColumnCustomization, QueryMetaResponse, ViewerQueryRequest, ViewerDataResponse, SliceRequestDef, OrderRequestDef, FilterOption, FetchDataParams, FetchDataResult, FetchDataFn, DictItem, PaginationState, SortState, QueryHooks, QueryHookContext, QueryTrigger, QueryHookName, BeforeQueryHookFn, AfterQueryHookFn, ErrorQueryHookFn, SearchSource, SearchTrigger, SearchHookContext, SearchHookUpdate, SearchHookName, BeforeSearchHookFn, AfterSearchHookFn, ErrorSearchHookFn, SearchHooks, MaybePromise, PivotAxisField, PivotAxisPage, PivotAxisPageScope, PivotAxisRole, PivotHeaderNode, PivotHeaderRole, PivotMetric, PivotRawAxisMember, PivotRawCell, PivotRawPayload, PivotShape, PivotViewMode, PivotViewModel, ListPresetVisibility, ListPresetPlacement, ListPresetConfig, ColumnViewSetting, QueryConditionPreset, ListViewState, ListPresetDef, FrontendMeta, FieldMeta, FieldCategory, MemberLookupMeta, UiHintsMeta, DefaultsMeta, CapabilitiesMeta, ParamsMeta, MemberQueryRequest, MemberOption, MemberQueryResponse } from './types';
+export { getTableDefaultQueryConfig } from './api/tableDefaultQueryConfig';
+export type { ColumnSchema, EnhancedColumnSchema, TableConfig, TableSchema, CellRenderContext, CellRenderFn, GlobalColumnRenderContext, GlobalColumnMatchFn, GlobalColumnRenderFn, GlobalColumnRenderer, GlobalColumnRenderResolution, CellCopyConfig, QueryMode, ColumnCustomization, QueryMetaResponse, ViewerQueryRequest, ViewerDataResponse, SliceRequestDef, OrderRequestDef, FilterOption, FetchDataParams, FetchDataResult, FetchDataFn, DictItem, PaginationState, SortState, QueryHooks, QueryHookContext, QueryTrigger, QueryHookName, BeforeQueryHookFn, AfterQueryHookFn, ErrorQueryHookFn, SearchSource, SearchTrigger, SearchHookContext, SearchHookUpdate, SearchHookName, BeforeSearchHookFn, AfterSearchHookFn, ErrorSearchHookFn, SearchHooks, MaybePromise, PivotAxisField, PivotAxisPage, PivotAxisPageScope, PivotAxisRole, PivotHeaderNode, PivotHeaderRole, PivotMetric, PivotRawAxisMember, PivotRawCell, PivotRawPayload, PivotShape, PivotViewMode, PivotViewModel, ListPresetVisibility, ListPresetPlacement, ListPresetConfig, TableDefaultQueryConfig, TableDefaultQueryConfigScope, TableDefaultQueryConfigLoadOptions, TableDefaultQueryConfigSource, ColumnViewSetting, QueryConditionPreset, ListViewState, ListPresetDef, FrontendMeta, FieldMeta, FieldCategory, MemberLookupMeta, UiHintsMeta, DefaultsMeta, CapabilitiesMeta, ParamsMeta, MemberQueryRequest, MemberOption, MemberQueryResponse } from './types';