Constrain

De Constrain-instructie kan in combinatie met de Let- of Set-instructie gebruikt worden om scriptvariabelen te definiëren. Met de Constrain-instructie kunt u beperkingen definiëren op mogelijke waarden voor deze variabelen. Als een definitie van een variabele de beperkingen schendt, mislukt de lading. Met beperkingen kunt u eisen dat variabele waarden overeenkomen met specifieke typen, binnen specifieke numerieke bereiken vallen en overeenkomen met aanvaardbare waarden die u definieert.

Constrain variablename = json

Waar:

variablename is een scriptvariabele.
json een geldig JSON-object is dat de beperkingen specificeert. Individuele beperkingen worden binnen dit object toegevoegd als sleutelwaardeparen.

Type beperkingen
Beperkingstype (sleutel)	Betekenis	Vereisten voor beperking (waarde)	Voorbeelden
"type"	Beperk variabelewaarden tot een specifiek gegevenstype.	"text" specificeert een teksttype. "number" specificeert een numeriek type.	`CONSTRAIN vExampleText = {"type": "text"}` `CONSTRAIN vExampleNumeric = {"type": "number"}`
"maxnum"	Stel een maximumwaarde in voor een variabele.	Alleen getallen (geheel getal of drijvende komma). Wetenschappelijke notatie is toegestaan.	`CONSTRAIN vExample = {"maxnum": 5000}`
"minnum"	Stel een minimumwaarde in voor een variabele.	Alleen getallen (geheel getal of drijvende komma). Wetenschappelijke notatie is toegestaan.	`CONSTRAIN vExample = {"minnum": 250}`
"valuesnum"	Definieer een lijst met aanvaardbare numerieke waarden voor de variabele.	Door komma's gescheiden lijst van getallen tussen vierkante haakjes. Bijvoorbeeld: [1,2,3]	`CONSTRAIN vExample = {"valuesnum": [1,2,3]}`
"valuestext"	Definieer een lijst met aanvaardbare tekstwaarden voor de variabele.	Door komma's gescheiden lijst van tekenreeksen tussen vierkante haakjes. Bijvoorbeeld: ["a","b","c"]	`CONSTRAIN vExample = {"valuestext": ["Department A", "Department B", "Department C"]}`

Wanneer een Constrain statement te gebruiken

Gebruik de Constrain-instructie om te voorkomen dat ongewenste variabele waarden in analyse-apps worden geladen.

Overwegingen

De Constrain-definitie voor de variabele moet een geldig JSON-object zijn.
U kunt meer dan één beperking voor één variabele opgeven. Alle beperkingen voor een variabele moeten in een enkel beperkingsobject staan. Zie Voorbeelden - meerdere beperkingen voor voorbeelden.
Als u al een scriptvariabele met een bepaalde naam in de applicatie hebt geladen, kunnen toekomstige pogingen om beperkingen en waarden voor die variabele te definiëren mislukken door conflicten tussen de oorspronkelijke en de opnieuw gedefinieerde variabelen.

Om deze conflicten op te lossen, reset u de beperkingen en waarden van de variabelen door lege definities in te voegen. Voorbeelden:
```
CONSTRAIN x;
LET x;
```
```
CONSTRAIN x;
SET x;
```
U kunt dan de variabele en de beperkingen ervan opnieuw definiëren in volgende secties in het load-script. Zie Voorbeeld - conflicten oplossen in de definitie van variabelen voor een voorbeeld in lange vorm.
De volgorde van de definitie van de variabele en de definitie van de beperking maakt niet uit. In het geval van een variabele-gerelateerde laadfout, zal de regel waarop het breekpunt optreedt echter anders zijn.
De Constrain script-instructie beperkt alleen variabele definities voor scriptvariabelen. U kunt ook beperkingen toepassen op script- en eindgebruikersvariabelen (variabelen die zijn aangemaakt of bijgewerkt in de werkbladweergave of als sessievariabelen met behulp van de API) door de openbare API te gebruiken. Ga voor meer informatie naar Alternatieven voor ontwikkelaars om variabele beperkingen te definiëren.
Beperkingen worden gevalideerd om scenario's te voorkomen die geen enkele waarde kunnen matchen voor de variabele. Voorbeelden van ongeldige beperkingen:
- {"minnum": 5000, "maxnum": 4}
- {"type": "text", "maxnum": 4}

Alternatieven voor ontwikkelaars om variabele beperkingen te definiëren

U kunt ook de openbare API gebruiken om variabele beperkingen te definiëren, in plaats van de Constrain-instructie in het load-script te gebruiken. Wanneer u beperkingen definieert via de API, zullen alle pogingen om variabele waarden bij te werken — of dit nu rechtstreeks in het load-script of in de werkbladweergave gebeurt — onderhevig zijn aan de beperkingen.

