Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.activeviam.com/llms.txt

Use this file to discover all available pages before exploring further.

addCalculatedMeasure

Returns a new MdxSelect corresponding to mdx where the given calculated measure was added. Does not mutate mdx.
addCalculatedMeasure(
  mdx,
  {
    calculatedMeasureName,
    expression,
    measureIndex,
    properties,
  },
  cube,
);
ArgumentTypeDescription
mdxMdxSelect
{
   calculatedMeasureName,
   expression,
   measureIndex,
   properties,
}
{
   calculatedMeasureName: string;
   expression: MdxExpression;
   measureIndex?: number;
   properties?: MdxMemberPropertyDefinition[];
}
cubeCube
Returns: MdxSelect

addLevel

Returns a new MdxSelect corresponding to mdx where the given level was added.
addLevel(mdx, {
  cube,
  dimensionName,
  hierarchyName,
  levelName,
  axisName,
  indexOnAxis,
  shouldCreateNonEmptyAxis,
  doesIncludeCalculatedMembers,
});
ArgumentTypeDescription
mdxMdxSelect
{
   cube,
   dimensionName,
   hierarchyName,
   levelName,
   axisName,
   indexOnAxis,
   shouldCreateNonEmptyAxis,
   doesIncludeCalculatedMembers,
}
{
   cube: Cube;
   dimensionName: DimensionName;
   hierarchyName: HierarchyName;
   levelName: LevelName;
   axisName?: AxisName;
   indexOnAxis?: number;
   shouldCreateNonEmptyAxis?: boolean;
   doesIncludeCalculatedMembers?: boolean;
}
Returns: MdxSelect

addMeasure

Returns a new MdxSelect corresponding to mdx where the given measure was added. Does not mutate mdx.
addMeasure(mdx, {
  cube,
  measureName,
  measureIndex,
  shouldCreateNonEmptyAxis,
  axisName,
});
ArgumentTypeDescription
mdxMdxSelect
{
   cube,
   measureName,
   measureIndex,
   shouldCreateNonEmptyAxis,
   axisName,
}
{
   cube: Cube;
   measureName: MeasureName;
   measureIndex?: number;
   shouldCreateNonEmptyAxis?: boolean;
   axisName?: AxisName;
}
Returns: MdxSelect

addPage

Adds a page to a dashboard and returns the updated dashboard state with the new page key. Does not mutate the dashboard state.
addPage(dashboardState, options);
ArgumentTypeDescription
dashboardStateDashboardState
options{
   page: DashboardPageState;
   key?: string;
   index?: number;
}
Returns: DashboardState

addWidget

Returns a new dashboard with the given widget added at the specified location. Does not mutate dashboard.
addWidget({
  dashboardState,
  initialWidgetState,
  layoutPath,
  pageKey,
  side,
});
ArgumentTypeDescription
{
   dashboardState,
   initialWidgetState,
   layoutPath,
   pageKey,
   side,
}
{
   dashboardState: DashboardState;
   initialWidgetState: AWidgetState;
   layoutPath: number[];
   pageKey: string;
   side: Side;
}
Returns: DashboardState

areHierarchiesEqual

Returns whether hierarchyCoordinatesA and hierarchyCoordinatesB represent the same hierarchy.
areHierarchiesEqual(hierarchyCoordinatesA, hierarchyCoordinatesB);
ArgumentTypeDescription
hierarchyCoordinatesAHierarchyCoordinates | undefined
hierarchyCoordinatesBHierarchyCoordinates | undefined
Returns: boolean

areLevelsEqual

Returns whether levelCoordinatesA and levelCoordinatesB represent the same level.
areLevelsEqual(levelCoordinatesA, levelCoordinatesB);
ArgumentTypeDescription
levelCoordinatesALevelCoordinates | undefined
levelCoordinatesBLevelCoordinates | undefined
Returns: boolean

areTuplesEqual

Returns whether tupleCoordinatesA and tupleCoordinatesB represent the same tuple
areTuplesEqual(tupleCoordinatesA, tupleCoordinatesB);
ArgumentTypeDescription
tupleCoordinatesATupleCoordinates | undefined
tupleCoordinatesBTupleCoordinates | undefined
Returns: boolean

collapse

Returns a new MdxSelect corresponding to mdx where the given tuple was collapsed. Does not mutate mdx.
collapse(mdx, {
  cube,
  tupleCoordinates,
});
ArgumentTypeDescription
mdxMdxSelect
{
   cube,
   tupleCoordinates,
}
{
   cube: Cube;
   tupleCoordinates: TupleCoordinates;
}
Returns: MdxSelect

createAtotiClient

Returns a new AtotiClient instance.
createAtotiClient(constructorArgs);
ArgumentTypeDescription
constructorArgsAtotiClientConstructorArgs
Returns: AtotiClient

createContentClient

Returns a new ContentClient instance.
createContentClient(constructorArguments);
ArgumentTypeDescription
constructorArgumentsContentClientConstructorArgs<Settings>
Returns: ContentClient<Settings>

