openwave:1.30:applicatiebeheer:instellen_inrichten:documentsjablonen

Verschillen

Dit geeft de verschillen weer tussen de geselecteerde revisie en de huidige revisie van de pagina.

Link naar deze vergelijking

Volgende revisie		 Vorige revisie
openwave:1.30:applicatiebeheer:instellen_inrichten:documentsjablonen [2024/01/08 09:06] – aangemaakt - Externe bewerking 127.0.0.1openwave:1.30:applicatiebeheer:instellen_inrichten:documentsjablonen [2024/07/15 13:11] (huidige) – Ton Pullens
Regel 34: Regel 34:
 In het detailscherm van een sjabloongroep, wordt de lijst met gekoppelde sjablonen getoond. Door middel van de plus- dan wel de min-knop, kunnen sjablonen gekoppeld/ontkoppeld worden aan de sjabloongroep. Er valt alleen te kiezen uit sjablonen die qua module overeenkomen met de toebedeelde modules aan de sjabloongroep. Ook zijn altijd zichtbaar de sjablonen die al gekoppeld zijn (ongeacht of deze sjablonen later vervallen zijn/ de module gewijzigd is waardoor logischerwijs het sjabloon niet opnieuw te kiezen is bij de sjabloongroep). Het daadwerkelijk aanmaken/verwijderen van sjablonen gebeurd bij de sjablonenlijst. In het detailscherm van een sjabloongroep, wordt de lijst met gekoppelde sjablonen getoond. Door middel van de plus- dan wel de min-knop, kunnen sjablonen gekoppeld/ontkoppeld worden aan de sjabloongroep. Er valt alleen te kiezen uit sjablonen die qua module overeenkomen met de toebedeelde modules aan de sjabloongroep. Ook zijn altijd zichtbaar de sjablonen die al gekoppeld zijn (ongeacht of deze sjablonen later vervallen zijn/ de module gewijzigd is waardoor logischerwijs het sjabloon niet opnieuw te kiezen is bij de sjabloongroep). Het daadwerkelijk aanmaken/verwijderen van sjablonen gebeurd bij de sjablonenlijst.
  
-==== Sjabloondefinitie (documentsjablonenlijst)====+==== Documentsjablonenlijst====
 In de lijst met documentsjablonen kunnen documentsjablonen verwijderd worden (inclusief parameters), nieuw aangemaakt en gekopieerd worden. Bij het maken van een kopie worden de parameters mee gekopieerd. Ook kan er op de lijst gefilterd en gezocht worden. In de lijst met documentsjablonen kunnen documentsjablonen verwijderd worden (inclusief parameters), nieuw aangemaakt en gekopieerd worden. Bij het maken van een kopie worden de parameters mee gekopieerd. Ook kan er op de lijst gefilterd en gezocht worden.
  
-==== Sjabloondefinitie (detailscherm)====+===== Sjabloondefinitie =====
 In het detailscherm van een documentsjabloon kan men het sjabloon na aanmaken vervolgens koppelen aan de gewenste sjabloongroep(en) via het blok **Sjabloongroep(en)**. Hierbij valt er te kiezen uit sjabloongroepen die niet vervallen zijn en waarvan de module van het sjabloon waar men op staat voorkomt in de modules van de sjabloongroep. In het detailscherm van een documentsjabloon kan men het sjabloon na aanmaken vervolgens koppelen aan de gewenste sjabloongroep(en) via het blok **Sjabloongroep(en)**. Hierbij valt er te kiezen uit sjabloongroepen die niet vervallen zijn en waarvan de module van het sjabloon waar men op staat voorkomt in de modules van de sjabloongroep.
 Voor bestaande sjablonen kan via het detailscherm op dezelfde manier de koppeling aan sjabloongroepen gewijzigd worden. Met de komst van dit blok is het veld //Sjabloongroep// komen te vervallen.  Voor bestaande sjablonen kan via het detailscherm op dezelfde manier de koppeling aan sjabloongroepen gewijzigd worden. Met de komst van dit blok is het veld //Sjabloongroep// komen te vervallen. 
  
-===== Triggers ===== +=== Triggers in het menu opties rechtsboven === 
-==== Triggers in het menu opties rechtsboven ==== +  * **Toon uploads** bij deze sjabloonfile. Hiermee wordt de uploadgeschiedenis getoond van het documentsjabloon zelf in de kolom dvtemplatebase64. Zie [[openwave:1.30:applicatiebeheer:probleemoplossing:module_overstijgende_schermen:uploads_lijst|Upload Lijst]]
- +
-  * **Toon uploads** bij deze sjabloonfile. Hiermee wordt de uploadgeschiedenis getoond van het documentsjabloon zelf in de kolom dvtemplatebase64. Zie [[openwave:1.29:applicatiebeheer:probleemoplossing:module_overstijgende_schermen:uploads_lijst|Upload Lijst]]+
   * **Verwijder upgeloade sjabloon**. Hiermee wordt de kolom dvtemplatebase64 leeggemaakt. Zichtbaar doordat het aanvinkvakje voor het label //Sjabloon is upgeload in tabel// leeggemaakt wordt.    * **Verwijder upgeloade sjabloon**. Hiermee wordt de kolom dvtemplatebase64 leeggemaakt. Zichtbaar doordat het aanvinkvakje voor het label //Sjabloon is upgeload in tabel// leeggemaakt wordt. 
  
-==== Triggers linksonder ==== +=== Triggers linksonder ===
   * Met de knop **controleer SQL-statements** worden de gevulde query-kolommen gevalideerd. De betreffende kolomnamen worden zichtbaar met een groen bolletje indien ok en met een rood bolletje indien het statement niet valide is.   * Met de knop **controleer SQL-statements** worden de gevulde query-kolommen gevalideerd. De betreffende kolomnamen worden zichtbaar met een groen bolletje indien ok en met een rood bolletje indien het statement niet valide is.
   * Met de knop **upload sjabloonfile** kan één document (met extensie .odt of .dotx of .docx) aangewezen worden, dat vervolgens met base64 opgeslagen wordt in de kolom dvtemplatebase64. Zichtbaar doordat het aanvinkvakje voor het label //Sjabloon is upgeload in tabel// gevuld is. Indien de kolom //(UNC-pad) + naam sjabloon// een lege waarde had, dan wordt deze gevuld met de naam van het zojuist geüploade document.   * Met de knop **upload sjabloonfile** kan één document (met extensie .odt of .dotx of .docx) aangewezen worden, dat vervolgens met base64 opgeslagen wordt in de kolom dvtemplatebase64. Zichtbaar doordat het aanvinkvakje voor het label //Sjabloon is upgeload in tabel// gevuld is. Indien de kolom //(UNC-pad) + naam sjabloon// een lege waarde had, dan wordt deze gevuld met de naam van het zojuist geüploade document.
