GetFieldSelections() liefert einen String mit der aktuellen Auswahl in einem Feld.
Wenn alle bis auf zwei oder alle bis auf einen Wert ausgewählt sind, wird das Format 'NOT x,y' beziehungsweise 'NOT y' verwendet. Wenn Sie alle Werte auswählen und die Anzahl aller Werte größer als max_values ist, wird der Text ALL ausgegeben.
Syntax:
GetFieldSelections ( field_name [, value_sep [, max_values [, state_name]]])
Rückgabe Datentyp: String
| Format | Beschreibung |
|---|---|
| 'a, b, c' |
Wenn die Anzahl der ausgewählten Werte max_values oder weniger beträgt, ist der zurückgegebene String eine Liste der ausgewählten Werte. Die Werte werden mit value_sep als Trennzeichen getrennt. |
| 'NOT a, b, c' |
Wenn die Anzahl der nicht ausgewählten Werte max_values oder weniger beträgt, ist der zurückgegebene String eine Liste der nicht ausgewählten Werte mit vorangestelltem NOT. Die Werte werden mit value_sep als Trennzeichen getrennt. |
| 'x of y' |
x = Anzahl der ausgewählten Werte y = Gesamtzahl der Werte Dies wird zurückgegeben, wenn max_values < x < ( y - max_values). |
| 'ALL' | Wird zurückgegeben, wenn alle Werte ausgewählt sind. |
| '-' | Wird zurückgegeben, wenn kein Wert ausgewählt ist. |
| <search string> | Wenn Sie anhand einer Suche ausgewählt haben, wird der Such-String zurückgegeben. |
Argumente:
| Argumente | Beschreibung |
|---|---|
| field_name | Das Feld mit dem Datenbereich, der angegeben werden soll. |
| value_sep | Das Trennzeichen zwischen Feldwerten. Standard ist ','. |
| max_values |
Die maximale Zahl der einzeln aufgeführten Feldwerte. Wird eine größere Anzahl an Werten ausgewählt, wird das Format 'x von y Werten' verwendet. Standard ist 6. |
| state_name |
Der Name eines alternativen Status, der für diese Visualisierung ausgewählt wurde. Beim Argument state_name werden nur die Auswahlen für den angegebenen Statusnamen berücksichtigt. Weitere Informationen finden Sie unter Using alternate states for comparative analysis. |
Beispiele und Ergebnisse:
Im folgenden Beispiel wird das in ein Filterfenster geladene Feld First name verwendet.
| Beispiele | Ergebnisse |
|---|---|
|
Vorgabe: John ist in First name ausgewählt. GetFieldSelections ([First name]) |
'John' |
|
Vorgabe: John und Peter sind ausgewählt. GetFieldSelections ([First name]) |
'John,Peter' |
|
Vorgabe: John und Peter sind ausgewählt. GetFieldSelections ([First name],'; ') |
'John; Peter' |
|
Vorgabe: John, Sue, Mark sind in First name ausgewählt. GetFieldSelections ([First name],';',2) |
'NOT Jane;Peter', weil der Wert 2 als Wert des Arguments max_values angegeben ist. Anderenfalls wäre das Ergebnis Folgendes gewesen: John; Sue; Mark. |
Im Beispiel verwendete Daten:
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 '|');