跳转至

CCH® Tagetik 函数

简介

CCH® Tagetik Intelligent Analytics for Microsoft Excel 提供了一组函数，可在 Excel 公式中使用，以从 CCH® Tagetik 检索数据和元素列表。

这些函数使用户能够以完全自由且直观的方式构建 Excel 报表，从 CCH Tagetik 检索数据，无需任何额外培训。

可以编写 Excel 公式来组合多个函数并引用其他单元格（甚至其他 Excel 工作表）的值，从而基于任意数据来源构建报表和模拟。

CCH® Tagetik Intelligent Analytics 函数可通过 Excel 公式栏或其侧面板 CCH® Tagetik 访问。

在 CCH® Tagetik Intelligent Analytics 加载项中，Microsoft Excel 可使用以下函数：

  • TGK.FILTER
  • TGK.OR
  • TGK.DISPLAY
  • TGK.VAL

TGK.FILTER 函数

TGK.FILTER 函数允许您从 CCH Tagetik 数据模型中选择最低层级元素或节点，并在其他公式中使用它们。

参数

  • Dimension_code：字符串，指定 Tagetik 维度代码。
  • Hierarchy_code：（可选）字符串，指定维度层次的代码。如果省略，则以下参数表示最低层级元素的代码；否则它们表示指定层次中节点元素的代码。
  • Selected_item1...n：字符串列表，表示最低层级元素或节点的代码。该列表必须至少包含一个元素。

返回值

一个表示筛选器的值，该筛选器仅由指定的最低层级元素或节点组成。该筛选器由 Excel 数据类型表示（官方 Excel 文档：https://support.microsoft.com/en-us/office/excel-data-types-stocks-and-geography-61a33056-9935-484f-8ac8-f1a89e210877) 它可用作 TGK.VAL、TGK.DISPLAY 或 TGK.OR 函数中的筛选器参数。

示例

TGK.FILTER("DIM",, "01", "02")

此示例返回代码为 'DIM' 的分析维度的最低层级元素 '01' 和 '02'。

TGK.FILTER("DIM", "H1", "01", "02")

此示例返回代码为 'DIM' 的分析维度中 'H1' 层次的节点 '01' 和 '02'。

TGK.OR 函数

TGK.OR 函数允许您使用逻辑 OR 运算符在同一分析维度内组合多个筛选器。

参数

filter1...n：要用 OR 运算符组合的筛选器列表。可以组合两个或更多筛选器。

返回值

一个表示指定筛选器组合的值。该筛选器由 Excel 数据类型表示（官方 Excel 文档：https://support.microsoft.com/en-us/office/excel-data-types-stocks-and-geography-61a33056-9935-484f-8ac8-f1a89e210877)。 它可用作 TGK.VAL 或 TGK.DISPLAY 函数中的筛选器参数。

示例

TGK.OR(TGK.FILTER("DIM",, "01"), TGK.FILTER("DIM", "H1", "02"))

此示例将代码为 'DIM' 的分析维度中最低层级元素筛选器 '01' 和层次 'H1' 的节点筛选器 '02' 以 OR 方式组合。

TGK.DISPLAY 函数

TGK.DISPLAY 函数允许您检索通过 TGK.FILTER 和 TGK.OR 公式定义的元素描述

参数

  • application_name：字符串，指定应用程序名称。
  • filter：使用 TGK.FILTER 或 TGK.OR 函数获得的筛选器。
  • text：（可选）字符串，指定用于覆盖原始描述的文本。

返回值

一个包含通过所应用筛选器选择的元素的值，并附带描述信息。该筛选器由 Excel 数据类型表示（官方 Excel 文档链接：https://support.microsoft.com/en-us/office/excel-data-types-stocks-and-geography-61a33056-9935-484f-8ac8-f1a89e210877)。 它可用作 TGK.VAL 或 TGK.OR 函数中的筛选器参数。

示例

TGK.DISPLAY("App", TGK.FILTER("DIM",, "01", "02"))

此示例显示代码为 'DIM' 的分析维度中元素 '01' 和 '02' 的描述。

TGK.VAL 函数

TGK.VAL 函数允许您从指定的筛选器检索值。

参数

  • application_name：字符串，指定应用程序名称。
  • reporting_view：字符串，指定报表视图。
  • measure：字符串，指定要聚合的度量。
  • filter1...n：（可选）要用 AND 运算符组合的筛选器。

返回值

指定度量下筛选数据交集的数值。如果筛选器未匹配任何数据，该函数返回空单元格。

示例

TGK.VAL("App", "ReportingView", "Measure", TGK.FILTER("DIM",, "01", "02"))

此示例从报表视图 'ReportingView' 中检索代码为 'DIM' 的分析维度中元素 '01' 和 '02' 与度量 'Measure' 相关的聚合值。

TGK.VAL("App", "ReportingView", "Measure", TGK.OR(TGK.FILTER("DIM1",, "01", "02"), TGK.FILTER("DIM1", "H1", "03")), TGK.FILTER("DIM2", "H2", "04"))

此示例从报表视图 'ReportingView' 中检索度量 'Measure' 的聚合值，该值基于以下逻辑应用筛选器后得出：

TGK.FILTER("DIM1",, "01", "02") OR TGK.FILTER("DIM1", "H1", "03") ] AND TGK.FILTER("DIM2", "H2", "04")