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 14:23] – [Stap 3A verwerk zaakdetails tot zaak en slotbericht overdragenZaak_Du01] 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. 
 +
 +<adm example voorbeeld overdragenZaak_Di01>
 +  <?xml version="1.0" encoding="utf-16"?>
 +  <overdragenZaak_Di01 xmlns:xsd="http://www.w3.org/2001/XMLSchema"
 +    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 +    xmlns="http://www.stufstandaarden.nl/koppelvlak/zds0120">
 +    <stuurgegevens xmlns="http://www.egem.nl/StUF/sector/zkn/0310">
 +        <berichtcode xmlns="http://www.egem.nl/StUF/StUF0301">Di01</berichtcode>
 +        <zender xmlns="http://www.egem.nl/StUF/StUF0301">
 +            <organisatie>Rommeldam</organisatie>
 +            <applicatie>RDApp</applicatie>
 +            <gebruiker/>
 +        </zender>
 +        <ontvanger xmlns="http://www.egem.nl/StUF/StUF0301">
 +            <organisatie>ODRommeldam</organisatie>
 +            <applicatie>Openwave</applicatie>
 +        </ontvanger>
 +        <referentienummer xmlns="http://www.egem.nl/StUF/StUF0301"
 +            >93b81f42-f8ca-4221-97a3-7297f77f7544</referentienummer>
 +        <tijdstipBericht xmlns="http://www.egem.nl/StUF/StUF0301"
 +            >20250725104913460</tijdstipBericht>
 +        <functie xmlns="http://www.egem.nl/StUF/StUF0301">overdragenZaak</functie>
 +    </stuurgegevens>
 +    <object xmlns:d4p1="http://www.egem.nl/StUF/StUF0301"
 +        xmlns="http://www.egem.nl/StUF/sector/zkn/0310" d4p1:entiteittype="ZAK"
 +        d4p1:functie="entiteit">
 +        <identificatie>ROM123456</identificatie>
 +        <isVan d4p1:entiteittype="ZAKZKT">
 +            <gerelateerde d4p1:entiteittype="ZKT">
 +                <omschrijving>Aanvraag straatfeest</omschrijving>
 +                <code>24026</code>
 +            </gerelateerde>
 +        </isVan>
 +    </object>
 +  </overdragenZaak_Di01>
 +</adm>
 +
  
 ====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>.\\
-De //Zender// wordt opgezocht in de medewekerstabel in de kolom dvloginnaam: deze robot-medewerker:+//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. 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 28: Regel 78:
 Indien GEEN robot-medewerker gevonden dan: Indien GEEN robot-medewerker gevonden dan:
   * wordt een kaart in tbmissingconfiguration aangemaakt onder de apinaam: //creeerStufOverdrachtZaak: geefZaakDetails//.    * wordt een kaart in tbmissingconfiguration aangemaakt onder de apinaam: //creeerStufOverdrachtZaak: geefZaakDetails//. 
-  * wordt het proces afgesloten zonder dan de externe partij dit weet: geen stuurgegevesn en certificaatgegevens bekend. +  * wordt het proces afgesloten zonder dan de externe partij dit weet: geen stuurgegevens en certificaatgegevens bekend. 
  
 Openwave zoekt in de betreffende kaart van tb33gemeente naar de noodzakelijke StUf stuurgegevens-instellingen en certificaat-gegevens om een bericht aan het externe zaak/dms te kunnen sturen.\\ Openwave zoekt in de betreffende kaart van tb33gemeente naar de noodzakelijke StUf stuurgegevens-instellingen en certificaat-gegevens om een bericht aan het externe zaak/dms te kunnen sturen.\\
