GetSysAttr - script- en diagramfunctie

De functie GetSysAttr() wordt gebruikt om informatie te retourneren over de tenant en de ruimte waarin een app zich bevindt. Met de functie GetSysAttr() kunt u de ID en naam van de tenant, de ID en naam van de ruimte en andere details over de omgeving waar de app zich bevindt, evalueren. Deze functie vereenvoudigt de identificatie van ruimte en tenant van een Qlik Sense-app die mogelijk tussen verschillende omgevingen wordt verplaatst. De functie maakt het eenvoudig om de specifieke omgeving waarin u werkt te identificeren. Dit is voornamelijk praktisch tijdens de ontwikkel-, test-, acceptatie- en productiefasen van de levenscyclus van een app.

Deze functie kan worden gebruikt in het load-script of de diagramuitdrukking van de app, ofwel direct als een uitdrukking of in een uitdrukking die is opgeslagen als een variabele. Als u verwacht dat uw app gedurende zijn levencyclus tussen ruimten of tenants zal worden verplaatst, gebruikt u de functie in een diagramuitdrukking om dynamisch ruimte- en tenantinformatie te verkrijgen, zonder de app opnieuw te laden. Wanneer u dit doet, slaat u de functie-uitdrukking op in een variabele buiten het load-script, of gebruikt u de functie direct in de diagramuitdrukking.

Gebruik GetSysAttr() om de volgende informatie over uw app te bepalen:

De id van de tenant waar de app zich bevindt.
De naam van de tenant waar de app zich bevindt.
De URL van de tenant waar de app zich bevindt.
De alias-URL is gedefinieerd voor de tenant die de app bevat.
De regio van de tenant die de app bevat.
De id van de ruimte waar de app zich bevindt.
De naam van de ruimte waar de app zich bevindt.
Het type van de ruimte (gedeeld of beheerd) waar de app zich bevindt.

De GetSysAttr()-functie kan direct in het load-script worden gebruikt of in een diagramuitdrukking. In beide gevallen kunt u de functie gebruiken om kenmerken in een variabele op te slaan of rechtstreeks zonder een variabele.

Als u deze functie gebruikt in Qlik Sense met clientbeheer, retourneert hij alleen lege gegevenswaarden. U kunt de functie daarom gebruiken om scripts te ontwikkelen in Qlik Sense met clientbeheer, zonder dat er fouten optreden en met de intentie om de apps later naar Qlik Cloud te uploaden.

Syntaxis:

GetSysAttr(name)

Retourgegevenstypen: dubbele waarde

Argumenten
Argument	Beschrijving
name	De naam van het kenmerk dat u moet worden geretourneerd. Voer in als een tekenreekswaarde in de uitdrukking. De tekenreekswaarde is hoofdlettergevoelig.

U kunt de functie gebruiken om omgevingskenmerken in uw app te laden. De functie kan de volgende kenmerken retourneren:

Omgevingskenmerken die kunnen worden geretourneerd door de GetSysAttr()-functie
Kenmerk	Beschrijving	Voorbeeld van load-scriptvariabele	Voorbeeld van een diagramuitdrukking (geen variabele)
tenantId	De tenant-id.	Let vTenantID = GetSysAttr('tenantId')	=GetSysAttr('tenantId')
tenantName	De naam van de tenant.	Let vTenantName = GetSysAttr('tenantName')	=GetSysAttr('tenantName')
tenantUrl	De standaard-URL voor tenant.	Let vTenantUrl = GetSysAttr('tenantUrl')	=GetSysAttr('tenantUrl')
tenantUrlAlias	De alias-URL is gedefinieerd voor de tenant.	Let vTenantUrlAlias = GetSysAttr('tenantUrlAlias')	=GetSysAttr('tenantUrlAlias')
tenantRegion	De regio waarin de tenant zich bevindt.	Let vTenantRegion = GetSysAttr('tenantRegion')	=GetSysAttr('tenantRegion')
spaceId	De ruimte-id. Dit is de enige die is gedefinieerd voor een app in een gedeelde of beheerde ruimte. Informatie Als de functie GetSysAttr() een lege spaceId-waarde retourneert in Qlik Cloud, geeft dit aan dat de app zich in een persoonlijke ruimte bevindt. De functie GetSysAttr() retourneert altijd een lege spaceId-waarde als deze wordt gebruikt in Qlik Sense met clientbeheer.	Let vSpaceId = GetSysAttr('spaceId')	=GetSysAttr('spaceId')
spaceName	De naam van de ruimte. Dit is de enige die is gedefinieerd voor een app in een gedeelde of beheerde ruimte. Informatie Als de functie GetSysAttr() een lege spaceName-waarde retourneert in Qlik Cloud, geeft dit aan dat de app zich in een persoonlijke ruimte bevindt. De functie GetSysAttr() retourneert altijd een lege spaceName-waarde als deze wordt gebruikt in Qlik Sense met clientbeheer.	Let vSpaceName = GetSysAttr('spaceName')	=GetSysAttr('spaceName')
spaceType	Het type ruimte waarin de app zich bevindt. Dit is de enige die is gedefinieerd voor een app in een gedeelde of beheerde ruimte. Informatie Als de functie GetSysAttr() een lege spaceType-waarde retourneert in Qlik Cloud, geeft dit aan dat de app zich in een persoonlijke ruimte bevindt. De functie GetSysAttr() retourneert altijd een lege spaceType-waarde als deze wordt gebruikt in Qlik Sense met clientbeheer.	Let vSpaceType = GetSysAttr('spaceType')	=GetSysAttr('spaceType')

