Find det register på listen, som du ønsker at abonnere på, og fold linjen ud ved at klikke på pilen til højre for registret.
Klik på Opret abonnement.
Opsætning
Du skal nu udfylde en række informationer, som led i oprettelsen af et abonnement.
Oplysninger
Levering
Eksempel på opbygning af url med brugernavn og adgangskode
<endpoint>/system/EventMessages/1.0.0/custom?datefrom=yyyy-mm-dd&dateto=yyyy-mm-dd&username=xxx&password=yyy&format=zzz&page=xx&pagesize=zz
Eksempel på opbygning af url i sikkerhedszone 0 med brugernavn og adgangskode
https://services.datafordeler.dk/system/EventMessages/1.0.0/custom?datefrom=yyyy-mm-dd&dateto=yyyy-mm-dd&username=xxx&password=yyy&format=zzz&page=xx&pagesize=zz
Eksempel på opbygning af url i sikkerhedszone 0 med certifikat
https://certservices.datafordeler.dk/system/EventMessages/1.0.0/custom?datefrom=yyyy-mm-dd&dateto=yyyy-mm-dd&format=zzz&page=xx&pagesize=zz
Eksempel på opbygning af url i sikkerhedszone 5 med certifikat
https://s5-certservices.datafordeler.dk/system/EventMessages/1.0.0/custom?datefrom=yyyy-mm-dd&dateto=yyyy-mm-dd&format=zzz&page=xx&pagesize=zz
Hændelsesbesked (PUSH)
Vælger du PUSH under Leveringstype skal du endvidere oplyse push-endepunkt og e-mail.
PUSH af hændelser fra Datafordeleren til anvendere er baseret på OData-standarden, og kendskab til OData er derfor en fordel, hvis man ønsker hændelsesbeskeder distribueret med PUSH.
Læs mere om PUSH af hændelser
Filtrering (valgfrit)
Betingelser
Filtre er opbygget af betingelser, som består af et felt, en operator og en betingelses værdi.
Det er ikke nødvendigt at opsætte filtre. Ønsker du ikke at benytte dig af muligheden tryk NÆSTE.
Ønsker du dig at opsætte filtre vælg "Tilføj Betingelse"
Felt
Felt henviser til et felt i en betingelse, som kan kombineres med en operator og en værdi.
I de registerspecifikke hændelseskataloger kan du for hver enkelt beskedtype se hvordan felterne skal udfyldes ved dannelse af en datanær hændelse.
Læs mere om datanære hændelser.
Find den registerspecifikke dokumentation via Dataoversigten på Datafordeler.dk.
Operator
Operator angiver sammenhængen mellem det valgte feltnavn og værdien i betingelsen.
Bemærk, at operatoren INDEHOLDER kun kan benyttes til feltet Objekthandling, hvis indhold i den forbindelse fortolkes som en liste.
Med operatorerne I og IKKE I er det muligt at angive en kommasepareret liste som værdi.
Betingelses værdi
I de registerspecifikke hændelseskataloger kan du for hver enkelt beskedtype se hvordan værdierne skal udfyldes ved dannelse af en datanær hændelse. Tabellerne i dokumentationen er udfyldt ud fra de specifikationer, der danner grundlag for konfigurationen af de datanære hændelser. Find den registerspecifikke dokumentation via Dataoversigten på Datafordeler.dk.
Til følgende felter i betingelserne knytter sig særlige bemærkninger;
- Beskedtype
Undlad at filtrere på feltet beskedtype, da denne parameter allerede er angivet - Beskedansvarligaktør
Undlad at filtrere på feltet beskedansvarligaktør, da der altid kun vil være en valgmulighed - Objekthandling
For feltet Objekthandling er det som noget specielt muligt at filtrere på, om det indeholder et bestemt ord. Hvis Objekthandling benyttes af registeret til at angive en liste med navne på ændrede felter, kan en anvender således opsætte et filter til kun at modtage hændelser, der omhandler ændringer i et bestemt felt.
Det er alene registeret, der bestemmer, hvorledes Objekthandling udfyldes, og der henvises derfor til den registerspecifikke dokumentation af hændelser for en beskrivelse af, hvordan felter i hændelsesbeskederne udfyldes ved dannelse af datanære hændelser på Datafordeleren.
Feltet Objekthandling kan være udfyldt med en tekststreng af formen value1;value2;…;valueN, der fortolkes som en liste af værdier adskilt med semikolon. Ved hjælp af operatoren INDEHOLDER kan du opstille en betingelse, om at denne liste af værdier i Objekthandling indeholder en bestemt værdi. Fx vil betingelsen ([Objekthandling] INDEHOLDER ’Postnummer’) evaluere til sand, når Objekthandling er udfyldt med ”By;Postnummer;Vejnavn”.
- Beskedtype
Eksempel på opsætning af en betingelse
Et eksempel for et abonnement på en opsætning for hændelsen JordstykkeCreate. Filtrering ved, at objekthandlingen skal indeholde SAMLETFASTEJENDOMLOKALID.
I opsætningen angives værdien som ren tekst. I filter-feltet ses, at systemet automatisk tilføjer ’ ’ omkring SAMLETFASTEJENDOMLOKALID i forespørgslen.
Grupper
Et filter kan indeholde en eller flere betingelser.
Den valgte betingelse eller rækken af betingelser kan endvidere grupperes og kombineres med andre grupper med de logiske operatorer OG og ELLER.
Geografisk afgrænsning (valgfrit)
Det er muligt at afgrænse de hændelsesbeskeder du ønsker at modtage til et bestemt geografisk område.
Du kan vælge mellem 3 forskellige typer geografiske afgrænsninger; bounding box, punkt/radius og DAGI inddeling.
Bounding box
Du kan zoome ind og ud med musen, hvis du holder shift nede, eller benytte ikonerne med + og - i venstre hjørne.
Klik det sted på kortet, hvor du vil placere et hjørne af din afgrænsning. Herefter er det muligt at trække i punktet, som bliver en Bounding BOX. Når du har fundet det ønskede udsnit klikker du igen, og boxen markeres med rød, og koordinaterne for kortudsnittet bliver automatisk angivet i felterne.
Punkt/radius
Du kan zoome ind og ud med musen, hvis du holder shift nede, eller benytte ikonerne med + og - i venstre hjørne.
Klik det sted på kortet, hvor du vil placere centrum af din afgrænsning. Herefter er det muligt at trække i punktet, som bliver radius på cirklen. Når du har fundet det ønskede udsnit klikker du igen, og cirklen markeres med rød, og koordinaterne for kortudsnittet bliver automatisk angivet i felterne.
DAGI inddeling
Vælger du DAGI inddeling tager det lidt tid at indlæse siden. Når siden er indlæst vises der markering af kommunerne.
I drop down menuen vælger du den kommune, som du ønsker at benytte til at afgrænse dit hændelsesabonnement.
Gennemse oplysninger, og bekræft abonnement
Når du har valgt oplysninger, levering, filtrering og geografisk afgrænsning, skal du gennemse dine valgte oplysninger. Herefter kan du klikke på Opret, for at oprette dit abonnement, eller gå tilbage for at redigere i dine valg til abonnementet.
Når du har valgt Opret, får du en bekræftelse på at dit abonnement er under udarbejdelse.
Herefter kan dit abonnement findes under Dine hændelser på din kontoside. Her har du mulighed for at gøre dit abonnement inaktiv/aktiv, redigere filter, geografisk afgrænsning eller slette dit abonnement igen.
Ikke alle detaljer vises i oversigten for et hændelsesabonnement. Hvis der er et filter eller en geografisk udstrækning, kan de først ses, når man har klikke på enten Rediger filter eller Rediger geografisk afgrænsning.
Du har også mulighed for at slette dit abonnement her, ved at klikke på Slet.