TM1 Function for TI, ​DimensionTopElementInsertDirect

Creates a root element in a dimension by directly editing a dimension.

What is the DimensionTopElementInsertDirect function?

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

Where can the DimensionTopElementInsertDirect function be used?

TurboIntegrator

Which TM1 Server version is this function available for?

Version 11 and 12

What is the syntax for DimensionTopElementInsertDirect?

DimensionTopElementInsertDirect(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 DimensionTopElementInsertDirect

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