GetCurrentSelections - Diagrammfunktion
GetCurrentSelections() gibt eine Liste der aktuellen Auswahlen in der App zurück. Wenn die Auswahlen stattdessen anhand einer Suchzeichenfolge in einem Suchfeld getroffen werden, gibt GetCurrentSelections() die Suchzeichenfolge zurück.
Wenn Optionen verwendet werden sollen, müssen Sie record_sep definieren. Definieren Sie eine neue Zeile, indem Sie record_sep als chr(13)&chr(10) angeben.
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:
GetCurrentSelections ([record_sep [, tag_sep [, value_sep [, max_values [, state_name]]]]])
Rückgabe Datentyp: String
Argumente:
Argumente | Beschreibung |
---|---|
record_sep | Trennzeichen zwischen Felddatensätzen. Standard ist <CR><LF>, d. h. eine neue Zeile. |
tag_sep | Trennzeichen zwischen dem Feldnamen und den Feldwerten. Standard ist ':'. |
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 Verwenden von alternativen Zuständen für vergleichende Analysen. |
Beispiele und Ergebnisse:
Im folgenden Beispiel werden zwei Felder verwendet, die in verschiedene Filterfenster geladen wurden: eins für First name und eins für Initials.
Beispiele | Ergebnisse |
---|---|
Vorgabe: John ist in First name ausgewählt. GetCurrentSelections () |
'First name: John' |
Vorgabe: John und Peter sind in First name ausgewählt. GetCurrentSelections () |
'First name: John, Peter' |
Vorgabe: John und Peter sind in First name ausgewählt und JA ist in Initials ausgewählt. GetCurrentSelections () |
'First name: John, Peter Initials: JA' |
Vorgabe: John ist in First name ausgewählt und JA ist in Initials ausgewählt. GetCurrentSelections ( chr(13)&chr(10) , ' = ' ) |
'First name = John Initials = JA' |
Vorgabe: Sie haben alle Namen außer Sue in First name und keine Werte in Initials ausgewählt. GetCurrentSelections (chr(13)&chr(10), '=', ',' ,3) |
'First name=NOT Sue' |
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 '|');