Inhoud

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

Waarschuwing

Let op: indien men in OpenWave met meerdere organisaties werkt zal voor bepalen OIN van zender deze instelling gebruikt worden indien de uitvoerende instantie van de zaak bovenliggend aan SWF ruimte gevuld is. Is deze niet gevuld dan zal het programma naar bevoegd gezag kijken (indien gevuld) en anders het OIN nummer van de gemeente waarin de zaak zich afspeelt.

Bepalen OIN van zender aanmaken en muteren van samenwerkingsruimtes

Naast bovengenoemde instellingen en condities zoals verder per blok op deze pagina beschreven, wordt er voor ALLE aanroepen naar de SWF toe vanuit OpenWave een OIN zender bepaald. Dit is het OIN nummer van de organisatie die de aanroep initieert en zal zoals bovenstaand genoemd bij Noodzakelijke instellingen, moeten voorkomen in de whitelist om ook de aanroep te mogen doen naar de SWF.

Het kan per OpenWave installatie verschillen of er altijd 1 OIN van zender is of dit per zaak kan verschillen. Indien men met 1 organisatie in OpenWave werkt en dit is een uitvoerende instantie dan is het voldoende om de configuratie instelling zoals hierboven beschreven, ingesteld te hebben. Idem dito als er precies één gemeente/provincie in de OpenWave omgeving werkt en er alleen zaken in behandeling zijn waarvan de gemeente het bevoegd gezag is.

Het wordt ingewikkelder als met meer dan 1 gemeente in dezelfde OpenWave omgeving werkt, er met compartimenten gewerkt wordt en of als er zowel een gemeente als een uitvoerende instantie in dezelfde OpenWave omgeving werkt. De aanroepen naar SWF zullen dan afhankelijk van de zaak waarin gewerkt wordt met een andere OIN van zender moeten gebeuren: het is niet de bedoeling dat dan voor zaak van organisatie 1, de aanroep naar SWF gebeurt met het OIN-nummer van organisatie 2.

Om deze redenen is de volgende logica van toepassing bij het bepalen van OIN van zender voor alle SWF aanroepen:

Zie ook schematisch weergeven de logica met als voorbeeld SWF-ruimte aanmaken:

Belangrijk voor ALLE organisaties

Het is dus zeer belangrijk dat de organisaties in de OpenWave omgeving voorkomen in tboin (OIN nummers tegel in beheerportaal-Nieuw). Voor alle via DSO binnengekomen zaken zullen de aanroepen naar SWF altijd goed gaan met bovenstaande logica. Immers dan is altijd de uitvoerende instantie en/of het bevoegd gezag gevuld. Voor de handmatig aangemaakte zaken zal het bevoegd gezag en/of de uitvoerende instantie niet standaard gevuld zijn. Het is aan te raden dit door de behandelaar van de zaak te laten vullen.

Voor de zaken die aangemaakt worden n.a.v. binnenkomende SWF-actieverzoeken is het instelbaar om het bevoegd gezag of uitvoerende instantie automatisch te laten vullen. In het beheerportaal-Nieuw is onder tegel OIN nummers per eigen organisatie aan te geven of automatisch het bevoegd gezag, of de uitvoerende instantie gevuld moet worden bij het aanmaken van een SWF advieszaak in OpenWave door het aanvinken van veld Is bevoegd gezag bij advieszaak o.b.v. binnenkomend actieverzoek SWF (in geval van bevoegd gezag), of van veld Is uitvoer inst./behandeldienst bij advieszaak o.b.v. binnenkomend actieverzoek SWF (in geval van uitvoerende instantie). Er kan maar 1 van de twee velden aangevinkt zijn per OIN-nummer.

Aanmaken / verwijderen samenwerkingsruimte

De omgevingskaart mag niet geblokkeerd zijn en het compartiment moet kloppen.

Een gebruiker die geautoriseerd is om een nieuwe samenwerkingsruimte aan te maken (tbomgrechten.dlcomgswfins) kan vanuit de lijst achter de tegel Samenwerkingsruimtes op een omgevingsportaal een nieuwe ruimte creëren. Dat gaat in twee stappen. Eerst wordt de ruimte in OpenWave gemaakt (een kaart in de tabel tbswfruimte). Hierbij:

Vervolgens kan vanuit het detailscherm de ruimte in de landelijke DSO-samenwerkingsruimte worden gemaakt. Is dat laatste gelukt dan wordt in de OpenWave tabel de kolom SWF id automatisch gevuld met de landelijke identificatie. Dan wordt o.a. ook automatisch de SWF creatiedatum gevuld.

