Creëer email [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.
 ====== Creëer email ====== 
In OpenWave zorgt de Creëer email-functionaliteit voor het genereren en versturen van mails op basis van in het beheer aanwezige emailsjablonen.
Deze functionaliteit is te starten via de knop **Creëer email** linksonder in het detailscherm van een omgevingszaak, handhavingszaak, info-aanvraag, inspectiebezoek of advies. 
De knop start de wizard maakEmail waarbij de gebruiker eerst een sjabloongroep kiest en vervolgens een sjabloon, waarna een aantal aanvullende vragen kunnen volgen. Indien er bij het sjabloon is aangegeven dat de body en/of onderwerp te wijzigen is, kan de medewerker de inhoud van de mail dan wel het onderwerp aanpassen in deze wizard. 
De wizard maak email is ook te starten vanuit het Opties menu bij de bovengenoemde schermen.

Er kan alleen een email worden verstuurd als:
  * er tenminste één contactpersoon bij de zaak/inrichting is met een gevuld mailadres
  * de ingelogde gebruiker een gevuld mailadres heeft in de medewerkerskaart
  * er vanuit OpenWave gemaild kan worden. Hiervoor bestaan standaard mailinstellingen. Indien er al gemaild wordt naar de BAG en/of adviesinstanties, dan zijn deze instellingen al goed ingeregeld. Zie ook [[openwave:1.34:applicatiebeheer:instellen_inrichten:configuratie:sectie_web.mail|sectie webmail]].

Er wordt bij opstellen van de email 1 geadresseerde gekozen en er kunnen meerdere CC-contacten gekozen worden. Uiteraard afhankelijk van het aantal aanwezige contactpersonen met gevuld mailadres bij de zaak/inrichting.

===== Adviesinstantie als contactpersoon =====

Indien de wizard gestart wordt vanaf een //Advies//, dan geldt het volgende:
  * de gebruiker kan als geadresseerde in ieder geval de aviesinstantie zelf kiezen (mits de adviesinstantie in de beheer een emailadres heeft en gekoppeld is aan een contactadreskaart: zie veld //ID contactadres// in het detailscherm van de adviesinstantie (beheertegel //Adviesinstanties//)
  * indien de instelling //sectie: Adviezen en Item: EmailGeenZaakcontacten// aangevinkt is, dan kan er NIET gekozen worden uit de contactadressen bij de bovenliggende zaak.
  * indien de instelling //sectie: Adviezen en Item: EmailExterneMedewerkers// aangevinkt is, dan kan er ook gekozen worden uit de externe adviseurs uit de medewerkerstabel die gekoppeld zijn aan de adviesinstantie. Voorwaarde is wel dat deze externe adviseur nmedewerkers een gevuld emailadres hebben (en de adviesinstantie zelf gekoppeld is aan een contactadreskaart.


De lijst met te kiezen contactpersonen krijgt dan een extra kolom //Adviesinstantie// waarin de naam van de instantie zichtbaar is.

<adm warning>
Indien de adviesinstantie als contactpersoon kan worden gekozen dient men hier bij de sjabloondefinitie rekening mee te houden. Gegevens over het contact in de body van de mail zullen moeten gehaald worden uit adviezen (en niet uit bijvoorbeeld omgevingscontacten tabel). En zijn dus beperkter dan dat men mailt naar een contactpersoon gekoppeld aan de hoofdzaak. Ook is verwijzing //:keyadres// niet functioneel: deze zal altijd vervangen worden door een contactadres ID bij de hoofdzaak. Een adviesinstantie hoeft niet gekoppeld te zijn aan de hoofdzaak als contactpersoon waardoor //:keyadres// leeg zal zijn.
</adm>

===== Rechten =====
  * De gebruiker moet lid zijn van een rechtengroep die het recht: //uploaden en creëren van documenten// heeft voor de betreffende module (omgeving, APV/overig, horeca, inrichting en handhaving, milieu/gebruik)
  * EN de zaak of inrichting mag niet geblokkeerd zijn: 
    * Voor documentcreatie vanuit een inspectiebezoek geldt dat de zaak geblokkeerd is indien tenminste één van onderstaande items waar is:
      * de afgerond datum van de inspectietrajectkaart is gevuld 
      * de instelling //Sectie: InspectieMilieu// en //Item: NietBlokkerenMetHoofdzaak// is NIET aangevinkt (of bestaat niet) EN de blokkering van de onderliggende zaak is WEL gevuld.

===== Keuzelijst met emailsjablonen ===== 
Deze wordt als volgt samengesteld uit tbemailsjabloon (beheertegel //Emailsjablonen//):
  * alleen mailsjablonen waarvoor geldt dat de vervaldatum leeg is
  * EN waarvoor geldt dat de kolom //benaderbaar vanuit tabel// (tbemailsjabloon.dvvanuittabel) gelijk is aan de tabel waarvandaan de optie creëer email is gekozen (mogelijkheden hier zijn voor nu alleen nog: tbomgvergunning, tbhandhavingen en tbinspbezoeken, tbadviezen)
  * EN waarvoor geldt dat kolom //Voor module// (tbemailsjabloon.dvvantoepop) leeg is of gelijk aan de moduleletter van de bovenliggende zaak of inrichting (W = Omgeving, H = Handhaving, E = Milieu/gebruik en Inrichting, O = APV/overige, I = Infoaanvragen)
  * EN waarvoor geldt dat de kolom //Alleen gemeentes// (tbemailsjabloon.dvalleengemeentes):
    * is leeg  
    * OF de gemeente-id van de bovenliggende Locatie (dus waar de zaak speelt) + ';' komt voor in de inhoud van deze kolom.

Indien de inlogger lid is van een [[openwave:1.34:applicatiebeheer:instellen_inrichten:compartimenten|compartiment]], dan geldt de restrictie dat alleen uit die mailsjablonen gekozen kan worden die gekoppeld zijn aan datzelfde compartiment.

Omgekeerd geldt dat indien de inlogger GEEN lid is van een compartiment, dat alleen uit die mailsjablonen gekozen kan worden die NIET gekoppeld zijn aan een compartiment.


===== Te genereren documentnaam =====

Indien de gecreëerde mail zal moeten worden opgeslagen, zal er een document van gemaakt worden (tekstbestand met als extensie .eml). Het document zal gecreëerd worden onder een naam. Het programma stelt een defaultnaam voor op basis van het volgende:
  * Indien de sjabloonkolom //Te genereren documentnaam zonder extensie// (dvtemplate) gevuld is dan wordt die naam gekozen waarbij de substrings
    * %date% vervangen moet worden door 'yyyymmdd' van vandaag 
    * %login% vervangen moet worden door  de medewerkerscode van de inlogger
    * %hoofdzaaknr% vervangen moet worden door de wave zaakcode van de hoofdzaak
    * %deelzaaknr% vervangen moet worden door de wave zaakcode van de deelzaak dus die van een specifiek advies, inspectie of bezwaarberoep
    * %hoofddmsnr% vervangen moet worden door zaakcode waarmee de hoofdzaak is verbonden met een extern zaaksysteem
    * %deeldmsnr% vervangen moet worden door zaakcode waarmee de deelzaak is verbonden met een extern zaaksysteem. Dus die van een specifiek advies, inspectie of bezwaarberoep
    * %teller% vervangen wordt met een automatische teller die gegenereerd wordt op basis van de (aangevinkte) instelling //Sectie: Documenten en Item: WaveBriefNummer//, waarbij de kolom //Tekst// gevuld is met een vast deel van de teller (bijv. WV), //Getal2// met de lengte van het ophogende deel (bijv. 3) en //Getal1// van deze instelling wordt door het algoritme gebruikt om het ophogende deel steeds opnieuw op te slaan wanneer deze is uitgetrokken bij een documentcreatie. Stel //Getal1// is 23, //Tekst// = WV en //Getal2// is 5 dan wordt als teller de waarde WV00023 gegenereerd. De teller kan ook in het document zelf worden opgenomen indien in het sjabloon de string <%teller%> is opgenomen.
  * anders (dvtemplate niet gevuld) dan wordt de documentnaam de waarde van de kolom //omschrijving//. 
De extensie wordt door het programma bepaald (altijd .eml).

Indien:
  * //Getal1// van //Sectie: Documenten Item: Documentregistratie// de waarde 1 heeft
  * EN het document is na creatie automatisch opgeslagen 
dan vindt een controle plaats in de geregistreerde documenten (tbcorrespondentie) op het voorkomen van de naam (pad + naam + extensie) in de kolom dvdocfilenaam. Zo ja, dan krijgt de gebruiker een melding en de mogelijkheid deze naam aan te passen.

===== Afzender =====

Er zijn drie mogelijkheden: het email-adres van de inlogger (tbmedewerkers.dvemail), het niet-persoonlijke emailadres van de inlogger (tbmedewerkers.dvnietpersemail) en het algemene (noreply) adres van de organisatie. Dit laatste adres is -indien de zaak GEEN compartimentszaak is -  de kolom //Tekst// van de instelling //Sectie: Programma en Item: NoReplyEmailadres//. In het geval dat de zaak WEL een compartimentszaak is, dan kijkt het programma naar de kolom //dvnoreplyemailadres// van het betreffende compartiment.

Er kan ook ingesteld worden wat de default (voorkeur) moet zijn van deze mogelijkheden. Indien geen compartiment is dat ingesteld in de kolom //Tekst// van //Sectie: Programma en Item:  AfzEmailDefVolg//. In geval van compartiment is dat de kolom //dvafzemaildefvolg//. De waarde moet zijn:
  * 1 (tevens defaultwaarde) betekent het mailadres van de inlogger. Deze is per definitie gevuld anders kan er geen email gemaakt worden
  * 2 betekent het het niet-persoonlijke mailadres van de inlogger
  * 3 betekent het algemene no reply mailadres.
OpenWave redeneert verder als volgt:

Indien ingestelde voorkeur is 2, maar geen tbmedewerkers.dvnietpersemail gevuld bij de inlogger dan wordt de default 1 (en kan optie 2 niet gekozen worden).

Indien voorkeur is 3, maar geen algemene no reply email-adres gevuld dan wordt de default 1 (en kan optie 3 niet gekozen worden).


Tot slot geldt dat - ook wanneer als afzender gekozen is voor het niet-persoonlijke emailadres van de inlogger of voor het algemene noreply-adres - , dat de inlogger een kopie krijgt als bcc (op zijn/haar persoonlijke emailadres) mits het aanvinkvakje //afschrift naar 'inlognaam van inlogger'// aangevinkt is. Dit vakje is default aangevinkt indien de instelling //Sectie: Documenten: Item EmailafschriftnaarInlogger// ook aangevinkt is.

===== Automatische opslag in DMS/fileshare =====

Of het gecreëerde document automatisch moet worden opgeslagen is afhankelijk van het ingestelde in het mailsjabloon onder de kolommen //Automatische Opslag Fileshare//. Indien hier de kolom //Autom. Upload// is aangevinkt dan is dat het geval (ook voor StUF zaak/DMS koppeling).

In geval van fileshare kan in het mailsjabloon de specifieke map worden aangewezen: te selecteren uit de mogelijkheden zoals gedefinieerd in //Sectie: AanmaakMappen//.

In geval van StUF zaak/DMS moet wel het externe zaak/DMS nummer bij de zaak gevuld zijn van waaruit het document wordt gecreëerd. Is dat niet geval dan wordt het gecreëerde document NIET automatisch opgeslagen.

Wanneer het mailsjabloon zo ingesteld is dat het document automatisch moet worden opgeslagen kijkt het programma naar de instellingen //Sectie: Documenten// en //Item: OphalenViaFileserver// en naar de instelling //Sectie: Documenten// en //Item: OphalenViaDMS//. Indien beide aangevinkt staan, dan zal de inlogger een keuze voor een van de twee moeten maken (of alsnog de keuze niet opslaan). Indien er maar één van deze twee instellingen is aangevinkt dan moet de inlogger de automatische opslag bevestigen.

Voor de **metadata** bij automatische opslag (alleen zinvol bij DMS) geldt een aantal voorwaarden. Of de inlogger metadata moet invullen is afhankelijk van het aangevinkt zijn van de volgende instellingen:
  * //Sectie: KoppelingDOCNAARDMS// en //Item: DocumenttypeVerplicht//. Indien aangevinkt komt de waarde documenttype uit de sjabloonkolom //Documentype DMS// (vwfrmemailsjabloon.dvdmsdoctype) en kan alleen dynamisch worden overschreven indien de sjabloonkolom leeg is.
  *  //Sectie: KoppelingDOCNAARDMS// en //Item: TitelVerplicht//. Indien aangevinkt dan zal de inlogger een titelkolom  moeten vullen. 
  * //Sectie: KoppelingDOCNAARDMS// en //Item: StatusVerplicht//. Indien aangevinkt dan zal de inlogger een statuskolom  moeten vullen. 
  * //Sectie: KoppelingDOCNAARDMS// en //Item: VertrouwelijkheidVerplicht//. Indien aangevinkt komt de waarde vertrouwelijkheid uit de sjabloonkolom //Vertrouwlijkheid DMS// (dvdmsvertrouwlijkheid) en kan alleen dynamisch worden overschreven indien de sjabloonkolom leeg is.
  * Indien //Sectie: KoppelingDOCNAARDMS// en //Item: AuteurVerplicht// is aangevinkt dan wordt de Auteur gevuld met de medewerkerscode van de inlogger.
  * Indien //Sectie: KoppelingDOCNAARDMS// en //Item: VerzenddatumSturen// is aangevinkt dan wordt de Verzenddatum gevuld met systeemdatum //(yyyymmdd)//.
 
<adm warning>
Indien een document wordt gecreëerd bij een zaak die geen extern zaak/DMS nummer heeft, dan worden bovenstaande metadata niet gevraagd (en het document wordt ook niet aan het DMS aangeboden).
</adm>

Bovenstaande instellingen zijn van toepassing op situatie GEEN compartiment. Indien WEL compartiment dan wordt gekeken naar de instellingen voor DMS bij de compartimentdefinitie. Hier is ook de default Documenttype en Vertrouwelijkheid aan te geven.

===== Automatisch registreren (tbcorrespondentie) =====

Het programma zal na creëren van een mail automatisch een regel aanmaken in geregistreerde documenten (tbcorrespondentie) indien:
  * //Getal1// van //Sectie: Documenten Item: Documentregistratie// de waarde 1 heeft
  * EN het document is na creatie automatisch opgeslagen 
(indien de registratie al bestond dan wordt deze overschreven in tbcorrespondentie) Zie ook pagina: [[openwave:1.34:applicatiebeheer:probleemoplossing:module_overstijgende_schermen:geregistreerde_documenten|Geregistreerde Documenten]]. 

Indien: 
  * Opslag op fileserver dan:
    * wordt de kolom dvdocfilenaam gevuld met map (van fileserver) + filenaam 
  * Opslag via stuf zaken/DMS dan:
    * wordt de kolom dvdocfilenaam gevuld met filenaam 
    * wordt de kolom dvintdoccode gevuld met de unieke documentidentifier uitgetrokken door het DMS
    * wordt de kolom dvintzaakcode gevuld met de unieke zaakidentifier waaronder het document is opgeslagen.
In alle gevallen wordt de verzenddatum //(ddbriefdatum)// van de geregistreerde email gevuld met de systeemdatum //(yyyymmdd)//.

De controle op of een registratie al bestaat vindt plaats op de kolom dvdocfilenaam (is pad + documentnaam inclusief extensie).


===== Briefnummer en gecrypte waardes =====

Voor het in de mail opnemen van gegenereerd briefnummer en gecrypte waardes zie: [[openwave:1.34:applicatiebeheer:instellen_inrichten:emailsjablonen]].

===== Bijlagen =====

In de definitie van het emailsjabloon kan aangegeven worden of de uiteindelijke verzender de mogelijkheid krijgt om bijlages aan te wijzen.
Indien de kolom //bijlagen toevoegen// bij dat sjabloon is aangevinkt, zal de verzender kunnen kiezen uit één of meer niet-vervallen geregistreerde documenten bij die zaak.

<adm warning>
Overleg met de juiste personen in uw organisatie of het versturen van documenten per email toegestaan is alvorens bijlagen in de email in de sjabloon toe te staan.</adm>

{{tag>openwave:1.34:applicatiebeheer:functionaliteiten:email}}