Skip to main content
Version: 1.1.0

ICADataTableBaseConfig

@spartanfx/react v1.1.0


@spartanfx/react / codeapps / ICADataTableBaseConfig

Interface: ICADataTableBaseConfig<TRecord, TId>

Base config shared by CodeApps DataTable adapters.

Extends

Extended by

Type Parameters

TRecord

TRecord

TId

TId extends string | number = string

Properties

PropertyTypeDescriptionInherited from
appearance?AppearanceModeAppearance mode for theming.-
autoRefresh?booleanEnable auto-refresh after mutations (default: true).ICAAdapterBaseConfig.autoRefresh
cacheDuration?numberCache TTL for read results in ms (default: 60_000).ICAAdapterBaseConfig.cacheDuration
columns?( | IColumn | IDataTableColumn<TRecord>)[]Columns to display. May mix simplified IDataTableColumn and Fluent IColumn.-
debug?booleanEnable verbose console logging (default: false).ICAAdapterBaseConfig.debug
fieldInfo?IDataTableFieldType[]Optional field metadata for renderers and tooltips. CodeApps services do not expose schema at runtime — supply this when you need rich column rendering (User, Lookup, Choice, DateTime, ...).-
filterDiscoveryLimit?numberSample size for the default filter-options discovery (default: 1000). Only used when onGetFilterOptions is not provided.-
filterOptionsCacheTTL?numberCache TTL for filter-options results in ms (default: 5 minutes). Filter values are far less volatile than table data.-
groupByLevel1?stringField name for level-1 grouping.-
groupByLevel2?stringField name for level-2 grouping.-
groupByLevel3?stringField name for level-3 grouping.-
groupsDefaultCollapsed?booleanWhether groups start collapsed.-
inPlaceFilterItems?(item) => booleanClient-side post-filter. Applied after server-side filtering, useful for computed predicates the connector can't express.-
inPlaceSearchText?stringDefault search text. Triggers a filter that matches any of searchFields against the value via contains().-
odataFilter?stringOData $filter expression applied to every read. Always AND-combined with column filters and search text.-
onError?(error) => voidError callback. Called for every operational failure.ICAAdapterBaseConfig.onError
onGetFilterOptions?(fieldName, currentFilters) => Promise<IFilterCriteria[]>Override the filter-options discovery. Default implementation queries the data source for distinct values from a top-N sample, which is inexact for large tables — supply a custom implementation for accurate results.-
onNotify?CANotifyFnNotification callback. If omitted, hook errors surface via error state only.ICAAdapterBaseConfig.onNotify
retryPolicy?ICARetryPolicyRetry policy for transient failures.ICAAdapterBaseConfig.retryPolicy
rowLimit?numberPage size (default: 100).-
searchFields?string[]Columns to search across when onSearch is invoked. Required when search is enabled — OData has no built-in cross-column search.-
serviceICATabularService<TRecord & CADataTableRecord, TId>Generated tabular service from pac code add-data-source.-
translate?(text) => stringTranslation function (rendered through component).-
translatedFields?string[]Fields whose filter values should be translated for display.-