GetSelectedCount() permet de déterminer le nombre de valeurs sélectionnées (en vert) d'un champ.
GetSelectedCount (field_name [, include_excluded [, state_name]])
entier
Les couleurs utilisées dans la barre de sélection et pour chaque état de sélection peuvent être remplacées par un thème personnalisé. Si vous utilisez une application qui emploie un thème personnalisé, vous remarquerez peut-être que vos sélections ne s'affichent pas avec les mêmes couleurs que celles décrites dans cette rubrique d'aide.
| Arguments | Description |
|---|---|
| field_name | Champ contenant la plage de données à mesurer. |
| include_excluded | Si cet argument est défini sur True(), le décompte inclut les valeurs sélectionnées, qui sont actuellement exclues par des sélections dans d'autres champs. Si l'argument est défini sur False ou s'il est omis, ces valeurs sont exclues. |
| state_name | Nom d'un état alternatif ayant été choisi pour cette visualisation en particulier. Si l'argument state_name est utilisé, seules les sélections associées au nom d'état spécifié sont prises en compte. Pour plus d'informations, voir Utilisation d'états alternatifs à des fins d'analyse comparative. |
Le tableau suivant répertorie d'autres fonctions associées à cette fonction.
| Fonction | Interaction |
|---|---|
| GetStateCounts - fonction de graphique | Si vous utilisez GetStateCounts(), vous pouvez combiner le calcul des nombres suivants à l'aide d'un seul appel de fonction :
|
| GetPossibleCount - fonction de graphique | Renvoie le nombre de valeurs possibles. |
| GetAlternativeCount - fonction de graphique | Renvoie le nombre de valeurs alternatives. |
| GetSelectedCount - fonction de graphique | Renvoie le nombre de valeurs exclues, à l'exclusion des valeurs exclues alternatives et sélectionnées. |
| Exemple | Résultat |
|---|---|
| GetSelectedCount (FirstName) | Si aucune sélection n'est effectuée, 0 est renvoyé. Si des sélections ont été effectuées dans le champ FirstName, le nombre d'éléments sélectionnés est renvoyé. |
| GetSelectedCount (FirstName, True()) | Si aucune sélection n'est effectuée, 0 est renvoyé. Si des sélections ont été effectuées dans le champ FirstName, le nombre d'éléments sélectionnés est renvoyé, indépendamment de toute sélection ultérieure dans d'autres champs qui pourrait réduire les valeurs disponibles dans le champ FirstName. |
Exemple - Les bases de GetSelectedCount
Vue d'ensemble
Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à une nouvelle section.
Le script de chargement contient :
Jeu de données chargé dans une table de données appelée Example.
Champs suivants dans la table de données :
FirstName
LastName
Initials
HasCellphone
Script de chargement
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 '|');Résultats
Chargez les données et ouvrez une feuille. Créez un nouveau volet de filtre et ajoutez ces champs comme dimensions :
FirstName
Initials
Créez deux objets ICP, un pour chacune des expressions de mesure suivantes :
ICP 1 : =GetSelectedCount(FirstName), pour renvoyer le nombre d'éléments sélectionnés dans le champ FirstName.
ICP 2 : =GetSelectedCount(Initials), pour renvoyer le nombre d'éléments sélectionnés dans le champ Initials.
Chaque ICP indique le nombre d'éléments sélectionnés dans chaque champ. En l'absence de sélection dans les filtres, les deux ICP renvoient la valeur 0.
Note ConseilDans cet exemple, le style de l'ICP a été ajusté de sorte à utiliser un comportement de disposition réactif afin de faciliter l'affichage de la sortie. Pour plus d'informations sur la modification du comportement de disposition des graphiques, consultez Définition du style de l'indicateur ICP.Cliquez sur Modifier la feuille pour passer en mode d'analyse et sélectionnez John dans le filtre FirstName.
L'ICP 1 renvoie la valeur 1, car il existe un élément sélectionné dans le filtre FirstName. L'ICP 2 continue à renvoyer 0, car le filtre Initials n'a pas d'éléments sélectionnés.
Exemple - GetSelectedCount avec le paramètre include_excluded
Vue d'ensemble
Cet exemple utilise le même jeu de données que l'exemple précédent, mais montre la différence de résultats lorsque le paramètre include_excluded est défini sur True().
Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à une nouvelle section.
Le script de chargement contient :
Jeu de données chargé dans une table de données appelée Example.
Champs suivants dans la table de données :
FirstName
LastName
Initials
HasCellphone
Script de chargement
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 '|');Résultats
Chargez les données et ouvrez une feuille. Créez un nouveau volet de filtre et ajoutez ces champs comme dimensions :
Initials
HasCellPhone
Créez deux objets ICP, un pour chacune des expressions de mesure suivantes :
ICP 1 : =GetselectedCount(Initials), pour déterminer le nombre de valeurs qui ont été sélectionnées dans le champ Initials.
ICP 2 : =GetSelectedCount([Initials], True()), pour inclure les valeurs sélectionnées qui sont actuellement exclues par des sélections dans d'autres champs.
En l'absence de sélection dans le volet de filtre, chaque ICP renvoie la valeur 0.
Note ConseilDans cet exemple, le style de l'ICP a été ajusté de sorte à utiliser un comportement de disposition réactif afin de faciliter l'affichage de la sortie. Pour plus d'informations sur la modification du comportement de disposition des graphiques, consultez Définition du style de l'indicateur ICP.Cliquez sur Modifier la feuille pour passer en mode d'analyse. Sélectionnez toutes les valeurs dans le filtre Initials, puis sélectionnez Yes dans le filtre HasCellphone.
Lorsque vous comparez les résultats de chaque ICP, vous pouvez voir que chacun renvoie une valeur différente selon que le paramètre include_excluded est défini sur True() ou non. L'ICP 2 renvoie la valeur 6, car il inclut toutes les valeurs sélectionnées dans le filtre Initials, même si la sélection dans le filtre HasCellphone a réduit les éléments disponibles à 4. L'ICP 1 renvoie 4, car il ne compte pas les valeurs exclues sélectionnées dans Initials.