Verwerking van StUF OLO/AIM berichten
Deze service wordt door externe programma(s) aangeroepen.
-
De service ondersteunt StUF-LVO versies 305, 311 en 312.
De service kan achter een firewall geïnstalleerd zijn.
De service kan met HTTPS authenticatie geïnstalleerd zijn.
Berichtsoorten
De service verwerkt de volgende berichtsoorten tot een nieuwe zaak in OpenWave:
De service verwerkt de volgende berichtsoort tot toevoegen van een extern zaaknummer (dvintzaakcode) aan bestaande OpenWave zaak (mits OLO aanvraagnummer bekend):
De service verwerkt de volgende berichtsoorten tot kaarten in de tabel tbOmgOLOberichten bij een bestaande OpenWave zaak (mits OLO-aanvraagnummer bekend):
Overige berichtsoorten worden niet verwerkt.
Verplichte instellingen
Kolom Tekst van de Sectie: Koppeling OLO en Item: Methode moet de waarde StUF-LVO 311 hebben en aangevinkt zijn. De service verwerkt met deze instelling zowel StUF-LVO 311 als StUF-LVO 312 berichten.
Er moet precies één kaart zijn in de tabel zaaktypes omgeving (tbsoortomgverg) waarbij de kolom OLO-tag de waarde: ReguliereProcedure Reguliere procedure heeft.
Er moet precies één kaart zijn in de tabel zaaktypes omgeving (tbsoortomgverg) waarbij de kolom OLO-tag de waarde: UitgebreideProcedure Uitgebreide procedure heeft.
Er moet precies één kaart zijn in de tabel zaaktypes omgeving (tbsoortomgverg) waarbij de kolom OLO-tag de waarde: Geen procedure van toepassing heeft. Dit OpenWave zaaktype wordt gebruikt voor meldingen die niet nader gespecificeerd worden door de facultatieve instellingen MeldingOnderdeelSlopen,
MeldingOnderdeelLozing, MeldingOnderdeelGebruik of MeldingOnderdeelActiviteit.
Getal2 van de instelling Koppeling OLO en Item: Onbekende vergunning verwijst naar een dnkey van tabel zaaktypes omgeving TbSoortOmgverg. Deze verwijzing wordt gebruikt indien OLO-bericht een niet nader te plaatsen soort procedure geeft of facultatieve instellingen ontbreken. De OpenWave-naam van dit zaaktype kan bijvoorbeeld Onbekende OLO_vergunning zijn.
Getal2 van de instelling Koppeling OLO en Item: Vooroverleg verwijst naar een dnkey van tabel zaaktypes omgeving TbSoortOmgverg die de betekenis vooroverleg heeft.
Getal2 van de instelling Koppeling OLO en Item: Onbekende Activiteit verwijst naar een dnkey van tabel activiteitsoorten (tbsrtToestemming) met de betekenis onbekende OLO-activiteit.
Getal2 van de instelling Koppeling OLO en Item: DummyLokatiePerceelkey verwijst naar een dnkey van tabel locaties (tbperceeladressen) met de betekenis onbekend adres (gevuld met bijvoorbeeld Onbekende Plaats, Onbekende Straat, Huisnummer 0 of 9999).
In de brontabel Adressoorten moet één van de adressoorten in de kolom OLO-tag voorzien worden van de waarde 'isAangevraagdDoor'. Bij ontbreken van deze instelling neemt het programma AVR (aanvrager) (deze moet wel gedefinieerd zijn voor omgevingszaken en/of milieu/gebruik).
In de brontabel Adressoorten moet één van de adressoorten in de kolom OLO-tag voorzien worden van de waarde 'heeftGemachtigde'. Bij ontbreken van deze instelling neemt het programma GEM (gemachtigde) (deze moet wel gedefinieerd zijn voor omgevingszaken en/of milieu/gebruik).
Bij de soort omgevingszaak (tbsoortomgverg) of de soort milieu/gebruikszaak (tbsoortmilverg) kan de default dossier-behandelaar worden opgegeven van de aangemaakte OLO-zaak. Indien deze niet bestaat dan wordt teruggevallen op kolom Tekst van de instelling Sectie: Koppeling OLO en Item: dossierbehandelaar. Hierin moet een valide medewerkerscode (tbmedewerkers.dvcode) staan. LET OP: case-sensitive.
Indien een van deze verplichte instellingen ontbreekt of niet valide is gedefinieerd dan wordt er toch een BV03-retourbericht verzonden (immers met het bericht is niets mis, maar wel met de instellingen). In de messagelog wordt echter de kolom error gevuld met de ontbrekende instelling, waardoor er geen zaak is aangemaakt.
Autorisatiesleutel voor WSAS-API i.v.m. aanmaak processtappen
Omdat de asynchroonservice op de DUSK-server een OpenWave API van de WSAS-server gaat aanroepen om (automatische) processtappen aan te kunnen maken, moet een autorisatiesleutel worden opgehaald. Hiertoe wordt de API getAuthorisation aangeroepen met de login en pass die vastgelegd zijn in de kolom Tekst van de instellingen Sectie: Logon en de Items: ExternOLOlogin en ExternOLOPass.
Daarbij moet het endpoint voor de OpenWave API getAuthorisation gedefinieerd zijn in de kolom Tekst van instelling Sectie: Koppeling OLO en Item: EndpointClassMedewerker. Het gaat hierbij om de juiste gegevens op de plek van vetgedrukte IP en poort (lokaal IP-adres): http://IP-ADRES:POORT/services/nl.rem.openwave.published.Medewerker.nl.rem.openwave.published.MedewerkerHttpsSoap11Endpoint/.
Verder moet het endpoint voor de OpenWave API InsertAutomatischeProcessen gedefinieerd zijn in de kolom Tekst van instelling Sectie: Koppeling OLO en Item: EndpointClassWizard. Het gaat hierbij om de juiste gegevens op de plek van vetgedrukte IP en poort (lokaal IP-adres): http://IP-ADRES:POORT/services/nl.rem.openwave.published.Wizard.nl.rem.openwave.published.WizardHttpsSoap11Endpoint/.
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.
Programma-logica
Facultatieve instellingen
Getal1 van Sectie: Koppeling OLO en Item: ExtAdviesRegulier verwijst naar een een dnkey van tabel zaaktypes omgeving TbSoortOmgverg waaronder de OLO-berichten van type omvDu01LeverenAanvraag met de tag aanvraagprocedure Reguliere procedure geplaatst moeten worden. Indien de instelling niet bestaat dan worden deze adviesaanvragen onder de verplichte OW zaaktype voor de reguliere procedure geplaatst
Getal1 van Sectie: Koppeling OLO en Item: ExtAdviesUitgebreid verwijst naar een een dnkey van tabel zaaktypes omgeving TbSoortOmgverg waaronder de OLO-berichten van type omvDu01LeverenAanvraag met de tag aanvraagprocedure Uitgebreide procedure geplaatst moeten worden. Indien de instelling niet bstaat dan worden deze adviesaanvragen onder de verplichte OW zaaktype voor de uitgebreide procedure geplaatst
Getal1 van Sectie: Koppeling OLO en Item: ExtAdviesOnbekend verwijst naar een een dnkey van tabel zaaktypes omgeving TbSoortOmgverg waaronder de OLO-berichten van type omvDu01LeverenAanvraag met de tag aanvraagprocedure anders dan regulier of uitgebreid moeten worden geplaatst. Indien de instelling niet bestaat dan worden deze adviesaanvragen onder de verplichte OW zaaktype voor geen-procedure-van-toepassing geplaatst
De instelling Sectie: Koppeling OLO en Item: MeldingenOpvangen moet aangevinkt zijn indien OLO-berichten met de procedure Geen procedure van toepassing of Onbekend geplaatst moeten worden op OpenWave zaaktypes Sloopmelding of Gebruikmelding, Lozingsmelding of Activiteitenmelding. Indien deze instelling niet aangevinkt is dan worden deze OLO-berichten geplaatst op de onbekende OLO-vergunning
Getal2 bij Sectie: Koppeling OLO en Item: MeldingOnderdeelSlopen verwijst naar een dnkey van tabel zaaktypes omgeving TbSoortOmgverg waaronder de sloopmeldingen geplaatst worden. OpenWave beschouwt een OLO-bericht als een sloopmelding indien Item: MeldingenOpvangen aangevinkt is EN het bericht een onderdeel <onderdeelSlopen> bevat
Getal2 bij Sectie: Koppeling OLO en Item: MeldingOnderdeelGebruik verwijst naar een dnkey van tabel zaaktypes omgeving TbSoortOmgverg waaronder de gebruiksmeldingen geplaatst worden. OpenWave beschouwt een OLO-bericht als een gebruiksmelding indien Item: MeldingenOpvangen aangevinkt is EN het bericht een onderdeel <onderdeelGebruik> bevat
Getal2 bij Sectie: Koppeling OLO en Item: MeldingOnderdeelLozing verwijst naar een dnkey van tabel zaaktypes omgeving TbSoortOmgverg waaronder de lozingsmeldingen geplaatst worden. OpenWave beschouwt een OLO-bericht als een lozingsmelding indien Item: MeldingenOpvangen aangevinkt is EN het bericht een onderdeel <onderdeelMeldingLozingOpDeBodemOfDeRioleringBuitenInrichtingen> bevat
Getal2 bij Sectie: Koppeling OLO en Item: MeldingOnderdeelActiviteit verwijst naar een dnkey van tabel zaaktypes omgeving TbSoortOmgverg waaronder de activiteitenmeldingen geplaatst worden. OpenWave beschouwt een OLO-bericht als een activiteitenmelding indien Item:MeldingenOpvangen aangevinkt is EN het bericht een onderdeel <onderdeelActiviteitenMelding> bevat.
Indien de instelling Sectie: Koppeling OLO en Item: Aanmaakmappen aangevinkt is zal het programma proberen op de fileshare (!) mappen aan te maken conform de instellingen van kolom Tekst bij Sectie: Aanmaakmappen waarbij Item begint met 'Omgeving_' of 'MilGebr_'. De automatisch aan te maken mappen zullen in ieder geval gedefinieerd moeten zijn als UNC-paden en de OLO-service moet hiertoe rechten hebben.
De woonplaatsnamen in het OLO bericht kunnen doorgegeven worden met de PTT-schrijfwijze. Het gaat hier om de woonplaatsnaam in het onderdeel <LVO:werkzaamheid>. Op grond van deze woonplaatsnaam wordt de locatie in Wave opgezocht. Dat gaat dus mis bij afwijkende schrijfwijze van de officiële woonplaatsnaam volgens tabel 33. Met deze instelling wordt deze afwijkende schrijfwijze omgeleid naar de schrijfwijze in OpenWave. Alleen de afwijkingen op officiële plaatsnaam moeten hier genoteerd worden. Als voor een bepaalde plaatsnaam de OLO-schrijfwijze en die van Wave overeenkomen is deze instelling niet nodig. Het gaat om de instelling Sectie: Koppeling OLO waarbij de kolom Item moet beginnen met de vaste tekst 'Woonplaatsnaam'. Dan een spatie en vervolgens de afwijkende schrijfwijze van de plaatsnaam. In de kolom Tekst moet vervolgens de juiste schrijfwijze van de woonplaatsnaam komen te staan, zoals deze staat in de Wave-tabel tbwoonplaats (zie Locatie).
Indien instelling Sectie: KoppelingOLO en Item: GeregistreerdAlsNaarZaaknrBevGezag aangevinkt is, dan wordt de tag identificatie van blok StaatGeregistreerdAls opgeslagen in kolom dvzaaknrbevgezag i.p.v. dvintzaakcode (zaaknr extern zaak/DMS).
Indien de instelling Sectie: Koppeling OLO en Item: LokatieHuisletterCaseSensitive niet is aangevinkt betekent dit dat bij het inlezen van het locatie adres uit het OLO-bericht de huisletter niet case-sensitive is. Dat wil zeggen dat een aanvraag voor bijvoorbeeld Acacialaan 1 b gekoppeld kan worden aan het locatie adres Acacialaan 1 b of aan 1 B. De default instelling is aangevinkt!!!! dus wel onderscheid.
Indien de instelling Sectie: Koppeling OLO en Item: BestaandeZaakNietOverschrijven aangevinkt staat, heeft dat tot consequentie dan wanneer een OLO-bericht wordt verwerkt met een OLO-aanvraagnummer dat al bestaat in OpenWave de gegevens van die bestaande zaak NIET worden overschreven. De (verwijzingen naar) bijlages van het OLO-bericht worden wel opgenomen in de tabel nagekomen OLO-berichten in zoverre deze nog niet bestonden (er wordt gematched op de tag bestandsnaam).
Indien de instelling Sectie: Koppeling OLO en Item: BestaandContactNietOverschrijven aangevinkt staat, heeft dat tot consequentie dat wanneer tijdens het inlezen van de aanvrager of gemachtigde het programma tot de conclusie komt dat deze reeds bestaat als contactadres in OpenWave, er alleen een koppeling plaatsvindt met de nieuwe vergunningsaanvraag zonder dat daarbij de bestaande contactadresgegevens worden overschreven. Die controle vindt bij een persoon alleen plaats op het BSN-nummer + lege vervaldatum. Bij een Bedrijf vindt de controle plaats op de combinatie kvkvestigingsnummer op vestigingsnummer + voorletters, tussenvoegsel, achternaam en geslacht + lege vervaldatum van de bijbehorende contactpersoon. of - indien deze niet is gevuld - op de combinatie handelsregisternummer op KvK-nummer + voorletters, tussenvoegsel, achternaam en geslacht + lege vervaldatum van de bijbehorende contactpersoon. Indien deze aanstelling niet bestaat of is uitgevinkt en het BSN-nummer of de combinatie contactgegevens + handelsregisternummer is bekend in OpenWave (en niet vervallen), dan wordt deze contactadreskaart dus wel overschreven met de gegevens uit het OLO-bericht. Daarbij geldt dat als een match heeft plaatsgevonden op KvK-nummer-handelsregisternummer en in het OLO-bericht is het kvkvestigingsnummer leeg, dat het bijbehorende vestigingsnummer in OpenWave dan blijft staan. Ook: wanneer een match heeft plaatsgevonden op vestigingsnummer - kvkvestigingsnummer en in het OLO-bericht is het handelsregisternummer leeg, dat het bijbehorende KvK-nummer in OpenWave dan blijft staan.
Indien de instelling Sectie: KoppelingGBA en Item: PuntjesfunctieVoorletters aangevinkt is dan zal het programma alvorens de kolom voorletters bij een contactpersoon te vullen zo nodig de afzonderlijke tekens scheiden met een punt.
Indien de instelling Sectie: Koppeling OLO en Item: Olonrdatumbijafsluitenextzaak is aangevinkt dan zal bij het afsluiten van een omgevingszaak met zowel een extern zaaknummer als een OLO-nummer, waarbij het afsluiten vergezeld gaat van een actualiseerZaakstatus-bericht (stuf zaak/DMS) waarin een eindedatum wordt doorgegeven; dan wordt aan het OLO-nummer een datum string met format '-jjjjmmdd' toegevoegd (dus als OLO-nummer is 123456 en de datum is 24 feb 2017 dan wordt dat 123456-20170224). Dit betekent dat een tweede adviesaanvraag (soms half jaar later) op hetzelfde OLO-nummer dan als nieuwe zaak wordt beschouwd door OpenWave.
Indien de instelling Sectie: Koppeling OLO en Item: LeverenAanvraagDatumReset aangevinkt is en het gaat om de verwerking van de berichtsoorten OmvDu01LeverenAanvraag en wwvDu01LeverenAanvraag, dan zal de startdatum (tbomgvergunning.ddaanvraag) worden gevuld met de systeemdatum i.p.v. de aanvraagdatum uit het bericht. |
In de instelling Sectie: Koppeling OLO en Item: Versienummer zet OpenWave zelf de versie van de gebruikte OLO-service neer. Dit is dus eigenlijk geen instelling.
Indien Getal2 van de instelling Sectie: Koppeling OLO en Item: Waterwet gevuld is dan verwijst deze waarde naar een dnkey van tbsoortomgverg (zaaktypes omgeving) waar nieuwe zaken op grond van de OLO-berichtsoorten wwvDi01AanbiedenAanvraag en wwvDu01LeverenAanvraag aan gekoppeld worden.
Indien de instelling
Sectie: Koppeling OLO en
Item: MeerdereAdviesaanvragen aangevinkt is ontstaan bij de berichtsoorten
omvDu01LeverenAanvraag of wwvDu01LeverenAanvraag meerdere zaken in OpenWave wanneer de berichten doublure-waardes hebben in de tag <aanvraagnummer> (OLO/DSO nummer in OpenWave). Zaken in OpenWave worden in dat geval automatisch voorzien van een postfix (bijv. _1 of _2) om de waarde in de kolom dvlvoaanvraagnr uniek te houden.
Indien de instelling Sectie: Koppeling OLO en Item: AltijdPostadres is aangevinkt en het correspondentieadres van een initiator of gemachtigde bij natuurlijkpersoon of vestiging is NIET opgenomen in het bericht, dan worden de verblijfsadresgegevens uit het OLO-bericht - naast overname in het blok vestiging - ook overgenomen in het blok postadres van de contactpersoon. |
Vanaf 1.29 is de OpenWave database in karakterset UTF-8. Dit betekent dat de database een groter aantal tekens aan kan dan voorheen. Het voorheen filteren van tekens die niet konden worden opgeslagen in de OpenWave database is daarom niet meer van toepassing. Indien in uitzonderlijke geval het toch nodig is dat berichtverkeer over DUSK WEL de oude filtering toepast van tekens, dan dient men instelling Sectie: Dusk en Item: WIN1252 aan te maken en aan te vinken. |
Vooroverleg
Indien de OLO-berichtsoort vrgDi01AanvragenVooroverleg is, dan koppelt OpenWave deze aanvraag aan het zaaktype waarnaar verwezen wordt in de waarde van Getal2 van de instelling Sectie: Koppeling OLO en Item: Vooroverleg. Getal2 bevat de dnkey (identifier) van de kaart uit tbsoortomgverg die bedoeld is voor zaaktype vooroverleg.
Om te kunnen bewerkstelligen dat een uiteindelijke aanvraag regulier of uitgebreid (die onder hetzelfde OLO-aanvraagnummer wordt binnengeschoten) een eigen zaak wordt in OpenWave - naast de vooroverlegzaak - moet de kolom Tekst van de instelling Koppeling OLO en Item: Vooroverleg gevuld zijn met een tekst waarvan de lengte kleiner of gelijk 5 is. Indien deze kolom Tekst gevuld is: dan
wordt deze tekst als prefix toegevoegd aan het OLO-nummer op de vooroverlegkaart.
Als dan de reguliere of uitgebreide vergunningsaanvraag binnenkomt (met hetzelfde OLO-aanvraagnummer als het vooroverleg) zal OpenWave zoeken naar een vooroverlegkaart waarvan het OLO-nummer (dvlvoaanvraagnr) bestaat uit deze prefix + het OLO-aanvraagnummer. Indien gevonden dan:
wordt de waarde van ddvooroverleg (en indien leeg dan de aanvraagdatum) van de vooroverlegzaak overgenomen in de kolom ddvooroverleg van de reguliere/uitgebreide vergunningszaak
wordt een nieuwe groep aangemaakt in tbgroepvergunning met de naam 'Vooroverleg en Zaak bij olonr ' + het OLO-aanvraagnummer van de zaak.
De aanvraagnaam waaronder een vooroverleg wordt opgenomen in OpenWave is in principe: Aanvragen Vooroverleg, maar indien de tag toelichting in het OLO-bericht is gevuld (blok parameters) EN kolom Getal1 van de instelling Sectie: koppeling OLO en Item: Vooroverleg heeft de waarde 1 dan wordt de aanvraagnaam (tbomgvergunning.dvaanvraagnaam) gevuld met deze toelichting (afgekapt op 200 posities).
De vooroverlegkaart krijgt default in de kolom ddvooroverleg (blok Keten) de waarde van vandaag. De voorgestelde datum uit het bericht wordt overgenomen in de kolom Toelichting.
Wat betreft OLO-documenten die worden ingeschoten via de OLO-uploadservice: OpenWave kijkt of het OLO-nummer bestaat. Zo ja, dan worden de documenten bij de omgevingskaart met dat OLO-nummer geplaatst. Zo nee, dan kijkt OpenWave of er een prefix is ingesteld en – indien dat het geval is EN de instelling Sectie: Koppeling OLO en Item: Vooroverleg is ook aangevinkt – dan wordt het OLO-nummer nogmaals gezocht met de prefix eraan vastgeplakt.
Wanneer de OLO-nummer in TbOmgVergunning wordt geregistreerd met een prefix dan is de registratie in tbmessagelog zonder prefix (daar staat het oorspronkelijke bericht). Ook het eventuele vervolgbericht dat vanuit OpenWave wordt verzonden: koppelzaakaanaanvraag bevat het oorspronkelijke OLO-aanvraagnummer zonder prefix.
Koppelen van onderdelen/activiteiten
Geldt voor de berichtsoorten omv/wwvDi01AanbiedenAanvraag en omvDi01AanvragenVooroverleg en omv/wwvDu01LeverenAanvraag.
In de kolom Tag in OLO-xml van de Soorten Activiteiten (tbsrtToestemming.dvlvotag) in portaal Zaakbeheer wordt de koppeling tussen de benamingen uit OLO-bericht en de OpenWave activiteiten geregeld.
Tag in OLO-xml kan de volgende waardes hebben:
onderdeelBouwen
onderdeelReclame
onderdeelUitrit (alleen 305 en niet meer vanaf 311)
onderdeelInrit (alleen 305 en niet meer vanaf 311)
onderdeelKappen
onderdeelSlopen
onderdeelGebruik
onderdeelMonumenten
onderdeelMilieu
onderdeelMeldingActiviteit (eigenlijk niet OLO, maar alleen AIM-meldingen )
onderdeelMilieuNeutraalWijizigen (alleen 305 en niet meer vanaf 311)
onderdeelGevolgenPlantenEnDieren (alleen 305 en niet meer vanaf 311)
onderdeelGevolgenBeschermdeNatuurGebieden (alleen 305 en niet meer vanaf 311)
onderdeelUitvoerenWerkOfWerkzaamheden (alleen 305 en niet meer vanaf 311)
onderdeelAfwijkenVanDeBestemming (alleen 305 en niet meer vanaf 311)
onderdeelGebruikGeslotenStortplaats
onderdeelAlarminstallatie
onderdeelRoerendeZaken
onderdeelMeldingLozingOpDeBodemOfDeRioleringBuitenInrichtingen
onderdeelBeperkteOmgevingsvergunningMilieu
onderdeelWijzigingMilieu
onderdeelGrondwaterbeschermingsgebieden
onderdeelHandelenInStrijdMetRegelsRuimtelijkeOrdening
onderdeelHandelingenMetGevolgenVoorBeschermdeNatuurgebieden
onderdeelHandelingenMetGevolgenVoorBeschermdePlant-EnDiersoorten
onderdeelWegAanleggenOfVeranderen
onderdeelWerkOfWerkzaamhedenUitvoeren
onderdeelIn-OfUitrit
onderdeelSlopenOgvRuimte
onderdeelSlopenInBeschermdStadsOfDorpsgezicht
onderdeelAanlegGeslotenBodemenergiesysteem en
onderdeelOBMBuitenInrichtingen
onderdeelWaterInDeBodemBrengenOfEraanOnttrekken
Het is dus de bedoeling dat alle hierboven genoemde OLO-onderdelen gekoppeld worden aan een activiteit.
Zo niet dan worden zij gekoppeld aan de zogenaamde Onbekende OLO-activiteit.
Wanneer een OLO-onderdeel niet hierboven is genoemd, wordt dat genegeerd.
Feitelijk loopt OpenWave het OLO-bericht na op het voorkomen van bovenstaande strings in het blok <werkzaamheden>. Zo ja, dan wordt in de tabel tbsrtToestemming naar de OpenWave mapping gezocht van die string. Gevonden: dan wordt onder die mappingnaam een kaart in de tabel tbToestemmingen (onderdelen/activiteiten) bij de omgevingszaak aangemaakt. Niet gevonden: dan onder de onbekende OLO-activiteit.
kadastrale gegevens
Indien een OLO-aanvraag is voorzien van kadastrale gegevens in blok isVan, dan worden deze nu opgenomen in een kaart van de projectlocaties (tbzaakkadperc).
Uitgaande bericht: KoppelZaakAanAanvraag-instellingen
OpenWave kan na het verwerken van een nieuwe (OLO)-aanvraag waarbij een nieuwe zaak is aangemaakt in tbomgvergunning een uitgaand bericht vrgDi01KoppelZaakAanAanvraag initiëren die de ontvanger vertelt welke OpenWave zaakcode er gekoppeld is aan het OLO-nummer. Daartoe zijn de volgende instellingen verplicht:
Indien de zaak NIET valt onder een compartiment dan:
de instelling Sectie: Koppeling OLO Item: KoppelZaakAanAanvraagBericht moet aangevinkt zijn
in de kolom Tekst van de instelling Sectie: Koppeling OLO Item: Ontvangstadres_Asynchroon moet het endpoint staan waar het vrgDi01KoppelZaakAanAanvraag naar toe moet
het stuurgegeven ontvanger organisatie in kolom Tekst van de instelling Sectie: Koppeling OLO Item: ontvanger_organisatie
het stuurgegeven ontvanger applicatie in kolom Tekst van de instelling Sectie: Koppeling OLO Item: ontvanger_applicatie
het stuurgegeven zender organisatie in kolom Tekst van de instelling Sectie: Koppeling OLO Item: zender_organisatie.
Indien de zaak WEL valt onder een compartiment dam moet bij het betreffende compartiment (beheerportaal-Nieuw) in het blok OLO-tergkoppeling:
de kolom dlolokoppelzaakbericht aangevinkt zijn:
de kolom dvolokoppelzaakendpoint gevuld met een valide endpoint
de kolom dvolokoppelzaakontvangorg gevuld met het stuurgegeven ontvanger organisatie
de kolom dvolokoppelzaakontvangapp gevuld met het stuurgegeven ontvanger applicatie
de kolom dvolokoppelzaakzenderorg gevuld met het stuurgegeven zender organisatie.
In alle gevallen geldt verder:
de SOAP action moet worden ingevuld in kolom Tekst van Sectie: Koppeling OLO Item: HTTPSoapAction_vrgDi01KoppelZaakAanAanvraag. Deze waarde is vrgDi01KoppelZaakAanAanvraag
de kolom Tekst van de instelling Sectie: Koppeling OLO en Item: Charset vullen met UTF-8
op de map van de dusk.exe moeten de libraries libeay32.dll en ssleay32.dll geïnstalleerd zijn (zowel voor one-way als two-way beveiliging).
Indien de kolom Getal2 van Sectie: Koppeling OLO en Item: Https de waarde 2 heeft, dan gaat OpenWave er vanuit dat er gewerkt wordt met een 2-way beveiligde verbinding (anders one-way). Voor een 2-way beveiligde verbinding verwacht OpenWave een selfsigned - beveiligingscertificaat op de submap met de naam SelfSignedCertificaat achter de map waarop de dusk.exe geïnstalleerd is. In deze submap worden drie files geplaatst respectievelijk het certificaat, de private sleutel (geëncrypt) en het Root-certificaat:
openwave.crt
openwave.key
openwaveCA.crt.
De volgende instellingen indien ook AIM meldingen worden ingelezen:
Getal2 van de instelling Sectie: Koppeling OLO en Item: MeldingOnderdeelMeldingActiviteit_O verwijst naar de dnkey van tabel zaaktypes omgeving TbSoortOmgverg waaraan de activiteitenmelding AIM moet worden gekoppeld
Getal2 van de instelling Sectie: Koppeling OLO en Item: MeldingOnderdeelMeldingActiviteit verwijst naar de dnkey van tabel zaaktypes milieugebruik TbSoortMilverg waaraan de activiteitenmelding AIM moet worden gekoppeld. Een van bovenstaande twee instellingen moet bestaan
In Getal2 van Sectie: Koppeling OLO en Item: OnbekendeInrichting wordt verwezen naar de dnkey van de inrichting (tbmilinrichtingen) waaraan een AIM-milieuactivteitenmelding moet worden gekoppeld wanneer het programma niet in staat is een bekende inrichting uit tbmilinrichtingen te kiezen op grond van de berichtgegevens. Deze instelling is alleen nodig indien de de AIM-meldingen in de tabel tbMilvergunningen moeten worden geplaatst.
Logging
Het loggen van de OLO-berichten kan (gelijktijdig) op vier manieren:
Loggen in tbMessagelog (beheertegel Messagelog) Deze logging staat aan indien de instelling aangevinkt is van Sectie: OWB en Item: MessageLog. In kolom Getal1 van deze instelling staat het aantal dagen dat de loggingskaarten bewaard moeten blijven. Default is dat 31.
Loggen van goed/fout/onbekend op aparte mappen op de server waar de OLO-service draait. Hier worden de goed en fout verwerkte berichten op aparte mappen opgeslagen op grond van de volgende instellingen. Let op dat de OLO-service hierbij kan en schrijfrechten moet hebben.!!! Er wordt niet gelogd als een instelling niet bestaat of verkeerd verwijst. Voor deze instellingen zijn systeembeheerrechten op de server waar de OLO-service draait nodig.
Kolom Tekst van - de aangevinkte - Instelling Sectie: Koppeling OLO en Item: BerichtGoedVerwerktMap moet gevuld zijn met UNC-pad van de bedoelde map.
Kolom Tekst van - de aangevinkte - Instelling Sectie: Koppeling OLO en Item: BerichtNietGoedVerwerktMap moet gevuld zijn met UNC-pad van de bedoelde map.
Kolom Tekst van - de aangevinkte - Instelling Sectie: Koppeling OLO en Item: BerichtOnbekendMap moet gevuld zijn met UNC-pad van de bedoelde map.
Kolom Tekst van - de aangevinkte - Instelling Sectie: Koppeling OLO en Item: BerichtWordtNietOndersteundMap moet gevuld zijn met UNC-pad van de bedoelde map.
Loggen van alle serviceverkeer van de berichtenserver DUSK (waar OLO-service een onderdeel van is) in een logfile op een map op de server waar de OLO-service draait. De naam van de logfile en de mapnaam staan in een configuratiefile naast de Berichtenservice (dusk.ini) Sectie: [Log] en Item: Level met mogelijke waardes 1 tot 9, waarbij 9 het diepst loggen betekent. In Sectie: [Log] en Item: Bestand staat de map + bestandsnaam van de logfile. Voor deze instellingen zijn systeembeheerrechten op de server waar de OLO-service draait nodig.
Loggen van de OLO-berichten in en uit als file op een map op de server waar de OLO-service draait. Deze mapnaam staat in een configuratiefile naast de Berichtenservice (dusk.ini). Sectie: [Log] en Item: MapSaveBericht.
De namen van de files die hier komen te staan worden door de service zelf gegenereerd (bijvoorbeeld Bericht_Van_Olo_Naar_Dusk_140602150536.xml. Om deze laatste logging te activeren voor OLO-berichten dient ook nog eens de instelling Sectie: Koppeling OLO en Item: SaveBericht aangevinkt te staan. Voor het definiëren van de map zijn systeembeheerrechten op de server waar de OLO-service draait nodig.
Instelling m.b.t. probleem gelijktijdigheid
De service voor het verwerken van OLO-bericht kan tegelijkertijd haar werk doen met de service voor het verwerken van een zakLk01 bericht om nieuwe zaak te verwerken. Beide controleren elkaar op het reeds bestaan van een zaak c.q. OLO. Wanneer dat tegelijkertijd gebeurt kan dat misgaan.
Dit is ook het geval wanneer tegelijkertijd twee of meer OLO-berichten binnenkomen met hetzelfde OLO-aanvraagnummer.
Indien in de Sectie: [LOG] van de dusk.ini (de configuratiefile naast de Berichtenservice DUSK) het Item: MapOloZaakBenBezig is opgenomen en gevuld met een ma verwijzing waarop de service schrijf-en verwijderrechten heeft, dan:
gaat de service voor verwerken van zakLk01/02 eerst kijken of de file BezigMetOLO.txt bestaat. Zo ja dan (pollend) maximaal 5 seconden tot de file BezigMetOLO.txt niet meer bestaat. Als die file BezigMetOLO.txt niet meer bestaat (of na 5 seconden) dan maakt de zakLk01/02 service zelf een file met de naam BezigMetZaak.txt aan en verwerkt het zakLk01/02 bericht en vernietigt daarna de file BezigMetZaak.txt
gaat de service voor verwerken van OLO-bericht ook eerst kijken of de file BezigMetZaak.txt bestaat. Zo ja dan (pollend) maximaal 5 seconden tot de file BezigMetZaak.txt niet meer bestaat. Als die file BezigMetZaak.txt niet bestaat (of na 5 seconden) dan maakt de OLO-service zelf een file met de naam BezigMetOLO.txt aan en verwerkt het OLO-bericht en vernietigt daarna de file BezigMetOLO.txt.
Voor bovenstaande instellingen zijn systeembeheerrechten op de server waar de OLO-service draait nodig.
Aanmaken zaak met zaak/DMS vanuit OLO-service
De verwerking van het OLO-bericht kan leiden tot het automatisch aanmaken van een zaak in externe zaaksysteem (zaak/DMS-koppeling). Dit is het geval wanneer:
Indien de zaak NIET valt onder een compartiment dan moet de instelling Sectie: Koppeling OLO en Item: AanmakenZaakmetZaak/dms aangevinkt zijn.
Indien de zaak WEL valt onder een compartiment dan moet:
EN de instelling Sectie: Koppeling OLO en Item: AanmakenZaakmetZaak/dms aangevinkt zijn
EN bij het betreffende compartiment moet de kolom Automatisch omgevingzaak aanmaken in DMS aangevinkt hebben staan
EN de verwerking van het OLO-bericht zonder fouten is afgehandeld (een Bv03-antwoordbericht)
EN de berichtsoort van het OLO-bericht was één van de drie onderstaande mogelijkheden
EN de OLO-verwerking daadwerkelijk heeft geleid tot de aanmaak van een nieuwe kaart in OpenWave (tbomgvergunning)
EN het endpoint voor de OpenWave
API MaakZaakInZaaksysteem gedefinieerd is in de kolom tekst van instelling
Sectie: Koppeling OLO en
Item: EndpointClassWizard Het gaat hierbij om de juiste gegevens op de plek van vetgedrukte IP en poort:
http://IP-ADRES:POORT/services/nl.rem.openwave.published.Wizard.nl.rem.openwave.published.WizardHttpSoap12Endpoint/
EN het endpoint voor de OpenWave
API getAuthorisation gedefinieerd is in de kolom tekst van instelling
Sectie: Koppeling OLO en
Item: EndpointClassMedewerker Het gaat hierbij om de juiste gegevens op de plek van vetgedrukte IP en poort:
http://IP-ADRES:POORT/services/nl.rem.openwave.published.Medewerker.nl.rem.openwave.published.MedewerkerHttpSoap12Endpoint/
De OLO-service moet dus geautoriseerd zijn om de OpenWave API maak/zaak in zaaksysteem uit te voeren.
De genoemde user/pass moeten daarom 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 'Wijzigen externe zaaknummers inclusief OLOnr' aangevinkt heeft (alle overige rechten mogen uitgevinkt zijn).
Zie verder voor nodige instellingen onder programmablok Creëer zaak zaak/dms.
Automatisch aanmaken mappen op fileshare vanuit OLO-service
Let Op, dit is alleen nodig indien je wilt dat er aanmaakmappen worden aangemaakt voordat er documenten zijn. Dus wel automatisch aanmaakmappen want er worden geen automatische documenten geplaatst. Dus bij standaard OLO-koppeling waarbij documenten automatisch worden geplaatst zijn deze instellingen niet nodig.
Indien
De verwerking van het OLO-bericht zonder fouten is afgehandeld (een Bv03-antwoordbericht)
EN de berichtsoort van het OLO-bericht was één van de drie onderstaande mogelijkheden:
EN de OLO-verwerking daadwerkelijk heeft geleid tot de aanmaak van een nieuwe kaart in OpenWave (tbomgvergunning)
EN - indien de zaak NIET valt onder een compartiment-
de instelling Sectie: Documenten, Item: OphalenViaFileserver aangevinkt is
EN de instelling Sectie: Koppeling OLO en Item: Aanmaakmappen aangevinkt is
EN - indien de zaak WEL valt onder een compartiment -
de kolom ophalen via fileserver op de detailkaart van het betreffende compartiment is aangevinkt
EN de kolom Automatisch aanmaak fileservermappen bij nieuwe zaak door OLO-bericht (dloloautoaanmaakmappen) van het betreffende compartiment aangevinkt is
EN het endpoint voor de OpenWave
API maakMappenOpFileshare gedefinieerd is in de kolom tekst van instelling
Sectie: Koppeling OLO en
Item: EndpointClassWizard Het gaat hierbij om de juiste gegevens op de plek van vetgedrukte IP en poort:
http://IP-ADRES:POORT/services/nl.rem.openwave.published.Wizard.nl.rem.openwave.published.WizardHttpSoap12Endpoint/
EN het endpoint voor de OpenWave
API getAuthorisation gedefinieerd is in de kolom tekst van instelling
Sectie: Koppeling OLO en
Item: EndpointClassMedewerker Het gaat hierbij om de juiste gegevens op de plek van vetgedrukte IP en poort:
http://IP-ADRES:POORT/services/nl.rem.openwave.published.Medewerker.nl.rem.openwave.published.MedewerkerHttpSoap12Endpoint/
dan zullen bij het aanmaken van een nieuwe zaak of inrichting automatisch de mappen genoemd in de rijen van Sectie: Aanmaakmappen worden aangemaakt. Hierbij uitgezonderd zijn de mappen waarin de variabelen %adviesnr% , %bezwaarnr% en %inspnr% zijn opgenomen.
Indien OpenWave in de Cloud draait, en de fileshare is lokaal, dan dan moet wel de satellite geïnstalleerd zijn.
Automatisch vullen van kolom dvhyperlink bij aanmaken zaak
Indien:
de zaak NIET valt onder een compartiment-
EN de instelling Sectie: Documenten, Item: OphalenViaFileserver aangevinkt is
EN de instelling Sectie: Koppeling OLO en Item: Aanmaakmappen aangevinkt is
EN - indien de zaak WEL valt onder een compartiment -
de kolom ophalen via fileserver op de detailkaart van het betreffende compartiment is aangevinkt
EN de kolom Automatisch aanmaak fileservermappen bij nieuwe zaak door OLO-bericht (dloloautoaanmaakmappen) van het betreffende compartiment aangevinkt is
EN de kolom Tekst van Sectie: Hyperlink_basis en Item: Omgeving is gevuld en aangevinkt
EN de berichtsoort van het OLO-bericht was één van de drie onderstaande mogelijkheden:
EN de OLO-verwerking daadwerkelijk heeft geleid tot de aanmaak van een nieuwe kaart in OpenWave (tbomgvergunning)
dan wordt de kolom dvhyperlink bij de nieuwe zaak automatisch gevuld met de ingestelde hyperlinkbasismap, waarbij de variabelen zaakjaar, zaakjaarmaand en zaaknr zijn vervangen met de waardes van de nieuwe kaart.
In geval dat de zaak behoort bij een compartiment, dan zal de documentroot in de basismap door OpenWave on the fly worden vervangen door de inhoud van de kolom Documentroot in satellite.ini (dvsateldocroot) van het betreffende compartiment (beheerportaal-Nieuw).
OLO-bijlagen
De digi-koppelaar kan op drie manieren de bijlagen bij een OLO-bericht aan OpenWave kwijt.
Zie voor loggen en alsnog verwerken van mislukte OLO/DSO bijlages bij streaming (tweede manier hierboven) ook Upload vanuit automatisch proces.
Ketenvoorbeelden