La fonction GetFieldSelections() renvoie une chaîne (string) avec les sélections actives dans un champ.
Si toutes les valeurs sauf deux, ou sauf une, sont sélectionnées, le format 'NOT x,y' ou 'NOT y' sera utilisé. Si vous sélectionnez toutes les valeurs et que le nombre total de valeurs est supérieur à l'argument max_values, le texte ALL est renvoyé.
GetFieldSelections ( field_name [, value_sep [, max_values [, state_name]]])
chaîne
| Format | Description |
|---|---|
| 'a, b, c' |
Si le nombre de valeurs sélectionnées est max_values ou moins, la chaîne renvoyée est une liste des valeurs sélectionnées. Les valeurs sont séparées par value_sep comme délimiteur. |
| 'NOT a, b, c' |
Si le nombre de valeurs non sélectionnées est max_values ou moins, la chaîne renvoyée est une liste des valeurs non sélectionnées avec NOT comme préfixe. Les valeurs sont séparées par value_sep comme délimiteur. |
| 'x of y' |
x = nombre de valeurs sélectionnées y = nombre total de valeurs Cela est renvoyé lorsque max_values < x < ( y - max_values). |
| 'ALL' | Renvoyé si toutes les valeurs sont sélectionnées. |
| '-' | Renvoyé si aucune valeur n'est sélectionnée. |
| <search string> | Si vous avez effectué votre sélection via la recherche, la chaîne de recherche est renvoyée. |
| Arguments | Description |
|---|---|
| field_name | Champ contenant la plage de données à mesurer. |
| value_sep | Séparateur à placer entre les valeurs de champ. La valeur par défaut est la virgule (,). |
| max_values | Nombre maximum de valeurs de champ pouvant être listées individuellement. Lorsqu'un plus grand nombre de valeurs est sélectionné, le format « x valeurs sur y » le remplace. La valeur par défaut est 6. |
| 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. |
| Exemple | Résultat |
|---|---|
GetFieldSelections( FirstName ) | Renvoie « - » (NULL) si aucune sélection n'a été effectuée dans le champ FirstName. Sinon, renvoie la valeur des sélections, par exemple John. |
Exemple - Les bases de GetFieldSelections
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 ce champ comme dimension :
FirstName
Créez un objet ICP et ajoutez la mesure suivante :
=GetFieldSelections(FirstName), pour renvoyer les valeurs de la sélection effectuée dans le champ FirstName.
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, puis effectuez les actions suivantes dans l'ordre dans lequel elles apparaissent dans le tableau :
Actions et résultats en mode d'analyse Action Résultats de l'ICP Sélectionnez John dans le filtre FirstName. La mesure renvoie la valeur : John.
Sélectionnez John et Peter dans le filtre FirstName. La mesure renvoie les valeurs : John, Peter.
Cliquez sur Modifier la feuille pour passer en mode d'édition, puis modifiez l'expression de la mesure ICP comme suit : =GetFieldSelections(FirstName,'; ') La mesure renvoie les valeurs avec le nouveau format value_sep : John; Peter.
Modifiez l'expression de la mesure ICP comme suit : =GetFieldSelections(FirstName,';', 2) La mesure renvoie les valeurs avec le nouvel espacement au format value_sep : John;Peter.
Cliquez sur Modifier la feuille pour revenir en mode d'analyse. Effacez les sélections du filtre FirstName, puis sélectionnez John, Sue et Mark. La mesure renvoie NOT Jane;Peter, car le nombre de sélections dépasse l'argument max_value 2. Si aucune valeur max_value n'est définie, tous les noms sélectionnés apparaîtront : John; Sue; Mark.
L'image suivante montre les résultats de la dernière action du tableau lorsque le nombre de sélections dépasse l'argument max_values.
Résultats de l'ICP lors de la sélection des prénoms John, Sue, et Mark
Dans cet exemple, vous pouvez voir comment les valeurs renvoyées par la fonction GetFieldSelections changent à mesure que des sélections sont effectuées.
Exemple - Scénario GetFieldSelections
Vue d'ensemble
La fonction GetFieldSelections est utilisée pour mettre en évidence les noms des clients à mesure de leur sélection.
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 :
OrderID
CustomerName
Product
Quantity
Script de chargement
Example:
LOAD * INLINE [
OrderID, CustomerName, Product, Quantity
1, John Doe, Laptop, 2
2, Jane Smith, Smartphone, 1
3, Ahmed Khan, Desk, 3
4, Maria Garcia, Chair, 1
5, Li Wei, Blender, 2
];Résultats
Chargez les données et ouvrez une feuille. Créez un nouveau volet de filtre et ajoutez ces champs comme dimensions :
CustomerName
Product
Créez un objet ICP et ajoutez la mesure suivante :
=GetFieldSelections(CustomerName).
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, puis sélectionnez Jane Smith et John Doe dans le filtre CustomerName.
La fonction GetFieldSelections renvoie les valeurs : Jane Smith, John Doe.
Vous pouvez voir les clients sélectionnés dans le volet de filtre de l'ICP.