GetCurrentSelections - diagramfunctie

GetCurrentSelections() retourneert een lijst van de huidige selecties in de app. Als de selecties in plaats daarvan zijn gemaakt met een zoekreeks in een zoekvak, retourneert GetCurrentSelections() de zoekreeks.

Als opties worden gebruikt, moet u record_sep opgeven. U kunt een nieuw regel opgeven door record_sep in te stellen op chr(13)&chr(10).

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:

GetCurrentSelections ([record_sep [, tag_sep [, value_sep [, max_values [, state_name]]]]])

Retourgegevenstypen: tekenreeks

Argumenten
Argumenten	Beschrijving
record_sep	Het scheidingsteken dat tussen veldrecords moet worden geplaatst. De standaardinstelling is <CR><LF>, oftewel een nieuwe regel.
tag_sep	Het scheidingsteken dat tussen de tag van de veldnaam en de veldwaarden moet worden geplaatst. De standaardinstelling is ': '.
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 states gebruiken voor vergelijkende analyse.

Voorbeeld: diagramuitdrukkingen
Voorbeeld	Resultaat
GetCurrentSelections ()	Retourneert (-) als er geen selectie is gemaakt in een van de velden. Als er selecties zijn gemaakt, dan is de geretourneerde waarde de veldnaam en de waarde, bijvoorbeeld First Name : John.

Voorbeeld - Basisprincipes voor GetCurrentSelections

Overzicht

Dit voorbeeld laat zien hoe de waarden die de functie GetCurrentSelections retourneert, veranderen volgens de selecties die u maakt.

Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.

Het load-script bevat:

Een gegevensverzameling die wordt geladen in een tabel met de naam Example.
De volgende velden in de gegevenstabel:
- FirstName
- LastName
- Initials
- HasCellphone

Load-script

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 '|');

Resultaten

Laad de gegevens en open een werkblad. Maak een nieuw filtervak en voeg deze velden toe als dimensies:
- FirstName
- Initials
Voeg een KPI-object toe en maak dan de volgende meting:
- =GetCurrentSelections (), om de huidige selecties te vinden.
  De KPI retourneert (-) omdat er geen waarden zijn geselecteerd.

In dit voorbeeld is de opmaak van de KPI aangepast om een responsief lay-outgedrag te gebruiken, zodat de uitvoer gemakkelijker te bekijken is. Zie voor meer informatie over het wijzigen van het lay-outgedrag van het diagram De stijl van de KPI aanpassen.

Klik op Werkblad bewerken om over te schakelen naar de analysemodus en selecteer vervolgens John in het veld FirstName. De KPI retourneert het volgende resultaat: FirstName: John.
- Selecteer nu Peter, zodat zowel John als Peter geselecteerd zijn. De KPI retourneert het volgende: FirstName: John, Peter.
- Voeg toe aan de selectie door JA te selecteren in het veld Initials. De KPI retourneert het volgende: First name: John, Peter Initials: JA.
Wis de selectie en doe het volgende:
- Selecteer John in het veld FirstName en JA in het veld Initials.
- Bewerk de KPI-uitdrukking als volgt: =GetCurrentSelections ( chr(13)&chr(10) , ' = ' ), om het tagscheidingsteken te wijzigen in een gelijkheidsteken (=).
  InformatieKPI ondersteunt geen regeleinden en voegt een spatie toe als recordscheidingsteken.
Wis de selectie en doe het volgende:
- Selecteer alle namen behalve Sue in het veld FirstName.
- Bewerk de KPI-uitdrukking als volgt: =GetCurrentSelections (chr(13)&chr(10), '=', ',' ,3), om een tagscheidingsteken (=), een waardescheidingsteken (,), en het maximale aantal waarden toe te voegen om op te sommen (3).
  
  De KPI retourneert de waarde : FirstName=NOT Sue omdat er vier namen zijn geselecteerd, maar het argument max_values geeft er maar drie. Als u het argument max_values wijzigt in 4, worden alle vier de waarden afzonderlijk weergegeven met dezelfde selectie.

Voorbeeld - Een diagramtitel aanpassen om selecties weer te geven

Overzicht

Dit voorbeeld laat zien hoe u de functie GetCurrentSelections kunt gebruiken om dynamische diagramtitels te maken op basis van de gebruikersselectie.

Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.

Het load-script bevat:

Een gegevensverzameling die wordt geladen in een tabel met de naam Example.
De volgende velden in de gegevenstabel:
- SalesID
- Product
- Year
- Region
- SalesAmount

Load-script

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

Resultaten

Laad de gegevens en open een werkblad. Maak een nieuw filtervak en voeg deze velden toe als dimensies:
- Region
- Year
Maak een lijndiagram en voeg de volgende dimensies toe:
- Year
- Region
Maak de volgende meting:
- =Sum(SalesAmount), om de totale verkoop weer te geven.
In het eigenschappenvenster van de meting, onder Uiterlijk > Algemeen > Titel, voert u de volgende uitdrukking in: ='Sales Analysis for: ' & GetCurrentSelections().

De resultaten tonen de som van verkopen voor alle regio's en jaren. De diagramtitel verschijnt als Sales Analysis for:.
Klik op Werkblad bewerken om over te schakelen naar de analysemodus en maak de volgende selecties:
- Selecteer in het veld Regio East en North.
- Selecteer in het veld Jaar 2022 en 2023.
  De diagramtitel verandert om de filterselecties voor Region en Year weer te geven.

Was deze pagina nuttig?

Als u problemen ervaart op deze pagina of de inhoud onjuist is – een typfout, een ontbrekende stap of een technische fout – laat het ons weten zodat we dit kunnen verbeteren!

Geef hier uw feedback