You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

I forbindelse med release den 21/05-2026 bliver ældre versioner af GraphQL og fildownload udfaset.

Benytter I som anvender tidligere versioner som bliver udfaset 21. maj 2026, skal I opdatere jeres systemer til at bruge de seneste tjeneste-versioner. Denne side er en vejledning til, hvad den seneste version er, hvad der er opdateret, og hvad I som anvendere skal være opmærksomme på.


Sideinformation


Forudsætninger og afgrænsninger

Til toppen

De tjenester og versioner, der udfases, beskrives i tabellen i næste afsnit.

Følgende forudsætninger og afgrænsninger gælder for at kunne følge :

  • Denne vejledning er kun relevant for dig, der kalder en af de tjeneste-versioner, der bliver udfaset 21. maj 2026.
  • Denne vejledning tager udgangspunkt i, at du er indforstået med og har god erfaring med GraphQL og fildownload.
  • Denne vejledning beskriver kun opgradering til den seneste version, der allerede bliver udstillet. Der bliver kun udfaset tidligere tjeneste-versioner af tjenester, hvor der bliver udstillet nyere versioner før 21. maj 2026.

Bemærk

Der vil komme yderligere nye versioner for enkelte tjenester med releasen den 21. maj 2026. Disse er ikke beskrevet i denne vejledning, men kun i særskilte ændringsmeddelelser. Følg med i kommende ændringer på https://datafordeler.dk/drift/aendringer





Tjenesteversioner, der udfases

Til toppen

Område

Register/tjeneste

Version(er) der udfases

Version der skal opgraderes til før 21. maj 2026

GraphQL

BBR

1

2

GraphQL

CVR

1

2

GraphQL

DAGI

1

2

GraphQL

DAR

1

2

GraphQL

DHMHoejdekurver

1

2

GraphQL

DHMOprindelse

1

2

GraphQL

DS

1

2

GraphQL

FIKSPUNKT

1

2

GraphQL

GEODKV

1

2

GraphQL

HISTKORT

1

2

GraphQL

MAT

1

2

GraphQL

SVR

1

2

GraphQL

VUR

1

2

Fildownload

GetAvailableFileDownloads

1

2

Fildownload

BBR

1 og 2

3

Fildownload

CVR

1

2

Fildownload

DAR

1 og 2

3

Fildownload

DHMHoejdekurver

1 og 2

3

Fildownload

DHMOprindelse

1 og 2

3

Fildownload

DS

1 og 2

3

Fildownload

EBR

1 og 2

3

Fildownload

FIKSPUNKT

1 og 2

3

Fildownload

GEODKV

1 og 2

3

Fildownload

MAT

1 og 2

3

Fildownload

SVR

1

2

Fildownload

VUR

1

2





GraphQL


Hvis jeres system bruger disse entiteter og felter, skal I opdatere jeres systemer til at håndtere de nye datatyper.

Uanset om I er påvirket af de nye datatyper, skal I opdatere den URL, der kalder tjenesterne, til at pege på den nye version.

For eksempel, hvis I tidligere kaldte version 1 for BBR: https://graphql.datafordeler.dk/BBR/v1, så skal I opdatere det til den seneste version. For BBR er det version 2: https://graphql.datafordeler.dk/BBR/v2.

Den seneste version for alle register listes i afsnit 3 Tjenesteversioner der udfases.

Ændringerne til GraphQL skyldes primært fejlrettelser til nullability og/eller geometrifelter i 3D, der skulle være 2D-koordinater. De berørte entiteter og felter beskrives nærmere under hvert register i Bilag 5.2 Entiteter og felter med dataændringer.





Fildownload


Metoden GetAvailableFileDownloads


Version 2 af metoden er beskrevet her: GetAvailableFileDownloads Version 2 ([C0200-Fildownload] afsnit 2.1.8.2.1). Forskellen fra version 1 kan opsummeres som følger:

  • Version 2 benytter paging
    • Parameteren ”PageNumber” og returværdien ”PaginationMetadata” er tilføjet for at understøtte paging
    • Den data, der tidligere var udstillet i version 1, tilgås nu under objektet ”AvailableFileDownloads”
  • Version 2 returnere kommuneopdelte fildownload, udover de filer der returneres i version 1
  • URL’en skifter til https://api.datafordeler.dk/FileDownloads/0/GetAvailableFileDownloads

