UpdateZaak-bericht wijzigen metadata(StUF) [Documentatie]

Deze pagina is alleen-lezen. Je kan de broncode bekijken maar niet veranderen. Neem contact op met de beheerder als je denkt dat dit niet klopt.
====== UpdateZaak-bericht wijzigen metadata(StUF) ====== 
 
Het updateZaak-bericht kan ook gebruikt worden om een zaak af te sluiten. Normaliter gebeurt dit met een actualiseerZaakStatus bericht, maar kan desgewenst ook met een updateZaak-bericht. Zie hiervoor het kopje //Uitzondering doorgeven einddatum en resultaat via updateZaak_Lk01// onderaan [[openwave:1.35:applicatiebeheer:probleemoplossing:programmablokken:wijzig_status_zaak_zaak_dms]].

Dit lemma gaat verder alleen over het gebruik van updateZaak-bericht voor het doorgeven van verschillende wijzigingen in een zaak.

**Zaaknaam**: indien:
  * de instelling //Sectie: Koppeling Zaak en Item: UpdateZaakNaam// is aangevinkt EN de string //omschrijving// voorkomt in de kolom //Tekst// van deze instelling
  * EN de instelling //Sectie: Koppeling Zaak en Item: HTTPSoapAction_updateZaak_Lk01// heeft de waarde //<nowiki>http://www.egem.nl/StUF/sector/zkn/0310/updateZaak_Lk01</nowiki>//
dan zal een wijziging van de zaakomschrijving (bijv. tbomgvergunning.dvaanvraagnaam of tbhandhavingen.dvomsbouwwerk) doorgezet worden in een updateZaak_LK01 bericht aan het DMS.

**Bevoegd Gezag**: indien:
  * de instelling //Sectie: Koppeling Zaak en Item: UpdateZaakNaam// is aangevinkt EN de string //instantie// voorkomt in de kolom //Tekst// van deze instelling
  * EN de instelling //Sectie: Koppeling Zaak en Item: HTTPSoapAction_updateZaak_Lk01// heeft de waarde //<nowiki>http://www.egem.nl/StUF/sector/zkn/0310/updateZaak_Lk01</nowiki>//
dan zal een wijziging van het bevoegd gezag (bijv. tbomgvergunning.dnkeyoinbevgez) of tbhandhavingen.dnkeyoinbevgez) doorgezet worden in een updateZaak_LK01 bericht (als extraElement) aan het DMS.

**Startdatum**: indien:
  * de instelling //Sectie: Koppeling Zaak en Item: UpdateZaakNaam// is aangevinkt EN de string //startdatum// voorkomt in de kolom //Tekst// van deze instelling
  * EN de instelling //Sectie: Koppeling Zaak en Item: HTTPSoapAction_updateZaak_Lk01// heeft de waarde //<nowiki>http://www.egem.nl/StUF/sector/zkn/0310/updateZaak_Lk01</nowiki>//
dan zal een wijziging van de startdatum (bijv. tbomgvergunning.ddaanvraag of thhandhavingen.ddverzoekdatum) doorgezet worden in een updateZaak_LK01 bericht aan het DMS.

**Dossierbehandelaar**  Indien: 
  *   de instelling //Koppeling Zaak  en item: UpdateZaakNaam// is aangevinkt  
    * EN de string //verantwoordelijke// of de string //uitvoerende// komt voor in de kolom //Tekst//.  (Indien beide dan wordt verantwoordelijke genegeerd).
