Una variabile in Qlik Sense può essere definita come un raccoglitore che memorizza un valore statico o un calcolo, ad esempio un valore numerico o alfanumerico. Quando si utilizza la variabile nell'app, qualsiasi modifica apportata alla variabile viene applicata ovunque venga utilizzata. È possibile definire le variabili utilizzando la relativa panoramica o nello script tramite l'Editor di caricamento dati. Per impostare il valore di una variabile si utilizzano le istruzioni Let o Set nello script di caricamento dei dati.
Panoramica
Se il primo carattere del valore di una variabile è un segno di uguale ' = ', Qlik Sense tenta di valutare il valore come se si trattasse di una formula (espressione di Qlik Sense), quindi visualizza o restituisce il risultato anziché il testo effettivo della formula.
Quando vengono utilizzate, la variabile viene sostituita dal suo valore. Le variabili possono essere utilizzate nello script per l'espansione con simbolo del dollaro e in diverse istruzioni di controllo. Ciò si rivela molto utile se la stessa stringa viene ripetuta molte volte nello script, ad esempio un percorso.
Alcune variabili di sistema speciali vengono impostate da Qlik Sense all'inizio dell'esecuzione dello script, indipendentemente dai loro valori precedenti.
Definizione di una variabile
Le variabili forniscono la possibilità di memorizzare valori statici o il risultato di un calcolo. Quando si definisce una variabile, utilizzare la sintassi seguente:
o
let variable = expression
L'istruzione Set viene utilizzata per la valutazione della stringa. Assegna il testo a destra del segno di uguale alla variabile. L'istruzione Let valuta un'espressione a destra del segno di uguale al momento di eseguire lo script e assegna il risultato dell'espressione alla variabile.
Le variabili fanno distinzione tra maiuscole e minuscole.
Esempi:
set x = 3 + 4; // la variabile otterrà la stringa '3 + 4' come valore.
let x = 3 + 4; // restituisce 7 come valore.
set x = Today(); // restituisce 'Today()' come valore.
let x = Today(); // restituisce la data di oggi come valore, per esempio, '27/9/2021'.
Denominazione delle variabili
Come best practice, si consiglia di utilizzare una convenzione di denominazione standardizzata per le variabili create dall'utente in un'app. Ad esempio, si può fare in modo che tutti i nomi delle variabili inizino con v. Ad esempio: vUserText. In questo modo, si garantisce che le variabili vengano riconosciute rapidamente come tali e differenziate da misure, campi e funzioni.
Opzioni aggiuntive durante la definizione delle variabili
Questa sezione elenca funzionalità aggiuntive che è possibile utilizzare per migliorare la potenza delle variabili definite nello script di caricamento.
Limitazione dei valori delle variabili
È possibile utilizzare le istruzioni Constrain per limitare le variabili script a definizioni specifiche, impedendo il caricamento di valori indesiderati. Le istruzioni Constrain possono essere utilizzate per la garanzia della qualità, una migliore collaborazione durante lo sviluppo congiunto di script e una maggiore sicurezza per le app di analisi. In Qlik Cloud, le istruzioni Constrain possono essere utilizzate anche in combinazione con l'API per sviluppatori per aggiornamenti dinamici delle variabili in fase di ricaricamento.
Per ulteriori informazioni, vedere Constrain.
Definizione di variabili solo script
È possibile utilizzare la variabile di sistema ScriptOnlyVariables per impostare variabili solo script. Una variabile solo script è disponibile solo nello script di caricamento e non viene visualizzata, ad esempio, nella vista foglio nell'applicazione.
Per ulteriori informazioni, vedere ScriptOnlyVariables.
Eliminazione di variabili
È possibile utilizzare un'istruzione Drop variable per eliminare le variabili nello script. L'eliminazione di una variabile è utile quando si desidera utilizzare una variabile solo per eseguire calcoli o definire campi nel contesto del modello dati.
Per ulteriori informazioni, vedere Drop variable.
Cancellare una variabile
Rimuovendo una variabile dallo script e ricaricando i dati, la variabile resta nell’app. Se si desidera rimuovere completamente la variabile dall’app, è possibile eseguire una delle seguenti operazioni:
Eliminare la variabile dalla finestra di dialogo delle variabili.
Eliminare la variabile nello script utilizzando un'istruzione Drop variable.
Impostare le variabili non necessarie nella finestra di dialogo delle variabili come variabili solo script utilizzando la variabile di sistema ScriptOnlyVariables nello script.
Per ulteriori informazioni, vedere Cancellare una variabile.
Caricamento di un valore della variabile come valore di campo
Se si desidera caricare un valore della variabile come valore di campo in un'istruzione LOAD e il risultato dell'espansione del simbolo del dollaro restituisce del testo invece che dei numeri o un'espressione, la variabile espansa deve essere racchiusa tra virgolette singole.
Esempio:
In questo esempio, la variabile di sistema contenente l'elenco degli errori di script viene caricata in una tabella. Si può notare che l'espansione di ScriptErrorCount nella clausola If non richiede virgolette, mentre l'espansione di ScriptErrorList richiede le virgolette.
Calcolo della variabile
Esistono diversi modi per utilizzare le variabili con i valori calcolati in Qlik Sense e il risultato dipende dal metodo di definizione e dal metodo di richiamo in un'espressione.
In questo esempio, sono stati caricati dei dati in linea:
Si definiscano due variabili:
Nella seconda variabile un segno di uguale verrà aggiunto prima dell'espressione. Ciò attiverà il calcolo della variabile prima che ne venga eseguita l'espansione e prima che l'espressione venga valutata.
Se si utilizza la variabile vSales senza modifiche, ad esempio in una misura, il risultato sarà la stringa Sum(Sales), vale a dire non verrà eseguito alcun calcolo.
Se si aggiunge un'espansione con simbolo del dollaro e si richiama $(vSales) nell'espressione, la variabile viene estesa e viene visualizzata la somma di Sales.
Infine, se si richiama $(vSales2), la variabile verrà calcolata prima di essere espansa. Ciò significa che il risultato visualizzato è la somma totale di Sales. In questo grafico, la differenza tra l'uso di =$(vSales) e =$(vSales2) come espressioni di misura restituisce i risultati:
| Dim | $(vSales) | $(vSales2) |
|---|---|---|
| A | 350 | 1560 |
| B | 470 | 1560 |
| C | 740 | 1560 |
Come si può vedere, $(vSales) risulta nella somma parziale di un valore di dimensione, mentre $(vSales2) risulta nella somma totale.
Sono disponibili le seguenti variabili di script:
- Variabili di errore
- Variabili di interpretazione numerica
- Variabili di sistema
- Variabili di gestione del valore