Integrationer
Blanketmotoren tilbyder gennem Orbeon Forms en bred vifte af muligheder for at lave integrationer mellem blanketter og digitale registre, således at der under udfyldelse af en blanket kan laves opslag i data og bruge dette i blanketten.
Integrationer i blanketterne opsættes med Orbeon Forms' Actions og HTTP Services
Actions og services kommer i et 1-1 forhold, hvor der er én service per action, der tilsammen udgør en integration. Her har servicen ansvaret for at styre, hvor der skal laves opslag, mens actionen har ansvar for at styre, hvornår der skal laves et opslag, hvad der skal være input og hvad der skal gøres med svaret.
Figuren nedenfor illustrerer, hvordan et sådan dataopslag fungerer
Du finder den officielle Orbeon-dokumentation her: HTTP Services og Actions, mens denne Wiki går mere i dybden med integrationer på de følgende undersider
HTTP Services og Actions: Her gennemgås brugen af HTTP Services og Actions, samt en række tips og tricks og do’s and don’ts
Udstillede services: Blanketmotoren udstiller selv en række integrationsmuligheder, hvor vi har prøvet at lave nogle simple snitflader til en række gængse datapunkter.
Eksempel på opsætning af CVR-integration: En trin-for-trin vejledning til opsætning af en CVR-integration med forklaringer af de enkelte trin
Dynamiske dropdowns: Foruden actions og services, så tilbyder Orbeon Forms også en anden form for integration i form af de såkaldte dynamiske dropdowns som er beskrevet her
Custom actions: Hvis det skal være rigtig avanceret, så kan man gå udover de sædvanlige actions og lave yderligere ting med integrationer via actions styret i blankettens XML
Andre kendte services: Her prøver vi at samle viden om andre offentligt tilgængelige services, der kan bruges direkte i blanketter
For at gøre brugen af integrationer nemmere, så kommer Blanketmotoren out-of-the-box med en række forskellige Globale section templates til forskellige dataopslag, ligesom vi prøver at lave vejledende eksempler i Blanketmotorens Sandkasse
Eksempler på dataopslag
Opslag på CVR-nummer: Et af de klassiske dataopslag i Blanketmotoren er opslag i CVR-registret på et CVR-nummer, der enten er indtastet af anmelder eller er hentet fra anmelders login. Her vil man så kunne hente virksomhedens navn, adresse, stiftelsesdato m.v. og udstille dette i blanketten. Et opslag på CVR-nummer kan sikre korrekte virksomhedsoplysninger i indsendelsen i stedet for at anmelder selv skal indtaste virksomhedsnavn og adresse og risikere at lave fejl.
Opslag på adresse: Alle gyldige danske adresser findes i Danmarks Adresseregister (DAR) og der er derfor ikke længere nogen grund til at give anmelder mulighed for at angive en dansk adresse på tværs af 3-5 fritekstfelter. Ved at bruge en integration ved indtastning af adresse sikrer du, at der kun kan indtastes gyldige adresser.
Opslag i eget sagsbehandlingssystem: Hvis dit sagsbehandlingssystem giver mulighed for det, så er en andet oplagt dataopslag at kunne fremsøge data på baggrund af et sagsnummer, hvis du eksempelvis har en blanket til indsendelse af supplerende oplysninger på en sag eller andet lignende