Regel 57: Regel 54:
     * EN de extensie van de sjabloonnaam (dvtemplatebase64) komt voor in de kolom //Tekst// van deze instelling (waarbij in kolom //Tekst// de mogelijke extensies gescheiden zijn door een puntkomma, dus bijvoorbeeld docx;xslsx;).     * EN de extensie van de sjabloonnaam (dvtemplatebase64) komt voor in de kolom //Tekst// van deze instelling (waarbij in kolom //Tekst// de mogelijke extensies gescheiden zijn door een puntkomma, dus bijvoorbeeld docx;xslsx;).
  
- +=== Triggers rechtsonder ===
-==== Triggers rechtsonder ==== +
   * Met het aanvinkvakje (default aangevinkt) vervallen kaarten zichtbaar, kan de lijst gefilterd worden op alleen niet-vervallen sjablonen.   * Met het aanvinkvakje (default aangevinkt) vervallen kaarten zichtbaar, kan de lijst gefilterd worden op alleen niet-vervallen sjablonen.
  
-===== Kolommen van sjabloon===== +==== Kolommen ====
  
   * De kolom **ID** (dnkey) geeft de automatisch gegenereerde primary key weer van het sjabloon in de tabel tbdocumenten.   * De kolom **ID** (dnkey) geeft de automatisch gegenereerde primary key weer van het sjabloon in de tabel tbdocumenten.
   * **Naam/beschrijving** (dvomschrijving). Vrij in te voeren naam voor het sjabloon, zoals die voor gebruikers zichtbaar worden in een lijst, wanneer de gebruiker de wizard //Maakdocument// aanroept.   * **Naam/beschrijving** (dvomschrijving). Vrij in te voeren naam voor het sjabloon, zoals die voor gebruikers zichtbaar worden in een lijst, wanneer de gebruiker de wizard //Maakdocument// aanroept.
-  * **Naam van sjabloon in Xential** (dvnaaminexternsjablprog). Moet alleen gevuld worden indien het OpenWave sjabloon doorgeefluik is naar een Xentail-sjabloon. Zie: [[openwave:1.29:applicatiebeheer:probleemoplossing:programmablokken:xential|]]. +  * **Naam van sjabloon in Xential** (dvnaaminexternsjablprog). Moet alleen gevuld worden indien het OpenWave sjabloon doorgeefluik is naar een Xentail-sjabloon. Zie: [[openwave:1.30:applicatiebeheer:probleemoplossing:programmablokken:xential|]]. 
-  * **Compartiment** (dnkeycompartiment). Indien het sjabloon hier wordt toegekend aan een [[openwave:1.29:applicatiebeheer:instellen_inrichten:compartimenten|compartiment]] kan dit sjabloon alleen worden gebruikt door iemand die lid is van dat compartiment. Omgekeerd: de inloggers die geen lid zijn van een compartiment zien enkel sjablonen die ook niet zijn toegekend aan een compartiment.+  * **Compartiment** (dnkeycompartiment). Indien het sjabloon hier wordt toegekend aan een [[openwave:1.30:applicatiebeheer:instellen_inrichten:compartimenten|compartiment]] kan dit sjabloon alleen worden gebruikt door iemand die lid is van dat compartiment. Omgekeerd: de inloggers die geen lid zijn van een compartiment zien enkel sjablonen die ook niet zijn toegekend aan een compartiment.
   * Met het **Volgordenummer** kan de volgorde van de sjabloonnamen bepaald worden zoals die voor gebruikers zichtbaar worden in een lijst, wanneer de gebruiker de wizard //Maakdocument// aanroept via optie //Creëer document//.   * Met het **Volgordenummer** kan de volgorde van de sjabloonnamen bepaald worden zoals die voor gebruikers zichtbaar worden in een lijst, wanneer de gebruiker de wizard //Maakdocument// aanroept via optie //Creëer document//.
   * **Vervaldatum**. Vervallen documentsjablonen zijn niet zichtbaar voor de gebruiker bij de wizard //Maakdocument//.   * **Vervaldatum**. Vervallen documentsjablonen zijn niet zichtbaar voor de gebruiker bij de wizard //Maakdocument//.
Regel 80: Regel 74:
     *  %teller% in dvtemplate wordt vervangen door uniek briefnummer dat gegenereerd wordt op moment van aanmaken van brief mits de instelling //Sectie: Documenten en Item: WaveBriefNummer// bestaat en is aangevinkt     *  %teller% in dvtemplate wordt vervangen door uniek briefnummer dat gegenereerd wordt op moment van aanmaken van brief mits de instelling //Sectie: Documenten en Item: WaveBriefNummer// bestaat en is aangevinkt
     * %adres% in dvtemplate wordt vervangen door het adres + de woonplaats van de hoofdzaak/inrichting      * %adres% in dvtemplate wordt vervangen door het adres + de woonplaats van de hoofdzaak/inrichting 
