Datatjänster

En datatjänst är ett sätt att beskriva och publicera ett eller flera API:er. I EntryScape Catalog kan du lägga till en datatjänst som hör till en datamängd.

Skapa datatjänst

För att skapa en datatjänst, gå in på Datatjänster i menyn och klicka på ”Skapa”.

Då får du fylla i titel och åtkomstadress för datatjänsten. För fältet åtkomstadress ska du peka på den mest generella öppna åtkomstadressen till din datatjänst. Undvik att länka djupare direkt till API:et. 

Om du dessutom klickar i att du vill se även rekommenderade och frivilliga fält så får du fylla i ytterligare information om datatjänsten, som till exempel licens m.m. Klicka sedan på "Skapa" för att skapa datatjänsten.

Obs! Det går att spara beskrivningen av datatjänsten även om man inte har fyllt i alla obligatoriska fält. Datatjänsen visas då i listan med en röd varningssymbol som visar att den är ofullständig och det går inte att publicera datatjänsten förrän alla obligatoriska fält är ifyllda.

Fältet Uppfyller

Fältet "Uppfyller" används för att hänvisa till en specifikation eller tillämpningsföreskrift som gäller för datatjänsten. Beroende på om man kör DCAT 3 eller DCAT 2 så hittas fältet "Uppfyller" under Rekommenderade fält respektive Frivilliga fält.

Du kan antingen välja en specifikation som finns upplagd på Sveriges dataportal eller välja ett eget specifikationsdokument som du har laddat upp eller länkat till via funktionen Dokument i EntryScape.

Du kan söka fram en specifikation från Sveriges dataportal via sökfältet eller klicka på förstoringsglaset för att bläddra bland specifikationer.

För att välja ett specifikationsdokument som har lagts upp lokalt i din instans av EntryScape, klicka på förstoringsglaset och välj "Lokal". Observera att dokument som du har laddat upp själv måste vara av dokumenttypen "Standard/rekommendation/specifikation" i Catalog för att synas här.

Skapa WMS-tjänst - exempel

Du kan skapa en WMS-tjänst med kartvisualering i EntryScape Catalog genom att koppla samman de olika delarna genom följande steg:

1. Hitta och kopiera in den externa WMS-tjänstens åtkomstadress (URL) i din WMS-tjänst i EntryScape.

2. Ange att datatjänsten är WMS, genom att den uppfyller en WMS-specification.

3. Skapa en datamängd med distribution baserad på den nyskapade WMS-tjänsten.

4. Skapa en kartvisualisering av WMS-tjänsten

Dessa steg beskrivs i detalj här under.

1. Kopiera URL till din WMS-tjänst i EntryScape

Börja med att leta rätt på den externa WMS-tjänstens åtkomstadress hos organisationen och kopiera den. Det kan t ex se ut såhär:

Under Datatjänster i EntryScape Catalog, klicka på Skapa. Fyll i titel och klistra in WMS-tjänstens åtkomstadress (URL).

2. Ange att datatjänsten uppfyller WMS-specifikation

Slå därefter på "Rekommenderade fält" högst upp och klicka eller scrolla dig ner till fältet "Uppfyller". Där kan du söka fram specifikationen "OGC Web Map Service" från Sveriges dataportal och klicka på "Skapa". (För de instanser som fortfarande kör DCAT 2 så behöver du slå på "Frivilliga fält".)

Efter det är datatjänsten skapad.

Obs! Om du inte har tillgång till specifikationer ifrån Sveriges dataportal, t ex "OGC Web Map Service", så kan du länka till specifikationen manuellt via funktionen Dokument i EntryScape istället. Läs mer om det här.

3. Skapa en datamängd med distribution från WMS-tjänsten.

Nästa steg är att skapa en datamängd baserad på den tillagda WMS-tjänsten. Gå till Datamängder, klicka på "Skapa" och välj "Datamängd baserad på datatjänst".

Välj sedan den nytillagda WMS-tjänsten som datatjänst.

Därefter visas alla lager som följt med WMS-tjänsten (i exemplet bara ett lager). Klicka på "Skapa" för att skapa en datamängd utifrån det lagret.

Du får sedan komplettera informationen om datamängden genom att fylla i en beskrivning och välja en utgivare. Sedan är din datamängd klar. Och samtidigt har en distribution skapats automatiskt.

4. Skapa kartvisualisering av WMS-tjänsten

Om din EntryScape-instans har visualiseringar och kartvisualiseringar påslaget i konfigurationen, så kan du gå vidare och skapa en kartvisualisering av WMS-tjänsten. Klicka då på plusknappen vid "Visualiseringar".

Obs! Om du inte lyckas att skapa en WMS-tjänst eller har problem med kartvisualiseringar, så kan antingen du läsa mer om vanliga problem kring WMS och problem med kartvisualiseringar i vår FAQ eller gå in på EntryScapes användarforum med frågor och svar.

Sen fyller du i vilken WMS-tjänst som visualiseringen ska baseras på, samt obligatorisk titel. Du kan också välja om din karta ska visa legend och skalstreck.

Scrolla sedan ner och använd zoom-knapparna (eller musknapparna) för att zooma till det utsnitt på kartan som du vill ska visas i din kartvisualisering. Klicka sedan på "Skapa".

Nu är kartvisualiseringen klar och du kan förhandsgranska den genom att klicka fram trepunktsmenyn och välja förhandsvisa.

Redigera eller ta bort datatjänst

Du kan redigera din datatjänst genom att klicka på redigeringspennan i listan med datatjänster.

Du kan också redigera informationen om din datatjänst eller ta bort med knapparna "Redigera" och "Ta bort" på översiktssidan för datatjänsten. Där kan du även se en lista med den eller de Datamängder som datatjänster försörjer.

Se detaljerad information

Om du vill se mer detaljerad information om en datatjänst kan du klicka på informationsikonen.

Då får du upp ett dialogfönster där du kan se metadata som åtkomstadress, vilken datamängd datatjänsten försörjer samt alla entiteter som länkar till och från datatjänsten. Läs mer om det på sidan detaljerad information.

Publicera datatjänst

När du har beskrivit din datatjänst tillräckligt så kan du publicera den, genom att klicka på publiceraknappen. Då blir knappen grön.

I listan över datatjänster visar ikonerna sedan om tjänsten är publicerad (grön jordglob) eller inte publicerad (svart överstruken jordglob).