Formål

At du får den rette adgang til Datafordeleren, så du kan hente data på den måde, der passer til dit behov.

Vigtigt om fortrolige data

Du skal afklare, om de data og tjenester, du ønsker at bruge, indeholder fortrolige oplysninger, fordi det kan have en betydning for valg af adgang, sikkerhed og godkendelser.

Læs mere under 3: Fortrolige data.

Formål 

Overvej hvilke data og registre du har brug for, og hvordan data skal anvendes. Brug Dataoversigten til at få et overblik over tilgængelige tjenester, adgangstyper og dokumentation.

Gør dette

• Gå til Dataoversigten og søg på de registre eller datatyper, du har brug for.
• Undersøg hvilke tjenester der stiller data til rådighed, og hvordan de er opbygget.
• Se hvilken adgangstype der anvendes (for eksempel API, fildownload eller geoservices).
• Følg links til dokumentation under tjenesten for at forstå dataindhold og anvendelse.
• Se under punkt 2: Hent data, for mere information omkring de forskellige datatyper.

Vær opmærksom på

• Dit valg af data har betydning for den videre opsætning af brugere, IT-systemer og sikkerhed.
• Nogle tjenester kan indeholde fortrolige data og kræve særlig adgang. Se under punkt 3: Fortrolige data.

Formål

At du får de oplysninger det kræver for at logge på og oprette dig på Datafordeleren.

I Datafordelerens Administration kan du oprette bruger med MitID eller e-mail, oprette IT-systemer og opsætte sikker adgang i form af API-key eller OAuth. Her kan du også anmode om adgang til fortrolige data og administrere brugere og rettigheder.                                       

Bemærk, at test- og produktionsmiljø er adskilte og har hver deres opsætning.

Sådan gør du

Gå til den tjeneste, du vil benytte, i Dataoversigten og læs hvilke adgangskrav der gælder.

Adgangskravene for tjenesten afgør, hvilken type bruger og adgang du skal oprette.

Du kan i Oversigt over brugeradgang læse, hvilken adgang de forskellige registrer kræver. 

Gå derefter til Log på Datafordeleren. Hvis du ikke allerede har en konto, skal du oprette en bruger med MitID eller e-mail. Vær opmærksom på, at fortrolige data kræver, at du opretter en bruger med MitID.

Læs mere om, hvilken bruger du skal oprette, og hvordan du gør, i dokumentationen om Brugeroprettelse.

Formål

Hvordan du henter dine data fra Datafordeleren afhænger af dine behov og dit valg af tjenester. Datafordeleren understøtter flere forskellige måder at hente data på, afhængigt af datamængde, anvendelse og tekniske krav. 

Hvilke muligheder der er tilgængelige, afhænger af den enkelte tjeneste og fremgår af Dataoversigten og den tilhørende dokumentation.

Formål

Hvordan du skal hente dine data afhænger af dine behov og dit valg af tjenester.

Data på Datafordeleren kan hentes via:

• GraphQL
• Fildownload
• Webservices (WFS, WMS, WMTS, WCS) 

Formål

Fildownload er en funktion til at hente data på Datafordeleren. Du kan hente fildownload med API-key og OAuth.

Fildownload tilbydes som prægenererede entitetsbaserede og rasterbaserede, samt som punktsky og baserer sig på de datamodeller, som registrene har på Datafordeleren.

Fildownload på Datafordeleren tilgås via et REST-API eller ved at logge ind på datafordeler.dk og benytte Dataoversigten.

Læs mere om Fildownload på Datafordeleren.

Få en Guide til fildownload på Datafordeleren.

GraphQL

GraphQL er et API-sprog, der gør det muligt at hente data på en effektiv og fleksibel måde. GraphQL-tjenesterne er velegnede, når du ønsker at hente mindre datamængder og ikke ønsker at efterbehandle data. Du kan hente GraphQL-tjenester med API-key og OAuth.

GraphQL-tjenester tilbydes som entitetsbaserede GraphQL-tjenester og baserer sig på de datamodeller, som registrene har på Datafordeleren.

GraphQL-tjenesterne på Datafordeleren tilgås via et GraphQL-API, gennem en desktop applikation eller gennem browseren ved brug af en udvidelse til browseren.

Du kan også hente GrahpQL skemaer og bygge en query via en GraphQL-klient.

Fleksibel opslagslogik 

Fleksibel opslagslogik er en ny GraphQL-tjeneste på Datafordeleren, der gør det muligt at udstille data gennem brug af joins i GraphQL.

Læs mere om Fleksibel opslagslogik på Datafordeleren. 

Læs mere om GraphQL på Datafordeleren.

Få en Guide til GraphQL på Datafordeleren.

Formål

Hændelser giver anvendere mulighed for at modtage automatiske notifikationer, når data ændres, så de kan holde egne løsninger opdaterede uden at skulle forespørge unødigt efter data.

Læs mere om Entitetsbaserede hændelser på Datafordeleren.  

Formål

Webservices giver anvenderne mulighed for at hente data ved at kalde en service.

Du finder den relevante URL under tjenesten i Dataoversigten. URL'en skal beriges med din tjenestebrugers brugernavn og adgangskode.

Støt dig til de guides, som der bliver linket til under tjenesten for de forskellige typer af webservices.

