Verschillen

Dit geeft de verschillen weer tussen de geselecteerde revisie en de huidige revisie van de pagina.

--- openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:dso_gemiste_verzoeken [2025/07/01 10:55] – ↷ Pagina verplaatst van openwave:1.32:applicatiebeheer:probleemoplossing:programmablokken:dso_gemiste_verzoeken naar openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:dso_gemiste_verzoeken Kars Gottschal
+++ openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:dso_gemiste_verzoeken [2025/08/11 13:48] (huidige) – Marc Pullens
@@ Regel 1: / Regel 1: @@
 ====== DSO Gemiste Verzoeken ======
-De lijst met DSO gemiste verzoeken is zichtbaar via de tegel //DSO gemiste verzoeken// in de kolom Notificaties van het servicecentrum-portaal. De lijst wordt getoond op basis van de tabel //tbgemisteverzoeken//. De lijst bestaat uit DSO-zaken (STAM-berichten) die opgenomen zouden moeten zijn in de OpenWave implementatie (op grond van bevoegd gezag of behandeldienst), maar dat niet zijn.
+De lijst met DSO gemiste verzoeken is zichtbaar via de tegel //DSO gemiste verzoeken// in de kolom Notificaties van het servicecentrum-portaal. De lijst wordt getoond op basis van de tabel //tbgemisteverzoeken//. De lijst bevat DSO-zaken (STAM-berichten) die, op grond van bevoegd gezag of behandeldienst, aanwezig zouden moeten zijn in de OpenWave-implementatie, maar nog niet zijn opgehaald of verwerkt.
-De tabel wordt periodiek aangevuld indien zo ingesteld via de taskscheduler (beheerportaal-nieuw: kolom: //Dieper beheer//) door de aanroep van de callable //importDSOGemisteVerzoeken//.
+De tabel wordt periodiek aangevuld (indien zo ingesteld via de Taskscheduler in het beheerportaal-nieuw: kolom: //Dieper beheer//) door de aanroep van de callable //importDSOGemisteVerzoeken//.
-Voor het ophalen van gerelateerde verzoeken bij een omgevingzaak (verzoeken die door een ander bevoegd gezag of behandeldienst worden behandeld, maar wel spelen op dezelfde locatie): Zie: [[openwave:1.32:applicatiebeheer:probleemoplossing:programmablokken:dso_gerelateerde_zaken]].
+Voor het ophalen van gerelateerde verzoeken bij een omgevingzaak (verzoeken die door een ander bevoegd gezag of behandeldienst worden behandeld, maar wel spelen op dezelfde locatie): Zie: [[openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:dso_gerelateerde_zaken]].
 ===== Ophalen en verwerken gemiste verzoeken =====
 ==== Noodzakelijke instellingen: ====
-  * Algemeen endpoint van de DSO-API verzoekafhandelen. Gedefinieerd in de instelling kolom //Tekst// van //Sectie: DSO en Item: DSO-Verzoekafhandelen// bijvoorbeeld: ''https://pkio.service.pre.omgevingswet.overheid.nl:443/overheid/verzoeken/api/afhandelen/v2''
+  * Algemeen endpoint van de DSO-API verzoekafhandelen. Gedefinieerd in de instelling kolom //Tekst// van //Sectie: DSO-VerzoekRaadplegen en Item: AlgemeenEndpoint// bijvoorbeeld: ''https://pkio.service.pre.omgevingswet.overheid.nl/overheid/verzoekenoverzicht/api/raadplegen/v1/''
-  * Datumrange. Alleen verzoeken worden opgehaald die jonger zijn dan de systeemdatum minus //Aantal dagen terug// in de kolom //Getal1// van de instelling //Sectie: DSO-Verzoekafhandelen en Item: AantalDagenTerugGemisteVerzoeken//.
+  * OIN-nummer(s). De callable werkt op basis van OIN-nummers waarvoor de implementatie bevoegd is. Deze worden samengesteld uit:
-  * Geografisch gebied. Het geografisch gebied wordt gedefinieerd door de kolom //Tekst// van instelling //Sectie: DSO-Verzoekafhandelen en Item: PolygoonGemisteVerzoeken//. Dit moet een polygoon zijn in rijksdriehoek van x- en y-coördinaten:, waarbij het eerste paar gelijk is aan het laatste paar. X en y gescheiden door een komma en de paren gescheiden door een spatie. Bijvoorbeeld: //75000,550000 125000,550000 125000,515000 75000,515000 75000,550000//.
+    * De kolom //Tekst// van instelling //Sectie: SWF en Item: OINvanZender// of
+    * Eventuele extra OIN-nummers in kolom //Info// van instelling //OINvanZender// (bijv. situatie WDW of BEL-gemeenten), gescheiden door **;** (puntkomma)
-Het polygoon moet grosso modo het grondgebied bevatten van de OpenWave implementatie: dus bijvoorbeeld dat van een gemeente, of een provincie of een omgevingsdienst.
+    * In geval van een compartiment het veld //OIN-nummer van compartiment t.b.v. aanmaken SWF-ruimte? (tbcompartiment.dvswfoinzender)// in detailscherm van de compartimentsinstellingen. Er zijn meerdere mogelijk, ook gescheiden door een **;**.
-  * OIN-nummer dat hoort bij de OpenWave implementatie dat gewhitelist is op het REM-certificaat waarmee de DSO API-aanroep wordt geautoriseerd. De kolom //Tekst// van instelling //Sectie: SWF en Item: OINvanZender// of, in geval van compartiment het veld //OIN-nummer van compartiment t.b.v. aanmaken SWF-ruimte?
+  * Datumrange. Alleen verzoeken worden opgehaald die jonger zijn dan de systeemdatum minus het //Aantal dagen terug// in de kolom //Getal1// van de instelling //Sectie: DSO-Verzoekafhandelen en Item: AantalDagenTerugGemisteVerzoeken//.
-// in detailscherm van compartimentsinstellingen.
 ==== Proces ophalen gemiste verzoeken ====
-De callable //importDSOGemisteVerzoeken// roept de DSO-API //verzoeken_zoek// aan op het algemene endpoint met in het POST-bericht (in de body) het geografische gebied en de ingestelde datumrange.\\
+De callable importDSOGemisteVerzoeken doorloopt de lijst met OIN-nummers. Voor ieder OIN-nummer wordt een GET-aanroep gedaan op het algemene endpoint. De DSO-API retourneert alle zaakverwijzingen binnen de opgegeven datumrange waarvoor het bevoegd gezag of de behandeldienst overeenkomt met het opgevraagde OIN.
-Gezien de mogelijk grote geretourneerde resultset uit het DSO wordt de aanvraag gedaan in pages van 50 stuks. De DSO-API retourneert alle zaakverwijzingen binnen de opgeven datumrange waarvan de coördinaten van de project locatie vallen binnen het opgegeven grondgebied. Alles wat niet voor de OpenWave implementatie is moet er nog uitgefilterd worden. De afhandeling door OpenWave per geretourneerde zaakverwijzing is als volgt:
+De afhandeling door OpenWave per geretourneerde zaakverwijzing is als volgt:
   *  Bestaat het verzoeknummer van de geretourneerde zaakverwijzing als zaak in tbomgvergunning
       * Zo ja, dan: Gaat het om intrekken of aanvullen?
@@ Regel 52: / Regel 52: @@
 **Noodzakelijke instellingen**
-  * Algemeen endpoint van de DSO-API verzoekafhandelen. Gedefinieerd in de instelling kolom //Tekst// van //Sectie: DSO en Item: DSO-Verzoekafhandelen// bijvoorbeeld: ''https://pkio.service.pre.omgevingswet.overheid.nl:443/overheid/verzoeken/api/afhandelen/v2''
+  * Algemeen endpoint van de DSO-API verzoekafhandelen. Gedefinieerd in de instelling kolom //Tekst// van //Sectie: DSO en Item: DSO-Verzoekafhandelen// bijvoorbeeld: ''https://pkio.service.pre.omgevingswet.overheid.nl/overheid/verzoeken/api/afhandelen/v3''
   * OIN-nummer dat hoort bij de OpenWave implementatie dat gewhitelist is op het REM-certificaat waarmee de DSO API-aanroep wordt geautoriseerd. De kolom //Tekst// van instelling //Sectie: SWF en Item: OINvanZender// of, in geval van compartiment het veld //OIN-nummer van compartiment t.b.v. aanmaken SWF-ruimte?
 // in detailscherm van compartimentsinstellingen.
     * Let op: het kan zijn dat er een andere OINvanZender van toepassing is, dit indien er met meer dan 1 organisatie wordt gewerkt in OpenWave;
-        *  kolom //Info// van instelling //Sectie: SWF en Item: OINvanZender// bevat 1 of meer OIN-nummers gescheiden door ;
+        * kolom //Info// van instelling //Sectie: SWF en Item: OINvanZender// bevat 1 of meer OIN-nummers gescheiden door ;
         * en/of er bij het compartiment meer dan 1 OIN nummer bestaat: veld //OIN-nummer van compartiment t.b.v. aanmaken SWF-ruimte?// bevat meer dan 1 OIN-nummer gescheiden door ;
     *  Indien er meer dan 1 OIN is waarvoor men Gemiste verzoeken wilt ophalen zal er bij het starten van de wizard gevraagd worden namens welke organisatie het gemiste verzoek opgehaald moet worden.
-  * Gewenste STAM versie van het op te halen Gemiste verzoek (vanaf 1.31). Gedefinieerd in de instelling kolom //Tekst// van //Sectie: DSO-VerzoekAfandelen en Item: STAMVersie//. Wordt bij de update naar 1.31 aangemaakt met //Tekst// = **4**. Dat betekent dat STAM 4 wordt gevraagd. Als men over is naar STAM 5 dan kan daarna deze instelling gewijzigd worden naar //Tekst// = **5**. Indien deze instelling niet bestaat dan wordt door DSO het gemiste verzoek in de oudst geldende versie van STAM meegegeven. Huidig is dat STAM 3. Vandaar dat met update naar 1.31 deze instelling aan wordt gemaakt om te voorkomen dat nog in STAM 3 wordt opgehaald.
+  * Gewenste STAM versie van het op te halen Gemiste verzoek (vanaf 1.31). Gedefinieerd in de instelling kolom //Tekst// van //Sectie: DSO-VerzoekAfandelen en Item: STAMVersie//. Wordt bij de update naar 1.31 aangemaakt met //Tekst// = **4**. Dat betekent dat STAM 4 wordt gevraagd. Als men over is naar STAM 5 dan kan daarna deze instelling gewijzigd worden naar //Tekst// = **5**. Indien deze instelling niet bestaat dan wordt door DSO het gemiste verzoek in de oudst geldende versie van STAM meegegeven. Huidig is dat STAM 4.
 ==== Ophalen STAM-bericht ====
-Op het algemene endpoint wordt de API //verzoeken/’ + Verzoeknummer + ’/samenvatting’// aangeroepen waarbij //verzoeknummer// wordt gevuld door het DSO-verzoeknummer van het betreffende gemiste verzoek. Indien het OIN-nummer gerechtigd is, dan retourneert het DSO het originele STAM-bericht.
+Op het algemene endpoint wordt de API //verzoeken/’ + Verzoeknummer + ’/samenvatting’// aangeroepen waarbij //verzoeknummer// wordt gevuld door het DSO-verzoeknummer van het betreffende gemiste verzoek. Indien het OIN-nummer gerechtigd is, dan retourneert het DSO het originele STAM-bericht. Hierbij gelden de bestaande instellingen voor STAM-versie en OIN-nummer.
-Indien zowel de instelling //Sectie: OWB, Item: MessageLog// als de instelling //Sectie: DSO en Item: messagelog_importgerelateerdezaken// aangevinkt is, dan wordt deze vraag en antwoord gelogd.
+Indien zowel de instelling //Sectie: OWB, Item: MessageLog// als de instelling //Sectie: DSO en Item: messagelog_importgerelateerdezaken// aangevinkt is, dan worden de vraag en het antwoord gelogd.
 Bij succes wordt de betreffende regel in tbgemisteverzoeken weggehaald en wordt het STAM-bericht in de eigen OpenWave API
- //VerwerkDSOstambericht// geschoten. Daar vindt de verwerking plaats conform de beschrijving [[openwave:1.32:applicatiebeheer:probleemoplossing:programmablokken:verwerking_dso_stam_berichten]].
+ //VerwerkDSOstambericht// geschoten. Daar vindt de verwerking plaats conform de beschrijving [[openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:verwerking_dso_stam_berichten]].