Vejledninger, best practices samt tips og tricks

Owned by Blanketmotorens Produktteam
Last updated: May 16, 2024
3 min read

I dette område af Wikien har vi prøvet at samle en række vejledninger, best practices samt tips og tricks til brugen af Blanketmotoren.

Best practices

Nedenfor finder du en række af de best practices, der er opstået gennem Blanketmotorens levetid og som er gode at have for øje, når du skal til at lave blanketter.

 

Ved indsættelse af nye sektioner og felter i blanketter, så kommer de med nogle generiske navne som Section-3 og Control-4, der ikke giver nogen information om, hvad de omhandler.

Du bør derfor altid stræbe efter at give sektioner, felter m.v. mere retvisende navne, så de er nemmere at bruge og vedligehold i formler eller ved fejlsøgning i selve XML’en

Læs mere om navngivning i vores beskrivelse af Toolboxen

Når der anvendes vedhæftningsfelter i en blanket, så vil der ofte være en antagelse om, hvilke typer filer brugeren skal kunne uploade, og I bør derfor altid overveje at opsætte validering på filtyper.

Læs mere om validering af filtyper under Attachment controls

Det er en god ide at bruge visningsregler, der gør, at et tidligere vist felt kan blive skjult hvis brugeren fortryder sit valg. Da Orbeon ikke automatisk rydder værdien af et felt som skjules, så er det vigtigt, at man selv sætter dette op i blanketten, HVIS IKKE feltet skal have en anden beregnet værdi, mens det er skjult.

Felter ryddes nemmest ved blot at lave en calculated value som følger:

if (<visningsregel>) then . else ''

Ovenstående formel virker på næsten alle felttyper, men der er et par undtagelser. For “Single checkboxes” skal den tomme streng erstattes med false() og for “Multiple File Attachments” kan data pt. ikke tømmes ved en formel.

Bemærk: Ved almindelige inputfelter, så er det kun selve vedhæftningen der fjernes, mens at XML’en stadig har spor efter filnavn og filstørrelse. Disse kan desværre ikke fjernes via en formel

Undgå at bede om oplysninger, der allerede er registreret andetsteds. Skal du bruge en virksomheds navn og adresse, så nøjes med at spørge efter CVR-nummer, og hent oplysningerne fra CVR. Skal du bruge brugerens navn, så hent det fra loginet.

Læs mere om udhentning af eksisterende data under XPath og logik i blanketter og Integrationer

Undgå at bede om oplysninger, du ikke har brug for. Har du fx brug for en mailadresse, hvis efterfølgende korrespondance kommer til at ske med digital post?

 

Virk Myndighedsteam har med udgangspunkt i erfaringer omkring brugen af Blanketmotoren og Virk portalen også lavet en række best practices, der findes under overskriften “Vejledning til indhold på Virk”.

Vejledninger

Vi har på en række undersider hertil prøvet at lave udførlige vejledninger til en række konkrete opsætninger ifm. brugen af Blanketmotoren

Tips og tricks