I dette afsnit kigger vi trin for trin på, hvordan man kan opsætte en CVR-integration, samt hvad de forskellige ting egentligt betyder. Hvis du vil se et eksempel i virkeligheden, så kan du med fordel søge på CVR i Blanketmotorens Sandkasse
Den integration vi bygger i denne vejledning tager et CVR-nummer som input som brugeren indtaster og udfylder en række felter i blanketten med
Virksomhedens navn
Virksomhedens adresse
Vejnavn
Husnummer
Postnummer
By
Virksomhedens form
Virksomhedens e-mail
Du skal derfor starte med at lave en blanket, hvori der er et felt til indtastning af CVR-nummer og felter til at indsætte data ovenfor. Til dette eksempel kan de alle bare være almindelige text fields.
Opsæt HTTP Service
Det første vi skal gøre for at opsætte en CVR-integration er at tilføje en ny HTTP Service som peger på Blanketmotorens CVR-service. Dette gøres ved at vælge fanen Advanced i Toolboxen og hernæst Add under HTTP Services som illustreret nedenfor
Du bliver nu præsenteret for en modal, hvor du kan angive en række informationer vist på billedet nedenfor
Service Name: Her kan du give et navn til din HTTP Service, som skal bruges senere ved opsætning af den tilhørende action. Hvis du kun skal have et CVR-opslag i din blanket kan den med fordel hedde CvrService, men hvis du skal have flere CVR-opslag i samme blanket kan det være smart at sætte dem i kontekst som eksempelvis AnmelderCvrService eller PaaVegneAfCvrService.
Ressource URL: Her angiver vi, hvor vi gerne hente data i vores opslag, hvilket i dette tilfælde er fra én af Blanketmotorens udstillede services som kan findes ved at indtaste følgende {xxf:property("blanketmotorservice")}/cvr/opslagPaaCvrNummer.
Method: Her angives hvilken type af opslag der ønskes lavet, noget der som udgangspunkt styres af den service man gerne vil kalde. Du vil oftest skulle vælge enten GET eller POST i denne og i vores tilfælde skal du vælge GET. For Blanketmotorens services vil du i Udstillede services kunne se, hvad du skal vælge i de enkelte tilfælde.
URL Parameters: Her angiver vi, hvilke input parametre vi skal sende til den service vi vil lave opslaget i. I vores tilfælde med Blanketmotorens CVR Service skal vi tilføje en enkel parameter med navnet cvrNummer. Hvilken værdi, der så kommer i den parameter styres i næste afsnit når vi opsætter den tilhørende Action.
Tryk herefter på Save, hvorefter du bør kunne se servicen i Toolboxen under HTTP Services