Page tree
Skip to end of metadata
Go to start of metadata




Siden beskriver filudtræk, der udstilles på Datafordeleren fra Danmarks Adresseregister (DAR).

Få en introduktion til Filudtræk på Datafordeleren, hvis du har brug for en generel og mere teknisk indføring i filudtræk på Datafordeleren.

Få en guide til at downloade og opsætte abonnementer på filudtræk i Selvbetjeningen i Guide til filudtræk på Selvbetjeningen.

Under kodelister på Danmarksadresser.dk, kan du finde de værdier forretningsproces, forretningsområde og forretningshændelse kan tage.





Guide til Danmarks Adresseregister (DAR) filudtræk

Denne guide forudsætter, at du via datafordeler.dk har oprettet en webbruger og en tilknyttet tjenestebruger, som skal anvendes til at bestille filudtræk.

Du kan finde guides til, hvordan du opretter en webbruger og tjenestebrugere på Datafordelerens hjemmeside https://datafordeler.dk/vejledning/brugeradgang/









Hent et aktuelt filudtræk

Vælg FILUDTRÆK i den øverste menu, vælg herefter Frit tilgængelige fildownloades.




Der fremkommer en liste med alle de frittilgængelige filudtræk udtræk, som Datafordeleren udstiller.



Marker det ønskede filudtræk og vælg kopier linket i Atom feed med info om nye data.



Sæt linket i en browser



Du har en række muligheder for at hente dit filudtræk. 


Mulighed 1 - hent filudtrækket fra en FTP-server

Hent filudtrækket fra en FTP-server, skal du have installeret en FTP-klient på din PC (eksempel på gratis løsninger: FileZilla, CoffeCup Free FTP, WinSCP).

I det efterfølgende screendump er markeret den adresse, som du skal bruge adressen på FTP-serveren. 



I din FTP-klient indsætter du adressen og tilgår filudtrækkene anonymt. 



Mulighed 2 - hent filudtrækket fra din browser

I det efterfølgende screendump er markeret det link, som du skal bruge for at hente det seneste filudtræk via din browser.







Opsæt et abonnement på et prædefineret filudtræk

Når du har oprettet et abonnement på et prædefineret filudtræk, vil du med det samme modtage det senest oprettede filudtræk. 

Abonnementet har et fast interval, så du hver mandag senest kl. 04.00 vil modtage nyeste udtræk genereret tidligt mandag morgen.


Vælg FILUDTRÆK i den øverste menu, vælg herefter PREDEFINED.



Der fremkommer en liste med alle de faste udtræk, som Datafordeleren udstiller.

Du kan sortere i alle de udtræk, der udbydes, ved fx at fremsøge de udtræk, der vedrører Danmarks Adresseregister. Eksemplet viser søgeresultatet for en søgning på DAR. Søgeresultatet viser fire totale udtræk af alle aktuelle data i json og xml for henholdsvis ugentlige og daglige udtræk.




Vælg et passende visningsnavn, din tjenestebruger og vælg det ønskede udtræk og klik NÆSTE.

Visningsnavn

Visningsnavn er filnavnet til dit udtræk. Datafordeleren supplerer selv navnet med dato og tidspunkt for udtrækket.

Fx: "Testforsoeg_21_20200315141312"

Datafordeleren skifter selv eventuelle mellemrum ud med "_" og danske bogstaver ud med omskrivninger (aa, ae eller oe), når den genererer din fil, men det får du ikke at vide.

Fx: "Fanø Kommune" ændres i udtrækket til: "Fanoe_Kommune”.

Datafordeleren tjekker ikke her, om der er andre ulovlige tegn i navnet. Hvis dette er tilfældet, får du det først at vide, når du har hentet filen, så anvend KUN: Danske bogstaver, tal og mellemrum.


Det er nu muligt at se hvilke parametre, som er sat op for det valgte filudtræk.

Det er ikke muligt at rette i parametre for de prædefineret filudtræk - har du fortrudt dit valg af tjeneste, så klik FORRIGE.




Acceptér ved at klikke GEM.


Du modtager en bekræftelse på, at dit abonnement er oprettet.

Klik på OK.



Når Datafordeleren har produceret dit filudtræk, modtager du en email, som oplyser, at du kan hente dit filudtræk på Datafordelerens FTP-server.

Et eksempel på en email fra Datafordeleren.



For at kunne hente filer fra en FTP-server, skal du have installeret en FTP-klient på din PC (eksempel på gratis løsninger: FileZilla, CoffeCup Free FTP, WinSCP).

Du skal bruge adressen på FTP-serveren, som er angivet i mailen, du har modtaget. I din FTP-klient skal du også angive dit tjenestebrugernavn og adgangskode foruden portnummer, som er 21.