createFilter

Returns the Filter represented by mdx (assuming that it represents a filter).
createFilter(mdx, {
  cube,
  nonVisualTotals,
});
ArgumentTypeDescription
mdxMdxExpression
{
   cube,
   nonVisualTotals
}
{
   cube: Cube;
   nonVisualTotals?: boolean;
}
Returns: Filter

createLevelCompoundIdentifier

Returns the MdxLevelCompoundIdentifier corresponding to the given level coordinates.
createLevelCompoundIdentifier({
  dimensionName,
  hierarchyName,
  levelName,
});
ArgumentTypeDescription
{
   dimensionName,
   hierarchyName,
   levelName,
}
LevelCoordinates
Returns: MdxLevelCompoundIdentifier

createMdxForFilter

Returns a new MdxExpression representing filter. Returns undefined for a filter on members where there are no members selected.
createMdxForFilter(filter, cube, options);
ArgumentTypeDescription
filterFilter
cubeCube
options{
   atotiServerVersion: string;
}
Returns: MdxExpression | undefined

deserializeDashboardState

Returns a new dashboard state where: - all MDX strings representing queries and filters are parsed and replaced by AST. - all data visualization widget mappings are deserialized. Does not mutate the passed dashboard state.
deserializeDashboardState(dashboardState);
ArgumentTypeDescription
dashboardStateDashboardState<“serialized”>
Returns: DashboardState<“deserialized”>

deserializeFilter

Deserializes a Filter, making it usable in Atoti UI.
deserializeFilter(filter);
ArgumentTypeDescription
filterFilter<“serialized”>
Returns: Filter<“deserialized”>

deserializeWidgetState

Accepts a serialized widgetState, as it is saved on a content server and returns its deserialized version, ready to live in the state of Dashboard.
deserializeWidgetState(widgetState);
ArgumentTypeDescription
widgetStateAWidgetState<“serialized”>
Returns: R

expand

Returns a new MdxSelect corresponding to mdx where the given tuple was expanded. Does not mutate mdx.
expand(mdx, {
  cube,
  tupleCoordinates,
  toLevel,
  doesIncludeCalculatedMembers,
});
ArgumentTypeDescription
mdxMdxSelect
{
   cube,
   tupleCoordinates,
   toLevel,
   doesIncludeCalculatedMembers,
}
{
   cube: Cube;
   tupleCoordinates: TupleCoordinates;
   toLevel: LevelCoordinates;
   doesIncludeCalculatedMembers?: boolean;
}
Returns: MdxSelect

fetchTranslations

Asynchronously returns the Atoti UI translations for locale.
fetchTranslations(locale);
ArgumentTypeDescription
localestring
Returns: Promise<{ [key in string]: string; }>

findContentRecords

Returns the nodes in tree with the given ids, indexed by id.
findContentRecords(tree, ids, pathOrOptions);
ArgumentTypeDescription
treeContentRecord<T>
idsstring[]
pathOrOptionsstring[] | {
   includeFolders: boolean;
}
Returns: { [id: string]: { node: ContentRecord<T>; pathToParentFolder: string[]; }; }

findMappingFieldForHierarchy

Returns the coordinates of the DataVisualizationMappingField in mapping that corresponds to the given hierarchy. Returns undefined if the hierarchy is not expressed in the mapping.
findMappingFieldForHierarchy(mapping, {
  dimensionName,
  hierarchyName,
});
ArgumentTypeDescription
mappingDataVisualizationWidgetMapping
{
   dimensionName,
   hierarchyName
}
HierarchyCoordinates
Returns: { attributeName: string; fieldIndex: number; type: “hierarchy”; } | { attributeName: string; fieldIndex: number; hierarchyIndex: number; type: “compositeHierarchy”; } | undefined

getActiveToolKey

Redux selector returning the key of the active tool tab. See activeToolKey in State.
getActiveToolKey(state);
ArgumentTypeDescription
stateState
Returns: string | undefined

getAntdTheme

Returns the Ant Desgin ThemeConfig based on the provided $Theme.
getAntdTheme(atotiTheme);
ArgumentTypeDescription
atotiThemeTheme
Returns: ThemeConfig

getCalculatedMeasures

Returns the expression of each calculated measure defined in mdx.
getCalculatedMeasures(mdx);
ArgumentTypeDescription
mdxMdxSelect | MdxDrillthrough
Returns: { [measureName: string]: MdxFormula; }

getContentNodes

Returns the nodes useful to display a ContentTree.
getContentNodes(structure, options);
ArgumentTypeDescription
structureContentRecord<T>
options{
   areFilesVisible: boolean;
   getDragItem?: (id: string, metaData: T) => void;
}
Returns: TreeObject<ContentNode<T>>[]

getContentRecordAtPath

Returns the ContentRecord at path in tree.
getContentRecordAtPath({
  tree,
  path,
});
ArgumentTypeDescription
{
   tree,
   path,
}
{
   tree?: ContentRecord<MetaData, T> | null;
   path?: string[];
}
Returns: ContentRecord<MetaData, T> | undefined

