GetFieldSelections() retourneert een tekenreeks met de huidige selecties in een veld.
Als alle waarden op één of twee na worden geselecteerd, wordt respectievelijk de indeling 'NOT x,y' of 'NOT y' gebruikt. Als u alle waarden selecteert en het aantal waarden is groter dan max_values, wordt de tekst ALL geretourneerd.
Syntaxis:
GetFieldSelections ( field_name [, value_sep [, max_values [, state_name]]])
Retourgegevenstypen: tekenreeks
| Notatie | Beschrijving |
|---|---|
| 'a, b, c' |
Als het aantal geselecteerde waarden max_values of minder is, is de tekenreeks die wordt geretourneerd, een lijst met de geselecteerde waarden. De waarden worden gescheiden met value_sep als scheidingsteken. |
| 'NOT a, b, c' |
Als het aantal niet-geselecteerde waarden max_values of minder is, is de tekenreeks die wordt geretourneerd, een lijst met niet-geselecteerde waarden met NOT als een voorvoegsel. De waarden worden gescheiden met value_sep als scheidingsteken. |
| 'x of y' |
x = het aantal geselecteerde waarden y = het totale aantal waarden Dit wordt geretourneerd wanneer max_values < x < ( y - max_values). |
| 'ALL' | Geretourneerd als alle waarden zijn geselecteerd. |
| '-' | Geretourneerd als geen waarde is geselecteerd. |
| <search string> | Als u een selectie hebt gemaakt met behulp van een zoekopdracht, wordt de zoekreeks geretourneerd. |
| Argumenten | Beschrijving |
|---|---|
| field_name | Het veld met het bereik van gegevens die moeten worden gemeten. |
| value_sep | Het scheidingsteken dat tussen twee veldwaarden moet worden geplaatst. De standaardwaarde is ', '. |
| max_values | Het maximale aantal veldwaarden dat afzonderlijk moet worden vermeld. Als een groter aantal waarden wordt geselecteerd, wordt de notatie 'x van y waarden' gebruikt. De standaardwaarde is 6. |
| state_name | De naam van een alternatieve state die voor de specifieke visualisatie is gekozen. Als het argument state_name wordt gebruikt, wordt alleen rekening gehouden met de selecties die zijn gekoppeld aan de opgegeven statenaam. Ga voor meer informatie naar Alternatieve states gebruiken voor vergelijkende analyse. |
| Voorbeeld | Resultaat |
|---|---|
GetFieldSelections( FirstName ) | Retourneert '-' (NULL) als er geen selectie is gemaakt in het veld FirstName. Anders wordt de waarde van de selecties geretourneerd, bijvoorbeeld John. |
Voorbeeld - Basisprincipes voor GetFieldSelections
Overzicht
Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.
Het load-script bevat:
Een gegevensverzameling die wordt geladen in een tabel met de naam Example.
De volgende velden in de gegevenstabel:
FirstName
LastName
Initials
HasCellphone
Load-script
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 '|');Resultaten
Laad de gegevens en open een werkblad. Maak een nieuw filtervak en voeg dit veld toe als dimensie:
FirstName
Voeg een KPI-object toe en maak dan de volgende meting:
=GetFieldSelections(FirstName), om de waarden van de selectie in het veld FirstName te retourneren.
TipIn dit voorbeeld is de opmaak van de KPI aangepast om een responsief lay-outgedrag te gebruiken, zodat de uitvoer gemakkelijker te bekijken is. Zie voor meer informatie over het wijzigen van het lay-outgedrag van het diagram De stijl van de KPI aanpassenKlik op Werkblad bewerken om over te schakelen naar de analysemodus en voer de volgende acties uit in de volgorde zoals ze verschijnen in de tabel:
Acties en resultaten in de analysemodus Actie KPI-resultaten Selecteer John in het filter FirstName. De meting retourneert de waarde: John.
Selecteer John en Peter in het filter FirstName. De meting retourneert de waarden: John, Peter.
Klik op Werkblad bewerken om over te schakelen naar de bewerkingsmodus en bewerk vervolgens de KPI-metinguitdrukking als volgt: =GetFieldSelections(FirstName,'; ') De meting retourneert de waarden met de nieuwe value_sep indeling: John; Peter.
Bewerk de KPI-metinguitdrukking als volgt: =GetFieldSelections(FirstName,';', 2) De meting retourneert de waarden met de nieuwe value_sep indeling: John;Peter.
Klik op Werkblad bewerken om terug te schakelen naar de analysemodus. Wis de selecties van het filter FirstName en selecteer vervolgens John, Sue en Mark. De meting retourneert NOT Jane;Peter, omdat het aantal selecties groter is dan het argument max_value van 2. Als er geen max_value is ingesteld, worden alle geselecteerde namen weergegeven: John; Sue; Mark.
De volgende afbeelding toont de resultaten van de laatste actie in de tabel waarbij het aantal selecties groter is dan het argument max_values.
KPI-resultaten van de selectie van de voornamen John, Sue, en Mark
In dit voorbeeld kunt u zien hoe de waarden die door de functie GetFieldSelections worden geretourneerd, veranderen naarmate er selecties worden gemaakt.
Voorbeeld - Scenario met GetFieldSelections
Overzicht
De functie GetFieldSelections wordt gebruikt om namen van klanten te markeren wanneer ze worden geselecteerd.
Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.
Het load-script bevat:
Een gegevensverzameling die wordt geladen in een tabel met de naam Example.
De volgende velden in de gegevenstabel:
OrderID
CustomerName
Product
Quantity
Load-script
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
];Resultaten
Laad de gegevens en open een werkblad. Maak een nieuw filtervak en voeg deze velden toe als dimensies:
CustomerName
Product
Voeg een KPI-object toe en maak dan de volgende meting:
=GetFieldSelections(CustomerName).
TipIn dit voorbeeld is de opmaak van de KPI aangepast om een responsief lay-outgedrag te gebruiken, zodat de uitvoer gemakkelijker te bekijken is. Zie voor meer informatie over het wijzigen van het lay-outgedrag van het diagram De stijl van de KPI aanpassen.Klik op Werkblad bewerken om over te schakelen naar de analysemodus en selecteer vervolgens Jane Smith en John Doe in het filter CustomerName.
De functie GetFieldSelections retourneert de waarden: Jane Smith, John Doe.
U kunt de geselecteerde klanten zien in het filtervak in de KPI.