What's new Download Reportworq
⬇ Guide PDF

ELCOMP function#

ELCOMP returns the name of a child (component) of a consolidated element at a given index - the way to walk a consolidation's children.

ELCOMP is a native TM1 / Planning Analytics function.

Signature#

=ELCOMP("Server:Dimension", element, index)

Arguments#

# Argument Type Required Permitted values and notes
1 Server:Dimension String Yes "server:dimension".
2 element String Yes A consolidated element. A numeric value warns but is accepted.
3 index Integer Yes The child to return, 1-based. Must be a whole number of at least 1.

ELCOMP takes exactly three arguments. The default result is an empty string.

What happens when an argument is wrong#

For the shared error model and the Calc Mode effect, see how Reportworq handles errors.

Situation Result
More than three arguments Hard error
Fewer than three arguments Warning, blank
index is not numeric or cannot be parsed Hard error
index is less than 1 Warning, blank
The element is a string element Warning, blank - a string element has no children
The element is not consolidated Returns blank
index is greater than the number of children Warning, blank
Dimension or element not found Warning, blank

Examples#

=ELCOMP("PlanTM1:Region", "North America", 1)

Feedback on this page

Comments, questions, requests, or something missing or unclear? Email us - the page you are on is filled in for you.

Email feedback on this page

Or write to support@reportworq.com directly.