Ketenvoorbeeld OLO digi-koppelaar OpenWave Fileshare

Er kunnen twee gelijktijdige processen stromen:

• A t/m B. Aanmaken/bijwerken van zaak op grond van OLO-bericht in OpenWave
• 1 t/m 7. Plaatsen van OLO-bijlagen via OpenWave op fileshare.

De digi-koppelaar stuurt het OLO-bericht integraal door naar de verwerk asynchroonservice (StUF-LVO) die draait op DUSK-server van OpenWave. Het endpoint van het bericht is: https://IPADRES:POORT/Wv_Olo_Document_311/soap/iontvangasynchroon. In de HTTPS header is een authenticatie onder basic verplicht. Deze wordt per Digi-koppelaar per installatie afgesproken.

De service kan achter een firewall geïnstalleerd zijn.

Zie de instellingen bij Verwerking van StUF OLO / AIM berichten. De berichtsoorten vrgDi01AanvragenVooroverleg, omvDi01AanbiedenAanvraag en omvDu01LeverenAanvraag worden verwerkt tot nieuwe zaken in tbomgvergunning en de bestandsnamen van de genoemde bijlagen in het bericht worden toegevoegd aan de tabel tbomgoloberichten. Dit alles mits het OLO-aanvraagnummer nog niet bestaat in OpenWave. In de kolom dvlvoaanvraagnummer wordt het OLO-aanvraagnummer gezet.

Bestaat het OLO-nummer reeds of gaat het om andere berichtsoorten dan de drie hierboven genoemd, dan worden alleen de bijlagen van het bericht toegevoegd en gekoppeld aan de reeds bestaande kaart.

Omdat het mogelijk is dat tegelijkertijd meerdere berichten met hetzelfde OLO-nummer richting OpenWave gaan, worden de berichten één voor één afgehandeld mits in de Sectie: [LOG] van de dusk.ini het Item: MapOloZaakBenBezig is opgenomen en gevuld met een ma verwijzing waarop de service schrijf- en verwijderrechten heeft. Hiermee kan worden voorkomen dat er twee zaken worden aangemaakt met hetzelfde OLO-aanvraagnummer. Voor deze instelling zijn systeembeheerrechten nodig. Zie verder: Programma logica OLO-verwerking.

Per OLO-bijlage verzendt de digi-koppelaar deze in base64 naar een afgesproken adres van een luisterservice op de OpenWave webserver: de OLOUploadmap op de tekening. https:adres/OLO_upload/olo_upload.php. Adres is dus bijvoorbeeld rommeldam.open-wave.nl. Dit gebeurt onder HTTPS met authenticatie (basic) en met 2 post parameters met de namen: olonummer en filenaam. Bijvoorbeeld: /OLO_upload/upload_olo.php?filenaam=63015_1.1357301.131_publiceerbareaanvraag.pdf&olonummer=63015. De authenticatie wordt per digi-koppelaar per installatie afgesproken (is niet dezelfde als in stap A).

De OW-olo_upload.php-luisterservice pakt de base64 file van stap 1 uit en slaat deze op een map gedefinieerd door de instelling kolom Tekst van Sectie: OWB Item: TussenMapOloUploadfiles. De map moet eindigen op '/openwave/uploadolo/' en beginnen met een '/'. De bijlage wordt opgeslagen met behulp van de postparameters uit stap 1 onder de naam 'OLO-nummer \'+ underscore + filenaam bijvoorbeeld '654321_prentje.png'.

Omdat de OW-luisterservice op de webserver een OpenWave API van de WSAS-server gaat aanroepen om een bijlage up te loaden naar het externe zaak/DMS systeem, moet een autorisatiesleutel worden opgehaald. Hiertoe wordt de API getAuthorisation aangeroepen met dezelfde login en pass die uitgegeven zijn aan de digikoppelaar om de bijlages te kunnen plaatsen (https-authenticatie).

Adres en poort waar de OpenWave API's staan te luisteren zijn genoteerd in de map config in de file openwave.ini op dezelfde machine als de luisterservice. Dit is een systeembeheerinstelling.

De genoemde Login/pass moeten ook opgenomen zijn in de medewerkerstabel waarbij:

• de user toegang moet hebben tot de browserversie
• EN passworddatum verloop nooit aangevinkt is
• EN de kolom 2-factor authentication opheffen aangevinkt is
• EN de user lid is van een rechtengroep die minimaal bij de omgevingszaken het recht Creëren en uploaden documenten aangevinkt heeft staan.
• EN de user lid is van een rechtengroep die minimaal op één van de modules (bouw/sloop, horeca, handhavingen, APV/overig/ milieu/gebruik/ info, omgeving of inrichtingen) kijkrechten heeft.

(Alle overige rechten mogen uitgevinkt zijn).

De luisterservice roept nu per document de API uploadfile aan. De uploadfile API wordt aangesproken met onder meer de filenaam van stap 2 en een extra parameter 'OLO' zodat de API weet dat de daadwerkelijke file moet worden opgehaald uit de map TussenMapOloUploadfiles uit stap 2. Zo gauw de API uploadfile de focus heeft worden alle files verwijderd die op de TussenMapOloUploadfiles staan en die een filedatum/timestamp hebben ouder dan het aantal uren hetgeen is ingesteld in Getal1 van de instelling van Sectie: OWB en Item: MaxUurUpload.

Met het OLO-nummer in de filenaam van stap 4 wordt de bijbehorende omgevingszaak in OpenWave getraceerd (tbomgvergunning.dvlvonr) om de nodige gegevens over de opslag van documenten op de fileshare op te halen. Aangezien de omgevingszaak ook door een automatische proces wordt aangemaakt (stap A t/m c) kan er een vertraging wenselijk zijn: als het programma het OLO-nummer niet kan vinden, 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 en Item: WachtOpExtAantalSeconden. In Getal1 staat het aantal seconden dat gewacht wordt (default 2) alvorens opnieuw te zoeken en in Getal2 staat het aantal maal dat dat herhaald mag worden (default 5). Kijk voor de nodige instellingen i.v.m. opslag op fileshare ook naar: Upload documenten naar fileshare.

Om de map te bepalen waar de documenten worden opgeslagen kijkt het programma naar de instelling met Sectie: AanmaakMappen en Item begint met 'Omgeving_' en Getal2 = 1. In de kolom Tekst staat de map waarin nog een aantal variabelen kunnen staan die het programma als volgt gaat vervangen:

• %zaakjaar% door het jaar (jjjj) van de begindatum omgevingszaak
• %zaakjaar% door de jaarmaand (jjjjmm) van de begindatum van de omgevingszaak
• %zaaknr% met de Wavezaakcode van de omgevingszaak.

Voorbeeld: \\CORK\OpenWave\Documents\Omgeving\%zaakjaar%\%zaaknr%\OLO\

wordt na substitutie bijvoorbeeld
\\CORK\OpenWave\Documents\Omgeving\2012\2013RP0044\OLO\

De gevonden map uit stap 5 wordt zo nodig aangemaakt en vervolgens worden daar de OLO-documenten op geplaatst.

Indien het plaatsen van het document op de fileserver in stap 6, of wanneer er in stap 4 of 5 iets misgegaan is, dan wordt geprobeerd een kaart aan te maken in tbbadExternUpload (beheertegel Mislukte OLO-uploads) met daarin datum/tijd en de filenaam van de betreffende OLO-bijlage. Het automatisch uploaden kan niet worden herhaald en zal dus met de hand moeten gebeuren.