Regel 40: 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 58: Regel 108:
 Het antwoordbericht kan wel een //geefZaakDetails_ZakLa01// bericht zijn, maar het blok <antwoord> ontbreekt daarin.\\ Het antwoordbericht kan wel een //geefZaakDetails_ZakLa01// bericht zijn, maar het blok <antwoord> ontbreekt daarin.\\
 In beide gevallen verzendt Openwave het slotbericht //overdragenZaak_Du01// naar het ontvangasynchroon endpoint van het externe zaak/dms. In dat bericht in de tag <antwoord> de boodschap: overdracht geweigerd.. Het externe zaak/dms antwoord hierop met een Bv03-bericht.\\ In beide gevallen verzendt Openwave het slotbericht //overdragenZaak_Du01// naar het ontvangasynchroon endpoint van het externe zaak/dms. In dat bericht in de tag <antwoord> de boodschap: overdracht geweigerd.. Het externe zaak/dms antwoord hierop met een Bv03-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.
    
 **Zoek mapping zaaktype**\\ **Zoek mapping zaaktype**\\
Regel 67: Regel 117:
   * 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.
-  * 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.+  * 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 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.
  
 **Controle overige noodzakelijke instellingen ** \\ **Controle overige noodzakelijke instellingen ** \\
Regel 73: Regel 129:
   * In de tabel tbadressoort dient zowel een niet vervallen rij te bestaan voor de dvcode //AVR// (aanvrager) als voor de dvcode: //GEM// (gemachtigde).   * In de tabel tbadressoort dient zowel een niet vervallen rij te bestaan voor de dvcode //AVR// (aanvrager) als voor de dvcode: //GEM// (gemachtigde).
   * Indien de zaaktype mapping is uitgekomen op rij uit tbsoortovverg (apv/overige zaaktypes) dan moet ook //Getal2// van de instelling //sectie Koppeling ZAAK en item: DummyMeldingAPVOVWerzKey// bestaan en verwijzen naar een valide dnkey van de tabel tbovwerkz.   * Indien de zaaktype mapping is uitgekomen op rij uit tbsoortovverg (apv/overige zaaktypes) dan moet ook //Getal2// van de instelling //sectie Koppeling ZAAK en item: DummyMeldingAPVOVWerzKey// bestaan en verwijzen naar een valide dnkey van de tabel tbovwerkz.
 +  * Indien er geen defaultbehandelaar is gevonden bij de gevonden rij in tbsoortomgverg of tbsoortovverg met de zaaktype mapping, dan valt OpenWave terug op de  kolom //Tekst// van de instelling //Sectie: Koppeling OLO en Item: dossierbehandelaar//.
 Indien aan deze voorwaarden niet is voldaan dan: Indien aan deze voorwaarden niet is voldaan dan:
   * 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.
-  * 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.+  * 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.
  
 **Bepaling perceeladres** \\ **Bepaling perceeladres** \\
Regel 105: Regel 162:
   * 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.
-  * 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.+  * 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.
  
 **Bepaling gemachtigde**\\ **Bepaling gemachtigde**\\
Regel 122: Regel 179:
   * dnkeymilinrichtingen met eventueel gevonden inrichting uit blok //<heeftBetekkingOp>// met entiteittype= //VES//   * dnkeymilinrichtingen met eventueel gevonden inrichting uit blok //<heeftBetekkingOp>// met entiteittype= //VES//
  
 +**Behandelaar en aanvrager/gemachtigde toevoegen**\\
 +Op grond van de gevonden defaultbehandelaar uit de zaaktypes in tbsoortomgverg of tbsoortovverg wordt de behandelaar in tbinbehandelingbij toegveoegd (indien leeg dan valt OpenWave terug op de  kolom// Tekst// van de instelling //Sectie: Koppeling OLO en Item: dossierbehandelaar//.\\
 +
 +De aanvrager wordt toegevoegd aan de zaak (tbomgcontactennn of tbovcontactennn) met de adresrol //AVR// en de eventuele gemachtigde onder de rol //GEM//.
 +
 +**Processen, mappen en hyperlinks aanmaken **\\
 +Zoals bij een handmatig aangemaakte zaak worden nu processen toegevoegd, mappen aangemaakt en hyperlink gevuld. Mits zo is ingesteld.
 +
 +**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 en in de tag <identificatie> het oorspronkelijke identificatienummer van het externe zaaksysteem.\\
 +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.\\
 +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.1755087818.txt.gz
  • Laatst gewijzigd: 2025/08/13 14:23
  • door Ton Pullens