getCube

Returns the cube identified by cubeName in dataModel.
getCube(dataModel, cubeName);
ArgumentTypeDescription
dataModelDataModel
cubeNameCubeName
Returns: Cube

getCubeName

Returns the name of the cube used in mdx, if any.
getCubeName(mdx);
ArgumentTypeDescription
mdxMdxSelect | MdxSubSelect | MdxDrillthrough | MdxFromClause
Returns: CubeName

getDashboardState

Redux selector returning the state of the dashboard. See dashboard in State.
getDashboardState(state);
ArgumentTypeDescription
stateState
Returns: DashboardState | undefined

getDimension

Returns the dimension identified by dimensionName in cube.
getDimension(dimensionName, cube);
ArgumentTypeDescription
dimensionNameDimensionName
cubeCube
Returns: Dimension

getDrillthroughColumns

Returns the DrillthroughColumnUniqueName of each drillthrough column in mdx.
getDrillthroughColumns(mdx);
ArgumentTypeDescription
mdxMdxDrillthrough
Returns: DrillthroughColumnUniqueName[]

getExpandedFolderPathsInHomePage

Redux selector returning the expanded folder paths of the homepage. See expandedFolderPathsInHomePage in State.
getExpandedFolderPathsInHomePage(state);
ArgumentTypeDescription
stateState
Returns: string[][]

getExpandedTuples

Returns the drilled down tuples in mdx.
getExpandedTuples(mdx, cube);
ArgumentTypeDescription
mdxMdxSelect | MdxAxis
cubeCube
Returns: { tupleCoordinates: TupleCoordinates; toLevel: LevelCoordinates; }[]

getFilters

Returns the filters expressed in mdx.
getFilters(mdx, {
  cube,
});
ArgumentTypeDescription
mdxMdxSelect | MdxSubSelect | MdxDrillthrough
{
   cube
}
{
   cube: Cube;
}
Returns: { mdx: MdxExpression; paths: (string | number)[][]; nonVisualTotals?: boolean; }[]

getHasUnsavedChanges

Redux selector returning whether the dashboard has unsaved changes. See dashboard and lastSavedDashboardHash in State.
getHasUnsavedChanges(state);
ArgumentTypeDescription
stateState
Returns: boolean

getHierarchy

Returns the hierarchy identified by hierarchyCoordinates in cube.
getHierarchy(hierarchyCoordinates, cube);
ArgumentTypeDescription
hierarchyCoordinatesHierarchyCoordinates
cubeCube
Returns: Hierarchy

getIndexedDataModel

Transforms a dataModel into an indexed format where properties can be accessed by keys.
getIndexedDataModel(dataModel);
ArgumentTypeDescription
dataModelDataModel<“raw”>
Returns: DataModel<“indexed”>

getIsDeferred

Redux selector returning whether deferred updates are enabled. See isDeferred in State.
getIsDeferred(state);
ArgumentTypeDescription
stateState
Returns: boolean

getIsOpenDashboardPopupVisible

Redux selector returning whether the ‘Open Dashboard’ popup is visible. See isOpenDashboardPopupVisible in State.
getIsOpenDashboardPopupVisible(state);
ArgumentTypeDescription
stateState
Returns: boolean

getIsPresenting

Redux selector returning whether the application is displayed in “Present” mode. See isPresenting in State.
getIsPresenting(state);
ArgumentTypeDescription
stateState
Returns: boolean

getIsSettingsPopupVisible

Redux selector returning whether the ‘Settings’ popup is visible. See isSettingsPopupVisible in State.
getIsSettingsPopupVisible(state);
ArgumentTypeDescription
stateState
Returns: boolean

getIsWidgetsPanelVisible

Redux selector returning whether the widgets panel is visible. See isWidgetsPanelVisible in State.
getIsWidgetsPanelVisible(state);
ArgumentTypeDescription
stateState
Returns: boolean

getLayoutPath

Returns the layoutPath of the widget identified by leafKey in layout.
getLayoutPath(layout, leafKey);
ArgumentTypeDescription
layoutLayout
leafKeystring
Returns: number[]

getLevel

Returns the level identified by levelCoordinates in cube.
getLevel(levelCoordinates, cube);
ArgumentTypeDescription
levelCoordinatesLevelCoordinates
cubeCube
Returns: Level

getLevels

Returns the coordinates of every level used in mdx.
getLevels(mdx, {
  cube,
});
ArgumentTypeDescription
mdxMdx
{
   cube
}
{
   cube: Cube;
}
Returns: LevelCoordinates[]

getMeasure

Returns the measure identified by measureName in cube.
getMeasure(measureName, cube);
ArgumentTypeDescription
measureNamestring
cubeCube
Returns: Measure

getMeasureNames

Returns the names of the measures used in the axes of mdx. Does not return duplicate measures.
getMeasureNames(mdx);
ArgumentTypeDescription
mdxMdxSelect | MdxDrillthrough
Returns: MeasureName[]

