Denne side beskriver hvordan du, som anvender, overgår fra Snowflake WFS-tjenester på den nuværende Datafordeler til de moderniserede sammenstillede WFS-tjenester på GeoServer.

Desuden beskrives de enkelte forskelle mellem eksisterende og migrerede WFS-tjenester, så anvendere er bekendt med hvad der ændres, samt hvilken betydning ændringerne har.

For at overgå til de nye WFS-tjenester skal du desuden være på Datafordelerens nye brugerstyring på Datafordeler Administration og have en dertilhørende autentifikationsmetode.

Introduktion til GeoServer WFS-tjenester

Den moderniserede Datafordeler anvender GeoServer, et veletableret open source standardprogrammel, til udstilling af WFS-tjenester. Datafordelerens eksisterende WFS-tjenester er migreret fra Snowflake til GeoServer, som vist på nedenstående figur. For at give anvendere god tid til at migrere over til WFS-tjenester på GeoServer, vil der i en periode være paralleldrift af eksisterende og migrerede tjenester.

Der har været stor fokus på at minimere de justeringer og ændringer, som en anvender skal foretage sig for at benytte sig af de moderniserede geotjenester. Overgangen til et nyt standardprogrammel har dog uundgåeligt medført nogle mindre justeringer. Det er blot aspekter, man skal være opmærksom på, og ikke ændringer som alle skal forholde sig til.

Guide til overgang fra nuværende til migrerede WFS tjenester

Størstedelen af anvendere skal ændre få ting for at overgå til de migrerede WFS-tjenester.

Den største ændring, som har en betydning for alle anvendere af WFS-tjenester, er at subdomænet i url'en har ændret sig. Det vil for størstedelen af anvendere kun være nødvendigt at ændre i subdomænet, for at overgå til de migrerede WFS-tjenester.

Der har været følgende ændring i url'en:

Følgende beskriver en "trin for trin" guide til at overgå til de migrerede WFS-tjenester.

1. Skift subdomæne-delen af din url
2. Skift brugernavn/adgangskode ud med en ny autentifikationsmetode, eksempelvis API-key
3. Tjek om det virker. Hvis alting virker som forventeligt er der ikke behov for at gøre noget yderligere.
   1. Hvis det ikke virker, så tjek i afsnittet Ændringer i de migrerede WFS-tjenester for de enkelte ændringer, som kan have betydning for visse anvendere.

Følgende er et eksempel på en fuld tjeneste-url, der viser at det kun er en mindre ændring i subdomænet og brugerstyring man som anvender skal forholde sig til.

Eksisterende url

Moderniserede url

Specielt for GIS klienter

Hvis du anvender WFS-tjenester i GIS klienter, som QGIS, ArcMap eller MapInfo, vil vi anbefale at du opretter en ny forbindelse til tjenesten, i stedet for at opdatere eksisterende. Følg den eksisterende guide til hvordan du opretter en ny forbindelse.

Det er vigtigt at bemærke at når du følger den eksisterende guide, skal du anvende den nye url som starter med https://wfs.datafordeler.dk, men med den fulde url til den tjeneste du vil anvende.

Den fulde url er beskrevet i ovenstående afsnit om overgang fra nuværende til migrerede WFS tjenester og nedenstående afsnit om oversigt over WFS-tjenester i den moderniserede Datafordeler. Husk at indsætte brugernavn og adgangskode. 

Den fulde url vil fx se ud som følgende:

Ændringer i de migrerede WFS-tjenester

For størstedelen af anvendere vil overgangen til de migrerede WFS-tjenester blot være at ændre subdomænet og brugerstyring. For anvendere med specialfremstillede løsninger eller infrastrukturopstillinger, der har begrænset ekstern adgang, kan der være behov for at foretage få yderligere ændringer.

Oversigt over WFS-tjenester i den moderniserede Datafordeler

Følgende tabel viser en oversigt over migrerede WFS-tjenester i den moderniserede Datafordeler.

WFS-versioner

Der ændres i alle GetCapabilities dokumenter, hvor værdierne fra supporterede WFS versioner nu kun har version 2.0.0. Følgende sektion i GetCapabilities indeholder nu kun <ows:Value>2.0.0</ows:Value>.

<ows:Parameter name="AcceptVersions">
<ows:AllowedValues>
<ows:Value>2.0.0</ows:Value>
</ows:AllowedValues>
</ows:Parameter>

Denne ændring burde ikke have en indflydelse på funktionaliteten, men hvis du som anvender har anvendt brugerdefineret logik der afhænger af version 1.0.0 eller 1.1.0, så skal du være forberedt på at disse versioner ikke understøttes af de migrerede tjenester.

FeatureCollection member