Zo ja. Dan gaat in een updatezaak-bericht uit richting Zaak/dms met – indien uitvoerende –  de nieuwe behandelaar in de wijzigingsblokken onder entiteit heeftAlsUitvoerende, en -  indien verantwoordelijke -  de wijzigingsblokken onder entiteit heeftAlsVerantwoordelijke.\\
De nieuwe medewerker wordt doorgegeven met identificatie, achternaam, voorletters en voorvoegsel, waarbij voor de identificatie. Openwave kijkt  naar de instelling // Sectie: Koppeling ZAAK en Item: BehandelaarDoorgeven// 
Indien bij deze instelling de kolom //info// is gevuld met de tekst 'geengemeenteid dan vult OpenWave de gemeenteid hieronder met lege string .\\
Verder, indien
  * //Getal1// heeft de waarde 1 dan wordt de gemeente-id van de zaak + de medewerkerscode van de dossierbehandelaar als identificatie van de medewerker gebruikt
  * //Getal1// heeft de waarde 2 dan wordt de gemeente-id van de zaak + de loginnaam van de dossierbehandelaar als identificatie van de medewerker gebruikt
  * //Getal1// heeft de waarde 3 dan wordt de gemeente-id van de zaak + de vaste waarde kolom Tekst van de instelling Sectie: Koppeling ZAAK en Item: Behandelaardoorgeven gebruikt
  * //Getal1// heeft de waarde 4 dan wordt de gemeente-id van de zaak + de externe code (dvmwcodextern) van de dossierbehandelaar als identificatie van de medewerker gebruikt
  * //Getal1// is anders dan blijft de identificatie leeg.


**Zaaktype**: indien:
  * de instelling //Sectie: Koppeling Zaak en Item: UpdateZaakNaam// is aangevinkt EN de string //zaaktype;// voorkomt in de kolom //Tekst// van deze instelling
  * EN de instelling //Sectie: Koppeling Zaak en Item: HTTPSoapAction_updateZaak_Lk01// heeft de waarde //<nowiki>http://www.egem.nl/StUF/sector/zkn/0310/updateZaak_Lk01</nowiki>//
  * EN de nieuwe verwijzing van het zaaktype heeft een gevulde dmszaaktype (tbsoortomgverg.dvmszaaktype)
dan zal een wijziging van het zaaktype in tbomgvergunning (tbomgvergunning.dnkeysoortomgverg) doorgezet worden in een updateZaak_LK01 bericht aan het DMS als extraElement. In dat extraEelment is dan de nieuwe waarde van dvdmszaaktypecode opgenomen.
Indien ook
  * //product;// en of //subproduct;// in bovenstaande instelling zijn opgenomen
  * EN de instelling //Sectie: PRODUCT/DIENST en Item: OMGEVING// is aangevinkt EN //Getal1// <> 1 (want dat is de situatie dat het gaat om één product en één subproduct per omgevingzaak)
  * EN de instelling //Sectie: Programma// en //Item: ZaaktypeWijzigenProductenVerwijderen// AAN staat 
DAN worden bij het wijzigen van het zaaktype de product- en subproductcode en omschrijvingen op dezelfde omgevingskaart leeggemaakt en als lege waardes doorgegeven (als extraElementen) in hetzelfde updateZaak_LK01 bericht aan het DMS.

**Product**: indien:
  * de instelling //Sectie: Koppeling Zaak en Item: UpdateZaakNaam// is aangevinkt EN de string //product;// voorkomt in de kolom //Tekst// van deze instelling
  * EN de instelling //Sectie: Koppeling Zaak en Item: HTTPSoapAction_updateZaak_Lk01// heeft de waarde //<nowiki>http://www.egem.nl/StUF/sector/zkn/0310/updateZaak_Lk01</nowiki>//
dan zal een wijziging van de productcode in tbomvergunningen (tbomgvergunning.dnkeyproducten) met omschrijving doorgezet worden (als extraElementen) in een updateZaak_LK01 bericht aan het DMS.
Indien ook
  * //subproduct;// in bovenstaande instelling is opgenomen
  * EN de instelling //Sectie: PRODUCT/DIENST en Item: OMGEVING// is aangevinkt EN //Getal1// <> 1 (want dat is de situatie dat het gaat om één product en één subproduct per omgevingzaak)
DAN wordt bij het wijzigen van het de productcode ook automatisch de subproductcode en omschrijving op dezelfde omgevingskaart leeggemaakt en als lege waarden doorgegeven (als extraElementen) in hetzelfde updateZaak_LK01 bericht aan het DMS.

