Tilføj et koblet kort som katalogtjeneste

Formål og versionsgrundlag

Vejledningen beskriver to måder at gøre et koblet kort tilgængeligt som katalogtjeneste:

Tilføj tjenesten centralt i localConfig.json.
Tilføj tjenesten direkte i Katalog på det aktuelle kort.

Konfigurationen er kontrolleret mod Nordiq-grundlaget nqgis-2026-10-sep. Kundens aktive konfiguration kan være indlæst fra en ekstern datamappe og skal derfor findes, før der redigeres.

Forudsætninger

Det koblede kort er gemt og har et ressource-id.
URL’en til kortets GeoStore-data er kendt.
MapServiceType er aktivt.
Katalogpluginet er konfigureret med servicetypen connectedmap.
Du har backup af den aktive localConfig.json, hvis tjenesten skal tilføjes centralt.

Den lokale URL har formen:

/mapstore/rest/geostore/data/RESSOURCE_ID

For en ekstern Nordiq WebGIS-installation bruges en fuld HTTPS-URL:

https://SITENAVN/mapstore/rest/geostore/data/RESSOURCE_ID

Berørte filer og tjenester

../nqgis/data/[sitenavn]/mapstore/static-config/configs/localConfig.json
Pluginet MapServiceType, som registrerer typerne map og connectedmap.
Katalogpluginet Catalog, som viser Connected MapStore Map blandt servicetyperne.
GeoStore-dataendpointet for det koblede kort.

Trin-for-trin

Metode 1: Tilføj tjenesten via localConfig.json

Brug denne metode, når tjenesten skal være tilgængelig som standard og ikke tilføjes manuelt i hvert kort.

Find den aktive localConfig.json.
Opret en backup ved at tage en kopi af localConfig.json
Find initialState.defaultState.catalog.default.services.
Tilføj en entydig nøgle, uden mellemrum og specialtegn, og tjenestens konfiguration:

{
  "initialState": {
    "defaultState": {
      "catalog": {
        "default": {
          "selectedService": "koblet_fagkort",
          "services": {
            "koblet_fagkort": {  <---- entydig nøgle "koblet_fagkort"
              "url": "/mapstore/rest/geostore/data/RESSOURCE_ID", <---- link til servicen. Ressource ID kan afleses som de sidste tal i kortets url
              "type": "connectedmap", <--- skal være typen connectedmap
              "title": "Koblet fagkort" <---- Overskrift som slutbrugeren ser i kataloget. Her må man gerne bruge mellemrum og specialtegn.
            }
          }
        }
      }
    }
  }
}

Eksemplet viser kun den relevante struktur. Bevar alle eksisterende katalogtjenester og øvrige felter i filen.

selectedService er valgfrit. Angiv kun den nye nøgle, hvis det koblede kort skal være den valgte tjeneste, når Katalog åbnes.

Kontrollér, at servicetypen connectedmap findes i Catalog:

{
  "name": "Catalog",
  "cfg": {
    "serviceTypes": [
      {
        "name": "connectedmap",
        "label": "Connected MapStore Map"
      }
    ]
  }
}

Kontrollér, at "MapServiceType" findes.
Gem den gyldige JSON-fil, og åben mapstore for at tjekke det virker

Metode 2: Tilføj tjenesten direkte i Katalog

Brug denne metode, når tjenesten kun skal gemmes sammen med det aktuelle kort.

Åbn kortet, og vælg Katalog.
Vælg +.
Angiv:
- Type: Connected MapStore Map
- Titel: Et entydigt og forståeligt navn
- URL: /mapstore/rest/geostore/data/RESSOURCE_ID
Bekræft tilføjelsen.
Vælg den nye tjeneste i Katalog.
Søg efter et kendt lag eller en kendt gruppe.
Tilføj et testlag, og gem kortet.

Konfiguration

Følgende felter er nødvendige for en forudkonfigureret tjeneste:

url: GeoStore-data-URL’en til det koblede kort.
type: Skal være connectedmap.
title: Navnet, som vises i Katalog.

Brug ikke typen map, hvis indholdet skal forblive koblet. Typen map tilføjer en almindelig kopi uden det abonnement, som Publicér bruger.

Tjenesten kan pege på:

et koblet kort på samme installation med en relativ URL

Aktivering eller genstart

Genindlæs Nordiq WebGIS efter deployment.
Ryd kun browsercache, hvis installationens statiske konfiguration ellers ikke opdateres.
Åbn et nyt kort, og kontrollér den forudkonfigurerede tjeneste.
Ved direkte tilføjelse skal kortet gemmes, så katalogtjenesten bevares.

Kontrol og rollback

Kontrollér:

Tjenesten vises med den forventede titel.
Søgning returnerer lag og grupper fra det korrekte koblede kort.
Når lagindstillinger eller Infoopsætning åbnes for det tilføjede indhold i et almindeligt abonnentkort, vises advarslen om redigering af koblet indhold.
En gruppe tilføjes med sine efterkommere.
Kortet kan gemmes og åbnes igen med tjenesten og koblingen bevaret.

Rollback for localConfig.json:

Rul tilbage ved først at omdøbe den forkerte localConfig.json til localConfig_noGood.json. Derefter omøbes backup-json’en til localConfig.json
Genindlæs Mapstore og tjek at det virker igen

En tjeneste, der er tilføjet direkte i Katalog, kan slettes fra listen over katalogtjenester. Det fjerner ikke automatisk lag, som allerede er tilføjet til kortet.

Sikkerhed

Katalogsynlighed giver ikke i sig selv adgang til beskyttede lag; den reelle adgang skal håndhæves i GeoServer, GeoStore eller den relevante backend.
Kontrollér delingsrettighederne på det koblede kort.

Fejlfinding

Problem: Typen Connected MapStore Map kan ikke vælges.
Mulig årsag: MapServiceType er ikke aktivt, eller connectedmap mangler i Catalog.cfg.serviceTypes.
Løsning: Kontrollér begge pluginopsætninger i den aktive konfiguration.

Problem: Tjenesten kan ikke tilføjes.
Mulig årsag: URL’en peger på viewer-sti i stedet for GeoStore-dataendpointet.
Løsning: Brug /mapstore/rest/geostore/data/RESSOURCE_ID.

Problem: Kataloget viser ingen resultater.
Mulig årsag: Ressource-id’et er forkert, kortet er ikke et koblet kort, eller brugeren mangler adgang.
Løsning: Åbn data-URL’en med en autoriseret bruger, og kontrollér, at JSON-svaret indeholder connectedAdminMap.

Problem: Lagene kan tilføjes, men de er ikke koblede.
Mulig årsag: Tjenesten er oprettet med typen map i stedet for connectedmap.
Løsning: Ret typen, tilføj indholdet igen fra den korrekte tjeneste, og gem kortet.