- Created by Cæcilie Elle, last modified by Maria Klostermann Tapdrup on Jul 08, 2019
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 2 Next »
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.
Filudtræk giver brugeren 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 adgangsbegrænsede data kan kun tilgås af tjenestebrugere, som er oprettet med SSH2-nøgle. - Få en guide til at downloade og opsætte abonnementer på filudtræk i Selvbetjeningen i Guide til filudtræk på Selvbetjeningen (tabulær) eller Guide til filudtræk på Selvbetjeningen (geodata)
Typer 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:
| Filudtrækstype | Placering eller url |
|---|---|
| Placering af frit tilgængelige filudtræk i zone 0 | \\<FTP endpoint>\DD1FTPUpdateAreaS0\public |
| Url for frit tilgængelige filudtræk der hentes med http i zone 0 | http(s)://services.datafordeler.dk/system/file/1/public?filename=<filnavn> |
Placering af abonnements-baserede filudtræk for kendte adgang og godkendt adgang i zone 0 | \\<FTP endpoint>\DD1FTPUpdateAreaS0\<bruger> |
| Placering af abonnements-baserede filudtræk for kendt adgang og godkendt adgang i zone 5 | \\<FTP endpoint>\DD1FTPUpdateAreaS5\<bruger> |
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.
Tidsparametre i filudtræk
Der er mulighed for at bruge forskellige tidsparametre med særlig relevans for filudtræk.
Datafordeler timestamp
For nogle tjenester er det muligt at angive DAFTimestampFra og DAFTimestampTil.
Datafordeler timestamp er et tidsparameter for, hvornår data er indlæst eller opdateret på Datafordeleren modsat fx. RegistreringTil der er et tidsparameter for hvornår data er registreret i et register.
Parametrene er klokkeslæt ud fra formen ”hh:mm:{ss}.{ssssss}Z|+hh:mm”, hvor sekunder og millisekunder kan udelades.
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.
Værdien af tidsstempel for seneste udtræk, vises som metadata for abonnementet i Selvbetjeningen.
Deltafiler vælges ved en checkboks med "Since Previous" i Selvbetjeningen.
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.
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.
Struktur for metadatafil Expand source
{
"$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"]
}
}
}
}
}
}
- No labels