GetSysAttr - funzione dello script e del grafico

In questo esempio, viene definito un set di variabili dello script che è possibile usare nei contenuti dell'app creati dall'utente. Ogni volta che l'app viene ricaricata, gli attributi verranno valutati e aggiunti all'app.

Procedere come indicato di seguito:

1. Creare una nuova app Qlik Sense in uno spazio condiviso.

2. Aprire Editor caricamento dati.

3. Incollare il seguente script di caricamento in una nuova scheda:

   Transactions:
   						
   Load * inline [
   id,date,amount
   1,1/1/2023,500.67
   2,1/2/2023,458.91
   3,1/3/2023,12.34
   4,1/4/2023,90.90
   5,1/5/2023,256.30
   6,1/6/2023,789.16
   7,1/7/2023,501.25
   8,1/8/2023,87.01
   9,1/9/2023,161.16
   10,1/10/2023,300.06
   ];
   
   Let vTenantId = GetSysAttr('tenantId');
   Let vTenantName = GetSysAttr('tenantName');
   Let vTenantUrl = GetSysAttr('tenantUrl');
   Let vTenantUrlAlias = GetSysAttr('tenantUrlAlias');
   Let vTenantRegion = GetSysAttr('tenantRegion');
   Let vSpaceId = GetSysAttr('spaceId');
   Let vSpaceName = GetSysAttr('spaceName');
   Let vSpaceType = GetSysAttr('spaceType');

Lo script di caricamento contiene i seguenti elementi:

• Una nuova tabella, denominata Transactions, contenente i dati della transazione di esempio. È possibile sostituire questi ultimi con qualsiasi dato, e vengono aggiunti come segnaposto.

• Una serie di definizioni della variabile dello script, per gli attributi disponibili che è possibile recuperare tramite GetSysAttr().

Caricare i dati e aprire un nuovo foglio in modalità di modifica avanzata.

Creare un oggetto Tabella e aggiungere le seguenti espressioni come dimensioni, insieme alle rispettive etichette:

• =vTenantId, con etichetta Tenant ID

• =vTenantName, con etichetta Tenant Name

• =vTenantUrl, con etichetta Tenant URL (Default)

• =vTenantUrlAlias, con etichetta Tenant URL (Alias)

• =vTenantRegion, con etichetta Tenant Region

• =vSpaceId, con etichetta Space ID

• =vSpaceName, con etichetta Space Name

• =vSpaceType, con etichetta Space Type

Ora si dispone di una tabella nella propria app, che visualizza in modo dinamico ciascuno degli attributi disponibili dell'ambiente. L'esportazione dell'app e il suo caricamento su un tenant e uno spazio differenti forniscono all'utente questi attributi per la versione appena caricata dell'app.

In questo esempio, anziché definire le variabili nello script, viene definita una serie di variabili utilizzando la finestra di dialogo nella modalità di modifica avanzata. Le variabili possono essere utilizzate quindi nelle espressioni del grafico nell'app.

Procedere come indicato di seguito:

1. Creare una nuova app Qlik Sense in uno spazio condiviso.

2. Aprire un nuovo foglio in modalità di modifica avanzata.

3. Fare clic su per aprire la finestra di dialogo delle variabili.

4. Fare clic su Crea nuovo.

5. In Nome, inserire vTenantId.

6. In Definizione, inserire =GetSysAttr('tenantId').

7. Fare clic su Crea.

Viene creata una variabile dell'app che consente di visualizzare l'ID del tenant. Ripetere i passaggi dal 3 al 6 per creare una variabile per ciascuno degli attributi rimanenti. Utilizzare i seguenti parametri:

• Nome tenant

  • Nome: vTenantName

  • Definizione: =GetSysAttr('tenantName')

• URL tenant

  • Nome: vTenantUrl

  • Definizione: =GetSysAttr('tenantUrl')

• Alias URL tenant

  • Nome: vTenantUrl

  • Definizione: =GetSysAttr('tenantUrlAlias')

