GetStateCounts - función de gráfico

La función de gráfico GetStateCounts() sirve para calcular el número total de valores únicos que coinciden con los estados de selección especificados.

Con GetStateCounts(), puede combinar los cálculos de las siguientes funciones en una única llamada a una función: GetSelectedCount(), GetNotSelectedCount(), GetAlternativeCount(), GetPossibleCount() y GetExcludedCount(). El recuento de valores excluidos seleccionados también está disponible para añadirlo al cálculo. Puede especificar si cada cálculo de función suma o resta del total devuelto.

Sintaxis:

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

Tipo de datos que devuelve: Entero

Argumentos
Argumento	Descripción
field_name	El campo para el que está calculando el estado de selección. Un nombre de campo inexistente da un resultado nulo.
state_name	El nombre del estado alterno. Si el argumento está vacío ('') o es nulo, se usa el estado alterno alterno heredado. Utilice $ para usar explícitamente el estado predeterminado. Un nombre de estado (no vacío) que no coincide con un estado existente produce un resultado nulo.
state_type	Lista de uno o más tipos de estado para el valor del campo. Estos tipos de estado se agregarán en un recuento. Un tipo de estado se especifica por medio de una clave. Introduzca cada clave con comillas simples. Cuando se omite este argumento, la función devuelve una cadena con todos los recuentos de estado disponibles para el campo, en el mismo orden que la enumeración. Para ver la lista de estados que puede utilizar, consulte la tabla a continuación.

Los tipos de estado se referencian por medio de claves específicas. Puede usar la versión numérica o textual de la clave. Combine más de una clave en la misma expresión para personalizar aún más el resultado. Puede restar el recuento de estados del total, en lugar de sumarlo. Para ello, utilice la clave de texto y anteponga el símbolo menos (-) al tipo de estado.

El tipo de estado y, si procede, el símbolo menos, deben ir entre comillas simples.

Claves para cada tipo de estado de campo
Tipo de estado del campo	Descripción	Clave numérica	Clave textual
Seleccionado	Incluye los valores seleccionados en el cálculo. Para ver la función equivalente, consulte GetSelectedCount - función de gráfico.	1	S
Opcional	Incluye valores opcionales (no seleccionados, pero posibles de seleccionar) en el cálculo. Para ver la función equivalente, consulte GetPossibleCount - función de gráfico.	2	O
Deseleccionado	Incluye valores no seleccionados en el cálculo. Este tipo de estado sólo está disponible cuando el campo está en modo and. Este tipo de estado devuelve el mismo cálculo que devuelve la función GetNotSelectedCount(), suponiendo que el argumento include_excluded de dicha función esté establecido como Falso por defecto. Para obtener más información sobre GetNotSelectedCount(), consulte GetNotSelectedCount - función de gráfico.	3	D
Alternativo	Incluye valores alternativos en el cálculo. Para ver la función equivalente, consulte GetAlternativeCount - función de gráfico.	4	A
Excluido	Incluye valores excluidos (no seleccionados) en el cálculo. Para ver la función equivalente, consulte GetExcludedCount - función de gráfico.	5	X
Excluidos seleccionados	Incluye valores excluidos seleccionados en el cálculo.	6	XS

Cuándo se utiliza

Con GetStateCounts(), puede calcular un estado de selección personalizado. La función le permite consolidar múltiples llamadas de función en una sola llamada de función, simplificando el proceso de escribir su expresión.

Por ejemplo, puede que necesite calcular el número total de valores excluidos, alternativos y excluidos seleccionados de un campo. Puede usar GetStateCounts() para calcular este total.

