openwave:1.31:applicatiebeheer:probleemoplossing:programmablokken:xential

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.31:applicatiebeheer:probleemoplossing:programmablokken:xential [2024/11/26 06:07] – Externe bewerking (Ongeldige datum) 127.0.0.1openwave:1.31:applicatiebeheer:probleemoplossing:programmablokken:xential [2025/07/01 10:49] (huidige) – Kars Gottschal
Regel 1: Regel 1:
-======Xential====== +====== Xential ====== 
-=====Beschrijving===== + 
-Er kan een koppeling gelegd worden met de Xential-sjabloongenerator. Dat betekent dat vanuit OpenWave een sjabloon van Xential wordt aangeroepen met de nodige merge-data. De gebruiker bewerkt dit document vervolgens ter plekke in Xential waarbij de merge-data door Xential reeds in het sjabloon zijn verwerkt.\\ +===== Beschrijving ===== 
 + 
 +Er kan een koppeling gelegd worden met de Xential-sjabloongenerator. Dat betekent dat vanuit OpenWave een sjabloon van Xential wordt aangeroepen met de nodige merge-data. De gebruiker bewerkt dit document vervolgens ter plekke in Xential waarbij de merge-data door Xential reeds in het sjabloon zijn verwerkt. 
 Met de Xential opdracht //creëer document// wordt het samengestelde document terug naar OpenWave verzonden en OpenWave plaatst het document vervolgens op de aangewezen plaats (fileserver of DMS) en - indien zo ingesteld - registreert het document in tbcorrespondentie. Met de Xential opdracht //creëer document// wordt het samengestelde document terug naar OpenWave verzonden en OpenWave plaatst het document vervolgens op de aangewezen plaats (fileserver of DMS) en - indien zo ingesteld - registreert het document in tbcorrespondentie.
  
-=====Noodzakelijke instellingen ===== +===== Noodzakelijke instellingen ===== 
-====Endpoints en credentials====+ 
 +==== Endpoints en credentials ==== 
 Zie  [[openwave:1.31:applicatiebeheer:instellen_inrichten:configuratie:sectie_xential|]] voor de instellingen in de configuratietabel (tbinitialisatie) met betrekking tot endpoints en credentials. Zie  [[openwave:1.31:applicatiebeheer:instellen_inrichten:configuratie:sectie_xential|]] voor de instellingen in de configuratietabel (tbinitialisatie) met betrekking tot endpoints en credentials.
  
-====Sjabloon verwijzing====+==== Sjabloon verwijzing ==== 
 Een OpenWave sjabloon (beheerportaal-Nieuw, kolom: Werkbeheer, tegel: Documentsjablonen) kan aangemerkt worden als Xential-sjabloon door de kolom //naam sjabloon in Xential// (dvnaaminexternsjablprog) te vullen. Dit moet gebeuren met de Xential-groepsnaam gevolgd door /../ gevolgd door de Xential templatenaam. Bijvoorbeeld: //ditiseengroep/../testtemplate//. \\ Een OpenWave sjabloon (beheerportaal-Nieuw, kolom: Werkbeheer, tegel: Documentsjablonen) kan aangemerkt worden als Xential-sjabloon door de kolom //naam sjabloon in Xential// (dvnaaminexternsjablprog) te vullen. Dit moet gebeuren met de Xential-groepsnaam gevolgd door /../ gevolgd door de Xential templatenaam. Bijvoorbeeld: //ditiseengroep/../testtemplate//. \\
-Aangezien OpenWave zorg draagt voor de opslag van het samengestelde Xential-document en de registratie daarvan, zijn alle OpenWave-sjabloonkolommen nog steeds geldig.\\+Aangezien OpenWave zorg draagt voor de opslag van het samengestelde Xential-document en de registratie daarvan, zijn alle OpenWave-sjabloonkolommen nog steeds geldig. 
 Alleen de queries die gebruikt worden om een OpenWave sjabloon te mergen met kolommen uit de database krijgen bij een Xential-sjabloon een andere functie namelijk om een xml samen te stellen die door Xential gebruikt gaat worden om het sjabloon te mergen.\\ Alleen de queries die gebruikt worden om een OpenWave sjabloon te mergen met kolommen uit de database krijgen bij een Xential-sjabloon een andere functie namelijk om een xml samen te stellen die door Xential gebruikt gaat worden om het sjabloon te mergen.\\
  