**Subproduct**: indien:
  * de instelling //Sectie: Koppeling Zaak en Item: UpdateZaakNaam// is aangevinkt EN de string //subproduct;// voorkomt in de kolom //Tekst// van deze instelling
  * EN de instelling //Sectie: Koppeling Zaak en Item: HTTPSoapAction_updateZaak_Lk01// heeft de waarde //<nowiki>http://www.egem.nl/StUF/sector/zkn/0310/updateZaak_Lk01</nowiki>//
dan zal een wijziging van de subproductcode in tbomvergunningen (tbomgvergunning.dnkeysubproducten) met omschrijving doorgezet worden (als extraElementen) in een updateZaak_LK01 bericht aan het DMS.

**Locatiedres** (tbperceeladressen)
  * bij wijzigen van dnkeyperceeladressen via de wizard verplaats naar ander locatieadres indien dvintzaakcode is gevuld)

**Overige voorwaarden**
Voorwaarden zijn daarbij dat:
  * indien de zaak speelt in een compartiment dan moet:
    * de kolom dldmsupdatezaakbericht van het betreffende compartiment aangevinkt zijn
    * EN de kolom dvdmsmethode moet de waarde //Stuf Zaken 310// hebben
  * indien de zaak NIET in een compartiment speelt dan:
    * moet //Getal1// van de instelling //Sectie: Koppeling Zaak en Item: UpdateZaakNaam// de waarde 1 hebben  
    * EN moet kolom //Tekst// van de instelling //Sectie: Koppeling ZAAK// en //Item: Methode// aangevinkt zijn en de waarde //Stuf zaken 310// hebben.