-    * %ExtDocIdent% (hoofdlettergevoelig!) in dvtemplate wordt vervangen door de externe documentidentifier die verkregen wordt door een Stuf Zaak/DMS genereerdocumentidentificatie-bericht. Alleen van toepassing indien automatische opslag in een DMS via Stuf Zaak/DMS. Wanneer OpenWave geen externe documentidentifier kan bemachtigen, blijft de tag %ExtDocIdent% staan in de documentnaam. Indien kolom dvtemplate leeg is dan geldt als te genereren documentnaam de waarde van de kolom //(UNC-pad) + naam sjabloon// (dvdocumentnaam) exclusief het eventuele UNC-pad. Ook hier wordt .dotx omgezet naar .docx.  +    * %ExtDocIdent% (hoofdlettergevoelig!) in dvtemplate wordt vervangen door de externe documentidentifier die verkregen wordt door een Stuf Zaak/DMS genereerdocumentidentificatie-bericht. Alleen van toepassing indien automatische opslag in een DMS via Stuf Zaak/DMS. Wanneer OpenWave geen externe documentidentifier kan bemachtigen, blijft de tag %ExtDocIdent% staan in de documentnaam. Indien kolom dvtemplate leeg is dan geldt als te genereren documentnaam de waarde van de kolom //(UNC-pad) + naam sjabloon// (dvdocumentnaam) exclusief het eventuele UNC-pad. Ook hier wordt .dotx omgezet naar .docx. \\ Voorbeeld: dvtemplate heeft de waarde //vraagaanvulling_%date%// en de //(UNC-pad) + naam sjabloon// (dvdocumentnaam) heeft de waarde: //Beleefde vraag aanvulling.dotx//, dan wordt de te genereren documentnaam: //vraagaanvulling_20170420.docx//
-<adm example> dvtemplate heeft de waarde //vraagaanvulling_%date%// en de //(UNC-pad) + naam sjabloon// (dvdocumentnaam) heeft de waarde: //Beleefde vraag aanvulling.dotx//, dan wordt de te genereren documentnaam: //vraagaanvulling_20170420.docx//</adm>+
   * **Benaderbaar vanuit tabel**. Deze kolom is verplicht en wordt onder meer gebruikt om de query variabelen :keyvergunning, :keyinrichting, :keyinspectie, :keyinspectiebezoek :keyadvies en :keyklacht en :keyadres en :keylocatie en :keybezwaarberoep met de juiste contextuele waarde te vullen (zie hieronder query-variabelen). Niet alle tabelnamen zijn zinvol. Alleen tbomgvergunning (indien een document wordt gevormd op basis van de data uit de actieve kaart in tbomgvergunning), tbhandhavingen, tbovvergunningen, tbmilinrichtingen, tbmilvergunningen, tbbouwvergunningen en tbinfoaanvragen zijn zinvol m.b.t. de variabele :keyvergunning en :keylocatie. En verder de tabel tbinspecties m.b.t. de variabele :keyinspectie en de tabel tbinsbezoeken m.b.t. :keyinspectiebezoek, tbmilinrichtingen m.b.t. :keyinrichting en tbadviezen m.b.t. :keyadvies en tbcontactadressen m.b.t. :keyadres en tbklachten m.b.t. :keyklacht en tot slot tbbezwaarberoep m.b.t. :keybezwaarberoep. Dit zijn tevens de plekken waar de gebruiker (mits geautoriseerd) de mogelijkheid heeft om de wizard //Maakdocument// aan te roepen   * **Benaderbaar vanuit tabel**. Deze kolom is verplicht en wordt onder meer gebruikt om de query variabelen :keyvergunning, :keyinrichting, :keyinspectie, :keyinspectiebezoek :keyadvies en :keyklacht en :keyadres en :keylocatie en :keybezwaarberoep met de juiste contextuele waarde te vullen (zie hieronder query-variabelen). Niet alle tabelnamen zijn zinvol. Alleen tbomgvergunning (indien een document wordt gevormd op basis van de data uit de actieve kaart in tbomgvergunning), tbhandhavingen, tbovvergunningen, tbmilinrichtingen, tbmilvergunningen, tbbouwvergunningen en tbinfoaanvragen zijn zinvol m.b.t. de variabele :keyvergunning en :keylocatie. En verder de tabel tbinspecties m.b.t. de variabele :keyinspectie en de tabel tbinsbezoeken m.b.t. :keyinspectiebezoek, tbmilinrichtingen m.b.t. :keyinrichting en tbadviezen m.b.t. :keyadvies en tbcontactadressen m.b.t. :keyadres en tbklachten m.b.t. :keyklacht en tot slot tbbezwaarberoep m.b.t. :keybezwaarberoep. Dit zijn tevens de plekken waar de gebruiker (mits geautoriseerd) de mogelijkheid heeft om de wizard //Maakdocument// aan te roepen
