Returns an aggregated value from the cube.
Syntax: CUBEVALUE(connection, member_expression1, member_expression2…)
connection is a text string of the name of the connection to the cube.
member_expression is a text string of a multidimensional expression (MDX) that evaluates to a member or tuple within the cube. Alternatively, member_expression can be a set defined with the CUBESET function. Use member_expression as a slicer to define the portion of the cube for which the aggregated value is returned. If no measure is specified in member_expression, the default measure for that cube is used.
- When the CUBEVALUE function evaluates, it temporarily displays a “#GETTING_DATA…” message in the cell before all of the data is retrieved.
- If a cell reference is used for member_expression, and that cell reference contains a CUBE function, then member_expression uses the MDX expression for the item in the referenced cell, and not the value displayed in that referenced cell.
- If the connection name is not a valid workbook connection stored in the workbook, CUBEVALUE returns a #NAME? error value. If the Online Analytical Processing (OLAP) server is not running, not available, or returns an error message, CUBEVALUE returns a #NAME? error value.
- If at least one element within the tuple is invalid, CUBEVALUE returns a #VALUE! error value.
- CUBEVALUE returns a #N/A error value when:
- The member_expression syntax is incorrect.
- The member specified by member_expression doesn’t exist in the cube.
- The tuple is invalid because there is no intersection for the specified values. (This can occur with multiple elements from the same hierarchy.)
- The set contains at least one member with a different dimension than the other members.
- CUBEVALUE may return a #N/A error value if you reference a session-based object, such as a calculated member or named set, in a PivotTable when sharing a connection, and that PivotTable is deleted or you convert the PivotTable to formulas. (On the Options tab, in the Tools group, click OLAP Tools, and then click Convert to Formulas.)