IDashboard
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production.
Analytical dashboard consists of widgets (widgets are kpis or insights with additional settings - drilling and alerting), layout (which defines rendering and ordering of these widgets), and filter context (configured attribute and date filters). It’s also possible to setup scheduled emails for the dashboard (user will receive an email with the exported dashboard attached at the specified time interval), and optionally extended date filter config.
export interface IDashboard<TWidget = IDashboardWidget> extends IDashboardBase, IDashboardObjectIdentity, Readonly<Required<IAuditableDates>>, Readonly<IAuditableUsers>, IAccessControlAware
Extends: IDashboardBase, IDashboardObjectIdentity, Readonly<Required<IAuditableDates>>, Readonly<IAuditableUsers>, IAccessControlAware
Properties
Property | Modifiers | Type | Description |
|---|---|---|---|
| (ALPHA) (Optional) Dashboard extended attribute filter configs | ||
| (ALPHA) (Optional) Data sets related to the dashboard, as defined by the includes directive | ||
| (ALPHA) (Optional) Dashboard extended common date filter config | ||
| (ALPHA) (Optional) Dashboard extended date filters with date data set/dimension configs | ||
| boolean | (ALPHA) (Optional) Disables cross filtering for this dashboard. | |
| boolean | (ALPHA) (Optional) Disables listing and saving of filter views for this dashboard. | |
| boolean | (ALPHA) (Optional) Disables persistent filters across tabs for this dashboard. | |
| boolean | (ALPHA) (Optional) Disables reset of user filters for this dashboard. | |
| boolean | (ALPHA) (Optional) Disables save of user filters for this dashboard. | |
| string | (ALPHA) (Optional) Override the default evaluation frequency for the dashboard. | |
| (ALPHA) (Optional) Dashboard filter context, or temporary filter context (temporary filter context is used to override original filter context during the export) | ||
| IDashboardLayout<TWidget> | (ALPHA) (Optional) The layout of the dashboard determines the dashboard widgets IWidget and where they are rendered | |
| (ALPHA) (Optional) Dashboard extended measure value filter configs | ||
| (ALPHA) (Optional) Legacy dashboard-level parameters. Preserved as a read-only fallback for legacy metadata; saves emit parameters per tab on IDashboardTab.parameters instead. Honored on load only when no tab carries parameters. | ||
| (ALPHA) (Optional) Plugins used on this dashboard. | ||
| (ALPHA) (Optional) Date dataset to use for filtering metrics in section header rich text. | ||
| IDashboardTab<TWidget>[] | (ALPHA) (Optional) Optional tabs configuration; when defined, the dashboard renders as a tabbed interface. Each tab has its own layout, filter context and filter configs. | |
| (ALPHA) (Optional) Dashboard-level timezone configuration. | ||
| “IDashboard” | (ALPHA) |
Property details
IDashboard.attributeFilterConfigspropertyAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production.
Dashboard extended attribute filter configs
readonly attributeFilterConfigs?: IDashboardAttributeFilterConfig[];
IDashboard.dataSetspropertyAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production.
Data sets related to the dashboard, as defined by the includes directive
readonly dataSets?: IDataSetMetadataObject[];
IDashboard.dateFilterConfigpropertyAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production.
Dashboard extended common date filter config
readonly dateFilterConfig?: IDashboardDateFilterConfig;
IDashboard.dateFilterConfigspropertyAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production.
Dashboard extended date filters with date data set/dimension configs
readonly dateFilterConfigs?: IDashboardDateFilterConfigItem[];
IDashboard.disableCrossFilteringpropertyAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production.
Disables cross filtering for this dashboard.
readonly disableCrossFiltering?: boolean;
IDashboard.disableFilterViewspropertyAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production.
Disables listing and saving of filter views for this dashboard.
readonly disableFilterViews?: boolean;
IDashboard.disablePersistentFiltersAcrossTabspropertyAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production.
Disables persistent filters across tabs for this dashboard.
readonly disablePersistentFiltersAcrossTabs?: boolean;
IDashboard.disableUserFilterResetpropertyAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production.
Disables reset of user filters for this dashboard.
readonly disableUserFilterReset?: boolean;
IDashboard.disableUserFilterSavepropertyAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production.
Disables save of user filters for this dashboard.
readonly disableUserFilterSave?: boolean;
IDashboard.evaluationFrequencypropertyAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production.
Override the default evaluation frequency for the dashboard.
readonly evaluationFrequency?: string;
IDashboard.filterContextpropertyAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production.
Dashboard filter context, or temporary filter context (temporary filter context is used to override original filter context during the export)
readonly filterContext?: IFilterContext | ITempFilterContext;
IDashboard.layoutpropertyAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production.
The layout of the dashboard determines the dashboard widgets IWidget and where they are rendered
readonly layout?: IDashboardLayout<TWidget>;
IDashboard.measureValueFilterConfigspropertyAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production.
Dashboard extended measure value filter configs
readonly measureValueFilterConfigs?: IDashboardMeasureValueFilterConfig[];
IDashboard.parameterspropertyAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production.
Legacy dashboard-level parameters. Preserved as a read-only fallback for legacy metadata; saves emit parameters per tab on IDashboardTab.parameters instead. Honored on load only when no tab carries parameters.
readonly parameters?: IDashboardParameter[];
IDashboard.pluginspropertyAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production.
Plugins used on this dashboard.
readonly plugins?: IDashboardPluginLink[];
IDashboard.sectionHeadersDateDataSetpropertyAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production.
Date dataset to use for filtering metrics in section header rich text.
readonly sectionHeadersDateDataSet?: ObjRef;
IDashboard.tabspropertyAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production.
Optional tabs configuration; when defined, the dashboard renders as a tabbed interface. Each tab has its own layout, filter context and filter configs.
readonly tabs?: IDashboardTab<TWidget>[];
IDashboard.timezoneConfigpropertyAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production.
Dashboard-level timezone configuration.
readonly timezoneConfig?: IDashboardTimezoneConfig;
IDashboard.typepropertyAlpha
Alpha API. Initial API, highly likely to change outside SemVer. Don’t build on it in production.
readonly type: "IDashboard";