DimensionElementInsert
DimensionElementInsert adds an element to a dimension. You can use this function to add numeric, string, or consolidated elements. You can't use this function in the Data or Epilog procedures of a TurboIntegrator process.
This function is valid in TM1® TurboIntegrator processes only.
Syntax
DimensionElementInsert(DimName, InsertionPoint, ElName,ElType);
Argument |
Description |
---|---|
DimName |
The dimension to which you want to add an element. |
InsertionPoint |
An existing dimension element. The element being added to the dimension will be inserted immediately before this existing element. If this parameter is an empty string (''), the new element is added to the end of the dimension. |
ElName |
The name that you want to assign to the new element. |
ElType |
The element type. There are three possible ElType values: N - Signifies a numeric element. S - Signifies a string element. C - Signifies a consolidated element. |
Example
DimensionElementInsert('Region','Belgium','Netherlands','S');
This example adds the string element Netherlands to the Region dimension. Netherlands is added immediately before Belgium in the dimension.
Example with an empty insertion point
DimensionElementInsert('Region','','Netherlands','S');
This example adds the string element Netherlands to the Region dimension. Netherlands is added to the end of the dimension.