Changes and additions to native functions
The functions described in this section have been changed to support hierarchies.
Cube.ImportCells
The previous syntax addresses the default hierarchy for all dimensions. If the client adds the 'WithHierarchies="true"' attribute, the server expects a hierarchy and an element column instead of the element column alone for each dimension. Empty hierarchy columns address the default hierarchy.
Cube.GetCellNote, Cube.PutCellNote, Cube.DeleteCellNote
The Element tag can take an additional Hierarchy attribute to address a non-default hierarchy.
Cube.Read
In the single-value variant with a CellCoordinates tag having an Elements attribute can take an additional Hierarchies attribute listing the target hierarchies separated like the elements.
The data-query based variant receives additional hierarchy columns (as the expected input in Cube.ImportCells) in these cases:
- The underlying data area explicitly addresses a non-default hierarchy.
- The
DataQuerytag has the'WithHierarchies="true"'attribute.
In both cases, the returned CellBatch tag is marked through WithHierarchies="true".
Cube.DataareaCopy
The element specifications can have a Hierarchy attribute to address a non-default hierarchy. For the source of an element-to-element mapping the SourceHierarchy attribute is used.
Cube.DataareaDefine
Selectors and elements can carry a Hierarchy attribute to target a non-default hierarchy with the definition.
Cube.DataareaCalculateHash
If the underlying data area addresses non-default hierarchies, the hash is calculated using the concatenated hierarchy and element name instead of using only the element name, if they are part of the hash.