Om variabele beperkingen via de openbare API te definiëren, gebruikt u de GenericVariableConstraints-eigenschap in de QlikEngine JSON API: GenericVariableProperties (alleen in het Engels).

Voorbeeld - type

Overzicht

Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.

Het load-script bevat:

Een Constrain-instructie om aan te geven dat de variabele definitie voor a het type number moet hebben.
Een LET-instructie die de variabele a definieert.

Load-script

CONSTRAIN a = {"type": "text"};
LET a = 1000;

Resultaten

De gegevens laden.

Het laden mislukt omdat de beperking een teksttype vereist voor de variabele a. De definitie van de variabele is een getal.

Daarentegen zou het specificeren van een type van number in de beperking ervoor zorgen dat het laden slaagt.

Voorbeeld - maxnum

Overzicht

Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.

Het load-script bevat:

Een Constrain-instructie om aan te geven dat de variabele definitie voor b een maximale waarde van 3000 kan hebben.
Een LET-instructie die de variabele b definieert.

CONSTRAIN b = {"maxnum": "3000"};
LET b = 3001;

Resultaten

De gegevens laden.

Het laden mislukt omdat de beperking een maximumwaarde van 3000 vereist voor de variabele b. De definitie van de variabele evalueert als 3001.

Daarentegen zou het specificeren van b als 2999 ervoor zorgen dat het laden slaagt.

Voorbeeld - minnum

Overzicht

Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.

Het load-script bevat:

Een Constrain-instructie om aan te geven dat de variabele definitie voor b een minimale waarde van 3000 kan hebben.
Een LET-instructie die de variabele c definieert.

CONSTRAIN c = {"minnum": "3000"};
LET c = 2999;

Resultaten

De gegevens laden.

Het laden mislukt omdat de beperking een minimumwaarde van 3000 vereist voor de variabele c. De definitie van de variabele evalueert als 2999.

Daarentegen zou het specificeren van c als 3000 ervoor zorgen dat het laden slaagt.

Voorbeeld - valuesnum

Overzicht

Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.

Het load-script bevat:

Een Constrain-instructie om aan te geven dat de variabele definitie voor d numeriek moet zijn en 2, 3 of 4 moet zijn.
Een LET-instructie die de variabele d definieert.

CONSTRAIN d = {"valuesnum": [2,3,4]};
LET d = 1;

Resultaten

De gegevens laden.

Het laden mislukt omdat de variabele d wordt geëvalueerd als 1, wat niet in de lijst met drie mogelijke waarden staat.

Daarentegen zou het specificeren van d als 2 ervoor zorgen dat het laden slaagt.

Voorbeeld - valuestext

Overzicht

Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.

Het load-script bevat:

Een Constrain-instructie om aan te geven dat de variabele definitie voor e een van de volgende tekstwaarden moet zijn:
- Department A
- Department B
- Department C
Een SET-instructie die de variabele e definieert.

CONSTRAIN e = {"valuestext": ["Department A", "Department B", "Department C"]};
SET e = Department D;

Resultaten

De gegevens laden.

Het laden mislukt omdat de variabele e is Department D, wat niet voorkomt in de lijst met toegestane waarden die door de beperking is gedefinieerd.

Daarentegen zou het specificeren van e als Department C ervoor zorgen dat het laden slaagt.

Voorbeelden - SET versus LET

Deze voorbeelden laten de verschillen zien tussen hoe beperkingen worden toegepast bij het gebruik van SET of LET tijdens het definiëren van variabelen. Alle voorbeelden gebruiken beperkingen die een type vereiste toepassen, maar deze principes gelden in het algemeen voor alle soorten beperkingen.

Overzicht

Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.

Het load-script bevat:

Een Constrain-instructie om aan te geven dat de variabele definitie voor f het type number moet hebben.
Een SET-instructie die de variabele f definieert.

Load-script

CONSTRAIN f = {"type": "number"};
SET f = 500*2;

Resultaten

De gegevens laden.

Het laden mislukt omdat de beperking een numeriek type vereist voor de variabele f. De definitie van de variabele bevat een numerieke uitdrukking, maar omdat er een SET-instructie wordt gebruikt, wordt de definitie als tekst geëvalueerd.

Overzicht

Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.

Het load-script bevat:

Een Constrain-instructie om aan te geven dat de variabele definitie voor g het type text moet hebben.
Een LET-instructie die de variabele g definieert.

Load-script

CONSTRAIN g = {"type": "text"};
LET g = 500*2;

De gegevens laden.

Het laden mislukt omdat de beperking een teksttype vereist voor de variabele g. De definitie van de variabele bevat een numerieke uitdrukking en er is een LET-instructie gebruikt, waardoor de definitie als een getal wordt geëvalueerd.

Overzicht

Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.

Het load-script bevat:

Een Constrain-instructie om aan te geven dat de variabele definitie voor h het type text moet hebben.
Een SET-instructie die de variabele h definieert.

Load-script