I de moderniserede WFS-tjenester vil der være en ændring i GML-data, som indeholder "FeatureCollection". Ændringen er meget lille og for de fleste anvendere ubetydelig. Ændringen er at dette GML-element nu hedder member i stedet for featureMember:

<?xml version="1.0" encoding="UTF-8"?>
<FeatureCollection ...>
<member>
<Formkurve2_5 gml:id="1">
<forretningshaendelse>systemetablering</forretningshaendelse>
<forretningsomraade>52.20.15.20</forretningsomraade>
<forretningsproces>systemetablering</forretningsproces>
<id>
<Identifikation>
<namespace>http://data.gov.dk/hoejdekurver</namespace>
<lokalId>beb45b9a-bb06-4266-8f9c-5b5899e5f40a</lokalId>
</Identifikation>
</id>
<registreringFra>2019-11-04T14:04:50.250Z</registreringFra>
<registreringsaktoer>systemetablering</registreringsaktoer>
<status>registreret</status>
<virkningFra>2019-11-04T14:04:50.250Z</virkningFra>
<virkningsaktoer>systemetablering</virkningsaktoer>
<geometri>
<LineString gml:id="geo.1" srsDimension="3" srsName="urn:ogc:def:crs:EPSG::25832">
<posList>607000 6248367.966 17.5 606996 6248367.327 17.5 606988 ... </posList>
</LineString>
</geometri>D<kurveId>15</kurveId>
<objektnavn>1km_6248_606</objektnavn>
<hjaelpekurve>false</hjaelpekurve>
<hoejde>17.5</hoejde>
</Formkurve2_5>
</member>
</FeatureCollection>

Denne ændring har ingen indflydelse, hvis du anvender de migrerede WFS-tjenester i en GIS-klient da det er indbygget. Har du har opsat brugerdefineret logik der statisk kigger efter værdien "featureMember", så skal du være forberedt på at den nu er ændret til "member".

XML skema namespace

I nogle migrerede WFS-tjenester er der ændret i XML-skema namespace i "DescribeFeatureType". Denne ændring har kun en betydning for anvendere, som anvender brugerdefineret logik til fortolkning af GML strukturer. Her vil du i nogle tilfælde skulle opdatere parseren og importere metadata på ny. Hvis du anvender en GIS-klient, vil klienten automatisk importere opdateret metadata fra tjenesten.

Nedenstående tabel beskriver de tjenester, der har denne ændring.

Tidsstempler 

I de migrerede WFS-tjenester vil tidsstemplet der returneres nu være i et nyt format. Denne ændring har højst sandsynligt ingen påvirkning på anvendere, men det kan være at du parser et tidsformat-format med en specifik formatering og i så fald skal du være opmærksom på den nye ændring.

Tidsfeltet der returneres fra de migrerede WFS-tjenester er nu i UTC-tidszone præsentation. Derfor vil følgende tidsstempel anvendes; "2024-02-26T10:00:00Z" i stedet for "2024-02-26T11:00:00+01:00".

Maksimum antal objekter per forespørgsel

De migrerede WFS-tjenester opretholder følgende grænser for, hvor mange objekter der returneres i en enkel forespørgsel. WFS-paging kan benyttes til at hente flere objekter end den fastsatte grænse per forespørgsel.

WFS 2.0-baseret paging

Alle tjenester understøtter WFS 2.0-baseret paging. Paging aktiveres ved at tilføje url-parameteren "startindex=0" når du kalder en tjeneste med "getfeature" request. Eksempel:

Herefter kan "next" attributten på "FeatureCollection"-elementet i svaret fra tjenesten bruges til at hente flere objekter. Når der ikke optræder en "next" attribut i svaret, er der ikke flere objekter at hente.

For GIS klienter

Moderne GIS klienter understøtter WFS 2.0 og herunder paging. For eksempel anvender QGIS automatisk paging i dialogen "Create a new WFS Connection" og "Modify WFS Connection" på de migrerede WFS-tjenester.

Adgangspunkter i Danske Stednavne Bearbejdet WFS

I tjenesten "Danske Stednavne Bearbejdet WFS" er adgangspunkter fjernet fra tjenestens XML-skema. Tjenesten returnerer derfor ikke længere attributter med navn på formen "adgangspunkt_", som fx "adgangspunkt_1.geometri", "adgangspunkt_1.adgangsbeskrivelse".

Feature ID-format i Matriklen2 tjenester

I de migrerede Matriklen2 WFS-tjenester er formatet af værdien i "feature ID"-attributten ændret. Tjenesten "Matriklen2 Gældende og Foreløbig WFS" beskrives i følgende tabel:

Tjenesten "Matriklen2 med historik WFS" beskrives nedenfor:

Anvendere, der opbevarer lokale data med referencer til disse tjenesters feature ID, skal forberede sig på at konvertere til det nye format i forbindelse med overgang til de migrerede Matriklen2 WFS-tjenester.