- Advanced Excel Functions Tutorial
- Advanced Excel Functions - Home
- Compatibility Functions
- Advanced Excel Functions - Cube
- Database Functions
- Date & Time Functions
- Engineering Functions
- Financial Functions
- Information Functions
- Advanced Excel Functions - Logical
- Lookup & Reference Functions
- Math & Trignometric Functions
- Statistical Functions
- Useful Resources
- Quick Guide
- Useful Resources
- Discussion
Cube - CUBEMEMBER Function
Description
The CUBEMEMBER function returns a member or tuple from the cube. Use this function to validate that the member or tuple exists in the cube.
Syntax
CUBEMEMBER (connection, member_expression, [caption])
Arguments
| Argument | Description | Required/ Optional |
|---|---|---|
| connection | Name of the connection to the cube - A text string | Required |
| member_expression | A multidimensional expression (MDX) that evaluates to a unique member in the cube - A text string OR A tuple, specified as a cell range or an array constant |
Required |
| caption | 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. | Optional |
Notes
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 does not 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. The PivotTable is deleted or you can convert the PivotTable to formulas. (On the Options tab, in the Tools group, click OLAP Tools, and then click Convert to Formulas).
Applicability
Excel 2007, Excel 2010, Excel 2013, Excel 2016
Example
