Oprindelig kilde Datafordeleren
Forfatter Datafordeleren
Dato for oprettelse Feb 03, 2023
Version 1.0
Dato for seneste ændring - se beskrivelse i historik May 09, 2023


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. For eksempel: ’DAR Totaludtraek Complete XML_HF’.

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.

Datoen for udfasning er udskudt fra 15. maj 2023, da der afventes retning af fejl vedrørende brugerdefinerede filudtræk med SSH2-nøgle/SFTP. Når fejlene er rettet bliver der meldt en endelig dato ud for udfasning af filudtrækstjenesterne på datafordeler.dk/Drift


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 – eks. på anvendelse af bitemporalitet.

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




Generelt for DAR filudtræk 

Registernavn i SelvbetjeningenDAR
FormaterXML, JSON 
DLS version2.3.7
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).

Til toppen



DAR Totaludtræk

Til toppen



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.

Til toppen







DAR Totaludtraek Complete XML

TjenestenavnDAR Totaludtræk
TjenestevisningsnavnDAR Totaludtraek Complete XML
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.

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





DAR Totaludtraek Complete JSON

TjenestenavnDAR Totaludtræk
TjenestevisningsnavnDAR Totaludtraek Complete JSON
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.

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





DAR Totaludtraek DeltaDaily XML

TjenestenavnDAR Totaludtræk
TjenestevisningsnavnDAR Totaludtraek DeltaDaily XML
Navn på Datafordeler.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.

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





DAR Totaludtraek DeltaDaily JSON

TjenestenavnDAR Totaludtræk
TjenestevisningsnavnDAR Totaludtraek DeltaDaily JSON
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.

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


Ønsker du et filudtræk, der indeholder alle objektversioner uden historiske og afregistrerede objekter fra før en bestemt dato, skal du udfylde den ønskede dato i Virkningfra og RegistreringFra.

Udfylder du Virkningfra og RegistreringFra med Now og modtager du et aktuelt filudtræk, som den første fil.





Brugerdefineret filudtræk

Tjenestenavn

DAR-Totaludtraek

Tjenestevisningsnavn

DAR Totaludtræk

Navn på Datafordeler.dk

DAR Totaludtræk Brugerdefineret

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.

Til toppen






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

NULLEAID_AB768062_FD24_4960_8AA1_C6BFF90C00C5

VirkningTil

Streng 

Tidspunktet hvortil objekterne har virkning. 

NULLEAID_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.

NULLEAID_96862BAA_95CA_46aa_A6A0_757327A10BF7

RegistreringTil

Streng 

Tidspunktet hvortil objekterne er registreret i registeret. 

NULLEAID_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å: 
https://danmarksadresser.dk/adressedata/kodelister/livscyklus/”             

NULL




Ønsker du et filudtræk, der indeholder alle objektversioner uden historiske og afregistrerede objekter fra før en bestemt dato, skal du udfylde den ønskede dato i Virkningfra og RegistreringFra.

Udfylder du Virkningfra og RegistreringFra med Now modtager du et aktuelt filudtræk, som den første fil.








Outputparametre

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








Eksempel

Alle objekter, som var gældende mellem 01-01-2020 og 31-12-2020.






DAR Aktuelt Totaludtræk

Til toppen



Beskrivelse

Totaludtræk for DAR er specificeret ud fra 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.



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 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








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







Inputparametre

Navn

Type

Beskrivelse

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




Outputparametre

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