You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »



Denne side beskriver hvordan du får tegnet et abonnement på en hændelse på Datafordeleren.

I det følgende forudsættes kendskab til webbrugere og tjenestebrugere på Selvbetjeningen samt det overordnede flow i opdatering af data og dannelse af datanære hændelser på Datafordeleren.

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.






Log på Selvbetjeningen

Oprettelsen af et abonnement kræver en webbruger og tjenestebruger, da abonnementet er relateret til en specifik tjenestebrugere. På grund af sikkerhedshensyn kræver nogle hændelser, at registeret giver adgang til, at en tjenestebruger kan abonnere på dem. 

Brug Dataoversigten til at undersøge, hvilken brugeradgang den ønskede hændelse kræver og læs mere om Brugeroprettelse og Brugeradgang på Datafordeler.dk.

Log på Selvbetjeningen med den ønskede webbruger og anmod eventuelt om adgang til de begrænsede tjenester via din tjenestebrugeren, som du finder under det overordnede menupunkt BRUGERE.

Til toppen



Opret et abonnement på en hændelse

Du kan på Selvbetjeningen under menupunktet HÆNDELSER oprette et abonnement på en hændelse.

Vælg i feltet med teksten "Alle brugere" den tjenestebruger, som du ønsker at tegne abonnementet med.

Bemærk, at hvis du ikke selv vælger en tjenestebruger, så bliver hændelsen automatisk tilknyttet til den første tjenestebruger. 

Vælg opret

Til toppen


Opsætning

Du skal nu udfylde en række informationer, som led i oprettelsen af et abonnement.





FELTER I OPSÆTNINGEN

  • Visningsnavn
    Du vælger selv et sigende visningsnavn for hændelsen
  • Tjenestebruger
    Her er angivet den tjenestebruger, som du har valgt til at tegne abonnementet
  • Aktiv
    Feltet angiver om abonnementet er aktivt eller ej
  • Registermyndighed
    I feltet vælger du det registre, hvorfra den hændelse, som du ønsker at abonnere på stammer.
    Bemærk, at feltet udfyldes med registerets navn i stedet for registermyndigheden. Eksempelvis CVR i stedet for Erhvervsstyrelsen
  • Abonnementtype
    Her kan du vælge mellem Datahændelser og Forretningshændelser
    Vælg som udgangspunkt Datahændelser.
    Læs mere om Forretningsmæssige og datanære hændelser
  • Beskedtype
    I feltet kan du vælge den hændelse, som abonnementet skal knyttes til.
  • Leveringsformat
    For de datanære hændelser kan du vælge imellem to leveringsformater XML og JSON. 
  • Leveringstype
    Det er muligt at vælge mellem to forskellige leveringstyper; PULL eller PUSH. 
    Ved PULL henter du hændelsesbeskederne og ved PUSH sender Datafordeleren hændelsesbeskeder til dig. 
    Læs mere om PULL og PUSH

Vælger du PUSH under Leveringstype skal du endvidere oplyse Push-endepunkt og e-mail.

Læs mere om PUSH af hændelser



Udfyld informationerne og vælg NÆSTE






Filtre

Det er muligt at opsætte filtre til dit abonnement.


Betingelser

Filtre er opbygget af betingelser, som består af et felt, en operator og en værdi. 

Vælg Tilføj Betingelse

Til toppen








Felter

Felter henviser til felter 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. Tabellerne i dokumentationen er udfyldt ud fra de specifikationer, der danner grundlag for konfigurationen af de datanære hændelser. Læs mere om datanære hændelser.

Find den registerspecifikke dokumentation via Dataoversigten på Datafordeler.dk.

Til toppen



FELTER I BETINGELSERNE

  • Beskedtype
  • BeskedansvarligAktør
  • TværgåendeProces
  • ObjektID
  • ObjektType
  • Registreringsaktør
  • Registreringstid
  • Status
  • RegistreringsID
  • Objekthandling
  • OpgaveEmne
  • RelateretObjektID
  • RelateretObjekttype





Operatorer

Operatorer angiver sammenhængen mellem det valgte feltnavn og værdien i betingelsen.

Bemærk, at operatoren INDEHOLDER kan kun benyttes til feltet Objekthandling, hvis indhold i den forbindelse fortolkes som en liste.

Til toppen



OPERATORER I BETINGELSERNE

  • =
  • <>
  • <
  • <=
  • >
  • >=
  • I
  • IKKE I
  • INDEHOLDER





Værdier

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.

  • Undlad at filtrere på feltet beskedtype, da dette parameter allerede er angivet

  • Undlad at filtrere på feltet beskedansvarligaktør, da der altid kun vil være en valgmulighed

  • Med operatorerne I og IKKE I er det muligt at angive en kommasepareret liste som værdi. 

  • 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”.

Til toppen