Bemærk: Hvis du kalder GetAvailableFileDownloads uden at angive en version, kalder du automatisk version 2, og du har derfor ikke behov for at ændre noget. Dette beskrives her: Version for REST-API’et ([C0200-Fildownload] afsnit 2.1.8.1).




Register Fildownloads


For dig, der henter fildownload, skal du nu hente filer i en ny version. Du kan se, hvilken version du skal skifte til i afsnit 3 Tjenesteversioner der udfases. Jeres system skal være opdateret til at håndtere de ændringer til datatyper, der beskrives i 5.2 Entiteter og felter med dataændringer.

Fælles for alle er også, at den seneste version udstiller tre ekstra felter:

  • datafordelerRowId (Guid)
  • datafordelerRegisterImportSequenceNumber (Integer)
  • datafordelerRowVersion (Integer)

Du kan læse mere om disse felter her: Nye datafordeler kolonner ([C0200-Fildownload] afsnit 2.1.8.3.4). Bemærk DHMHøjdekurver og DHMOprindelse er undtaget og udstiller ikke felterne.

For at skifte til den seneste version, skal du:

  • Hvis du kalder GetAvailableFildownloads, skal du opdatere filtreringen med ”Version”-parameteren til den seneste version, for dernæst at hente den relevante fil med GetFile.
  • Hvis du kalder GetFile direkte, skal du opdatere filnavnet til version 3. For eksempel:

BBR_V1_Bygning_TotalDownload_csv_Bitemporal_577.zip → BBR_V3_Bygning_TotalDownload_csv_Temporal_577.zip

”Generation Number” er ens mellem versioner, så I behøver ikke at opdatere noget vedrørende generationsnummer, hvis I bruger det for at finde det seneste fildownload.





Entiteter og felter med dataændringer


BBR


GraphQL


Dataændringer for BBR mellem version 1 og 2 i GraphQL:

Entitet

Felt

Ændring

Bygning

byg404Koordinat

“wkt”-feltet i den returnerede “SpatialPointEpsg25832Type” er ændret til at være non-nullable


TekniskAnlaeg

tek109Koordinat




Fildownload


Hvis du opgraderer fra version 1, skal du håndtere de ændringer der beskrives i nedenstående tabel, udover dem, der beskrives i 5.2 Register Fildownloads.

Hvis du opgraderer fra version 2, skal du kun håndtere de ændringer, der beskrives i 5.2 Register Fildownloads. 


Entitet

Felt

Ændring

Bygning

byg404Koordinat

Indeholder ikke værdi for Z-koordinat, hvorfor Z-koordinat attribut ikke udstilles 

TekniskAnlaeg

tek109Koordinat




CVR


GraphQL


Dataændringer for CVR mellem version 1 og 2 i GraphQL:

Entitet

Felt

Ændring

Branche

sekvens

Ændret til at være non-nullable

Navn

sekvens

Produktionsenhed

pNummer

tilknyttetVirksomhedsCVRNummer

Virksomhed

CVRNummer




CVR har, udover ændringer til datatyper, også tilføjet krav om filtrering på særlige felter. Hvilke felter det drejer sig om, fremgår i GraphQL-skemaet for CVR: Hent GraphQL Schema ([C0200-GQL] afsnit 2.11.1.1) med direktivet @filterRequirement. For eksempel, fremgår dette for CVR_Adressering:



CVR_Adressering(

    "Returns the first _n_ elements from the list."

    first: Int

    "Returns the elements in the list that come after the specified cursor."

    after: String

    virkningstid: DafDateTime

    where: CVR_AdresseringFilterInput

  ): CVR_AdresseringConnection

    @listSize(

      assumedSize: 1000

      slicingArguments: ["first"]

      sizedFields: ["nodes", "edges"]

      requireOneSlicingArgument: false

    )

    @cost(weight: "5000")

    @filterRequirement(

      requiresOneOfFields: ["Adresse", "CVREnhedsId", "datafordelerRowId"]

      requiresOneOfArguments: []

    )



Her er der et krav om at filtrere på enten ”Adresse”, ”CVREnhedsId” eller ”datafordelerRowId”. Der returneres en fejlbesked, hvis din query ikke filtrerer på et af disse felter. Du kan finde filtreringskrav til alle andre CVR-entiteter ved at hente deres GraphQL-skema fra https://graphql.datafordeler.dk/CVR/v2/schema.




Fildownload






  • No labels