getMetaData

Returns a file’s metadata content, useful to display its corresponding node in a ContentTree. Throws a MissingMetaDataError if the record is missing for the given id. Throws an InvalidMetaDataError if the name attribute is missing.
getMetaData(node, id);
ArgumentTypeDescription
nodeContentRecord<MetaData>
idstring
Returns: MetaData

getMetaDataRecord

Returns a file’s metadata record, containing information about when and by whom this file was saved and who can access it.
getMetaDataRecord(node, id);
ArgumentTypeDescription
nodeContentRecord<MetaData, T>
idstring
Returns: ContentRecord<MetaData, T>

getNode

Returns a reference to the node at the given path
getNode(tree, path);
ArgumentTypeDescription
treeTreeObject<T> | TreeObject<T>[]
pathnumber[]
Returns: TreeObject<T>

getOwnersAndReaders

Returns the ContentEntry owners and readers corresponding to the given permissions. - Permissions of type “editor” are converted to “owners”. - Permissions of type “reader” are converted both to “owners” and “readers”. - The current user is added both as “owner” and “reader”.
getOwnersAndReaders(permissions, currentUserName);
ArgumentTypeDescription
permissionsPermission[]
currentUserNamestring
Returns: { owners: string[]; readers: string[]; }

getOwnersAndReadersForNewFile

Returns the ContentEntry owners and readers for a new file or folder. The reasoning is as follows: - if the user is not allowed to share, then she is the only owner/reader for the file being created and is not allowed to edit those permissions. - if the user is allowed to share.. - ..and is saving at the root, then she is initially the only owner/reader for the file being created, but is allowed to edit those permissions. - ..and is saving under a folder with doesInheritParentFolderPermissions set to true, then the file being created initially inherits the permissions of that folder, and its permissions are editable.
getOwnersAndReadersForNewFile({
  currentUserName,
  canShare,
  parentFolderOwners,
  parentFolderReaders,
  isParentFolderRoot,
  doesInheritParentFolderPermissions,
});
ArgumentTypeDescription
{
   currentUserName,
   canShare,
   parentFolderOwners,
   parentFolderReaders,
   isParentFolderRoot,
   doesInheritParentFolderPermissions,
}
{
   currentUserName: string;
   canShare: boolean;
   parentFolderOwners: string[];
   parentFolderReaders: string[];
   isParentFolderRoot: boolean;
   doesInheritParentFolderPermissions?: boolean;
}
Returns: { owners: string[]; readers: string[]; }

getPage

Returns the page with the specified key in the dashboard.
getPage(dashboardState, pageKey);
ArgumentTypeDescription
dashboardStateDashboardState | null | undefined
pageKeystring | null
Returns: DashboardPageState | undefined

getParentPaths

Returns the paths to the parents of the nodes identified by the given paths
getParentPaths(paths);
ArgumentTypeDescription
pathsT[][]
Returns: T[][]

getPluginsTranslations

Returns the translations of all plugins for the given locale
getPluginsTranslations(plugins, locale);
ArgumentTypeDescription
plugins{
   [key in PluginType]?: PluginsOfType<APlugin>;
} | null
localestring
Returns: { [key in string]: string; }

getPrefixedLocalStorageKey

Returns key, prefixed with the application’s name, in order to avoid conflicts on the domain where it is deployed.
getPrefixedLocalStorageKey(key);
ArgumentTypeDescription
keystring
Returns: string

getResourcesPanelKey

Redux selector returning the key of the currently open resources panel. See resourcesPanelKey in State.
getResourcesPanelKey(state);
ArgumentTypeDescription
stateState
Returns: “data-model” | “widgets” | “filters”

getSelectedLeafKey

Redux selector returning the key of the selected widget, identifying it in its parent dashboard page. See widgetSelection in State. It is useful to retrieve the selected widget state.
getSelectedLeafKey(state, activePageKey);
ArgumentTypeDescription
stateState
activePageKeystring | undefined
Returns: string | undefined For example:
import { useSelector } from "react-redux";
import { getWidget } from "@activeviam/atoti-ui-sdk"

const dashboardState = useSelector(getDashboardState);
const activePageKey = useActivePageKeyFromUrl();
const selectedLeafKey = useSelector((state) =>
 getSelectedLeafKey(state, activePageKey),
);
const selectedWidgetState = getWidget(dashboardState, activePageKey, selectedLeafKey);

getSelectionWithinWidgets

Redux selector returning the selected elements within each widget in the dashboard. See selectionWithinWidget in State.
getSelectionWithinWidgets(state);
ArgumentTypeDescription
stateState
Returns: SelectionWithinWidgets

getSort

Returns the OrderMode defining the sort and the LevelCoordinates if it is alphabetical or the TupleCoordinates if it is numerical. Returns undefined if mdx is not sorted.
getSort(mdx, {
  cube,
});
ArgumentTypeDescription
mdxMdxSelect
{
   cube
}
{
   cube: Cube;
}
Returns: ({ orderMode: OrderMode; } & ({ tupleCoordinates: TupleCoordinates; } | { levelCoordinates: LevelCoordinates; })) | undefined

