Guide til filudtræk på Datafordeleren

Oprettelsen af et abonnement kræver en webbruger og tjenestebruger. På grund af sikkerhedshensyn kræver nogle filudtræk, at registeret giver adgang til, at en tjenestebruger kan abonnere på dem.

Brug Dataoversigten til at undersøge, hvilken brugeradgang det ønskede filudtræk kræver og læs mere om Brugeroprettelse og Brugeradgang på Datafordeler.dk.

Log på Datafordeleren med den ønskede webbruger og anmod eventuelt om adgang til de begrænsede tjenester via tjenestebrugeren, som du finder under det menupunktet Dine tjenestebrugere på din konto.

TJENESTEOVERSIGT

Tjenestenavn
Navn for tjenesten
Tjeneste
Hvilken tjenestetype der er tale om (filudtræk, webservice eller hændelse)
Service
Her vises hvilken service der er tale om, fx abonnement eller REST
Adgang
Hvilken adgang der er krævet til tjenesten
Filformat
Hvilket filformat tjenesten er i
Beskrivelse
Information om tjenesten

Du kan se mere om tjenesten, ved at klikke på pilen til højre for tjenestenavnet.

De frit tilgængelige filudtræk kan kun findes via Selvbetjeningen.

Se hvordan du henter de frit tilgængelige filudtræk her.

Hent et enkelt filudtræk (Download)

Det er muligt at downloade et filudtræk som ét enkelt udtræk, eller som et abonnement, hvori der angives et tidsinterval mellem de automatiske genereringer af nye udtræk.

Det er – med undtagelse af tidsintervallet – de samme basisdata og brugerparametre, der skal angives til enkeltfilsudtræk og til brugerdefineret abonnementsudtræk.

Når opsætningen er gemt, vil filudtrækket blive bestilt, og du modtager en email, når det er færdigt.

Til toppen

Søg den tjeneste du vil downloade et enkelt filudtræk fra. Det er ikke alle tjenester på Dataoversigten, hvor du kan downloade et enkelt filudtræk, men kun dem hvor der er en Download-knap ved siden af Opret abonnement, eller de prægenererede filudtræk.

Klik på Download.
Herefter skal du angive et navn for dit filudtræk til download, og hvilken tjenestebruger du ønsker at benytte.

FELTER I OPSÆTNINGEN

Navn på download
Her skal du skrive et navn for dit filudtræk.
Din tjenestebruger kan kun bruge det samme visningsnavn. Det er dog muligt at bruge et navn efterfulgt af et skiftende tal.

Filnavnet må ikke indeholde: ø, æ og å samt mellemrum i visningsnavnet
Hvis du alligevel anvender disse tegn, vil Datafordeleren automatisk ændre navnet således:
æ i navnet på filudtrækket vil blive ændret til ae
ø i navnet på filudtrækket vil blive ændret til oe
å i navnet på filudtrækket vil blive ændret til aa
mellemrum i navnet på filudtrækket blive ændret til ”_”

Tjenestebruger
Her vælger du den tjenestebruger, som du ønsker at hente dit filudtræk med.
Tjek efter om din tjenestebruger stemmer overens med de krav tjenesten stiller.

Klik på Fortsæt.

Herefter skal du tilføje inputparametre og vælge outputformat.

I den registerspecifikke dokumentation kan du for hver enkelt tjeneste se, hvordan inputparametre kan udfyldes.

Tabellerne i dokumentationen er udfyldt ud fra de specifikationer, der danner grundlag for konfigurationen af tjenesten.

Find den registerspecifikke dokumentation via Dataoversigten på Datafordeler.dk.

Skemaerne for inputparametre afhænger af det specifikke filudtræk, og nedenstående er blot et eksempel på et muligt skema.

Udfyld de relevante felter alt efter hvad du vil filtrere efter.

Vent på en email om at dit filudtræk er tilgængeligt.

