Returns a member or tuple from the cube. Use to validate that the member or tuple exists in the cube.
Syntax: CUBEMEMBER(connection, member_expression, caption)
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 unique member in the cube. Alternatively, member_expression can be a tuple, specified as a cell range or an array constant.
caption is a text string displayed in the cell instead of the caption, if one is defined, from the cube. When a tuple is returned, the caption used is the one for the last member in the tuple.
- When the CUBEMEMBER function evaluates, it temporarily displays a “#GETTING_DATA…” message in the cell before all of the data is retrieved.
- When you use CUBEMEMBER as an argument to another CUBE function, the MDX expression that identifies the member or tuple is used by that CUBE function, not the displayed value in the cell of the CUBEMEMBER function.
- If the connection name is not a valid workbook connection stored in the workbook, CUBEMEMBER returns a #NAME? error value. If the Online Analytical Processing (OLAP) server is not running, not available, or returns an error message, CUBEMEMBER returns a #NAME? error value.
- If at least one element within the tuple is invalid, CUBEMEMBER returns a #VALUE! error value.
- If member_expression is longer than 255 characters, which is the limit for an argument to a function, CUBEMEMBER returns a #VALUE! error value. To use text strings longer than 255 characters, enter the text string in a cell (for which the limit is 32,767 characters), and then use a cell reference as the argument.
- CUBEMEMBER returns a #N/A error value when:
- The member_expression syntax is incorrect.
- The member specified by the MDX text string 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.
- CUBEMEMBER 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.)