openwave:1.32:applicatiebeheer:probleemoplossing:programmablokken:zgw_open_zaak_api_functionaliteit:creeerzgwzaakobject

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
openwave:1.32:applicatiebeheer:probleemoplossing:programmablokken:zgw_open_zaak_api_functionaliteit:creeerzgwzaakobject [2025/05/08 15:47] – Ton Pullensopenwave:1.32:applicatiebeheer:probleemoplossing:programmablokken:zgw_open_zaak_api_functionaliteit:creeerzgwzaakobject [2025/05/15 16:02] (huidige) – Lonneke van Dijk
Regel 3: Regel 3:
  
 Op het endpoint //base-url//<nowiki>/api/zgw/zaken/api/v1/zaakobjecten/</nowiki> kan een POST worden geplaatst waarmee OpenWave een zaakobject van objectType //adres// kan toevoegen aan een bestaande zaak.\\ Op het endpoint //base-url//<nowiki>/api/zgw/zaken/api/v1/zaakobjecten/</nowiki> kan een POST worden geplaatst waarmee OpenWave een zaakobject van objectType //adres// kan toevoegen aan een bestaande zaak.\\
-Op grond van deze adresgegevens wordt sowieso een kaart aangemaakt (of bijgewerkt) in tbzaakkadperc die de eigenschap hoofdprojectlocatie krijgt. Daarnaast wordt getracht de zaak op grond van deze adresinformatie te (her)koppelen aan een kaart van tbperceeladressen (de OpenWave lokatie-tabel).\\+Op grond van deze adresgegevens wordt sowieso een kaart aangemaakt (of bijgewerkt) in tbzaakkadperc die de eigenschap hoofdprojectlocatie krijgt. Daarnaast wordt getracht de zaak op grond van deze adresinformatie te (her)koppelen aan een kaart van tbperceeladressen (de OpenWave locatie-tabel).\\
 De //base_url// is de implementatie van OpenWave waar tegenaan gepraat moet worden, bijvoorbeeld: //<nowiki>https://acc.rommeldam.open-wave.nl</nowiki>//.\\ De //base_url// is de implementatie van OpenWave waar tegenaan gepraat moet worden, bijvoorbeeld: //<nowiki>https://acc.rommeldam.open-wave.nl</nowiki>//.\\
  
-Gebaseerd op versie Open Zaak Api 1.2+Gebaseerd op versie Open Zaak API 1.2
  
 <adm warning Whitelist> <adm warning Whitelist>
Regel 22: Regel 22:
  
 <adm warning (robot) Medewerker moet gelinkt zijn aan endpoint> <adm warning (robot) Medewerker moet gelinkt zijn aan endpoint>
-De gevonden token is gelinkt aan een (robot)-medewerker (degene onder wiens credentials het token is gecreëerd). Bij de betreffende medewerkers kaart moet de kolom //Endpoint (robotmedewerker is gedefinieerd voor binnenkomende berichten op endpoint)// (dnkeyendpointlist) in blok login verwijzen naar een kaart in //tbendpointlist// waarvan de inhoud van de kolom //dvendpointurl// een substring is van dit endpoint //api/zgw/zaken/api/v1/zaakobjecten/ /// waarop dit creer zaakobjectbericht wordt gepost: bijvoorbeeld: ///api/zgw//+De gevonden token is gelinkt aan een (robot)-medewerker (degene onder wiens credentials het token is gecreëerd). Bij de betreffende medewerkers kaart moet de kolom //Endpoint (robotmedewerker is gedefinieerd voor binnenkomende berichten op endpoint)// (dnkeyendpointlist) in blok login verwijzen naar een kaart in //tbendpointlist// waarvan de inhoud van de kolom //dvendpointurl// een substring is van dit endpoint //api/zgw/zaken/api/v1/zaakobjecten/ /// waarop dit creeer zaakobjectbericht wordt gepost: bijvoorbeeld: ///api/zgw//
 </adm> </adm>
  
Regel 50: Regel 50:
 OpenWave ondersteunt alleen het objectType met waarde //adres//. OpenWave ondersteunt alleen het objectType met waarde //adres//.
  
-De verwerking van het bericht door OpenWave wordt gelogd in tbmessagelog indien  +De verwerking van het bericht door OpenWave wordt gelogd in tbmessagelog indien:  
   * de instelling //Sectie: ZGW en Item: Messagelog// aangevinkt staat    * de instelling //Sectie: ZGW en Item: Messagelog// aangevinkt staat 
   * EN de instelling //Sectie: OWB en Item: MessageLog// aangevinkt staat.   * EN de instelling //Sectie: OWB en Item: MessageLog// aangevinkt staat.
Regel 56: Regel 56:
 In principe leidt de inhoud van de body tot de aanmaak van een nieuwe projectlocatie (of het wijzigen van een projectlocatie) in tbzaakkadperc en tot het herkoppelen van de zaak aan een kaart in tbperceeladressen. Dit alles bij een een omgevingzaak of APV/Overige zaak die eerder is aangemaakt en voorzien is van een gevulde kolom dvzgwuuid.  In principe leidt de inhoud van de body tot de aanmaak van een nieuwe projectlocatie (of het wijzigen van een projectlocatie) in tbzaakkadperc en tot het herkoppelen van de zaak aan een kaart in tbperceeladressen. Dit alles bij een een omgevingzaak of APV/Overige zaak die eerder is aangemaakt en voorzien is van een gevulde kolom dvzgwuuid. 
  
