Hvem og hvornår
Bruges af en myndighedsmedarbejder. Medarbejderen står i en sag i fagsystemet og har brug for at se, hvilke samtykker der findes for borgeren eller for netop den sag. Integrationen hopper til søgesiden i Digitalt Samtykke, allerede afgrænset med de angivne filtre.
Forudsætninger
- Myndigheden er tilsluttet Digitalt Samtykke.
- Medarbejderen kan logge ind og har adgang til myndighedens samtykker.
To varianter
Integrationspunktet findes i to udgaver. Vælg efter hvor meget du vil styre ved landingen.
Enkel
POST /api/Integration/ConsentQueryParameters
Almindelige formfelter. Kan afgrænse oversigten til en bestemt borger eller en bestemt sag.
JSON
POST /api/Integration/ConsentQueryParameters/Json
Ét formfelt, Body, med et JSON-dokument. Kan ud over afgrænsningen også
forudvælge hvilken fane der åbnes, hvordan der sorteres, og hvilken visning der bruges.
Forløbet
Trin 1. Fagsystemet bygger formularen
En HTML-formular med method="post" mod den valgte variant.
Se de to endpoints i Swagger UI.
Trin 2. Digitalt Samtykke validerer inputtet
Myndigheden skal findes. I JSON-varianten kontrolleres desuden, at de valgte filtre og sorteringer er gyldige for den valgte fane.
Går noget galt, vises en fejlside til brugeren.
Trin 3. Medarbejderen lander på oversigten
Efter login vises samtykkeoversigten med de valgte filtre anvendt. Herfra arbejder medarbejderen videre i Digitalt Samtykke.
Datamodel
Den fulde feltliste med typer, længder og svarkoder ligger i Swagger UI under
POST /api/Integration/ConsentQueryParameters og
POST /api/Integration/ConsentQueryParameters/Json. JSON-varianten har desuden
regler for, hvilke filtre og sorteringer der er gyldige for hvilken fane.
Prøv det
Testklienten har begge varianter. JSON-varianten har desuden en indbygget "byg JSON"-hjælper med løbende forhåndsvisning.