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
| Opmaak | Beschrijving |
|---|---|
| 'a, b, c' |
Als het aantal geselecteerde waarden max_values of minder is, wordt een tekenreeks met een lijst van de geselecteerde waarden geretourneerd. De waarden worden gescheiden met value_sep als scheidingsteken. |
| 'NOT a, b, c' |
Als het aantal niet-geselecteerde waarden max_values of minder is, wordt een tekenreeks met een lijst van de niet-geselecteerde waarden met NOT als prefix geretourneerd. De waarden worden gescheiden met value_sep als scheidingsteken. |
| 'x of y' |
x = het aantal geselecteerde waarden y = het totaal aantal waarden Dit wordt geretourneerd als max_values < x < ( y - max_values). |
| 'ALL' | Wordt geretourneerd als alle waarden zijn geselecteerd. |
| '-' | Wordt geretourneerd als er geen waarde is geselecteerd. |
| <search string> | Als u hebt geselecteerd door middel van een zoekopdracht, wordt de zoekreeks geretourneerd. |
Argumenten:
- 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 is gekozen voor de specifieke visualisatie. Als het argument state_name is gebruikt, worden alleen de selecties die zijn gekoppeld aan de opgegeven state meegenomen. Zie voor meer informatie Alternatieve status.
Voorbeelden
In het volgende voorbeeld wordt het veld First name gebruikt dat naar een keuzelijst is geladen.
Voorbeeld 1: John is geselecteerd in First name
GetFieldSelections ([First name])
retourneert 'John'
Voorbeeld 2: John en Peter zijn geselecteerd in First name
GetFieldSelections ([First name])
retourneert 'John,Peter'
Voorbeeld 3: John en Peter zijn geselecteerd in First name
GetFieldSelections ([First name],'; ')
retourneert 'John; Peter'
Voorbeeld 4: John, Sue, Mark zijn geselecteerd in First name
GetFieldSelections ([First name],';',2)
retourneert 'NOT Jane;Peter', omdat de waarde 2 is aangegeven als de waarde van het argument max_values. Anders zou het resultaat John; Sue; Mark. zijn geweest.
Gebruikte gegevens in voorbeeld:
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 '|');
