Formulieren beheren

Formulier aanmaken

Start vanaf het scherm met het overzicht van formulieren binnen het dossiertype. Klik op de knop + Voeg formulier toe. Het dialoogvenster Nieuw formulier opent zich.
Vul een Naam in. Terwijl je de naam typt, wordt automatisch de Key ingevuld. Indien gewenst, kan je deze achteraf nog wijzigen via de JSON.
Optioneel kan je de functionaliteit Validatie per sectie inschakelen. Met deze optie moet de gebruiker het formulier sectie per sectie vervolledigen, waarbij elke sectie wordt afzonderlijk gevalideerd. Meer info hierover kan je terugvinden in de sectie formulier validatie.
Bevestig door op de knop Aanmaken te klikken. Je komt nu in de formulier editor voor het nieuw aangemaakte formulier.

Keys moeten uniek zijn binnen de scope van je applicatie (over dossiertypes heen).

Het is ook mogelijk om rechtstreeks vanuit een gebruikerstaak in de workflow editor een formulier aan te maken. Gebruik hiervoor de knop. Vervolgens kan je ook rechtstreeks naar het gelinkte formulier navigeren. Klik op het icoon naast de formulierselector.

Formuliereigenschappen bewerken

Start vanaf het scherm met het overzicht van formulieren binnen het dossiertype. Klik op het
icoon naast het formulier waarvan je de eigenschappen wil bewerken. Het dialoogvenster Bewerk formulier opent zich.
Hier kan je de Naam van het formulier wijzigen. Ook de functionaliteit Validatie per sectie kan je in- of uitschakelen. Meer info hierover kan je terugvinden in de sectie formulier validatie.

Formulier bewerken in formulier editor

Start vanaf het scherm met het overzicht van formulieren binnen het dossiertype. Klik op het formulier dat je wil bewerken.
De formulier editor opent. Je kunt nu je bewerkingen starten.

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

Formulier bewerken in de JSON-formulierdefinitie

Je kan het formulier ook rechtstreeks in de JSON-formulierdefinitie aanpassen.

Start vanaf het scherm van het overzicht van formulieren binnen het dossiertype. Klik op het formulier dat je wil bewerken.
De formulier editor opent. Klik nu rechts bovenaan op het ellips icoon en kies vervolgens Bewerk het formulier in de JSON-editor.

Een formulier bewerken in de JSON-formulierdefinitie is mogelijk, maar vergt diepgaande kennis van alle eigenschappen.

Formulier verwijderen

Binnen Studio is het niet mogelijk om een formulier te verwijderen. Dit moet in de git tool gebeuren en is niet zonder risico. De reden hiervoor is dat dossiertypes een lange levensduur hebben (van enkele maanden tot enkele jaren). Van zodra binnen één specifiek proces een formulier is aangemaakt is de formulierdefinitie blijvend nodig om de ingevoerde data te kunnen visualiseren en opslaan. Ook al breng je dus achteraf wijzigingen aan in je dossiertype en maak je geen actief gebruik meer van het formulier, dan nog hebben we de formulierdefinitie nodig om de voordien aangemaakte en afgeronde dossiers toegankelijk te houden. Klik hier voor meer uitleg over backwards compatibility.

Formulier integreren in de workflow

Een formulier kan worden geïntegreerd in de workflow door middel van een gebruikers- of servicetaak. Als je wilt dat een menselijke gebruiker het formulier leest, bewerkt of invult, maak dan een gebruikerstaak aan. Als je wilt dat een formulier automatisch wordt gelezen, bewerkt of ingevuld, maak dan een servicetaak aan.

Gebruikerstaak

Selecteer in je workflow de taak en verander het type in User task. Ga vervolgens naar het tabblad Basis binnen het eigenschappen panel van de taak. Zoek naar de eigenschap Element template en selecteer Formulier. Vul vervolgens de specifieke eigenschappen in met betrekking tot gebruikerstaak algemeen en gebruikerstaak formulier.

Servicetaak

Selecteer in je workflow de taak en verander het type in Service task. Ga vervolgens naar het tabblad Basis binnen het eigenschappen panel van de taak. Zoek naar de eigenschap Element template en selecteer de template die je nodig hebt. Vul volgende de relevante eigenschappen met betrekking tot die template in. Sommige van deze templates maken een link met een specifiek formulier. Als je de Schrijf een expressie template kiest, kun je een expressie bouwen om waarden naar een formulierveld te schrijven.

Pad naar formuliervelden

Het pad naar formuliervelden vertrekt vanuit de root van de applicatie.

Het pad naar een formulierveld houdt geen rekening met dossiertype. Let er dus op dat je een formulierkey (bv. aanvraag) nooit gebruikt in twee verschillende dossiertypes. Formulierkeys moeten uniek zijn binnen de scope van de applicatie.

Standaardvelden

formulieren.keyFormulier.keyVeld

Velden in een groep

formulieren.keyFormulier.keyGroep.keyVeld

Velden in een lijst (index meegeven)

formulieren.keyFormulier.keyLijst[0].keySubveld

Hoe je deze paden aanspreekt binnen een expressie, hangt af van het soort expressie en de scope waarbinnen de expressie wordt uitgevoerd.

Snapshot formulier maken

De inhoud van een formulier kan wijzigen doorheen het proces. Soms wil een dossierbeheerder weten wat de exacte toestand van een formulier was op een specifiek ogenblik in het proces (bijvoorbeeld vlak na initiële indiening van het aanvraagformulier). Vandaar dat Skryv de mogelijkheid voorziet om een snapshot te maken.

Formulier testen

Maak geen nieuw testdossier aan voor elke testiteratie van je formulier. Pas in plaats daarvan de volgende strategie toe.

Maak binnen je workflow een gebruikerstaak aan en koppel deze aan het formulier.
Ga naar de preview-omgeving van je applicatie.
Start een testdossier en duw het door de workflow tot het punt dat het de gebruikerstaak bereikt.
Open de gebruikerstaak. Evalueer hoe je formulier eruit ziet.
Bewerk het formulier in Studio.
Stuur je bijgewerkte formulierdefinitie via update naar de preview-omgeving van je applicatie.
Ga terug naar de geopende gebruikerstaak. Refresh de pagina. Het formulier wordt aangepast.
Evalueer je wijzigingen. Indien niet OK of verdere iteraties nodig, herhaal dan vanaf stap 5.

Meer info over hoe dit specifieke gedrag tot stand komt, kan je terugvinden op de pagina over backwards compatibility.