HJÆLP TIL AT AFLÆSE DE REGISTERSPECIFIKKE HÆNDELSESKATALOGER

De registerspecifikke hændelseskataloger er knyttet til de specifikationer, som registret har specificeret i deres Dataleverancespecifikation (DLS). 

I nedenstående kan du se efter hvilke retningslinjer skemaerne i de registerspecifikke hændelseskataloger er udfyldt.

  • N/A
    Er feltet udfyldt med N/A betyder det, at feltet ikke benyttes.
  • Constant(...)
    Er feltet udfyldt med Constant betyder det, at feltet i hændelsesbeskeden altid vil være udfyldt med den viste værdi.
  • Load(...)
    Er feltet udfyldt med Load betyder det, at feltet i hændelsesbeskeden vil være udfyldt med værdien fra opdateringen. 
    Henviser til udstillingsmodellen.
  • Publish(...)
    Er feltet udfyldt med Publish betyder det, at feltet i hændelsesbeskeden vil være udfyldt med værdi fra opdateringen/databasen.
    Henviser til udstillingsmodellen.







Eksempel på opsætning af et filter

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.

Til toppen








Grupper

Et filter kan indeholde en eller flere betingelser. 

Den valgte betingelsen eller rækken af betingelser kan endvidere grupperes og kombineres med andre grupper med de logiske operatorer OG og ELLER.

Til toppen








Geografisk afgrænsning

Det vil være 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.

Til toppen



Bounding box

Angiv koordinater i projektionen UTM32/ETRS89.







Punkt/radius

Angiv koordinater i projektionen UTM32/ETRS89






DAGI inddeling

Kun DAGI polygoner vises. 




DAGI INDDELING

  • Inddelingstype
    F.eks. kommune eller region
  • Inddeling
    For den valgte inddelingstype angives inddeling fra den specifikke type.
    F.eks. Aalborg kommune for inddelingstype kommune eller Region Hovedstaden inddelingstype region





Generering af hændelsesbeskeden

Du har nu sat et abonnement op, som er nødvendigt for at få den hændelsesbesked, der bliver dannet.

Har du i dit abonnement valgt at hente hændelsesbeskeder (PULL-scenariet), vil hændelsesbeskeden blive gjort tilgængelig i en RESTful tjeneste med følgende signatur:

<endpoint>/system/EventMessages/1.0.0/custom?datefrom=yyyy-mm-dd&dateto=yyyy-mm-dd&username=xxxx&password=yyyy

Datefrom og dateto samt brugernavn og adgangskode er obligatoriske parametre og skal derfor tilføjes.

Derudover skal endpoint tilføjes - find det korrekte endpoint på Endpointoversigt og miljøer.

Til toppen







Få et overblik over tjenester på Datafordeleren

Du kan på Selvbetjeningen og se oversigten over samtlige tjenester under menupunktet TJENESTER.

Det er muligt at søge på hændelser på Datafordeleren eller sortere tjenesterne efter de forskellige registre. 



En mere fordelagtig måde at få et overblik på er at gå via Dataoversigten, hvor det er muligt at danne sig en oversigt over alle de eksisterende hændelser, som Datafordeleren tilbyder.

Til toppen




Få en oversigt over oprettede hændelsesabonnementer

Du kan på Selvbetjeningen under menupunktet HÆNDELSER få et overblik over de abonnementer på hændelser, som du har tegnet.

I feltet Alle brugere kan du vælge mellem de tjenestebruger, som du har tilknyttet den webbruger, som du er logget på med. 

Når du har valgt en specifik tjenestebruger i dropdown listen, vises kun abonnementer for den specifikke tjenestebruger. 

Til toppen







Se detaljer for et abonnement på en hændelse

Vælg det ønskede abonnement i resultatlisten.

Detaljer for abonnementet vises i højre side og det valgte abonnement bliver highlightet i resultatlisten

Til toppen




ABONNEMENTSDETALJER

  • Navn
    Her vises det navn, som du har valgt til abonnementet
  • Leveringsformat
    Det valgte leveringsformatet for abonnementet
  • Leveringstype
    Den valgt leveringstyper for abonnementet
  • Push-endpoint
    Eventuel URL adressen for det endpoint, som Datafordeleren skal kalde for at aflevere hændelsen
  • e-mail
    Her angives den e-mail, som skal benyttes ved PUSH
  • Filter
    Her angives de filtre, som eventuelt er opsat til abonnementet
  • Beskedtype visningsnavn
    Her vises visningsnavnet for beskedtypen
  • Aktiv
    Angiver om abonnementet er aktivt eller ej
  • Webbruger identifikation
    Den webbruger, som tegner abonnementet
  • Tjenestebruger identifikation
    Den tjenestebruger, som tegner abonnementet
  • Logisk datamodel klassemodel
    Her vises den logisk entitet
  • No labels