Du henter dit filudtræk ved at benytte den fremgangsmåde, som beskrevet nedenfor under Hent filudtræk.

Udfyld oplysninger

Herefter skal du angive et navn for dit filudtræk, og hvilken tjenestebruger du ønsker at benytte.

FELTER I OPSÆTNINGEN

Navn på abonnement
Her skal du skrive et visningsnavn for dit filudtræk.
Din tjenestebruger kan ikke bruge samme visningsnavn mere end en gang. Det er dog muligt at bruge et navn efterfulgt af et skiftende tal.
Filenavnet må ikke indeholde: ø, æ og å samt mellemrum i visningsnavnet
Hvis du alligevel anvender disse tegn, vil Datafordeleren automatisk ændre navnet således:
æ i navnet på filudtrækket vil blive ændret til ae
ø i navnet på filudtrækket vil blive ændret til oe
å i navnet på filudtrækket vil blive ændret til aa
mellemrum i navnet på filudtrækket blive ændret til ”_”
Tjenestebruger
Her vælger du den tjenestebruger, som du ønsker at tegne abonnementet med.
Tjek efter om din tjenestebruger stemmer overens med de krav tjenesten stiller.

Tjek parametre og bekræft

Når du valgt et navn på dit filudtræk og tjenestebruger, skal du klikke på Fortsæt, herefter får du vist de parametre som udtrækket er sat op med. Disse kan ikke ændres ved et prædefineret filudtræk.

Klik på Opret nederste.

En besked om at dit abonnement er oprettet vil komme frem.

Vent på en email om at dit filudtræk er tilgængeligt.

Du henter dit filudtræk ved at benytte den fremgangsmåde, som beskrevet nedenfor under Hent filudtræk.

Abonnement på brugerdefineret filudtræk

Et brugerdefineret filudtræk, er udtræk, der genereres med et brugerdefineret indhold og interval.

Vælg tjeneste

Når du har fundet det brugerdefineret filudtræk, som du ønsker at oprette abonnement på, skal du klikke på Opret abonnement.

FELTER I OPSÆTNINGEN

Tjenestebruger
Her vælger du den tjenestebruger, som du ønsker at tegne abonnementet med.
Tjek efter om din tjenestebruger stemmer overens med de krav tjenesten stiller.
Navn på abonnement
Her skal du skrive et visningsnavn for dit filudtræk.
Din tjenestebruger kan ikke bruge samme visningsnavn mere end en gang. Det er dog muligt at bruge et navn efterfulgt af et skiftende tal. Det kan være være en fordel at angive register, interval eller lignende i navnet, så det er nemmere at identificere dit filudtræk på din oversigt, hvis du har mange abonnementet.
Filnavnet må ikke indeholde: ø, æ og å samt mellemrum i visningsnavnet
Hvis du alligevel anvender disse tegn, vil Datafordeleren automatisk ændre navnet således:
æ i navnet på filudtrækket vil blive ændret til ae
ø i navnet på filudtrækket vil blive ændret til oe
å i navnet på filudtrækket vil blive ændret til aa
mellemrum i navnet på filudtrækket blive ændret til ”_”

Vælg interval for kørsel af abonnement

Herefter skal du angive et interval for kørslen af dit brugerdefinerede filudtræk.

FELTER OG INTERVALLER I LEVERING