Indien de kolom SWF id gevuld is, dan is de kaart niet muteerbaar in OpenWave en een getrouwe afspiegeling van de landelijke samenwerkingsruimte.

Zolang de kolom SWF id nog niet is gevuld, kan de kaart verwijderd worden uit OpenWave (tbomgrechten.dlcomgswfdel). Indien de kolom SWF id wel is gevuld dan kan de kaart alleen verwijderd worden indien ook landelijke de samenwerkingsruimte is beëindigd: de kolom tbswfruimte.ddverwijderd wordt daarbij gevuld.

Op de detailkaart van een samenwerkingsruimte in OpenWave zijn linksonder vier knoppen:

Indien het programma bij het verversen tot de constatering komt dat de landelijke ruimte niet meer bestaat (respons errorcode 404), dan wordt de kolom tbswfruimte.ddverwijderd gevuld met timestamp van dat moment. Deze kolom ddverwijderd kan ook weer worden leeggemaakt indien bij een volgende synchronisatie-actie de ruimte toch weer blijkt te bestaan.

Voor de documenten, actieverzoeken en notificaties geldt dat indien tijdens het verversen (synchroniseren) blijkt dat een verzoek of document of notificatie niet meer bestaat in het SWF, deze regel in OpenWave een rood bolletje krijgt (onderliggend wordt de kolom dlinswf gevuld met F). De historie blijft zo bestaan.

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:

Met de insertknop kan een ketenpartner gekozen worden uit de beheertabel tboin waarvoor geldt:

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 gebruiker het afsluit/verwijderrecht in SWF te hebben op de samenwerkingsruimte (tbomgechten.dlcomgswfafs).

Wijzigen privilege van samenwerkingspartner

In het blok Ketenpartners is de knop Wijzig ketenpartner privilege zichtbaar indien:

De knop start een wizard waarmee het gewenste privilege opgegeven kan worden voor de ketenpartner. Bij uitvoeren van de wizard zal aan het SWF dit nieuw opgegeven privilege worden doorgegeven. Let op: er is helaas geen verversactie voor de Ketenpartnerlijst bij een SWF-ruimte. Het aanpassen van het privilege zal pas voor de medewerker zichtbaar zijn na draaien van Task SynchroniseerOpenSWFRuimtes. Voor het instellen van de task scheduler zie pagina Taskscheduler.

Uploaden en downloaden en synchroniseren van documenten

OpenWave kijkt voor de documentfunctionaliteit alleen naar het recht om de samenwerkingsruimte te zien (tbomgrechten.dlcomgswfvsb).

De samenwerkingsruimte moet nog open staan!!

Uploaden

Als de (landelijke) samenwerkingsruimte is aangemaakt kunnen documenten geüpload worden. Op het detailscherm van de samenwerkingsruimte is hiertoe het blok Documenten aanwezig. Met de uploadknop (mits de samenwerkingsruimte nog NIET is beëindigd) wordt een wizard gestart waarmee de gebruiker een document kan aanwijzen. Dat kan een document zijn dat op de eigen device staat of een document uit de geregistreerde documentenlijst bij dezelfde omgevingzaak. In het laatste geval kan alleen een keuze gemaakt worden uit die documenten waarvoor geldt dat ze niet zelf uit het SWF afkomstig zijn (tbcorrespondentie.Dvswfdocumentid moet leeg zijn) en dat het document vrij moet zijn (dvdocplaats =(S)erver) en niet vervallen.
De gebruiker dient ook aan te geven of het document Strikt Vertrouwelijk of Regulier Vertrouwelijk is. Strikt vertrouwelijke documenten kunnen alleen gezien worden door ketenpartners met het privilege Volledige Toegang.

Bij een document hoort een beschrijving. Nummer en Kenmerk zijn niet verplicht.

De documenten die ook in de landelijke SWF staan worden in OpenWave gesynchroniseerd in de tabel tbswfdocumenten. Daar is ook de identifier zichtbaar waaronder het document landelijk bekend is.

Downloaden

Met de downloadknop kan een document naar de device van de gebruiker worden gedownload. Vooralsnog wordt het gedownloade document dus niet automatisch in de documentopslag van OpenWave (fileshare of DMS) geplaatst. Zie daarvoor de knop hieronder: Doorzetten naar documentopslag + registreren