getStatusNotifications

Redux selector return the state corresponding to the status notifications of the current asynchronous actions. See statusNotifications in State.
getStatusNotifications(state);
ArgumentTypeDescription
stateState
Returns: StatusNotification[]

getTargetCube

Returns the serverKey, dataModel and cube targeted by the given cubeName and/or serverKey. If neither serverKey nor cubeName are defined, defaults to the last cube the user used if it is still valid, and the first cube of the first provided server otherwise. If only cubeName is defined, uses the serverKey from lastUsedCube if it is still valid. Else defaults to the first server containing a cube with that name. If only serverKey is defined, uses the cubeName from lastUsedCube if it is still valid. Else defaults to the first cube from that server.
getTargetCube({
  dataModels,
  serverKey,
  cubeName,
  lastUsedCube,
});
ArgumentTypeDescription
{
   dataModels,
   serverKey,
   cubeName,
   lastUsedCube,
}
{
   dataModels: {
     [serverKey: string]: DataModel;
  };
   serverKey?: string;
   cubeName?: CubeName;
   lastUsedCube?: {
     cubeName: CubeName;
     serverKey: string;
  } | null;
}
Returns: { cube: Cube; dataModel: DataModel; serverKey: string; }

getToolsTranslations

Returns the translations of all tools for the given locale.
getToolsTranslations(tools, locale);
ArgumentTypeDescription
toolsTool[] | null
localestring
Returns: { [key in string]: string; }

getUserFromJwt

Extracts the user name and roles from an Atoti server sandbox authentication token.
getUserFromJwt(jwt);
ArgumentTypeDescription
jwtstring
Returns: User

getUserRoles

DeprecatedUse getUserFromJwt instead.
Decodes the user roles from the authentication token.
getUserRoles(token);
ArgumentTypeDescription
tokenstring
Returns: string[]

getWidget

Returns the widget with the specified key in the page at the specified index of the dashboard.
getWidget(dashboardState, pageKey, leafKey);
ArgumentTypeDescription
dashboardStateDashboardState | null | undefined
pageKeystring | null
leafKeystring | null
Returns: AWidgetState | undefined

getWidgetQuery

A function returning the widget’s Query impacted by the user, dashboard, page and widget filters and query contexts.
getWidgetQuery(widgetState, {
  dashboardState,
  pageKey,
  queryRanges,
  userFilters,
  userQueryContext,
  dataModels,
  lastUsedCube,
  filtersFromFoldersBySection,
  atotiServerVersion,
});
ArgumentTypeDescription
widgetStateWidgetWithQueryState<MdxType>
{
   dashboardState,
   pageKey,
   queryRanges,
   userFilters,
   userQueryContext,
   dataModels,
   lastUsedCube,
   filtersFromFoldersBySection,
   atotiServerVersion,
}
{
   dashboardState?: DashboardState;
   pageKey?: string;
   queryRanges?: Partial<{
     [axisId in AxisId]: QueryRange;
  }>;
   userFilters?: Filter[];
   userQueryContext?: QueryContextEntry[];
   dataModels: {
     [serverKey: string]: DataModel;
  };
   lastUsedCube?: {
     cubeName: CubeName;
     serverKey: string;
  } | null;
   filtersFromFoldersBySection?: {
     [sectionName: string]: Filter[];
  };
   atotiServerVersion?: string;
}
Returns: Query<MdxString> | undefined

isActionInDashboard

An action can be used in or outside a dashboard. Some actions make sense in any context (e.g. “sort the current widget”). Some others only make sense in a dashboard (e.g. “remove widget”). This function returns whether the action is being used in a dashboard.
isActionInDashboard(props);
ArgumentTypeDescription
propsActionProps<WidgetState, SelectionType, LowLevelSelectionType>
Returns: props is WidgetInDashboardActionProps<WidgetState, SelectionType, LowLevelSelectionType>

isBodyCell

Returns whether props represent a body cell in a cellset table.
isBodyCell(props);
ArgumentTypeDescription
propsCellSetTableCellProps
Returns: props is CellSetTableBodyCellProps

isHeaderCell

Returns whether props represent a header cell in a cellset table.
isHeaderCell(props);
ArgumentTypeDescription
propsCellSetTableCellProps
Returns: props is CellSetTableHeaderCellProps

isLevelNode

Returns whether node is a LevelNode. If hierarchyCoordinates is provided, returns whether node is a $LevelNode representing a level of this hierarchy.
isLevelNode(node, hierarchyCoordinates);
ArgumentTypeDescription
nodeDataModelNode
hierarchyCoordinatesHierarchyCoordinates
Returns: node is LevelNode

isStaticHeaderCell

Returns whether props represent a static header cell in a cellset table.
isStaticHeaderCell(props);
ArgumentTypeDescription
propsCellSetTableCellProps
Returns: props is CellSetTableStaticHeaderCellProps

