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 Werte bis auf zwei oder alle Werte 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 | 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. Der 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. |
| Beispiel | Ergebnis |
|---|---|
GetCurrentSelections () | Gibt (-) zurück, wenn in keinem Feld eine Auswahl getroffen wurde. Wenn eine Auswahl getroffen wurde, ist der zurückgegebene Wert der Feldname und der Wert, zum Beispiel First Name : John. |
Beispiel – Grundlegendes zu „GetCurrentSelections“
Übersicht
Dieses Beispiel zeigt Ihnen, wie sich die von der Funktion GetCurrentSelections zurückgegebenen Werte je nach den von Ihnen getroffenen Auswahlen ändern.
Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in einen neuen Abschnitt ein.
Das Ladeskript umfasst:
Datensatz, der in eine Datentabelle namens Example geladen wird
Die folgenden Felder in der Datentabelle:
FirstName
LastName
Initials
HasCellphone
Ladeskript
Example:
LOAD * inline [
FirstName|LastName|Initials|HasCellphone
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 '|');Ergebnisse
Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie ein neues Filterfenster und fügen Sie die folgenden Felder als Dimensionen hinzu:
FirstName
Initials
Fügen Sie ein KPI-Objekt hinzu und erstellen Sie dann die folgende Kennzahl:
=GetCurrentSelections (), um die aktuellen Auswahlen zu suchen.
Der KPI gibt (-) zurück, weil keine Werte ausgewählt sind.
Klicken Sie auf Arbeitsblatt bearbeiten, um in den Analysemodus zu wechseln, und wählen Sie im Feld FirstName den Wert John aus. Der KPI gibt Folgendes zurück: FirstName: John.
Wählen Sie nun Peter aus, sodass sowohl John als auch Peter ausgewählt sind. Der KPI gibt Folgendes zurück: FirstName: John, Peter.
Ergänzen Sie die Auswahl, indem Sie im Feld Initials die Option JA auswählen. Der KPI gibt Folgendes zurück: First name: John, Peter Initials: JA.
Löschen Sie die Auswahl und gehen Sie folgendermaßen vor:
Wählen Sie im Feld FirstName die Option John und im Feld Initials die Option JA aus.
Bearbeiten Sie die KPI-Formel wie folgt: =GetCurrentSelections ( chr(13)&chr(10) , ' = ' ), um das Tag-Trennzeichen in ein Gleichheitszeichen (=) zu ändern.
InformationshinweisKPI unterstützt keine Zeilenumbrüche und fügt ein Leerzeichen als Datensatztrennzeichen ein.
Löschen Sie die Auswahl und gehen Sie folgendermaßen vor:
Wählen Sie im Feld FirstName alle Namen außer Sue aus.
Bearbeiten Sie die KPI-Formel wie folgt: =GetCurrentSelections (chr(13)&chr(10), '=', ',' ,3), um ein Tag-Trennzeichen (=), ein Werttrennzeichen (,) und die maximale Anzahl der aufzulistenden Werte (3) hinzuzufügen.
Der KPI gibt den Wert FirstName=NOT Sue zurück, weil vier Namen ausgewählt wurden, das Argument max_values aber nur drei auflistet. Wenn Sie das Argument max_values in 4 ändern, werden alle vier Werte separat mit der gleichen Auswahl aufgelistet.
Beispiel – Anpassen eines Diagrammtitels zur Anzeige von Auswahlen
Übersicht
Dieses Beispiel zeigt, wie Sie die Funktion GetCurrentSelections verwenden können, um dynamische Diagrammtitel auf der Grundlage der Benutzerauswahl zu erstellen.
Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in einen neuen Abschnitt ein.
Das Ladeskript umfasst:
Datensatz, der in eine Datentabelle namens Example geladen wird
Die folgenden Felder in der Datentabelle:
SalesID
Product
Year
Region
SalesAmount
Ladeskript
Example:
LOAD * INLINE [
SalesID, Product, Year, Region, SalesAmount
1, WidgetA, 2021, North, 500
2, WidgetB, 2021, South, 600
3, WidgetC, 2021, East, 450
4, WidgetA, 2021, West, 700
5, WidgetB, 2022, North, 550
6, WidgetC, 2022, South, 425
7, WidgetB, 2022, East, 650
8, WidgetC, 2022, West, 250
9, WidgetB, 2023, North, 650
10, WidgetC, 2023, South, 325
11, WidgetB, 2023, East, 550
12, WidgetC, 2023, West, 450
13, WidgetB, 2024, North, 550
14, WidgetC, 2024, South, 525
15, WidgetB, 2024, East, 350
16, WidgetC, 2024, West, 650
];Ergebnisse
Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie ein neues Filterfenster und fügen Sie die folgenden Felder als Dimensionen hinzu:
Region
Year
Erstellen Sie ein Liniendiagramm und fügen Sie die folgenden Dimensionen hinzu:
Year
Region
Erstellen Sie die folgende Kennzahl:
=Sum(SalesAmount), um den Gesamtumsatz anzuzeigen.
Geben Sie im Eigenschaftsfenster der Kennzahl unter Darstellung > Allgemein > Titel die folgenden Formel ein: ='Sales Analysis for: ' & GetCurrentSelections().
Die Ergebnisse zeigen die Summe der Umsätze für alle Regionen und Jahre. Der Diagrammtitel wird als Sales Analysis for: angezeigt.
Klicken Sie auf Arbeitsblatt bearbeiten, um in den Analysemodus zu wechseln, und treffen Sie die folgenden Auswahlen:
Wählen Sie im Feld Region die Optionen East und North aus.
Wählen Sie im Feld Year die Optionen 2022 und 2023 aus.
Der Diagrammtitel ändert sich und zeigt die Filterauswahl für Region und Year.