GetStateCounts - função de gráfico

A função do gráfico GetStateCounts() é usada para calcular o número total de valores exclusivos que correspondem aos estados de seleção especificados.

Com GetStateCounts(), você pode combinar os cálculos das funções a seguir em uma única chamada de função: GetSelectedCount(), GetNotSelectedCount(), GetAlternativeCount(), GetPossibleCount(), e GetExcludedCount(). A contagem dos valores excluídos selecionados também está disponível para ser adicionada ao cálculo. Você pode especificar se cada cálculo de função inclui ou subtrai do total retornado.

Sintaxe:

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

Tipo de dados de retorno: inteiro

Argumentos
Argumento	Descrição
field_name	O campo para o qual você está calculando o estado de seleção. Um nome de campo inexistente resulta em um resultado nulo.
state_name	O nome do estado alternativo. Se o argumento estiver vazio ('') ou for nulo, o estado alternativo herdado será usado. Use $ para usar explicitamente o estado padrão. Um nome de estado nomeado (não vazio) que não corresponda a um estado existente resulta em um resultado nulo.
state_type	Uma lista de um ou mais tipos de campo para o valor do campo. Esses tipos de estado serão agregados em uma contagem. Um tipo de estado é especificado usando uma chave. Insira cada chave com aspas simples. Quando esse argumento é omitido, a função retorna uma cadeia de caracteres com todas as contagens de campos disponíveis, na mesma ordem da enumeração. Para obter uma lista de estados que você pode usar, consulte a tabela.

Os tipos de estado são referenciados usando chaves específicas. Você pode usar a versão numérica ou textual da chave. Personalize mais de uma chave na mesma expressão para personalizar ainda mais o resultado. Você pode subtrair a contagem total do estado, em vez de adicioná-la. Para fazer isso, use a chave textual e prefixe o tipo de prefixo do estado com um símbolo de menos (-).

O tipo de estado e, se aplicável, o símbolo de menos, precisam ser colocados em um conjunto de aspas simples.

Chaves para cada tipo de campo
Tipo de estado do campo	Descrição	Chave numérica	Chave textual
Selecionado	Inclui valores selecionados no cálculo. Para conhecer a função equivalente, consulte GetSelectedCount - função de gráfico.	1	S
Opcional	Inclui valores opcionais (não selecionados, mas possíveis de serem selecionados) no cálculo. Para conhecer a função equivalente, consulte GetPossibleCount - função de gráfico.	2	O
Desmarcado	Inclui valores não selecionados no cálculo. Esse tipo de campo só está disponível quando o campo está no modo e. Esse tipo de estado retorna o mesmo cálculo que a função GetNotSelectedCount() retorna, supondo que o argumento include_excluded nessa função esteja definido como padrão de falso. Para obter mais informações sobre o GetNotSelectedCount(), consulte GetNotSelectedCount - função de gráfico.	3	D
Alternativo	Inclui valores não selecionados no cálculo. Para conhecer a função equivalente, consulte GetAlternativeCount - função de gráfico.	4	A
Excluído	Inclui valores excluídos (não selecionados) no cálculo. Para obter a função equivalente, consulte GetExcludedCount - função de gráfico.	5	X
Selecionado excluído	Inclui valores excluídos selecionados no cálculo.	6	XS

Quando usar

Com GetStateCounts(), você pode calcular um estado de seleção personalizado. A função permite consolidar várias chamadas de função em uma única chamada de função, simplificando o processo de escrever sua expressão.

Por exemplo, talvez você precise calcular o número total de valores excluídos, alternativos e selecionados excluídos para um campo. Você pode usar GetStateCounts() para calcular esse total.

Exemplos e resultados
Exemplos	Resultados
=GetStateCounts(ProductName, Null(), 'S')	Retorna a contagem selecionada para ProductName, no estado alternativo herdado.
=GetStateCounts(ProductName, '', 'X', 'A', 'XS')	Contagem total de valores excluídos, selecionados excluídos e alternativos para ProductName. O estado alternativo herdado é usado.
=GetStateCounts(ProductName, '', 'S', 'XS')	Retorna a contagem total de seleções de usuário para ProductName, no estado herdado.
Considerando que o campo ProductName está no modo. =GetStateCounts(ProductName, '', 'D', '-O')	Retorna o número de valores não selecionados, subtraído pelo número de valores possíveis, para ProductName. O estado alternativo herdado é usado.
=GetStateCounts(ProductName, '', 'X', , 'A', 'XS')	Contagem total de valores excluídos, selecionados excluídos e alternativos para ProductName. O estado alternativo herdado é usado.
=GetStateCounts(ProductName, '$', 'O')	Retorna a contagem possível para ProductName, no estado alternativo padrão.
=GetStateCounts(ProductName, 'StateA', 'S')	Retorna a contagem selecionada de ProductName, no estado alternativo denominado StateA.

Exemplo 1 - Contagem do número total de seleções do usuário (incluindo os valores selecionados excluídos)

Visão geral

A função GetSelectedCount() retorna o número total de valores selecionados, não incluindo o número total de valores excluídos selecionados. Com GetExcludedCount(), você pode incluir a contagem de valores excluídos selecionados no cálculo do gráfico.

Abra o Editor da carga de dados e adicione o script de carregamento a seguir a uma nova guia.

Script de carregamento

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 '|');

Resultados

Faça o seguinte:

Carregue os dados e abra uma pasta.
Crie dois painéis de filtro.
Adicione First name como uma dimensão no primeiro painel de filtro. Adicione Last name como uma dimensão no secundo painel de filtro.
Em seguida, crie um KPI com essa medida:

=GetStateCounts([First name], '', 'X', 'A', 'XS')
No painel de filtro First name, selecione os valores Mark e Peter. No painel de filtro Last name, selecione o valor Carr.
Observe que o KPI mostra um valor de 2. Isso reflete que todos os valores que você selecionou, incluindo o valor excluído selecionado Peter, são contados.

Exemplo 2 - Combinação de contagens de excluídos, excluídos selecionados e alternativos

Visão geral

A função GetExcludedCount() retorna o número total de valores exclusivos que não são selecionados e excluídos. Se quiser incluir contagens alternativas e excluídas selecionadas em sua visualização, você poderá usar a função GetStateCounts() da seguinte forma.

Abra o Editor da carga de dados e adicione o script de carregamento a seguir a uma nova guia.

Script de carregamento

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 '|');

Resultados

Faça o seguinte:

Carregue os dados e abra uma pasta.
Crie dois painéis de filtro.
Adicione First name como uma dimensão no primeiro painel de filtro. Adicione Last name como uma dimensão no secundo painel de filtro.
Em seguida, crie um KPI com essa medida:

=GetStateCounts([First name], '', 'X', 'A', 'XS')
No painel de filtro First name, selecione os valores John e Peter. No painel de filtro Last name, selecione o valor Franc.
Observe que o KPI mostra um valor de 4. Isso reflete que o valor excluído selecionado John está incluído na contagem, além da contagem dos valores excluídos.
Edite o KPI e substitua a medida existente pela seguinte:

=GetStateCounts([Last name], '', 'X', 'A', 'XS')
Mantendo as seleções existentes, selecione o valor Anderson no painel de filtro Last name.
Observe que o KPI ainda mostra um valor de 4. Isso reflete que o valor alternativo Devonshire está incluído na contagem, além da contagem dos valores excluídos.

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo - um erro de digitação, uma etapa ausente ou um erro técnico - informe-nos como podemos melhorar!

Deixe seu feedback aqui