Sådan opsætter du søgninger i OneDoor

OneDoor leveres med et bibliotek af forkonfigurerede søgninger — adresser, matrikler, plandata, ejendomme, BBR, CVR m.fl. Denne vejledning viser hvordan du tænder dem du har brug for, justerer deres parametre og kobler eksterne kilder som QGIS Server, S4Index eller ArcGIS på.

Søgninger konfigureres i config.yml og params.yml

Hvor konfigureres søgningerne?

Find mappen for din konfiguration og åbn config.yml:

text

config/
  organisations/
    <din-organisation>/
      configurations/
        <din-konfiguration>/
          config.yml        ← her importeres bibliotekerne og tændes søgningerne
          params.yml        ← her står kommunekode, targets og credentials

Du arbejder typisk i to filer:

config.yml — importerer bibliotekerne (standardkommune, evt. tingbog, tinglysning, dmp, s4index) og tænder de søgninger brugeren skal have.
params.yml — kommunekode, targets, tokens og credentials.

Aktivér en standard-søgning

1. Importér biblioteket i `config.yml`

yaml

import:
  sections:
    - name: params
      dir: $.env.configDir
    - name: standardkommune
      dir: $.env.libDir/lib/standardkommune

2. Sæt kommunekode og targets i `params.yml`

yaml

parameters:
  kommunekode: "0751"           # Aarhus. Brug "*" for hele landet.

  gsearch:
    targets:
      - matrikelnumre
      - postdistrikter
      # - kommuner
      # - sogne

  plansystem:
    targets:
      - vedtagetlokalplan
      - lokalplanforslag
      - kommuneplanramme
      - kommuneplantillaeg
      - byggefelt
      - delomraade
      - zonestatus
      - kystnaerhedszone

Udkommentér de linjer du ikke har brug for. Standard-søgningerne tilpasser sig automatisk.

3. Tænd søgningerne i `config.yml`

yaml

controller:
  _type: Septima.Search.Controller
  _options:
    blankBehavior: search
    searchers:
      - _ref: $.standardkommune.dawa
      - _ref: $.standardkommune.gsearch
      - _ref: $.standardkommune.plansystem
      - _ref: $.standardkommune.stednavne
      - _ref: $.standardkommune.ejendomme
      - _ref: $.standardkommune.bbr
      - _ref: $.standardkommune.cvr

Rækkefølgen bestemmer i hvilken orden søgeresultaterne vises. Fjern linjer du ikke vil have med.

Søgninger der kan konfigureres

Standard — kommer med `standardkommune`-import

Navn	Hvad finder den?	Forudsætninger
`dawa`	Adresser, vejnavne og husnumre	—
`gsearch`	Matrikler, sogne, kommuner, postdistrikter m.fl.	Inkluderet i OneDoor-licensen
`plansystem`	Lokalplaner, kommuneplanrammer, byggefelter m.fl.	—
`stednavne`	Stednavne	Inkluderet i OneDoor-licensen
`cvr`	Virksomheder og p-enheder	Inkluderet i OneDoor-licensen
`ejendomme`	Samlet fast ejendom og BFE-numre	Datafordeler-bruger og -certifikat
`bbr`	Bygninger og boligenheder fra BBR	Datafordeler-bruger og -certifikat
`skoledistrikter`	Skoledistrikter (FKG)	—
`poi`	Points of Interest (biblioteker, tankstationer m.fl.)	API-token fra Septima
`kloakoplande`	Vedtagne og mulige kloakoplande	—

Tilvalg — kræver ekstra import

Navn	Hvad finder den?	Forudsætninger
`tingbog`	Tingbogen via Septimas service — adkomst, hæftelser, byrder	Tingbogs-abonnement hos Septima + `tingbog`-import
`tinglysning`	Tingbogsoplysninger via GeoPartner	GeoPartner-brugernavn + adgangskode + `tinglysning`-import
`dmp`	DMP-lagkatalog — natur, beskyttelse, fredede bygninger	`dmp`-import

Eksterne kilder — kræver URL i `params.yml`