Opsæt et abonnement på et brugerdefineret filudtræk

Ved et brugerdefineret filudtræk opretter du et abonnement på automatisk udtræk og advisering af et brugerdefineret udtræk.


Vælg FILUDTRÆK i den øverste menu, vælg herefter OPRET.







Der fremkommer en liste med alle de brugerdefinerede filudtræk, som Datafordeleren udstiller.

Du kan sortere i alle de udtræk, der udbydes, ved fx at fremsøge de udtræk, der vedrører Danmarks Adresseregister. Eksemplet viser søgeresultatet for en søgning på DAR. Søgeresultatet viser et total udtræk fra Danmarks Adresseregister (DAR).







Når du markere det ønskede filudtræk bliver du bedt om at vælge visningsnavn og tjenestebruger. Derudover skal du svare på, hvor hyppigt du ønsker dette udtræk.

Der vil blive genereret de specificerede filudtræk, indtil du ændrer eller ophæver abonnementet.








Klik på NÆSTE nede i højre hjørne.


På denne side skal du skrive de parametre du ønsker for dit udtræk.

Visningsnavn

Visningsnavn er filnavnet til dit udtræk. Datafordeleren supplerer selv navnet med dato og tidspunkt for udtrækket.

Fx: "Testforsoeg_21_20200315141312"

Datafordeleren skifter selv eventuelle mellemrum ud med "_" og danske bogstaver ud med omskrivninger (aa, ae eller oe), når den genererer din fil, men det får du ikke at vide.

Fx: "Fanø Kommune" ændres i udtrækket til: "Fanoe_Kommune”.

Datafordeleren tjekker ikke her, om der er andre ulovlige tegn i navnet. Hvis dette er tilfældet, får du det først at vide, når du har hentet filen, så anvend KUN: Danske bogstaver, tal og mellemrum.


Tjenestebruger

Vælg hvilken af dine tjenestebrugere, du ønsker at benytte, hvis du har flere.


Interval

Der kan vælges mellem forskellige intervaller: Ugentligt, Månedligt, Kvartalsvis, Årligt eller N-Månedligt.


Timer

Tidspunktet kan også frit stilles.



VirkningFra

Tidspunktet hvorfra forvaltningsobjekterne har virkning. 


VirkningTil

Tidspunktet hvortil forvaltningsobjekterne har virkning. 


RegistreringFra

Tidspunktet hvorfra dataobjekterne er registreret i registeret. 


RegistreringTil

Tidspunktet hvortil dataobjekterne er registreret i registeret. 


DAFTimestampFra

Dataobjekter registreret i Datafordeleren før dette tidspunkt medtages ikke i resultatet.


DAFTimestampTil

Dataobjekter registreret i Datafordeleren efter dette tidspunkt medtages ikke i resultatet.


Læs mere om dato- og tidsformat i Generelt for DAR filudtræk


Status

Dataobjekternes status i den pågældende version, dvs. elementets tilstand i den samlede livscyklus. Under kodelister på Danmarksadresser.dk, kan du finde de værdier forretningsproces, forretningsområde og forretningshændelse kan tage under status.


Output_format


 Mulige output formater

Json - skriv json i Selvbetjeningen

Xml - skriv xml i Selvbetjeningen



OPMÆRKSOMHEDSPUNKTER VED OPSÆTNING AF PARAMETRE

Hvis du blot trykker på GEM uden at foretage dig noget, får du genereret et filudtræk, som er baseret på default værdierne.

Der er ingen detaljeret vejledning til parametre i Selvbetjeningen.  Datafordeleren tjekker ikke for korrekte indtastninger blandt de lovlige værdier, så vær meget omhyggelig.

Hvis du staver forkert får du ingen advarsel. Der kommer først en reaktion på fejl, når du har hentet og udpakket den genererede fil.




Klik herefter på GEM.




Du modtager en bekræftelse på, at dit abonnement er oprettet.

Klik på OK.







Når Datafordeleren har produceret dit filudtræk, modtager du en email, som oplyser, at du kan hente dit filudtræk på Datafordelerens FTP-server.

Et eksempel på en email fra Datafordeleren.







For at kunne hente filer fra en FTP-server, skal du have installeret en FTP-klient på din PC (eksempel på gratis løsninger: FileZilla, CoffeCup Free FTP, WinSCP).

Du skal bruge adressen på FTP-serveren, som er angivet i mailen, du har modtaget. I din FTP-klient skal du også angive dit tjenestebrugernavn og adgangskode foruden portnummer, som er 21.













Hent et brugerdefineret filudtræk

Under download henter du et brugerdefineret udtræk, der bliver udtrukket, når du bestiller det. 


