===== Update Zaakdocument ====
{{tag>openwave:1.32:applicatiebeheer:functionaliteiten:stuf_zaak_dms}}

Mits OpenWave is ingesteld voor het plaatsen van van documenten in het DMS via Stuf Zaak/DMS (dus //instelling KoppelingDOCNAARDMS en Item: Methode// is aangevinkt EN lower(kolom //Tekst//) = stuf-zaken 310) dan kan een Updatezaakdocument_Di02 bericht verstuurd worden in de volgende situaties:

 *  Bij regeneratie van geregistreerd document op basis van OpenWave-sjabloon onder hetzelfde externe document-identificatienummer zie kopje //Regenereer opgeslagen DMS document// bij [[openwave:1.32:applicatiebeheer:probleemoplossing:module_overstijgende_schermen:geregistreerde_documenten:detailscherm_geregistreerd_document]].\\ Daarbij geldt dat 4 extra elementen kunnen worden opgenomen indien de kolom //Tekst// van de instelling //Sectie: KoppelingDOCNAARDMS en Item: UpdateZaakDocumentExtraElementen// gevuld is met de extraElement-namen dlisdigondertekend; en/of dvdigondertekvoluit; en/of dddigondertekend; en/of dlbodemrapnaarbis; (dus kolomnamen uit tbcorrespondentie aangevuld met een puntkomma).

 * Bij het opnieuw aanbieden (uploaden) van een opgehaald document onder hetzelfde documentidentifciatienumnmer (tbcorrespondentitie.dvintdoccode).

 * Bij het wijzigen van de kolom //dlisdigondertekend// in geregistreerde documenten (tbcorrespondentie) mits:
   * de kolom dvintdoccode (dus de identificatiecode waarin het document in het DMS is opgeslagen) gevuld is
   * EN de tekst dlisdigondertekend; (met afsluitende puntkomma) voorkomt in de kolom //Tekst// van de instelling //Sectie: KoppelingDOCNAARDMS en Item: UpdateZaakDocumentExtraElementen//

 * Bij het wijzigen van de kolom  //dlbodemrapnaarbis// in geregistreerde documenten (tbcorrespondentie) mits:
   * de kolom dvintdoccode (dus de identificatiecode waarin het document in het DMS is opgeslagen) gevuld is
   * EN de tekst dlbodemrapnaarbis; (met afsluitende puntkomma) voorkomt in de kolom //Tekst// van de instelling //Sectie: KoppelingDOCNAARDMS en Item: UpdateZaakDocumentExtraElementen//

Bij het wijzigen van de kolommen dlbodemrapnaarbis en dlisdigondertekend en bij regeneratie van een document worden dan maximaal 4 extraElementen opgenomen in het  StUfbericht: namelijk de elementen dlisdigodertekend, dvdigondertekvoluit, dddigondertekend en dlbodemrapnaarbis. Hiertoe moeten zij dus opgenomen zijn (met een afsluitende puntkomma) in de kolom //Tekst// van de instelling //Sectie: KoppelingDOCNAARDMS en Item: UpdateZaakDocumentExtraElementen//.

De datumkolom dddigondertekend wordt doorgegeven conform het formaat van kolom //Tekst// van //Sectie: koppelingDOCNAARDMS Item: StufDateTimeFormaat//. Bijvoorbeeld: //yyyyMMddHHmmss//.\\
Dat format moet één van de volgende zijn:
  *	yyyyMMdd
  *	yyyy-MM-dd
  *	yyyyMMdd'T'HHmmss
  *	yyyy-MM-dd'T'HH-mm-ss
  *	yyyy-MM-ddHH-mm-ss
  *	yyyyMMddHHmmss
 
Dus let op: die T staat tussen apostrofjes.
De month moet in hoodfletters  (MM)
Hours moeten ook in hoofdletters (HH) 

Indien het formaat niet voldoet of leeg dan wordt yyyyMMdd gebruikt.

<adm warning Let op:geefZaakDocumentbewerken en checkoutId>
Om metadata of het document zelf te wijzigen van een document dat reeds opgeslagen is in een DMS, kan het zijn dat het DMS vereist dat eerst een //geefZaakDocumentbewerken// bericht moet worden verstuurd, waarmee het DMS het document kan blokkeren. OpenWave krijgt in de response een checkoutID dat weer teruggegeven wordt bij het updaten van het document, waarna het DMS deze weer kan vrijgegevn.
Indien de instelling //sectie: KoppelingDOCNAARDMS en Item: geefZaakDocumentbewerken// is aangevinkt, dan zal OpenWave hiertoe eerst een checkoutID ophalen bij het DMS met het //geefZaakDocumentberwerken// bericht, en die checkoutID weer gebruiken in het //updateZaakdocument// bericht.
</adm>