openwave:1.32:applicatiebeheer:probleemoplossing:programmablokken:upload_dso-document_vanuit_digi-koppelaar

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
Volgende revisie		 Vorige revisie
openwave:1.32:applicatiebeheer:probleemoplossing:programmablokken:upload_dso-document_vanuit_digi-koppelaar [2025/07/01 10:59] – aangemaakt - Externe bewerking 127.0.0.1openwave:1.32:applicatiebeheer:probleemoplossing:programmablokken:upload_dso-document_vanuit_digi-koppelaar [2025/12/18 11:47] (huidige) – Kars Gottschal
Regel 1: Regel 1:
 ====== Verwerken DSO-bijlagen  ====== ====== Verwerken DSO-bijlagen  ======
 +
 Er zijn twee manieren waarop OpenWave de daadwerkelijke bijlagen uit het DSO binnenhaalt en verwerkt. Er zijn twee manieren waarop OpenWave de daadwerkelijke bijlagen uit het DSO binnenhaalt en verwerkt.
   * OpenWave haalt zelf de bijlagen en verzoek.pdf op met de DSO-AfhandelenVerzoek-API. Dit gebeurt na het verwerken van een binnengekomen DSO-verzoekbericht. Zie hiervoor het kopje //Ophalen en registreren van bijlages en verzoek.pdf// van [[openwave:1.32:applicatiebeheer:probleemoplossing:programmablokken:verwerking_dso_stam_berichten]]\\ Deze weg is te prevaleren omdat alleen de nodige documenten worden opgehaald op grond van gevraagde registratienummers.   * OpenWave haalt zelf de bijlagen en verzoek.pdf op met de DSO-AfhandelenVerzoek-API. Dit gebeurt na het verwerken van een binnengekomen DSO-verzoekbericht. Zie hiervoor het kopje //Ophalen en registreren van bijlages en verzoek.pdf// van [[openwave:1.32:applicatiebeheer:probleemoplossing:programmablokken:verwerking_dso_stam_berichten]]\\ Deze weg is te prevaleren omdat alleen de nodige documenten worden opgehaald op grond van gevraagde registratienummers.
Regel 7: Regel 8:
  
 ===== Verwerken DSO-bijlagen vanuit digi-koppelaar  ===== ===== Verwerken DSO-bijlagen vanuit digi-koppelaar  =====
 +
 Dit is het geval indien  de instelling //Sectie: OWB// en //Item: OphalenDSODocsViaApi// **NIET** aangevinkt is OF indien de instelling //Sectie: DocumentRegistreren// en //Item: AlleOLODSOUploads// **NIET** aangevinkt is ( of - als het verzoekbericht gaat over een compartiment - indien tbcompartiment.dldocregalleolodsouploads niet is aangevinkt). Dit is het geval indien  de instelling //Sectie: OWB// en //Item: OphalenDSODocsViaApi// **NIET** aangevinkt is OF indien de instelling //Sectie: DocumentRegistreren// en //Item: AlleOLODSOUploads// **NIET** aangevinkt is ( of - als het verzoekbericht gaat over een compartiment - indien tbcompartiment.dldocregalleolodsouploads niet is aangevinkt).
  
Regel 26: Regel 28:
 </adm> </adm>
  
