GetExcludedCount() encontra o número de valores (cinza-escuro) excluídos na área identificada. Somente os campos excluídos (cinza escuro) são contados. Valores alternativos (cinza claro) e selecionados excluídos (cinza escuro com marca de seleção) não são contados.
Sintaxe:
GetExcludedCount (field_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. |
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:
|
| GetSelectedCount - função de gráfico | Retorna a contagem de valores incluídos selecionados. |
| 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. |
| Exemplo | Resultado |
|---|---|
| GetExcludedCount( Initials ) | Retorna 0 se nenhuma seleção tiver sido feita. Se uma seleção tiver sido feita, o valor retornado será o número de valores excluídos em Initials com cor cinza escuro. |
Exemplo - Fundamentos de GetExcludedCount
Visão geral
Este exemplo mostra como os valores retornados pela função GetExcludedCount mudam conforme seleções adicionais são feitas.
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
LastName
Initials
Crie três objetos KPI e adicione as expressões a seguir como medidas, uma por objeto de KPI:
=GetExcludedCount(FirstName), para contar o número de valores excluídos no campo FirstName.
=GetExcludedCount(Initials), para contar o número de valores excluídos no campo Initials.
=GetExcludedCount(LastName), para contar o número de valores excluídos no campo LastName.
Sua pasta terá a aparência da imagem a seguir, pois nenhum valor foi selecionado. A função GetExcludedCount retorna 0 para cada KPI.
Clique em Editar pasta para alternar para o modo de análise e faça as seguintes seleções na ordem:
Filtrar seleções e resultados no modo de análise Seleção do painel de filtro Resultados do KPI Selecione John no filtro FirstName. - GetExcludedCount (Initials) retorna um valor de 5 porque há 5 valores excluídos em Initials com cor cinza escuro. O valor de JA permanece em branco, porque está associado com a seleção de John em FirstName.
- GetExcludedCount (LastName) retorna um valor de 5 porque há 5 valores excluídos em LastName com cor cinza escuro. O valor de Anderson permanece em branco, porque está associado com a seleção de John em FirstName.
Selecione John e Peter no filtro FirstName. - GetExcludedCount (Initials) retorna um valor de 3 porque há 3 valores excluídos em Initials com cor cinza escuro.
- GetExcludedCount (LastName) retorna um valor de 3 porque há 3 valores excluídos em LastName com cor cinza escuro.
Com John e Peter selecionados, selecione Franc no filtro LastName. - GetExcludedCount (FirstName) retorna um valor de 3 porque há 3 valores excluídos em FirstName com cor cinza escuro e sem marca de seleção. A função The GetExcludedCount conta apenas os valores excluídos. Valores alternativos e excluídos selecionados não são incluídos na contagem. John é um valor excluído selecionado.
- GetExcludedCount (Initials) retorna um valor de 5 porque há 5 valores excluídos em Initials com cor cinza escuro.
- GetExcludedCount (LastName) retorna um valor de 3 porque há 3 valores excluídos em LastName com cor cinza escuro. Os 2 valores de cor cinza claro, Anderson e Devonshire, são valores alternativos.
Mantenha as seleções anteriores e, no filtro LastName, selecione Anderson. - GetExcludedCount (FirstName) retorna um valor de 3 porque há 3 valores excluídos em FirstName com cor cinza escuro.
- GetExcludedCount (Initials) retorna um valor de 4 porque há 4 valores excluídos em Initials com cor cinza escuro.
- GetExcludedCount (LastName) retorna um valor de 3 porque há 3 valores excluídos em LastName com cor cinza escuro.
Você pode ver os resultados finais das seleções do painel de filtro na imagem a seguir.
Resultados de KPI da seleção de nomes, John e Peter, e sobrenomes, Franc e Anderson
Exemplo - Cenário de GetExcludedCount
Visão geral
Um gerente de vendas usa a função GetExcludedCount para criar um gráfico de KPI para analisar os produtos vendidos por vendedor.
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:
Salesperson
Product
SalesAmount
Script de carregamento
Example:
LOAD * INLINE [
Salesperson, Product, SalesAmount
John, Laptops, 1000
Alice, Smartphones, 800
Bob, Laptops, 1200
Carol, Tablets, 700
Dave, Tablets, 900
];Resultados
Carregue os dados e abra uma pasta. Crie um novo painel de filtro e adicione estes campos como dimensões:
Salesperson
Product
Crie um novo objeto de KPI e adicione a seguinte medida:
=GetExcludedCount(Product), para encontrar o número de valores excluídos no campo Product.
Clique em Editar pasta para alternar para o modo de análise e, em seguida, selecione Alice no filtro Salesperson.
A função GetExcludedCount retorna um valor de 2 porque há 2 valores exclusivos e excluídos (cinza escuro) no campo Product.
Os resultados mostram como você pode usar a função GetExcludedCount para analisar os dados. O vendedor Alice não vendeu nenhum item em 2 dos 3 grupos de produtos: produtos Laptop e Tablet.