GetSysAttr - skript- och diagramfunktion

Funktionen returnerar klientorganisationen och utrymmesdomänattributen för en vald app. Den kan användas på både dataladdningsskriptet och i ett diagramuttryck.

Funktionen GetSysAttr() kan användas direkt i laddningsskriptet eller i ett diagramuttryck. I båda fallen kan du använda funktionen för att lagra attribut i en variabel eller direkt utan variabel.

Om du använder funktionen i För klienthanterat Qlik Sense kommer den bara att returnera tomma datavärden. Alltså kan du använda funktionen för att ta fram skript i För klienthanterat Qlik Sense utan att fel inträffar i syfte att senare kunna läsa in apparna till Qlik Cloud.

Syntax:

GetSysAttr(name)

Returnerad datatyp: dual

Argument
Argument	Beskrivning
name	Namn på det attribut som ska returneras. Ange som ett strängvärde i uttrycket. Det angivna strängvärdet är skiftlägeskänsligt.

Du kan använda funktionen för att läsa in miljöattribut i din app. Funktionen kan returnera följande attribut:

Miljöattribut som kan returneras av funktionen GetSysAttr()
Attribut	Beskrivning	Exempel på variabel i inläsningsskript	Exempel på diagramuttryck (ingen variabel)
tenantId	Klientorganisationens ID.	Let vTenantID = GetSysAttr('tenantId')	=GetSysAttr('tenantId')
tenantName	Namn på klientorganisationen	Let vTenantName = GetSysAttr('tenantName')	=GetSysAttr('tenantName')
tenantUrl	Standard-URL för klientorganisationen	Let vTenantUrl = GetSysAttr('tenantUrl')	=GetSysAttr('tenantUrl')
tenantUrlAlias	Alias-URL som har definierats för klientorganisationen.	Let vTenantUrlAlias = GetSysAttr('tenantUrlAlias')	=GetSysAttr('tenantUrlAlias')
tenantRegion	Regionen där klientorganisationen är registrerad.	Let vTenantRegion = GetSysAttr('tenantRegion')	=GetSysAttr('tenantRegion')
spaceId	Utrymmets ID. Detta definieras enbart för en app i ett delat eller hanterat utrymme. Anteckning om information Om GetSysAttr()-funktionen returnerar ett tomt spaceId-värde in Qlik Cloud indikerar det att appen är placerad i ett personligt utrymme. GetSysAttr()-funktionen returnerar ett tomt spaceId-värde när det används i För klienthanterat Qlik Sense.	Let vSpaceId = GetSysAttr('spaceId')	=GetSysAttr('spaceId')
spaceName	Namnet på utrymmet. Detta definieras enbart för en app i ett delat eller hanterat utrymme. Anteckning om information Om GetSysAttr()-funktionen returnerar ett tomt spaceName-värde i Qlik Cloud indikerar det att appen är placerad i ett personligt utrymme. GetSysAttr()-funktionen returnerar ett tomt spaceName-värde när det används i För klienthanterat Qlik Sense.	Let vSpaceName = GetSysAttr('spaceName')	=GetSysAttr('spaceName')
spaceType	Typen av utrymme där appen är placerad. Detta definieras enbart för en app i ett delat eller hanterat utrymme. Anteckning om information Om GetSysAttr()-funktionen returnerar ett tomt spaceType-värde i Qlik Cloud indikerar det att appen är placerad i ett personligt utrymme. GetSysAttr()-funktionen returnerar ett tomt spaceType-värde när det används i För klienthanterat Qlik Sense.	Let vSpaceType = GetSysAttr('spaceType')	=GetSysAttr('spaceType')

Användning

Funktionen förenklar identifiering av utrymme och klientorganisation för en Qlik Sense-app som kan ha flyttats mellan olika miljöer. Funktionen gör det enkelt att identifiera den specifika miljö som du arbetar i. Det är speciellt praktiskt under stadierna utveckling, test, acceptans och produktion (DTAP) i en apps livscykel.

Funktionen kan användas i inläsningsbeskrivningar i appens inläsningsskript eller diagramuttryck, antingen direkt eller i ett uttryck som har lagrats som en variabel. Om du förväntar dig att din app kommer att flyttas mellan utrymmen och klientorganisationer under dess livscykel kan du använda funktionen i ett diagramuttryck för att dynamiskt skaffa utrymmen och information om klientorganisationen utan att läsa in appen på nytt. I så fall ska du lagra funktionsuttrycket i en variabel utanför inläsningsskriptet eller använda funktionen direkt i diagramuttrycket.

Exempel 1 – Lagra miljöattribut som variabler i inläsningsskript

I det här exemplet definierar vi en uppsättning skriptvariabler som kan användas i appinnehåll som du skapar. Varje gång appen läses in kommer attributen att utvärderas och läggas till appen.

Gör följande:

Skapa en ny Qlik Sense-app i ett delat utrymme.
Öppna Skriptredigeraren.

Klistra in följande inläsningsskript i en ny flik:

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

Det här inläsningsskriptet innehåller följande:

En ny tabell, som heter Transactions, innehåller exempeltransaktionsdata. Den kan ersättas med vilka data som helst och läggs till som en platshållare.
En serie definitioner av skriptvariabler för tillgängliga attribut som kan hämtas med GetSysAttr().

