...

Image Added

Dokumenthistorik

Referencer

Indholdsfortegnelse
1 Introduktion
1.1 Målgruppe
1.1.1 Forudsætninger
1.2 Begreber
1.3 Begrænsninger
1.3.1 Joins
1.3.2 BBR
1.3.3 CVR
1.3.4 EJF
1.4 Anvendelse af oversættelser
1.4.1 Filtrering
1.4.2 Eksempel på komprimering af query baseret på forretningsbehov
2 Oversigt over de udvalgte REST-tjenester
3 REST-tjenester omsat til GraphQL-queries
3.1 Variabler i GraphQL
3.2 GraphQL-felter
3.3 EJF
3.3.1 Ejerskabsskifte
3.3.2 Ejerskabmedstamoplysninger
3.4 MAT
3.4.1 BestemtFastEjendom
3.4.2 MatrikulaerSag
3.4.3 SamletFastEjendom
3.5 EBR
3.5.1 Ejendomsbeliggenhed
3.6 BBR
3.6.1 BBRSag
3.6.2 Enhed
3.6.3 Bygning
3.7 CVR
3.7.1 hentVirksomhedMedCVRNummerFortrolig
3.7.2 hentvirksomhedMedCVRNummer
3.7.3 hentproduktionsenhedmedpnummer
3.8 VUR
3.8.1 Hentejendomsvurderingerforbfe
3.8.2 Hentejendomsvurderingerforejendomsvurderingid
3.9 DAR
3.9.1 Adresse
3.9.2 Adressetilenhedbfe

Anchor
_Toc212623685 _Toc212623685

Introduktion

Dette dokument består af 16 udvalgte eksempler på REST-tjenester omsat til GraphQL-forespørgsler. REST-tjenesterne og deres metoder er udvalgt af Datafordeleren på baggrund af deres relevans og årlige anvendelse. Eksemplerne bruger de Fleksible GraphQL-tjenester (også kendt som fleksibel opslagslogik) til at udstille relationerne mellem registrenes data og derved returnere et resultat der bedst muligt svarer til det fra REST-tjenesterne. 
Alle REST-tjenesterne er oversat ved hjælp af metoden beskrevet i *\[Transitionsguiden m{*}<span style="color: #0f2147"><strong>ellem REST-services og GraphQL-services</strong></span>{*}\]{*}.
Denne guide indeholder kun resultatet af transitionen fra REST til GraphQL for de udvalgte tjenester, men vil dog understrege eventuelle begrænsninger fundet ifm. oversættelserne af disse tjenester. De 16 REST-tjenester er opdelt efter register, REST-tjeneste og metoder, samt i hvilket afsnit man finder de konkrete oversættelser. 
Oversigten over de udvalgte REST-tjenester kan findes i afsnit 2 og de konkrete oversættelser kan findes i afsnit 3. 

Anchor
_Toc212623686 _Toc212623686

Målgruppe

Dette dokument fungerer som en inspiration for udviklere, der står over for opgaven om at oversætte REST-tjenester til GraphQL-forespørgsler. Guiden vil også beskrive de eventuelle udfordringer, udviklere typisk vil støde på i denne proces. Det er her vigtigt at være opmærksom på, at en direkte 1-til-1 oversættelse af REST til GraphQL som oftest ikke anbefales. I stedet bør man udnytte GraphQL-tjenesternes fleksibilitet til at designe forespørgsler, der mere præcist afspejler det faktiske databehov.

Anchor
_Toc212623687 _Toc212623687

Forudsætninger

Dette dokument er tiltænkt læsere, som:

• Besidder teknisk viden inden for udvikling og design af software systemer.
• Har kendskab til de eksisterende REST-tjenester og det data der udstilles.
• Er bekendt med de grundlæggende principper inden for REST, GraphQL og SQL.

Uden denne grundlæggende viden kan læsere have behov for betydelig ekstra tid til at forstå og arbejde med oversættelserne.

Anchor
_Toc212623688 _Toc212623688

Begreber

I dette dokument bruges begreberne, som beskrevet i Tabel 1. Bemærk at begreberne også kan være yderligere forklaret i løbet af dokumentet med eksempler.

Tabel 1: Begrebsliste

Anchor
_Toc212623689 _Toc212623689

Begrænsninger

Anchor
_Toc212623690 _Toc212623690

Joins

Der er nogle begrænsninger for hvordan man kan join entiteter sammen i fleksibel opslagslogik-tjenesterne. Disse beskrives nedenfor.

Anchor
_Generelt _Generelt

Inner-joins og unions understøttes ikke

Anchor
_Ref211954817 _Ref211954817

Begræsning på antal left-joins

Det maksimale antal joins samt resultater per side og andre fælles begrænsinger for oversættelserne kan findes i *\[{*}<span style="color: #0f2147"><strong>Transitionguiden for fleksibel opslagslogik]</strong></span>. Bemærk at de mulige joins i fleksibel opslagslogik er betinget af de relationer som registrene har specificeret til Datafordeleren som værende gyldige. Det samme gør sig gældende for filtreringsmuligheder og det er derfor ikke altid muligt at filtrere på alle felter. Man kan i GraphQL skemaerne se, hvilke relationer som er mulige samt hvilke filtreringsmuligheder en entitet har. Der er tilføjet filtre med testværdier på eksemplerne i dette dokument for at give anvendere mulighed for at se og forstå, hvordan disse kan fungere. Det er muligt at filtrere på flere parametre end disse, og alle parametre vil som nævnt kunne findes i GraphQL skemaerne. 
Nogle oversættelser af REST-tjenester til GraphQL er påvirket af begrænsninger i antallet af tilladte joins. På grund af denne begrænsning er visse oversættelser nødt til at blive opdelt i flere separate GraphQL-queries for at undgå at overskride grænsen for antal joins. Et eksempel på en oversættelse, der er blevet opdelt i flere GraphQL-queries, er SamletFastEjendom i kapitel 3.4.1, hvor resultatværdier fra den første query bruges i efterfølgende kald for at fortsætte join-operationer og hente det endelige resultat. Omvendt er det muligt at optimere og komprimere queries ved at fjerne unødvendige elementer. Et eksempel på denne tilgang kan findes i kapitel 1.4.2, hvor queries kan simplificeres ved at reducere antallet af joins ved at fjerne ikke-påkrævede data.
\\