-  * **Voor module**. Lijkt dubbelop i.v.m. //benaderbaar vanuit tabelnaam//, maar zowel voor klachten, adviezen en inspecties en bezwaar/beroep geldt dat zij vanuit verschillende modules oproepbaar zijn. Dus als een document wordt gebruikt bij een inspectie waarbij gegevens uit de bijbehorende omgevingszaak worden gebruikt dan is de tabelnaam: tbinspecties en de moduleletter: W. +  * **Voor module**. Lijkt dubbelop i.v.m. //benaderbaar vanuit tabelnaam//, maar zowel voor klachten, adviezen en inspecties en bezwaar/beroep geldt dat zij vanuit verschillende modules oproepbaar zijn. Dus als een document wordt gebruikt bij een inspectie waarbij gegevens uit de bijbehorende omgevingszaak worden gebruikt dan is de tabelnaam: tbinspecties en de moduleletter: W.\\  Mogelijkheden zijn W: Omgeving O: APV/Overig, H: Handhaving, I: Info, E: Milieu/gebruik (gedeeltelijk pre-wabo) + Inrichtingen/Vestigingen/Objectregistratie, C: Horeca en B: Bouw/Sloop (pre-wabo)
- Mogelijkheden zijn W: Omgeving O: APV/Overig, H: Handhaving, I: Info, E: Milieu/gebruik (gedeeltelijk pre-wabo) + Inrichtingen/Vestigingen/Objectregistratie, C: Horeca en B: Bouw/Sloop (pre-wabo)+
   * **Documenttype DMS**. Deze kolom is noodzakelijk indien het te genereren document direct wordt doorgezet met een zaak/DMS koppeling (//autom upload (dlautoupload) // is aangevinkt EN indien GEEN compartiment dan de kolom //Tekst// van instelling //Sectie: KoppelingDOCNAARDMS// en //Item: Methode// heeft de waarde StUF-ZAKEN 310, indien WEL compartiment dan Documenten opslag in DMS aangevinkt en veld DMS-Methode heeft de waarde Stuf-zaken 310 bij compartimentdefinitie) naar een extern DMS, waarbij documenttype verplicht is. Wordt ook gebruikt bij documentregistratie in OpenWave (tbcorrespondentie) indien na het creëren van een document het document automatisch opgeslagen wordt en een regel in tbcorrespondentie wordt aangemaakt. Dit is het geval indien //Getal1// van //Sectie: Documenten en Item: Documentregistratie// de waarde 1 heeft. De documenttypen keuzelijst bestaat in principe uit de niet vervallen rijen van beheertabel tbdocumenttypes waarbij geldt dat als er een compartiment gekozen is bij de sjabloondefinitie, de rijen beperkt zijn uit tbdocumenttypes voor gekozen compartiment. Indien er geen compartiment gekozen is bij de sjabloondefinitie bestaat de keuzelijst uit alle niet vervallen rijen EN geen gevulde dnkeycompartiment uit tbdocumenttypes   * **Documenttype DMS**. Deze kolom is noodzakelijk indien het te genereren document direct wordt doorgezet met een zaak/DMS koppeling (//autom upload (dlautoupload) // is aangevinkt EN indien GEEN compartiment dan de kolom //Tekst// van instelling //Sectie: KoppelingDOCNAARDMS// en //Item: Methode// heeft de waarde StUF-ZAKEN 310, indien WEL compartiment dan Documenten opslag in DMS aangevinkt en veld DMS-Methode heeft de waarde Stuf-zaken 310 bij compartimentdefinitie) naar een extern DMS, waarbij documenttype verplicht is. Wordt ook gebruikt bij documentregistratie in OpenWave (tbcorrespondentie) indien na het creëren van een document het document automatisch opgeslagen wordt en een regel in tbcorrespondentie wordt aangemaakt. Dit is het geval indien //Getal1// van //Sectie: Documenten en Item: Documentregistratie// de waarde 1 heeft. De documenttypen keuzelijst bestaat in principe uit de niet vervallen rijen van beheertabel tbdocumenttypes waarbij geldt dat als er een compartiment gekozen is bij de sjabloondefinitie, de rijen beperkt zijn uit tbdocumenttypes voor gekozen compartiment. Indien er geen compartiment gekozen is bij de sjabloondefinitie bestaat de keuzelijst uit alle niet vervallen rijen EN geen gevulde dnkeycompartiment uit tbdocumenttypes
   * **Aanduiding vertrouwelijkheid**. Deze kolom is alleen noodzakelijk indien het te genereren document direct wordt doorgezet met een zaak/DMS koppeling (//autom upload (dlautoupload)// is aangevinkt EN de kolom //Tekst// van instelling //Sectie: KoppelingDOCNAARDMS// en //Item: Methode// heeft de waarde StUF-ZAKEN 310) naar een extern DMS, waarbij het metadata gegeven vertrouwelijkheidsaanduiding verplicht is. Wordt ook gebruikt bij documentregistratie in OpenWave (tbcorrespondentie) indien na het creëren van een document het document automatisch opgeslagen wordt en een regel in tbcorrespondentie wordt aangemaakt. Dit is het geval indien //Getal1// van //Sectie: Documenten en Item: Documentregistratie// de waarde 1 heeft   * **Aanduiding vertrouwelijkheid**. Deze kolom is alleen noodzakelijk indien het te genereren document direct wordt doorgezet met een zaak/DMS koppeling (//autom upload (dlautoupload)// is aangevinkt EN de kolom //Tekst// van instelling //Sectie: KoppelingDOCNAARDMS// en //Item: Methode// heeft de waarde StUF-ZAKEN 310) naar een extern DMS, waarbij het metadata gegeven vertrouwelijkheidsaanduiding verplicht is. Wordt ook gebruikt bij documentregistratie in OpenWave (tbcorrespondentie) indien na het creëren van een document het document automatisch opgeslagen wordt en een regel in tbcorrespondentie wordt aangemaakt. Dit is het geval indien //Getal1// van //Sectie: Documenten en Item: Documentregistratie// de waarde 1 heeft
Regel 97: Regel 89:
   * **Sjabloon is upgeload in tabel** (dvtemplatebase64 is wel/niet gevuld). Zie hierboven en bij de triggers upload/download sjabloon   * **Sjabloon is upgeload in tabel** (dvtemplatebase64 is wel/niet gevuld). Zie hierboven en bij de triggers upload/download sjabloon
   * **autom upload** (dlautoupload). Indien aangevinkt heeft dat als consequentie dat het programma het te genereren document direct gaat opslaan: Indien   * **autom upload** (dlautoupload). Indien aangevinkt heeft dat als consequentie dat het programma het te genereren document direct gaat opslaan: Indien
-    * de kolom //Tekst// van instelling //Sectie: KoppelingDOCNAARDMS// en //Item: Methode// de waarde //StUF-ZAKEN 310// heeft EN de externe zaakcode is gevuld EN de instelling //Sectie: Documenten// en //Item: OphalenViaDMS// is aangevinkt, dan wordt het document doorgegeven met de zaak/DMS services. Zie [[openwave:1.29:applicatiebeheer:probleemoplossing:programmablokken:upload_document:upload_naar_stuf_zaak_dms|Upload documenten met StUF zaak/dms]]  +    * de kolom //Tekst// van instelling //Sectie: KoppelingDOCNAARDMS// en //Item: Methode// de waarde //StUF-ZAKEN 310// heeft EN de externe zaakcode is gevuld EN de instelling //Sectie: Documenten// en //Item: OphalenViaDMS// is aangevinkt, dan wordt het document doorgegeven met de zaak/DMS services. Zie [[openwave:1.30:applicatiebeheer:probleemoplossing:programmablokken:upload_document:upload_naar_stuf_zaak_dms|Upload documenten met StUF zaak/dms]]  
-    * de kolom //Tekst// van instelling //Sectie: KoppelingDOCNAARDMS// en //Item: Methode// de waarde //CMIS 1.0// heeft EN de instelling //Sectie: Documenten, Item: OphalenViaDMS// is aangevinkt EN de kolom //Item// van //Sectie: Aanmaakmappen// verwijst naar een kaart in tbinitialisatie met de juiste CMIS map-informatie, dan wordt het document doorgegeven met CMIS. Zie: [[openwave:1.29:applicatiebeheer:probleemoplossing:programmablokken:upload_document:upload_met_cmis]] +    * de kolom //Tekst// van instelling //Sectie: KoppelingDOCNAARDMS// en //Item: Methode// de waarde //CMIS 1.0// heeft EN de instelling //Sectie: Documenten, Item: OphalenViaDMS// is aangevinkt EN de kolom //Item// van //Sectie: Aanmaakmappen// verwijst naar een kaart in tbinitialisatie met de juiste CMIS map-informatie, dan wordt het document doorgegeven met CMIS. Zie: [[openwave:1.30:applicatiebeheer:probleemoplossing:programmablokken:upload_document:upload_met_cmis]] 
-    * de instelling //Sectie: Documenten, Item: OphalenViaFileserver// is aangevinkt EN de kolom //Item// van //Sectie: Aanmaakmappen// verwijst naar een kaart in tbinitialisatie met de juiste fileshare-mapinformatie, dan wordt het document geplaatst op de fileshare. Zie: [[openwave:1.29:applicatiebeheer:probleemoplossing:programmablokken:upload_document:upload_naar_fileshare]]. Indien sprake is van een hybride situatie van zowel opslag mogelijk op fileserver als in DMS kan een voorkeur opgegeven worden met de instelling //Sectie: Documenten Item: BriefAutoOpslaan//. Indien //Getal1// wordt gevuld met 1 dan zal OpenWave bij het creëren van een brief op basis van een sjabloon als default de fileserver voorstellen. Bij 2 wordt DMS voorgesteld en bij 3 de optie Nee (hetgeen betekent: niet automatisch opslaan). Deze instelling geldt alleen voor de Host. Indien namelijk sprake is van een compartiment wordt deze zelfde informatie opgehaald uit de nieuwe kolom met label //Default brieven opslaan// (tbcompartiment.dnAutoopslaan) +    * de instelling //Sectie: Documenten, Item: OphalenViaFileserver// is aangevinkt EN de kolom //Item// van //Sectie: Aanmaakmappen// verwijst naar een kaart in tbinitialisatie met de juiste fileshare-mapinformatie, dan wordt het document geplaatst op de fileshare. Zie: [[openwave:1.30:applicatiebeheer:probleemoplossing:programmablokken:upload_document:upload_naar_fileshare]]. Indien sprake is van een hybride situatie van zowel opslag mogelijk op fileserver als in DMS kan een voorkeur opgegeven worden met de instelling //Sectie: Documenten Item: BriefAutoOpslaan//. Indien //Getal1// wordt gevuld met 1 dan zal OpenWave bij het creëren van een brief op basis van een sjabloon als default de fileserver voorstellen. Bij 2 wordt DMS voorgesteld en bij 3 de optie Nee (hetgeen betekent: niet automatisch opslaan). Deze instelling geldt alleen voor de Host. Indien namelijk sprake is van een compartiment wordt deze zelfde informatie opgehaald uit de nieuwe kolom met label //Default brieven opslaan// (tbcompartiment.dnAutoopslaan) 
-  * **Item Sectie Aanmaakmappen**. Deze kolom is alleen zinvol indien //autom upload// is aangevinkt en die automatische upload van het gegenereerde document moet naar de fileshare of via CMIS in een DMS. Hier wordt verwezen naar de instellingskaart kaart met //Sectie : Aanmaakmappen// waarin exact wordt verwezen onder welke map het document geplaatst moet worden. Zie: [[openwave:1.29:applicatiebeheer:probleemoplossing:programmablokken:upload_document|Upload document]]+  * **Item Sectie Aanmaakmappen**. Deze kolom is alleen zinvol indien //autom upload// is aangevinkt en die automatische upload van het gegenereerde document moet naar de fileshare of via CMIS in een DMS. Hier wordt verwezen naar de instellingskaart kaart met //Sectie : Aanmaakmappen// waarin exact wordt verwezen onder welke map het document geplaatst moet worden. Zie: [[openwave:1.30:applicatiebeheer:probleemoplossing:programmablokken:upload_document|Upload document]]
   * **Queries**. Er zijn 10 formqueries (queries waarvan het resultaat van het SQL-statement uit maar één regel mag bestaan) en 12 childqueries (de resultaatsets van deze SQL-statements mogen wel meer dan één regel bevatten). In het .odt of .dotx of .docx sjabloon worden childqueries gebruikt om tabellen te vullen en formqueries voor één op één merge-coderingen. Zie kopjes formquery en childquery. De views waarvan de naam begint met ‘VwFrm’ zijn de views die goed gedocumenteerd zijn en door Rem bij updates worden beschermd. Het is dus raadzaam alleen deze views als onderlaag van de queries te gebruiken. Zie https://www.open-wave.nl/community/online/datadictionary/Index.html.   * **Queries**. Er zijn 10 formqueries (queries waarvan het resultaat van het SQL-statement uit maar één regel mag bestaan) en 12 childqueries (de resultaatsets van deze SQL-statements mogen wel meer dan één regel bevatten). In het .odt of .dotx of .docx sjabloon worden childqueries gebruikt om tabellen te vullen en formqueries voor één op één merge-coderingen. Zie kopjes formquery en childquery. De views waarvan de naam begint met ‘VwFrm’ zijn de views die goed gedocumenteerd zijn en door Rem bij updates worden beschermd. Het is dus raadzaam alleen deze views als onderlaag van de queries te gebruiken. Zie https://www.open-wave.nl/community/online/datadictionary/Index.html.
  
-=====Queries voor merge ===== +
-Queries worden gebruikt om een documentsjabloon te mergen met gegevens uit de database.\\  +
-In het geval dat het OpenWave sjabloon een doorgeefluik is naar een Xential sjabloon (kolom dvnaaminexternsjablprog is dan gevuld), worden de resultsets van de queries gebruikt om een xml te construeren die Xential gebruikt om te mergen. Zie voor deze toepassing: [[openwave:1.29:applicatiebeheer:probleemoplossing:programmablokken:xential|]]. +
  
 ====Formquery ==== ====Formquery ====
Regel 112: Regel 102:
  
 <adm warning> <adm warning>
-**LET OP:** Zorg dat de spellingchecker uit staat EN zorg dat de coderingen in het sjabloon zonder opmaak zijn (dus echt elke code selecteren en opmaak wissen uitvoeren)+**LET OP:** Zorg dat de spellingchecker uit staat EN zorg dat de coderingen in het sjabloon zonder opmaak zijn (dus echt elke code selecteren en opmaak wissen uitvoeren)\\ 
 +Tevens geldt dat indien er gebruik gemaakt wordt van input parameters, het gebruik van de **LIKE** operator NIET van toepassing is: in dat geval zal alles na karakter **%** opgevat worden als naam van een input parameter. Wil men toch zoeken op een gedeelte van een waarde gebruik dan substring selects
 </adm> </adm>
  
Regel 204: Regel 195:
 </code> </code>
  
-==== Query-variabelen ====+=== Query-variabelen ===
  
   * Bij afspraak geldt de variabele **:keyvergunning** – indien mogelijk - in een form- of childquery door OpenWave gevuld wordt met het betreffende waarde van de keykolom van de actieve Omgevingsvergunning, Handhaving, Bouw/sloopvergunning, Overige vergunning, Horecavergunning, Bestemmingsplan of Infoaanvraag, Milieu-gebruiksinrichting/vergunning/melding.    * Bij afspraak geldt de variabele **:keyvergunning** – indien mogelijk - in een form- of childquery door OpenWave gevuld wordt met het betreffende waarde van de keykolom van de actieve Omgevingsvergunning, Handhaving, Bouw/sloopvergunning, Overige vergunning, Horecavergunning, Bestemmingsplan of Infoaanvraag, Milieu-gebruiksinrichting/vergunning/melding. 
Regel 222: Regel 213:
  
 OpenWave heeft zelf een aantal functies op de database gedefinieerd - zoals fn_ddmaandjjjj() -  die gebruikt kunnen worden in allerlei queries. OpenWave heeft zelf een aantal functies op de database gedefinieerd - zoals fn_ddmaandjjjj() -  die gebruikt kunnen worden in allerlei queries.
-Zie:[[openwave:1.29:applicatiebeheer:instellen_inrichten:openwave_database-functies|OpenWave database functies]].+Zie:[[openwave:1.30:applicatiebeheer:instellen_inrichten:openwave_database-functies|OpenWave database functies]].
  
  
Regel 257: Regel 248:
   * de tabel in de header telt wel mee in de tellingen van het aantal tabellen. Dus stel dat in de header één tabel staat en in de body staat ook één tabel, dan verwijst de tabel van de body naar childquery2.   * de tabel in de header telt wel mee in de tellingen van het aantal tabellen. Dus stel dat in de header één tabel staat en in de body staat ook één tabel, dan verwijst de tabel van de body naar childquery2.
    
-==== Speciale childquery: samenvoegen met externe bron ====+=== Speciale childquery: samenvoegen met externe bron ===
  
 Het is mogelijk om delen van een sjabloon samen te voegen met gegevens uit een externe bron in plaats van met gegevens uit de OpenWave database. Dat kan vooralsnog alleen bij childqueries. Het is mogelijk om delen van een sjabloon samen te voegen met gegevens uit een externe bron in plaats van met gegevens uit de OpenWave database. Dat kan vooralsnog alleen bij childqueries.
Regel 263: Regel 254:
 Momenteel zijn daartoe enkel de volgende mogelijkheden:  Momenteel zijn daartoe enkel de volgende mogelijkheden: 
   * Opsomming van afgekeurde items uit digitale checklist. De tekst in de bijbehorende childquery moet zijn: //JSON_DigitaleChecklisten_Controle_brief_1    * Opsomming van afgekeurde items uit digitale checklist. De tekst in de bijbehorende childquery moet zijn: //JSON_DigitaleChecklisten_Controle_brief_1 
-//. Zie hiertoe het kopje //Instellingen voor overnemen van afgekeurde checklist-items in document// bij [[openwave:1.29:applicatiebeheer:probleemoplossing:programmablokken:digitale_checklijsten|Digitale checklisten]].+//. Zie hiertoe het kopje //Instellingen voor overnemen van afgekeurde checklist-items in document// bij [[openwave:1.30:applicatiebeheer:probleemoplossing:programmablokken:digitale_checklijsten|Digitale checklisten]].
  
-==== Speciale childquery: Opsommen aangewezen bijlages ====+=== Speciale childquery: Opsommen aangewezen bijlages ===
  
 De variabele **:keysaangewezenbijlages** kan gebruikt worden om in een childquery een resultaat set te verkrijgen van kaarten uit tbcorrespondentie (geregistreerde documenten) die de gebruiker heeft aangewezen als bijlages. De variabele :keysaangewezenbijlages worden door OpenWave on the fly vervangen door een opsomming van de dnkeys uit tbcorrespondentie die als bijlage zijn aangewezen gescheiden door een komma en tussen twee haakjes. De variabele **:keysaangewezenbijlages** kan gebruikt worden om in een childquery een resultaat set te verkrijgen van kaarten uit tbcorrespondentie (geregistreerde documenten) die de gebruiker heeft aangewezen als bijlages. De variabele :keysaangewezenbijlages worden door OpenWave on the fly vervangen door een opsomming van de dnkeys uit tbcorrespondentie die als bijlage zijn aangewezen gescheiden door een komma en tussen twee haakjes.
Regel 286: Regel 277:
 </code> </code>
    
-===== Invoegen tekstblokken op basis van een query-aanroep naar tbqueries ===== 
  
 +====Queries en gebruik van Xential ====
 +Queries worden gebruikt om een documentsjabloon te mergen met gegevens uit de database.\\ 
 +In het geval dat het OpenWave sjabloon een doorgeefluik is naar een Xential sjabloon (kolom dvnaaminexternsjablprog is dan gevuld), worden de resultsets van de queries gebruikt om een xml te construeren die Xential gebruikt om te mergen. Zie voor deze toepassing: [[openwave:1.30:applicatiebeheer:probleemoplossing:programmablokken:xential|]]. 
 +
 +====Formquery en childquery-verwijzingen naar tbqueries====
 +De inhoud van de kolommen van de formqueries en childqueries kan ook bestaan uit een verwijzing naar een query in de beheertabel tbqueries. Zie: [[openwave:1.30:applicatiebeheer:instellen_inrichten:queries|]]\\
 +Hierdoor hoeft een query die in meerdere sjablonen gebruikt wordt maar eenmalig te worden gedefinieerd.  De opmaak van de sjablonen wijzigt hierdoor niet.
 +<adm example>
 +formmquery_1 is bijvoorbeeld:
 +  select dvzaakcode, dvaanvraagnaam from tbomgvergunning where dnkey = :keyvergunning
 +en formquery_2 is bijvootrbeeld 
 +  select dvbedrijfsnaam, dvachternaam from tbcontactadressen where dnkey = :keyadres
 +Deze twee select statements kunnen nu vervangen worden door de volgende:\\
 +De inhoud van formquery_1 wordt dan
 +  %query(sjabloon_zaakgegevens,:keyvergunning)%
 +en die van formquery_2 wordt dan
 +  %query(sjabloon_geadresseerdegegevens,:keyadres)%
 +  
 +In de tabel tbqueries dienen vervolgens twee kaarten aangemaakt te worden:\\
 +Eén met de naam //sjabloon_zaakgegevens// met de inhoud:
 +  select dvzaakcode, dvaanvraagnaam from tbomgvergunning where dnkey = {id}
 +en één met de naam //sjabloon_geadresseerdegegevens// met als inhoud
 +  select dvbedrijfsnaam, dvachternaam from tbcontactadressen where dnkey = {id}
 +</adm>
  
 +==== Invoegen tekstblokken o.b.v. query-aanroep naar tbqueries ====
 Er kan in het sjabloon een speciale vorm van merge-codering worden opgenomen die verwijst naar een kaart in tbqueries. In dat geval wordt die aangeroepen query geëvalueerd en het resultaat wordt op de bewuste plek in het sjabloon ingevoegd. Een dergelijke verwijzing ziet er als volgt uit:  Er kan in het sjabloon een speciale vorm van merge-codering worden opgenomen die verwijst naar een kaart in tbqueries. In dat geval wordt die aangeroepen query geëvalueerd en het resultaat wordt op de bewuste plek in het sjabloon ingevoegd. Een dergelijke verwijzing ziet er als volgt uit: 
   * <%query(codevanquery)%>    * <%query(codevanquery)%> 
Regel 325: Regel 340:
  
 In de tabel tbtekstblokken (beheertegel //Tekstblokken//) kunnen deze tekstblokken gedefinieerd worden die op bovenstaande wijze in meerdere sjablonen op conditie kunnen worden aangeroepen. In de tabel tbtekstblokken (beheertegel //Tekstblokken//) kunnen deze tekstblokken gedefinieerd worden die op bovenstaande wijze in meerdere sjablonen op conditie kunnen worden aangeroepen.
-Zie ook: [[openwave:1.29:applicatiebeheer:instellen_inrichten:queries|Queries]].+Zie ook: [[openwave:1.30:applicatiebeheer:instellen_inrichten:queries|Queries]].
  
-==== Invoegen plaatje op basis van een query-aanroep naar tbqueries die verwijst naar tbimages ====+==== Invoegen plaatje o.b.v. query-aanroep naar tbqueries ====
  
-Er kan in het sjabloon een speciale vorm van merge-codering worden opgenomen die verwijst naar een kaart in tbqueries t.b.v. opnemen plaatjes. In dat geval wordt die aangeroepen query geëvalueerd en het resultaat van die query MOET verwijzen naar een unieke dvcode uit de tabel tbimages. Het plaatsje uit tbimages wordt op de bewuste plek in het sjabloon ingevoegd. Een dergelijke verwijzing ziet er als volgt uit: +Er kan in het sjabloon een speciale vorm van merge-codering worden opgenomen die verwijst naar een kaart in tbqueries t.b.v. opnemen plaatjes. In dat geval wordt die aangeroepen query geëvalueerd en het resultaat van die query MOET verwijzen naar een unieke dvcode uit de tabel **tbimages**. Het plaatje uit tbimages wordt op de bewuste plek in het sjabloon ingevoegd. Een dergelijke verwijzing ziet er als volgt uit: 
   * <%imagequery(codevanquery)%>    * <%imagequery(codevanquery)%> 
   * of <%imagequery(codevanquery,:keyvergunning)%>   * of <%imagequery(codevanquery,:keyvergunning)%>
Regel 356: Regel 371:
  
  
-===== Tonen Wave briefnummer =====+==== Tonen Wave briefnummer ====
 (indien instelling //Sectie: Documenten, Item: WaveBriefNummer// is aangevinkt) (indien instelling //Sectie: Documenten, Item: WaveBriefNummer// is aangevinkt)
  
Regel 365: Regel 380:
 Indien //Getal1// van //Sectie: Documenten Item: Documentregistratie// de waarde 1 heeft, dan wordt het gecreëerde document op basis van dit sjabloon automatisch op geslagen in de geregistreerde documenten (tbcorrespondentie), waarbij de kolom dvbriefcode de waarde van deze teller krijgt (ongeacht of deze  teller in het sjabloon is opgenomen). Indien //Getal1// van //Sectie: Documenten Item: Documentregistratie// de waarde 1 heeft, dan wordt het gecreëerde document op basis van dit sjabloon automatisch op geslagen in de geregistreerde documenten (tbcorrespondentie), waarbij de kolom dvbriefcode de waarde van deze teller krijgt (ongeacht of deze  teller in het sjabloon is opgenomen).
  
-===== Tonen externe documentidentifier =====+==== Tonen externe documentidentifier ====
  
 De string <%ExtDocIdent%> (let op kamelennotatie) zal worden vervangen door de externe documentidentifier die verkregen wordt door een Stuf Zaak/DMS genereerdocumentidentificatie-bericht. Alleen van toepassing indien automatische opslag in een DMS via stufzaak/DMS. Wanneer OpenWave geen externe documentidentifier kan bemachtigen, wordt de string <%ExtDocIdent%> vervangen door een lege string. De string <%ExtDocIdent%> (let op kamelennotatie) zal worden vervangen door de externe documentidentifier die verkregen wordt door een Stuf Zaak/DMS genereerdocumentidentificatie-bericht. Alleen van toepassing indien automatische opslag in een DMS via stufzaak/DMS. Wanneer OpenWave geen externe documentidentifier kan bemachtigen, wordt de string <%ExtDocIdent%> vervangen door een lege string.
  
-===== Tonen gecrypte versie van een kolomwaarde =====+==== Tonen gecrypte versie van een kolomwaarde ====
  
-Verder kan de encryptiemethode worden aangeroepen vanuit het documentsjabloon. De string <%strEncrypt(:columnname)%> in een sjabloon wordt bij het creëren van een document als volgt geïnterpreteerd. Het programma zal columnname interpreteren als een kolomnaam uit de hoofdtabel van het sjabloon. De waarde van die kolom wordt gecrypt volgens de ingestelde methode (zie: [[openwave:1.29:applicatiebeheer:instellen_inrichten:2way_encryptie_externe_wachtwoorden]]) en deze gecrypte waarde wordt in het document opgenomen op de betreffende plaats. Voorbeeld: <%strEncrypt(:dnkey)%>.+Verder kan de encryptiemethode worden aangeroepen vanuit het documentsjabloon. De string <%strEncrypt(:columnname)%> in een sjabloon wordt bij het creëren van een document als volgt geïnterpreteerd. Het programma zal columnname interpreteren als een kolomnaam uit de hoofdtabel van het sjabloon. De waarde van die kolom wordt gecrypt volgens de ingestelde methode (zie: [[openwave:1.30:applicatiebeheer:instellen_inrichten:2way_encryptie_externe_wachtwoorden]]) en deze gecrypte waarde wordt in het document opgenomen op de betreffende plaats. Voorbeeld: <%strEncrypt(:dnkey)%>.
  
  
Regel 379: Regel 394:
  
 Uitzondering hierop zijn de hierboven behandelde strings <%query(codevanquery)%>, <%iamgequery(codevanquery)%>, <%Teller%> en <%strEncrypt(:dnkey)%>. Elke query kan 0 of meer parameters hebben. Uitzondering hierop zijn de hierboven behandelde strings <%query(codevanquery)%>, <%iamgequery(codevanquery)%>, <%Teller%> en <%strEncrypt(:dnkey)%>. Elke query kan 0 of meer parameters hebben.
 +
 +<adm warning>
 +**LET OP:** Indien er gebruik gemaakt wordt van input parameters, is het niet mogelijk om de **LIKE** operator te gebruiken in ALLE Form query's: in dat geval zal alles na karakter **%** opgevat worden als naam van een input parameter. Wil men toch zoeken op een gedeelte van een waarde gebruik dan substring selects
 +</adm>
  
 ==== Parameterkolommen ==== ==== Parameterkolommen ====
Regel 447: Regel 466:
   * een integer of string inputparameter zonder quootjes of extra functie in de query kan worden opgenomen: zoals %Zomaareeninteger%   * een integer of string inputparameter zonder quootjes of extra functie in de query kan worden opgenomen: zoals %Zomaareeninteger%
   * een floatparameter alleen ingebracht kan worden als type string en dat die dan gecast wordt naar float   * een floatparameter alleen ingebracht kan worden als type string en dat die dan gecast wordt naar float
-  * een datumparameter gecast moet worden naar datum met bijv. to_date functie waarbij de ingevoerde datum wordt aangeleverd als yyyy-mm-dd.+  * een datumparameter kan op verschillende manieren gecast worden in een query bijvoornbeeld: 
 +    * to_char(%Zomaardatum%::DATE,'DD-MM-YYYY')   : resultaat: 16-07-2024 
 +    * fn_ddmaandjjjj(%Zomaardatum%) : resultaat: 16 juli 2024 
 +    * fn_ddmaandjjjj(to_date(%Zomaardatum%,'yyyy-mm-dd')) : resultaat: 16 juli 2024 
 +    * %Zomaardatum%  : resultaat: 2024-07-16 +02
  
 Er zijn dus 5 invoerparameters: Er zijn dus 5 invoerparameters:
Regel 469: Regel 492:
 </code> </code>
  
-=====formquery en childquery-verwijzingen naar tbqueries===== +
-De inhoud van de kolommen van de formqueries en childqueries kan ook bestaan uit een verwijzing naar een query in de beheertabel tbqueries. Zie: [[openwave:1.29:applicatiebeheer:instellen_inrichten:queries|]]\\ +
-Hierdoor hoeft een query die in meerdere sjablonen gebruikt wordt maar eenmalig te worden gedefinieerd.  De opmaak van de sjablonen wijzigt hierdoor niet. +
-<adm example> +
-formmquery_1 is bijvoorbeeld: +
-  select dvzaakcode, dvaanvraagnaam from tbomgvergunning where dnkey = :keyvergunning +
-en formquery_2 is bijvootrbeeld  +
-  select dvbedrijfsnaam, dvachternaam from tbcontactadressen where dnkey = :keyadres +
-Deze twee select statements kunnen nu vervangen worden door de volgende:\\ +
-De inhoud van formquery_1 wordt dan +
-  %query(sjabloon_zaakgegevens,:keyvergunning)% +
-en die van formquery_2 wordt dan +
-  %query(sjabloon_geadresseerdegegevens,:keyadres)% +
-   +
-In de tabel tbqueries dienen vervolgens twee kaarten aangemaakt te worden:\\ +
-Eén met de naam //sjabloon_zaakgegevens// met de inhoud: +
-  select dvzaakcode, dvaanvraagnaam from tbomgvergunning where dnkey = {id} +
-en één met de naam //sjabloon_geadresseerdegegevens// met als inhoud +
-  select dvbedrijfsnaam, dvachternaam from tbcontactadressen where dnkey = {id} +
-</adm>+
  • openwave/1.30/applicatiebeheer/instellen_inrichten/documentsjablonen.1704701211.txt.gz
  • Laatst gewijzigd: 2024/01/08 09:06
  • door 127.0.0.1