-OpenWave plaatst het document eerst op de DSO-tempmap (kolom //Tekst// van de instelling://Sectie: OWB// en //Item: TussenMapDSOUploadfiles//) onder de naam verzoeknummer + underscore + de aangeleverde naam van de digi-koppelaar.\\ +OpenWave plaatst het document eerst op de DSO-tempmap (kolom //Tekst// van de instelling://Sectie: OWB// en //Item: TussenMapDSOUploadfiles//) onder de naam verzoeknummer + underscore + de aangeleverde naam van de digi-koppelaar. 
-Vanuit deze tempmap wordt het document vervolgens verwerkt bij de juiste zaak en opgeslagen onder de naam die door de digi-koppelaar is aangeleverd.\\ +Vanuit deze tempmap wordt het document vervolgens verwerkt bij de juiste zaak en opgeslagen onder de naam die door de digi-koppelaar is aangeleverd. 
-Dat wil zeggen óf - via stuf zaak/dms - in het DMS óf op de fileserver op de map gedefinieerd door de kolom //Tekst// van instelling //Sectie: Aanmaakmappen// en waarbij item begint met //Omgeving_// en waarbij //Getal2 = 1//.\\+Dat wil zeggen óf - via stuf zaak/dms - in het DMS óf op de fileserver op de map gedefinieerd door de kolom //Tekst// van instelling //Sectie: Aanmaakmappen// en waarbij item begint met //Omgeving_// en waarbij //Getal2 = 1//.
 Indien ingesteld dat het document geregistreerd moet worden in tbcorrespondentie dan gebeurt dat in de kolom dvdocfilenaam met - in geval van opslag in DMS - alleen met de bestandnaam en - in geval van opslag op fileserver - met het volledige pad + bestandsnaam. Indien ingesteld dat het document geregistreerd moet worden in tbcorrespondentie dan gebeurt dat in de kolom dvdocfilenaam met - in geval van opslag in DMS - alleen met de bestandnaam en - in geval van opslag op fileserver - met het volledige pad + bestandsnaam.
  
  
-==== Werkwijze DSO-bijlagen via digi-koppelaar====+==== Werkwijze DSO-bijlagen via digi-koppelaar ====
  
-De DSO/PHP-luisterservice plaatst de binnengekomen file op een map op de webserver.\\ +De DSO/PHP-luisterservice plaatst de binnengekomen file op een map op de webserver. 
-Deze map is gedefinieerd in kolom //Tekst// van de instelling: //Sectie: OWB// en //Item: TussenMapDSOUploadfiles//.\\+Deze map is gedefinieerd in kolom //Tekst// van de instelling: //Sectie: OWB// en //Item: TussenMapDSOUploadfiles//.
 In de kolom //Tekst// staat de mapnaam op de webserver: deze mapnaam MOET eindigen op de karakterreeks: '/openwave/uploaddso/' en beginnen met een '/'. In de kolom //Tekst// staat de mapnaam op de webserver: deze mapnaam MOET eindigen op de karakterreeks: '/openwave/uploaddso/' en beginnen met een '/'.
 De luisterservice roept hiertoe de API getAuthorisation aan en daarna met de verkregen sessie-sleutel de API geefInstellingen (om de DSOUploadmap op te halen) en tenslotte de API Uploadfile. De luisterservice roept hiertoe de API getAuthorisation aan en daarna met de verkregen sessie-sleutel de API geefInstellingen (om de DSOUploadmap op te halen) en tenslotte de API Uploadfile.
Regel 65: Regel 67:
 Indien OpenWave de zaak heeft gevonden kan het zijn dat een extra controle wenselijk is of het document al bestaat bij de gevonden zaak. Dat gebeurt indien bijlages ook worden geregistreerd in tbcorrespondentie (indien dus //Sectie: DocumentRegistreren// en //Item: AlleOLODSOUploads// is aangevinkt) EN de instelling //Sectie: Koppeling OLO en Item: CheckOpDubbeleDocumentnaam// is aangevinkt. Dan checkt OpenWave of de documentnaam reeds voorkomt in de geregistreerde documenten bij de gevonden zaak (kolom dvdocfilenaam). Zo ja, dan wordt het document niet geplaatst en wel een kaart gemaakt in tabel mislukte OLO/DSO-bijlages.   Indien OpenWave de zaak heeft gevonden kan het zijn dat een extra controle wenselijk is of het document al bestaat bij de gevonden zaak. Dat gebeurt indien bijlages ook worden geregistreerd in tbcorrespondentie (indien dus //Sectie: DocumentRegistreren// en //Item: AlleOLODSOUploads// is aangevinkt) EN de instelling //Sectie: Koppeling OLO en Item: CheckOpDubbeleDocumentnaam// is aangevinkt. Dan checkt OpenWave of de documentnaam reeds voorkomt in de geregistreerde documenten bij de gevonden zaak (kolom dvdocfilenaam). Zo ja, dan wordt het document niet geplaatst en wel een kaart gemaakt in tabel mislukte OLO/DSO-bijlages.  
  
-{{openwave:applicatiebeheer:probleemoplossing:programmablokken:dsodubbelecheckopingeschotendocumenten.png?900|}}+{{openwave:applicatiebeheer:probleemoplossing:programmablokken:dsodubbelecheckopingeschotendocumenten.png?900|dsodubbelecheckopingeschotendocumenten}}
  
-**ad 1. De bijlages worden door de digi-koppelaar geplaatst op het daartoe bestemde endpoint**\\ +**ad 1. De bijlages worden door de digi-koppelaar geplaatst op het daartoe bestemde endpoint** 
-De bijlagenaam is dus de documentnaam zoals door Jnet of door EnableU is doorgeschoten.\\+De bijlagenaam is dus de documentnaam zoals door Jnet of door EnableU is doorgeschoten.
 Indien vanuit Jnet ingeschoten dan bestaat de bijlagenaam uit het OIN-nummer (20 posities) gevolgd door hyphen gevolgd door DSO-verzoeknummer (13 posities) gevolgd door hyphen gevolgd door het versienummer (bestaande uit drie posities) en dan een hyphen en dan de pure documentnaam).   Indien vanuit Jnet ingeschoten dan bestaat de bijlagenaam uit het OIN-nummer (20 posities) gevolgd door hyphen gevolgd door DSO-verzoeknummer (13 posities) gevolgd door hyphen gevolgd door het versienummer (bestaande uit drie posities) en dan een hyphen en dan de pure documentnaam).  
 Indien door EnableU dan is de bijlagenaam gelijk aan de pure documentnaam. Indien door EnableU dan is de bijlagenaam gelijk aan de pure documentnaam.
