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.

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.

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

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

FELTER I OPSÆTNINGEN

Visningsnavn
Her skal du skrive et navn 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.

Har du valgt abonnement på et brugerdefineret filudtræk, skal du desuden angive et interval for levering af dit filudtræk.

FELTER I OPSÆTNINGEN

Levering
Interval for generering af filudtrækket.
Intervallerne man kan vælge imellem afhænger af det specifikke filudtræk.

Klik på NÆSTE

Herefter skal du tilføje inputparametre til abonnementet, hvis du har valgt et brugerdefineret. Ved et prædefineret kan du ikke ændre inputparametrene.

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.

Udfyld og klik på Opret

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. Se mere 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 det 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
}

Error rendering macro 'code': Invalid value specified for parameter '[Ljava.lang.Object;@7c33eeb5'

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

Abonnement på filudtræk

Rediger eller slet et abonnement på filudtræk

Hent filudtræk

Transformation

Metadatafil i FTP/SFTP