Daglig
Her vælger du det tidspunkt på dagen, som du ønsker at dit filudtræk skal køre. Sætter du tidspunktet efter det tidspunkt du opretter abonnementet, vil filudtrækket køres første gang samme dag du har oprettet abonnementet.
Ugentligt
Her vælger du den ugedag, samt tidspunkt på den givne dag for kørslen af filudtrækket.
Månedligt
Her vælger du den dato i måneden filudtrækket skal køres på, og tidspunkt på dagen.
Du kan vælge mellem dag 1-28 i måneden. Du kan også vælge at det skal køres den sidste dag i måneden.
Sætter du datoen til tidligere i måneden end den dag du opretter abonnementet på, får du udtrækket første gang næste måned.
Kvartalsvist
Her vælger du den dato i måneden det skal modtages på, og tidspunkt på dagen.
Vælger du en dato før den dag du opretter abonnementet på, vil første kørsel ske den følgende måned, og herefter hver tredje måned.
Vælger du en dato efter den dag du opretter abonnementet på, vil du modtage første udtræk samme måned på den angivne dato, og herefter hver tredje måned.
Årligt
Her vælger du den dato i måneden det skal modtages på, og tidspunkt på dagen.
Vælger du en dato før den dag du opretter abonnementet på, vil første kørsel ske den følgende måned, og herefter hver årligt.
Vælger du en dato efter den dag du opretter abonnementet på, vil første kørsel ske samme måned på den angivne dato, og herefter årligt.
N-månedligt
Her vælger du det tidspunkt på dagen, som du ønsker at modtage dit filudtræk, samt den dato filudtrækket skal det skal modtages på. Du kan også vælge at det skal modtages den sidste dag i måneden.
Derudover skal du vælge med hvilket månedligt interval filudtrækket skal køre.

Når du har valgt intervallet for kørslen af dit brugerdefinerede filudtræk, så klik på NÆSTE

Vælg inputparametre

Herefter skal du tilføje/ændre inputparametre til abonnementet.

Skemaerne for inputparametre afhænger af det specifikke filudtræk. I de registerspecifikke dokumentation kan du for hver enkelt tjeneste se, hvordan inputparametre kan udfyldes. Tabellerne i dokumentationen er udfyldt ud fra de specifikationer, der danner grundlag for konfigurationen af tjenesten.

Find den registerspecifikke dokumentation via Dataoversigten på Datafordeler.dk.

Eksempel på inputparametre for GeoDanmark Brugerdefineret - se mere på Filudtræk (GeoDanmark Vektor)

Udfyld og klik på Næste

Herefter kan du gennemse de indtastede oplysninger, inden du bekræfter oprettelsen.

FELTER I GENNEMSE OPLYSNINGER

Oprettet med tjenestebruger
Her fremgår navnet på den tjenestebruger, der er valgt til filudtrækket.
Navn på abonnement
Her fremgår det navn du har angivet til dit brugerdefinerede filudtræk.
Startdato
Her fremgår datoen for hvornår dit første filudtræk kører.
Tidspunkt
Her fremgår tidspunktet på dagen for hvornår dit filudtræk kører.
Tidsinterval
Her fremgår hvilket interval du har valgt.
Vær opmærksom på at hvis du har valgt N-månedligt i interval kan du ikke se det månedligt interval du har valgt i oplysningerne. Dette kan kun ses ved at redigere abonnementet efterfølgende i Selvbetjeningen.
Parametre
Her fremgår de parametre du har angivet.

Du henter dit filudtræk ved at benytte den fremgangsmåde, som beskrevet nedenfor under Hent filudtræk.

Rediger eller slet et abonnement på filudtræk

På din kontoside kan du se en oversigt over dine filudtræk. Her kan du slette et filudtræk.

Ønsker du at redigere et filudtræk, skal du logge ind via Selvbetjeningen. Læs mere om hvordan du redigerer et abonnement på filudtræk her.

Du skal bruge adressen på FTP-serveren, som er angivet i mailen, du har modtaget.

Værtsnavn for FTP server i zone 0, som ikke indeholder fortrolige eller følsomme data, er ftp://ftp3.datafordeler.dk

I din FTP-klient skal du angive dit tjenestebrugernavn og adgangskode foruden portnummer, som er 21.

NAVNGIVNING

Brugerdefineret filudtræk
Filudtrækket vil have det navn, som du har angivet ved oprettelsen.

Prædefineret filudtræk
Filudtrækket vil have et systemgeneret abonnementsnavn.

