openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:verwerking_stuf_overdragenzaak

Verschillen

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

Link naar deze vergelijking

Beide kanten vorige revisie Vorige revisie
Volgende revisie		 Vorige revisie
openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:verwerking_stuf_overdragenzaak [2025/08/13 15:45] – Ton Pullensopenwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:verwerking_stuf_overdragenzaak [2025/08/21 15:04] (huidige) – [Verwerking StUF Zaak/dms 1.2 Overdragen Zaak] Cecilio do Rosario
Regel 2: Regel 2:
 {{tag>openwave:1.33:applicatiebeheer:functionaliteiten:stuf_zaak_dms}} {{tag>openwave:1.33:applicatiebeheer:functionaliteiten:stuf_zaak_dms}}
  
-Vanuit een DMS kan een verzoek gedaan worden aan OpenWave om een zaak aan te maken. Hieronder een beschrijving van welke berichten daartoe uitgewisseld moeten worden, welke instellingen aan OpenWave-kant noodzakelijk zijn en welke onderdelen van het antwoord op geefZaakDetails door OpenWave verwerkt worden.+Vanuit een DMS kan een verzoek gedaan worden aan OpenWave om een zaak aan te maken. Hieronder een beschrijving van welke berichten daartoe uitgewisseld moeten worden, welke instellingen aan OpenWave-kant noodzakelijk zijn en welke onderdelen van het antwoord op geefZaakDetails door OpenWave verwerkt worden.\\ 
 +Naast de noodzakelijke instellingen geldt: 
 +  * het externe zaaktype van de overgedragen zaak moet gemapt zijn in openwave (tbsoortomgverg of tbsoortovverg) 
 +  * er moet een intiator (aanvrager) overgedragen worden  
 +  * de zaak moet nog niet bestaan
  
-=====Endpoint en beveiliging via certificaten===== +=====Endpoint en beveiliging via certificaten, whitelist===== 
-Het externe zaaksysteem/dms roept het SOAP-endpoint //**base-url/**api/stuf/ontvangasynchroon// van OpenWave aan met het verzoekbericht //overdragenZaak_Di01//.\\ +Het externe zaaksysteem/dms roept het SOAP-endpoint //**base-url/**api/stuf/ontvangAsynchroonOverdragen// van OpenWave aan met het verzoekbericht //overdragenZaak_Di01//.\\ 
-Een base-URL is een implementatie van OpenWave zoals bijvoorbeeld <nowiki>https://acceptatie.rommeldam.open-wave.nl</nowiki>.+Een base-URL is een implementatie van OpenWave zoals bijvoorbeeld <nowiki>https://acceptatie.rommeldam.open-wave.nl</nowiki>.\\ 
 +De wsdl van het endpoint is bereikbaar op //**base-url**/api/stuf/ontvangAsynchroonOverdragen.wsdl//
  
-De OpenWave StUF webservice op dat SOAP-endpoint  maakt gebruik van 2-way SSL. Dus de eerste authenticatie gebeurt volledig op serverniveau door middel van uitwisseling van certificaten onder het TLS1.2 encryptieprotocol en is geen onderdeel van deze handleiding.+De OpenWave StUF webservice op dat SOAP-endpoint  maakt gebruik van 2-way SSL onder het TLS1.2 encryptieprotocol.\\ 
 +De authenticatie gebeurt op endpoint-niveau door controle op IP-adres en aangeleverd client-certificaat: het IP-adres en de fingerprint van het client-certificaat van het externe zaaksysteem/dms wordt door OpenWave gecontroleerd in de tabel tbendpointlist (beheerportaal: zie Endpoints whitelist):  
 +  * In tbendpointlist moet een rij worden gedefinieerd met als endpoint //api/stuf/ontvangasynchroonoverdragen//  (dus zonder base-url). 
 +  * En vervolgens dienen de IP-adressen die toestemming moeten krijgen om de StUF overdragenZaak berichten te posten op dit soap-endpoint te worden toegevoegd (dochtertabel tbipauthorisationlist), waar de fingerprint een onderdeel van de omschrijving kan zijn.
  
 +Indien het bericht van het externe zaak/dms systeem NIET door deze firewall heen komt, wordt de HTTP-code 401 geretourneerd.
 =====Berichtenverkeer===== =====Berichtenverkeer=====
 {{:openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:stufzaakdms_overdagenzaak.png?800|}} {{:openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:stufzaakdms_overdagenzaak.png?800|}}
  
 ====Stap 1A en 1B: overdragenZaak_Di01==== ====Stap 1A en 1B: overdragenZaak_Di01====
