====== Verwerking van StUF OLO/AIM berichten ====== * Deze service wordt door externe programma(s) aangeroepen. * De wsdl van deze service heeft format: ''http://IP-ADRES:POORT/wv_olo_document_311/wsdl/IOntvangAsynchroon'' * 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: * vrgDi01AanvragenVooroverleg * omvDi01AanbiedenAanvraag * vrgDi01AanvragenAdvies samen met omvDu01LeverenAanvraag * wwvDi01AanbiedenAanvraag * wwvDu01LeverenAanvraag De service verwerkt de volgende berichtsoort tot toevoegen van een extern zaaknummer (dvintzaakcode) aan bestaande OpenWave zaak (mits OLO aanvraagnummer bekend): * vrgDi01KoppelZaakAanAanvraag (OpenWave kan ook zelf een vrgDi01KoppelZaakAanAanvraag initiëren om bijv. aan het OLO-loket terug te koppelen onder welke OpenWave zaakcode het bericht is opgeslagen: zie hiervoor het kopje //Uitgaande bericht: KoppelZaakAanAanvraag-instellingen//). De service verwerkt de volgende berichtsoorten tot kaarten in de tabel tbOmgOLOberichten bij een bestaande OpenWave zaak (mits OLO-aanvraagnummer bekend): * vrgDi01IndienenAanvulling * vrgDi01VoegAdviesToe * vrgDi01IntrekkenAanvraag * vrgDi01VerwijderenAanvraag * vrgDi01WijzigGemachtigde 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 ==== Zie: [[openwave:1.29:applicatiebeheer:probleemoplossing:programmablokken:olo_verwerking:programma-logica_olo_verwerking|Programma logica OLO-verwerking]]. ===== 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 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 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 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 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 . 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 (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 . 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. ==== Extra AIM-instellingen ==== 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 * vrgDi01AanvragenVooroverleg of * omvDi01AanbiedenAanvraag of * omvDu01LeverenAanvraag * 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/ * EN de user/pass waarmee getAuthorisation aangeroepen wordt moeten gedefinieerd zijn in de kolommen //Tekst// van de instellingen //Sectie: Logon// en //Item: ExternOLOLogin// en //Sectie: Logon// en //Item: ExternOLOpass//. 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 [[openwave:1.29:applicatiebeheer:probleemoplossing:programmablokken:creeer_zaak_zaak_dms|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: * vrgDi01AanvragenVooroverleg of * omvDi01AanbiedenAanvraag of * omvDu01LeverenAanvraag * 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/ * EN de user/pass waarmee getAuthorisation aangeroepen wordt moeten gedefinieerd zijn in de kolommen tekst van de instellingen //Sectie: Logon// en //Item: ExternOLOLogin// en //Sectie: Logon// en //Item: ExternOLOpass//. De genoemde user/pass moeten 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 kolom //deze persoon hoeft geen inlogverklaring af te vinken//, aangevinkt is 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 [[openwave:1.29:applicatiebeheer:instellen_inrichten:satellite_filesysteem|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: * vrgDi01AanvragenVooroverleg of * omvDi01AanbiedenAanvraag of * omvDu01LeverenAanvraag * 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. * In het geval dat OpenWave met een CMIS-koppeling verbonden is aan een DMS kunnen de documenten op een afgesproken plek in dat DMS (een map op basis van het OLO-nummer) geplaatst worden (de digi-koppelaar wordt daartoe geautoriseerd door het DMS). Bij het opvragen van documenten worden deze bijlagen door OpenWave naar de goede map behorende bij de OpenWave zaak verplaatst (Zie voor instellingen toon documenten ophalen met CMIS). * De tweede manier is dat de digi-koppelaar een bijlage onder http (met naam en wachtwoord) streamt naar een OpenWave URL (upload service) met twee postvariabelen: OLO-nummer en filenaam. Aldaar wordt de bijlage opgepakt en vervolgens geüpload naar ofwel fileshare, ofwel DMS via CMIS, ofwel DMS via stuf zaak/DMS bericht. Zie hiervoor [[openwave:1.29:applicatiebeheer:probleemoplossing:programmablokken:upload_vanuit_automatisch_proces|Upload vanuit automatisch proces]]. * De derde manier is dat de digi-koppelaar de bijlages plaatst op een afgesproken plek op een fileshare. OpenWave pakt deze bijlages op en vervolgens worden deze verplaatst naar ofwel een andere plek op de fileshare, ofwel DMS via CMIS, ofwel DMS via stuf zaak/DMS bericht. Zie: [[openwave:1.29:applicatiebeheer:probleemoplossing:programmablokken:toon_documenten_en_download|Toon documenten en download]]. Zie voor loggen en alsnog verwerken van mislukte OLO/DSO bijlages bij streaming (tweede manier hierboven) ook [[openwave:1.29:applicatiebeheer:probleemoplossing:programmablokken:upload_vanuit_automatisch_proces|Upload vanuit automatisch proces]]. ===== Ketenvoorbeelden ===== * [[openwave:1.29:applicatiebeheer:probleemoplossing:programmablokken:olo_verwerking:ketenvoorbeeld_olo_digikoppelaar_openwave_fileshare|Ketenvoorbeeld OLO Digikoppelaar OpenWave Fileshare]] * [[openwave:1.29:applicatiebeheer:probleemoplossing:programmablokken:olo_verwerking:ketenvoorbeeld_olo_digikoppelaar_openwave_zaak_dms|Ketenvoorbeeld OLO Digikoppelaar OpenWave Zaak/DMS]] * [[openwave:1.29:applicatiebeheer:probleemoplossing:programmablokken:olo_verwerking:ketenvoorbeeld_olo_digikoppelaar_zaak_openwave|Ketenvoorbeeld OLO Digikoppelaar Zaak OpenWave]]