Je kunt via de API extra informatie meesturen, zoals auteur, publicatiedatum of contenttype. Deze metadata wordt zichtbaar bij documenten in de kennisbank en kan ook aan de voorkant worden getoond. Zo kun je zoekresultaten opmaken met een herkenbare layout waarin direct de belangrijkste details te zien zijn.

Volg de stappen om metadata door te sturen via de API, te koppelen en zichtbaar te maken aan de voorkant. De configuratie bestaat uit vier stappen:

Stap 1: instellen via (Drupal Search) API

• Toepasbaar met de API (niet via crawling).

• Ingebouwd in de Drupal Search API-module.

• Koppel de juiste velden aan de metadata die je wilt meesturen.

Tip: gebruik duidelijke systeemnamen. Deze koppelen we aan vragen.ai en zijn daar zichtbaar als metadata.

Je kunt dit ook via je eigen API-koppeling instellen; de werkwijze is dan anders, maar het principe blijft gelijk.

Stap 2: instellen in vragen.ai

Voor elk nieuw veld dat je via de API meestuurt, maak je in vragen.ai een nieuw metadata-veld aan onder Instellingen.

Bij het toevoegen:

• Gebruik als naam de systeemnaam uit de API.

• Kies het juiste type, dit bepaalt de weergave:

  • Text

  • Number

  • Date (datum)

  • Boolean (ja/nee)

• Voeg eventueel een beschrijving toe.

• Stel eventueel een default value in voor documenten zonder deze metadata.

• Vink Is multiple aan als een veld meerdere waarden kan bevatten (bijv. meerdere auteurs).

Bestaande documenten krijgen metadata niet automatisch met terugwerkende kracht.

Start een herindex vanuit de API om ontbrekende metadata toe te voegen. Neem contact op als je hulp wilt bij deze herindexatie.

Stap 3: metadata tonen bij zoekresultaten

Ga naar Mijn integraties en bewerk de gewenste integratie. Onder Semantisch zoeken vind je Zoekresultaatvelden. Als dit leeg is, wordt de standaardweergave gebruikt (titel en korte beschrijving).

• Klik op Voeg veld toe aan zoekresultaten.

• Selecteer per veld de gewenste metadata en geef optioneel een label, bijvoorbeeld: Auteur: [metadata].

• Pas de volgorde aan zoals je wilt dat deze wordt weergegeven.

De wijzigingen worden binnen circa 15 minuten zichtbaar.

Stap 4: layout aanpassen

We hanteren een standaardlayout. Wil je hiervan afwijken, dan kun je de weergave aan websitezijde aanpassen via custom CSS.