This article describes the formula syntax and usage of the CUBEKPIMEMBER function in Microsoft Excel.
Description
Returns a key performance indicator (KPI) property and displays the KPI name in the cell. A KPI is a quantifiable measurement, such as monthly gross profit or quarterly employee turnover, that is used to monitor an organization's performance.
Note: The CUBEKPIMEMBER function is supported only when the workbook is connected to a Microsoft SQL Server 2005 Analysis Services or later data source.
Syntax
CUBEKPIMEMBER(connection, kpi_name, kpi_property, [caption])
The CUBEKPIMEMBER function syntax has the following arguments:
-
Connection Required. A text string of the name of the connection to the cube.
-
Kpi_name Required. A text string of the name of the KPI in the cube.
-
Kpi_property Required. The KPI component returned and can be one of the following:
Integer |
Enumerated constant |
Description |
1 |
KPIValue |
The actual value |
2 |
KPIGoal |
A target value |
3 |
KPIStatus |
The state of the KPI at a specific moment in time |
4 |
KPITrend |
A measure of the value over time |
5 |
KPIWeight |
A relative importance assigned to the KPI |
6 |
KPICurrentTimeMember |
A temporal context for the KPI |
-
If you specify KPIValue for kpi_property, only kpi_name is displayed in the cell.
-
Caption Optional. An alternative text string that is displayed in the cell instead of kpi_name and kpi_property.
Remarks
-
When the CUBEKPIMEMBER function evaluates, it temporarily displays a "#GETTING_DATA…" message in the cell before all of the data is retrieved.
-
To use the KPI in a calculation, specify the CUBEKPIMEMBER function as a member_expression argument in the CUBEVALUE function.
-
If the connection name is not a valid workbook connection that is stored in the workbook, CUBEKPIMEMBER returns a #NAME? error value. If the Online Analytical Processing (OLAP) server is not running, not available, or returns an error message, CUBEKPIMEMBER returns a #NAME? error value.
-
CUBEKPIMEMBER returns a #N/A error value when kpi_name or kpi_property is invalid.
-
CUBEKPIMEMBER 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.)
Examples
=CUBEKPIMEMBER("Sales","MySalesKPI",1)
=CUBEKPIMEMBER("Sales","MySalesKPI", KPIGoal,"Sales KPI Goal")