• Regione tenant

  • Nome: vTenantRegion

  • Definizione: =GetSysAttr('tenantRegion')

• ID spazio

  • Nome: vSpaceId

  • Definizione: =GetSysAttr('spaceId')

• Nome spazio

  • Nome: vSpaceName

  • Definizione: =GetSysAttr('spaceName')

• Tipo di spazio

  • Nome: vSpaceType

  • Definizione: =GetSysAttr('spaceType')

Creare un oggetto Tabella e aggiungere ciascuna delle seguenti espressioni come dimensioni, insieme alle rispettive etichette:

• =vTenantId, con etichetta Tenant ID

• =vTenantName, con etichetta Tenant Name

• =vTenantUrl, con etichetta Tenant URL (Default)

• =vTenantUrlAlias, con etichetta Tenant URL (Alias)

• =vTenantRegion, con etichetta Tenant Region

• =vSpaceId, con etichetta Space ID

• =vSpaceName, con etichetta Space Name

• =vSpaceType, con etichetta Space Type

Ora si dispone di una tabella nella propria app, che visualizza in modo dinamico ciascuno degli attributi disponibili dell'ambiente. L'esportazione dell'app e il suo caricamento su un tenant e uno spazio differenti forniscono all'utente questi attributi per la versione appena caricata dell'app.

Il principale vantaggio dell'utilizzo della funzione nelle espressioni dei grafici è che non è necessario ricaricare l'app per aggiornare questi attributi. Ciò consente di spostare più facilmente le app tra tenant e spazi diversi come parte del loro ciclo di vita.

È possibile anche usare la funzione nelle proprie app senza bisogno di alcuna variabile. Questo esempio dimostra come caricare una tabella con ciascuno degli attributi come campi individuali. Da qui, è possibile creare visualizzazioni in un'app in modo da mostrare tali dettagli.

Procedere come indicato di seguito:

1. Creare una nuova app Qlik Sense in uno spazio condiviso.

2. Aprire l'Editor caricamento dati.

3. Incollare il seguente script di caricamento in una nuova scheda:

   Attributes:
   
   Load RowNo() as Key,
   GetSysAttr('tenantId') as TenantID,
   GetSysAttr('tenantName') as TenantName,
   GetSysAttr('tenantUrl') as TenantUrl,
   GetSysAttr('tenantUrlAlias') as TenantUrlAlias,
   GetSysAttr('tenantRegion') as TenantRegion,
   GetSysAttr('spaceId') as SpaceID,
   GetSysAttr('spaceName') as SpaceName,
   GetSysAttr('spaceType') as SpaceType autogenerate 1;

Caricare i dati. Viene creata una tabella nel modello dati, che visualizza ciascuno degli attributi in campi individuali.

Ora è possibile usare i campi degli attributi nelle visualizzazioni, come oggetti tabella o di testo e immagine.

È possibile immettere la funzione direttamente nelle espressioni del grafico senza utilizzare una variabile.

Il principale vantaggio dell'utilizzo della funzione nelle espressioni dei grafici è che non è necessario ricaricare l'app per aggiornare questi attributi. Ciò consente di spostare più facilmente le app tra tenant e spazi diversi come parte del loro ciclo di vita.

Procedere come indicato di seguito:

1. Creare una nuova app Qlik Sense in uno spazio condiviso.

2. Aprire un nuovo foglio in modalità di modifica avanzata.

3. Trascinare un oggetto Testo e immagine sul foglio.

4. Fare clic all'interno del grafico vuoto per aggiungere testo, e digitare:

   ID tenant:

5. Nel pannello proprietà, fare clic su Aggiungi misura.

6. Immettere l'espressione:

   =GetSysAttr('tenantId')

7. Ripetere questi passi per gli altri attributi nelle nuove righe, utilizzando le espressioni presentate nella tabella degli attributi nell'introduzione di questo argomento della guida.