Läs in dina data och öppna ett nytt ark i avancerat redigeringsläge.

Skapa ett tabell-objekt och lägg till följande uttryck som dimensioner tillsammans med respektive etiketter:

=vTenantId, med etikett Tenant ID
=vTenantName, med etikett Tenant Name
=vTenantUrl, med etikett Tenant URL (Default)
=vTenantUrlAlias, med etikett Tenant URL (Alias)
=vTenantRegion, med etikett Tenant Region
=vSpaceId, med etikett Space ID
=vSpaceName, med etikett Space Name
=vSpaceType, med etikett Space Type

Nu har du en tabell i din app som dynamiskt visar vart och ett av de tillgängliga miljöattributen. Om du exporterar och laddar upp den till en annan klientorganisation kommer utrymmet att ge dig attributen för den nyligen uppladdade versionen av appen.

Exempel 2 – Lagra miljöattribut som variabler och använda dem i diagramuttryck

I det här exemplet kommer vi att, i stället för att definera variabler i skriptet, definiera flera variabler med dialogrutan i avancerat redigeringsläge. Sedan kan variablerna användas i diagramuttryck i appen.

Gör följande:

Skapa en ny Qlik Sense-app i ett delat utrymme.
Öppna ett nytt ark i avancerat redigeringsläge.
Klicka på om du vill öppna variabeldialogen.Variabler
Klicka på Skapa nytt.
Under Namn anger du vTenantId.
Under Definition anger du =GetSysAttr('tenantId').
Klicka på Skapa.

Det skapar en appvariabel som visar klientorganisationens ID. Upprepa steg 3 till 6 för att skapa en variable för vart och ett av de återstående attributen. Använd följande parametrar:

Klientorganisationens namn
- Namn: vTenantName
- Definition: =GetSysAttr('tenantName')
Klientorganisationens URL
- Namn: vTenantUrl
- Definition: =GetSysAttr('tenantUrl')
Klientorganisationens URL-alias
- Namn: vTenantUrlAlias
- Definition: =GetSysAttr('tenantUrlAlias')
Klientorganisationens region
- Namn: vTenantRegion
- Definition: =GetSysAttr('tenantRegion')
Utrymmets ID
- Namn: vSpaceId
- Definition: =GetSysAttr('spaceId')
Utrymmets namn
- Namn: vSpaceName
- Definition: =GetSysAttr('spaceName')
Utrymmets typ
- Namn: vSpaceType
- Definition: =GetSysAttr('spaceType')

Skapa ett tabell-objekt och lägg till vart och ett av följande uttryck tillsammans med respektive etiketter:

=vTenantId, med etikett Tenant ID
=vTenantName, med etikett Tenant Name
=vTenantUrl, med etikett Tenant URL (Default)
=vTenantUrlAlias, med etikett Tenant URL (Alias)
=vTenantRegion, med etikett Tenant Region
=vSpaceId, med etikett Space ID
=vSpaceName, med etikett Space Name
=vSpaceType, med etikett Space Type

Största fördelen med att använda funktionen i ett diagramuttryck är att appen inte behöver läsas in på nytt för att dessa attribut ska uppdateras. Det möjliggör en smidigare rörelse av appar mellan klientorganisationer och utrymmen som en del i appens livscykel.

Exempel 3 – Använda funktionen direkt i inläsningsskriptet

Du kan även använda funktionen i dina appar utan någon variabel. I det här exemplet ser du hur du kan läsa in en tabell med vart och ett av attributen som enskilt fält. Utifrån detta kan du skapa visualiseringar i appen för att visa dessa detaljer.

Gör följande:

Skapa en ny Qlik Sense-app i ett delat utrymme.
Öppna Skriptredigeraren.

Klistra in följande inläsningsskript i en ny flik:

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;

Ladda data. En tabell skapas i datamodellen och visar vart och ett av attributen i enskilda fält.

Nu kan du använda dessa attributfält i visualiseringar, som tabeller eller text- och bildobekt.

Exempel 4 – Använda funktionen direkt i diagramuttryck

Du kan ange funktionen direkt i diagramuttryck utan att använda någon variabel.

Största fördelen med att använda funktionen i ett diagramuttryck är att appen inte behöver läsas in på nytt för att uppdatera dessa attribut. Det möjliggör en smidigare rörelse av appar mellan klientorganisationer och utrymmen som en del i appens livscykel.

Gör följande:

Skapa en ny Qlik Sense-app i ett delat utrymme.
Öppna ett nytt ark i avancerat redigeringsläge.
Dra ett text- och bildobjekt till arket.
Klicka i det tomma diagrammet för att lägga till text och skriv in:
Klientorganisationens ID:
I egenskapsfönstret klickar du på Lägg till mått.
Ange följande uttryck:
=GetSysAttr('tenantId')
Upprepa dessa steg för övriga attribut på nya rader. Använd uttrycken som presenteras i attributtabellen i inledningen till detta hjälpavsnitt.

Var den här sidan till hjälp för dig?

Om du hittar några fel på denna sida eller i innehållet – ett stavfel, ett steg som saknas eller ett tekniskt fel – berätta för oss så att vi kan blir bättre!

Lämna din feedback här