Regel 84: Regel 86:
 Aan de bijlagenamen is niet af te leiden of het document daadwerkelijk is gewijzigd ten opzichte van het origineel of niet. Aan de bijlagenamen is niet af te leiden of het document daadwerkelijk is gewijzigd ten opzichte van het origineel of niet.
  
-**ad 2. Bestaat de bijlage wel fysiek op de tempmap?**\\ +**ad 2. Bestaat de bijlage wel fysiek op de tempmap?** 
-De tempmap is in dit geval de tussenmap op de server gedefinieerd door de kolom //Tekst// van instelling //Sectie: OWB// en //Item: TussenMapDsoUploadfiles//.\\ +De tempmap is in dit geval de tussenmap op de server gedefinieerd door de kolom //Tekst// van instelling //Sectie: OWB// en //Item: TussenMapDsoUploadfiles//. 
-De filenaam die daar is opgeslagen is de bijlagenaam (zie ad1) voorafgegaan door het DSO-verzoeknummer en een hypen.\\+De filenaam die daar is opgeslagen is de bijlagenaam (zie ad1) voorafgegaan door het DSO-verzoeknummer en een hypen.
  
-**ad 3. is de bijlagenaam een Jnet of een EnableU naam?**\\+**ad 3. is de bijlagenaam een Jnet of een EnableU naam?**
 OpenWave kijkt hiertoe naar //Getal 1// van de instelling //Sectie: Koppeling OLO// en //Item: CheckOpDubbeleDocumentnaam//. Indien 1 dan wordt er vanuit gegaan dat de bijlagenaam een EnableU-naam is. Indien ongelijk aan 1 dan dus een Jnet-naam. OpenWave kijkt hiertoe naar //Getal 1// van de instelling //Sectie: Koppeling OLO// en //Item: CheckOpDubbeleDocumentnaam//. Indien 1 dan wordt er vanuit gegaan dat de bijlagenaam een EnableU-naam is. Indien ongelijk aan 1 dan dus een Jnet-naam.
  
-**ad 4. Bestaat de bijlagenaam reeds in tbcorrespondentie.dvdocfilenaam?**\\ +**ad 4. Bestaat de bijlagenaam reeds in tbcorrespondentie.dvdocfilenaam?** 
-In geval van Jnet-naam wordt de bijlagenaam gezocht zonder OIN-nummer. Dus stel de bijlagenaam is //00099999999999999999-0123456789123-000-kameel.docx//, dan wordt hier gekeken of de string //0123456789123-000-kameel.docx// voorkomt in de documentnamen van tbcorrespondentie bij de omgevingzaak die hoort bij het verzoeknummer.\\+In geval van Jnet-naam wordt de bijlagenaam gezocht zonder OIN-nummer. Dus stel de bijlagenaam is //00099999999999999999-0123456789123-000-kameel.docx//, dan wordt hier gekeken of de string //0123456789123-000-kameel.docx// voorkomt in de documentnamen van tbcorrespondentie bij de omgevingzaak die hoort bij het verzoeknummer.
 Er wordt gezocht binnen de kolom dvdocfilenaam van tbcorrespondentie: het laatste gedeelte van de dvdocfilenaam moet gelijk zijn aan de bijlagenaam. Er wordt gezocht binnen de kolom dvdocfilenaam van tbcorrespondentie: het laatste gedeelte van de dvdocfilenaam moet gelijk zijn aan de bijlagenaam.
  
