Skip to content

DSO Explorer

A step-by-step walkthrough for searching the Digitaal Stelsel Omgevingswet from inside LDE and linking the result to a BPMN subprocess. For the architectural overview and API surface, see DSO Integration.

Before you start

  • Open LDE and navigate to the DSO Explorer view in the sidebar (the globe icon).
  • Decide which DSO environment you need. Most authority data is published in pre-production first; production carries the authoritative live ruleset. Test anchors per environment are listed in DSO Integration Phase Plan.
  • Confirm the environment in Settings → DSO environment. The header badge turns amber for pre-production, green for production.

Screenshot: Settings panel open over the DSO Explorer with the DSO environment section visible — two radio options labelled Pre-production (default) and Production, with the Pre-production radio currently selected

Switching the DSO environment in Settings

The setting persists in localStorage — closing and reopening LDE keeps the same environment.

Workflow 1 — Find a werkzaamheid by citizen-facing name

Use this when you know the public name of the task (the term a citizen would use on the Omgevingsloket) but not the underlying URN.

  1. Open the Works tab.
  2. Start typing — autocomplete suggestions appear after two characters. The list is sorted by meestGekozen, so the most-used Omgevingsloket terms surface first.
  3. Pick a suggestion or hit Enter to run the full search.
  4. Click a result to open the detail panel. The panel shows the current version's omschrijving, validity period, and the full version history with start/end dates. (Search and autocomplete come from the Zoekinterface; the detail panel is a separate call to the Opvragen Werkzaamheden API.)

Screenshot: Works tab showing the detail panel open for a selected werkzaamheid — heading with the omschrijving, a metadata row with begindatum and a current badge, the functioneleStructuurRef URI on its own line, and below that a Version history section with three rows each showing a date range and one marked current

Werkzaamheid detail panel with version history

The functioneleStructuurRef URI on each result is the pivot to the STTR file used by the Phase 4 rule extraction (see Workflow 4 below). Copy it now if you'll be linking it to a BPMN subprocess later.

Workflow 2 — Browse activiteiten by authority

Use this when you know which authority publishes the activity (e.g. gemeente Lelystad) and want to see what they have on a given date.

  1. Open the Activities tab.
  2. Pick an authority preset — Lelystad, Flevoland, Ede or Gelderland. Ede (municipality) and Gelderland (province) were added in v2026.08.0. The same preset list drives both this filter and the authority name shown when importing a form.
  3. The date input defaults to today; change it if you need a historical view.
  4. Click Load. The list refreshes with that authority's activiteiten valid on the selected date.

Each card shows badges for which rule types are present:

  • Conclusie — DMN decision content available
  • Indieningsvereisten — application questionnaire available
  • Maatregelen — textual measures available

The badges tell you ahead of time which downstream LDE assets the activity can support.

  1. Click an activity card to open the detail panel.

Activities with many children take a moment to open

The RTR hands LDE only a list of links for an activity's child activities, with no names attached, so the panel looks each child up individually — one request per child, fired in parallel, on top of the request for the activity itself. Opening an activity with 23 children means 24 calls. Children whose lookup fails or that come back nameless are shown as their raw URN instead of a name; they are still clickable. Nothing is cached, so re-opening the same activity fetches it all again.

Screenshot: Activities tab with the Lelystad preset selected, todays date shown in the date input, and a list of activity cards beneath — each card has the omschrijving, validity from-date, and small green pill badges for the rule types present, with the Bed & Breakfast starten card highlighted to show it has both Conclusie and Indieningsvereisten

Activities filtered by Lelystad with rule-type badges

Workflow 3 — Verify a URN you already have

Use this when someone has handed you a DSO URN and you need to confirm it resolves and see what it points to.

  1. Open a BPMN process in the BPMN Modeler.
  2. Scroll to the DSO Activity section in the footer panel.
  3. Paste the URN into the input. The button next to it changes from Verify to Save as soon as the text differs from what is stored — it is one button doing both jobs.
  4. Click it. The URN is written to the process straight away, and LDE then queries the live DSO RTR — always the pre-production one. (A URN already stored on the process is re-verified automatically whenever the panel opens.)
  5. On success, a teal info card appears below showing the omschrijving, the authority block, and a link icon that opens the URN in the public DSO RTR viewer.
  6. On 404, a red error appears: "URN not found in DSO".
  7. The URN is persisted as ronl:dsoActiviteitUrn on the BPMN process when you click Save in the canvas toolbar.

This panel ignores the DSO environment setting

Unlike the DSO Explorer, the BPMN DSO Activity selector always queries pre-production. Switching to production in Settings changes nothing here, so a production-only URN — for example nl.imow-gm0995.activiteit.HoutopstandVellen — will always report "URN not found in DSO". Confirm such a URN in the DSO Explorer's Activities tab (with the toggle on production), then paste it in and save it without verification.

Screenshot: BPMN Modeler with the footer DSO Activity section showing a URN field with a Lelystad URN entered, the Verify button just clicked, and below it the teal verification card showing the activity omschrijving, the authority block on three lines (gemeente Lelystad GM 0995), and an external-link icon link to the RTR viewer

Verifying a URN against the live DSO RTR

The URN is stored as typed, whether or not verification succeeded — verification is a check, not a gate.

Workflow 4 — Extract an activity's rules into LDE (Phase 4)

Use this to turn a DSO activity's toepasbare regels into LDE assets. Open the activity's detail panel (Workflow 2 or 3) and find the Applicable Rules section, which lists the rules grouped by type (Conclusie / Indieningsvereisten) with validity date and STTR version.

  • ↓ STTR — download the raw STTR XML for any rule type.
  • ↓ Extract DMN (Conclusie) — download the embedded decision table as a standalone, deploy-ready .dmn (normalized to DMN 1.3 with FEEL-safe names, output typeRefs and camunda:historyTimeToLive, so it deploys and evaluates on Operaton as-is).
  • ↓ Form scaffold (Indieningsvereisten) — download a form-js JSON scaffold generated from the questionnaire.
  • ↓ Import into LDE (Indieningsvereisten) — save that scaffold straight into the Form Editor as a draft, tagged with the authority name and a green DSO badge — no manual download/import.
  • Publish via CPSV Editor (Conclusie) — open the CPSV Editor with a deep-link to publish the extracted DMN to TriplyDB, where the LDE DMN picker (Chain Builder) can consume it.

Common situations

An activity card has only Indieningsvereisten — no Conclusie. That activity has questionnaire logic but no full decision model. You can still link it to a BPMN subprocess and generate a form scaffold from it, but there is no DMN to extract.

The detail panel shows "not available in this environment". The URN was queried with the wrong DSO environment toggle. Switch in Settings and try again.

A werkzaamheid result shows no ref: line. The Zoekinterface didn't return a functioneleStructuurRef for that werkzaamheid version. Try a different version from the version history, or contact the publishing authority — the activity may not yet carry a structuur reference.

Some child activities show as long URNs instead of names. Their individual name lookup failed or returned no omschrijving. The links still work — click through and the child's own detail panel will load.

Authority preset Load button gives an empty list. Either the authority has no activities for that date, or the date is outside the validity windows of all activities. Try a recent date close to today.