isTotal

Determines whether the member is a total given its hierarchy
isTotal(hierarchy, member);
ArgumentTypeDescription
hierarchyHierarchy
memberMemberCoordinates | Member
Returns: boolean

isWidgetInDashboard

Returns whether props are the properties of a widget in a dashboard. In this case, it contains a “dashboardState” and a “pageKey” attribute.
isWidgetInDashboard(props);
ArgumentTypeDescription
propsWidgetPluginProps<T, SelectionType, Elements, LowLevelSelectionType>
Returns: props is WidgetPluginInDashboardProps<T, SelectionType, Elements, LowLevelSelectionType>

isWidgetWithQueryState

Returns whether widgetState is a WidgetWithQueryState.
isWidgetWithQueryState(widgetState);
ArgumentTypeDescription
widgetStateAWidgetState<T>
Returns: widgetState is WidgetWithQueryState<MdxType, T>

moveAllMeasures

Returns a new MdxSelect corresponding to mdx where all measures were moved to indexOnAxis on the axis with axisName. Does not mutate mdx.
moveAllMeasures(mdx, {
  axisName,
  cube,
  indexOnAxis,
  shouldCreateNonEmptyAxis,
});
ArgumentTypeDescription
mdxMdxSelect
{
   axisName,
   cube,
   indexOnAxis,
   shouldCreateNonEmptyAxis,
}
{
   axisName?: AxisName;
   cube: Cube;
   indexOnAxis?: number;
   shouldCreateNonEmptyAxis?: boolean;
}
Returns: MdxSelect

moveLevel

Returns a new MdxSelect corresponding to mdx where the given level is moved at indexOnAxis on the axis with axisName. Does not mutate mdx.
moveLevel(mdx, {
  cube,
  dimensionName,
  hierarchyName,
  levelName,
  axisName,
  indexOnAxis,
  shouldCreateNonEmptyAxis,
});
ArgumentTypeDescription
mdxMdxSelect
{
   cube,
   dimensionName,
   hierarchyName,
   levelName,
   axisName,
   indexOnAxis,
   shouldCreateNonEmptyAxis,
}
{
   cube: Cube;
   dimensionName: DimensionName;
   hierarchyName: HierarchyName;
   levelName: LevelName;
   axisName?: AxisName;
   indexOnAxis: number;
   shouldCreateNonEmptyAxis?: boolean;
}
Returns: MdxSelect

moveMeasure

Returns a new MdxSelect corresponding to mdx where the given measure was moved to measureIndex. Does not mutate mdx.
moveMeasure(mdx, options);
ArgumentTypeDescription
mdxMdxSelect
options{
   cube: Cube;
   measureName: MeasureName;
   measureIndex: number;
   shouldCreateNonEmptyAxis?: boolean;
}
Returns: MdxSelect

moveWidget

Returns a new dashboard with the given widget moved from the specified origin to the specified target. When the moved widget was the last one on its origin page (i.e. moving across pages empties the origin page), the origin page is reset to emptyPageState so that it remains usable. Does not mutate dashboard.
moveWidget({
  dashboardState,
  originLayoutPath,
  pageKey,
  originPageKey: _originPageKey,
  targetPageKey: _targetPageKey,
  side,
  targetLayoutPath,
  emptyPageState,
});
ArgumentTypeDescription
{
   dashboardState,
   originLayoutPath,
   pageKey,
   originPageKey: _originPageKey,
   targetPageKey: _targetPageKey,
   side,
   targetLayoutPath,
   emptyPageState,
}
{
   dashboardState: DashboardState;
   originLayoutPath: number[];
   pageKey?: string;
   originPageKey?: string;
   targetPageKey?: string;
   side: Side;
   targetLayoutPath: number[];
   emptyPageState?: Omit<DashboardPageState, “name”>;
}
Returns: DashboardState

opacitize

Returns the rgba color corresponding to the given color with the given opacity. CSS custom property references (e.g. var(--atoti-color-0)) are returned as-is, since their actual value is resolved by the browser at render time.
opacitize(color, opacity);
ArgumentTypeDescription
colorColor
opacitynumber
Returns: Color

parse

Returns the Mdx abstract syntax tree corresponding to mdxString
parse(mdxString);
ArgumentTypeDescription
mdxStringMdxString
Returns: T Throws: MdxError when mdxString does not represent a valid Mdx query.

ping

Pings the server at the given URL.
ping(serverUrl, serviceVersion, options);
ArgumentTypeDescription
serverUrlstring
serviceVersionServiceVersion
optionsRequestInit
Returns: Promise<void>

quote

Converts an array of strings into the corresponding stringified Mdx compound identifier.
quote(path);
ArgumentTypeDescription
pathstring[]
Returns: MdxString For example:
quote("a", "b"); // === '[a].[b]'

removeAllMeasures