-**ad 5. Bestaat de pure bijlagenaam en dsovolgnr in tbomgoloberichten?**\\ +**ad 5. Bestaat de pure bijlagenaam en dsovolgnr in tbomgoloberichten?** 
-Het DSO-volgnummer is bij Jnet bepaald door het betreffende gedeelte uit de bijlagenaam en bij EnableU door de kolom ***dsovolgnr** van de betreffende omgevingzaak.\\ +Het DSO-volgnummer is bij Jnet bepaald door het betreffende gedeelte uit de bijlagenaam en bij EnableU door de kolom ***dsovolgnr** van de betreffende omgevingzaak. 
-OpenWave kijkt alleen indien het DSO-volgnummer ongelijk aan //000// is of er een kaart bestaat in tbomgoloberichten bij de betreffende omgevingzaak met als dvlvobestandnaam de pure bijlagenaam EN waarbij dvdsovolgnr gelijk is aan DSO-volgnummer EN waarbij dddsovervallen leeg is. Die pure bijlagenaam is bij EnableU gelijk aan de bijlagenaam. Bij Jnet is de pure bijlagenaam de bijlagenaam zonder OIN-nummer en zonder verzoeknummer en zonder volgnummer. \\+OpenWave kijkt alleen indien het DSO-volgnummer ongelijk aan //000// is of er een kaart bestaat in tbomgoloberichten bij de betreffende omgevingzaak met als dvlvobestandnaam de pure bijlagenaam EN waarbij dvdsovolgnr gelijk is aan DSO-volgnummer EN waarbij dddsovervallen leeg is. Die pure bijlagenaam is bij EnableU gelijk aan de bijlagenaam. Bij Jnet is de pure bijlagenaam de bijlagenaam zonder OIN-nummer en zonder verzoeknummer en zonder volgnummer. 
 Deze stap geldt niet voor de verzoek.pdf want dit is geen bijlage in tbomgoloberichten (en zit dus ook niet in het STAM-bericht).  Deze stap geldt niet voor de verzoek.pdf want dit is geen bijlage in tbomgoloberichten (en zit dus ook niet in het STAM-bericht). 
  
-**ad 6. Bepaal versienummer bij Jnet berichten**\\+**ad 6. Bepaal versienummer bij Jnet berichten**
 Alleen bij Jnet-berichten zit het versienummer (DSO-volgnummer) in de bijlagenaam. Zie bij ad 1. Indien de bijlagenaam toch niet volgens het stramien OIN-verzoeknr-versienr-documentnaam is opgebouwd dan wordt '000'als versienummer genomen. Alleen bij Jnet-berichten zit het versienummer (DSO-volgnummer) in de bijlagenaam. Zie bij ad 1. Indien de bijlagenaam toch niet volgens het stramien OIN-verzoeknr-versienr-documentnaam is opgebouwd dan wordt '000'als versienummer genomen.
  
-**ad 7. Haal OIN-nummer uit de bijlagenaam**\\+**ad 7. Haal OIN-nummer uit de bijlagenaam**
 Alleen bij Jnet-berichten zit het OIN-nummer in de bijlagenaam. Zie bij ad 1. Indien de bijlagenaam toch niet volgens het stramien OIN-verzoeknr-versienr-documentnaam is opgebouwd dan wordt deze stap overgeslagen. Alleen bij Jnet-berichten zit het OIN-nummer in de bijlagenaam. Zie bij ad 1. Indien de bijlagenaam toch niet volgens het stramien OIN-verzoeknr-versienr-documentnaam is opgebouwd dan wordt deze stap overgeslagen.
 In het geval dat documenten worden verzonden naar OpenWave die horen bij een zogenaamd DSO kopiebericht, dan bevat de documentnaam het OIN-nummer van het bevoegd gezag. Hetzelfde document kan echter al aanwezig zijn in OpenWave onder het OIN-nummer van de behandeldienst. De controle vindt daarom plaats op een substring van de documentnaam (zonder het OIN-gedeelte) mits //Getal1// van de instelling //Sectie: Koppeling OLO// en //Item: CheckOpDubbeleDocumentnaam// ongelijk aan waarde 1 is (dus indien het gaat om Jnet).  In het geval dat documenten worden verzonden naar OpenWave die horen bij een zogenaamd DSO kopiebericht, dan bevat de documentnaam het OIN-nummer van het bevoegd gezag. Hetzelfde document kan echter al aanwezig zijn in OpenWave onder het OIN-nummer van de behandeldienst. De controle vindt daarom plaats op een substring van de documentnaam (zonder het OIN-gedeelte) mits //Getal1// van de instelling //Sectie: Koppeling OLO// en //Item: CheckOpDubbeleDocumentnaam// ongelijk aan waarde 1 is (dus indien het gaat om Jnet). 
