Verschillen
Dit geeft de verschillen weer tussen de geselecteerde revisie en de huidige revisie van de pagina.
| Beide kanten vorige revisie Vorige revisie Volgende revisie | Vorige revisie | ||
| openwave:1.34:applicatiebeheer:probleemoplossing:programmablokken:verwerking_stuf_overdragenzaak [2025/12/18 12:49] – Kars Gottschal | openwave:1.34:applicatiebeheer:probleemoplossing:programmablokken:verwerking_stuf_overdragenzaak [2026/05/04 12:04] (huidige) – Lonneke van Dijk | ||
|---|---|---|---|
| Regel 1: | Regel 1: | ||
| - | ====== Verwerking StUF Zaak/dms 1.2 Overdragen Zaak ====== | + | ====== Verwerking StUF Zaak/DMS 1.2 Overdragen Zaak ====== |
| {{tag> | {{tag> | ||
| Regel 5: | Regel 5: | ||
| 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: | Naast de noodzakelijke instellingen geldt: | ||
| - | * het externe zaaktype van de overgedragen zaak moet gemapt zijn in openwave | + | * het externe zaaktype van de overgedragen zaak moet gemapt zijn in OpenWave |
| * er moet een intiator (aanvrager) overgedragen worden | * er moet een intiator (aanvrager) overgedragen worden | ||
| * de zaak moet nog niet bestaan | * de zaak moet nog niet bestaan | ||
| Regel 11: | Regel 11: | ||
| ===== Endpoint en beveiliging via certificaten, | ===== Endpoint en beveiliging via certificaten, | ||
| - | Het externe zaaksysteem/ | + | Het externe zaaksysteem/ |
| Een base-URL is een implementatie van OpenWave zoals bijvoorbeeld < | Een base-URL is een implementatie van OpenWave zoals bijvoorbeeld < | ||
| De wsdl van het endpoint is bereikbaar op // | De wsdl van het endpoint is bereikbaar op // | ||
| - | De OpenWave StUF webservice op dat SOAP-endpoint | + | 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: | + | De authenticatie gebeurt op endpoint-niveau door controle op IP-adres en aangeleverd client-certificaat: |
| * In tbendpointlist moet een rij worden gedefinieerd met als endpoint // | * In tbendpointlist moet een rij worden gedefinieerd met als endpoint // | ||
| - | * 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), | + | * 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), |
| + | |||
| + | Indien het bericht van het externe zaak/DMS systeem NIET door deze firewall heen komt, wordt de HTTP-code 401 geretourneerd. | ||
| - | Indien het bericht van het externe zaak/dms systeem NIET door deze firewall heen komt, wordt de HTTP-code 401 geretourneerd. | ||
| ===== Berichtenverkeer ===== | ===== Berichtenverkeer ===== | ||
| Regel 27: | Regel 28: | ||
| ==== Stap 1A en 1B: overdragenZaak_Di01 ==== | ==== Stap 1A en 1B: overdragenZaak_Di01 ==== | ||
| - | 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 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 | + | Indien het bericht van het externe zaak/DMS systeem WEL door de firewall heen is, antwoord |
| - | Beide berichten worden opgeslagen in de messagelog-tabel onder de rubriek: //DMS overdragenZaak// | + | Beide berichten worden opgeslagen in de messagelog-tabel onder de rubriek: //DMS overdragenZaak// |
| <adm example voorbeeld overdragenZaak_Di01> | <adm example voorbeeld overdragenZaak_Di01> | ||
| Regel 73: | Regel 74: | ||
| OpenWave vraagt aan het externe Zaak/DMS systeem de zaakgegevens op. Uit het ontvangen // | OpenWave vraagt aan het externe Zaak/DMS systeem de zaakgegevens op. Uit het ontvangen // | ||
| - | // | + | // |
| // | // | ||
| Regel 81: | Regel 82: | ||
| * hoeft geen loginverklaringen af te tekenen | * hoeft geen loginverklaringen af te tekenen | ||
| * heeft in de kolom dnmaginapp (1=robot, 2=browser, 3=beide) de waarde 3 | * heeft in de kolom dnmaginapp (1=robot, 2=browser, 3=beide) de waarde 3 | ||
| - | * is lid van een rechtengroep die insertrechten heeft op de omgevingstabel en/of de apv/overige | + | * is lid van een rechtengroep die insertrechten heeft op de omgevingstabel en/of de APV/Overige |
| * heeft in de kolom dvtelefoon een codering staan (bij afspraak bestaande uit 4 letters) die verwijst naar de kolom // | * heeft in de kolom dvtelefoon een codering staan (bij afspraak bestaande uit 4 letters) die verwijst naar de kolom // | ||
| Indien GEEN robot-medewerker gevonden dan: | Indien GEEN robot-medewerker gevonden dan: | ||
| - | * wordt een kaart in tbmissingconfiguration aangemaakt onder de apinaam: // | + | * wordt een kaart in tbmissingconfiguration aangemaakt onder de API-naam: // |
| - | * wordt het proces afgesloten zonder | + | * wordt het proces afgesloten zonder |
| - | Openwave | + | OpenWave |
| In het blok //StUF zaak/dms endpoint credentials// | In het blok //StUF zaak/dms endpoint credentials// | ||
| - | * //Endpoint asynchroon// | + | * //Endpoint asynchroon// |
| - | * //Endpoint Beantwoordvraag// | + | * //Endpoint Beantwoordvraag// |
| - | * // | + | * // |
| * // | * // | ||
| * // | * // | ||
| In het blok //StUF zaak/dms stuurgegevens// | In het blok //StUF zaak/dms stuurgegevens// | ||
| - | * //Zender applicatie// | + | * //Zender applicatie// |
| - | * //Zender organisatie// | + | * //Zender organisatie// |
| - | * //Ontvanger applicatie// | + | * //Ontvanger applicatie// |
| - | * //Ontvanger organisatie// | + | * //Ontvanger organisatie// |
| - | 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.\\ |
| Indien GEEN kaart gevonden in tb33gemeente OF endpointgegevens en/of stuurgegevens en/of certificaat gegevens zijn niet compleet dan | Indien GEEN kaart gevonden in tb33gemeente OF endpointgegevens en/of stuurgegevens en/of certificaat gegevens zijn niet compleet dan | ||
| - | * wordt een kaart in tbmissingconfiguration aangemaakt onder de apinaam: // | + | * wordt een kaart in tbmissingconfiguration aangemaakt onder de API-naam: // |
| - | * wordt het proces afgesloten zonder | + | * wordt het proces afgesloten zonder |
| Alles wel OK dan verzendt OpenWave het // | Alles wel OK dan verzendt OpenWave het // | ||
| - | Het externe zaak/dms antwoord synchroon met een // | + | Het externe zaak/DMS antwoord synchroon met een // |
| - | Beide berichten worden opgeslagen in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen | + | Beide berichten worden opgeslagen in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen |
| ==== Stap 3A verwerk zaakdetails tot zaak en slotbericht overdragenZaak_Du01 ===== | ==== Stap 3A verwerk zaakdetails tot zaak en slotbericht overdragenZaak_Du01 ===== | ||
| Regel 116: | Regel 117: | ||
| Het antwoordbericht kan een fault-bericht zijn (zie messagelog). In dat geval gaat iets mis in het transport. | Het antwoordbericht kan een fault-bericht zijn (zie messagelog). In dat geval gaat iets mis in het transport. | ||
| Het antwoordbericht kan wel een // | Het antwoordbericht kan wel een // | ||
| - | In beide gevallen verzendt | + | In beide gevallen verzendt |
| - | Beide berichten worden opgeslagen in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen //sectie | + | Beide berichten worden opgeslagen in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen //Sectie: |
| === Zoek mapping zaaktype === | === Zoek mapping zaaktype === | ||
| - | Indien | + | Indien het antwoordbericht // |
| - | Indien niet gevonden dan wordt dezelfde zoekopracht uitgevoerd maar dan in de tabel zaaktypes | + | Indien niet gevonden dan wordt dezelfde zoekopracht uitgevoerd maar dan in de tabel zaaktypes |
| 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: // | + | * wordt een kaart in tbmissingconfiguration aangemaakt onder de API-naam: // |
| - | * wordt het slotbericht // | + | * wordt het slotbericht // |
| - | * worden beide berichten gelogd in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen //sectie | + | * worden beide berichten gelogd in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen //Sectie: |
| === Bestaat de zaak al? === | === Bestaat de zaak al? === | ||
| De ''< | De ''< | ||
| - | * wordt een kaart in tbmissingconfiguration aangemaakt onder de apinaam: // | + | * wordt een kaart in tbmissingconfiguration aangemaakt onder de API-naam: // |
| - | * wordt het slotbericht // | + | * wordt het slotbericht // |
| - | * worden beide berichten gelogd in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen //sectie | + | * worden beide berichten gelogd in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen //Sectie: |
| === Controle overige noodzakelijke instellingen === | === Controle overige noodzakelijke instellingen === | ||
| - | * Openwave | + | * OpenWave |
| * 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 | + | * Indien de zaaktype mapping is uitgekomen op rij uit tbsoortovverg (APV/Overige |
| * 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 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: // | + | * wordt een kaart in tbmissingconfiguration aangemaakt onder de API-naam: // |
| - | * wordt het slotbericht // | + | * wordt het slotbericht // |
| - | * worden beide berichten gelogd in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen //sectie | + | * worden beide berichten gelogd in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen //Sectie: |
| === Bepaling perceeladres === | === Bepaling perceeladres === | ||
| - | Indien het blok ''< | + | Indien het blok ''< |
| Indien niet gevonden dan wordt gezocht op de gegevens uit het blok < | Indien niet gevonden dan wordt gezocht op de gegevens uit het blok < | ||
| Nog geen perceeladres gevonden, dan wordt gekeken naar het blok met ''< | Nog geen perceeladres gevonden, dan wordt gekeken naar het blok met ''< | ||
| - | is gevuld, dan wordt deze opgezocht in de niet vervallen rijen van tbperceeladressen op respectievelijk de kolommen // | + | is gevuld, dan wordt deze opgezocht in de niet vervallen rijen van tbperceeladressen op respectievelijk de kolommen // |
| Indien nog geen perceeladres gevonden dan wordt //Getal2// van de instelling van //Sectie: Koppeling Zaak Item: DummyLokatiePerceelkey// | Indien nog geen perceeladres gevonden dan wordt //Getal2// van de instelling van //Sectie: Koppeling Zaak Item: DummyLokatiePerceelkey// | ||
| Regel 160: | Regel 161: | ||
| Anders, Indien het blok ''< | Anders, Indien het blok ''< | ||
| - | * Indien tag //< | + | * Indien tag //< |
| - | * Gevonden dan is aanvrager bekend. | + | * Gevonden dan is aanvrager bekend. |
| * Niet gevonden dan wordt een nieuwe kaart aangemaakt in tbcontactadressen met de gegevens uit dit blok. | * Niet gevonden dan wordt een nieuwe kaart aangemaakt in tbcontactadressen met de gegevens uit dit blok. | ||
| Anders, Indien het blok ''< | Anders, Indien het blok ''< | ||
| - | * Indien tag // | + | * Indien tag // |
| * Gevonden dan is aanvrager bekend. indien //Sectie: Koppeling Zaak en Item: BestaandContactNietOverschrijven// | * Gevonden dan is aanvrager bekend. indien //Sectie: Koppeling Zaak en Item: BestaandContactNietOverschrijven// | ||
| * Niet gevonden dan wordt een nieuwe kaart aangemaakt in tbcontactadressen met de gegevens uit dit blok. | * Niet gevonden dan wordt een nieuwe kaart aangemaakt in tbcontactadressen met de gegevens uit dit blok. | ||
| Anders, indien nog steeds geen contactadres gevonden of aangemaakt voor de aanvrager dan: | Anders, indien nog steeds geen contactadres gevonden of aangemaakt voor de aanvrager dan: | ||
| - | * wordt een kaart in tbmissingconfiguration aangemaakt onder de apinaam: // | + | * wordt een kaart in tbmissingconfiguration aangemaakt onder de API-naam: // |
| - | * wordt het slotbericht // | + | * wordt het slotbericht // |
| - | * worden beide berichten gelogd in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen //sectie | + | * worden beide berichten gelogd in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen //Sectie: |
| === Bepaling gemachtigde === | === Bepaling gemachtigde === | ||
| Regel 194: | Regel 195: | ||
| De aanvrager wordt toegevoegd aan de zaak (tbomgcontactennn of tbovcontactennn) met de adresrol //AVR// en de eventuele gemachtigde onder de rol //GEM//. | 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 === | + | === Processen, mappen en hyperlinks, interne betrokkenen, |
| - | Zoals bij een handmatig aangemaakte zaak worden nu processen toegevoegd, mappen aangemaakt en hyperlink gevuld. Mits zo is ingesteld. | + | Zoals bij een handmatig aangemaakte zaak worden nu processen toegevoegd, mappen aangemaakt en hyperlink gevuld. Mits zo is ingesteld.\\ |
| + | Dit geldt ook voor interne betrokkenen aanmaken bij de zaak en Extra kenmerken. Zie voor voorwaarden wat er wel/niet wordt aangemaakt pagina [[openwave: | ||
| === 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 ''< | + | Tot slot wordt het bericht overdragenZaak_Du01 naar het ontvangasynchroon endpoint van het externe zaak/DMS gestuurd. In dat bericht in de tag ''< |
| - | 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 | + | Beide berichten worden gelogd in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen //Sectie: |
| Indien // | Indien // | ||