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:
- 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 status.
Voorbeelden
Het volgende voorbeeld gebruikt het veld First name dat in 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 '|');
