Types
AccessLog
Property | Type | Description |
---|---|---|
id | string | |
lastOpened | number |
Action
The Redux actions dispatched by Atoti UI to update its state.
- ActivePageChangedAction
- ActiveToolChangedAction
- DashboardLoadedAction
- DashboardUnloadedAction
- DashboardUpdatedAction
- DashboardSavedAction
- ExpandDataModelTreeAction
- CollapseDataModelTreeAction
- IsOpenDashboardPopupVisibleAction
- IsSettingsPopupVisibleAction
- IsPresentingAction
- StatusNotificationAddedAction
- StatusNotificationSettledAction
- StatusNotificationRemovedAction
- IsDeferredAction
- ResourcesPanelChangedAction
- WidgetSelectedAction
- ExpandedFolderPathsInHomePageAction
ActionProps
- WidgetActionProps<WidgetState, SelectionType>
- WidgetInDashboardActionProps<WidgetState, SelectionType>
ActivePageChangedAction
Redux action to change the active dashboard page. See activePageKey
in State.
Property | Type | Description |
---|---|---|
pageKey | string | |
type | "activePageChanged" |
ActivePivotClient
Provides methods to interact with an ActivePivot server:
-
Allows to run MDX queries against ActivePivot via a websocket.
-
Allows to perform REST calls against ActivePivot.
Property | Type | Description |
---|---|---|
serverVersion | string | The server's version. |
serviceVersion | ServiceVersion | The version of the APIs offered by the server's REST and websocket endpoints. |
url | string | The server's URL. |
calculatedMembers | { [cubeName: string]: { calculatedMembers?: { [name: string]: { owners: string[]; readers: string[]; }; }; isLoading: boolean; error?: Error; }; } | The list of calculated members per cube, if they are already loaded. See loadCalculatedMembers . |
connectionStatus | ConnectionStatus | The current connection status of the client. |
dataModel | DataModel | undefined | The DataModel if it is already loaded. See loadDataModel . |
dataModelLoadingError | DataModelLoadingError | undefined | The error received from the server in case the data model could not be loaded. |
drillthroughColumns | { [cubeName: string]: { drillthroughColumns?: DrillthroughColumn[]; isLoading: boolean; error?: Error; }; } | The list of DrillthroughColumn per cube, if they are already loaded. See loadDrillthroughColumns . |
isDataModelLoading | boolean | Whether the DataModel is still loading. |
Method | Description |
---|---|
addCalculatedMembersListener | Deprecated: Use subscribeToCalculatedMembers instead. |
addConnectionStatusListener | Deprecated: Use subscribeToConnectionStatus instead. |
addDataModelListener | Deprecated: Use subscribeToDataModel instead. |
addDrillthroughColumnsListener | Deprecated: Use subscribeToDrillthroughColumns instead. |
addQueryListener | Deprecated: Use subscribeToQuery instead. |
addQueryResultListener | Deprecated: Use subscribeToQueryResult instead. |
connect | Asynchronously connects the client to the ActivePivot server's query streaming service. Resolves immediately if the client is already connected. |
createCalculatedMember | Asynchronously creates a calculated member in the cube identified by cubeName . |
createKpi | Asynchronously creates a Kpi in the cube identified by cubeName . |
deleteCalculatedMember | Asynchronously deletes a calculated member from the cube identified by cubeName . |
deleteKpi | Asynchronously deletes a Kpi from the cube identified by cubeName . |
disconnect | Disconnects the client from the ActivePivot server's query streaming service. |
getQuery | Returns the Query identified by queryId if it exists. |
getQueryResult | Returns the latest QueryResult for the Query identified by queryId . |
loadCalculatedMembers | Asynchronously returns the calculated members defined in the cube identified by cubeName . The loaded calculated members are then accessible using addCalculatedMembersListener . |
loadDataModel | Asynchronously loads the DataModel, making it available through ActivePivotClient. Can be called several times to load an up-to-date version. |
loadDrillthroughColumns | Asynchronously loads the list of DrillthroughColumn for cube cubeName , making it available through ActivePivotClient. |
refreshQuery | Re-executes a paused query once. |
removeCalculatedMembersListener | Deprecated: Use subscribeToCalculatedMembers instead. |
removeConnectionStatusListener | Deprecated: Use subscribeToConnectionStatus instead. |
removeDataModelListener | Deprecated: Use subscribeToDataModel instead. |
removeDrillthroughColumnsListener | Deprecated: Use subscribeToDrillthroughColumns instead. |
removeQueryListener | Deprecated: Use subscribeToQuery instead. |
removeQueryResultListener | Deprecated: Use subscribeToQueryResult instead. |
setQuery | Updates the Query identified by queryId or register it if it did not exist. Marks the query as loading and sends a message to the server. If passed, the initialHeaders received during the first call for this query are added to the "REGISTER" websocket message. initialHeaders received on subsequent calls are disregarded. Indeed, the ones attached to the "REGISTER" message are then also attached to the following "UPDATE" messages for this query. |
subscribeToCalculatedMembers | Registers callback to be called when the calculated members of the cube identified by cubeName change. |
subscribeToConnectionStatus | Registers callback to be called whenever the client status changes. |
subscribeToDataModel | Registers callback to be called whenever the data model changes. |
subscribeToDrillthroughColumns | Registers callback to be called whenever the drillthrough columns change. |
subscribeToQuery | Registers callback to be called whenever the Query identified by queryId is updated. |
subscribeToQueryResult | Registers callback to be called whenever a new QueryResult is received for the Query identified by queryId . |
updateCalculatedMember | Asynchronously updates a calculated member in the cube identified by cubeName . |
ActiveToolChangedAction
Redux action to change the active tool. See activeToolKey
in State.
Property | Type | Description |
---|---|---|
toolKey | string | null | |
type | "activeToolChanged" |
Activity
Information about the past usage of Atoti by the current user. Useful to provide shortcuts to recently used elements, and more. Regroups all pieces of information stored on the Content Server, belonging to a user and which are not settings.
Property | Type | Description |
---|---|---|
lastUsedCube | { cubeName: CubeName; serverKey: string; } | The name and the server key of the last cube selected by the user. It controls which cube is targeted when creating a new widget. |
recentlyOpenedDashboards | AccessLog[] | The ids of the dashboards recently opened by the current user, ordered by last opened |
userFilters | Filter<T>[] | Filters attached to the current user and applying to all dashboards she visits. |
userQueryContext | QueryContextEntry[] | Query context attached to the current user and applying to all dashboards they visit. |
ActivityListener
Use ContentClient.getActivity()
and ContentClient.subscribeToActivity()
instead.
(value: Activity[K]) => void
ADataModelNode
A node in a data model tree, under a cube.
Property | Type | Description |
---|---|---|
caption | string | |
dragItem | any | |
isActionable | boolean | |
isDisabled | boolean | |
isFolder | boolean | |
cubeName | string | |
serverKey | string |
AFilter
A filter is always contextual to a hierarchy
HierarchyCoordinates & {
isExclusionFilter?: boolean;
isPinned?: boolean;
}
AllMeasuresInMapping
A tile in the widget mapping, representing all measures.
Property | Type | Description |
---|---|---|
type | "allMeasures" |
AMdxCompoundIdentifier
The common attributes shared by all types of MdxCompoundIdentifier.
Property | Type | Description |
---|---|---|
elementType | "CompoundIdentifier" | |
identifiers | MdxIdentifier[] |
AMetaData
Property | Type | Description |
---|---|---|
isFolder | boolean | |
name | string |
ANode
Property | Type | Description |
---|---|---|
caption | string | |
dragItem | any | |
isActionable | boolean | |
isDisabled | boolean | |
isFolder | boolean |
APlugin
Type extended by every plugin type. Each plugin must specify its key and can come with its own translations.
Property | Type | Description |
---|---|---|
key | string | |
translations | { [locale: string]: TranslationTree<string>; } |
ApplicationMenu
A menu that is displayed in the header of the application.
ApplicationMenuItem
A menu item that is displayed in the header of the application.
Property | Type | Description |
---|---|---|
key | string |
Method | Description |
---|---|
useMenuItem |
ApplicationSubMenu
A submenu within the menu in the header of the application. The children can be more submenus, or menu items.
Property | Type | Description |
---|---|---|
key | string | |
children | ApplicationMenu[] |
Method | Description |
---|---|
useMenuItem |
Argument
- "PLACE_HOLDER" /** * boolean, int, double, date, … */
- "SCALAR" /** * function keyword */
- "KEYWORD" /** * string (means will be surrounded by single quotes) */
- "STRING"
AttributeRole
Attribute roles define what happens when the user switches from one type of widget to another. For instance, when the user switches from a pivot table to a line chart, the fields belonging to each role are mapped to the attributes of the same role in the target widget.
In the case of a line chart xAxis
is primaryOrdinal
, values
is primaryNumeric
, splitBy
is secondaryOrdinal
and secondaryValues
(values mapped to the secondary Y axis) is secondaryNumeric
. In the case of a pivot table rows
is primaryOrdinal
, measures
is primaryNumeric
and columns
is secondaryOrdinal
.
- "primaryNumeric"
- "primaryOrdinal"
- "secondaryNumeric"
- "secondaryOrdinal"
- "subplot"
AWidgetState
The state of any widget. Note that each individual widget plugin typically extends this type. If linked to a saved widget, contains a reference to its id
and the version
that was used when the copy was made. See WidgetMetaData
IsLinkedToSavedWidget extends true ? AWidgetState<T, false> & {
version: number;
id: string;
hasDivergedFromOriginal: boolean;
} : {
isFullScreen?: boolean;
filters?: Filter<T>[];
queryContext?: QueryContextEntry[];
name?: string;
widgetKey: string;
behavior?: WidgetBehavior;
}
Axis
Property | Type | Description |
---|---|---|
hierarchies | { dimension: DimensionName; hierarchy: HierarchyName; }[] | |
id | AxisId | |
maxLevelPerHierarchy | number[] | |
positions | Member[][] | |
range | AxisRange |
AxisId
- -1
- 0
- 1
- 2
- 3
- 4
AxisName
- "COLUMNS"
- "0"
- "ROWS"
- "1"
- "SLICER"
- "PAGES"
AxisRange
Property | Type | Description |
---|---|---|
from | number | |
to | number | |
axisLength | number | |
entireAxis | boolean |
BasicDashboardProps
Property | Type | Description |
---|---|---|
activePageKey | string | |
className | string | |
initialPageState | Omit<DashboardPageState, "name"> | |
isExportingToPDF | boolean | |
LeafComponent | ComponentType<LeafProps> | |
onActivePageChange | (newActivePageKey: string) => void | |
onChange | (newState: DashboardState) => void | |
onLoaded | () => void | |
onWidgetSelected | (newSelectedLeafKey: string) => void | |
selectedLeafKey | string | |
state | DashboardState | |
style | CSSProperties | |
tabBarExtraContent | ReactNode |
Catalog
Property | Type | Description |
---|---|---|
cubes | T extends "raw" ? Cube<"raw">[] : { [cubeName: string]: Cube<"indexed">; } | |
name | string |
CatalogNode
A data model tree node representing a catalog
Property | Type | Description |
---|---|---|
caption | string | |
dragItem | any | |
isActionable | boolean | |
isDisabled | boolean | |
isFolder | boolean | |
type | "catalog" |
Cell
Property | Type | Description |
---|---|---|
formattedValue | string | |
ordinal | number | |
properties | { [key in CellProperty]?: null | string | number | undefined; } | |
value | number | string |
CellPlugin
Plugin useful for cell Components usable on table widgets.
Property | Type | Description |
---|---|---|
key | string | |
translations | { [locale: string]: TranslationTree<string>; } | |
Cell | ForwardRefExoticComponent<CellPropsType & RefAttributes<HTMLDivElement>> |
CellPluginForCellSetTable
Most used variant of CellPlugin, suitable for table widgets representing a CellSet.
CellPlugin<CellSetTableCellProps>
CellProperty
Properties attached to each cell in a CellSet.
In Atoti UI, these properties are used for styling.
- "BACK_COLOR"
- "FORE_COLOR"
- "FONT_NAME"
- "FONT_FLAGS"
- "FONT_SIZE"
- "FORMAT_STRING"
- "DISPLAY_INFO"
CellProps
Type extended by the props of CellPlugin Cell
components.
Property | Type | Description |
---|---|---|
caption | string | |
className | string | |
columnIndex | number | |
height | number | |
isColumnFrozen | boolean | |
isRowFrozen | boolean | |
isVirtualized | boolean | |
left | number | |
parentTotalRowIndex | number | |
rowIndex | number | |
size | "small" | "medium" | "large" | |
style | CSSProperties | |
top | number | |
value | string | number | |
width | number | |
wrapText | boolean |
CellSet
Property | Type | Description |
---|---|---|
axes | Axis[] | |
cells | Cell[] | |
cube | CubeName | |
defaultMembers | DefaultMember[] | |
epoch | number |
CellSetAxesSelection
The tuples and levels corresponding to the selected positions (which can be headers in a table or ticks on a chart's axes).
- { id: AxisId; hierarchies?: (LevelCoordinates
- {
dimensionName: "Measures";
hierarchyName: "Measures";
})[];
positions?: Tuple[];
positionIndices?: number[];
}[]
CellSetCellsSelection
The tuple and value corresponding to each selected Cell (which can be body cells in a table, or points on a chart).
- { tuple: Tuple; value?: number
- string; }[]
CellSetSelection
A selection of cells, positions and levels in a CellSet.
{
axes?: CellSetAxesSelection;
cells?: CellSetCellsSelection;
}
CellSetTableBodyCellProps
The props of body cells in a CellSetTable.
LoadingTableCellProps & DerivedCellSetTableBodyCellProps
CellSetTableCellProps
The props of cells in a CellSetTable.
- LoadingTableCellProps
- CellSetTableBodyCellProps
- CellSetTableHeaderCellProps
- CellSetTableStaticHeaderCellProps
CellSetTableHeaderCellProps
The props of header cells in a CellSetTable.
- LoadingTableCellProps & DerivedCellSetTableHeaderCellProps & (CellSetTableCellPropsFromRow
- CellSetTableCellPropsFromColumn)
CellSetTableStaticHeaderCellProps
The props of static header cells in a CellSetTable.
LoadingTableCellProps & DerivedCellSetTableStaticHeaderCellProps
CellStylePlugin
Plugin useful to provide style to cells in table widgets.
Property | Type | Description |
---|---|---|
key | string | |
translations | { [locale: string]: TranslationTree<string>; } | |
withCellStyle | <T extends CellPropsType = CellPropsType>(CellComponent: ForwardRefExoticComponent<T & RefAttributes<HTMLDivElement>>) => ForwardRefExoticComponent<PropsWithoutRef<T> & RefAttributes<HTMLDivElement>> |
CellStylePluginForCellSetTable
Most used variant of CellStylePlugin, suitable for table widgets representing a CellSet.
CellStylePlugin<CellSetTableCellProps>
Client
Parent interface for ActivePivot/Content Server/ActiveMonitor clients.
Property | Type | Description |
---|---|---|
serverVersion | string | The server's version. |
serviceVersion | ServiceVersion | The version of the APIs offered by the server's REST and websocket endpoints. |
url | string | The server's URL. |
Clients
Property | Type | Description |
---|---|---|
activePivot | { [serverKey: string]: ActivePivotClient; } | |
content | ContentClient |
CollapseDataModelTreeAction
Redux action to collapse the data model tree. See isDataModelTreeExpanded
in State.
Property | Type | Description |
---|---|---|
type | "collapseDataModelTree" |
Color
A string representing a color.
string
CompositeHierarchyInMapping
A tile in the widget mapping, representing 2 hierarchies glued together. This can be created through an "expand by" action on a pivot table.
Property | Type | Description |
---|---|---|
hierarchies | (LevelCoordinates & { expandedDownTo?: LevelName; })[] | |
type | "compositeHierarchy" |
Configuration
Object describing how Atoti UI is configured. In particular, it describes which Plugins are registered, which has an impact both on the application functionalities and on the bundle size.
Property | Type | Description |
---|---|---|
applicationName | string | |
extraVersions | { [name: string]: string; } | The extra software versions that will be displayed in the about popup below the Atoti UI and Atoti Server(s) versions. |
higherOrderComponents | ((wrappedComponent: ComponentType) => ComponentType)[] | Higher-order components (HOCs) wrapping the application. In particular, it allows to provide React contexts.See https://reactjs.org/docs/higher-order-components.html |
initialDashboardPageState | Omit<DashboardPageState, "name"> | |
isBrandSignatureVisible | boolean | |
leftApplicationMenu | ApplicationMenu[] | Controls the menu items on the left of the header. They are usually specific to dashboards. |
pathToHome | string | The path to the Atoti home page. |
pluginRegistry | PluginRegistry | |
rightApplicationMenu | ApplicationMenu[] | Controls the menu items on the right of the header. They are typically always available. |
routes | RouteObject[] | |
storeEnhancers | StoreEnhancer[] | Redux store enhancers, allowing extensions to hook into the state of Atoti UI.It can be used by an extension to: - inject its own state into Atoti UI, so that the extension itself and other extensions can consume it - react to actions dispatched by Atoti UI or other extensionsThe store enhancers are composed, which allows to split state management on a per-extension basis.See https://redux.js.org/usage/configuring-your-store#extending-redux-functionality |
themes | { [themeKey: string]: Partial<Theme> & { primaryColor: Color; }; } | |
tools | Tool[] | |
widgetLoadingOverlay | ComponentType<LoadingOverlayProps> | An overlay shown while a widget is loading. |
ConnectionStatus
The connection status of an ActivePivotClient. When "connected", queries can be run against it using useQueryResult.
- "disconnected"
- "connecting"
- "connected"
ContainingMode
- "startsWith"
- "doesNotStartWith"
- "endsWith"
- "doesNotEndWith"
- "contains"
- "doesNotContain"
ContentClient
Provides methods to interact with the Content Server.
Property | Type | Description |
---|---|---|
serverVersion | string | The server's version. |
serviceVersion | ServiceVersion | The version of the APIs offered by the server's REST and websocket endpoints. |
url | string | The server's URL. |
Method | Description |
---|---|
addActivityListener | Deprecated: Use subscribeToActivity instead. |
addPermissionListener | Deprecated: Use subscribeToPermission instead. |
addSettingListener | Deprecated: Use subscribeToSetting instead. |
addTreeListener | Deprecated: Use subscribeToTree instead. |
createFile | Asynchronously creates a dashboard or a widget file on the Content Server. Returns its id. |
createFolder | Asynchronously creates a dashboard or a widget folder on the Content Server. Returns its id. |
deleteFile | Asynchronously deletes a dashboard or a widget file on the Content Server. |
deleteFilesAndFolders | Asynchronously deletes the selected files and folders of type on the Content Server. |
deleteFolder | Asynchronously deletes a dashboard or a widget folder on the Content Server. |
exportFilesAndFolders | Asynchronously returns: - a flat map containing all content entries (recursively) below the passed ids on the Content Server. - the tree structure of these entries under the exported folder. This method is only compatible with content service versions of 7 and above. The passed ids must refer to entries in a single folder, located at pathToParentFolder . |
fetchFile | Asynchronously returns the content of a dashboard or a widget file on the Content Server. Includes the file's metadata unless withMetaData: false is given, in which case pathToParentFolder is optional. |
fetchThumbnail | Asynchronously returns the thumbnail at path if it exists, undefined otherwise. |
fetchThumbnails | Asynchronously returns all accessible thumbnails in pathToParentFolder . Does not return thumbnails of subfolders. Returns a record object where values are the thumbnail images and keys are the ids of the files they relate to. |
getActivity | Returns the value of the activity identified by activityKey if it exists. |
getArePermissionsLoaded | Returns whether the permissions have been loaded by loadPermissions |
getAreSettingsLoaded | Returns whether the settings have been loaded by loadSettings |
getPermission | Returns the value of the permission identified by permissionKey , along with a flag indicating whether it is explicitly set in one of the permission files impacting the user. |
getSetting | Returns the value of the setting identified by settingKey if it exists. |
getTree | Returns the dashboards, widgets, or filters tree, if it is already loaded. |
importFilesAndFolders | Asynchronously imports the given files and folders into the Content Server. These files and folders must all be under the same parent folder. This method is only compatible with content service versions of 7 and above. |
loadActivity | Asynchronously loads the Activity of the current user and makes it available via getActivity . If the activity file's content is not a valid JSON object, a default empty activity object is loaded. |
loadPermissions | Asynchronously loads the permissions, making them available via getPermission . If one of the permissions file's content is not a valid JSON object, loads a set of default permissions values instead. |
loadSettings | Asynchronously loads the settings, making them available via getSetting . If one of the settings file's content is not a valid JSON object, loads a set of default settings values instead. |
loadTree | Asynchronously loads the tree of all accessible dashboards, widgets, or filters. |
moveFiles | Asynchronously moves files from a same folder into a different folder on the Content Server. |
removeActivityListener | Deprecated: Use subscribeToActivity instead. |
removePermissionListener | Deprecated: Use subscribeToPermission instead. |
removeSettingListener | Deprecated: Use subscribeToSetting instead. |
removeTreeListener | Deprecated: Use subscribeToTree instead. |
subscribeToActivity | Registers callback to be called whenever the value of the activity identified by activityKey is updated. |
subscribeToPermission | Registers callback to be called whenever the value of the permission identified by permissionKey is updated. |
subscribeToSetting | Registers callback to be called whenever the value of the setting identified by settingKey is updated. |
subscribeToTree | Registers callback to be called whenever the dashboards, widgets, or filters tree is reloaded. |
updateActivity | Saves the new version of the user's Activity on the Content Server. |
updateFile | Asynchronously updates an existing dashboard or widget file on the Content Server. |
updateFilePermissions | Asynchronously updates an existing dashboard or widget file's permissions on the Content Server. |
updateFolder | Asynchronously updates an existing dashboard or widget folder on the Content Server. |
updateFolderPermissions | Asynchronously updates an existing folder's permissions on the Content Server. |
updatePermission | Asynchronously updates the value of the permission identified by key for the given user. Requires being authenticated as a user with admin privileges. |
updateSetting | Asynchronously updates the value of the user setting identified by key for the given user. |
updateSettings | Asynchronously updates the user settings. |
ContentEntry
An entry on the content server.
{
isDirectory?: boolean;
owners: string[];
readers: string[];
content?: Content;
} &
(T extends "response" ? {
canRead: boolean;
canWrite: boolean;
isDirectory: boolean;
lastEditor: string;
timestamp: number;
} : unknown)
Remarks:
The properties of the content entry vary on whether it is sent in an API request or received in an API response.
See https://artifacts.activeviam.com/documentation/rest/6.0.0/content-server.html\#files\_\_\_path\_\_path\_\_get for more information on the ContentEntry response shape. See https://artifacts.activeviam.com/documentation/rest/6.0.0/content-server.html\#files\_\_\_path\_\_path\_\_post for more information on the ContentEntry request shape.
ContentNode
Property | Type | Description |
---|---|---|
caption | string | |
dragItem | any | |
isActionable | boolean | |
isDisabled | boolean | |
isFolder | boolean | |
entry | ContentEntry<AMetaData> | |
id | string | |
metaData | MetaData | |
type | ContentNodeType |
ContentNodeType
- "file"
- "folder"
- "server"
ContentRecord
Property | Type | Description |
---|---|---|
children | { [childName: string]: ContentRecord<Content, T>; } | |
entry | ContentEntry<Content, T> |
ContentType
- "dashboard"
- "widget"
- "filter"
ContextValueDefinition
Property | Type | Description |
---|---|---|
category | string | |
description | string | |
name | string | |
type | string |
Cube
Property | Type | Description |
---|---|---|
caption | string | |
contextValues | T extends "raw" ? DefaultContextValue[] : { [defaultContextValueName: string]: DefaultContextValue; } | |
defaultMembers | DefaultMember[] | |
dimensions | T extends "raw" ? Dimension<"raw">[] : { [dimensionName: string]: Dimension<"indexed">; } | |
kpis | T extends "raw" ? Kpi[] : { [kpiName: string]: Kpi; } | |
measureGroups | T extends "raw" ? MeasureGroup[] : { [measureGroupName: string]: MeasureGroup; } | |
measures | T extends "raw" ? Measure[] : { [measureName: string]: Measure; } | |
name | CubeName | |
sets | T extends "raw" ? Set[] : { [setName: string]: Set; } |
CubeName
string
CubeNode
A data model tree node representing a cube
Property | Type | Description |
---|---|---|
caption | string | |
dragItem | any | |
isActionable | boolean | |
isDisabled | boolean | |
isFolder | boolean | |
name | string | |
serverKey | string | |
type | "cube" |
CurriedCellSetTableCellProps
The props of CellSet table cells, which are curried by the CellSetTable Component.
Property | Type | Description |
---|---|---|
cells | CellSetTableCell[][] | The cells forwarded to the underlying Table component. The dimensions of the array include the frozen rows and columns. Only the cells of the body are filled, as the rendering of the header cells depend on more information, present in the metaData. |
columnHeaderIndices | { hierarchyIndex: number; levelIndex: number; }[] | Represents the level corresponding to each frozen row of the column header. |
columnIndexImpactingRowStyle | number | The index of the column whose conditional formatting impacts full rows, if applicable. |
columnsAxis | Axis | undefined | |
cube | Cube | |
data | CellSet | |
defaultMeasure | DefaultMember | |
hierarchyIndicesInCellSet | HierarchyIndicesInCellSet | |
indexOfMeasureOnSlicer | number | |
isRowHeaderTree | boolean | |
loadedRange | GridRange | |
mapping | DataVisualizationWidgetMapping | |
memberPropertyKeys | string[] | |
numberOfColumnsInBody | number | |
numberOfFrozenColumns | number | |
numberOfFrozenRows | number | |
numberOfRowsInBody | number | |
rowHeaderIndices | { hierarchyIndex: number; levelIndex: number; }[] | |
rowsAxis | Axis | |
slicerAxis | Axis | |
sort | { orderMode: OrderMode | undefined; tupleCoordinates?: TupleCoordinates; levelCoordinates?: LevelCoordinates; } | |
staticHeaderCoordinatesOnColumns | TableStaticHeaderCoordinates[] | |
staticHeaderCoordinatesOnRows | TableStaticHeaderCoordinates[] | |
staticHeadersOnColumns | TableStaticHeader[] | |
staticHeadersOnRows | TableStaticHeader[] | |
styleImpactingRows | MeasureStyle | The style of the measure impacting full rows, if applicable. |
areFrozenColumnsIgnored | boolean | If the table is resized and becomes so thin that frozen columns would be larger than its total width, then they can be ignored so that the user can still scroll horizontally in order to see the columns to the right. This prop allows to control this behavior. |
isExpandable | (tuple: Tuple) => boolean | |
isExpanded | (tuple: TupleCoordinates) => boolean | |
onExpansionChanged | (tuple: Tuple, toLevel: LevelCoordinates, isExpanding: boolean) => void | |
onSortChanged | () => void | |
widgetState | DataVisualizationWidgetState |
CurriedDrillthroughTableCellProps
The props of cells in drillthrough table that are curried by the DrillthroughTable Component.
Property | Type | Description |
---|---|---|
headerCaptions | DrillthroughDataSetHeaderCell[] | |
headerValues | DrillthroughDataSetHeaderCell[] | |
onSortChanged | () => void | |
sort | { orderMode: "ASC" | "DESC"; drillthroughColumnUniqueName: string; } | |
widgetState | DrillthroughTableWidgetState |
CustomFilter
Property | Type | Description |
---|---|---|
mdx | T extends "deserialized" ? MdxExpression : string | |
type | "custom" |
DashboardContent
The content of a dashboard file on the Content Server.
Omit<DashboardState<"serialized">, "name">
DashboardLoadedAction
Redux action to change the state of the dashboard when it is loaded.
Property | Type | Description |
---|---|---|
dashboardState | DashboardState | |
type | "dashboardLoaded" |
DashboardMetaData
The content of a dashboard meta data file on the Content Server, representing this dashboard in the dashboards tree.
DashboardPageState
The state of a dashboard page. content
contains the state of each leaf. layout
represents how they are laid out.
{
content: {
[leafKey: string]: WidgetStateType;
};
filters?: Filter<T>[];
queryContext?: QueryContextEntry[];
layout: Layout;
name: string;
}
DashboardSavedAction
Redux action to mark the current dashboard as saved. It does not actually save the action on the Content Server. See dashboard
and lastSavedDashboardHash
in State.
Property | Type | Description |
---|---|---|
dashboardState | DashboardState | |
type | "dashboardSaved" |
DashboardState
The state of a dashboard. pages
contains the state of each page.
{
filters?: Filter<T>[];
queryContext?: QueryContextEntry[];
name?: string;
pages: {
[pageKey: string]: DashboardPageState<T>;
};
pagesOrder: string[];
}
DashboardUnloadedAction
Redux action to unload the dashboard. This action resets the undo/redo history. See dashboard
in State.
Property | Type | Description |
---|---|---|
type | "dashboardUnloaded" |
DashboardUpdatedAction
Redux action to change the state of the dashboard. See dashboard
in State.
Property | Type | Description |
---|---|---|
dashboardState | DashboardState | |
newSelectedWidget | { leafKey: string; pageKey: string; } | |
type | "dashboardUpdated" |
DataModel
Describes the data contained in a server.
Property | Type | Description |
---|---|---|
catalogs | T extends "raw" ? Catalog<"raw">[] : { [catalogName: string]: Catalog<"indexed">; } | |
contextValues | T extends "raw" ? ContextValueDefinition[] : { [contextValueDefinitionName: string]: ContextValueDefinition; } |
DataModelClickListener
A listener on data model tree clicks, called whenever a node is clicked in the DataModelTree.
(node: DataModelNode<T>) => void
DataModelNode
A data model tree node
- T extends "with-hierarchy-folders" ? LegacyDataModelNode<T>
- HierarchyFolderNode : LegacyDataModelNode
DataOverrides
Plotly overrides relative to the traces.
Property | Type | Description |
---|---|---|
additionalTraces | Trace[] | |
commonTraceOverride | Partial<Trace> | |
overridesByTraceIndex | Partial<Trace>[] | |
overridesByTraceKey | { [traceKey: string]: Partial<Trace>; } |
DataVisualizationMappingField
A field in a data visualization widget's mapping.
- AllMeasuresInMapping
- MeasureInMapping
- KpiPropertyInMapping
- HierarchyInMapping
- CompositeHierarchyInMapping
- NamedSetInMapping
DataVisualizationStyle
Style attributes of a data visualization widget.
Property | Type | Description |
---|---|---|
measures | { [measureName: string]: MeasureStyle; } | |
tupleImpactingRowStyle | TupleCoordinates | |
tuples | { [tupleKey: string]: CSSProperties; } |
DataVisualizationWidgetMapping
The attributes to fields mapping, specific to a given type of data visualization widget. Contains deserialized fields.
For example:
{
rows: [
{
type: "hierarchy",
dimensionName: "Currency",
hierarchyName: "Currency",
levelName: "Currency"
}
]
}
DataVisualizationWidgetState
Property | Type | Description |
---|---|---|
areFiltersDrivenByMdx | boolean | Whether the filters applied to the query when it is sent to the server are driven by: 1. widgetState.query.mdx (when true). It allows users to write filters as they like in the query editor. 2. dashboardState.filters , pageState.filters and widgetState.filters (when false). It allows a single source of truth for dashboard and page filters, preventing bugs.Defaults to false.In practice it is set to true when the user submits an MDX query in the query editor. It it set to false when filters are changed using other UI elements, such as the content or filter editor. |
query | Partial<Query<T extends "serialized" ? MdxString : MdxType>> | |
serverKey | string | |
shouldUseDefaultColumns | MdxType extends MdxDrillthrough ? boolean : never | Whether the columns specified in the drillthrough.defaultSelectedColumns setting are used in the drillthrough query. It is useful when performing a drillthrough from another widget, as it allows to create the drillthrough widget right away, while triggering the query only once the default columns have been fetched. |
mapping | T extends "serialized" ? SerializedDataVisualizationWidgetMapping : DataVisualizationWidgetMapping | |
style | Style | |
switchedTo | string |
DefaultContextValue
Property | Type | Description |
---|---|---|
name | string | |
value | string |
DefaultMember
Property | Type | Description |
---|---|---|
captionPath | string[] | |
dimension | DimensionName | |
hierarchy | HierarchyName | |
path | string[] |
DerivedCellSetTableBodyCellProps
The props specific to body cells in a CellSetTable.
Property | Type | Description |
---|---|---|
properties | { [key in CellProperty]?: null | string | number | undefined; } | |
tuple | Tuple | null |
DerivedCellSetTableHeaderCellProps
The props specific to header cells in a CellSetTable.
Property | Type | Description |
---|---|---|
headerDepth | number | |
hierarchyIndex | number | |
levelIndex | number | |
positionIndex | number | |
tuple | Tuple | null |
DerivedCellSetTableStaticHeaderCellProps
The props specific to static header cells in a CellSetTable.
Property | Type | Description |
---|---|---|
staticHeaderCoordinates | TableStaticHeaderCoordinates |
Dimension
Property | Type | Description |
---|---|---|
caption | string | |
defaultHierarchy | HierarchyName | |
description | string | |
hierarchies | T extends "raw" ? Hierarchy<"raw">[] : { [hierarchyName: string]: Hierarchy<"indexed">; } | |
measureGroups | string[] | |
name | DimensionName | |
type | string | |
visible | boolean |
DimensionName
The readable name of a dimension in a cube.
string
For example:
const dimensionName = 'Geography';
DimensionNode
A data model tree node representing a dimension
Property | Type | Description |
---|---|---|
caption | string | |
dragItem | any | |
isActionable | boolean | |
isDisabled | boolean | |
isFolder | boolean | |
cubeName | string | |
serverKey | string | |
children | (T extends "with-hierarchy-folders" ? HierarchyNode | HierarchyFolderNode : HierarchyNode)[] | |
dimension | Dimension | |
type | "dimension" |
DrillthroughColumn
The drillthrough column as described by the server
Property | Type | Description |
---|---|---|
caption | string | |
name | DrillthroughColumnUniqueName | |
type | "String" | "double" | "int" | "long" | "LocalDate" | "LocalDateTime" | "Object" | |
visible | boolean |
DrillthroughColumnUniqueName
A unique identifier for a drillthrough column.
string
DrillthroughDataSet
Property | Type | Description |
---|---|---|
headers | DrillthroughDataSetHeaderCell[] | |
rows | DrillthroughDataSetRow[] |
DrillthroughDataSetCell
- string
- number
- Record<string, unknown>
DrillthroughDataSetHeaderCell
Drillthrough's result column header description as returned by the server
Property | Type | Description |
---|---|---|
caption | string | |
name | string | |
type | "String" | "double" | "int" | "long" | "LocalDate" | "LocalDateTime" | "Object" |
DrillthroughDataSetRow
DrillthroughResult
Drillthrough query result as returned by the server
Property | Type | Description |
---|---|---|
epoch | number | |
result | DrillthroughDataSet |
DrillthroughSelection
A selection of cells and/or headers in a DrillthroughResult.
Property | Type | Description |
---|---|---|
columns | { header: DrillthroughDataSetHeaderCell; cells: DrillthroughDataSetCell[]; }[] | |
headers | DrillthroughDataSetHeaderCell[] |
DrillthroughTableCellProps
The props of cells in a drillthrough table
CellProps & CurriedDrillthroughTableCellProps
DrillthroughTableWidgetState
- WidgetWithQueryState<MdxDrillthrough> & {
initialCubeName?: CubeName;
columnWidths?: {
[drillthroughColumnUniqueName: string]: number;
}; sort?: { orderMode: "ASC" - "DESC"; drillthroughColumnUniqueName: string; }; style?: TableWidgetStyle; }
EditorProps
Props received by content and style editors.
ActionProps<WidgetState>
ElementType
Used for switching when visiting
- "Drillthrough"
- "Select"
- "SubSelect"
- "Axis"
- "CaseExpression"
- "CompoundIdentifier"
- "Formula"
- "Function"
- "From"
- "Identifier"
- "Literal"
- "MemberPropertyDefinition"
- "When"
ExpandDataModelTreeAction
Redux action to expand the data model tree. See isDataModelTreeExpanded
in State.
Property | Type | Description |
---|---|---|
type | "expandDataModelTree" |
ExpandedFolderPathsInHomePageAction
Redux action to expand and collapse folders on the homepage. See expandedFolderPathsInHomePage
in State.
Property | Type | Description |
---|---|---|
expandedFolderPathsInHomePage | string[][] | |
type | "expandedFolderPathsInHomePageUpdated" |
ExpansionAction
An action of expansion in a tree.
Property | Type | Description |
---|---|---|
path | number[] | the path to the node that the user interacted with |
type | "expand" | "collapse" | whether the node was expanded or collapsed |
ExtensionModule
The entrypoint module of an Atoti UI extension.
Property | Type | Description |
---|---|---|
activate | (params: Configuration) => Promise<void> |
FieldUniqueName
- "ALL_MEASURES"
- LevelUniqueName
- MeasureUniqueName
- KpiPropertyIdentifier
- "namedSet"
FileListMenuItemProps
Property | Type | Description |
---|---|---|
contentTree | ContentRecord | |
contentType | ContentType | |
onAfterSubmit | OnAfterSubmit | |
onEditStarted | (id: string) => void | |
pathToParentFolder | string[] | |
selectedFilesAndFolders | ({ id: string; record: ContentRecord<AMetaData>; } | { doesRepresentServer: true; })[] |
Filter
- FilterOnMembers
- FilterOnDateRange<T>
- FilterOnTimePeriodToDate
- FilterOnRecentDates
- FilterOnTopBottomMembers
- FilterOnLowerOrGreaterValues
- FilterOnValuesRange
- FilterOnLowerOrGreaterCaptions
- FilterOnCaptionsRange
- FilterOnCaptionContaining
- FilterOnExistenceOfValue
- CustomFilter<T>
FilterMetaData
The content of a filter meta data file on the Content Server, representing a filter in the filters tree.
{
name: string;
isFolder?: boolean;
}
FilterOnCaptionContaining
A filter on the members of a level of a hierarchy with a caption starting, ending, containing (or not) the given string.
Property | Type | Description |
---|---|---|
containingMode | ContainingMode | |
levelName | LevelName | |
token | string | |
type | "captionsContaining" |
For example:
Filter on employees with a last name alphabetically containing "son".
FilterOnCaptionsRange
A filter on the members of a level of a hierarchy with a caption alphabetically between the given limits.
Property | Type | Description |
---|---|---|
isBetween | boolean | |
levelName | LevelName | |
lowerToken | string | |
type | "captionsRange" | |
upperToken | string |
For example:
Filter on employees with a last name alphabetically between "L" and "O".
FilterOnDateRange
A filter on a range of dates (only available for hierarchies of type time
).
Property | Type | Description |
---|---|---|
endDate | T extends "deserialized" ? Date : string | |
isRollingDate | boolean | |
levelName | LevelName | |
startDate | T extends "deserialized" ? Date : string | |
type | "dateRange" |
For example:
Filter on transactions between "2021/12/01" and "2021/12/20".
FilterOnExistenceOfValue
A filter on the members of a level of a hierarchy with an existing value for the given measure.
Property | Type | Description |
---|---|---|
doesExist | boolean | |
levelName | LevelName | |
measureName | MeasureName | |
type | "existenceOfValue" |
For example:
Filter on countries with a known GDP.
FilterOnLowerOrGreaterCaptions
A filter on the members of a level of a hierarchy with a caption alphabetically before or after a given limit.
Property | Type | Description |
---|---|---|
levelName | LevelName | |
lowerOrGreaterMode | LowerOrGreaterMode | |
token | string | |
type | "lowerOrGreaterCaptions" |
For example:
Filter on employees with a last name alphabetically after "H".
FilterOnLowerOrGreaterValues
A filter on the members of a level of a hierarchy with a value of a given measure lower or greater than a defined limit.
Property | Type | Description |
---|---|---|
levelName | LevelName | |
lowerOrGreaterLimit | number | |
lowerOrGreaterMode | LowerOrGreaterMode | |
measureName | MeasureName | |
type | "lowerOrGreaterValue" |
For example:
Filter on countries with a GDP above 500B$.
FilterOnMembers
A filter on explicitly defined members of a hierarchy.
Property | Type | Description |
---|---|---|
members | string[][] | |
type | "members" |
For example:
Filter on Currency = Dollar
FilterOnRecentDates
Property | Type | Description |
---|---|---|
levelName | LevelName | |
numberOfRecentDates | number | |
type | "recentDates" |
FilterOnTimePeriodToDate
A filter on a range of dates from the beginning of the selected time period (for example month, quarter or year) to the current date. Only available for hierarchies of type time
.
Property | Type | Description |
---|---|---|
levelName | LevelName | |
timePeriod | TimePeriod | |
type | "timePeriodToDate" |
For example:
Filter on transactions between the first day of the current year and today.
FilterOnTopBottomMembers
A filter on the n members of a level of a hierarchy with the lowest or highest value for a measure.
Property | Type | Description |
---|---|---|
levelName | LevelName | |
limit | number | |
measureName | MeasureName | |
scope | FilterScope | |
topBottomMode | TopBottomMode | |
type | "topBottomMembers" |
For example:
Filter on the 3 best selling products of each category
FilterOnValuesRange
A filter on the members of a level of a hierarchy with a value of a given measure between or outside the given limits.
Property | Type | Description |
---|---|---|
isBetween | boolean | |
levelName | LevelName | |
lowerLimit | number | |
measureName | MeasureName | |
type | "valuesRange" | |
upperLimit | number |
For example:
Filter on countries with a GDP between 200 and 500B$.
FilterScope
- "overall"
- "ofEachParent"
FilterType
- "members"
- "topBottomMembers"
- "lowerOrGreaterValue"
- "valuesRange"
- "lowerOrGreaterCaptions"
- "captionsRange"
- "captionsContaining"
- "existenceOfValue"
- "dateRange"
- "timePeriodToDate"
- "recentDates"
- "custom"
FormulaType
- "SET"
- "MEMBER"
GenericIndenter
Property | Type | Description |
---|---|---|
indent | (needSpace?: boolean) => string | |
newLine | (needSpace?: boolean) => string | |
unindent | () => void |
GridRange
A Range of cells in a table grid.
Property | Type | Description |
---|---|---|
columns | Range | |
rows | Range |
Hierarchy
Property | Type | Description |
---|---|---|
caption | string | |
description | string | |
folder | string | |
levels | T extends "raw" ? Level<"raw">[] : { [levelName: string]: Level<"indexed">; } | |
maxNbResultsPerSearch | number | The maximum number of cells returned by the server when looking up members from the hierarchy, to avoid performance issues. Only applicable for virtual hierarchies. See virtual. |
name | HierarchyName | |
slicing | boolean | |
virtual | boolean | Whether the hierarchy is implemented as "virtual" or not on the server. Virtual hierarchies have a high cardinality, and their members are not represented in memory on the server. This limits what operations can be done on them, in particular when querying them through MDX. |
visible | boolean |
HierarchyCoordinates
The dimension and hierarchy names identifying a hierarchy in a cube.
Property | Type | Description |
---|---|---|
dimensionName | DimensionName | |
hierarchyName | HierarchyName |
For example:
const hierarchyCoordinates = {
dimensionName: 'Geography',
hierarchyName: 'City'
};
HierarchyFolderNode
A data model tree node representing a hierarchy folder.
Property | Type | Description |
---|---|---|
caption | string | |
dragItem | any | |
isActionable | boolean | |
isDisabled | boolean | |
isFolder | boolean | |
cubeName | string | |
serverKey | string | |
children | (HierarchyNode | HierarchyFolderNode)[] | |
type | "hierarchyFolder" |
HierarchyIndicesInCellSet
A map of hierarchy unique names to the index of the axis where the hierarchy can be found in cellSet.axes
and its own index in axis.hierarchies
.
HierarchyInMapping
A tile in the widget mapping, representing a hierarchy.
Property | Type | Description |
---|---|---|
expandedDownTo | LevelName | |
type | "hierarchy" |
HierarchyName
The readable name of a hierarchy in a cube.
string
For example:
const hierarchyName = 'City';
HierarchyNode
A data model tree node representing a hierarchy
Property | Type | Description |
---|---|---|
caption | string | |
dragItem | any | |
isActionable | boolean | |
isDisabled | boolean | |
isFolder | boolean | |
cubeName | string | |
serverKey | string | |
dimension | Dimension | |
hierarchy | Hierarchy | |
type | "hierarchy" |
HierarchyUniqueName
A string representing the unique identifier of a hierarchy in a cube.
string
For example:
const hierarchyUniqueName = '[Geography].[City]';
HighlightedCaptionProps
Property | Type | Description |
---|---|---|
caption | string | |
className | string | |
isDisabled | boolean | |
searchValue | string |
InternalNode
Represents a node in a tree.
NodeType & {
path: number[];
parentNames: string;
}
IsDeferredAction
Redux action to toggle deferred updates. See isDeferred
in State.
Property | Type | Description |
---|---|---|
isDeferred | boolean | |
type | "isDeferredChanged" |
IsOpenDashboardPopupVisibleAction
Redux action to change whether the 'Open Dashboard' popup is visible. See isOpenDashboardPopupVisible
in State.
Property | Type | Description |
---|---|---|
type | "openDashboardPopupOpened" | "openDashboardPopupClosed" |
IsPresentingAction
Redux action to change whether the application is displayed in "Present" mode. See isPresenting
in State.
Property | Type | Description |
---|---|---|
isPresenting | boolean | |
type | "isPresentingChanged" |
IsSettingsPopupVisibleAction
Redux action to change whether the 'Settings' popup is visible. See isSettingsPopupVisible
in State.
Property | Type | Description |
---|---|---|
type | "settingsPopupOpened" | "settingsPopupClosed" |
Kpi
Property | Type | Description |
---|---|---|
caption | string | |
description | string | |
expiry | string | |
folder | string | |
goal | string | |
name | string | |
start | string | |
status | string | |
statusPresenter | string | |
trend | string | |
value | string |
KpiComparison
KpiFolderNode
A data model tree node representing a folder of kpis
Property | Type | Description |
---|---|---|
caption | string | |
dragItem | any | |
isActionable | boolean | |
isDisabled | boolean | |
isFolder | boolean | |
cubeName | string | |
serverKey | string | |
children | KpiNode[] | |
type | "kpiFolder" |
KpiNode
A data model tree node representing a kpi
Property | Type | Description |
---|---|---|
caption | string | |
dragItem | any | |
isActionable | boolean | |
isDisabled | boolean | |
isFolder | boolean | |
cubeName | string | |
serverKey | string | |
children | KpiPropertyNode[] | |
type | "kpi" |
KpiProperty
Property | Type | Description |
---|---|---|
kpiName | string | |
kpiPropertyName | KpiPropertyName | |
underlyingMeasureName | MeasureName |
KpiPropertyIdentifier
string
For example:
KPIStatus("my KPI"): pnl.SUM
KpiPropertyInMapping
A tile in the widget mapping, representing a KPI property.
Property | Type | Description |
---|---|---|
kpiName | string | |
propertyName | KpiPropertyName | |
type | "kpiProperty" | |
underlyingMeasureName | MeasureName |
KpiPropertyName
- "KPIValue"
- "KPIGoal"
- "KPIStatus"
- "KPITrend"
- "KPIStart"
- "KPIExpiry"
KpiPropertyNode
A data model tree node representing a kpi property, such as its status
Property | Type | Description |
---|---|---|
caption | string | |
dragItem | any | |
isActionable | boolean | |
isDisabled | boolean | |
isFolder | boolean | |
cubeName | string | |
serverKey | string | |
kpiName | string | |
kpiPropertyName | KpiPropertyName | |
underlyingMeasureName | MeasureName | |
type | "kpiProperty" |
KpisRootNode
A data model tree node representing a kpisRoot
Property | Type | Description |
---|---|---|
caption | string | |
dragItem | any | |
isActionable | boolean | |
isDisabled | boolean | |
isFolder | boolean | |
cubeName | string | |
serverKey | string | |
children | (KpiFolderNode | KpiNode)[] | |
type | "kpisRoot" |
KpiWidgetState
Property | Type | Description |
---|---|---|
areFiltersDrivenByMdx | boolean | Whether the filters applied to the query when it is sent to the server are driven by: 1. widgetState.query.mdx (when true). It allows users to write filters as they like in the query editor. 2. dashboardState.filters , pageState.filters and widgetState.filters (when false). It allows a single source of truth for dashboard and page filters, preventing bugs.Defaults to false.In practice it is set to true when the user submits an MDX query in the query editor. It it set to false when filters are changed using other UI elements, such as the content or filter editor. |
query | Partial<Query<T extends "serialized" ? MdxString : MdxType>> | |
serverKey | string | |
shouldUseDefaultColumns | MdxType extends MdxDrillthrough ? boolean : never | Whether the columns specified in the drillthrough.defaultSelectedColumns setting are used in the drillthrough query. It is useful when performing a drillthrough from another widget, as it allows to create the drillthrough widget right away, while triggering the query only once the default columns have been fetched. |
mapping | T extends "serialized" ? SerializedDataVisualizationWidgetMapping : DataVisualizationWidgetMapping | |
style | Style | |
switchedTo | string | |
comparison | KpiComparison | |
titles | { [tupleKey: string]: string; } |
Layout
Atoti UI dashboard page layout Tree of widgets, not necessarily binary. Allows a more intuitive widget resizing behavior than the ActiveUI 4 binary layout.
Property | Type | Description |
---|---|---|
children | (Layout | LayoutLeaf)[] | |
direction | "column" | "row" | |
size | number |
LayoutLeaf
Property | Type | Description |
---|---|---|
leafKey | string | |
size | number |
LegacyDataModelNode
- CatalogNode
- CubeNode
- DimensionNode<T>
- HierarchyNode
- KpiPropertyNode
- KpiNode
- KpiFolderNode
- KpisRootNode
- LevelNode
- MeasuresFolderNode
- MeasuresRootNode
- MeasureNode
- ServerNode
- SetNode
- SetsRootNode
Level
{
name: LevelName;
caption: string;
description?: string;
type: string;
} &
(T extends "indexed" ? {
index: number;
} : unknown)
LevelCoordinates
The dimension, hierarchy and level names identifying a hierarchy in a cube.
HierarchyCoordinates & {
levelName: LevelName;
}
For example:
const hierarchyCoordinates = {
dimensionName: 'Geography',
hierarchyName: 'City',
levelName: 'City'
};
LevelName
The readable name of a level in a cube.
string
For example:
const levelName = 'City';
LevelNode
A data model tree node representing a level
Property | Type | Description |
---|---|---|
caption | string | |
dragItem | any | |
isActionable | boolean | |
isDisabled | boolean | |
isFolder | boolean | |
cubeName | string | |
serverKey | string | |
depth | number | |
dimension | Dimension | |
hierarchy | Hierarchy | |
level | Level | |
type | "level" |
LevelUniqueName
A string representing the unique identifier of a level in a cube.
string
For example:
const levelUniqueName = '[Geography].[City].[City]';
LoadingOverlayProps
The props provided to a loading overlay.
Property | Type | Description |
---|---|---|
className | string | |
isInitiallyVisible | boolean | |
isLoading | boolean | |
style | CSSProperties | |
timeBeforeContinueLoadingButtonAppears | number | |
tip | string |
LoadingTableCellProps
The props of cells in a CellSetTable, in cases such as undefined cube or undefined data.
CellProps & CurriedCellSetTableCellProps
LowerOrGreaterMode
- "Lower"
- "LowerOrEqual"
- "Greater"
- "GreaterOrEqual"
- "Equal"
- "NotEqual"
Mdx
The Abstract syntax tree of an MdxString.
- MdxExpression
- MdxAxis
- MdxFromClause
- MdxFormula
- MdxDrillthrough
- MdxMemberPropertyDefinition
- MdxSelect
- MdxSubSelect
- MdxWhenClause
MdxAxis
An Mdx representing an axis such as ROWS
or COLUMNS
and its associated expression.
Property | Type | Description |
---|---|---|
elementType | "Axis" | |
expression | MdxExpression | |
name | AxisName | |
nonEmpty | boolean | |
properties | Mdx[] |
MdxCaseExpression
An Mdx representing a CASE
statement.
Property | Type | Description |
---|---|---|
cases | MdxWhenClause[] | |
elementType | "CaseExpression" | |
elseExp | MdxExpression | |
match | MdxExpression | null | |
name | string |
MdxCompoundIdentifier
The subset of Mdxs that identify something using hierarchical dot notation, as in the MDX [Measures].[MyMeasure]
. Each segment is an MdxIdentifier.
- MdxUnknownCompoundIdentifier
- MdxDimensionCompoundIdentifier
- MdxHierarchyCompoundIdentifier
- MdxLevelCompoundIdentifier
- MdxMemberCompoundIdentifier
- MdxMeasureCompoundIdentifier
- MdxNamedSetCompoundIdentifier
MdxDimensionCompoundIdentifier
A MdxCompoundIdentifier that represents a dimension.
Property | Type | Description |
---|---|---|
elementType | "CompoundIdentifier" | |
identifiers | MdxIdentifier[] | |
dimensionName | DimensionName | |
type | "dimension" |
MdxDrillthrough
An Mdx representing a DRILLTHROUGH
statement.
Property | Type | Description |
---|---|---|
columns | MdxExpression[] | |
elementType | "Drillthrough" | |
firstRow | number | |
maxRows | number | |
select | MdxSelect |
MdxErrorDetails
Property | Type | Description |
---|---|---|
expected | string[] | |
from | { line: number; ch: number; } | |
text | string | |
to | { line: number; ch: number; } |
MdxExpression
The subset of Mdxs that can be used in expression contexts such as the expression of a calculated measure.
MdxFormula
An Mdx representing an formula definition in the WITH
clause of a MdxSelect. An example formula: WITH Member [Measures].[MyConstant] AS 42
.
Property | Type | Description |
---|---|---|
elementType | "Formula" | |
expression | MdxExpression | |
inlined | boolean | undefined | |
name | MdxNamedSetCompoundIdentifier | MdxMeasureCompoundIdentifier | MdxMemberCompoundIdentifier | MdxUnknownCompoundIdentifier | |
properties | MdxMemberPropertyDefinition[] | |
type | string |
MdxFromClause
An Mdx representing a named cube for the FROM
clause of a MdxSelect. Does not represent a subselect expression in a FROM
clause – that is represented by a MdxSubSelect instead.
Property | Type | Description |
---|---|---|
cubeName | CubeName | |
elementType | "From" |
MdxFunction
An Mdx representing a function call. Some functions are called with syntax that makes them look like an operator or part of the language; see Syntax for the different syntaxes for calling functions.
Property | Type | Description |
---|---|---|
arguments | MdxExpression[] | |
elementType | "Function" | |
name | string | |
syntax | Syntax |
MdxHierarchyCompoundIdentifier
A MdxCompoundIdentifier that represents a hierarchy.
Property | Type | Description |
---|---|---|
elementType | "CompoundIdentifier" | |
identifiers | MdxIdentifier[] | |
dimensionName | DimensionName | |
hierarchyName | HierarchyName | |
type | "hierarchy" |
MdxIdentifier
An Mdx representing an identifier – the name of a hierarchy, level, measure, KPI, etc. For example, this could represent the MDX Geography
or [Geography]
. A MdxCompoundIdentifier is made of these separated by dots.
Property | Type | Description |
---|---|---|
elementType | "Identifier" | |
quoting | Quoting | |
value | string |
MdxLevelCompoundIdentifier
A MdxCompoundIdentifier that represents a level.
Property | Type | Description |
---|---|---|
elementType | "CompoundIdentifier" | |
identifiers | MdxIdentifier[] | |
dimensionName | DimensionName | |
hierarchyName | HierarchyName | |
levelName | LevelName | |
type | "level" |
MdxLiteral
An Mdx representing a literal value such as a number or string.
Property | Type | Description |
---|---|---|
elementType | "Literal" | |
type | Argument | |
value | string |
MdxMeasureCompoundIdentifier
Property | Type | Description |
---|---|---|
elementType | "CompoundIdentifier" | |
identifiers | MdxIdentifier[] | |
measureName | MeasureName | |
type | "measure" |
MdxMemberCompoundIdentifier
A MdxCompoundIdentifier that represents a member.
Property | Type | Description |
---|---|---|
elementType | "CompoundIdentifier" | |
identifiers | MdxIdentifier[] | |
dimensionName | DimensionName | |
hierarchyName | HierarchyName | |
levelName | LevelName | |
path | string[] | |
type | "member" |
MdxMemberPropertyDefinition
An Mdx representing the definition of a property of a member that is defined in a MdxFormula. Some example property names are FORE_COLOR
and FONT_FLAGS
.
Property | Type | Description |
---|---|---|
elementType | "MemberPropertyDefinition" | |
expression | MdxExpression | |
name | string |
MdxNamedSet
Property | Type | Description |
---|---|---|
caption | string | |
cube | CubeName | |
description | string | |
expression | MdxString | |
name | AxisName | |
serverUrl | string | |
type | "namedSet" |
MdxNamedSetCompoundIdentifier
A MdxCompoundIdentifier that represents a named set.
Property | Type | Description |
---|---|---|
elementType | "CompoundIdentifier" | |
identifiers | MdxIdentifier[] | |
setName | SetName | |
type | "namedSet" |
MdxOrderFunction
An MdxFunction that represents a call to the [Order
function](https://docs.microsoft.com/en-us/sql/mdx/order-mdx).
- MdxFunction & MdxFunction & { arguments: [MdxExpression, MdxExpression, OrderModeMdxLiteral]
- [MdxExpression, MdxExpression]; name: "Order"; }
MdxSelect
An Mdx representing a SELECT statement.
Property | Type | Description |
---|---|---|
axes | MdxAxis[] | |
cellProps | string[] | |
elementType | "Select" | |
from | MdxSubSelect | MdxFromClause | |
slicerAxis | MdxSlicerAxis | null | |
withClause | MdxFormula[] |
MdxSlicerAxis
MdxAxis & {
name: "SLICER";
}
MdxString
A string representing an [MDX](https://en.wikipedia.org/wiki/MultiDimensional\_eXpressions) query or a part of one.
string
For example:
const mdx = 'SELECT\n [Measures].[contributors.COUNT] ON COLUMNS\n FROM [EquityDerivativesCube]';
For example:
const mdx = '[Measures].[contributors.COUNT]';
For example:
const mdx = '"a string in MDX"';
For example:
const mdx = '123';
MdxSubSelect
An Mdx representing a subselect expression.
Property | Type | Description |
---|---|---|
axes | MdxAxis[] | |
elementType | "SubSelect" | |
from | MdxSubSelect | MdxFromClause | |
nonVisual | boolean | |
slicerAxis | MdxSlicerAxis | null |
MdxUnknownCompoundIdentifier
A MdxCompoundIdentifier representing an unknown identifier.
Property | Type | Description |
---|---|---|
elementType | "CompoundIdentifier" | |
identifiers | MdxIdentifier[] | |
type | "unknown" |
Remarks:
This type is used for any MDX compound identifier whose type cannot be identified. It is the case for all compound identifiers in the raw result of parsing an MDX string. It can then be further refined by confronting it to the dataModel and calling getSpecificCompoundIdentifier
.
MdxWhenClause
An Mdx representing a WHEN
clause of a MdxCaseExpression, including the clause’s THEN
true result expression.
Property | Type | Description |
---|---|---|
elementType | "When" | |
then | MdxExpression | |
when | MdxExpression |
Measure
Property | Type | Description |
---|---|---|
caption | string | |
description | string | |
expression | string | |
folder | string | |
formatString | string | |
measureGroup | string | |
name | MeasureName | |
type | string | |
visible | boolean |
MeasureConditionalStyle
Contains the style for a measure and the conditions under which to apply it. The condition is described with 1 or 2 keys. When there are 2 keys, they are necessarily a pair of lt(e)/gt(e), matching all values between or outside 2 limits.
Property | Type | Description |
---|---|---|
eq | number | |
gt | number | |
gte | number | |
lt | number | |
lte | number | |
neq | number | |
style | CSSProperties |
MeasureGroup
Property | Type | Description |
---|---|---|
caption | string | |
description | string | |
name | string |
MeasureInMapping
A tile in the widget mapping, representing a measure.
Property | Type | Description |
---|---|---|
caption | string | Optional caption for query-scoped calculated measures. For regular measures, the caption defined in the cube is used. |
measureName | string | |
type | "measure" |
MeasureName
The readable name of a measure in a cube.
string
For example:
const measureName = 'pnl.SUM';
MeasureNode
A data model tree node representing a measure
Property | Type | Description |
---|---|---|
caption | string | |
dragItem | any | |
isActionable | boolean | |
isDisabled | boolean | |
isFolder | boolean | |
cubeName | string | |
serverKey | string | |
measure | Measure | |
type | "measure" |
MeasuresFolderNode
A data model tree node representing a measuresFolder
Property | Type | Description |
---|---|---|
caption | string | |
dragItem | any | |
isActionable | boolean | |
isDisabled | boolean | |
isFolder | boolean | |
cubeName | string | |
serverKey | string | |
children | (MeasureNode | MeasuresFolderNode)[] | |
type | "measuresFolder" |
MeasuresRootNode
A data model tree node representing a measuresRoot
Property | Type | Description |
---|---|---|
caption | string | |
dragItem | any | |
isActionable | boolean | |
isDisabled | boolean | |
isFolder | boolean | |
cubeName | string | |
serverKey | string | |
type | "measuresRoot" |
MeasureStyle
The style applied to the values of a Measure in the target widget.
Property | Type | Description |
---|---|---|
conditional | MeasureConditionalStyle[] | |
dateFormat | string | |
default | CSSProperties | |
justifyContent | CSSProperties["justifyContent"] | |
numberFormat | NumberFormat | |
numberOfDecimals | number |
MeasureUniqueName
A string representing the unique identifier of a measure in a cube.
string
For example:
const measureUniqueName = '[Measures].[pnl.SUM]';
Member
Property | Type | Description |
---|---|---|
captionPath | string[] | |
namePath | string[] | |
properties | { [key: string]: any; } | Properties attached to each member in CellSet positions.In Atoti UI, these properties are used in table header cells to: - Display extra information on hover. - Infer whether the cell is expandable.See https://learn.microsoft.com/en-us/analysis-services/multidimensional-models/mdx/mdx-member-properties?view=asallproducts-allversions |
MemberCoordinates
Coordinates identifying a Member.
HierarchyCoordinates & {
namePath: string[];
}
MenuItemPlugin
Plugin useful for items in the context menus of widgets or in the top right widget menu.
Property | Type | Description |
---|---|---|
key | string | |
translations | { [locale: string]: TranslationTree<string>; } | |
doesContextMenuCloseOnClick | boolean | Whether clicking the menu item closes the context menu. true by default. |
useMenuItem | (props: MenuItemProps<WidgetState, SelectionType>) => Omit<MenuItemType | SubMenuType, "key"> | undefined |
MenuItemProps
ActionProps<WidgetState, SelectionType>
NamedSetInMapping
A tile in the widget mapping, representing a named set.
Property | Type | Description |
---|---|---|
name | string | |
type | "namedSet" |
NodeIconProps
Property | Type | Description |
---|---|---|
node | InternalNode<NodeType> | |
style | CSSProperties |
NodeProps
Property | Type | Description |
---|---|---|
caretStyle | CSSProperties | |
contextMenuItems | ItemType[] | |
data | InternalNode<NodeType>[] | |
getDefaultCaption | (node?: NodeType) => string | |
hasCheckbox | boolean | |
hasSelectedChildren | boolean | |
hoverStyle | CSSProperties | |
Icon | ComponentType<NodeIconProps<NodeType>> | null | |
index | number | |
isEdited | boolean | |
isExpandable | boolean | |
isExpanded | boolean | |
isFocused | boolean | |
isPopoverOpen | boolean | |
isSelected | boolean | |
onClick | (item: InternalNode<NodeType>, event: ReactMouseEvent<HTMLDivElement>) => void | |
onEditCanceled | () => void | |
onEditEnded | (path: number[], caption: string) => void | |
onEditStarted | (path: number[]) => void | |
onExpandToggled | (item: InternalNode<NodeType>, isExpanding: boolean) => void | |
popoverContent | JSX.Element | |
popoverInnerHeight | number | |
popoverTitle | string | |
searchValue | string | |
selectionStyle | CSSProperties | |
style | CSSProperties | |
tooltip | JSX.Element | |
tooltipDelay | number | |
trees | TreeObject<NodeType>[] |
NonEmptyEvaluationMeasureSetting
Controls the measure used to filter out empty members in the list presented to the user when creating or editing a filter on a hierarchy. Members with no value for this measure are considered empty and are omitted from this list.
This measure defaults to contributors.COUNT
, and can be configured: - globally, by defining the setting value as a single measure name - or on a per hierarchy basis, by defining the setting value as a map from hierarchy unique name to measure name. This map also has a special default
key, to define the measure that should be used for a hierarchy that is not expressed in the map.
- string
- Partial<{
[hierarchyUniqueName: string]: string;
default: string;
}>