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]]]]])

Return data type: String

Arguments:

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.

Examples and results:

Im folgenden Beispiel werden zwei Felder verwendet, die in verschiedene Filterfenster geladen wurden: eins für First name und eins für Initials.

Beispiele und Ergebnisse
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 '|');