Relationsnavn

Nogle relationer mellem entiteterne har sigende navne, som AdresseHarHusnummer (DAR_Adresse til DAR_Husnummer), hvorimod andre har autogenerede navne, som objectid_336_MatrikulaerSag_sagsoperation_matrikulaersagobjectid_ref (MAT_MatrikulaerSag til MAT_MatrikulaerSag_sagsoperation).
Det er et kendt problem at relations-navnene i GraphQL-skemaerne kan indeholde stavefejl. Dette vil blive løst i en fremtidige release, efter at registrene har indsendt nye relationsbilag til Datafordeleren. Dette vil resultere i nye versioner af de fleksible GraphQL-tjenester og vil være en breaking change for anvendere. GraphQL-queries til de oversatte REST-tjenester vil stadigvæk fungere efter releasen, så længe anvender husker at opdatere de GraphQL-queries, som påvirkes af navneændringerne. Der vil være paralleldrift af de forskellige versioner af fleksibel opslagslogik, så anvender har muligheden for at opdatere sine systemer inden de gamle versioner udfases.

Anchor
_Toc212623691 _Toc212623691

BBR

I BBRs REST-tjenester er der filtrering på periodeændringer via argumenterne PeriodeaendringFra/Til, som ikke er muligt i GraphQL. Det er derfor op til anvender og udvikler selv, at filtrere på de periodeændringer, der fremgår i svaret fra de fleksible GraphQL-tjenester.

Anchor
_Toc212623692 _Toc212623692

CVR

Det er kun muligt at skabe relationer til CVRs entiteter når man bruger GraphQL-skemaet fra flexibleCurrent-tjenesten, hvilket betyder at det kun er muligt at sende forespørgsler, som indeholder joins fra og til CVR ved brug af flexibleCurrent-tjenesten.
Det er ikke muligt at filtrere på registreringstid i CVR, andet end dags dato, hvilket automatisk håndteres af tjenesten og registreringstid fremgår derfor ikke i eksemplerne. Dette er et krav fra registeret.
Det er ikke muligt at filtrere på beskæftigelsestalstype i GraphQL og dette skal derfor gøres efter at klient-applikationen der har modtaget svaret fra flexibleCurrent-tjenesten.

Anchor
_Toc212623693 _Toc212623693

EJF

Det er ikke muligt at filtrere på registreringstid i tabellerne EJFCustom_PersonSimpelAlt og EJFCustom_PersonSimpelBegraenset. Dette følger EJFs forretningslogik, hvor det fremgår at der kun må filtreres på dags dato for disse tabeller. Disse specialudviklede EJF-CPR-sammenstillinger kan udelukkende tilgås via flexibleCurrent-tjenesten. Det betyder, at alle queries, der vedrører disse særlige EJF-CPR-sammenstillinger, ikke er valide i den almindelige flexible-tjeneste.

Anchor
_Toc212623694 _Toc212623694

Anvendelse af oversættelser

Oversættelserne udgør ikke en komplet løsning til at erstatte anvendernes brug af REST-tjenester. I stedet skal de betragtes som eksempler på anvendelse, hvor anvenders specifikke forretningsbehov kan kræve, at der foretages ændringer i oversættelserne. Forretningsbehov varierer nemlig mellem anvendere, og formålet med de følgende oversættelser er at fungere som et udgangspunkt eller eksempler, og ikke at blive kopieret til direkte brug. Blandt andet kan dele af oversættelserne være irrelevante for en anvenders forretning, da de henter mere data end nødvendigt. Alle oversættelser indeholder samtlige felter for at give anvendere mulighed for at fjerne den data, de ikke har brug for.

Anchor
_Toc212623695 _Toc212623695

Filtrering

I alle oversættelser er det kun de påkrævede filtre fra REST-tjenesterne som er inkluderet. Alle frivillige filtreringsmuligheder er op til anvenderen at tilføje efter behov. For at identificere hvilke filterparametre der kan anvendes, henvises til dokumentationen for *\[D{*}<span style="color: #0f2147"><strong>ataoversigten]</strong></span> på Datafordeleren. Alle tilladte REST-tjeneste filtre vil ligeledes kunne findes i GraphQL-skemaerne. I hvert oversat afsnit nævnes de påkrævede filtre, der anvendes med angivelse af både filterparameterets navn i REST-tjenesten og det tilsvarende GraphQL-skema. Uden yderligere filtrering kan der returneres unødvendige data, som det er op til anvenderen selv at processere. Filtrering kan tilføjes for både hovedentiteten, der joines fra, og underentiteterne, der joines til, i overensstemmelse med GraphQL-skemaerne.

Anchor
_Ref211954663 _Ref211954663

Anchor
_Toc212623696 _Toc212623696

