CUBEKPIMEMBER function

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")

Was this information helpful?

Great! Any other feedback?

How can we improve it?

Thank you for your feedback!

×