CUBEKPIMEMBER function

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

connection is a text string of the name of the connection to the cube.

kpi_name is a text string of the name of the KPI in the cube.

kpi_property is 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 is 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.)

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>

*

code

clearPost Comment