Verschillen
Dit geeft de verschillen weer tussen de geselecteerde revisie en de huidige revisie van de pagina.
Volgende revisie | Vorige revisie | ||
openwave:1.30:applicatiebeheer:probleemoplossing:programmablokken:upload_dso-document_vanuit_digi-koppelaar [2024/01/08 09:06] – aangemaakt - Externe bewerking 127.0.0.1 | openwave:1.30:applicatiebeheer:probleemoplossing:programmablokken:upload_dso-document_vanuit_digi-koppelaar [2024/12/11 14:20] (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. | ||
+ | * 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// | ||
+ | * OF de digi-koppelaar | ||
+ | |||
+ | Indien ingesteld is dat OpenWave zelf de bijlagen ophaalt met de instelling //Sectie: OWB en Item: OphalenDSODocsViaApi// | ||
+ | |||
+ | ===== Verwerken DSO-bijlagen vanuit digi-koppelaar | ||
+ | Dit is het geval indien | ||
Voor het uploaden vanuit de digi-koppelaar van DSO-bijlagen naar OpenWave is een endpoint aanwezig.\\ | Voor het uploaden vanuit de digi-koppelaar van DSO-bijlagen naar OpenWave is een endpoint aanwezig.\\ | ||
Regel 15: | Regel 23: | ||
Het kan zijn dat de digi-koppelaar het OIN-nummer van het bevoegd gezag of behandeldienst toevoegt als prefix aan de documentnaam gevolgd door een hyphen (' | Het kan zijn dat de digi-koppelaar het OIN-nummer van het bevoegd gezag of behandeldienst toevoegt als prefix aan de documentnaam gevolgd door een hyphen (' | ||
- | In het geval van complexe verzoeken in samenwerkingsverband, | + | In het geval van complexe verzoeken in samenwerkingsverband, |
</ | </ | ||
- | OpenWave plaatst het document eerst op de DSO-tempmap (kolom //Tekst// van de instelling:// | + | OpenWave plaatst het document eerst op de DSO-tempmap (kolom //Tekst// van de instelling:// |
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// | 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// | ||
Regel 24: | Regel 32: | ||
- | + | ==== Werkwijze | |
- | ==== Verwerken | + | |
De DSO/ | De DSO/ | ||
- | Deze map is gedefinieerd in kolom //Tekst// van de instelling: //Sectie: OWB 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: | In de kolom //Tekst// staat de mapnaam op de webserver: deze mapnaam MOET eindigen op de karakterreeks: | ||
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 48: | Regel 55: | ||
Zo gauw de API uploadfile de focus heeft worden alle files die op de // | Zo gauw de API uploadfile de focus heeft worden alle files die op de // | ||
- | === Bepaling zaak in OpenWave === | + | ==== Bepaling zaak in OpenWave |
Het DSO-nummer wordt gebruikt om de omgevingszaak te traceren (tbomgvergunning.dvlvoaanvraagnr) en daarbij eventueel het nodige externe zaak/DMS nummer op te halen (dvintzaakcode). Aangezien deze laatste ook door automatische processen worden aangemaakt kan er een vertraging wenselijk zijn: als het programma het DSO-nummer niet kan vinden of aan het DSO-nummer is nog geen externe zaakidentificatie gekoppeld dan kan in een loop nog een aantal maal een poging worden gedaan. | Het DSO-nummer wordt gebruikt om de omgevingszaak te traceren (tbomgvergunning.dvlvoaanvraagnr) en daarbij eventueel het nodige externe zaak/DMS nummer op te halen (dvintzaakcode). Aangezien deze laatste ook door automatische processen worden aangemaakt kan er een vertraging wenselijk zijn: als het programma het DSO-nummer niet kan vinden of aan het DSO-nummer is nog geen externe zaakidentificatie gekoppeld dan kan in een loop nog een aantal maal een poging worden gedaan. | ||
- | Deze loop is qua aantal en wachtduur instelbaar met de instelling //Sectie: KoppelingDOCNAARDMS// | + | Deze loop is qua aantal en wachtduur instelbaar met de instelling //Sectie: KoppelingDOCNAARDMS// |
- | === Controle dubbele documenten === | + | ==== Controle dubbele documenten |
- | 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 // | + | 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 // |
- | {{:openwave:1.29: | + | {{openwave: |
- | **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. | ||
<adm voorbeeld>: | <adm voorbeeld>: | ||
- | Bij Jnet zien de bijlagenamen bij het oorspronkelijke | + | Bij Jnet zien de bijlagenamen bij het oorspronkelijke |
00099999999999999999-0123456789123-000-kameel.docx | 00099999999999999999-0123456789123-000-kameel.docx | ||
00099999999999999999-0123456789123-000-schaap.docx | 00099999999999999999-0123456789123-000-schaap.docx | ||
Regel 77: | Regel 84: | ||
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// | + | OpenWave kijkt hiertoe naar //Getal 1// van de instelling //Sectie: Koppeling OLO// en //Item: CheckOpDubbeleDocumentnaam// |
- | **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 | + | In geval van Jnet-naam wordt de bijlagenaam gezocht zonder OIN-nummer. Dus stel de bijlagenaam is // |
Er wordt gezocht binnen de kolom dvdocfilenaam van tbcorrespondentie: | Er wordt gezocht binnen de kolom dvdocfilenaam van tbcorrespondentie: | ||
- | **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 dvdso 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 | + | 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 |
- | Deze stap geldt niet voor de verzoek.pdf want dit is geen bijlage in tbomgoloberichten (en 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 ' | 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 ' | ||
- | **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, | + | In het geval dat documenten worden verzonden naar OpenWave die horen bij een zogenaamd DSO kopiebericht, |
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 aangemaakt**.\\ | + | **ad 8. Document wordt opgeslagen en registratie |
- | Bij Jnet-documenten wordt de volledige bijlagenaam (dus incl. OIN-nummer, verzoeknummer en versienummer) gebruikt bij de registratie in tbcorrerspondentie. | + | 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 tbbadexternupload. 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 === | + | |
- | Het daadwerkelijk plaatsen van de file (op fileshare, of CMIS of Stuf zaak/DMS) gaat gelijk aan het beschrevene in het lemma [[openwave: | + | ===== Opslaan van document in fileshare of in DMS ===== |
- | * bij plaatsing via CMIS of fileshare kijkt het programma naar de unieke map gedefinieerd door //Sectie: AanmaakMappen// | + | Het daadwerkelijk plaatsen van de file (op fileshare of Stuf zaak/DMS) gaat gelijk aan het beschrevene in het lemma [[openwave: |
- | * bij plaatsing via STUF Zaken kijkt het programma wat betreft het documenttype indien GEEN compartiment naar kolom //Tekst// van instelling //Sectie: KoppelingDOCNAARDMS// | + | * bij plaatsing via fileshare kijkt het programma naar de unieke map gedefinieerd door //Sectie: AanmaakMappen// |
- | * bij plaatsing via STUF Zaken kijkt het programma ook wat betreft metadata vertrouwelijkheid indien GEEN compartiment naar kolom //Tekst// van instelling //Sectie: KoppelingDOCNAARDMS// | + | * bij plaatsing via STUF Zaken kijkt het programma wat betreft het documenttype indien GEEN compartiment naar kolom //Tekst// van instelling //Sectie: KoppelingDOCNAARDMS// |
- | * wat betreft Auteur bij StUF zaken: deze krijgt de waarde onbekend | + | * bij plaatsing via STUF Zaken kijkt het programma ook wat betreft metadata vertrouwelijkheid indien GEEN compartiment naar kolom //Tekst// van instelling //Sectie: KoppelingDOCNAARDMS// |
- | * indien zowel is ingesteld dat documenten op de fileserver geplaatst kunnen worden als in een DMS, dan zullen de DSO-bijlages in het DMS worden geplaatst, tenzij de instelling //Sectie: Koppeling OLO en Item: BestandenNaarFileserver// | + | * wat betreft Auteur bij StUF zaken: deze krijgt de waarde |
+ | * indien zowel is ingesteld dat documenten op de fileserver geplaatst kunnen worden als in een DMS, dan zullen de DSO-bijlages in het DMS worden geplaatst, tenzij de instelling //Sectie: Koppeling OLO// en //Item: BestandenNaarFileserver// | ||
- | ==== Automatische registratie van document ==== | + | ===== Automatische registratie van document |
- | Indien de zaak speelt in een compartiment dan kijkt OpenWave | + | Indien de zaak speelt in een compartiment dan kijkt OpenWave of de kolom //OLO/DSO uploads registreren// |
- | * **Documenttype** (dvdoctype_oms) indien GEEN compartiment met kolom //Tekst// van Instelling //Sectie: KoppelingDOCNAARDMS Item: OloDocType// | + | * **Documenttype** (dvdoctype_oms) indien GEEN compartiment met kolom //Tekst// van Instelling //Sectie: KoppelingDOCNAARDMS// en //Item: OloDocType// |
- | * **Definitief** met indien //Getal1// van de instelling // | + | * **Definitief** met indien //Getal1// van de instelling // |
* **Richting** met (B)innenkomend | * **Richting** met (B)innenkomend | ||
- | * **dldsovertrouwelijkehid** met de waarde (T of F) van de bijbehorende bijlageverwijzing in tbomgoloberichten. | + | * **dldsovertrouwelijkheid** met de waarde (T of F) van de bijbehorende bijlageverwijzing in tbomgoloberichten |
* **Vertrouwelijkheid** (dnkeyvertrouwelijkheid) | * **Vertrouwelijkheid** (dnkeyvertrouwelijkheid) | ||
- | * indien DSO vertrouwelijkheid (dldsovertrouwelijkheid) =' | + | * indien DSO vertrouwelijkheid (dldsovertrouwelijkheid) =' |
- | * Indien | + | * indien |
- | * Anders | + | * anders |
- | * Indien | + | * indien |
- | * nog niet gevonden dan blijft de dbkeyvertrouwelijkheid | + | * nog niet gevonden dan blijft de dnkeyvertrouwelijkheid |
* Indien dldsovertrouwelijkheid) ='F ' | * Indien dldsovertrouwelijkheid) ='F ' | ||
- | * indien GEEN compartiment wordt met kolom //Tekst// van Instelling //Sectie: KoppelingDOCNAARDMS Item: OloVertrouwelijkheid// | + | * indien GEEN compartiment wordt met kolom //Tekst// van Instelling //Sectie: KoppelingDOCNAARDMS// en //Item: OloVertrouwelijkheid// |
- | * Indien | + | * indien |
- | * Indien | + | * indien |
- | * indien WEL compartiment dan wordt de tekst in het veld OLO/DSO vertrouwelijkheid op het detailscherm van de compartimentsrechten in het beheerportaal gezocht in tbvertrouwlijkheid | + | * indien WEL compartiment dan wordt de tekst in het veld //OLO/DSO vertrouwelijkheid// op het detailscherm van de compartimentsrechten in het beheerportaal gezocht in tbvertrouwelijkheid |
- | * Indien | + | * indien |
- | * Indien | + | * indien |
* **Omschrijving** met de waarde van kolom dvomschrijving van de corresponderende kaart uit de tabel tbomgoloberichten (de tabel met opgesomde documenten uit het DSO-verzoekbericht of OLO-aanvraagbericht). | * **Omschrijving** met de waarde van kolom dvomschrijving van de corresponderende kaart uit de tabel tbomgoloberichten (de tabel met opgesomde documenten uit het DSO-verzoekbericht of OLO-aanvraagbericht). | ||
- | ==== Technische instelling ==== | + | ===== Technische instelling |
WSAS moet benaderd worden op poort 9763(HTTP), dit is een onopgeloste bug. Op poort 9443(HTTPS) werkt het upload.php script niet. | WSAS moet benaderd worden op poort 9763(HTTP), dit is een onopgeloste bug. Op poort 9443(HTTPS) werkt het upload.php script niet. | ||
Regel 147: | Regel 154: | ||
* use_protocol_endpoint = Http | * use_protocol_endpoint = Http | ||
- | ==== Loggen ==== | + | ===== Loggen |
In plaats van dat de tabel tbUpload gevuld wordt met een log (zowel gelukt als niet gelukt) wordt nu de beheertabel tbBadExternUpload gevuld met **alleen de mislukte plaatsingen**. In alle gevallen (gelukt of niet gelukt) wordt de oorspronkelijke file op de TussenMapDSOUploadfiles vernietigd. | In plaats van dat de tabel tbUpload gevuld wordt met een log (zowel gelukt als niet gelukt) wordt nu de beheertabel tbBadExternUpload gevuld met **alleen de mislukte plaatsingen**. In alle gevallen (gelukt of niet gelukt) wordt de oorspronkelijke file op de TussenMapDSOUploadfiles vernietigd. | ||
{{tag> | {{tag> |