Det er muligt at transformere filudtræk til et andet format. Det er den enkelte registermyndighed, der beslutter, hvilke formater et givet filudtræk skal kunne transformeres til.

Følgende transformationer er understøttet: XML, JSON, GML, eller de i nedenstående tabel angivne geoformater for filudtræk. Bemærk at transformation angives i abonnementsopsætningen.

Geoformater
MapInfo TAB
Esri Shape

Filudtræk Metadata skema.json

{
	"$schema": "http://json-schema.org/draft-04/schema#",
	"title": "FiludtraekMetadata",
	"description": "Leveranceskema for metadatabeskrivelse for filudtræk v3 04/03/2020",
	"type": "object",
	"required": [
		"leveranceNavn",
		"miljoe",
		"fortroligData",
		"dataOmfattetAfPersondataloven",
		"DatafordelerUdtraekstidspunkt",
		"tilgaengelighedsperiode",
		"AbonnementsOplysninger",
		"BrugerUdfyldteParametre"
	],
	"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": [
					"deltavindueSlut"
				],
				"properties": {
					"deltavindueStart": {
						"title": "deltavindueStart",
						"description": "UTC timestamp",
						"type": "string",
						"format": "date-time"
					},
					"deltavindueSlut": {
						"title": "deltavindueSlut",
						"description": "UTC timestamp",
						"type": "string",
						"format": "date-time"
					}
				},
				"additionalProperties": false
			}, "maxItems": 1
		},
		"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",
						"description": "UTC timestamp",
						"type": "string",
						"format": "date-time"
					},
					"senesteAbonnementRedigeringsdato": {
						"title": "senesteAbonnementRedigeringsdato",
						"description": "UTC timestamp",
						"type": "string",
						"format": "date-time"
					},
					"gentagelsesinterval": {
						"title": "gentagelsesinterval",
						"type": "string",
						"enum":["Adhoc", "Dagligt", "Ugentligt", "Månedligt", "Årligt"]
					}
				},
				"additionalProperties": false
			},
			"maxItems": 1
		},
		"BrugerUdfyldteParametre": {
			"type": "array",
			"items": {
				"type": "object",
				"required": ["parameternavn", "parametervaerdi"],
				"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"]
					}
				},
				"additionalProperties": false
			}
		}
	},
	"additionalProperties": false
}

Eksempel på struktur for metadataskema for prædefineret filudtræk

{
"leveranceNavn":"DAR_Totaludtraek_DeltaDaily_JSON_20200526210000.json",
"miljoe":"PROD01",
"fortroligData":"Nej",
"dataOmfattetAfPersondataloven":"Nej",
"MD5CheckSum":"256acc117d7c9812992ad9a44cdc05ad",
"DatafordelerUdtraekstidspunkt": [
{
"deltavindueStart":"2020-05-25T21:00:21.323+02:00",
"deltavindueSlut":"2020-05-26T21:00:00.412+02:00"}],
"tilgaengelighedsperiode":30,
"AbonnementsOplysninger": [
{
"webBrugernavn":"PREDEFINED",
"tjenesteBrugernavn":"PREDEFINED",
"abonnementnavn":"DAR Totaludtraek DeltaDaily JSON",
"tjenestenavn":"DAR-Totaludtraek",
"tjenesteversion":"1.0.1",
"oprettelsesdato":"2019-10-23T15:48:16.924+02:00",
"senesteAbonnementRedigeringsdato":"2019-10-23T15:48:16.924+02:00",
"gentagelsesinterval":"Dagligt"}],
"BrugerUdfyldteParametre": [
{
"parameternavn":"Status",
"parametervaerdi":"NULL"},
{
"parameternavn":"DAFTimestampTil",
"parametervaerdi":"2020-05-26T21:00:00.412+02:00"},
{
"parameternavn":"executionTimestamp",
"parametervaerdi":"2020-05-26T21:00:00.412+02:00"},
{
"parameternavn":"VirkningFra",
"parametervaerdi":"NULL"},
{
"parameternavn":"RegistreringFra",
"parametervaerdi":"NULL"},
{
"parameternavn":"VirkningTil",
"parametervaerdi":"NULL"},
{
"parameternavn":"SincePrevious",
"parametervaerdi":"true"},
{
"parameternavn":"DAFTimestampFra",
"parametervaerdi":"NULL"},
{
"parameternavn":"output_format",
"parametervaerdi":"json"},
{
"parameternavn":"RegistreringTil",
"parametervaerdi":"NULL"},
{
"parameternavn":"lastExecutedTimestamp",
"parametervaerdi":"2020-05-25T21:00:21.323+02:00"}]}

