Skip to main content

ICAPlannerInternalConfig

@spartanfx/react v1.2.2


@spartanfx/react / codeapps / ICAPlannerInternalConfig

Interface: ICAPlannerInternalConfig<TId>

Base config shared by CodeApps Planner adapters.

Extends

Type Parameters

TId

TId extends string | number

Properties

Required

PropertyTypeDescription
idColumnstringColumn name carrying the primary key in records (e.g. Id for SP, <entity>id for DV).
modeCAPlannerMode-
schemaIPlannerSchemaSchema mapping internal planner fields to data source columns.
serviceICATabularService<CAPlannerRecord, TId>Generated tabular service from pac code add-data-source.

Options

PropertyTypeDescription
autoRefresh?booleanEnable auto-refresh after mutations (default: true).
cacheDuration?numberCache TTL for read results in ms (default: 60_000).
choiceColumns?string[]SharePoint-only: column names backed by Choice / Lookup / Person columns. The Planner schema is consumer-driven (it doesn't know which columns are Choice columns), so declare them here to enable automatic expansion of string labels to the { "@odata.type", Value, Id } object the SharePoint connector requires on create/update. No default — when omitted, no resolution is performed. Ignored for services that don't expose getReferencedEntity (e.g. Dataverse). See: https://learn.microsoft.com/en-us/power-apps/developer/code-apps/how-to/sharepoint-operations
debounceMs?numberDebounce delay for refetch on date-range change (default: 300 ms).
debug?booleanEnable verbose console logging (default: false).
endDate?DateInitial end of the visible range. Default: Dec 31 of current year.
odataFilter?stringAdditional OData $filter to combine with the date-range clause.
retryPolicy?ICARetryPolicyRetry policy for transient failures.
rowLimit?numberMaximum records per fetch (default: 5000).
searchText?stringOptional search text for client-side filtering.
startDate?DateInitial start of the visible range. Default: Jan 1 of current year.

Events & callbacks

PropertyTypeDescription
onError?(error) => voidError callback. Called for every operational failure.
onNotify?CANotifyFnNotification callback. If omitted, hook errors surface via error state only.