DNEXT function#
DNEXT returns the next element (by index) after a given element in a dimension - the way to walk a dimension in order.
DNEXT is a native TM1 / Planning Analytics function.
Signature#
=DNEXT("Server:Dimension", element)
Arguments#
| # | Argument | Type | Required | Permitted values and notes |
|---|---|---|---|---|
| 1 | Server:Dimension |
String | Yes | "server:dimension". |
| 2 | element |
String | Yes | Element name. A numeric value warns but is accepted. |
DNEXT takes exactly two 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 two arguments | Hard error |
| Fewer than two arguments | Warning, blank |
| The element is the last one in the dimension | Warning, blank - there is no next element |
| Dimension or element not found | Warning, blank |
Examples#
=DNEXT("PlanTM1:Period", "Jan")
Related pages#
- IBM Planning Analytics functions - the function index and the shared error model.
- DFRST function - the first element in a dimension.
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 pageOr write to support@reportworq.com directly.