Eksempel på struktur for metadatafil for brugerdefineret filudtræk

{
"leveranceNavn":"EJFtotal_regtid_kah_20200526210500.json",
"miljoe":"PROD01",
"fortroligData":"Ja",
"dataOmfattetAfPersondataloven":"Nej",
"MD5CheckSum":"3b7a5237abc602cdb4f2c21c6c956197",
"DatafordelerUdtraekstidspunkt": [
{
"deltavindueStart":"2020-05-25T21:05:00.341+02:00",
"deltavindueSlut":"2020-05-26T21:05:00.784+02:00"}],
"tilgaengelighedsperiode":30,
"AbonnementsOplysninger": [
{
"webBrugernavn":"xxxx",
"tjenesteBrugernavn":"IESZEITSDY",
"abonnementnavn":"EJFtotal_regtid_kah",
"tjenestenavn":"EJFTotalUdtraekFlad",
"tjenesteversion":"1.0.1",
"oprettelsesdato":"2019-07-02T15:17:57.058+02:00",
"senesteAbonnementRedigeringsdato":"2019-07-02T15:17:57.058+02:00",
"gentagelsesinterval":"Dagligt"}],
"BrugerUdfyldteParametre": [
{
"parameternavn":"Status",
"parametervaerdi":"NULL"},
{
"parameternavn":"DAFTimestampTil",
"parametervaerdi":"2020-05-26T21:05:00.784+02:00"},
{
"parameternavn":"Virkningstid",
"parametervaerdi":"NULL"},
{
"parameternavn":"Registreringstid",
"parametervaerdi":"Null"},
{
"parameternavn":"RegistreringstidTil",
"parametervaerdi":"NOW()"},
{
"parameternavn":"executionTimestamp",
"parametervaerdi":"2020-05-26T21:05:00.784+02:00"},
{
"parameternavn":"output_format",
"parametervaerdi":"JSON"},
{
"parameternavn":"VirkningstidFra",
"parametervaerdi":"0001-01-01T00:00:00.000+00:00"},
{
"parameternavn":"SincePrevious",
"parametervaerdi":"true"},
{
"parameternavn":"RegistreringstidFra",
"parametervaerdi":"2019-04-01T00:00:00.000+02:00"},
{
"parameternavn":"VirkningstidTil",
"parametervaerdi":"NOW()"},
{
"parameternavn":"DAFTimestampFra",
"parametervaerdi":"NULL"},
{
"parameternavn":"lastExecutedTimestamp",
"parametervaerdi":"2020-05-25T21:05:00.341+02:00"}]}

Page tree

Introduktion til filudtræk

Liste over alle filudtræk

Frit tilgængelige filudtræk

Hent et enkelt filudtræk (Download)

Abonnement på filudtræk

Abonnement på prædefineret filudtræk

Vælg tjeneste

Udfyld oplysninger

Tjek parametre og bekræft

Abonnement på brugerdefineret filudtræk

Vælg tjeneste

Udfyld oplysninger

Vælg interval for kørsel af abonnement

Vælg inputparametre

Gennemse oplysninger, og bekræft

Rediger eller slet et abonnement på filudtræk

Hent filudtræk

Transformation

Metadatafil i FTP/SFTP