DSO Viewer APIs — Presentatie¶

Documentatie in ontwikkeling

De Nederlandse vertaling van deze pagina is nog niet beschikbaar. Raadpleeg de Engelse versie voor de huidige inhoud. De dia's zelf zijn Engelstalig.

Een technische presentatie van twaalf dia's over de manier waarop de DSO Viewer in LDE met het Digitaal Stelsel Omgevingswet communiceert: de proxylaag, de vijf bovenliggende API's, welke aanroepen elk tabblad doet, en de openstaande punten. Zie DSO-integratie voor dezelfde stof in lopende tekst.

Downloaden

DSO Viewer APIs Deck (PDF, 121 KB)

De presentatie wordt gegenereerd in de linked-data-explorer-repository (docs/) en hier gekopieerd. Deze versie is die van 24 augustus 2026, bij LDE v2026.08.3.

Architectuur¶

Dia 1 van 12, titeldia: DSO Viewer — API Reference, met onderaan drie kengetallen — 5 bovenliggende DSO-API's, 12 LDE-proxyendpoints, 2 omgevingen die met één header worden geschakeld — Vijf API's, twaalf proxyendpoints, twee omgevingen

Dia 2 van 12, het aanroeppad: DsoExplorer.tsx naar dsoService.ts naar de LDE-proxy op /v1/dso/* naar dso.service.ts naar het DSO — de frontend benadert het DSO nooit rechtstreeks — Elk verzoek loopt via de LDE-backend

Dia 3 van 12, wat de proxylaag oplevert: de API-sleutel blijft server-side, één header (X-Dso-Env) schakelt tussen pre-productie en productie, en HAL-antwoorden worden ongewijzigd doorgegeven binnen de success-data-envelop — Sleutel, omgeving en payload — de drie redenen voor de proxy

De vijf bovenliggende API's¶

Dia 4 van 12, vijf bovenliggende DSO-API's met hun paden: Stelselcatalogus, RTR Gegevens, Zoekinterface, Opvragen Werkzaamheden en Toepasbare Regels Uitvoeren Gegevens — De vijf API's achter één `/v1/dso`-oppervlak

Dia 5 van 12, drie tabbladen en vijf API's: Concepts gebruikt API 1, Werkzaamheden gebruikt API 3 voor zoeken en suggesties en API 4 voor versiedetail, Activities gebruikt API 2 voor lijst en detail en API 5 voor het regelpaneel — Welk tabblad welke API aanroept — Werkzaamheden gebruikt er twee

Activiteiten en de fan-out¶

Dia 6 van 12, activiteiten laden in twee modi: op datum (per 20 gepagineerd) of op bevoegd gezag via de OIN-presets, waarbij één aanroep met pageSize=200 de volledige set ophaalt zodat het naamfilter client-side werkt — Twee laadmodi: op datum, of de hele set van één bevoegd gezag

Dia 7 van 12, een activiteit openen kost 1 + N verzoeken: de RTR levert onderliggende activiteiten als kale links zonder omschrijving, dus het paneel vraagt elke onderliggende activiteit apart op — 24 aanroepen voor Bedrijfsactiviteiten met 23 kinderen, zonder cache en zonder limiet op gelijktijdigheid — De zwaarste interactie in de viewer — `1 + N` aanroepen, alleen voor namen

Toepasbare regels¶

Dia 8 van 12, van regelbeheerobject naar regelbestand: geselecteerde activiteit, regelBeheerObjecten, functioneleStructuurRef en identifier — en daarna één upstream-endpoint met drie acties (STTR downloaden, DMN extraheren, formulierscaffold genereren) — Eén STTR-download, drie verschillende bewerkingen

Dia 9 van 12, vijf correcties maken STTR-uitvoer uitvoerbaar: DMN 1.2 naar 1.3, ontbrekende id's, FEEL-veilige variabelenamen, typeRef op ongetypeerde uitvoer en camunda:historyTimeToLive per beslissing — Wat `normalizeDmnForOperaton` aanpast

Dia 10 van 12, een DMN publiceren is een overdracht en geen opslag: LDE heeft geen eigen DMN-opslag, dus de deep link naar de CPSV Editor draagt alleen identificatoren en de CPSV Editor haalt de XML zelf op bij dezelfde backend — De deep link draagt identificatoren; de CPSV Editor haalt de XML zelf op

Status en vervolg¶

Dia 11 van 12, bekende losse eindjes: zoeken op geometrie is gebouwd maar niet ontsloten in de UI, geldigOp op begripzoeken heeft geen invoerveld, en de fan-out heeft geen cache — Drie bekende gaten: twee onbereikbare functies en één prestatierisico

Dia 12 van 12, vervolgstappen: kaart- en puntselectie, de fan-out memoïseren, meer bevoegde gezagen dan de vier presets, geldigheidsdatum in de UI, en een eigen timeout en defaults voor productie — Vijf vervolgstappen, in de volgorde die de presentatie voorstelt