Context formulieren

Concept

Een context formulier is een formulier dat als gegevensbron gelinkt wordt aan het te editeren formulier. Uit het context formulier kan je veldwaardes ophalen om er vervolgens expressies mee op te bouwen in de formulier logica tab.

Formulieren die in aanmerking komen om te linken als context formulier:

Alle formulieren binnen het geopende dossiertype.
Alle formulieren binnen gelinkte dossiertypes.
Het login data formulier: dit bevat alle info over de ingelogde gebruiker (niet via Studio UI).
Alle andere formulieren gedefinieerd in de root van de applicatie (niet via Studio UI).

Let erop dat een gelinkt context formulier het te editeren formulier voorafgaat in de workflow. Een aanvraagformulier kan bijvoorbeeld de perfecte context vormen bij een beslissingsformulier. Maar omgekeerd heeft het geen zin om een beslissingsformulier als context toe te voegen bij een aanvraagformulier.

Context formulier toevoegen

Vanuit het overzicht van formulieren, selecteer het formulier waaraan je een context formulier wilt toevoegen.
Binnen de formulier editor open je vervolgens het tabblad Context in het Elementen panel.
Klik op de knop + Voeg nieuwe context toe. Het Contexten dialoogvenster opent zich.
Selecteer een formulier en klik op Aanmaken. Je hebt nu een context formulier gelinkt.

Context formulier verwijderen

Vanuit het overzicht van formulieren, selecteer het formulier waaraan je een context formulier wilt toevoegen.
Binnen de formulier editor open je vervolgens het tabblad Context in het Elementen panel.
Zoek het context formulier binnen de lijst en klik op het prullenmand icoon. Het context formulier is nu verwijderd.

Alle bewerkingen worden automatisch opgeslagen. Let op: er zijn geen knoppen om acties ongedaan te maken of opnieuw uit te voeren.

Het ondoordacht verwijderen van een context formulier kan ernstige schade berokkenen aan de correcte werking van het formulier en zelfs van de workflow in zijn geheel.

Context formulieren in de JSON-formulierdefinitie

Je vindt de context formulieren terug onder "contextDependencies" helemaal onderaan je formulierdefinitie.

Voorbeeld van twee gelinkte context formulieren: ‘postcode’ en ‘goedkeuring’.

CODE

  "contextDependencies": {
    "postcode": {
      "documentByDefinitionKey": "postcode"
    },
    "goedkeuring": {
      "documentByDefinitionKey": "goedkeuring"
    }
  }

Veldwaardes ophalen uit context formulier

Eenmaal een context formulier gelinkt is, kan je er de veldwaardes uit ophalen. Je kan er expressies mee opbouwen in de formulier logica tab van het Elementen panel. Deze expressies kan je vervolgens op verschillende manieren gebruiken in je formulierdefinitie.