Vælg FILUDTRÆK i den øverste menu, vælg herefter DOWNLOAD.






Du kan følge Opsæt et abonnement på et brugerdefineret filudtræk og vil undgå at angive Interval og Timer under opsætningen af tjenesten. 

Bemærk, at der svares altid "Abonnement blev oprettet", skønt du ikke har bestilt et abonnement, men kun et enkeltstående filudtræk.











Generelt for DAR filudtræk 

Registernavn i SelvbetjeningenDAR
FormaterXML, JSON 
DLS version2.3.4
Sikkerhedszone0 – Indeholder ikke fortrolige eller følsomme data
TværgåendeNej
Dato- og tidsformat

Datoformat følger ISO 8601 Date and time format.

Alle datoer skrives med andre ord i formatet yyyy-mm-ddTHH:MM:SS.ssssss, hvor tidsangivelsen kan udelades.

Tidszonen kan angives enten ved (2019-02-05T07:50:14.687580+01:00 (for normaltid/vintertid)), (2019-07-05T07:50:14.687580+02:00 (for sommertid)) eller ved at benytte Z (2019-07-05T07:50:14.687580Z).




DAR Totaludtræk

Beskrivelse

Udtræk af al data i DAR ud fra de angivne parametre.

Totaludtræk for DAR ud fra specificeret virkningsperiode, registreringsperiode og DAF registreringstidspunkt.

Tjenesteversion
("udgave" i Selvbetjeningen)
1.0.1


Prædefinerede filudtræk

De prædefinerede filudtræk vil indeholde alle data tilbage i tid og frem til de aktuelle opdateringer på Datafordeleren.

De prædefinerede filudtræk er opsat efter udtrækkets default værdier.

Du kan på "Filudtræk på Datafordeleren" se en oversigt over Tidsparametre på ejendoms- og adresseområdet for de prædefinerede filudtræk.



DAR Totaludtraek Complete XML

TjenestenavnDAR Totaludtræk
TjenestevisningsnavnDAR Totaludtraek Complete XML
Inputparametre

Inputparametrene følger defaultværdierne fra det brugerdefineret filudtræk, som dette filudtræk er opbygget efter.

FormatXML
Minimumsinterval for abonnementUgentlig
Lagringstid30 dage
Forventes klarMandag 04:00:00



DAR Totaludtraek Complete JSON

TjenestenavnDAR Totaludtræk
TjenestevisningsnavnDAR Totaludtraek Complete JSON
Inputparametre

Inputparametrene følger defaultværdierne fra det brugerdefineret filudtræk, som dette filudtræk er opbygget efter.

FormatJSON
Minimumsinterval for abonnementUgentlig
Lagringstid30 dage
Forventes klarMandag 04:00:00



DAR Totaludtraek DeltaDaily XML

TjenestenavnDAR Totaludtræk
TjenestevisningsnavnDAR Totaludtraek DeltaDaily XML
Inputparametre

Inputparametrene følger defaultværdierne fra det brugerdefineret filudtræk, som dette filudtræk er opbygget efter.

FormatXML
Minimumsinterval for abonnementDagligt
Lagringstid30 dage
Forventes klar00:00:00



DAR Totaludtraek DeltaDaily JSON

TjenestenavnDAR Totaludtræk
TjenestevisningsnavnDAR Totaludtraek DeltaDaily JSON
Inputparametre

Inputparametrene følger defaultværdierne fra det brugerdefineret filudtræk, som dette filudtræk er opbygget efter.

FormatJSON
Minimumsinterval for abonnementDagligt
Lagringstid30 dage
Forventes klar00:00:00




Brugerdefineret filudtræk

Tjenestenavn

DAR-Totaludtraek

Tjenestevisningsnavn

DAR Totaludtræk

Minimumsinterval for abonnement

Dagligt

Type

Brugerdefineret 

Lagringstid for udtræk

30 dage

Adgangsniveau

Kendt bruger – der skal oprettes en webbruger og tjenestebruger med brugernavn og adgangskode.


Inputparametre

Since Previous (Deltafiler)

Vælger du checkboksen med Since Previous vil den første levering indeholde alle data, som du har sat dit abonnement op til.
Efterfølgende vil du via dit abonnement modtage deltafiler med ændringer eller opdateringer af data.


Navn

Type

Beskrivelse

Default VærdiUUID fra Udstillingsmodel

VirkningFra

Streng

Tidspunktet hvorfra forvaltningsobjekterne har virkning. 

NULLEAID_AB768062_FD24_4960_8AA1_C6BFF90C00C5

VirkningTil

Streng 

Tidspunktet hvortil forvaltningsobjekterne har virkning. 