Returns a new MdxSelect corresponding to mdx where all measures were removed. Does not mutate mdx.
removeAllMeasures(mdx, {
  cube,
  shouldRemoveCalculatedMeasureExpression,
});
ArgumentTypeDescription
mdxMdxSelect
{
   cube,
   shouldRemoveCalculatedMeasureExpression,
}
{
   cube: Cube;
   shouldRemoveCalculatedMeasureExpression?: boolean;
}
Returns: MdxSelect

removeLevel

Returns a new MdxSelect corresponding to mdx where the given level was removed. Does not mutate mdx
removeLevel(mdx, {
  cube,
  dimensionName,
  hierarchyName,
  levelName,
});
ArgumentTypeDescription
mdxMdxSelect
{
   cube,
   dimensionName,
   hierarchyName,
   levelName,
}
{
   cube: Cube;
   dimensionName: string;
   hierarchyName: string;
   levelName: string;
}
Returns: MdxSelect

removeMeasure

Returns a new MdxSelect corresponding to mdx where the given measure was removed. Does not mutate mdx.
removeMeasure(mdx, {
  cube,
  measureName,
  shouldRemoveCalculatedMeasureExpression,
});
ArgumentTypeDescription
mdxMdxSelect
{
   cube,
   measureName,
   shouldRemoveCalculatedMeasureExpression,
}
{
   cube: Cube;
   measureName: string;
   shouldRemoveCalculatedMeasureExpression?: boolean;
}
Returns: MdxSelect

removePage

Returns a new DashboardState corresponding to dashboardState from which the page identified by pageKey was removed. Does not mutate dashboardState.
removePage(dashboardState, pageKey);
ArgumentTypeDescription
dashboardStateDashboardState
pageKeystring
Returns: DashboardState

removeSort

Returns a new MdxSelect corresponding to mdx, unsorted. Does not mutate mdx. This function removes both Order functions and ReverseHierarchize functions (sorting for Atoti Server >= 6.0.28 or >= 6.1.15). When removing ReverseHierarchize, the expression is wrapped with Hierarchize to restore the hierarchical ordering.
removeSort(mdx);
ArgumentTypeDescription
mdxMdxSelect
Returns: MdxSelect

removeWidget

Returns a new dashboard with the widget at the specified location removed. When the removed widget was the last one on its page, the page is reset to emptyPageState so that it remains usable. emptyPageState defaults to a blank page with no widgets. Does not mutate dashboard.
removeWidget({
  dashboardState,
  layoutPath,
  pageKey,
  leafKey,
  emptyPageState,
});
ArgumentTypeDescription
{
   dashboardState,
   layoutPath,
   pageKey,
   leafKey,
   emptyPageState,
}
{
   dashboardState: DashboardState;
   layoutPath: number[];
   pageKey: string;
   leafKey: string;
   emptyPageState?: Omit<DashboardPageState, “name”>;
}
Returns: DashboardState Returns the matches corresponding to searchValue within list. Uses a fuzzy search algorithm. See https://fusejs.io/.
search(list, searchValue, options);
ArgumentTypeDescription
listT[]
searchValuestring
optionsPartial<FuseOptions<T>> & {
   limit?: number;
}
Returns: ((T & { score: number; }) | T)[]

serializeDashboardState

Returns a new dashboard state where: - all MDX AST objects of filters and queries are replaced by their stringified versions - all data visualization widget mappings are serialized. Does not mutate the passed dashboard state.
serializeDashboardState(dashboardState);
ArgumentTypeDescription
dashboardStateDashboardState<“deserialized”>
Returns: DashboardState<“serialized”>

serializeFilter

Serializes a Filter, making it lighter to store on the Content Server.
serializeFilter(filter);
ArgumentTypeDescription
filterFilter<“deserialized”>
Returns: Filter<“serialized”>

serializeWidgetState

Accepts a deserialized widgetState, as it lives in the state of Dashboard and returns its serialized version, ready to be saved on a content server.
serializeWidgetState(widgetState, options);
ArgumentTypeDescription
widgetStateAWidgetState<“deserialized”>
options{
   indent?: boolean;
}
Returns: AWidgetState<“serialized”>

setCubeName

Returns a new MdxSelect or MdxDrillthrough corresponding to mdx with cubeName updated as required. Does not mutate mdx.
setCubeName(mdx, {
  cubeName,
});
ArgumentTypeDescription
mdxMdxSelect | MdxDrillthrough
{
   cubeName
}
{
   cubeName: string;
}
Returns: MdxSelect | MdxDrillthrough

setDrillthroughColumns

Returns a new MdxDrillthrough corresponding to mdx. The columns in the returned MDX are set to the drillthrough columns corresponding to drillthroughColumnUniqueNames. Does not mutate mdx.
setDrillthroughColumns(mdx, {
  drillthroughColumnUniqueNames,
});
ArgumentTypeDescription
mdxMdxDrillthrough
{
   drillthroughColumnUniqueNames,
}
{
   drillthroughColumnUniqueNames: DrillthroughColumnUniqueName[];
}
Returns: MdxDrillthrough

setFilters