Synchroniseren

De synchroniseerknop haalt alle (metadata van alle) documenten bij de betreffende samenwerkingsruimte op, waarmee de lijst in OpenWave gelijk wordt gemaakt aan de lijst in de landelijke ruimte. Immers ketenpartners kunnen documenten hebben toegevoegd of gewijzigd.

Verwijderen

De verwijderknop zal NOOIT het document in SWF verwijderen maar is bedoeld om documenten uit de lijst van OpenWave te verwijderen die gepoogd zijn up te loaden bij het SWF maar waarvoor dat niet gelukt is. Zo'n document is te herkennen aan icoon rood kruis. Indien men op de verwijderknop klikt voor een documentregel waarvan het document wel in SWF staat (icoon groen vinkje) dan zal het programma een melding geven met dat het document niet verwijderd kan worden.

Doorzetten naar documentopslag + registreren

Indien er gebruik wordt gemaakt van documentregistratie in OpenWave, dan kan met behulp van deze knop de aangevinkte documenten doorgezet worden naar de documentopslag (fileshare/DMS).

Voor het automatisch registreren van SWF documenten zal gekeken worden of instelling Sectie: DocumentRegistreren, Item: AlleGeselecteerdeSWFUploads aan staat (bij compartiment of Geselecteerde SWF uploads automatisch registreren? aangevinkt is.

In de lijst met SWF documenten wordt bij kolom Reg? aangegeven of het document al geregistreerd staat bij de zaak (er komt een kaart voor in tbcorrespondentie met overeenkomend Doc id SWF). Zo ja dan staat er een groen vinkje, anders een rood kruisje.

Men kan 1 of meer documenten aanwijzen alvorens op de knop te klikken. Er zal alleen een scherm getoond worden indien er een fout optreedt waardoor de documenten niet doorgezet kunnen worden.

De wizard zal voor de documenten die nog niet voorkomen in tbcorrespondentie, deze doorzetten naar fileshare dan wel DMS en indien gelukt daarna een kaart aanmaken in tbcorrespondentie.

De doelmap op de fileshare wordt bepaald door de instelling Sectie: AanmaakMappen en Item: (begint met) Omgeving_ EN Getal2 heeft waarde 1 (waarbij de substring %zaakjaar% en %zaaknr% gesubstitueerd worden door zaaknummer en jaar van de betreffende omgevingzaak).
Indien geen satellite dan is de bestemming gelijk aan de doelmap (zowel voor host als voor compartiment).
Bij de combinatie compartiment en satellite wordt de bestemming bepaald door de inhoud van de kolom dvsatellitedocroot van het betreffende compartiment gevolgd door de doelmap waar de string docroot dan weer uitgehaald is. De docroot is de inhoud van de kolom Tekst van instelling Sectie: Documenten Item Documentroot

In de lijst Geregistreerde Documenten zijn de aangemaakte kaarten terug te vinden.

Documenttype wordt gedefinieerd in kolom Tekst van de instelling Sectie: SWF en Item: Documenttype (vanaf versie 1.29.3) De defaultwaarde is:SWF.
De vertrouwelijkheid van de documenten wordt als volgt bepaald:

Wijzigen vertrouwelijkheid van document

Met de wijzigknop kan de vertrouwelijkheid van het document in de SWF-ruimte gewijzigd worden. De wijzigknop is zichtbaar indien:

De knop start een wizard waarmee de gewenste vertrouwelijkheid opgegeven kan worden voor het document. Bij uitvoeren van de wizard zal aan het SWF de nieuwe vertrouwelijkheid worden doorgegeven.
Let op: Het aanpassen van de vertrouwelijkheid zal pas voor zichtbaar zijn na verversen van de documenten in SWF. Dit kan bijvoorbeeld door klikken op de verversknop onderaan de lijst.
N.b. het is niet zo dat de vertrouwelijkheid in de eventueel in OpenWave corresponderende documentregistratie (en/of DMS opslag) wordt aangepast! Indien men daar de vertrouwelijkheid zou willen wijzigen, dan zal dit handmatig moeten worden uitgevoerd door de gebruiker.

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:

Op het detailscherm zijn de volgende knoppen zichtbaar en enabled indien:

Met het gereedmelden wordt de status van het actieverzoek: GEREED

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 inlogger:

Waarschuwing

LET OP: alle OIN-nummers moeten op de whitelist geplaatst worden.

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 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.