Navn	Hvad finder den?	Forudsætninger
`qgis` (OWS)	Lag fra en WMS/WFS-server, fx QGIS Server	URL til OWS-endpoint
`s4Index`	Lag og data fra SpatialSuite S4	URL til S4-host + `s4index`-import
`arcgis`	Lag fra ArcGIS REST-services	URL + servicenavn + `arcgis-eksempel`-import

Parametre per søgning

`gsearch.targets`

Bestemmer hvilke geografiske kategorier gsearch returnerer hits for.

Værdi	Hvad finder den?
`matrikelnumre`	Matrikelnumre (jordstykker)
`matrikelnumre_udgaaet`	Udgåede matrikelnumre
`kommuner`	Kommuner
`regioner`	Regioner
`sogne`	Sogne
`postdistrikter`	Postdistrikter
`politikredse`	Politikredse
`retskredse`	Retskredse
`opstillingskredse`	Opstillingskredse

`plansystem.targets`

Bestemmer hvilke plantyper plansystem søger i.

Værdi	Hvad finder den?
`vedtagetlokalplan`	Vedtagne lokalplaner
`lokalplanforslag`	Lokalplanforslag i høring
`kommuneplanramme`	Kommuneplanrammer
`kommuneplantillaeg`	Kommuneplantillæg (vedtagne)
`kommuneplantillaeg_alle`	Alle kommuneplantillæg (også forslag)
`byggefelt`	Byggefelter fra lokalplaner
`delomraade`	Delområder fra lokalplaner
`regionplan`	Regionplaner
`zonestatus`	Zonestatus (by-, land- og sommerhuszone)
`kystnaerhedszone`	Kystnærhedszone
`transportkorridor`	Transportkorridorer
`vedtagetkloakopland`	Vedtagne kloakoplande
`mulighedforudtraedenkloakopland`	Områder med mulighed for udtræden af kloakopland

POI — `poi.token`, `poi.hovedtyper`, `poi.undertyper`

yaml

parameters:
  poi:
    token: <api-token-fra-septima>
    hovedtyper: ['*']    # '*' for alle, [] for ingen
    undertyper: []       # '*' for alle, [] for ingen

Ejendomme og BBR — `datafordeler.*`

ejendomme og bbr kalder Datafordeleren og kræver både brugernavn/adgangskode og et klientcertifikat.

yaml

parameters:
  datafordeler:
    username: <datafordeler-brugernavn>
    password: <datafordeler-adgangskode>
    certifikat:
      passphrase: <kodeord-til-p12-fil>
      dir:
        _ref: $.env.organisationDir
      filename: "<navn-på-p12-fil>"

Tingbog — Septimas service

Importér tingbog i config.yml og tilføj - _ref: $.tingbog.searcher i controller.searchers. Selve service-adgangen er knyttet til jeres OneDoor-abonnement hos Septima og kræver ingen credentials i config.

yaml

import:
  sections:
    - name: tingbog
      dir: $.env.libDir/lib/standardkommune

Tinglysning — GeoPartner

yaml

import:
  sections:
    - name: tinglysning
      dir: $.env.libDir/lib/standardkommune

parameters:
  geoPartner:
    userName: <geopartner-bruger>
    passWord: <geopartner-adgangskode>

Aktivér med - _ref: $.tinglysning.geoPartnerSearcher.

DMP — datakatalog

Importér dmp og tilføj de feature-searchere du har brug for:

yaml

import:
  sections:
    - name: dmp
      dir: $.env.libDir/lib/standardkommune

controller:
  _options:
    searchers:
      - _ref: $.dmp.natur_features
      - _ref: $.dmp.beskyttelse_features
      - _ref: $.dmp.oevrige_features

Eksterne kilder

OWS / QGIS Server

Definér en searcher i config.yml med URL til OWS-endpointet. Eksemplet her peger på en QGIS Server:

yaml

