TM1 Function for TI, ​DimensionTopElementInsert

Creates a root element in a dimension.

What is the DimensionTopElementInsert function?

DimensionTopElementInsert creates a root element in a dimension. This can only be created if the dimension does not have a standalone root element. This action occurs after a commitment in the process (e.g. at the end of executing the metadata tab). To action this function immediately, use DimensionTopElementInsertDirect.

Where can the DimensionTopElementInsert function be used?


What is the syntax for DimensionTopElementInsert?

DimensionTopElementInsert(DimName, InsertionPoint, ElName)​;

​DimName = Dimension Name​
InsertionPoint = An existing element where the element is inserted before this element. If blank, the new element will be added as the last element in the dimension.​
ElName = Element Name

A demonstration on how to use DimensionTopElementInsert

Create a singular root element called, All Sales Territories, for the Sales Territory dimension