GetCurrentSelections() restituisce un elenco delle selezioni attuali all'interno dell'app. Se invece le selezioni vengono effettuate usando una stringa di ricerca all'interno di una casella di ricerca, GetCurrentSelections() restituisce la stringa di ricerca.
Se vengono utilizzate opzioni, è necessario specificare record_sep. Per specificare una nuova riga, impostare record_sep su chr(13)&chr(10).
Se vengono selezionati tutti i valori meno due o tutti i valori meno uno, verrà utilizzato rispettivamente il formato "NOT x,y" o "NOT y". Se si selezionano tutti i valori e il conteggio dei valori è superiore a max_values, verrà restituito il testo ALL.
Sintassi:
GetCurrentSelections ([record_sep [, tag_sep [, value_sep [, max_values [, state_name]]]]])
Tipo di dati restituiti: stringa
| Argomenti | Descrizione |
|---|---|
| record_sep | Il separatore da inserire tra i record del campo. Il valore predefinito è <CR><LF> che significa una nuova linea. |
| tag_sep | Il separatore da inserire tra il tag del nome di campo e i valori del campo. Il valore predefinito è ": ". |
| value_sep | Il separatore da inserire tra i valori di campo. Il valore predefinito è ', '. |
| max_values | Il numero massimo di valori di campo da elencare singolarmente. Se si seleziona un numero maggiore di valori, verrà utilizzato il formato 'x di y valori'. Il valore predefinito è 6. |
| state_name | Il nome di uno stato alternato che è stato scelto per la specifica visualizzazione. Se viene utilizzato l'argomento state_name, saranno prese in considerazione solo le selezioni associate al nome dello stato specificato. Per ulteriori informazioni, vedere Uso degli stati alternati per l'analisi comparativa. |
| Esempio | Risultato |
|---|---|
GetCurrentSelections () | Restituisce (-) se non è stata effettuata alcuna selezione per nessuno dei campi. Se sono state effettuate delle selezioni, i valori restituiti sono il nome del campo e il valore, ad esempio First Name : John. |
Esempio: principi fondamentali della funzione GetCurrentSelections
Panoramica
Questo esempio mostra come i valori restituiti dalla funzione GetCurrentSelections cambiano in base alle selezioni effettuate.
Aprire l'Editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova sezione.
Lo script di caricamento contiene:
Un set di dati che viene caricato in una tabella dati chiamata Example.
I seguenti campi nella tabella dati:
FirstName
LastName
Initials
HasCellphone
Script di caricamento
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 '|');Risultati
Caricare i dati e aprire un foglio. Creare una nuova casella di filtro e aggiungere questi campi come dimensioni:
FirstName
Initials
Aggiungere un oggetto KPI, quindi creare la seguente misura:
=GetCurrentSelections (), per visualizzare le selezioni correnti.
Il KPI restituisce (-) perché non sono stati selezionati valori.
Fare clic su Modifica foglio per passare alla modalità di analisi quindi, nel campo FirstName, selezionare John. Il KPI restituisce il seguente valore: FirstName: John.
Ora selezionare Peter, in modo da selezionare sia John che Peter. Il KPI restituisce il seguente valore: FirstName: John, Peter.
Aggiungere un valore alla selezione selezionando JA dal campo Initials. Il KPI restituisce il seguente valore: First name: John, Peter Initials: JA.
Annullare la selezione ed eseguire una delle seguenti operazioni:
Selezionare John dal campo FirstName e JA dal campo Initials.
Modificare l'espressione KPI come segue: =GetCurrentSelections ( chr(13)&chr(10) , ' = ' ) per cambiare il separatore di tag nel segno uguale (=).
Nota informaticaIl KPI non supporta le interruzioni di riga e aggiunge uno spazio come separatore dei record.
Annullare la selezione ed eseguire una delle seguenti operazioni:
Selezionare tutti i nomi tranne Sue nel campo FirstName.
Modificare l'espressione KPI come segue: =GetCurrentSelections (chr(13)&chr(10), '=', ',' ,3) per aggiungere un separatore di tag (=), un separatore di valori (,) e il numero massimo di valori da elencare (3).
Il KPI restituisce il valore FirstName=NOT Sue, perché sono stati selezionati quattro nomi, ma l'argomento max_values ne può elencare solo tre. Se si cambia l'argomento max_values in 4, tutti e quattro i valori saranno elencati separatamente con la stessa selezione.
Esempio: personalizzare il titolo di un grafico per mostrare le selezioni
Panoramica
Questo esempio mostra come utilizzare la funzione GetCurrentSelections per creare titoli di grafici dinamici in base alla selezione dell'utente.
Aprire l'Editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova sezione.
Lo script di caricamento contiene:
Un set di dati che viene caricato in una tabella dati chiamata Example.
I seguenti campi nella tabella dati:
SalesID
Product
Year
Region
SalesAmount
Script di caricamento
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
];Risultati
Caricare i dati e aprire un foglio. Creare una nuova casella di filtro e aggiungere questi campi come dimensioni:
Region
Year
Creare un grafico lineare e aggiungere le seguenti dimensioni:
Year
Region
Creare la seguente misura:
=Sum(SalesAmount), per visualizzare il totale delle vendite.
Nel pannello delle proprietà della misura, in Aspetto > Generale > Titolo, inserire la seguente espressione: ='Sales Analysis for: ' & GetCurrentSelections().
I risultati mostrano la somma delle vendite per tutti gli anni e le regioni. Il titolo del grafico appare come Sales Analysis for:.
Fare clic su Modifica foglio per passare alla modalità di analisi, quindi effettuare le seguenti selezioni:
Nel campo Regione selezionare East e North.
Nel campo Anno selezionare 2022 e 2023.
Il titolo del grafico cambia per mostrare le selezioni del filtro per Region e Year.