searchers:
  qgis:
    _type: Septima.Search.OwsUtils.Searcher
    _options:
      url: https://gis.min-kommune.dk/ows?VERSION=1.1.0&MAP=/data/dmp-lagkatalog/server.qgz
    detailhandlers:
      - _type: Septima.Search.OwsUtils.InfoHandler

Aktivér med - _ref: $.searchers.qgis i controller.searchers.

S4Index — SpatialSuite

Importér s4index og sæt host i params.yml:

yaml

import:
  sections:
    - name: s4index
      dir: $.env.libDir/lib/standardkommune

parameters:
  s4Index:
    host: http://<s4-server>:8080
    datasources: "*"      # "*" for alle, eller en liste af datasource-navne

Aktivér med - _ref: $.s4Index i controller.searchers.

ArcGIS REST

Definér en searcher der peger på en ArcGIS REST-service:

yaml

searchers:
  arcgis:
    _type: Septima.Search.ArcGisSearcher
    _options:
      source: minkommune
      catalogUrl: https://kort.min-kommune.dk/rest/services/
      serviceName: DIVERSE/Weblager
      layers: "Weblager"
      resultTypes:
        Weblager:
          singular: Byggesag
          plural: Byggesager

Aktivér med - _ref: $.searchers.arcgis i controller.searchers.

Fejlfinding

Symptom	Hvad skal du tjekke?
Søgningen vises ikke i dropdown'et	Den er ikke tændt — tilføj `- _ref: $.<bibliotek>.<navn>` i `controller._options.searchers`.
Serveren fejler ved opstart med "…doesn't exist"	En `import.sections`-post mangler. Tjek `name` (uden `.yml`) og `dir`.
Standardsøgningerne giver ingen hits	`parameters.kommunekode` er tom, eller `standardkommune` er ikke importeret.
`ejendomme` eller `bbr` fejler ved opslag	Datafordeler-credentials eller certifikat er forkert. Tjek `username`, `password`, `certifikat.passphrase` og at `.p12`-filen ligger i `dir`.
OWS/ArcGIS/S4 returnerer 404 eller timeout	URL'en svarer ikke. Test endpointet i en browser og tjek netværk/firewall.
YAML giver parse-fejl	Tjek indrykning og bindestreger — `controller._options.searchers` skal være en liste hvor hvert element starter med `- _ref: ...`.

Sådan opsætter du søgninger i OneDoor ​

Hvor konfigureres søgningerne? ​

Aktivér en standard-søgning ​

1. Importér biblioteket i config.yml ​

2. Sæt kommunekode og targets i params.yml ​

3. Tænd søgningerne i config.yml ​

Søgninger der kan konfigureres ​

Standard — kommer med standardkommune-import ​

Tilvalg — kræver ekstra import ​

Eksterne kilder — kræver URL i params.yml ​

Parametre per søgning ​

gsearch.targets ​

plansystem.targets ​

POI — poi.token, poi.hovedtyper, poi.undertyper ​

Ejendomme og BBR — datafordeler.* ​

Tingbog — Septimas service ​

Tinglysning — GeoPartner ​

DMP — datakatalog ​

Eksterne kilder ​

OWS / QGIS Server ​

S4Index — SpatialSuite ​

ArcGIS REST ​

Fejlfinding ​

Sådan opsætter du søgninger i OneDoor

Hvor konfigureres søgningerne?

Aktivér en standard-søgning

1. Importér biblioteket i `config.yml`

2. Sæt kommunekode og targets i `params.yml`

3. Tænd søgningerne i `config.yml`

Søgninger der kan konfigureres

Standard — kommer med `standardkommune`-import

Tilvalg — kræver ekstra import

Eksterne kilder — kræver URL i `params.yml`

Parametre per søgning

`gsearch.targets`

`plansystem.targets`

POI — `poi.token`, `poi.hovedtyper`, `poi.undertyper`

Ejendomme og BBR — `datafordeler.*`

Tingbog — Septimas service

Tinglysning — GeoPartner

DMP — datakatalog

Eksterne kilder

OWS / QGIS Server

S4Index — SpatialSuite

ArcGIS REST

Fejlfinding