DimensionTopElementInsert function for IBM Planning Analytics (TM1)

Where can the DimensionTopElementInsert function be used?

Which TM1 Server version is the DimensionTopElementInsert function available for?

What is the syntax for DimensionTopElementInsert?

• 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

Relevant Functions

• DimensionCreate = Creates a new dimension.
• DimensionDeleteAllElements = Deletes all elements in a dimension.
• DimensionDeleteElements = Deletes elements in a dimension based on a subset.
• DimensionDestroy = Deletes a dimension.
• DimensionElementComponentAdd = Adds an element to a consolidated element in a rollup according to a specific weight in a dimension. This action occurs after a commitment in the process (e.g. at the end of executing the metadata tab).
• DimensionElementComponentAddDirect = Adds an element to a consolidated element in a rollup according to a specific weight in a dimension. This function is actioned immediately.
• DimensionElementComponentDelete = Deletes an element from a consolidated element in a rollup. This action occurs after a commitment in the process (e.g. at the end of executing the metadata tab).
• DimensionElementComponentDeleteDirect = Deletes an element from a consolidated element. This function is actioned immediately.
• DimensionElementDelete = Deletes an element in a dimension. This action occurs after a commitment to the process (e.g., at the end of executing the metadata tab).
• DimensionElementDeleteDirect = Deletes an element directly in a dimension. This function is actioned immediately.
• DimensionElementExists = Checks whether a specific element exists in a dimension.
• DimensionElementInsert = Adds an element in a dimension. This action occurs after a commitment in the process (e.g. at the end of executing the metadata tab).
• DimensionElementInsertDirect = Adds an element in a dimension by directly editing a dimension. This function is actioned immediately.
• DimensionElementPrincipalName = Returns the principal name of an element or element alias.
• DimensionExists = Checks whether a dimension exists.
• DimensionHierarchyCreate = Creates a hierarchy in a dimension.
• DimensionSortOrder = Sorts the elements and components of consolidations within a dimension.
• DimensionTimeLastUpdated = Returns a serial value indicating the date and time when a dimension was last updated.
• DimensionTopElementInsert = Creates a root element in a dimension.
• DimensionTopElementInsertDirect = Creates a root element in a dimension by directly editing a dimension.
• DimensionUpdateDirect = Rewrites a dimension that has been edited with Dimension*Direct function(s) (e.g. DimensionElementInsertDirect) to reduce the memory utilised to edit the dimension.