-====Queries tbv xmlopmaak====+==== Queries tbv xmlopmaak ==== 
 Een mergeveld in een Xential-sjabloon wordt gedefinieerd door een tag-verwijzing naar die meegeleverde xml. Bijvoorbeeld indien een kolom wavezaakcode in Xential een tagverwijzing krijgt van <root><zaak><identificatie> dan moet die wavezaakcode dus onder die tagbenamingen in de xml worden aangeleverd.  Een mergeveld in een Xential-sjabloon wordt gedefinieerd door een tag-verwijzing naar die meegeleverde xml. Bijvoorbeeld indien een kolom wavezaakcode in Xential een tagverwijzing krijgt van <root><zaak><identificatie> dan moet die wavezaakcode dus onder die tagbenamingen in de xml worden aangeleverd. 
  
Regel 30: Regel 38:
      
 dan moet formquery1 als volgt zijn gevuld: dan moet formquery1 als volgt zijn gevuld:
 +
 +<code sql>
   select    select 
   '<root>',   '<root>',
Regel 38: Regel 48:
   from tbomgvergunning a   from tbomgvergunning a
   where a.dnkey = :keyvergunning   where a.dnkey = :keyvergunning
- +</code> 
 en moet formquery2 als volgt zijn gevuld: en moet formquery2 als volgt zijn gevuld:
 +
 +<code sql>
   select '<contactgegevens>',   select '<contactgegevens>',
   '<handelsnaam>' || coalesce(a.dvbedrijfsnaam,'') || '</handelsnaam>',   '<handelsnaam>' || coalesce(a.dvbedrijfsnaam,'') || '</handelsnaam>',
Regel 47: Regel 60:
   from tbcontactadressen a   from tbcontactadressen a
   where a.dnkey = :keyadres   where a.dnkey = :keyadres
 +</code>
 +
 </adm> </adm>
  
 OpenWave plakt alle regels van de resultsets van de queries achter elkaar en zo ontstaat de gewenste xml. OpenWave plakt alle regels van de resultsets van de queries achter elkaar en zo ontstaat de gewenste xml.
  
-Indien één van de tags in de query de waarde //<docidentifier/>// bevat dan wordt deze door OpenWave gevuld met een opgehaalde **documentidentifier uit het DMS** mits  +Indien één van de tags in de query de waarde //<docidentifier/>// bevat dan wordt deze door OpenWave gevuld met een opgehaalde **documentidentifier uit het DMS** mits de instelling //Sectie: Xential en Item: Genereervoorafdocidentifier// aangevinkt is EN //Getal1// van //Sectie: Xential en Item: methode// de waarde 2 heeft (dus gegenereerde document wordt via stuf/zaak in DMS opgeslagen). 
-de instelling //Sectie: Xential en Item: Genereervoorafdocidentifier// aangevinkt is EN //Getal1// van //Sectie: Xential en Item: methode// de waarde 2 heeft (dus gegenereerde document wordt via stuf/zaak in DMS opgeslagen). \\ + 
-OpenWave zal in dat geval, vóórdat Xential aangeroepen wordt, bij het DMS een documentidentifier opvragen (genereerDocumentidentificatie) en de tag //<docidentifier/>// vervangen door //<docidentifier>hierstaatdeopgehaaldewaarde</docidentifier>//.\\+OpenWave zal in dat geval, vóórdat Xential aangeroepen wordt, bij het DMS een documentidentifier opvragen (genereerDocumentidentificatie) en de tag //<docidentifier/>// vervangen door //<docidentifier>hierstaatdeopgehaaldewaarde</docidentifier>//.
  
 <adm warning> <adm warning>
Regel 60: Regel 75:
 </adm> </adm>
  