Verder moet:
  * de betreffende zaak een gevulde dvintzaakcode hebben (de identifier in het zaak/DMS) 
  * en moet de Status nog in behandeling of leeg zijn
  * en moeten de stuurgegevens en endpoints en credentials vastgelegd zijn in de gemeentekaart van waar de zaak speelt (beheertegel //Gemeentes//: blok StUF zaak/DMS).

===== Triggers =====

Het wijzigen van de **omschrijving** (in het element omschrijving van het blok object van het StUF-bericht) van een zaak wordt getriggerd door een verandering van:
  * dvaanvraagnaam van een omgevingszaak
  * dvomsbouwwerk  van een handhavingszaak
  * dvpublbouwwerk van de APV/Overige zaak (de nieuwe omschrijving wordt dan aardwerkzaamheden + dvpublbouwerk)
  * dvpublbouwwerk van de milieu/gebruik zaak (de nieuwe omschrijving wordt dan aardwerkzaamheden + dvpublbouwerk)
  * dvomschrijving van een infoaanvraag     
  * soort onderneming bij een horecazaak (de nieuwe omschrijving wordt //het uitbaten van// + soort onderneming). 

Het wijzigen van het **bevoegd gezag** van een zaak wordt in alle modules getriggerd door een verandering van de kolom dnkeyoinbevgezag. De nieuwe bevoegd gezag naam (uit tboin.dvorganisatie where dnkey = dnkeyoinbevgezag) komt in het blok **extraElementen** onderaan het blok **object** onder de attribuutnaam gedefinieerd door de kolom //Tekst// van de instelling //Sectie: Koppeling Zaak Item: ElementnaamBevGez//. Defaultwaarde van deze attribuutnaam = //instantie//.

Het wijzigen van een **zaaktype** van een zaak wordt alleen in de omgevingsmodule getriggerd door een verandering van de kolom dnkeysoortomgverg. OpenWave zoekt in de zaaktypetabel tbsoortomgverg de nieuwe dvdmszaaktypecode op die bij het veranderde OpenWave-zaaktype hoort. Dit zaaktype (dus zoals de zaak bekend is in het DMS) komt in het blok **extraElementen** onderaan het blok **object** onder de attribuutnaam gedefinieerd door de kolom //Tekst// van de instelling //Sectie: Koppeling Zaak Item: ElementnaamZaaktype//. Defaultwaarde van deze attribuutnaam = //zaaktype//.

Het wijzigen van een **productcode** van een zaak wordt alleen in de omgevingsmodule  getriggerd door een verandering van de kolom dnkeyproducten (al of niet automatisch bij wijziging van zaaktype). De nieuwe productcode (uit tbproductdef.dvproductcode where dnkey = dnkeyproducten) komt in het blok **extraElementen** onderaan het blok **object** onder de attribuutnaam gedefinieerd door de kolom //Tekst// van de instelling //Sectie: Koppeling Zaak Item: ElementnaamProductcode//. Defaultwaarde van deze attribuutnaam = //productcode//.

Het wijzigen van een **productomschrijving** van een zaak wordt alleen in de omgevingsmodule getriggerd door een verandering van de kolom dnkeyproducten (al of niet automatisch bij wijziging van zaaktype). De nieuwe productomschrijving (uit tbproductdef.dvproductoms where dnkey = dnkeyproducten) komt in het blok **extraElementen** onderaan het blok **object** onder de attribuutnaam gedefinieerd door de kolom //Tekst// van de instelling //Sectie: Koppeling Zaak Item: ElementnaamProductoms//. Defaultwaarde van deze attribuutnaam = //productoms//.

Het wijzigen van een **subproductcode** van een zaak wordt alleen in de omgevingsmodule getriggerd door een verandering van de kolom dnkeysubproducten (al of niet automatisch bij wijziging van zaaktype of productcode). De nieuwe subproductcode (uit tbsubproducten.dvsubproductcode where dnkey = dnkeysubproducten) komt in het blok **extraElementen** onderaan het blok **object** onder de attribuutnaam gedefinieerd door de kolom //Tekst// van de instelling //Sectie: Koppeling Zaak Item: ElementnaamSubProductcode//. Defaultwaarde van deze attribuutnaam = //subproductcode//.

Het wijzigen van een **subproductomschrijving** van een zaak wordt alleen in de omgevingsmodule getriggerd door een verandering van de kolom dnkeysubproducten (al of niet automatisch bij wijziging van zaaktype of productcode). De nieuwe subproductomschrijving (uit tbsubproducten.dvsubproductoms where dnkey = dnkeysubproducten) komt in het blok **extraElementen** onderaan het blok **object** onder de attribuutnaam gedefinieerd door de kolom //Tekst// van de instelling //Sectie: Koppeling Zaak Item: ElementnaamSubProductoms//. Defaultwaarde van deze attribuutnaam = //subproductoms//.

Het wijzigen van de **startdatum** (in het element startdatum van het blok object van het StUF-bericht) van een zaak wordt getriggerd door een verandering van:
  * ddaanvraag van een omgevingszaak
  * ddverzoekdatum  van een handhavingszaak
  * ddontvangsdatum van de APV/Overige zaak (de nieuwe omschrijving wordt dan aardwerkzaamheden + dvpublbouwerk)
  * ddontvangstdatum van de milieu/gebruik zaak (de nieuwe omschrijving wordt dan aardwerkzaamheden + dvpublbouwerk)
  * ddaanvraagdatum van een infoaanvraag     
  * ddaanvraagdatum bij een horecazaak (de nieuwe omschrijving wordt //het uitbaten van// + soort onderneming). 

Het wijzigen van **lokatieadres** (dnkeyperceeladressen)  via de wizard //verplaats naar ander locatieadres// indien dvintzaakcode is gevuld

**Dossierbehandelaar** wordt getriggerd door het opvoeren van een nieuwe behandelaar (tbinbehandelingbij)



 
Indien de instelling //Sectie: Koppeling ZAAK// en //Item: UpdateZaakEenObject// aangevinkt is, dan wordt de updateZaak-bericht verzonden met maar één blok object (normaal twee blokken object: de oude situatie en de nieuwe situatie).

===== Automatische doorgifte Inititor na ontvangst ZGW contactpersoon =====
Ook een contactpersoon in de rol van initator die doorgegeven wordt in het binnenkomend ZGW-bericht kan doorgezet worden via een updateZaakbericht.
Zie hiertoe kopje zaak/dms in : [[.:zgw_open_zaak_api_functionaliteit:vereiste_minimale_instellingen|]]

{{tag>openwave:1.35:applicatiebeheer:functionaliteiten:stuf_zaak_dms}}