Display Metadata | ||
---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
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.
Ønsker du at opsætte et kopiregister kan du med fordel benytte Datafordeleren - guide til kopiregistre.
Du kan finde eksempler på, hvad der sker med DAR data i filudtræk, når der sker ændringer i adresser på siden Grunddata – eksempler på anvendelse af bitemporalitet.
Under kodelister på Danmarksadresser.dk, kan du finde de værdier forretningsproces, forretningsområde og forretningshændelse kan tage.
Info |
---|
Bemærk Datafordeleren ændrer tjenester med filudtræk i JSON-og XML-formater Den 15. februar 2023 overgår distributionen af filudtræk på Datafordeleren fra FME til Hangfire. Derfor kan du fra den 15. februar 2023 ændre dine abonnementer på filudtræk i JSON-og XML-formater fra Datafordeleren. Du skal oprette abonnement med de nye tjenester som hedder ’_HF’ sidst i navnet. Tjenesterne på denne side er opdateret til de nye navne. Der vil være paralleldrift af de gamle og nye tjenester fra den 15. februar 2023. Der er ikke ændret i logikken eller specifikationen for de enkelte tjenester. Det er kun navnet, der bliver ændret. Læs mere på Datafordelerens ændringsmeddelelser om hvad det har betydning for allerede oprettede abonnementer, og hvordan du opretter nye abonnementer og sletter de gamle. De tidligere filudtræk på FME kan kan ses her: Filudtræk (DAR) FME, udfases |
Table of Contents |
---|
Der fremkommer en liste med alle de frittilgængelige filudtræk udtræk, som Datafordeleren udstiller.
Marker det ønskede filudtræk og 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.
Info | ||
---|---|---|
| ||
Visningsnavn Visningsnavn er filnavnet til dit udtræk. Datafordeleren supplerer selv navnet med dato og tidspunkt for udtrækket. F.eks.: "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. F.eks.: "DAR Filudtræk " ændres i udtrækket til: "DAR Filudtraek”. 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. |
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.
Info | ||
---|---|---|
| ||
Visningsnavn Visningsnavn er filnavnet til dit udtræk. Datafordeleren supplerer selv navnet med dato og tidspunkt for udtrækket. F.eks.: "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. F.eks.: "DAR Filudtræk " ændres i udtrækket til: "DAR Filudtraek”. 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: Dagligt, Ugentligt, Månedligt, Kvartalsvis, Årligt eller N-Månedligt. Timer Tidspunktet kan også frit stilles. |
Info | |||||
---|---|---|---|---|---|
| |||||
VirkningFra - Tidspunktet hvorfra objekterne har virkning. VirkningTil - Tidspunktet hvortil objekterne har virkning. RegistreringFra - Tidspunktet hvorfra objekterne er registreret i registeret. RegistreringTil - Tidspunktet hvortil objekterne er registreret i registeret. DAFTimestampFra - Objekter registreret i Datafordeleren før dette tidspunkt medtages ikke i resultatet. DAFTimestampTil - Objekter registreret i Datafordeleren efter dette tidspunkt medtages ikke i resultatet. Læs mere om dato- og tidsformat i Generelt for DAR filudtræk Status - Objekternes 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
|
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 |
---|
DAR Totaludtraek Complete XML_HF
Tjenestenavn | DAR Totaludtræk_HF |
---|---|
Tjenestevisningsnavn | DAR Totaludtraek Complete XML_HF |
Navn på Datafordeler.dk | DAR Totaludtræk Prædefineret XML |
Inputparametre | Inputparametrene følger defaultværdierne fra det brugerdefineret filudtræk, som dette filudtræk er opbygget efter. |
Format | XML |
Minimumsinterval for abonnement | Ugentlig |
Lagringstid | 30 dage |
Forventes klar | Mandag 04:00:00 |
DAR Totaludtraek Complete JSON_HF
Tjenestenavn | DAR Totaludtræk_HF |
---|---|
Tjenestevisningsnavn | DAR Totaludtraek Complete JSON_HF |
Navn på Datafordeler.dk | DAR Totaludtræk Prædefineret JSON |
Inputparametre | Inputparametrene følger defaultværdierne fra det brugerdefineret filudtræk, som dette filudtræk er opbygget efter. |
Format | JSON |
Minimumsinterval for abonnement | Ugentlig |
Lagringstid | 30 dage |
Forventes klar | Mandag 04:00:00 |
DAR Totaludtraek DeltaDaily XML_HF
Tjenestenavn | DAR Totaludtræk_HF |
---|---|
Tjenestevisningsnavn | DAR Totaludtraek DeltaDaily XML_HF |
Navn på Datafordeleren.dk | DAR Totaludtræk Delta Daily Prædefineret XML |
Inputparametre | Inputparametrene følger defaultværdierne fra det brugerdefineret filudtræk, som dette filudtræk er opbygget efter. |
Format | XML |
Minimumsinterval for abonnement | Dagligt |
Lagringstid | 30 dage |
Forventes klar | 00:00:00 |
DAR Totaludtraek DeltaDaily JSON_HF
Tjenestenavn | DAR Totaludtræk_HF |
---|---|
Tjenestevisningsnavn | DAR Totaludtraek DeltaDaily JSON_HF |
Navn på Datafordeler.dk | DAR Totaludtræk Delta Daily Prædefineret JSON |
Inputparametre | Inputparametrene følger defaultværdierne fra det brugerdefineret filudtræk, som dette filudtræk er opbygget efter. |
Format | JSON |
Minimumsinterval for abonnement | Dagligt |
Lagringstid | 30 dage |
Forventes klar | 00:00:00 |
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. |
Navn | Type | Beskrivelse | Default Værdi | UUID fra Udstillingsmodel |
---|---|---|---|---|
VirkningFra | Streng | Tidspunktet hvorfra objekterne har virkning. Ønsker du et filudtræk, der indeholder alle objektversioner, men at eksludere historiske og afregistrerede objekter før en bestemt dato, kan du gøre dette ved at udfylde den ønskede dato i Virkningfra og RegistreringFra. Det er vigtigt at udfylde både virknings- og registreringsdatoerne ellers vil resultatet indeholde de objekter, som man med udfyldelsen af datoer, havde tænkt sig at eksludere. | NULL | EAID_AB768062_FD24_4960_8AA1_C6BFF90C00C5 |
VirkningTil | Streng | Tidspunktet hvortil objekterne har virkning. | NULL | EAID_3058C5FD_9824_48ba_B62C_C24587BF6537 |
RegistreringFra | Streng | Tidspunktet hvorfra objekterne er registreret i registeret. Ønsker du et filudtræk, der indeholder alle objektversioner, men ønsker at eksludere historiske og afregistrerede objekter før en bestemt dato, kan du gøre dette ved at udfylde den ønskede dato i Virkningfra og RegistreringFra. Det er vigtigt at udfylde både virknings- og registreringsdatoerne ellers vil resultatet indeholde de objekter, som man med udfyldelsen af datoer, havde tænkt sig at eksludere. | NULL | EAID_96862BAA_95CA_46aa_A6A0_757327A10BF7 |
RegistreringTil | Streng | Tidspunktet hvortil objekterne er registreret i registeret. | NULL | EAID_301BF58F_26E7_4d1f_B7B6_3881F8C1B0A5 |
DAFTimestampFra | Streng | Objekter registreret i Datafordeleren før dette tidspunkt medtages ikke i resultatet. | NULL | |
DAFTimestampTil | Streng | Objekter registreret i Datafordeleren efter dette tidspunkt medtages ikke i resultatet. | Now() | |
Status | List<String> | Objekternes status i den pågældende version, dvs. elementets tilstand i den samlede livscyklus. Ønsker du filudtrækket begrænset til objekter med en bestemt status, kan du markere dette i parameteren status. Vær opmærksom på, at hvis du vælger, at dit filudtræk kun skal indeholde en eller flere statusværdier, vil du ikke modtage eventuelle opdateringer for objekterne, hvis disse ændrer status. Læs mere om status på: | NULL |
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.
Info | ||
---|---|---|
| ||
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. |