-=====Werkwijze=====+===== Werkwijze ===== 
 Wanneer de gebruiker met de OpenWave-wizard //creëer document// een sjabloon aanwijst dat gekoppeld is aan een Xential-sjabloon zal OpenWave met behulp van alle ingestelde endpoints en credentials een zogenaamd ticketID opvragen, waarbij een merge-xml op basis van de formqueries door OpenWave bij Xential wordt afgeleverd.\\ Wanneer de gebruiker met de OpenWave-wizard //creëer document// een sjabloon aanwijst dat gekoppeld is aan een Xential-sjabloon zal OpenWave met behulp van alle ingestelde endpoints en credentials een zogenaamd ticketID opvragen, waarbij een merge-xml op basis van de formqueries door OpenWave bij Xential wordt afgeleverd.\\
 In de OpenWave tabel tbupload wordt een kaart aangemaakt met een door OpenWave op dat moment uitgetrokken UUID met metadata als vertrouwelijkheid, herkomst, bestemming e.d. Deze uuid en de filenaam zoals deze is opgegeven in het wave-sjabloon worden meegestuurd met de aanvraag van de ticketid.\\ In de OpenWave tabel tbupload wordt een kaart aangemaakt met een door OpenWave op dat moment uitgetrokken UUID met metadata als vertrouwelijkheid, herkomst, bestemming e.d. Deze uuid en de filenaam zoals deze is opgegeven in het wave-sjabloon worden meegestuurd met de aanvraag van de ticketid.\\
 Xential construeert een URL voor de gebruiker waarin template en ticketid zijn opgenomen. OpenWave stuurt de gebruiker door naar deze Xential URL in een apart tabblad. Op de Xential URL is de template geopend en gemerged met de aangeleverde xml uit OpenWave. OpenWave en Xential fungeren op dat moment onafhankelijk van elkaar.\\ Xential construeert een URL voor de gebruiker waarin template en ticketid zijn opgenomen. OpenWave stuurt de gebruiker door naar deze Xential URL in een apart tabblad. Op de Xential URL is de template geopend en gemerged met de aangeleverde xml uit OpenWave. OpenWave en Xential fungeren op dat moment onafhankelijk van elkaar.\\
-Wanneer de gebruiker in Xential de opdracht geeft om het samengestelde document daadwerkelijk te creëren, wordt de webhookservice (endpointwebhookurl) van OpenWave aangeroepen door Xential met het document en het eerder doorgegeven UUID nummer en filenaam. Xential kan daarmee afgesloten worden.\\ +Wanneer de gebruiker in Xential de opdracht geeft om het samengestelde document daadwerkelijk te creëren, wordt de webhookservice (endpointwebhookurl) van OpenWave aangeroepen door Xential met het document en het eerder doorgegeven UUID nummer en filenaam. Xential kan daarmee afgesloten worden. 
 De webhookservice van OpenWave slaat het document tijdelijk op (onder het UUID nummer+ _ + de filenaam) in de uploadmap op de OpenWave server (kolom //Tekst// van //Sectie: OWB, Item: TussenmapUploadfiles//) en roept vervolgens de interne OpenWave API uploadfile aan met het UUID nummer. \\ De webhookservice van OpenWave slaat het document tijdelijk op (onder het UUID nummer+ _ + de filenaam) in de uploadmap op de OpenWave server (kolom //Tekst// van //Sectie: OWB, Item: TussenmapUploadfiles//) en roept vervolgens de interne OpenWave API uploadfile aan met het UUID nummer. \\
-De OpenWave API haalt op grond van het UUID nummer de herkomst- en bestemmingsgegevens op uit de tabel tbupload en plaatst het document op de fileserver of met stuf zaak/dms in het DMS.\\+De OpenWave API haalt op grond van het UUID nummer de herkomst- en bestemmingsgegevens op uit de tabel tbupload en plaatst het document op de fileserver of met stuf zaak/dms in het DMS.
  
 Zo nodig (//Sectie: DocumentregistReren Item: AlleHandmatigeUploads// is aangevinkt of tbcompartiment.dldocregallehandmuploads is //T//) wordt een registratie aangemaakt in tbcorrespondentie.\\  Zo nodig (//Sectie: DocumentregistReren Item: AlleHandmatigeUploads// is aangevinkt of tbcompartiment.dldocregallehandmuploads is //T//) wordt een registratie aangemaakt in tbcorrespondentie.\\ 
  • openwave/1.31/applicatiebeheer/probleemoplossing/programmablokken/xential.1732597677.txt.gz
  • Laatst gewijzigd: 2024/11/26 06:07
  • door 127.0.0.1