WFS

Datafordeleren udstiller entitetsbaserede WFS-tjenester, som er automatisk genereret og baseret direkte på registrenes datamodeller.

Læs mere om WFS på datafordeleren.

WMS, WMTS, WCS

Datafordeleren udstiller entitetsbaserede WFS-tjenester, som er baseret direkte på registrenes datamodeller.

Læs mere om WMS, WMTS og WCS på Datafordeleren.

Sammenstillede WFS

Sammenstillede WFS-tjenester indeholder data fra et register i lag, som er beregnet til at bruge i GIS-klienter. 

Læs mere om Sammenstillede WFS på Datafordeleren.

Formål

At du afklarer, om de data og tjenester, du vil bruge, indeholder fortrolige oplysninger, og sikrer, at adgang, godkendelser og sikkerhedsopsætning er på plads, før data tages i brug.

Fortrolige data kræver særlige rettigheder og tekniske sikkerhedstiltag. Det er derfor vigtigt, at du tager stilling til dette tidligt i processen.

Se nedenfor, hvordan du trin for trin afklarer krav til fortrolige data og sikrer korrekt adgang.

Vær opmærksom på

Ikke alle tjenester på Datafordeleren er frit tilgængelige. Nogle indeholder oplysninger, som kræver særlig adgang.

Start med at undersøge de tjenester du vil bruge:

• Find tjenesten i Dataoversigten.
• Læs vilkår for brug af data og adgangskrav (her fremgår det, hvilken adgang data kræver).
• Brug link til registerspecifik dokumentation for detaljer.

Formål

Hvis dit valg af tjeneste indeholder fortrolige data, skal du afklare, hvad der kræves for at få adgang: 

• Tjenesterne kræver godkendelse hos den relevante registermyndighed. For at anmode om adgang skal du følge vejledningen på Anmodning om adgang, hvor du finder en oversigt over de registre, der udstiller adgangsbegrænsede tjenester på Datafordeleren.
• Kræver tjenesten et særligt sikkerhedsniveau (for eksempel MitID og OAuth)
• Er der krav om IP Allowlist eller andre tekniske begrænsninger?
• Er der krav til bruger- og rettighedsstyring (hvem må tilgå data)?

Hvis tjenesten kræver godkendelse:

• Følg den proces i Datafordelerens Administration, der er beskrevet i registermyndighedens dokumentation.
• Indsend de nødvendige oplysninger (formål, anvendelse, system, kontaktperson).
• Afvent registerets godkendelse af din anmodning før du går videre.

Læs mere om anmodning til beskyttede data på Datafordeleren. 

Når kravene er afklaret (og adgang er godkendt), skal du sikre, at opsætningen er korrekt:

• Opsæt autentifikation (OAuth eller anden krævet metode).
• Opret IP Allowlist, hvis det er et krav.
• Tildel adgang til de rigtige brugere/roller.

Du kan teste din opsætning i testmiljøerne, inden du bruger data i produktionen:

• Test adgang og dataflow i Testmiljøet. 
• Læs mere om de forskellige testmiljøer på Test på Datafordeleren. 

Bemærk: Hvert testmiljø har sin egen administration og kræver særskilt adgang. Sørg derfor for, at du har adgang til det testmiljø, du skal bruge.

Formål

At du løbende kan holde dig orienteret om drift, ændringer og vigtige meddelelser på Datafordeleren, og ved hvordan du skal forholde dig, hvis noget ikke fungerer som forventet.

Herunder er de trin, du skal følge for at holde dig orienteret og reagere ved ændringer eller fejl.

Vær opmærksom på

Driftsforstyrrelser, planlagt vedligehold og ændringer kan påvirke, hvordan dine tjenester fungerer.

Driftssiden giver et overblik over den aktuelle driftsstatus på Datafordeleren og informerer om planlagt vedligehold og kommende ændringer.

Her kan du se, om der er kendte driftsforstyrrelser, som kan påvirke dine data eller integrationer.

• Tjek driftssiden for meddelelser omkring fejl, manglende data eller driftsforstyrrelser.
• Hold øje med planlagte ændringer og opdateringer, som kan påvirke eksisterende løsninger.
• Opret abonnement på meddelelser og vælg hvilke registre du vil følge. Du får automatisk abonnement på generelle meddelelser om Datafordeleren.

Vær opmærksom på

Mange fejl og spørgsmål er allerede beskrevet på supportsiden.

På supportsiden finder du kendte fejl, FAQ og anbefalinger, som kan hjælpe dig med at løse kendte problemer og afklare spørgsmål om brugen af Datafordeleren. Der kan være yderligere link til relevant dokumentation.

• Tjek Kendte Fejl for kendte problemer og midlertidige løsninger. 
• Brug FAQ til at få svar på typiske spørgsmål om adgang, data og funktionalitet.
• Følg anbefalinger for god praksis ved brug af Datafordeleren.

Vær opmærksom på

Datafordeleren arbejder løbende med at optimere den tilhørende dokumentation på siden.

Hvis du oplever problemer, som ikke kan afklares via driftsmeddelelser eller kendte fejl, kan du kontakte Datafordelerens support.

• Har du spørgsmål eller forslag til ændringer, kan du skrive til Datafordeler Support via datafordeler.dk/Support.