Ejemplos y resultados
Ejemplos	Resultados
=GetStateCounts(ProductName, Null(), 'S')	Devuelve el recuento seleccionado para ProductName, en el estado alterno heredado.
=GetStateCounts(ProductName, '', 'X', 'A', 'XS')	Devuelve el recuento total de valores excluidos, excluidos seleccionados y alternativos de ProductName. Se utiliza el estado alterno heredado.
=GetStateCounts(ProductName, '', 'S', 'XS')	Devuelve el recuento total de selecciones de usuario para ProductName, en el la provincia/estado heredados.
Dado que el campo ProductName está en modo and. =GetStateCounts(ProductName, '', 'D', '-O')	Devuelve el número de valores no seleccionados, restándole el número de valores posibles, de ProductName. Se utiliza el estado alterno heredado.
=GetStateCounts(ProductName, '', 'X', , 'A', 'XS')	Devuelve el recuento total de valores excluidos, excluidos seleccionados y alternativos de ProductName. Se utiliza el estado alterno heredado.
=GetStateCounts(ProductName, '$', 'O')	Devuelve el recuento de valores posibles de ProductName, en el estado alterno predeterminado.
=GetStateCounts(ProductName, 'StateA', 'S')	Devuelve el recuento de valores seleccionados de ProductName, en el estado alterno heredado denominado StateA.

Ejemplo 1: Recuento del número total de selecciones de usuario (incluidos los valores excluidos seleccionados).

Vista general

La función GetSelectedCount() devuelve el número total de valores seleccionados, sin incluir el número total de valores excluidos seleccionados. Con GetExcludedCount(), puede incluir el recuento de valores excluidos seleccionados en el cálculo del gráfico.

Abra el Editor de carga de datos y agregue el siguiente script de carga en una nueva pestaña.

Script de carga

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

Haga lo siguiente:

Cargue los datos y abra una hoja.
Cree dos paneles de filtrado.
Añada First name como dimensión en el primer panel de filtrado. Añade Last name como dimensión en el segundo panel de filtrado.
A continuación, cree un KPI con esta medida:

=GetStateCounts([First name], '', 'X', 'A', 'XS')
En el panel de filtrado First name, seleccione los valores Mark y Peter. En el panel de filtrado Last name, seleccione el valor Carr.
Observe que el KPI muestra un valor de 2. Esto refleja que todos los valores que seleccionó, incluido el valor excluido seleccionado Peter, se contabilizan.

Ejemplo 2: Combinar recuentos de excluidos, excluidos seleccionados y alternativos.

Vista general

La función GetExcludedCount() devuelve el número total de valores únicos no seleccionados y excluidos. Si desea incluir recuentos de alternativos y excluidos seleccionados en su visualización, puede utilizar la función GetStateCounts() de la siguiente manera.

Abra el Editor de carga de datos y agregue el siguiente script de carga en una nueva pestaña.

Script de carga

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

Haga lo siguiente:

Cargue los datos y abra una hoja.
Cree dos paneles de filtrado.
Añada First name como dimensión en el primer panel de filtrado. Añada Last name como dimensión en el segundo panel de filtrado.
A continuación, cree un KPI con esta medida:

=GetStateCounts([First name], '', 'X', 'A', 'XS')
En el panel de filtrado First name, seleccione los valores John y Peter. En el panel de filtrado Last name, seleccione el valor Franc.
Observe que el KPI muestra un valor de 4. Esto refleja que el valor excluido seleccionado John está incluido en el recuento, además del recuento de los valores excluidos.
Edite el KPI y reemplace la medida existente por lo siguiente:

=GetStateCounts([Last name], '', 'X', 'A', 'XS')
Manteniendo las selecciones actuales, seleccione el valor Anderson en el panel de filtrado Last name.
Observe que el KPI sigue mostrando un valor de 4. Esto refleja que el valor alternativo Devonshire está incluido en el recuento, además del recuento de los valores excluidos.

¿Esta página le ha sido útil?

No dude en indicarnos en qué podemos mejorar si encuentra algún problema en esta página o su contenido, como, por ejemplo, errores tipográficos, pasos que falta o errores técnicos.

Deje aquí sus comentarios