Tilføj adressesøgning og resultatside

Dette eksempel viser hvordan du udvider en eksisterende OneDoor-konfiguration med:

1. En adressesøgning, så brugeren kan finde adresser i søgefeltet, og
2. En resultatside med faner, der vises når brugeren klikker på en adresse — med husnummer-oplysninger, BBR, administrative inddelinger og skråfotos.

Forudsætning

Du har en kørende OneDoor med mindst én eksisterende konfiguration. Se Installation hvis du mangler installationen, og Opret ny profil hvis du skal lave en helt ny konfiguration først.

Resultatet

Brugeren skriver fx "Rådhuspladsen 1, København" og får adressen som resultat. Et klik åbner en resultatside med fire faner:

Fane	Indhold
Husnummer	Oplysninger om selve adressen
BBR	Bygning og enhed på adressen
Administrativ inddeling	Sogn, retskreds, politikreds m.fl.
Skråfotos	Skråfotos fra Dataforsyningen

Find din konfiguration

Konfigurationen ligger under config/organisations/<din-organisation>/configurations/<din-konfiguration>/ og består typisk af config.yml og params.yml. Alle ændringer i dette eksempel laves i de to filer.

Trin 1 – Sørg for at standardkommune er importeret

OneDoor leveres med biblioteket standardkommune der indeholder en færdig DAWA-søger og et katalog af genbrugelige faner. Åbn config.yml og tjek at toppen indeholder importet:

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

Hvis standardkommune-linjen mangler, så tilføj den. Tjek også at params.yml har en kommunekode:

parameters:
  kommunekode: "0101"     # København. Brug "*" for hele landet.

Trin 2 – Tilføj adresse søgeren

Søgningerne er listet i controller._options.searchers i config.yml. Tilføj linjen for DAWA — sørg for at den peger på $.searchers.dawa :

controller:
  _type: Septima.Search.Controller
  _options:
    blankBehavior: search
    searchers:
      # ... eksisterende søgninger ...
      - _ref: $.searchers.dawa     # ← tilføj denne linje

Definér derefter dawa-søgeren under searchers::

searchers:
  # ... eksisterende searchers ...
  dawa:
    _ref: $.standardkommune.dawa

På dette tidspunkt virker selve søgningen — brugeren kan finde adresser. Men resultatsiden er tom. Trin 3 viser hvordan man tilføjer resultat sider og yderligere faner til resultatet.

Trin 3 – Tilføj faner til resultatsiden

Resultatsidens faner kaldes detailhandlers og placeres direkte under søgeren. Udvid dawa-blokken fra Trin 2:

searchers:
  dawa:
    _ref: $.standardkommune.dawa
    detailhandlers:
      - _ref: $.standardkommune.detailhandlers.omHusnummeret
      - _ref: $.standardkommune.detailhandlers.bbrEnhedInfo
      - _ref: $.standardkommune.detailhandlers.dagiInfo
      - _ref: $.standardkommune.detailhandlers.skraafoto

Rækkefølgen i detailhandlers: er rækkefølgen brugeren ser fanerne i. Du kan til enhver tid omarrangere, fjerne eller tilføje linjer.

Flere standardfaner findes

standardkommune.detailhandlers indeholder også sqPlaner, sqJordstykker, bbrInfoOgSager, ejendomsInfo m.fl. Se Detaljefaner for det fulde katalog.

Trin 4 – Genindlæs og test

1. Genindlæs konfigurationen på serveren.
2. Åbn din konfiguration i browseren.
3. Skriv en adresse i søgefeltet.
4. Vælg adressen i resultatlisten.
5. Bekræft at resultatsiden viser de fire faner du tilføjede.

Næste skridt

• Tilføj flere søgninger (matrikler, planer, ejendomme, BBR, CVR …): Søgninger
• Tilpas en fane eller lav din egen fra bunden: Detaljefaner
• Vis dine egne data som kortlag: Lagvælger