# 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 sola llamada a la 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.<br><br>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.<br><br>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](https://help.qlik.com/es-ES/sense/November2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getselectedcount.htm). | 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](https://help.qlik.com/es-ES/sense/November2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getpossiblecount.htm). | 2 | O |
| Deseleccionado | Incluye valores no seleccionados en el cálculo. Este tipo de estado únicamente está disponible cuando el campo está en modo AND. | 3 | D |
| Alternativo | Incluye valores alternativos en el cálculo. Para ver la función equivalente, consulte [GetAlternativeCount - función de gráfico](https://help.qlik.com/es-ES/sense/November2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getalternativecount.htm). | 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](https://help.qlik.com/es-ES/sense/November2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getexcludedcount.htm). | 5 | X |
| Seleccionado excluido | 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: expresiones de gráficos

| 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.<br><br><br>`=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).

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getstatecounts.htm)

#### Expresión de gráfico

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 la página Editor de carga de datos y añada el siguiente script de carga a una nueva sección.

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:

1. Cargue los datos y abra una hoja.

2. Cree dos paneles de filtrado.

3. 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.

4. A continuación, cree un KPI con esta medida:

   `=GetStateCounts([First Name],'', 'S','XS')`

5. En el panel de filtrado First name, seleccione los valores Mark y Peter. En el panel de filtrado Last name, seleccione el valor Carr.

6. 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.

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getstatecounts.htm)

#### Expresiones de gráfico

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 la página Editor de carga de datos y añada el siguiente script de carga a una nueva sección.

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:

1. Cargue los datos y abra una hoja.

2. Cree dos paneles de filtrado.

3. 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.

4. A continuación, cree un KPI con esta medida:

   `=GetStateCounts([First name], '', 'X', 'A', 'XS')`

5. En el panel de filtrado First name, seleccione los valores John y Peter. En el panel de filtrado Last name, seleccione el valor Franc.

6. 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.

7. Edite el KPI y reemplace la medida existente por lo siguiente:

   `=GetStateCounts([Last name], '', 'X', 'A', 'XS')`

8. Manteniendo las selecciones actuales, seleccione el valor Anderson en el panel de filtrado Last name.

9. 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.