Voorbeeld 1 – Omgevingkenmerken opslaan als load-scriptvariabelen

In dit voorbeeld definiëren we een reeks scriptvariabelen die kunnen worden gebruikt in de appcontent die u maakt. Elke keer dat de app opnieuw wordt geladen, worden de kenmerken beoordeeld en toegevoegd aan de app.

Doe het volgende:

Maak een nieuwe Qlik Sense-app in een gedeelde ruimte.
Open de Editor voor laden van gegevens.

Plak het volgende load-script in een nieuw tabblad:

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

Dit load-script bevat het volgende:

Een nieuwe tabel, met de naam Transactions, die voorbeeldtransactiegegevens bevat. Dit kan worden vervangen door gegevens of wordt toegevoegd als een tijdelijke aanduiding.
Een reeks scriptvariabeledefinities, voor de beschikbare kenmerken die kunnen worden opgehaald door GetSysAttr().

Laad de gegevens en open een nieuw werkblad in de geavanceerde bewerkingsmodus.

Maak een tabelobject en voeg de volgende uitdrukkingen toe als dimensies met hun respectievelijke labels:

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

U hebt nu een tabel in uw app die dynamisch elk van de beschikbare omgevingskenmerken weergeeft. Door de app te exporteren en naar een andere tenant en ruimte te uploaden, krijgt u deze kenmerken voor de nieuw geüploade versie van de app.

Voorbeeld 2 – Omgevingskenmerken uploaden als variabelen en ze in diagramuitdrukkingen gebruiken

In dit voorbeeld definiëren we verschillende variabelen met gebruik van het dialoogvenster in de geavanceerde bewerkingsmodus in plaats van dat u variabelen in het script definieert. De variabelen kunnen dan worden gebruikt in de diagramuitdrukkingen in de app.

Doe het volgende:

Maak een nieuwe Qlik Sense-app in een gedeelde ruimte.
Open een nieuw werkblad in de geavanceerde bewerkingsmodus.
Klik op om het variabelendialoogvenster te openen.
Klik op Nieuw maken.
Voer bij Naam vTenantId in.
Voer bij Definitie =GetSysAttr('tenantId') in.
Klik op Maken.

Dit maakt een appvariabele waarmee de id van de tenant wordt weergegeven. Herhaal stappen 3 t/m 6 om een variabele voor elk van de resterende kenmerken te maken. Gebruik de volgende parameters:

Tenantnaam
- Naam: vTenantName
- Definitie: =GetSysAttr('tenantName')
Tenant-URL
- Naam: vTenantUrl
- Definitie: =GetSysAttr('tenantUrl')
Tenant-URL-alias
- Naam: vTenantUrlAlias
- Definitie: =GetSysAttr('tenantUrlAlias')
Tenantregio
- Naam: vTenantRegion
- Definitie: =GetSysAttr('tenantRegion')
Ruimte-id
- Naam: vSpaceId
- Definitie: =GetSysAttr('spaceId')
Ruimtenaam
- Naam: vSpaceName
- Definitie: =GetSysAttr('spaceName')
Ruimtetype
- Naam: vSpaceType
- Definitie: =GetSysAttr('spaceType')

Maak een tabelobject en voeg elk van de volgende uitdrukkingen toe als dimensies met hun respectievelijke labels:

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

Het belangrijkste voordeel van gebruik van de functie in diagramuitdrukkingen is dat de app niet opnieuw hoeft te worden geladen om deze kenmerken te vernieuwen. Dit zorgt ervoor dat apps moeiteloos kunnen worden verplaatst tussen tenants en ruimte als onderdeel van de levenscyclus van de app

Voorbeeld 3 – De functie direct in het load-script gebruiken

U kunt de functie tevens zonder variabele in uw apps gebruiken. Dit voorbeeld laat zien hoe u een tabel kunt laden met elk kenmerk als een afzonderlijke veld. Van hieruit kunt u visualisaties in de app maken om deze details weer te geven.

Doe het volgende:

Maak een nieuwe Qlik Sense-app in een gedeelde ruimte.
Open de editor voor laden van gegevens.

Plak het volgende load-script in een nieuw tabblad:

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;

Laad de gegevens. Een tabel wordt aangemaakt in het gegevensmodel en geeft elk van de kenmerken in afzonderlijke velden weer.

Nu kunt u de kenmerkvelden in visualisaties gebruiken, zoals tabellen of tekst- en afbeeldingsobjecten.

Voorbeeld 4 – De functie direct in diagramuitdrukkingen gebruiken

U kunt de functie direct en zonder een variabele in diagramuitdrukkingen gebruiken.

Doe het volgende:

Maak een nieuwe Qlik Sense-app in een gedeelde ruimte.
Open een nieuw werkblad in de geavanceerde bewerkingsmodus.
Sleep een tekst- en afbeeldingsobject naar het werkblad.
Klik in het lege diagram om tekst en type toe te voegen:
Tenant-id:
Klik in het eigenschappenvenster op Meting toevoegen.
Voer de volgende uitdrukking in:
=GetSysAttr('tenantId')
Herhaal deze stappen voor de andere kenmerken op nieuwe regels, met gebruik van de uitdrukkingen die in de kenmerkentabel worden gepresenteerd in de introductie van dit helponderwerp.

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