Returns a new MdxSelect or MdxDrillthrough corresponding to mdx where the filters were set to filters. Does not mutate mdx.
setFilters(mdx, {
  filters,
  cube,
});
ArgumentTypeDescription
mdxMdxSelect | MdxDrillthrough
{
   filters,
   cube,
}
{
   filters: (MdxExpression | {
     mdx: MdxExpression;
     nonVisualTotals?: boolean;
  })[];
   cube: Cube;
}
Returns: MdxSelect | MdxDrillthrough

setSort

Returns a new MdxSelect corresponding to mdx, sorted as specified. Does not mutate mdx.
setSort(mdx, {
  cube,
  levelCoordinates,
  orderMode,
  tupleCoordinates,
  serverVersion,
});
ArgumentTypeDescription
mdxMdxSelect
{
   cube,
   levelCoordinates,
   orderMode,
   tupleCoordinates,
   serverVersion,
}
{
   cube: Cube;
   levelCoordinates?: LevelCoordinates;
   orderMode: OrderMode;
   tupleCoordinates?: TupleCoordinates;
   serverVersion?: string;
}
Returns: MdxSelect

sortTree

Returns a new tree, corresponding to tree recursively sorted using comparator. Does not mutate tree.
sortTree(tree, comparator);
ArgumentTypeDescription
treeTreeObject<NodeType>[]
comparator(nodeA: NodeType, nodeB: NodeType) => number
Returns: TreeObject<NodeType>[]

stringify

Returns the Mdx string corresponding to mdx
stringify(mdx, options, indenter);
ArgumentTypeDescription
mdxMdx
options{
   indent?: boolean;
}
indenterGenericIndenter
Returns: MdxString

traverseMdx

Walks through mdx recursively and calls callback on each node. If callback explicitly returns false when evaluated on a node, the function execution is stopped, and false is returned.
traverseMdx(mdx, callback, path);
ArgumentTypeDescription
mdxMdx | null | undefined | Mdx[]
callback(mdx: Mdx, path: (string | number)[]) => boolean | void
path(string | number)[]
Returns: boolean | void

unquote

Converts a stringified Mdx compound identifier into the corresponding array of strings.
unquote(str);
ArgumentTypeDescription
strMdxString
Returns: string[] For example:
unquote("[a].[b]"); // === ['a', 'b']

updatePage

Updates the page with the specified key in the dashboard. Does not mutate dashboard.
updatePage(dashboardState, pageKey, updater);
ArgumentTypeDescription
dashboardStateDashboardState
pageKeystring
updater(page: DashboardPageState) => void
Returns: DashboardState

updateWidget

Updates the widget with the specified key in the specified page in the dashboard. Does not mutate dashboard.
updateWidget(
  dashboardState,
  {
    pageKey,
    leafKey,
  },
  updater,
);
ArgumentTypeDescription
dashboardStateDashboardState
{
   pageKey,
   leafKey,
}
{
   pageKey: string;
   leafKey: string;
}
updater(widget: WidgetState) => WidgetState
Returns: DashboardState

withDefaultCellStyle

Provides style to the underlying table cell Component.
withDefaultCellStyle(CellComponent);
ArgumentTypeDescription
CellComponentForwardRefExoticComponent<T & RefAttributes<HTMLDivElement>>
Returns: ForwardRefExoticComponent<PropsWithoutRef<T> & RefAttributes<HTMLDivElement>>

withLazyLoadedQueryResult

Runs the widget’s query and provides its result to the underlying component. Also provides the query’s lazy loading ranges and a callback to change them. Requires the underlying widget plugin to have a widgetPlugin.lazyLoading attribute, containing the chunkSizes it should load.
withLazyLoadedQueryResult(WrappedComponent);
ArgumentTypeDescription
WrappedComponentComponentType<WidgetWithQueryProps<WidgetState, CellSet, Selection, Elements, LowLevelSelection>>
Returns: ComponentType<WidgetPluginProps<WidgetState, Selection, Elements, LowLevelSelection>>

withQueryResult

Runs the widget’s query and provides its result to the underlying component.
withQueryResult(WrappedComponent);
ArgumentTypeDescription
WrappedComponentComponentType<WidgetWithQueryProps<WidgetState, CellSet, Selection, Elements, LowLevelSelection>>
Returns: ComponentType<WidgetPluginProps<WidgetState, Selection, Elements, LowLevelSelection> & { queryRanges?: Partial<{ [axisId in AxisId]: QueryRange; }>; onQueryRangesChanged?: (newQueryRanges: Partial<{ [axisId in AxisId]: QueryRange; }>) => void; }>

withWidgetLoadingBar

Displays a loading bar above a widget if a query is taking a while to load.
withWidgetLoadingBar(WrappedComponent);
ArgumentTypeDescription
WrappedComponentForwardRefExoticComponent<T & RefAttributes<HTMLDivElement>>
Returns: ForwardRefExoticComponent<PropsWithoutRef<T> & RefAttributes<HTMLDivElement>>