Applies ToExcel for Microsoft 365 Excel for Microsoft 365 for Mac Excel for the web Excel 2024 Excel 2024 for Mac Excel 2021 Excel 2021 for Mac Excel 2019 Excel 2016 Excel for iPad Excel Web App Excel for iPhone Excel for Android tablets Excel for Android phones

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

Need more help?

Want more options?

Explore subscription benefits, browse training courses, learn how to secure your device, and more.

Communities help you ask and answer questions, give feedback, and hear from experts with rich knowledge.