GetSelectedCount() encontra o número de valores (verde) selecionados em um campo.
Sintaxe:
GetSelectedCount (field_name [, include_excluded [, state_name]])
Tipo de dados de retorno: inteiro
As cores usadas na barra de seleção e para cada estado de seleção podem ser modificadas com um tema personalizado. Se você estiver trabalhando com um aplicativo que usa um tema personalizado, poderá notar que suas seleções não são exibidas com as mesmas cores descritas neste tópico de ajuda.
| Argumentos | Descrição |
|---|---|
| field_name | O campo que contém o intervalo de dados que será medido. |
| include_excluded | Se for definido como True(), a contagem incluirá os valores selecionados, atualmente excluídos por seleções em outros campos. Se False ou omitido, esses valores não serão incluídos. |
| state_name | O nome de um estado alternativo que foi escolhido para a visualização específica. Se o argumento state_name for usado, apenas as seleções associadas ao nome do estado especificado serão levadas em consideração. Para obter mais informações, consulte Usando estados alternados para análises comparativas. |
A tabela a seguir lista outras funções relacionadas a essa função.
| Função | Interação |
|---|---|
| GetStateCounts - função de gráfico | Usando GetStateCounts(), você pode combinar o cálculo das contagens a seguir usando uma única chamada de função:
|
| GetPossibleCount - função de gráfico | Retorna a contagem de valores possíveis. |
| GetAlternativeCount - função de gráfico | Retorna a contagem de valores alternativos. |
| GetSelectedCount - função de gráfico | Retorna a contagem de valores excluídos, não incluindo valores excluídos alternativos e selecionados. |
| Exemplo | Resultado |
|---|---|
| GetSelectedCount (FirstName) | Se nenhuma seleção for feita, o endereço 0 será retornado. Se alguma seleção tiver sido feita no campo FirstName, o número de itens selecionados será retornado. |
| GetSelectedCount (FirstName, True()) | Se nenhuma seleção for feita, o endereço 0 será retornado. Se alguma seleção tiver sido feita no campo FirstName, o número de itens selecionados será retornado, independentemente de quaisquer seleções subsequentes em outros campos que possam reduzir os valores disponíveis no campo FirstName. |
Exemplo - Fundamentos de GetSelectedCount
Visão geral
Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.
O script de carregamento contém:
Um conjunto de dados que é carregado em uma tabela de dados denominada Example.
Os campos a seguir na tabela de dados:
FirstName
LastName
Initials
HasCellphone
Script de carregamento
Example:
LOAD * inline [
FirstName|LastName|Initials|HasCellphone
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
Carregue os dados e abra uma pasta. Crie um novo painel de filtro e adicione estes campos como dimensões:
FirstName
Initials
Crie dois objetos de KPI, um para cada uma das expressões de medida a seguir:
KPI 1: =GetSelectedCount(FirstName) para retornar o número de itens selecionados no campo FirstName.
KPI 2: =GetSelectedCount(Initials), para retornar o número de itens selecionados no campo Initials.
Cada KPI retorna o número de itens selecionados em cada campo. Sem seleções nos filtros, ambos os KPIs retornam o valor 0.
Nota de dicaNeste exemplo, o estilo do KPI foi ajustado para usar um comportamento de layout ágil para facilitar a exibição do resultado. Para obter mais informações sobre como alterar o comportamento do layout do gráfico, consulte Estilizando o KPIClique em Editar pasta para alternar para o modo de análise e, em seguida, selecione John no filtro FirstName.
O KPI 1 retorna o valor 1 porque há um item selecionado no filtro FirstName. O KPI 2 ainda retorna 0 porque o filtro Initials não tem itens selecionados.
Exemplo – GetSelectedCount com o parâmetro include_excluded
Visão geral
Este exemplo usa o mesmo conjunto de dados do exemplo anterior, mas demonstra a diferença nos resultados quando o parâmetro include_excluded é definido como True().
Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.
O script de carregamento contém:
Um conjunto de dados que é carregado em uma tabela de dados denominada Example.
Os campos a seguir na tabela de dados:
FirstName
LastName
Initials
HasCellphone
Script de carregamento
Example:
LOAD * inline [
FirstName|LastName|Initials|HasCellphone
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
Carregue os dados e abra uma pasta. Crie um novo painel de filtro e adicione estes campos como dimensões:
Initials
HasCellPhone
Crie dois objetos de KPI, um para cada uma das expressões de medida a seguir:
KPI 1: =GetselectedCount(Initials) para determinar o número de valores que foram selecionados no campo Initials.
KPI 2: =GetSelectedCount([Initials], True()) para incluir os valores selecionados que estão atualmente excluídos por seleções em outros campos.
Sem seleções no painel de filtro, cada KPI retorna o valor 0.
Nota de dicaNeste exemplo, o estilo do KPI foi ajustado para usar um comportamento de layout ágil para facilitar a exibição do resultado. Para obter mais informações sobre como alterar o comportamento do layout do gráfico, consulte Estilizando o KPIClique em Editar pasta para alternar para o modo de análise. Selecione todos os valores no filtro Initials e, em seguida, selecione Yes no filtro HasCellphone.
Ao comparar os resultados de cada KPI, você pode ver como cada um retorna um valor diferente, dependendo de o parâmetro include_excluded estar definido como True() ou não. O KPI 2 retorna o valor 6 porque inclui todos os valores selecionados no filtro Initials, mesmo que a seleção no filtro HasCellphone tenha reduzido os itens disponíveis para 4. O KPI 1 retorna 4 porque não conta os valores excluídos selecionados em Initials.