-Indien het bericht van het externe zaak/dms systeem door de firewall heen is, antwoord Openwave ongezien op het overdragenZaak_Di01- bericht met een Bv03 (bevestigings-)bericht. \\+Indien het bericht van het externe zaak/dms systeem NIET door de firewall heen komt, wordt de HTTP-code 401 geretourneerd.\\ 
 +Indien het bericht van het externe zaak/dms systeem WEL door de firewall heen is, antwoord Openwave ongezien op het overdragenZaak_Di01- bericht met een Bv03 (bevestigings-)bericht. \\
 Beide berichten worden opgeslagen in de messagelog-tabel onder de rubriek: //DMS overdragenZaak// mits de instellingen //sectie Koppeling ZAAK en item: Messagelog// EN de instelling //Sectie: OWB en Item: MessageLog// aangevinkt staan.  Beide berichten worden opgeslagen in de messagelog-tabel onder de rubriek: //DMS overdragenZaak// mits de instellingen //sectie Koppeling ZAAK en item: Messagelog// EN de instelling //Sectie: OWB en Item: MessageLog// aangevinkt staan. 
  
Regel 56: Regel 66:
 ====Stap 2A en 2B geefZaakDetails_ZakLv01==== ====Stap 2A en 2B geefZaakDetails_ZakLv01====
 OpenWave vraagt aan het externe Zaak/DMS systeem de zaakgegevens op. Uit het ontvangen //overdragenZaak_diO1// bericht worden twee gegevens gebruikt: de //Zender//: <stuurgegevens><zender><organisatie> en de //Dmszaakidentificatie//: <object><identificatie>.\\ OpenWave vraagt aan het externe Zaak/DMS systeem de zaakgegevens op. Uit het ontvangen //overdragenZaak_diO1// bericht worden twee gegevens gebruikt: de //Zender//: <stuurgegevens><zender><organisatie> en de //Dmszaakidentificatie//: <object><identificatie>.\\
-Op grond van bovenstaand voorbeeld zou de zender-organisatie //Rommeldam// éénmalig moeten voorkomen in de dvloginnaam van de medewerkerstabel.\\ +//ROM123456// in bovenstaand voorbeeld is de identificatie waaronder de zaak in het externe zaak/dms bekend is.\\ 
-De waarde //ROM123456// in bovenstaand voorbeeld is de identificatie waaronder de zaak in het externe zaak/dms bekend is. +//Rommeldam// is daarin de naam van de zender-organisatie. 
  
-De //Zender// wordt opgezocht in de medewerkerstabel in de kolom dvloginnaam: deze robot-medewerker:+De //Zender// wordt opgezocht in de medewerkerstabel in de kolom dvloginnaam. Op grond van bovenstaand voorbeeld zou de zender-organisatie //Rommeldam// dus moeten voorkomen in de dvloginnaam van de medewerkerstabel (en maar één keer). Deze robot-medewerker:
   * heeft geen wachtwoord,    * heeft geen wachtwoord, 
   * heeft geen 2-factor authenticatie    * heeft geen 2-factor authenticatie 
Regel 80: Regel 90:
   * //Zender applicatie// (dvstufzknzenderapp) bijv OpenWave   * //Zender applicatie// (dvstufzknzenderapp) bijv OpenWave
   * //Zender organisatie// (dvstufzknzenderorg) bijv ODRommeldam   * //Zender organisatie// (dvstufzknzenderorg) bijv ODRommeldam
-  * //Ontvanger applicatie// (dvstufzknontvapp) bijv Djuma12 +  * //Ontvanger applicatie// (dvstufzknontvapp) bijv RDApp  (gelijk aan de zender-applicatie uit het binnengekomen overdragenZaak_Di01) 
-  * //Ontvanger organisatie// (dvstufzknontvorg) bijv ODRommeldam+  * //Ontvanger organisatie// (dvstufzknontvorg) bijv Rommeldam  (gelijk aan de zender-organisatie uit het binnengekomen overdragenZaak_Di01)
 En indien het externe zaak/dms dat verlangt kunnen ook de kolommen administratie en gebruiker worden gevuld.\\ En indien het externe zaak/dms dat verlangt kunnen ook de kolommen administratie en gebruiker worden gevuld.\\
 Bovenstaande waarden moeten afgestemd zijn met het externe zaak/dms.\\ Bovenstaande waarden moeten afgestemd zijn met het externe zaak/dms.\\
