Display Metadata | ||
---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Denne side beskriver adgangen til og den tekniske distribution af filudtræk, som er gældende for alle registre på Datafordeleren, der udstiller data med filudtræk.
Denne side tager sit udgangspunkt i ejendoms- og adresseområdet. Vi anbefaler, at du tilgår den registerspecifikke dokumentation om filudtræk, hvis du ønsker yderligere informationer om filudtræk fra Danmarks Højdemodel (DHM), GeoDanmark Ortofoto, GeoDanmark Vektor og Skærmkortet.
Table of Contents |
---|
Om filudtræk
Filudtræk giver
dig mulighed for at downloade data fra Datafordeleren. Det er den enkelte registermyndighed, der beslutter, hvilke data myndigheden stiller til rådighed som filudtræk.
For oplysninger om hvilke filudtræk og data, der er tilgængelige på Datafordeleren, brug Dataoversigten. Tjenesterne er beskrevet i dokumentationen for registrenes tjenester.
Se Vilkår for anvendelse for de enkelte registre på Datafordeler.dk
Beskrivelsen af filudtræk forudsætter et kendskab til brugeroprettelse og adgangstyring på Datafordeleren.
Generelt gælder det for filudtræk, at de fleste filudtræk kan tilgås af tjenestebrugere, som er oprettet med brugernavn/adgangskode.
Filudtræk
med følsomme data kan kun tilgås af tjenestebrugere, som er oprettet med SSH2-nøgle. Du kan på siden Brugeradgang - Oversigtfå et overblik over hvilke filudtræk, som kræver en SSH2-nøgle.
Få en guide til at downloade og opsætte abonnementer på filudtræk fra Dataoversigten i
Datafordeleren, eller i Selvbetjeningen i Guide til filudtræk på Selvbetjeningen
Table of Contents |
---|
Brug
af filudtræk
Der er overordnet to typer af filudtræk: Prædefineret og brugerdefineret udtræk.
Prædefineret
Der kan hentes data i på forhånd genererede filudtræk, som produceres og udstilles efter et givent interval fastsat af registermyndigheden fx ugentligt eller kvartalsvis. Filformater vil være et eller flere af de mulige formater (XML, JSON, CSV, GIS formater). For geodata vil der desuden være valgt projektion på forhånd.
For de tjenester der kan tilgås uden brugeroprettelse, er det ikke muligt at abonnere på prædefinerede filudtræk, i stedet kan man ”abonnere” på feeds ved hjælp af en browser eller feedreader. I Dataoversigten på Datafordelerens hjemmeside vises Atom feedet for det anonyme filudtræk, hvor det er muligt at se informationer om placeringen af filudtrækket. Det er ikke muligt at downloade denne type filudtræk direkte fra Selvbetjeningen.
Prædefinerede filudtræk der er frit tilgængelige uden brugeroprettelse kan hentes i en fælles FTP folder eller via HTTP.
Brugerdefineret udtræk
I et brugerdefineret udtræk er der mulighed for at angive en række parametre (eksempelvis geografisk udstrækning, format, projektion, registreringstid med mere). Udtrækslogikken og formater af data vil være specificeret på forhånd af registret.
For brugerdefinerede udtræk er det muligt at downloade enkelte udtræk ad hoc eller opsætte et fast abonnement på et filudtræk. Du modtager en e-mail, når Datafordeleren har genereret nye filer på dit abonnement eller når dit ad hoc udtræk er færdigt. E-mailen bliver sendt til din webbruger.
Brugerdefinerede filudtræk placeres på en FTP-server, og du kan hente dem via den FTP-klient, du har har valgt med brugernavn og password. Hvis data er følsomme skal du hente filerne med Secure FTP (SFTP) . I det tilfælde skal din tjenestebruger være tilknyttet en SSH2-nøgle.
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.
Metadatafil i FTP/SFTP
Der leveres altid en metadatafil med et filudtræk på FTP/SFTP serveren.
I tilfælde hvor der ikke er data i filudtrækket, leveres der stadig en udtræksfil samt en metadatafil.
Code Block | ||||
---|---|---|---|---|
| ||||
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "FiludtraekMetadata",
"description": "Metadatabeskrivelse for filudtræk",
"type": "object",
"properties": {
"leveranceNavn":{
"title":"leveranceNavn",
"type":"string"
},
"miljoe":{
"title":"miljoe",
"type":"string"
},
"fortroligData":{
"title":"fortroligdata",
"type":"string",
"enum":["Ja","Nej"]
},
"dataOmfattetAfPersondataloven":{
"title":"dataOmfattetAfPersondataloven",
"type":"string",
"enum":["Ja","Nej"]
},
"MD5CheckSum":{
"title":"MD5CheckSum",
"type":"string"
},
"DatafordelerUdtraekstidspunkt": {
"type": "array",
"items": {
"type": "object",
"required": [
"deltaVindueStart",
"DeltavindueSlut"
],
"properties": {
"deltaVindueStart": {
"title": "deltaVindueStart",
"description": "UTC timestamp",
"type": "string",
"format": "date-time"
},
"DeltavindueSlut": {
"title": "DeltavindueSlut",
"description": "UTC timestamp",
"type": "string",
"format": "date-time"
}
}
}
},
"tilgaengelighedsperiode":{
"title":"tilgaengelighedsperiode",
"type":"integer"
},
"AbonnementsOplysninger": {
"type": "array",
"items": {
"type": "object",
"required": [
"webBrugernavn",
"tjenesteBrugernavn",
"abonnementnavn",
"tjenestenavn",
"tjenesteversion",
"oprettelsesdato",
"senesteAbonnementRedigeringsdato",
"gentagelsesinterval"
],
"properties": {
"webBrugernavn": {
"title": "webBrugernavn",
"type": "string"
},
"tjenesteBrugernavn": {
"title": "tjenesteBrugernavn",
"type": "string"
},
"abonnementnavn": {
"title": "abonnementnavn",
"type": "string"
},
"tjenestenavn": {
"title": "tjenestenavn",
"type": "string"
},
"tjenesteversion": {
"title": "tjenesteversion",
"type": "string"
},
"oprettelsesdato": {
"title": "oprettelsesdato",
"type": "string",
"pattern": "(0[1-9]|[12]\\d|3[01])-(0[1-9]|1[0-2])-(\\d{3})"
},
"senesteAbonnementRedigeringdsato": {
"title": "senesteAbonnementRedigeringsdato",
"type": "string",
"pattern": "(0[1-9]|[12]\\d|3[01])-(0[1-9]|1[0-2])-(\\d{4})"
},
"gentagelsesinterval": {
"title": "gentagelsesinterval",
"type": "string",
"enum":["Adhoc","Dagligt","Ugentligt","Månedligt","Årligt"]
}
}
}
},
"BrugerUdfyldteParametre": {
"type": "array",
"items": {
"type": "object",
"properties": {
"parameternavn":{
"title":"parameternavn",
"type":"string"
},
"parametervaerdi":{
"title":"parametervaerdi",
"type":"string"
},
"parametertype":{
"title":"parametertype",
"type":"string",
"enum":["string","date-time","integer","number","object","array","null"]
}
}
}
}
}
} |
Åbn skema for metadatafilen i en browser
Fordele ved brug af filudtræk
Anvendere af Datafordelerens tjenester kan have forskellige typer af behov for at benytte filudtrækstjenester:
- Nogle anvendere er kun interesserede i virkningstider. De behov imødekommes med aktuelle data – dvs. data, der aktuelt ikke er afregistrerede, og hvis virkningsperiode omfatter den virkningstid, som er angivet i udtræksparametrene.
- Nogle anvendere har behov for også at kunne angive registreringstid – altså at kunne tage på en tidsrejse tilbage i tid og se hvordan data så ud på et specifikt tidspunkt. Det kunne fx være tilfældet hvis en borger klager over en afgørelse, og man ønsker at se hvordan data så ud, da afgørelsen blev truffet.
- Nogle anvendere ønsker at etablere et kopiregister i umiddelbar, netværksmæssig nærhed af de applikationer, der har behov for at foretage opslag i kopiregistrene, og her er filudtræk en fordel.
Anvenderes begrundelse for at etablere kopiregistre kan være svartid (performance) og robusthed (Recilience) over for nedbrud i Datafordeleren eller i forbindelsen hertil. Anvendere som vedligeholder et kopiregister, har brug for at kende information om data, der har ændret sig siden sidste gang de foretog et udtræk til dette kopiregister. Dette inkluderer behov for historik - dvs. summen af alle mulige og virkelighedstro øjebliksbilleder.
Du kan læse mere om kopiregistre i Datafordeleren - guide til kopiregistre.
Info |
---|
Bemærk Risiko for manglende data ved brug af filudtræk I enkelte tilfælde kan du opleve at filudtræk ”mangler” data. Dette kan forekomme, hvis filudtræk fx igangsættes på et tidspunkt, hvor der sker dataopdateringer på Datafordeleren. Risikoen for, at dataopdateringer ikke kommer med i et filudtræk, er størst ved totale filudtræk og for de registre, der har mange enkeltopdateringer i det meste af døgnet. Se mere om frekvensen for registrenes dataopdateringer. Data opdateres løbende på Datafordeleren i takt med, at registrene fremsender data. Opdateringen har et forløb: registret fremsender en ’slettemarkering’, som afregistrerer rækker for et objekt. Dernæst fremsender registret en update- og insert-række. Normalt følger sletning og opdatering af et objekt umiddelbart hinanden, men ved ekstraordinært mange dataopdateringer kan det ske, at den tidsmæssige afstand vokser. Når dannelsen af et filudtræk igangsættes, ”låses” Datafordeleren tidsmæssigt, således at filudtrækket afspejler status på igangsættelsestidspunktet. Derved sikres konsistens i udtrækkets data. Derfor kan det ske at du kan opleve manglende data, på grund af at dannelsen af filudtræk påbegyndes netop i brøkdelen af sekundet mellem objektets sletning og den efterfølgende opdatering. For så vidt muligt at minimere risikoen for manglende data i dit filudtræk anbefales det at bruge prædefineret filudtræk, samt det anbefales så vidt muligt at planlægge dine filudtræk på tidspunkter uden for normal arbejdstid, fx efter kl. 20. Du kan ligeledes orientere dig under Driftsmeddelelser på Datafordeler.dk, om der skulle være varslet ekstraordinært mange dataopdateringer på det tidspunkt du ønsker at igangsætte dit 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 | 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 | NOW() | NULL - NOW() | Ikke muligt | Ikke muligt | Ikke muligt | 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 Totaludtræk Flad | VUR | Ikke muligt | Ikke muligt | Ikke muligt | 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 |
MAT2 Totaludtræk | MAT2 | NULL - NULL | NOW() | NULL - NULL | NOW() | NULL - NOW() | Ikke muligt | Ikke muligt | Ikke muligt | Ikke muligt |
MAT2 Totaludtræk Hist | MAT2 | 0001-01-01 - 9999-12-31 | NULL | NULL - NULL | NOW() | NULL - NOW() | Ikke muligt | Ikke muligt | Ikke muligt |
Skedulering af filudtræk
Der er mulighed for at bestemme, hvornår et filudtræk ønskes eksekveret, ved at angive dag og klokkeslæt for fremstillingen. Skeduleringen angives ved oprettelse af ad hoc udtræk eller abonnement.