Anchor | Toppen | Toppen |
---|---|---|
Display Metadata | ||
|
Anchor | ||||
---|---|---|---|---|
|
Table of Contents |
---|
Særligt for udtrækkene af typen Complete og DeltaDaily
For en række udvalgte tjenester har Datafordeleren lavet en række prædefinerede tjenester, hvor et ugentlig totaludtræk kan kombineres med daglige ændringer. Udtræk leveres i ét standardudtræk, som er tilgængeligt på samme tidspunkt, som det er muligt at abonnere på.
Der er tale om tjenester på ejendoms- og adresseområdet, som har særlig høj anvendelse. Det er samtidig nogle tjenester, hvor det forventes at mange brugere vil have samme anvendelsesmønster.
Følgende registre er omfattet:
- Bygnings- og Boligregistret (BBR)
- Danmarks Adresseregister (DAR)
- Ejendomsbeliggenhedsregistret (EBR)
- Ejendomsvurdering (VUR)
- Ejerfortegnelsen (EJF)
- Matriklen (MAT)
Der er derfor oprettet to typer prædefinerede filudtræk: Complete og DeltaDaily. Ved Complete får du ugentligt et fuldt totaludtræk af registeret, og ved DeltaDaily modtager du daglige opdateringer.
Indholdet i opdateringerne afhænger af hvilket filudtræk du vælger. Bemærk, at de filudtræk, som indeholder aktuelle filudtræk for eksempel kun leverer gældende data og det gælder også for de tilknyttede deltaudtræk og at du skal indlæse et fuldt deltaudtræk som en samlet opdatering for at bevare dataintegritet. Læs mere om Deltaudtræk og dataintegritet.
Hvad indeholder leverancen i 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. Er det prædefineret filudtræk ikke tidligere blevet dannet, vil du modtage det, når det er blevet dannet af systemet.
Vælger du fx at tegne et abonnement på et ugentlig filudtræk om onsdagen, vil du modtage det senest dannede filudtræk. Filudtræk dannes om søndagen og vil senest blive leveret mandag tidlig morgen.
Du kan læse under den registerspecifikke dokumentation, hvad opdateringstiden er for den enkelte tjeneste.
Opbygge kopi
Prædefinerede filudtræk er en fordel for fx de brugere, der skal opbygge en kopi. I det tilfælde er der behov for et etableringsudtræk i form af et totaludtræk efterfulgt af daglige opdateringer. Der dannes én gang ugentligt et totaludtræk. Sideløbende vil der dagligt dannes deltaudtræk, hvilket også omfatter de dage der generes totaludtræk.
Skal du opbygge en kopi, skal du både oprette et abonnement på de tjenester, der hedder Complete, samt de tjenester der hedder DeltaDaily. For at opbygge en kopi skal du oprette abonnement på delta først. Dernæst skal du oprette abonnement på complete, som er tilgængelig hver mandag. For at få en fuld kopi skal du kombinere data i deltafilen fra søndag med totaludtrækket og deltafilen for mandag.
Hvis du kun ønsker at modtage et totaludtræk én gang, skal du slette abonnementet efter du har modtaget den første fil.
Når du skal behandle data, skal du sortere på registreringstid frem for datafordeler timestamp (DAFTimestamp).
Ønsker du at benytte deltaudtræk til at modtage ændringer skal du som minimum undersøge om filudtrækket indeholder fuld historik (både virknings- og registreringstid), da de aktuelle filudtræk kun leverer gældende data og det gælder også for deltaudtræk. Ændringer, som træder i kraft i fremtiden, vil ikke blive inkluderet i udtrækket på et senere tidspunkt, da deltaudtræk kun vil inkludere ændringer, der er modtaget siden sidst. Det er vigtigt, at du benytter et filudtræk med fuld historik, hvis du ønsker at modtage alle ændringer via deltaudtræk og det er en forudsætning, at registret bevarer fuld dobbelthistorik, når der sendes opdateringer til Datafordeleren.
Vi anbefaler, at du derfor undersøger hvorledes det enkelte register har implementeret bitemporalitet på Datafordeleren. Du kan med fordel starte med Datafordeleren - introduktion til bitemporalitet og læse mere i Datafordeleren - guide til kopiregistre
Navngivning af prædefinerede filudtræk
Normalt er filen, som bliver genereret, baseret på abonnementsnavnet. Det er ikke tilfældet for prædefinerede filudtræk. For prædefinerede filudtræk er filnavnet givet af systemet og ikke baseret på abonnementsnavnet, som andre typer af filudtræk.
Abonnementsnavn DARDailyJSON-v01, som er et prædefineret udtræk af en fil DAR_Totaludtraek_DeltaDaily_JSON, vil resulterer i en fil, som hedder DAR_Totaludtraek_DeltaDaily_JSON_20191024210021.zip
I det første prædefinerede udtræk refererer tidspunktet i filnavnet til det tidspunkt, hvor dit abonnement er blevet oprettet. I de efterfølgende leverancer vil tidspunktet i navngivningen referere til det tidspunkt, hvor udtrækket er blevet dannet.
Since Previous og de prædefinerede filudtræk
Since Previous er altid sat for prædefinerede daglige filudtræk. Det har derfor ingen betydning for udtrækket, at man fjerner fluebenet i sit abonnement.
Indholdet i leverance er fra det senest dannede filudtræk. Det vil sige, at indholdet i deltafilen altid vil indeholde alle opdateringer siden sidste deltaopdatering blev dannet.Bemærk, at du ikke modtager automatisk vil modtage alle ændringer blot ved at benytte SincePrevious på et givent filudtræk. De prædefinerede filudtræk er defineret på baggrund af en række parametre og falder en ændring uden for en af disse parametre vil ændringen ikke komme med i deltaudtrækket.
Bemærk, at du ikke modtager automatisk vil modtage alle ændringer blot ved at benytte SincePrevious på et givent filudtræk. De prædefinerede filudtræk er defineret på baggrund af en række parametre og falder en ændring uden for en af disse parametre vil ændringen ikke komme med i deltaudtrækket.
Brug af filudtræk
Filudtræk | Register | INTERVAL VirkningstidFra - VirkningstidTil | TIDSPUNKT Virkningstid | INTERVAL RegistreringstidFra - RegistreringstidTil | TIDSPUNKT Registreringstid | INTERVAL DAFTimeStampFra - DAFTimeStampTil | INTERVAL AjourføringDatoFra - AjourføingDatoTil | INTERVAL ÆndringDatoFra - ÆndringDatoTil | INTERVAL PeriodeaendringFra -PeriodeaendringTil | TIDSPUNKT KunNyesteIPeriode |
---|---|---|---|---|---|---|---|---|---|---|
BBR Totaludtræk | BBR | NULL - NULL | Ikke muligt | NULL - NULL | Ikke muligt |
INTERVAL VirkningstidFra - VirkningstidTil | TIDSPUNKT Virkningstid | INTERVAL RegistreringstidFra - RegistreringstidTil | TIDSPUNKT Registreringstid | INTERVAL DAFTimeStampFra - DAFTimeStampTil | INTERVAL AjourføringDatoFra - AjourføingDatoTil | INTERVAL ÆndringDatoFra - ÆndringDatoTil | INTERVAL PeriodeaendringFra -PeriodeaendringTil | TIDSPUNKT KunNyesteIPeriode | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
BBR Totaludtræk | BBR | NULL - NULL | Ikke muligt | NULL - NULL | Ikke muligt | NULL - NOW() | Ikke muligt | Ikke muligt | NULL - NULL | FALSE | ||||||||
BBR Aktuelt Totaludtræk | BBR | NOW() - NOW() | Ikke muligt | NOW() - NOW() | Ikke muligt | NULL - NOW() | Ikke muligt | Ikke muligt | NULL - NULL | FALSE | ||||||||
DAR | NULL - NULL | Ikke muligt | NULL - NULL | Ikke muligt | NULL - NOW() | Ikke muligt | Ikke muligt | Ikke muligt | Ikke muligt | |||||||||
DAR Aktuelt Totaludtræk | DAR | NOW() - NOW() | Ikke muligt | NOW() - NOW() | Ikke muligt | NULL - NOW() | Ikke muligt | Ikke muligt | Ikke muligt | Ikke muligt | ||||||||
EBR | Ikke muligt | NOW() | Ikke muligt | NOW() | NULL - NOW() | Ikke muligt | Ikke muligt | Ikke muligt | Ikke muligt | |||||||||
Ejendomsbeliggenhed Simpel | EBR | NULL | NOW() | NULL - NULL | NOW()NULL - NOW() | Ikke muligt | Ikke muligt | Ikke muligt | Ikke muligt | Ejendomsbeliggenhed Simpel Hist | EBR | 0001-01-01 - 9999-12-31 | NULL | NULL - NULL | NULL - NULL | FALSE | ||
BBR Aktuelt Totaludtræk | BBR | NOW() - NOW() | Ikke muligt | NOW() - NOW() | Ikke muligt | NOW()NULL - NOW() | Ikke muligt | Ikke muligt | NULL - NULL | FALSE | ||||||||
DAR | NULL - NULL | Ikke muligt | Ikke muligt | Ejendomsvurdering Filudtræk | VUR | Ikke muligtIkke muligtIkke muligt | NULL - NULL | Ikke muligt | NULL - NOW() | NULL - NULL | NULL - NULLIkke muligt | Ikke muligt | Ikke muligt | Ikke muligt | Ejendomsvurdering Totaludtraek Flad | VUR | ||
DAR Aktuelt Totaludtræk | DAR | NOW() - NOW() | Ikke muligtIkke muligt | Ikke muligtNOW() - NOW() | Ikke muligt | NULL - NOW() | 0001-01-01 - Now() | 0001-01-01 - 9999-12-31Ikke muligt | Ikke muligt | Ikke muligt | Ikke muligt | |||||||
Ejerfortegnelsen Totaludtræk Flad | EJF | 0001-01-01 - 9999-12-31 | NULL | 0001-01-01 - NOW() | EBR | Ikke muligt | NOW() | Ikke muligt | NOW()NULL | NULL - NOW() | Ikke muligt | Ikke muligt | Ikke muligt | Ikke muligt | Ejerfortegnelsen Fortrolig Totaludtræk Flad | EJF | 0001-01-01 - 9999-12-31 | NULL |
Ejendomsbeliggenhed Simpel | EBR | NULL | NOW0001-01-01 - NOW() | NULL - NULL | NOW() | NULL - NOW() | Ikke muligt | Ikke muligt | Ikke muligt | Ikke muligt | MAT Totaludtræk | MAT | NULL - NULL | NOW() | ||||
Ejendomsbeliggenhed Simpel Hist | EBR | 0001-01-01 - 9999-12-31 | NULL | NULL - NULL | NOW() | NULL - NOW() | Ikke muligt | Ikke muligt | Ikke muligt | Ikke muligt | MAT Totaludtræk Hist | MAT | 0001-01-01 - 9999-12-31 | NULL | NULL - NULL | NOW() | NULL - NOW() | Ikke muligt |
Ejendomsvurdering Filudtræk | VUR | Ikke muligt | Ikke muligt | Ikke muligt | Ikke muligt | NULL - NOW() | NULL - NULL | NULL - NULL | Ikke muligt | Ikke muligt | ||||||||
Ejendomsvurdering Totaludtraek Flad | VUR | Ikke muligt | Ikke muligt | Ikke muligt |
Deltafiler
For nogle tjenester er det muligt at abonnere på deltafiler ved brug af funktionen "Since Previous". Her vil der kun returneres data, som har en Datafordeler-registreringstid lig med eller senere end det tidspunkt, hvor det samme filudtræk senest er genereret til den pågældende abonnent. Det vil sige, at der i abonnementet fremsøges data, som er opdateret på Datafordeleren siden den foregående generering af det tilsvarende filudtræk på samme abonnement. Der vil altid blive dannet en fil, også selvom der ikke har været opdateringer i registeret i perioden, i så fald vil filen være tom.
Tidsstemplet for seneste udtræk, vises som metadata for abonnementet i Selvbetjeningen. Deltafiler vælges ved en checkboks med "Since Previous" i Selvbetjeningen.
Bemærk, at du skal indlæse et fuldt deltaudtræk som en samlet opdatering for at bevare dataintegritet. Læs mere om Deltaudtræk og dataintegritet.
Skedulering af filudtræk
Der er mulighed for at bestemme, hvornår et filudtræk ønskes eksekveret, ved at angive dag og klokkeslet for fremstillingen. Skeduleringen angives ved oprettelse af ad hoc udtræk eller abonnement.
Ikke muligt | NULL - NOW() | 0001-01-01 - Now() | 0001-01-01 - 9999-12-31 | Ikke muligt | Ikke muligt | |||||
Ejerfortegnelsen Totaludtræk Flad | EJF | 0001-01-01 - 9999-12-31 | NULL | 0001-01-01 - NOW() | NULL | NULL - NOW() | Ikke muligt | Ikke muligt | Ikke muligt | Ikke muligt |
Ejerfortegnelsen Fortrolig Totaludtræk Flad | EJF | 0001-01-01 - 9999-12-31 | NULL | 0001-01-01 - NOW() | NULL | NULL - NOW() | Ikke muligt | Ikke muligt | Ikke muligt | Ikke muligt |
MAT Totaludtræk | MAT | NULL - NULL | NOW() | NULL - NULL | NOW() | NULL - NOW() | Ikke muligt | Ikke muligt | Ikke muligt | Ikke muligt |
MAT Totaludtræk Hist | MAT | 0001-01-01 - 9999-12-31 | NULL | NULL - NULL | NOW() | NULL - NOW() | Ikke muligt | Ikke muligt | Ikke muligt | Ikke muligt |
Endpoint, folder og filplacering
Nedenstående tabel angiver foldernavn/placering og http(s) url for de forskellige filudtrækstyper:
Placering af abonnements-baserede filudtræk for kendte adgang og godkendt adgang i zone 0
Connectivity til FTP folderen kan først opnås når tjenestebrugeren har oprettet et abonnement på et filudtræk, da folderen først oprettes i det øjeblik der genereres et filudtræk.
Læs mere om hvordan du henter dit filudtræk via din FTP-client i afsnittet Hent filudtræk på siden Guide til Filudtræk på Datafordeleren.Folderstruktur
På FTP-klient bliver dine filudtræk fra Datafordeleren, som udgangspunkt, udstillet i en zip-fil.
På GeoDanmark Ortofoto er implementeret en funktionalitet, som udstiller indholdet af dit filudtræk i en række mindre zip-filer. Filudtrækket er udstillet i en mappe, som indeholder zip-filer for hver tile. På den måde er det muligt kun at hente de dele af filudtrækket, som du er interesseret i at benytte. Læs mere om filudtræk fra GeoDanmark Ortofoto på siden Filudtræk (GeoDanmark Ortofoto).