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å.

Forudsætninger og afgrænsninger

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.

Tjenesteversioner, der udfases

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 afsnit 3Tjenesteversioner 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.2Entiteter 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 3Tjenesteversioner der udfases. Jeres system skal være opdateret til at håndtere de ændringer til datatyper, der beskrives i 5.2Entiteter 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:

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. 

CVR

GraphQL

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

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:

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