GetStateCounts - 图表函数

GetStateCounts() 图表函数用于计算与指定选择状态匹配的唯一值的总数。

通过 GetStateCounts()，您可以将以下函数的计算合并到一个函数调用中：GetSelectedCount()、GetNotSelectedCount()、GetAlternativeCount()、GetPossibleCount() 和 GetExcludedCount()。所选排除值的计数也可添加到计算中。您可以指定每个函数计算是对返回的总和进行相加还是相减。

语法：

GetStateCounts (field_name, state_name [, state_type1,...state_typeN])

返回数据类型：整数

参数
参数	描述
field_name	您正在计算选择项状态的字段。不存在的字段名会导致空结果。
state_name	备用状态的名称。如果参数为空 ('') 或 null，则使用继承的备用状态。使用 $ 来显式使用默认状态。与现有状态不匹配的命名（非空）状态名称将导致 null 结果。
state_type	字段值的一个或多个状态类型的列表。这些状态类型将被聚合到一个计数中。状态类型使用键来指定。用单引号输入每个键。当省略此参数时，函数将返回一个字符串，其中包含字段的所有可用状态计数，顺序与枚举相同。有关可以使用的状态列表，请参阅下表。

使用特定键引用状态类型。您可以使用键的数字或文本版本。在同一表达式中组合多个键以进一步自定义结果。您可以从总数中减去状态计数，而不是将其相加。为此，请使用文本键并在状态类型前加上减号 (-)。

状态类型以及减号（如果适用）需要用一组单引号括起来。

每个字段状态类型的键
字段状态类型	描述	数字键	文本键
已选择	在计算中包括选定值。有关等效函数，请参阅GetSelectedCount - 图表函数。	1	S
可选	在计算中包括可选（未选择，但可以选择）值。有关等效函数，请参阅GetPossibleCount - 图表函数。	2	O
取消选择	在计算中包括未选定值。此状态类型仅在字段处于“和”模式时可用。假设该函数中的 include_excluded 参数设置为默认值 False，则此状态类型返回与 GetNotSelectedCount() 函数返回的相同的计算结果。有关 GetNotSelectedCount() 的更多信息，请参阅GetNotSelectedCount - 图表函数。	3	D
替代	在计算中包括替代值。有关等效函数，请参阅GetAlternativeCount - 图表函数。	4	A
排除	在计算中包括排除（未选定）值。有关等效函数，请参阅GetExcludedCount - 图表函数。	5	X
选定排除	在计算中包括选定排除值。	6	XS

适用场景

通过 GetStateCounts()，您可以计算自定义选择项状态。该函数允许您将多个函数调用合并为一个函数调用，简化了编写表达式的过程。

例如，您可能需要计算字段的排除值、替代值和选定排除值的总数。您可使用 GetStateCounts() 计算这一合计。

示例和结果
示例	结果
=GetStateCounts(ProductName, Null(), 'S')	以继承的替代状态返回 ProductName 的选定计数。
=GetStateCounts(ProductName, '', 'X', 'A', 'XS')	返回 ProductName 的排除值、选定排除值和替代值的总数。使用继承的替代状态。
=GetStateCounts(ProductName, '', 'S', 'XS')	返回处于继承状态的 ProductName 的用户选择项的总数。
假定 ProductName 字段处于“和”模式。 =GetStateCounts(ProductName, '', 'D', '-O')	返回的 ProductName 未选定值的数量减去可能值的数量。使用继承的替代状态。
=GetStateCounts(ProductName, '', 'X', , 'A', 'XS')	返回 ProductName 的排除值、选定排除值和替代值的总数。使用继承的替代状态。
=GetStateCounts(ProductName, '$', 'O')	在默认备用状态下返回 ProductName 的可能计数。
=GetStateCounts(ProductName, 'StateA', 'S')	返回在名为 StateA 的替代状态下的 ProductName 选定计数。

示例 1 - 计算用户选择项的总数（包括选定的排除值）

概述

GetSelectedCount() 函数返回选定值的总数，不包括选定排除值的总数。通过 GetExcludedCount()，您可以在图表的计算中纳入选定排除值的计数。

打开数据加载编辑器，并将以下加载脚本添加到新选项卡。

加载脚本

Names:

LOAD * inline [

"First name"|"Last name"|Initials|"Has cellphone"

John|Anderson|JA|Yes

Sue|Brown|SB|Yes

Mark|Carr|MC |No

Peter|Devonshire|PD|No

Jane|Elliot|JE|Yes

Peter|Franc|PF|Yes ] (delimiter is '|');

结果

执行以下操作：

加载数据并打开工作表。
创建筛选器窗格
在第一个筛选窗格中添加 First name 为维度。在第二个筛选窗格中添加 Last name 为维度。
下一步，用这个度量创建 KPI：

=GetStateCounts([First name], '', 'X', 'A', 'XS')
在 First name 筛选器窗格中，选择值 Mark 和 Peter。在 Last name筛选器窗格中，选择值 Carr。
观察到 KPI 显示值 2。这反映了您选择的所有值，包括所选的排除值 Peter，都将被计算在内。

示例 2 - 结合排除、选定排除和替代计数

概述

GetExcludedCount() 函数返回未选定和排除的唯一值的总数。如果要在可视化中包含选定的排除计数和替代计数，可以按如下方式使用 GetStateCounts() 函数。

打开数据加载编辑器，并将以下加载脚本添加到新选项卡。

加载脚本

Names:
LOAD * inline [
First name|Last name|Initials|Has cellphone
John|Anderson|JA|Yes
Sue|Brown|SB|Yes
Mark|Carr|MC|No
Peter|Devonshire|PD|No
Jane|Elliot|JE|Yes
Peter|Franc|PF|Yes ] (delimiter is '|');

结果

执行以下操作：

加载数据并打开工作表。
创建筛选器窗格
在第一个筛选窗格中添加 First name 为维度。在第二个筛选窗格中添加 Last name 为维度。
下一步，用这个度量创建 KPI：

=GetStateCounts([First name], '', 'X', 'A', 'XS')
在 First name 筛选器窗格中，选择值 John 和 Peter。在 Last name筛选器窗格中，选择值 Franc。
观察到 KPI 显示值 4。这反映了除了排除值的计数外，选定排除值 John 也包含在计数中。
编辑 KPI 并用以下内容替换现有度量：

=GetStateCounts([Last name], '', 'X', 'A', 'XS')
保留现有选择项，在 Last name 筛选器窗格中选择值 Anderson。
观察到 KPI 仍显示值 4。这反映了除了排除值的计数外，替代值 Devonshire 也包含在计数中。

本页面有帮助吗？

如果您发现此页面或其内容有任何问题 – 打字错误、遗漏步骤或技术错误 – 请告诉我们如何改进！

在此处留下您的反馈