Node
When you select a node
object in a derived property expression or a
sourceNode
object in a property transformation expression, you can
select node attributes depending on the data type of the node object:
- AllAncestors: All ancestor node objects, combined from all node locations, in the node set. For attributes, see Node List.
- Ancestors: Ancestor node objects for a node instance in the node set. For attributes, see Node List.
- BoundAncestors: In hierarchy set bound viewpoints, returns a list of ancestor nodes for a node in the bound viewpoint. In node type bound or unbound viewpoints, returns ancestor node objects for a node instance (the same result as when using Ancestors). For attributes, see Node List.
- BoundLocations: In hierarchy set bound viewpoints, returns a list of
locations for a node in the bound viewpoint. In node type bound or unbound
viewpoints, returns node locations (the same result as when using Locations).
Optional: Enable Exclude Implicit Shares to filter
the returned list of bound locations to only node instances under unique parents.
For attributes, see Node List.
Tip:
Using the bound versions of Ancestors and Locations enables you to access the full scope of the bound viewpoint when using an expression in a maintenance viewpoint. - Children: Child node objects for a node. For attributes, see Node List.
- CompareTo: Compare two node locations with these options:
SAME_LOCATION
: Node location is the same as a specified node locationSAME_PARENT_AND_NODE
: Node location has the same parent as a specified node locationSUBSET_LOCATION
: Node location has a set of contiguous ancestors that is the same as a specified node location
Tip:
This enables you to build an expression that returns different results based on a comparison of node locations. For example, you can derive the value of a Data Storage property as stored or shared based on whether a particular node is the first location in the hierarchy and whether it shares a parent or ancestors with other node locations.
- Dimension: Node dimension. You can select the
name
attribute. - HierarchySet: Identifies the hierarchy set of a node in a viewpoint. For a
hierarchy set, you can select the
name
attribute. - Locations: Node locations (can contain node instances).
- Optional: Enable Exclude Implicit Shares to filter the returned list of locations to only node instances under unique parents.
-
Optional: Enable Sort to return the locations in the order in which they appear in a hierarchy viewpoint. This allows business logic for shared nodes based on hierarchy order to be implemented. For example, you can create a derived Data Storage property for Planning dimensions which assigns the first member instance a Stored value and other member instances in the hierarchy a Shared value.
For attributes, see Node List.
- Name: Node name. For attributes, see Strings, Numeric Strings, and Sequences.
- NextSibling: Node sibling after a node in the hierarchy. If this is the last
node, then the
NextSibling
attribute returnsNull
. The parameters that you can add are:dimension
name
nodeType
properties
- NodeType: Node type for a node. For a node type, you can select the
name
attribute. - Parent: Node parent. Parent also has the node data type, which means that you can select other node attributes such as the dimension or the node type of the parent. However, you cannot select the parent of a parent.
- PreviousSibling: Node sibling before a node in the hierarchy. If this is a
first node without a previous sibling, then the
PreviousSibling
attribute returnsNull
. The parameters that you can add are:dimension
name
nodeType
properties
- Properties: Node properties. For attributes, see Properties.
- Siblings. Sibling node objects for a node instance. For attributes, see Node List.