Regel 109: Regel 111:
 Dit kopiebericht is bijvoorbeeld het geval als een gemeente geen eigen opvang heeft van DSO-berichten en hiervoor de Omgevingsdienst gebruikt. De omgevingsdienst verwerkt het STAM-bericht voor het bevoegd gezag (de gemeente). Er gaat echter altijd een kopie vanuit het DSO naar het bevoegd gezag: in dit geval is dat wederom dezelfde OpenWave installatie. OpenWave voorkomt altijd dat een dubbele zaak (dus met hetzelfde DSO verzoeknummer) wordt aangemaakt binnen één OpenWave installatie. De namen van de nagestuurde documenten bij de kopiezaak zijn echter niet gelijk aan de originelen die de omgevingsdienst als behandeldienst al heeft ontvangen. Hetzelfde document begint in de originele zaak met het OIN-nummer van de omgevingsdienst en bij de kopiezaak is dat het OIN-nummer van het bevoegd gezag. Dit kopiebericht is bijvoorbeeld het geval als een gemeente geen eigen opvang heeft van DSO-berichten en hiervoor de Omgevingsdienst gebruikt. De omgevingsdienst verwerkt het STAM-bericht voor het bevoegd gezag (de gemeente). Er gaat echter altijd een kopie vanuit het DSO naar het bevoegd gezag: in dit geval is dat wederom dezelfde OpenWave installatie. OpenWave voorkomt altijd dat een dubbele zaak (dus met hetzelfde DSO verzoeknummer) wordt aangemaakt binnen één OpenWave installatie. De namen van de nagestuurde documenten bij de kopiezaak zijn echter niet gelijk aan de originelen die de omgevingsdienst als behandeldienst al heeft ontvangen. Hetzelfde document begint in de originele zaak met het OIN-nummer van de omgevingsdienst en bij de kopiezaak is dat het OIN-nummer van het bevoegd gezag.
  
-**ad 8. Document wordt opgeslagen en registratie wordt aangemaakt**\\+**ad 8. Document wordt opgeslagen en registratie wordt aangemaakt**
 Bij Jnet-documenten wordt de volledige bijlagenaam (dus incl. OIN-nummer, verzoeknummer en versienummer) gebruikt bij de registratie in tbcorrespondentie. Bij Jnet-documenten wordt de volledige bijlagenaam (dus incl. OIN-nummer, verzoeknummer en versienummer) gebruikt bij de registratie in tbcorrespondentie.
  
-**ad 9. Stop, Bijlage wordt genegeerd**\\+**ad 9. Stop, Bijlage wordt genegeerd**
 De bijlage wordt niet verwerkt in OpenWave. Wel wordt een kaartje aangemaakt in tbadexternupload. Zie tegel //Mislukte OLO/DSO bijlages// in het servicecentrum-portaal De bijlage wordt niet verwerkt in OpenWave. Wel wordt een kaartje aangemaakt in tbadexternupload. Zie tegel //Mislukte OLO/DSO bijlages// in het servicecentrum-portaal
  
 ===== Opslaan van document in fileshare of in DMS ===== ===== Opslaan van document in fileshare of in DMS =====
 +
 Het daadwerkelijk plaatsen van de file (op fileshare of Stuf zaak/DMS) gaat gelijk aan het beschrevene in het lemma [[openwave:1.32:applicatiebeheer:probleemoplossing:programmablokken:upload_document|Upload document(en)]], waarbij het volgende extra geldt: Het daadwerkelijk plaatsen van de file (op fileshare of Stuf zaak/DMS) gaat gelijk aan het beschrevene in het lemma [[openwave:1.32:applicatiebeheer:probleemoplossing:programmablokken:upload_document|Upload document(en)]], waarbij het volgende extra geldt:
   * bij plaatsing via fileshare kijkt het programma naar de unieke map gedefinieerd door //Sectie: AanmaakMappen// en //Item begint met 'Omgeving_'// EN //Getal2// = 1   * bij plaatsing via fileshare kijkt het programma naar de unieke map gedefinieerd door //Sectie: AanmaakMappen// en //Item begint met 'Omgeving_'// EN //Getal2// = 1
  • openwave/1.32/applicatiebeheer/probleemoplossing/programmablokken/upload_dso-document_vanuit_digi-koppelaar.1751360399.txt.gz
  • Laatst gewijzigd: 2025/07/01 10:59
  • door 127.0.0.1