NULLEAID_3058C5FD_9824_48ba_B62C_C24587BF6537

RegistreringFra

Streng 

Tidspunktet hvorfra dataobjekterne er registreret i registeret. 

NULLEAID_96862BAA_95CA_46aa_A6A0_757327A10BF7

RegistreringTil

Streng 

Tidspunktet hvortil dataobjekterne er registreret i registeret. 

NULLEAID_301BF58F_26E7_4d1f_B7B6_3881F8C1B0A5

DAFTimestampFra

Streng 

Dataobjekter registreret i Datafordeleren før dette tidspunkt medtages ikke i resultatet.

NULL

DAFTimestampTil

Streng 

Dataobjekter registreret i Datafordeleren efter dette tidspunkt medtages ikke i resultatet.

Now()

Status

List<String>

Dataobjekternes status i den pågældende version, dvs. elementets tilstand i den samlede livscyklus. 

NULL




Outputparametre

MetodeSkema
Den inkluderede fil ”DAR_2.3.4_DARTotal.schema.json” indeholder output som JSON-schemaSkema - filudtræk og webservices (DAR)




Eksempel

Alle sager som var gældende mellem 22-03-2015 og 22-03-2017.







DAR Aktuelt Totaludtræk

Beskrivelse

Filudtræk baseret på REST tjenesten DAR (Rest).

Totaludtræk for DAR ud fra specificeret virkningsperiode, registreringsperiode og DAF registreringstidspunkt.

Tjenesteversion
("udgave" i Selvbetjeningen)
1.0.1



Prædefinerede filudtræk

De prædefinerede filudtræk vil indeholde de aktuelt gældende og registrerede DAR data.

De prædefinerede filudtræk er opsat efter udtrækkets default værdier.

Du kan på "Filudtræk på Datafordeleren" se en oversigt over Tidsparametre på ejendoms- og adresseområdet for de prædefinerede filudtræk.


DAR Aktuelt Totaludtræk XML

TjenestenavnDAR-Aktuelt-Totaludtraek
TjenestevisningsnavnDAR Aktuelt Totaludtræk XML
Inputparametre

Inputparametrene følger defaultværdierne fra det brugerdefineret filudtræk, som dette filudtræk er opbygget efter.

FormatXML
Minimumsinterval for abonnement

Dagligt

Forventes klar00:00:00
Lagringstid for udtræk

30 dage

Adgangsniveau

Anonym bruger – man behøver ikke at være bruger


BEMÆRK

De to filudtræk DAR Aktuelt Totaludtræk XML og DAR Aktuelt Totaludtræk JSON er i Selvbetjeningen placeret under de frit tilgængelig fildownloads og vil derfor ikke optræde på listen over de prædefinerede filudtræk.





DAR Aktuelt Totaludtræk JSON

TjenestenavnDAR-Aktuelt-Totaludtraek
TjenestevisningsnavnDAR Aktuelt Totaludtræk JSON
Inputparametre

Inputparametrene følger defaultværdierne fra det brugerdefineret filudtræk, som dette filudtræk er opbygget efter.

FormatJSON
Minimumsinterval for abonnement

Dagligt

Forventes klar00:00:00
Lagringstid for udtræk

30 dage

Adgangsniveau

Anonym bruger – man behøver ikke at være bruger







Parametre

Inputparametre

Navn

Type

Beskrivelse

Default VærdiUUID fra Udstillingsmodel
VirkningFraStrengTidspunktet hvorfra forvaltningsobjekterne har virkning.NOW()EAID_AB768062_FD24_4960_8AA1_C6BFF90C00C5
VirkningTilStrengTidspunktet hvortil forvaltningsobjekterne har virkning.NOW()EAID_3058C5FD_9824_48ba_B62C_C24587BF6537
RegistreringFraStrengTidspunktet hvorfra dataobjekterne er registreret i registeret.NOW()EAID_96862BAA_95CA_46aa_A6A0_757327A10BF7
RegistreringTilStrengTidspunktet hvortil dataobjekterne er registreret i registeret.NOW()EAID_301BF58F_26E7_4d1f_B7B6_3881F8C1B0A5
DAFTimestampFraStrengDataobjekter registreret i Datafordeleren før dette tidspunkt medtages ikke i resultatet.NULL
DAFTimestampTilStrengDataobjekter registreret i Datafordeleren efter dette tidspunkt medtages ikke i resultatet.Now()
StatusList<String>Dataobjekternes status i den pågældende version, dvs. elementets tilstand i den samlede livscyklus.NULL




Outputparametre

MetodeSkema
Den inkluderede fil ”DAR_2.3.4_DARTotal.schema.json” indeholder output som JSON-schemaSkema - filudtræk og webservices (DAR)