Eksempel på komprimering af query baseret på forretningsbehov

Oversættelsen af REST-tjenensten "MatrikulaerSag", som beskrevet i afsnit 3.4.2, kan f.eks. komprimeres efter hvilken ejendomstype, der ønskes medtaget i resultatet. De 4 GraphQL-queries, der oprindeligt køres efterfølgende af hinanden, kan omskrives til kun 1 query (se nedenstående eksempel), alt afhængigt af det specifikke forretningsbehov. Dette undgår også begrænsningen for det maksimale antal tilladte joins (se kapitel 1.3.1.2), hvilket sammen med unions- og ejendomstyperne var årsagen til den oprindelige opdeling.
I dette eksempel opnås det samme resultat som ved at udføre alle 4 GraphQL-queries i kapitel 3.4.2, men i et enkelt kald i stedet for 4 separate kald. Den komprimerede query inkluderer alle fire ejendomstype-relationer samtidigt:

• bygningPaaFremmedGrundFladeTilhoererMatrikulaerSag
• bygningPaaFremmedGrundPunktTilhoererMatrikulaerSag
• ejerlighedTilhoererMatrikulaerSag
• samletFastEjendomTilhoererMatrikulaerSag

De fleksible GraphQL-tjenester returnerer kun data for de relationer, hvor der faktisk findes tilknyttede ejendomme, mens tomme relationer returneres som tomme arrays. Dette reducerer både antallet af netværkskald og giver et mere sammenhængende datasæt. Oversættelsen kan komprimeres endnu mere ved at fjerne irrelevante ejendomstype-relationer. Hvis anvenderen f.eks. kun behøver data om SamletFastEjendom, kan de tre øvrige relationer udelades, hvilket resulterer i mindre data og hurtigere svar.
Den nye komprimeret GraphQL-query bliver således:
{
MAT_MatrikulaerSag(
first: 1
virkningstid: "9999-01-23T10:39:04.658307Z"
where: { id_lokalId: { eq: "100143926" } }
) {
pageInfo {
hasNextPage
endCursor
}
nodes {
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
ejerlavLokalId
feltliste
forretningshaendelse
forretningsomraade
forretningsproces
id_lokalId
id_namespace
jordstykkeLokalId
journaliseringsdato
kommune
matrikelmyndighedensJournalnum
objectid
registreringFra
registreringsaktoer
registreringTil
rekvirentRef
sagstitel
status
StedbestemmelsesGeometri
virkningFra
virkningsaktoer
virkningTil
bygningPaaFremmedGrundFladeTilhoererMatrikulaerSag {
nodes {
id_lokalId
status
senesteSagLokalId
}
}
bygningPaaFremmedGrundPunktTilhoererMatrikulaerSag {
nodes {
id_lokalId
status
senesteSagLokalId
}
}
ejerlighedTilhoererMatrikulaerSag {
nodes {
id_lokalId
status
senesteSagLokalId
}
}
samletFastEjendomTilhoererMatrikulaerSag {
nodes {
id_lokalId
status
senesteSagLokalId
}
}
objectid_336_MatrikulaerSag_sagsoperation_matrikulaersagobjectid_ref {
nodes {
betegnelse
}
}
}
}
}
 
Bemærk at fremsøgning af en sag med virkningstid svarende til nutid kun returnerer de ejendomme, der ikke er ændret af andre sager efterfølgende. For at finde de ejendomme, der faktisk indgik i sagen på tidspunktet for sagsafslutningen, skal anvendes en virkningstid svarende til sagsafslutningens tidspunkt.

Anchor
_Toc212113574 _Toc212113574

Anchor
_Toc212622493 _Toc212622493

Anchor
_Toc212623697 _Toc212623697

Anchor
_Ref203571891 _Ref203571891

Anchor
_Toc212623698 _Toc212623698

Oversigt over de udvalgte REST-tjenester

Tabel 2 indeholder en oversigt over de udvalgte REST-tjenester og metoder samt hvilket afsnit man finder resultatet af oversættelsen.

Anchor
_Ref203571902 _Ref203571902

Anchor
_Toc212623699 _Toc212623699

REST-tjenester omsat til GraphQL-queries

Dette afsnit indeholder de konkrete oversættelser af REST-tjenester og deres metoder til GraphQL-forespørgsler. Hver REST-tjeneste er inddelt i sit eget underafsnit, med yderligere underafsnit for hver af de individuelle metoder. Hver underafsnit i dette afsnit er i følgende format; Registernavn – REST-tjeneste – Metode. REST-tjenesterne og deres metoder er oversat ved hjælp af metoden fra *\[Transitionsguiden m{*}<span style="color: #0f2147"><strong>ellem REST-services og GraphQL-services</strong></span>{*}\]{*}. En udvikler skulle derfor gerne kunne følge guiden og komme til samme resultat. Udvikler skal her være opmærksom på de begrænsninger, som er gældende for hver REST-tjeneste og deres metoder.

Anchor
_Toc212113577 _Toc212113577

Anchor
_Toc212622496 _Toc212622496

Anchor
_Toc212623700 _Toc212623700

Anchor
_Toc212623701 _Toc212623701

Variabler i GraphQL