CONSTRAIN h = {"type": "text"};
SET h = 500*2;

De gegevens laden.

Het laden slaagt. De beperking vereist een teksttype voor de variabele h. De definitie van de variabele bevat een numerieke uitdrukking, maar omdat er een SET-instructie wordt gebruikt, wordt de definitie als tekst geëvalueerd.

Overzicht

Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.

Het load-script bevat:

Een Constrain-instructie om aan te geven dat de variabele definitie voor i het type number moet hebben.
Een LET-instructie die de variabele i definieert.

Load-script

CONSTRAIN i = {"type": "number"};
LET i = 500*2;

De gegevens laden.

Het laden slaagt. De beperking vereist een numeriek type voor de variabele i. De definitie van de variabele bevat een numerieke uitdrukking en er is een LET-instructie gebruikt, waardoor de definitie als een getal wordt geëvalueerd.

Voorbeelden - meerdere beperkingen

Overzicht

Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.

Het load-script bevat:

Een Constrain-instructie om aan te geven dat de variabele definitie voor j tussen 1 en 5 moet liggen.
Een LET-instructie die de variabele j definieert.

Load-script

CONSTRAIN j = {"minnum": 1, "maxnum": 5};
LET j = 2;

De gegevens laden.

Het laden slaagt. De variabele f evalueert naar 2, wat binnen het aanvaardbare bereik ligt.

Overzicht

Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.

Het load-script bevat:

Een Constrain-instructie waardoor de variabele tekst of numeriek kan zijn, zolang het maar een van de aanvaardbare waarden is.
Een LET-instructie die de variabele k definieert.

Load-script

CONSTRAIN k = {"valuestext": ["abc","def","ghi"], "valuesnum": [0,1,3,5]};
LET k = 'def';

De gegevens laden.

Het laden slaagt. De waarde voor variabele k staat in de lijst met aanvaardbare waarden. Op dezelfde manier zou het opgeven van k als 3 resulteren in een succesvolle lading.

Voorbeeld - conflicten oplossen in de definitie van variabelen

Overzicht

Dit voorbeeld laat zien hoe definitieconflicten van variabelen kunnen optreden bij het toevoegen van beperkingen voor een variabele die al in de applicatie gedefinieerd is bij een vorige lading.

Load-script 1: een variabele voor het script instellen

Open de Editor voor laden van gegevens. Voeg het volgende script toe:

LET vConflictExample = 'Department C';

De gegevens laden. Het laden is geslaagd. Variabele vConflictExample is in de applicatie aangemaakt als een scriptvariabele.

Load-script 2: poging tot beperkingsdefinitie op eerder geladen scriptvariabele

Verwijder load-script 1. Voeg het volgende script toe:

CONSTRAIN vConflictExample = {"type": "number"};
LET vConflictExample = 123;

De gegevens laden.

Het laden mislukt met een beperkingsfout, ook al zijn de nieuwe beperking en waardedefinitie compatibel. Dit komt omdat load-script 1 de variabele al in de applicatie geladen heeft, met een tekstwaarde, en deze waarde nog steeds in de applicatie aanwezig is. Om dit probleem op te lossen, moeten we de variabelebeperking en -definitie opnieuw instellen. Zie load-script 3.

Load-script 3: beperking en waardedefinities resetten

Verwijder load-script 2. Voeg het volgende script toe:

CONSTRAIN vConflictExample;
LET vConflictExample;

CONSTRAIN vConflictExample = {"type": "number"};
LET vConflictExample = 123;

MockData:
LOAD 
* 
Inline [
id, date, amount
1, 05/30/2025, 23.56
];

De gegevens laden.

Het laden slaagt. Het bovenstaande script kan worden opgesplitst in drie delen, elk gescheiden door lege regels:

Het eerste deel stelt de beperkings- en waardedefinitie voor vConflictExample opnieuw in. Hiermee wordt de definitie verwijderd die met load-script 1 in de applicatie was geladen.
In het tweede deel worden de nieuwe beperkings- en waardedefinities die in load-script 2 mislukten, opnieuw toegepast.
Het derde deel voegt gewoon schijngegevens toe zodat we de werkbladweergave kunnen openen en de variabele waarde kunnen inspecteren (zie hieronder).

Open de werkbladweergave in de bewerkingsmodus en open het dialoogvenster Variables Variabelen. We kunnen zien dat de variabele vConflictExample met succes is aangemaakt.

Variables dialog in sheet view showing that the script variable has successfully been created. — Het dialoogvenster Variabelen in de werkbladweergave laat zien dat het conflict met de definitie van variabelen voor vConflictExample is opgelost.

Let

Set

Werken met variabelen in de editor voor het laden van gegevens

Was deze pagina nuttig?

Als u problemen ervaart op deze pagina of de inhoud onjuist is – een tikfout, een ontbrekende stap of een technische fout – laat het ons weten!

Geef hier uw feedback