Dit is een oude revisie van het document!
Samenwerkingsfunctionaliteit
Onder een omgevingszaak is de tegel Samenwerkingsruimtes zichtbaar en benaderbaar voor die medewerkers die (beheertegel Functionele rechten) geautoriseerd zijn om de samenwerkingsruimte te zien (tbomgrechten.dlcomgswfvsb). De tegel geeft toegang tot de tabellen tbswfruimte, tbswfoinpartners, tbswfdocumenten, tbswfactieverzoeken en tbswfnotificaties.
Inregelen landelijke samenwerkingsruimte
OpenWave verzorgt het berichtenverkeer van en naar de landelijke samenwerkingsfunctionaliteit op een eigen certificaat (van Rem Automatisering). Bij het certificaat hoort een whitelist die aangeeft welke partners (OIN-nummers) berichten kunnen sturen op dat certificaat.
Noodzakelijke instellingen
- Endpoint. In de kolom Tekst van de instelling Sectie: SWF en Item: AlgemeenEndpoint dient het algemene gedeelte van het endpoint van de landelijke samenwerkingsfunctionaliteit te staan bijvoorbeeld
https://service.pre.omgevingswet.overheid.nl/overheid/samenwerken/api/behandelen/v4/
. - CertificaatPassword. In de kolom Tekst van de instelling Sectie: SWF en Item: CertificaatPassword dient het password van het certificaat gecrypt opgeslagen te worden. Deze gecrypte waarde wordt door REM aangeleverd (en kan niet via userinterface van OpenWave gedecrypt worden). Wordt door Rem geregeld.
- CertificaatType. In de kolom Tekst van de instelling Sectie: SWF en Item: CertificaatType dient het type van het certificaat te staan namelijk PKCS12. Wordt door Rem geregeld.
- ClientCertificaatNaam. In de kolom Tekst van de instelling Sectie: SWF en Item: ClientCertificaatNaam dient de naam van het certificaat te staan namelijk digikoppeling.open-wave.nl_20210624.p12. Wordt door Rem geregeld.
- OIN van zender. In de kolom Tekst van de instelling Sectie: SWF en Item: OINvanZender dient het OIN-nummer te staan van de organisatie die OpenWave gebruikt en die dus in de whitelist voor moet komen. Bijvoorbeeld de omgevingsdienst ODDEVALLEI zal 00000001852282229000 als waarde moeten invullen. Indien vanuit de tegel Samenwerkingsruimte berichten worden verstuurd, dan kan OpenWave - indien de bijbehorende omgevingszaak bij een compartiment hoort - de OINvanZender ophalen uit de compartimentstabel (tbcompartiment.dvswfoinzender).
Waarschuwing
Vanaf 1.30 is deze instelling WEL nodig voor de programmatuur die binnenkomende actieverzoeken verwerkt, openstaande SWF ruimtes synchroniseert en andere automatische tasks. Maar vanaf 1.30 wordt er niet meer naar deze instelling gekeken voor bepalen OIN van Zender bij handmatige opvraagacties naar het SWF: dit zijn alle knoppen in SWF ruimte detailscherm. Zie ook kopje Bepalen OIN van zender aanmaken en muteren van samenwerkingsruimtes voor de nieuwe voorwaarden.
- Messagelog. Indien de instelling Sectie: SWF en Item: MessageLog_InkomendeActieverzoeken is aangevinkt dan worden de berichten van de operatie Ophalen Inkomende Open Actieverzoeken gelogd in de beheertabel tbmessagelog. Dit is niet altijd nodig en bovendien verzwarend, vandaar deze instelling. Uitgaande berichten naar samenwerkingsfunctionaliteit vanuit de tegel Samenwerkingsruimtes bij een omgevingszaak, worden wel altijd gelogd in de tabel tbmessagelog (mits de instelling Sectie: OWB, Item: MessageLog aangevinkt is).
- Key van onbekend lokatieadres.Getal2 van de instelling Sectie: Koppeling ZAAK Item: DummyLokatiePerceelkey moet gevuld zijn met een dnkey uit tbperceeladressen die staat voor een onbekend adres waaraan nieuwe zaken worden gekoppeld bij de operatie inlezen open inkomende actieverzoeken.
- Zaaktype bij actieverzoek. In de beheertabel Zaaktypes omgeving moet één (niet vervallen) kaart zijn waarbij Is zaaktype actieverzoek SamenwerkingsFunctionaliteit (dlswfactieverzoek) aangevinkt is. Onder dit zaaktype worden nieuwe binnenkomende open actieverzoeken, waarvoor een nieuwe zaak moet worden aangemaakt, met een nieuwe samenwerkingsruimte geplaatst.
Bepalen OIN van zender aanmaken en muteren van samenwerkingsruimtes
Belangrijk voor ALLE organisaties
Acties bij de samenwerkingsruimte
Aanmaken SWF ruimte
Knoppen op detailkaart van de SWF ruimte
Ververs SWF ruimte
Verleng de einddatum
Toevoegen extern contact aan zaak
Sluiten en verwijderen van de SWF ruimte
Aanwijzen/Wijzigen van de samenwerkingspartners
Als de (landelijke) samenwerkingsruimte is aangemaakt en nog open staat moet aangegeven worden aan welke ketenpartners straks een of meer actieverzoeken worden verzonden. Op het detailscherm van de samenwerkingsruimte is hiertoe het blok Ketenpartners. De insertknop is zichtbaar indien:
- de medewerker insertrechten op de samenwerkingsruimte (tbomgrechten.dlcomgswfvsb) heeft
- de samenwerkingsruimte nog NIET is beëindigd
- de aanmaker van de samenwerkingsruimte (tbswf.dvaangemaaktdooroinin) dezelfde is als de door programmatuur bepaalde OIN van zender (zie kopje Bepalen OIN van zender aanmaken en muteren van samenwerkingsruimtes).
Met de insertknop kan een ketenpartner gekozen worden uit de beheertabel tboin waarvoor geldt:
- dat de OIN-organisatie nog niet is vervallen
- EN dat de eigenschap SWF is aangevinkt (is partner samenwerkingsfunctionaliteit: dlswf)
- EN dat het OIN-nummer ongelijk is aan de door programmatuur bepaalde OIN van zender (zie kopje Bepalen OIN van zender aanmaken en muteren van samenwerkingsruimtes)
- EN dat het OIN nog niet is toegevoegd bij de betreffende samenwerkingsruimte.
Daarnaast dient een privilege toegekend te worden aan de partner (BT = beperkte toegang en VT = volledige toegang). Dit privilege wordt vergeleken met de vertrouwelijkheidaanduiding van een geüpload document. Een ketenpartner met Beperkte Toegang die documenten opvraagt van een samenwerkingsruimte, zal alleen de documenten met Regulier Vertrouwelijk zien.
Indien succesvol (hetgeen betekent dat ook de landelijke SWF de partner heeft geaccepteerd) wordt een kaart aangemaakt in tbswfoinpartners bij de betreffende samenwerkingsruimte.
Voor het verwijderen van een ketenpartner dient de medewerker het afsluit/verwijderrecht in SWF te hebben op de samenwerkingsruimte (tbomgechten.dlcomgswfafs).
Wijzigen privilege van samenwerkingspartner
SWF Documenten functionaliteit
OpenWave kijkt voor de documentfunctionaliteit alleen naar het recht om de samenwerkingsruimte te zien (tbomgrechten.dlcomgswfvsb). M.u.v. het verwijderen van documenten in het SWF (zie kopje Verwijderen).
Waarschuwing
De samenwerkingsruimte moet nog open staan
Uploaden
Downloaden
Downloadcentrum
Synchroniseren
Verwijderen
Doorzetten naar documentopslag + registreren
Wijzigen vertrouwelijkheid van document
Uitgaande Actieverzoeken
Als de (landelijke) samenwerkingsruimte is aangemaakt en nog open staat kunnen één of meer actieverzoeken worden verstuurd naar één van ketenpartners van de samenwerkingsruimte met een titel en een beschrijving. In het geval dat men niet de aanmaker van de SWF ruimte is, kan men ook een actieverzoek versturen aan de initiator van de SWF ruimte.
Op het lijstscherm zijn de volgende knoppen zichtbaar en enabled:
- De insertknop waarmee een nieuw actieverzoek gemaakt kan worden (met tbswfactieverzoeken.dluitgaand = T) is zichtbaar en enabled indien:
- de medewerker insertrechten heeft op de samenwerkingsruimte (tbomgrechten.dlcomgswfvsb)
- de samenwerkingsruimte nog NIET is beëindigd en nog OPEN staat
- het OIN nummer van de aanmaker van het verzoek moet gelijk zijn aan de door programmatuur bepaalde OIN van zender (zie kopje Bepalen OIN van zender aanmaken en muteren van samenwerkingsruimtes). De organisatie waarmee het actieverzoek wordt aangemaakt kan de aanmaker van de samenwerkingsruimte zijn maar dat hoeft niet (kan ook een van de ketenpartners zijn die een actieverzoek heeft ontvangen)
- compartiment ok en bovenliggende zaak niet is geblokkeerd.
- Verversknop (synchroniseer met landelijke ruimte)is zichtbaar en enabled indien:
- compartiment ok en bovenliggende zaak niet is geblokkeerd
- de SWF-ruimte nog NIET is beëindigd.
Op het detailscherm zijn de volgende knoppen zichtbaar en enabled indien:
- Actieverzoek gereedmelden is zichtbaar en enabled indien:
- het actieverzoek nog in de landelijke SWF aanwezig is
- de status van de actie op OPEN staat
- de medewerker muteerrechten heeft op de samenwerkingsruimte (tbomgrechten.dlcomgswfedt)
- de samenwerkingsruimte nog NIET is beëindigd en nog OPEN staat
- de ontvanger van het actieverzoek (tbswfactieverzoeken.dvontvangeroin) dezelfde is als de door programmatuur bepaalde OIN van zender (zie kopje Bepalen OIN van zender aanmaken en muteren van samenwerkingsruimtes)
- compartiment ok en bovenliggende zaak niet is geblokkeerd.
Met het gereedmelden wordt de status van het actieverzoek: GEREED
- Actieverzoek intrekken is zichtbaar en enabled indien:
- het actieverzoek nog in de landelijke SWF aanwezig is
- de status van de actie op OPEN of GEREED staat
- de medewerker muteerrechten heeft op de samenwerkingsruimte (tbomgrechten.dlcomgswfedt)
- de samenwerkingsruimte nog NIET is beëindigd en nog OPEN staat
- de zender van het actieverzoek (tbswfactieverzoeken.dvzenderoin) dezelfde is als de door programmatuur bepaalde OIN van zender (zie kopje Bepalen OIN van zender aanmaken en muteren van samenwerkingsruimtes)
- compartiment ok en bovenliggende zaak niet is geblokkeerd.
Met het intrekken wordt de status van het actieverzoek: INGETROKKEN.
Inkomende Open Actieverzoeken
Zie voor schema: SWF Verwerking Inkomende Actieverzoeken
Op het operationsportaal onder de kolom Import is een tegel gedefinieerd Ophalen SWF Open Actieverzoeken. De actie achter deze tegel haalt alle inkomende openstaande actieverzoeken op uit de landelijke SWF voor de OpenWave installatie.
Indien de medewerker:
- GEEN lid van een compartiment is, dan worden de berichten opgehaald die verzonden zijn naar:
- het OIN-nummer gedefinieerd in kolom Tekst van de instelling Sectie: SWF en Item: OINvanZender
- EN naar de OIN-nummers (gescheiden door puntkomma) gedefinieerd in kolom Info van de instelling Sectie: SWF en Item: OINvanZender. Bedoeld voor de situatie van een samenwerkingsverband, zoals de BEL-combinatie, die zowel een overkoepelend OIN-nummer hebben als individuele gemeentelijke OIN-nummers.
Waarschuwing
Alle OIN-nummers moeten op de whitelist geplaatst worden.
- WEL lid van een compartiment is dan worden de berichten opgehaald die verzonden zijn naar de OIN-nummers (gescheiden door puntkomma) gedefinieerd in kolom tbcompartiment.dvswfoinzender van het betreffende compartiment. Bedoeld voor die situatie waarbij een compartiment uit een samenwerkingsverband bestaat (Over-Gemeente).
De actie achter de tegel kan ook gescheduled aangeroepen worden (zie:Taskscheduler). De robot haalt in dat geval alle berichten op die verzonden zijn naar:
- het OIN-nummer gedefinieerd in kolom Tekst van de instelling Sectie: SWF en Item: OINvanZender
- EN naar de OIN-nummers (gescheiden door puntkomma) gedefinieerd in kolom Info van de instelling Sectie: SWF en Item: OINvanZender
- EN naar de OIN-nummers (gescheiden door puntkomma) gedefinieerd in kolom tbcompartiment.dvswfoinzender van alle niet vervallen compartimenten.
Het programma redeneert voor de verwerking van die berichten als volgt: eerst zoekt OpenWave of het actieverzoek al bestaat in de bestaande kaartenbak van tbswfactieverzoeken. Maar alleen in de kaarten die dlUitgaand op F(alse) hebben staan. Immers binnen een samenwerkingsverband kan de ene gemeente een actieverzoek aan de andere uit doen gaan.
- Indien het actieverzoek reeds bestaat in OpenWave (tbswfactieverzoeken.dvactieverzoekid) dan wordt deze kaart ververst.
- Indien het actieverzoek nog niet bestaat in OpenWave, maar de bijbehorende samenwerkingsruimte wel (tbswfruimte.dvsamenwerkingid), dan wordt het nieuwe actieverzoek toegevoegd aan die bestaande SWF-ruimte in OpenWave (met dluitgaand = F). Hierop is de uitzondering indien de instelling Sectie: SWF en Item: ActieverzoekNwezaak aangevinkt is: dan wordt altijd een nieuwe zaak aangemaakt en de SWF-ruimte gedupliceerd. Voor compartimenten is hiertoe de kolom tbcompartiment.dlActieverzoekNwezaak.
- Indien zowel het actieverzoek als de samenwerkingsruimte nog niet bestaat (of ingesteld dat er altijd een nieuwe zaak gemaakt moet worden), dan wordt:
- een nieuwe zaak gemaakt in tbomgvergunning met als zaaktype de (unieke, niet vervallen) kaart uit tbsoortomgverg waarvoor geldt dat de kolom Is zaaktype actieverzoek SamenwerkingsFunctionaliteit (dlswfactieverzoek) aangevinkt is (zie schema voor meer adequate beschrijving). De behandelaar van deze zaak is de default behandelaar zoals aangegeven bij het zaaktype. Is deze niet gevuld dan zet de programmatuur als behandelaar de ingelogde medewerker die de openstaande actieverzoeken heeft binnen gehaald
Afwijkend zaaktype
Indien bij het SWF actieverzoek door de zendende organisatie een productcode opgegeven is dan gaat de programmatuur controleren of bij de ontvangende organisatie deze productcode voorkomt bij een omgevingszaaktype waarbij de eigenschap Is zaaktype actieverzoek SamenwerkingsFunctionaliteit NIET is aangevinkt. De programmatuur van OpenWave zal in dat geval het gevonden SWF advieszaaktype zoals hierboven beschreven vervangen door het gevonden zaaktype o.b.v. deze productcode. Voor meer informatie zie pagina SWF Afwijkende Zaaktypes
- deze nieuwe zaak wordt gekoppeld aan de locatie met tbperceeladressen.dnkey = Getal2 van de instelling Sectie: Koppeling ZAAK Item: DummyLokatiePerceelkey. Bij compartimenten kijkt OpenWave naar tbcompartiment.dnkeyswfdummyadres
- aan deze nieuwe zaak wordt de samenwerkingsruimte gekoppeld, die bij het actieverzoek hoort. Deze samenwerkingsruimte is dus door een externe partij aangemaakt
- bij de nieuwe samenwerkingsruimte worden alle op dat moment bekende ketenpartners van de SWF ruimte opgenomen in de tabel tbswfoinpartners. De ketenpartners zijn daarmee zichtbaar in het blok Ketenpartners in het detailscherm van de samenwerkingsruimte
- aan de nieuwe samenwerkingsruimte wordt het actieverzoek gekoppeld (met dluitgaand = F). De medewerker kan zelf bij de samenwerkingsruimte de documenten ophalen
- wanneer bij het zaaktype de verplichte adressoort (rol) is gevuld, dan wordt de OIN van de zender van het actieverzoek opgezocht in de beheertabel tboin. Indien aldaar de kolom ID uit tbcontactadressen t.b.v. aanvrager bij nieuwe zaak op basis actieverzoek is gevuld (met een dnkey uit tbcontactadressen), dan wordt bij de nieuwe omgevingszaak dit contactadres toegevoegd onder de gevonden adresrol van het zaaktype. LET OP: indien gebruik gemaakt wordt van een DMS dan zal het contactadres-ID gevuld moeten worden bij alle Samenwerkingspartners.
- wanneer voor de OIN van zender in de beheertabel tboin het vinkje Bij inkomend actieverzoek SWF dit OIN vullen bij uitvoerende instantie van de zaak als Ontvanger aangevinkt is, dan wordt de OIN van zender overgenomen in tbomgvergunning.dnkeyoinuitvinst (is de Ontvangende instantie)
- wanneer voor de organisatie van wie het actieverzoek afkomstig is in de beheertabel tboin het vinkje Bij inkomend actieverzoek SWF dit OIN vullen bij bevoegd gezag van de zaak als Vrager is, dan wordt het deze organisatie overgenomen in tbomgvergunning.dnkeyoinbevgez (is de Vragende instantie).