For at simplificere de oversatte queries er der indsat placeholder værdier. Det er gjort på den måde så anvenderne kan se, hvordan en query reelt set vil se ud. Dette afsnit, vil med et simpelt eksempel, uddybe, hvordan man kan bruge variabler i sine GraphQL queries. Motivationen bag at bruge variabler er, at man med variabler i sine queries kan lave mere dynamiske og automatiserede kald.
Nedenstående eksempel består af to filer. En fil med en graphql query og en fil med et tilhørende variabel. I dette eksempel tages der et CPRnummer (0101011234) fra variabel filen, som man så kan query med. Filerne sættes eksempelvis sammen gennem et API client tool som Bruno. Dette er ikke relevant ved benyttelse af oversættelserne, men bliver relevant ved udvikling af egne queries.
query ($input: PrivateSectorPersonInput) {
  CPRCustom_PrivateSectorPerson (input: $input) {
    personnumre {
    personnummer
    status
    }
    beskyttelser {
    beskyttelsestype
    status
    virkningfra
    }
   }
}
query ($input: PrivateSectorPersonInput) {
{
"input": {
"pnr": "0101011234"
}
}

Anchor
_Toc212623702 _Toc212623702

GraphQL-felter

GraphQL-felterne i oversættelserne er udvalgt på baggrund af en analyse af REST-tjenesterne og deres JSON schema, som beskrevet i afsnit 3.1 Step 0: Evaluate REST-service fra *\[Transitionsguiden m{*}<span style="color: #0f2147"><strong>ellem REST-services og GraphQL-services</strong></span>{*}\]{*}.

Anchor
_Toc212623703 _Toc212623703

EJF

Anchor
_Toc208412910 _Toc208412910

Anchor
_Toc208414578 _Toc208414578

Anchor
_Toc208414638 _Toc208414638

Anchor
_Toc208905028 _Toc208905028

Anchor
_Toc208909386 _Toc208909386

Anchor
_Toc208909466 _Toc208909466

Anchor
_Toc208909533 _Toc208909533

Anchor
_Toc208910598 _Toc208910598

Anchor
_Toc208910667 _Toc208910667

Anchor
_Toc208910736 _Toc208910736

Anchor
_Toc208911127 _Toc208911127

Anchor
_Toc208412911 _Toc208412911

Anchor
_Toc208414579 _Toc208414579

Anchor
_Toc208414639 _Toc208414639

Anchor
_Toc208905029 _Toc208905029

Anchor
_Toc208909387 _Toc208909387

Anchor
_Toc208909467 _Toc208909467

Anchor
_Toc208909534 _Toc208909534

Anchor
_Toc208910599 _Toc208910599

Anchor
_Toc208910668 _Toc208910668

Anchor
_Toc208910737 _Toc208910737

Anchor
_Toc208911128 _Toc208911128

Anchor
_Toc208412912 _Toc208412912

Anchor
_Toc208414580 _Toc208414580

Anchor
_Toc208414640 _Toc208414640

Anchor
_Toc208905030 _Toc208905030

Anchor
_Toc208909388 _Toc208909388

Anchor
_Toc208909468 _Toc208909468

Anchor
_Toc208909535 _Toc208909535

Anchor
_Toc208910600 _Toc208910600

Anchor
_Toc208910669 _Toc208910669

Anchor
_Toc208910738 _Toc208910738

Anchor
_Toc208911129 _Toc208911129

Anchor
_Toc208412913 _Toc208412913

Anchor
_Toc208414581 _Toc208414581

Anchor
_Toc208414641 _Toc208414641

Anchor
_Toc208905031 _Toc208905031

Anchor
_Toc208909389 _Toc208909389

Anchor
_Toc208909469 _Toc208909469

Anchor
_Toc208909536 _Toc208909536

Anchor
_Toc208910601 _Toc208910601

Anchor
_Toc208910670 _Toc208910670

Anchor
_Toc208910739 _Toc208910739

Anchor
_Toc208911130 _Toc208911130

Anchor
_Ref203555680 _Ref203555680

Anchor
_Toc212623704 _Toc212623704

Ejerskabsskifte

Inputparametre

GraphQL-filter til denne query er udvalgt på baggrund af de obligatoriske inputparametre fra Ejerskabsskifte-metoden og er blevet mappet over til felter fra EJF_EjerskabsskifteFilterInput, som set i GraphQL-skemaet.

• Både registreringstid og virkningstid er påkrævet som input til denne tjeneste.
• I denne metode filtreres der på et bestemt Ejerskabsskifte objekt og felter til paging kan derfor undlades.
• Den aktuelle værdi til "ejerskifteLokalId" er ikke garanteret til at virke for anvendere og skal kun ses som et eksempel.

Resultatet af oversættelsen kan ses herunder og er klar til afprøvning i en autoriseret GraphQL-klient:
{
EJF_Ejerskabsskifte(
first: 10
registreringstid: "2025-03-28T22:12:56.184158Z"
virkningstid: "2025-11-14T11:28:27.184158Z"
where: { ejerskifteLokalId: { eq: "0a3f50c1-12c8-32b8-e044-0003ba298018" } }
) {
nodes {
afgivendeEjerobjektLokalId
afstaaetAndel_naevner
afstaaetAndel_taeller
behandlingsID
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
ejerskifteLokalId
forretningshaendelse
forretningsomraade
forretningsproces
id_lokalId
id_namespace
modtagendeEjerobjektLokalId
modtagetAndel_naevner
modtagetAndel_taeller
registreringFra
registreringsaktoer
registreringTil
status
virkningFra
virkningsaktoer
virkningTil
}
}
}

Anchor
_Ref203570080 _Ref203570080

Anchor
_Toc212623705 _Toc212623705

Ejerskabmedstamoplysninger

Oversættelsen af "Ejerskabmedstamoplysninger" metoden er lavet med udgangspunkt i følgende GraphQL-tjeneste, overentitet og filter input, som er tilgængelig i tjenestens tilhørende GraphQL-skema.

Da EJF_Ejerskab har relationer til entiteter i CVR, kan denne oversættelse kun sendes til flexibleCurrent-tjenesten.

Inputparametre

GraphQL-filter til denne query er udvalgt på baggrund af de obligatoriske inputparametre fra Ejerskabmedstamoplysninger-metoden og er blevet mappet over til felter fra EJF_EjerskabFilterInput, som set i GraphQL-skemaet.

• Kun virkningstid er påkrævet som input til denne tjeneste.
• De konkrete værdier til "ejerskifteLokalId" og "bestemtFastEjendomBFENr" er ikke garanteret til at virke for anvendere og skal kun ses som eksempler.

Denne forespørgsel bruger de samme filtre som den første forespørgsel og vedr. en tilknyttet produktionsenhed.
{
EJF_Ejerskab(
first: 1
virkningstid: "2025-11-14T11:28:27.184158Z"
where: { bestemtFastEjendomBFENr: { eq: 2150138 }, status: { eq: "gældende" } }
) {
pageInfo {
hasNextPage
endCursor
}
nodes {
produktionsenhedPNr_20_Produktionsenhed_pNummer_ref {
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
feltliste
id
pNummer
produktionsenhedOphoersdato
produktionsenhedStartdato
registreringFra
registreringsaktoer
registreringTil
status
tilknyttetTilVirksomhedOphoersdato
tilknyttetTilVirksomhedStartdato
tilknyttetVirksomhedsCVRNummer
virkningFra
virkningsaktoer
virkningTil
id_CVR_Adressering_CVREnhedsId_ref( first: 10
where: { AdresseringAnvendelse: { eq: "beliggenhedsadresse" } }
) {
pageInfo {
hasNextPage
endCursor
}
nodes {
Adresse
AdresseringAnvendelse
coNavn
CVRAdresse_adresseFritekst
CVRAdresse_doerbetegnelse
CVRAdresse_etagebetegnelse
CVRAdresse_husnummerFra
CVRAdresse_husnummerTil
CVRAdresse_kommunekode
CVRAdresse_kommunenavn
CVRAdresse_landekode
CVRAdresse_postboks
CVRAdresse_postdistrikt
CVRAdresse_postnummer
CVRAdresse_supplerendeBynavn
CVRAdresse_vejkode
CVRAdresse_vejnavn
CVREnhedsId
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
feltliste
registreringFra
registreringsaktoer
registreringTil
virkningFra
virkningsaktoer
virkningTil
}
}
id_CVR_Navn_CVREnhedsId_ref {
CVREnhedsId
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
feltliste
registreringFra
registreringsaktoer
registreringTil
sekvens
vaerdi
virkningFra
virkningsaktoer
virkningTil
}
id_CVR_Reklamebeskyttelse_CVREnhedsId_ref {
CVREnhedsId
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
feltliste
registreringFra
registreringsaktoer
registreringTil
vaerdi
virkningFra
virkningsaktoer
virkningTil
}
}
}
}
}
 

Anchor
_Toc212623706 _Toc212623706

MAT

Dette afsnit beskriver oversættelsen af de tre REST-metoder BestemtFastEjendom, MatrikulaerSag og SamletFastEjendom fra Matriklen (MAT).

Anchor
_Toc208412917 _Toc208412917

Anchor
_Toc208414585 _Toc208414585

Anchor
_Toc208414645 _Toc208414645

Anchor
_Toc208905035 _Toc208905035

Anchor
_Toc208909393 _Toc208909393

Anchor
_Toc208909473 _Toc208909473

Anchor
_Toc208909540 _Toc208909540

Anchor
_Toc208910605 _Toc208910605

Anchor
_Toc208910674 _Toc208910674

Anchor
_Toc208910743 _Toc208910743

Anchor
_Toc208911134 _Toc208911134

Anchor
_Toc208412918 _Toc208412918

Anchor
_Toc208414586 _Toc208414586

Anchor
_Toc208414646 _Toc208414646

Anchor
_Toc208905036 _Toc208905036

Anchor
_Toc208909394 _Toc208909394

Anchor
_Toc208909474 _Toc208909474

Anchor
_Toc208909541 _Toc208909541

Anchor
_Toc208910606 _Toc208910606

Anchor
_Toc208910675 _Toc208910675

Anchor
_Toc208910744 _Toc208910744

Anchor
_Toc208911135 _Toc208911135

Anchor
_Toc208412919 _Toc208412919

Anchor
_Toc208414587 _Toc208414587

Anchor
_Toc208414647 _Toc208414647

Anchor
_Toc208905037 _Toc208905037

Anchor
_Toc208909395 _Toc208909395

Anchor
_Toc208909475 _Toc208909475

Anchor
_Toc208909542 _Toc208909542

Anchor
_Toc208910607 _Toc208910607

Anchor
_Toc208910676 _Toc208910676

Anchor
_Toc208910745 _Toc208910745

Anchor
_Toc208911136 _Toc208911136

Anchor
_Toc208412920 _Toc208412920

Anchor
_Toc208414588 _Toc208414588

Anchor
_Toc208414648 _Toc208414648

Anchor
_Toc208905038 _Toc208905038

Anchor
_Toc208909396 _Toc208909396

Anchor
_Toc208909476 _Toc208909476

Anchor
_Toc208909543 _Toc208909543

Anchor
_Toc208910608 _Toc208910608

Anchor
_Toc208910677 _Toc208910677

Anchor
_Toc208910746 _Toc208910746

Anchor
_Toc208911137 _Toc208911137

Anchor
_Toc208412921 _Toc208412921

Anchor
_Toc208414589 _Toc208414589

Anchor
_Toc208414649 _Toc208414649

Anchor
_Toc208905039 _Toc208905039

Anchor
_Toc208909397 _Toc208909397

Anchor
_Toc208909477 _Toc208909477

Anchor
_Toc208909544 _Toc208909544

Anchor
_Toc208910609 _Toc208910609

Anchor
_Toc208910678 _Toc208910678

Anchor
_Toc208910747 _Toc208910747

Anchor
_Toc208911138 _Toc208911138

Anchor
_Ref203555693 _Ref203555693

Anchor
_Toc212623707 _Toc212623707

BestemtFastEjendom

Oversættelsen af "BestemtFastEjendom" metoden er lavet med udgangspunkt i følgende GraphQL-tjeneste, overentitet og filter input, som er tilgængelig i tjenestens tilhørende GraphQL-skema. Oversættelsen tager udgangspunkt i SamletFastEjendom og anvenderne kan selv oversætte for Ejerlejlighed, BygningPaaFremmedGrundflade samt BygningPaaFremmedGrundpunkt ved at skifte startsentiteten.

Inputparametre

GraphQL-filter til denne query er udvalgt på baggrund af de obligatoriske inputparametre fra BestemtFastEjendom-metoden og er blevet mappet over til felter fra MAT_SamletFastEjendomFilterInput, som set i GraphQL-skemaet.

• Både registreringstid og virkningstid er påkrævet som input til denne tjeneste.
• I denne metode filtreres der på et bestemt SamletFastEjendoms objekt og felter til paging kan derfor undlades.
• Den aktuelle værdi til "senesteSagLokalId" er ikke garanteret til at virke for anvendere og skal kun ses som et eksempel.
  • Alternativt kan man bruge "BFEnummer" i stedet for "senesteSagLokalId", da bare en af parametrene er obligatoriske.

Denne oversættelse overgår begrænsingen for antal af joins, så oversættelsen er blevet opdelt i flere forespørgsler. Første del af oversættelsen kan ses herunder og er klar til afprøvning i en autoriseret GraphQL-klient:
{
MAT_SamletFastEjendom(
first: 10
registreringstid: "2025-03-28T22:12:56.184158Z"
virkningstid: "2025-11-14T11:28:27.184158Z"
where: { senesteSagLokalId: { eq: "100024618" } }
) {
pageInfo {
hasNextPage
endCursor
}
nodes {
arbejderbolig
BFEnummer
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
erFaelleslod
feltliste
forretningshaendelse
forretningsomraade
forretningsproces
hovedejendomOpdeltIEjerlejligh
id_lokalId
id_namespace
landbrugsnotering
objectid
paataenktHandling
registreringFra
registreringsaktoer
registreringTil
senesteSagLokalId
status
StedbestemmelsesReference
udskiltVej
virkningFra
virkningsaktoer
virkningTil
jordstykkeSamlesISamletFastEjendom(first: 10) {
pageInfo {
hasNextPage
endCursor
}
nodes {
arealberegningsmetode
arealbetegnelse
arealtype
brugsretsareal
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
delnummer
ejerlavLokalId
faelleslod
feltliste
forretningshaendelse
forretningsomraade
forretningsproces
fredskov_areal
fredskov_omfang
id_lokalId
id_namespace
jordrente_omfang
klitfredning_areal
klitfredning_omfang
kommuneLokalId
majoratsskov_nummer
majoratsskov_omfang
matrikelnummer
objectid
paataenktHandling
regionLokalId
registreretAreal
registreringFra
registreringsaktoer
registreringTil
samletFastEjendomLokalId
senesteSagLokalId
skelforretningssagsLokalId
sognLokalId
stammerFraJordstykkeLokalId
status
strandbeskyttelse_areal
strandbeskyttelse_omfang
supplerendeMaalingSagLokalId
vandarealinkludering
vejareal
vejarealberegningsstatus
virkningFra
virkningsaktoer
virkningTil
objectid_336_Jordstykke_sekundaerForretning_Jordstykkeobjectid_ref(
first: 10
) {
pageInfo {
hasNextPage
endCursor
}
nodes {
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
Jordstykkeobjectid
sekundaerForretningshaendelse
}
}
}
}
}
}
}
 
Denne forespørgsel er til en anden entitet i Matriklen, specifikt MAT_Ejerlav. I denne forespørgsel bruger vi værdien fra "ejerlavLokalId" fra den første forespørgsel, til at hente de Ejerlav som er knyttet til ejendommen. Bemærk at dette gøres separat, da der ikke er en relation fra MAT_SamletFastEjendom til MAT_Ejerlav.
{
MAT_Ejerlav(
first: 10
registreringstid: "2025-03-28T22:12:56.184158Z"
virkningstid: "2025-11-14T11:28:27.184158Z"
where: { id_lokalId: { eq: "140453" } }
) {
pageInfo {
hasNextPage
endCursor
}
nodes {
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
ejerlavskode
ejerlavsnavn
id_lokalId
id_namespace
objectid
registreringFra
registreringsaktoer
registreringTil
senesteSagLokalId
status
virkningFra
virkningsaktoer
virkningTil
administrativtOmraadeTilhoererMatrikulaerSag {
matrikulaerSagStedfaestesAfJordstykke(first: 10) {
pageInfo {
hasNextPage
endCursor
}
nodes {
arealberegningsmetode
arealbetegnelse
arealtype
brugsretsareal
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
delnummer
ejerlavLokalId
faelleslod
feltliste
forretningshaendelse
forretningsomraade
forretningsproces
fredskov_areal
fredskov_omfang
id_lokalId
id_namespace
jordrente_omfang
klitfredning_areal
klitfredning_omfang
kommuneLokalId
majoratsskov_nummer
majoratsskov_omfang
matrikelnummer
objectid
paataenktHandling
regionLokalId
registreretAreal
registreringFra
registreringsaktoer
registreringTil
samletFastEjendomLokalId
senesteSagLokalId
skelforretningssagsLokalId
sognLokalId
stammerFraJordstykkeLokalId
status
strandbeskyttelse_areal
strandbeskyttelse_omfang
supplerendeMaalingSagLokalId
vandarealinkludering
vejareal
vejarealberegningsstatus
virkningFra
virkningsaktoer
virkningTil
centroideLiggerIndenForJordstykke(first: 10) {
pageInfo {
hasNextPage
endCursor
}
nodes {
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
feltliste
forretningshaendelse
forretningsomraade
forretningsproces
id_lokalId
id_namespace
jordstykkeLokalId
objectid
paataenktHandling
registreringFra
registreringsaktoer
registreringTil
senesteSagLokalId
status
virkningFra
virkningsaktoer
virkningTil
}
}
jordstykkeSamlesISamletFastEjendom(first: 10) {
pageInfo {
hasNextPage
endCursor
}
nodes {
arbejderbolig
BFEnummer
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
erFaelleslod
feltliste
forretningshaendelse
forretningsomraade
forretningsproces
hovedejendomOpdeltIEjerlejligh
id_lokalId
id_namespace
landbrugsnotering
objectid
paataenktHandling
registreringFra
registreringsaktoer
registreringTil
senesteSagLokalId
status
StedbestemmelsesReference
udskiltVej
virkningFra
virkningsaktoer
virkningTil
}
}
objectid_336_Jordstykke_sekundaerForretning_Jordstykkeobjectid_ref(
first: 10
) {
pageInfo {
hasNextPage
endCursor
}
nodes {
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
Jordstykkeobjectid
sekundaerForretningshaendelse
}
}
}
}
}
}
}
}
 
Denne forespørgsel er til MAT_Ejerlav igen, dog denne gang med fælles lod. I denne forespørgsel bruger vi værdien fra "ejerlavLokalId" fra den første forespørgsel, til at hente de Ejerlav med fælles lod, som er knyttet til ejendommen.
{
MAT_Ejerlav(
first: 1
registreringstid: "2025-03-28T22:12:56.184158Z"
virkningstid: "2025-11-14T11:28:27.184158Z"
where: { id_lokalId: { eq: "" } }
) {
pageInfo {
hasNextPage
endCursor
}
nodes {
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
ejerlavskode
ejerlavsnavn
id_lokalId
id_namespace
objectid
registreringFra
registreringsaktoer
registreringTil
senesteSagLokalId
status
virkningFra
virkningsaktoer
virkningTil
administrativtOmraadeTilhoererMatrikulaerSag {
matrikulaerSagStedfaestesAfJordstykke(first: 10) {
pageInfo {
hasNextPage
endCursor
}
nodes {
arealberegningsmetode
arealbetegnelse
arealtype
brugsretsareal
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
delnummer
ejerlavLokalId
faelleslod
feltliste
forretningshaendelse
forretningsomraade
forretningsproces
fredskov_areal
fredskov_omfang
id_lokalId
id_namespace
jordrente_omfang
klitfredning_areal
klitfredning_omfang
kommuneLokalId
majoratsskov_nummer
majoratsskov_omfang
matrikelnummer
objectid
paataenktHandling
regionLokalId
registreretAreal
registreringFra
registreringsaktoer
registreringTil
samletFastEjendomLokalId
senesteSagLokalId
skelforretningssagsLokalId
sognLokalId
stammerFraJordstykkeLokalId
status
strandbeskyttelse_areal
strandbeskyttelse_omfang
supplerendeMaalingSagLokalId
vandarealinkludering
vejareal
vejarealberegningsstatus
virkningFra
virkningsaktoer
virkningTil
jordstykkeHarFaelleslodsAndelshavere {
nodes {
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
Jordstykkeobjectid
SamletFastEjendomobjectid
}
}
centroideLiggerIndenForJordstykke(first: 10) {
pageInfo {
hasNextPage
endCursor
}
nodes {
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
feltliste
forretningshaendelse
forretningsomraade
forretningsproces
id_lokalId
id_namespace
jordstykkeLokalId
objectid
paataenktHandling
registreringFra
registreringsaktoer
registreringTil
senesteSagLokalId
status
virkningFra
virkningsaktoer
virkningTil
}
}
jordstykkeSamlesISamletFastEjendom(first: 10) {
pageInfo {
hasNextPage
endCursor
}
nodes {
arbejderbolig
BFEnummer
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
erFaelleslod
feltliste
forretningshaendelse
forretningsomraade
forretningsproces
hovedejendomOpdeltIEjerlejligh
id_lokalId
id_namespace
landbrugsnotering
objectid
paataenktHandling
registreringFra
registreringsaktoer
registreringTil
senesteSagLokalId
status
StedbestemmelsesReference
udskiltVej
virkningFra
virkningsaktoer
virkningTil
}
}
objectid_336_Jordstykke_sekundaerForretning_Jordstykkeobjectid_ref(
first: 10
) {
pageInfo {
hasNextPage
endCursor
}
nodes {
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
Jordstykkeobjectid
sekundaerForretningshaendelse
}
}
}
}
}
}
}
}
 
Denne forespørgsel er til en anden entitet i Ejendomsbeliggenhedsregistret (EBR), specifikt EBR_Ejendomsbeliggenhed. I denne forespørgsel bruger vi værdien fra "BFEnummer" fra den første forespørgsel, til at hente de Ejendomsbeliggenhed, som er knyttet til ejendommen.
{
EBR_Ejendomsbeliggenhed(
first: 1
registreringstid: "2025-03-28T22:12:56.184158Z"
virkningstid: "2025-11-14T11:28:27.184158Z"
where: { bestemtFastEjendomBFENr: { eq: "" } }
) {
pageInfo {
hasNextPage
endCursor
}
nodes {
adresseLokalId
adresseManueltAngivet
bestemtFastEjendomBFENr
betegnelse
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
ESDHReferenceAdresse
ESDHReferenceKommune
feltliste
forretningshaendelse
forretningsomraade
forretningsproces
husnummerLokalId
id_lokalId
id_namespace
kommuneinddelingKommunekode
kommuneManueltAngivet
objectid
registreringFra
registreringsaktoer
registreringTil
status
virkningFra
virkningsaktoer
virkningTil
ejendomsbeliggenhedKnytterAdresseTilBestemtFastEjendomSFE(first: 10) {
pageInfo {
hasNextPage
endCursor
}
nodes {
ejerlejlighedErDelAfSamletFastEjendom(first: 10) {
pageInfo {
hasNextPage
endCursor
}
nodes {
b_BygningPaaFremmedGrundFladeL
b_BygningPaaFremmedGrundPunktL
BFEnummer
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
ejerlejlighedskort
ejerlejlighedsnummer
feltliste
fordelingstalNaevner
fordelingstalTaeller
forretningshaendelse
forretningsomraade
forretningsproces
iBygningPaaFremmedGrund
id_lokalId
id_namespace
objectid
paataenktHandling
registreringFra
registreringsaktoer
registreringTil
samletAreal
samletFastEjendomLokalId
senesteSagLokalId
status
StedbestemmelsesGeometri
StedbestemmelsesReference
virkningFra
virkningsaktoer
virkningTil
ejerlejlighedErDelAfBygningPaaFremmedGrundPunkt(first: 10) {
pageInfo {
hasNextPage
endCursor
}
nodes {
BFEnummer
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
feltliste
forretningshaendelse
forretningsomraade
forretningsproces
geometri {
type
crs
dimension
wkt
}
id_lokalId
id_namespace
objectid
opdeltIEjerlejligheder
oprindelse
paaHavet
paataenktHandling
registreringFra
registreringsaktoer
registreringTil
rids
samletFastEjendomLokalId
senesteSagLokalId
status
StedbestemmelsesReference
virkningFra
virkningsaktoer
virkningTil
ejerlejlighedErDelAfBygningPaaFremmedGrundPunkt(first: 10) {
pageInfo {
hasNextPage
endCursor
}
nodes {
b_BygningPaaFremmedGrundFladeL
b_BygningPaaFremmedGrundPunktL
BFEnummer
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
ejerlejlighedskort
ejerlejlighedsnummer
feltliste
fordelingstalNaevner
fordelingstalTaeller
forretningshaendelse
forretningsomraade
forretningsproces
iBygningPaaFremmedGrund
id_lokalId
id_namespace
objectid
paataenktHandling
registreringFra
registreringsaktoer
registreringTil
samletAreal
samletFastEjendomLokalId
senesteSagLokalId
status
StedbestemmelsesGeometri
StedbestemmelsesReference
virkningFra
virkningsaktoer
virkningTil
}
}
}
}
ejerlejlighedErDelAfBygningPaaFremmedGrundFlade(first: 10) {
pageInfo {
hasNextPage
endCursor
}
nodes {
BFEnummer
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
feltliste
forretningshaendelse
forretningsomraade
forretningsproces
id_lokalId
id_namespace
objectid
opdeltIEjerlejligheder
oprindelse
paaHavet
paataenktHandling
registreringFra
registreringsaktoer
registreringTil
rids
samletFastEjendomLokalId
senesteSagLokalId
status
StedbestemmelsesReference
virkningFra
virkningsaktoer
virkningTil
ejerlejlighedErDelAfBygningPaaFremmedGrundFlade(first: 10) {
pageInfo {
hasNextPage
endCursor
}
nodes {
b_BygningPaaFremmedGrundFladeL
b_BygningPaaFremmedGrundPunktL
BFEnummer
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
ejerlejlighedskort
ejerlejlighedsnummer
feltliste
fordelingstalNaevner
fordelingstalTaeller
forretningshaendelse
forretningsomraade
forretningsproces
iBygningPaaFremmedGrund
id_lokalId
id_namespace
objectid
paataenktHandling
registreringFra
registreringsaktoer
registreringTil
samletAreal
samletFastEjendomLokalId
senesteSagLokalId
status
StedbestemmelsesGeometri
StedbestemmelsesReference
virkningFra
virkningsaktoer
virkningTil
}
}
}
}
}
}
objectid_336_SamletFastEjendom_sekundaerFor_SamletFastEjendomobjectid_ref(
first: 10
) {
pageInfo {
hasNextPage
endCursor
}
nodes {
datafordelerOpdateringstid
datafordelerRegisterImportSequenceNumber
datafordelerRowId
datafordelerRowVersion
SamletFastEjendomobjectid
sekundaerForretningshaendelse
}
}
}
}
}
}
}