Integrationer

Owned by Blanketmotorens Produktteam
Last updated: Oct 19, 2022
3 min read

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