Regel 105: Regel 115:
 Indien er meerdere gegadigden zijn, dan wordt de eerste de beste gepakt.\\ Indien er meerdere gegadigden zijn, dan wordt de eerste de beste gepakt.\\
 Indien echter geen mapping gevonden voor het zaaktype dan: Indien echter geen mapping gevonden voor het zaaktype dan:
 +  * wordt een kaart in tbmissingconfiguration aangemaakt onder de apinaam: //creeerStufOverdrachtZaak: geefZaakDetails//.
 +  * wordt het slotbericht //overdragenZaak_Du01// naar het ontvangasynchroon endpoint van het externe zaak/dms gestuurd. In dat bericht in de tag <antwoord> de boodschap: overdracht geweigerd.. Het externe zaak/dms antwoord hierop met een Bv03-bericht.
 +  * worden beide berichten gelogd in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen //sectie Koppeling ZAAK en item: Messagelog// EN de instelling //Sectie: OWB en Item: MessageLog// aangevinkt staan.
 +
 +**Bestaat de zaak al?**\\
 +De <identificatie> van het antwoordbericht wordt opgezocht in tbomgvergunning.dvintzaakcode en/of in tbovvergunningen.dvintzaakcode. Indien gevonden dan bestaat de zaak reeds en
   * wordt een kaart in tbmissingconfiguration aangemaakt onder de apinaam: //creeerStufOverdrachtZaak: geefZaakDetails//.   * wordt een kaart in tbmissingconfiguration aangemaakt onder de apinaam: //creeerStufOverdrachtZaak: geefZaakDetails//.
   * wordt het slotbericht //overdragenZaak_Du01// naar het ontvangasynchroon endpoint van het externe zaak/dms gestuurd. In dat bericht in de tag <antwoord> de boodschap: overdracht geweigerd.. Het externe zaak/dms antwoord hierop met een Bv03-bericht.   * wordt het slotbericht //overdragenZaak_Du01// naar het ontvangasynchroon endpoint van het externe zaak/dms gestuurd. In dat bericht in de tag <antwoord> de boodschap: overdracht geweigerd.. Het externe zaak/dms antwoord hierop met een Bv03-bericht.
Regel 172: Regel 188:
  
 **Verzenden slotbericht overdragenZaak_Du01 met succesmelding**\\ **Verzenden slotbericht overdragenZaak_Du01 met succesmelding**\\
-Tot slot wordt het bericht overdragenZaak_Du01 naar het ontvangasynchroon endpoint van het externe zaak/dms gestuurd. In dat bericht in de tag <antwoord> de boodschap: overdracht geaccepteerd en in de tag <melding> de wavezaakcode waaronder de zaak is aangemaakt in OpenWave.\\+Tot slot wordt het bericht overdragenZaak_Du01 naar het ontvangasynchroon endpoint van het externe zaak/dms gestuurd. In dat bericht in de tag <antwoord> de boodschap: overdracht geaccepteerd en in de tag <melding> de wavezaakcode waaronder de zaak is aangemaakt in OpenWave en in de tag <identificatie> het oorspronkelijke identificatienummer van het externe zaaksysteem.\\
 Het externe zaak/dms antwoord hierop met een Bv03-bericht. \\ Het externe zaak/dms antwoord hierop met een Bv03-bericht. \\
-Beide berichten worden gelogd in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen //sectie Koppeling ZAAK en item: Messagelog// EN de instelling //Sectie: OWB en Item: MessageLog aangevinkt// staan.+Beide berichten worden gelogd in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen //sectie Koppeling ZAAK en item: Messagelog// EN de instelling //Sectie: OWB en Item: MessageLog aangevinkt// staan.\\ 
 +Indien //overdracht geaccepteerd// dan komt in de kolom dvmessage_casid de wavezaakcode van de net aangemaakte zaak.
  • openwave/1.33/applicatiebeheer/probleemoplossing/programmablokken/verwerking_stuf_overdragenzaak.1755092702.txt.gz
  • Laatst gewijzigd: 2025/08/13 15:45
  • door Ton Pullens