-Die bestaande zaak is reeds gekoppeld aan een perceeladres bij het verwerken van een creeerzaakbericht. Dit zal altijd een dummylokatie zijn (onbekend adres) omdat het creerzaak-bericht geen lokatie informatie bevat. Een uitzondering is wanneer waarnemingsgegevens zijn opgenomen als extra items in dat creeerzaakbericht, deze worden dus niet ondersteund door de Open Zaak API, maar OpenWave verwerkt deze optionele gegevens in de klachtenkolommen van een omgevingzaak EN tracht tevens de zaak aan een bestaand valide adres in tbperceeladressen te koppelen.+Die bestaande zaak is reeds gekoppeld aan een perceeladres bij het verwerken van een creeerzaakbericht. Dit zal altijd een dummylokatie zijn (onbekend adres) omdat het creerzaak-bericht geen locatie informatie bevat. Een uitzondering is wanneer waarnemingsgegevens zijn opgenomen als extra items in dat creeerzaakbericht, deze worden dus niet ondersteund door de Open Zaak API, maar OpenWave verwerkt deze optionele gegevens in de klachtenkolommen van een omgevingzaak EN tracht tevens de zaak aan een bestaand valide adres in tbperceeladressen te koppelen.
  
 Indien er geometrie is opgegeven in het creeerzaakbericht dan heeft OpenWave al een een projectlocatiekaart aangemaakt in tbzaakkadperc en deze kaart voorzien van de eigenschap hoofdprojectlocatie. Is dat het geval dan wordt deze projectlocatiekaart met dit creeerzaakobject-bericht bijgewerkt. Anders wordt dus een nieuwe kaart aangemaakt bij de zaak in tbzaakkadperc. Indien er geometrie is opgegeven in het creeerzaakbericht dan heeft OpenWave al een een projectlocatiekaart aangemaakt in tbzaakkadperc en deze kaart voorzien van de eigenschap hoofdprojectlocatie. Is dat het geval dan wordt deze projectlocatiekaart met dit creeerzaakobject-bericht bijgewerkt. Anders wordt dus een nieuwe kaart aangemaakt bij de zaak in tbzaakkadperc.
  
 Dit alles, mits aan de nodige voorwaarden in de OpenWave implementatie is voldaan: \\ Dit alles, mits aan de nodige voorwaarden in de OpenWave implementatie is voldaan: \\
-  * De robotmedewerker die verbonden is aan de uitgereikte token moet gekoppeld zijn aan de rechtengroep die het functionele recht tbomgrechten.dlbomgins (insertrecht op de omgevingstabel) aangevinkt heeft staan (indien de zaak een omngevingzaak is), en anders - dus als de zaak een apvoverige zaak is - het functionele recht tbovrechten.dlbovvins. +  * De robotmedewerker die verbonden is aan de uitgereikte token moet gekoppeld zijn aan de rechtengroep die het functionele recht tbomgrechten.dlbomgins (insertrecht op de omgevingstabel) aangevinkt heeft staan (indien de zaak een omngevingzaak is), en anders - dus als de zaak een APV/Overige zaak is - het functionele recht tbovrechten.dlbovvins. 
   * Er moet een unieke kaart zijn in tbomgvergunning waarvoor geldt dat tbomgvergunning.dvzgwuuid gelijk is aan de waarde (een UUID-code) vanaf de laatste slash van item //**zaak**// OF er moet een unieke kaart zijn in tbovvergunningen waarvoor geldt dat tbovvergunningen.dvzgwuuid gelijk is aan deze waarde.   * Er moet een unieke kaart zijn in tbomgvergunning waarvoor geldt dat tbomgvergunning.dvzgwuuid gelijk is aan de waarde (een UUID-code) vanaf de laatste slash van item //**zaak**// OF er moet een unieke kaart zijn in tbovvergunningen waarvoor geldt dat tbovvergunningen.dvzgwuuid gelijk is aan deze waarde.
  
Regel 74: Regel 74:
 Indien wel een unieke perceeladreslokatie is gevonden (op grond van identificatie dan wel adres), dan wordt de dnkeyperceeladressen bij de zaak gewijzigd met deze gevonden dnkey-waarde.\\ Indien wel een unieke perceeladreslokatie is gevonden (op grond van identificatie dan wel adres), dan wordt de dnkeyperceeladressen bij de zaak gewijzigd met deze gevonden dnkey-waarde.\\
  
-     
 ======Responsebericht===== ======Responsebericht=====
 Indien de rol niet kon worden aangemaakt wordt een responsecode anders dan 200/201 geretourneerd met in de body de oorzaak van het falen.\\ Indien de rol niet kon worden aangemaakt wordt een responsecode anders dan 200/201 geretourneerd met in de body de oorzaak van het falen.\\
 Indien de rol succesvol is aangemaakt wordt onder de responsecode 201 het oorspronkelijke bericht geretourneerd aangevuld met de verplichte items, waarbij Indien de rol succesvol is aangemaakt wordt onder de responsecode 201 het oorspronkelijke bericht geretourneerd aangevuld met de verplichte items, waarbij
-  *  in het item //uuid// de code wordt geretourneerd die opgeslagen is bij het zaakobject ( tbzaaakkadperc.dvzgwuuid) +  *  in het item //uuid// de code wordt geretourneerd die opgeslagen is bij het zaakobject (tbzaaakkadperc.dvzgwuuid) 
  
 <adm example Voorbeeld response body> <adm example Voorbeeld response body>
  • openwave/1.32/applicatiebeheer/probleemoplossing/programmablokken/zgw_open_zaak_api_functionaliteit/creeerzgwzaakobject.txt
  • Laatst gewijzigd: 2025/05/15 16:02
  • door Lonneke van Dijk