Verschillen

Dit geeft de verschillen weer tussen de geselecteerde revisie en de huidige revisie van de pagina.

--- openwave:1.32:applicatiebeheer:instellen_inrichten:samenwerkingsfunctionaliteit [2025/03/21 12:59] – [Aanmaken / verwijderen en overige acties bij de samenwerkingsruimte] Lonneke van Dijk
+++ openwave:1.32:applicatiebeheer:instellen_inrichten:samenwerkingsfunctionaliteit [2025/03/24 16:52] (huidige) – [Samenwerkingsfunctionaliteit] Lonneke van Dijk
@@ Regel 1: / Regel 1: @@
 ====== Samenwerkingsfunctionaliteit ======
+Op deze pagina staan de functionaliteiten beschreven omtrent de samenwerkingsruimtes in OpenWave.\\
+Samenwerkingsruimtes vallen onder de omgevingmodule in OpenWave. Onder een omgevingszaak is de tegel //Samenwerkingsruimtes// zichtbaar en benaderbaar voor die medewerkers die geautoriseerd zijn om de samenwerkingsruimte te zien (beheertegel //Functionele rechten//, tbomgrechten.dlcomgswfvsb = T).
+De tegel geeft toegang tot de lijst met samenwerkingsruimtes (SWF ruimtes) bij de omgevingszaak. \\
+Via de lijst kan men doorklikken naar het detailscherm van een SWF ruimte. Hier vindt men de gegevens van de SWF ruimte inclusief de lijst-schermen van de Ketenpartners (tbswfoinpartners), Actieverzoeken (tbswfactieverzoeken), Documenten (tbswfdocumenten) en Notificaties (tbswfnotificaties) in de SWF ruimte.\\
-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).
+Onderstaand schema toont de onderliggende databasetabellen in OpenWave betrokken bij de SWF lijst- en detailschermen benaderbaar via de Omgevingszaak:
-De tegel geeft toegang tot de tabellen tbswfruimte, tbswfoinpartners, tbswfdocumenten, tbswfactieverzoeken en tbswfnotificaties.
 {{:openwave:applicatiebeheer:instellen_inrichten:samenwerkingfunctionaliteitinopenwave.png?800|}}
+Op deze dokuwiki pagina worden eerst de noodzakelijke instellingen beschreven en vervolgens worden de functionaliteiten die onder de samenwerkingsruimte tegel vallen uitgelegd.
 ===== Inregelen landelijke samenwerkingsruimte =====
@@ Regel 50: / Regel 54: @@
 ===== Acties bij de samenwerkingsruimte =====
+==== Aanmaken SWF ruimte ====
+Voor het aanmaken van een SWF ruimte mag de omgevingskaart niet geblokkeerd zijn en het compartiment moet kloppen.\\
+Een medewerker 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:
+     * wordt de Bron (dvbronVerzoek) alleen gevuld met de waarde ‘DSO_LV’ indien de zaak in OpenWave een DSO-zaak betreft (dus projectid gevuld). In alle andere gevallen blijft deze kolom leeg.
+     * wordt het verzoekNummer (dvverzoeknummer) gevuld met het DSO-verzoeknummer indien de zaak een DSO-zaak is: in alle andere gevallen blijft deze kolom leeg
+  * 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 en einddatum 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.
+Een SWF ruimte heeft een status/toestand: voorheen waren de opties voor de status OPEN of GESLOTEN. Daar is vanaf 1.32 (SWF v5 versie) bijgekomen de status INITIALISATIE.
+De status INITIALISATIE wordt door het SWF zelf aan de SWF ruimte gegeven. En wordt toegepast in de volgende twee situaties:
+  * 1. direct na het starten van de samenwerking waarbij ook het verzoek wordt opgehaald (alleen indien verzoeknummer is gevuld bij de SWF ruimte), en
+  * 2. als (een aanvulling op) een verzoek wordt opgehaald
+De status INITIALISATIE geeft aan dat nog het een ander klaargezet wordt in het SWF en dat het beter is te wachten totdat de status weer op OPEN staat alvorens documenten op te halen.
+Een aantal acties zijn niet mogelijk als de SWF ruimte status INITIALISATIE heeft:
+  * De samenwerking sluiten
+  * Het ophalen van een aanvulling op een verzoek starten
+OpenWave geeft nette meldingen mocht zo'n actie toch worden uitgevoerd. Het verversen van de SWF ruimte (al dan niet handmatig) zorgt ervoor dat zodra het SWF de ruimte weer op OPEN zet, dit ook in OpenWave zichtbaar wordt.
+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 en de status (dvstatus) wordt op GESLOTEN gezet. Deze kolom ddverwijderd kan ook weer worden leeggemaakt indien bij een volgende synchronisatie-actie de ruimte toch weer blijkt te bestaan. Ook de status zal in deze gevallen hersteld worden naar OPEN.
 ==== Knoppen op detailkaart van de SWF ruimte ====
-Op de detailkaart van een samenwerkingsruimte in OpenWave zijn linksonder vier knoppen:
+Op de detailkaart van een samenwerkingsruimte in OpenWave zijn linksonder vier knoppen en 2 knoppen in het scherm zelf:
-  * Aanmaken ruimte in SWF (zie hieronder).
+  * Aanmaken ruimte in SWF (zie hierboven).
   * Beëindigen ruimte in SWF. Hiermee wordt de landelijke op beëindigd gezet, waarna - bij succes - de kolom tbswfruimte.ddverwijderd wordt gevuld. Deze knop is alleen zichtbaar en enabled indien:
     * compartiment ok
@@ Regel 67: / Regel 93: @@
     * bovenliggende omgevingszaak niet geblokkeerd
     * aangemaakt door organisatie OIN is gelijk aan kolom //Tekst// van de instelling //Sectie: SWF en Item: OINvanZender// OF - indien de zaak speelt in een compartiment - gelijk aan tbcompartiment.dvswfoinzender. Dus alleen de organisatie die de landelijke ruimte heeft gecreëerd kan de status op GESLOTEN zetten.
-  * Synchroniseren van gegeven met landelijke ruimte. Deze knop is alleen zichtbaar en enabled indien:
+  * Ververs SWF ruimte. Deze knop is alleen zichtbaar en enabled indien:
     * compartiment ok
-    * bovenliggende omgevingszaak niet geblokkeerd.
+    * bovenliggende omgevingszaak niet geblokkeerd
+  * Laatste wijziging na synchronisatie gezien: uitvinken als gewijzigd. Zichtbaar en enabled indien:
+    * compartiment ok
+    * tbswfruimte.dvsamenwerkingid is gevuld
+    * tbswfruimte.dlgewijzigdbijsync is 'T'
+    * bovenliggende omgevingszaak niet geblokkeerd. Het klikken op deze knop geeft aan dat men alle wijzigingen na synchroniseren van de ruimte gezien heeft. Onder water wordt in de database tbswfruimte.dlgewijzigdbijsync op 'F' gezet waardoor deze niet meer voorkomt in de lijst van //Mijn gewijzigde SWF zaken//
+  * Verleng de einddatum. Zichtbaar en enabled indien:
+    * compartiment ok
+    * tbswfruimte.ddverwijderd is niet gevuld
+    * tbswfruimte.dvsamenwerkingid is gevuld
+    * aangemaakt door organisatie OIN is gelijk aan kolom //Tekst// van de instelling //Sectie: SWF en Item: OINvanZender// OF - indien de zaak speelt in een compartiment - gelijk aan tbcompartiment.dvswfoinzender. Dus alleen de organisatie die de landelijke ruimte heeft gecreëerd kan de einddatum verlengen
+  * Voeg extern contact toe aan zaak. Zichtbaar en enabled indien:
+    * de medewerker het recht heeft om contactpersonen te koppelen (tbomgrechten.dlcomgcadins).
-==== Aanmaken SWF ruimte ====
+==== Ververs SWF ruimte ====
-Voor het aanmaken van een SWF ruimte mag de omgevingskaart niet geblokkeerd zijn en het compartiment moet kloppen.
+Klikken op deze knop geeft synchroniseren van de gegevens met die zoals deze in het SWF staan voor de ruimte. 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.
-Een medewerker 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.
+==== Verleng de einddatum ====
-  * Eerst wordt de ruimte in OpenWave gemaakt (een kaart in de tabel tbswfruimte). Hierbij:
+Indien het nodig is om de SWF ruimte langer open te laten, kan de initiator van de ruimte de einddatum aanpassen naar de gewenste nieuwe einddatum.
-     * wordt de Bron (dvbronVerzoek) alleen gevuld met de waarde ‘DSO_LV’ indien de zaak in OpenWave een DSO-zaak betreft (dus projectid gevuld). In alle andere gevallen blijft deze kolom leeg.
+Hier gelden bij het SWF een aantal voorwaarden voor:
-     * wordt het verzoekNummer (dvverzoeknummer) gevuld met het DSO-verzoeknummer indien de zaak een DSO-zaak is: in alle andere gevallen blijft deze kolom leeg
+  * De samenwerking verloopt binnen 30 dagen
-  * 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 en einddatum gevuld.
+  * De nieuw opgegeven eindatum ligt na de huidige eind datum
+  * De nieuw opgegeven einddatum ligt voor de huidige einddatum + 365 dagen (het mag met maximaal een jaar verlengt worden)
-Indien de kolom //SWF id// gevuld is, dan is de kaart niet muteerbaar in OpenWave en een getrouwe afspiegeling van de landelijke samenwerkingsruimte.
+Indien voldaan wordt aan de voorwaarden zal bij uitvoeren van de wizard een bericht uitgaan naar het SWF om de datum te wijzigen. Wordt niet aan de voorwaarden voldaan dan zal de wizard een nette melding tonen aan de gebruiker. Het vullen van het einddatum veld is opgenomen bij de programmatuur voor verversen van SWF ruimte, verwerken van inkomende actieverzoeken en synchroniseren van openstaande SWF ruimtes. Bij verversen van de SWF ruimte zal de programmatuur gecontroleerd worden op ook overnemen van mogelijk nieuwe einddatum.
-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.
+==== Toevoegen extern contact aan zaak ====
+Klikken op deze knop start een wizard die kijkt of er een nieuw contactpersoon moet worden aangemaakt of dat er een bestaand contactpersoon (indien aanwezig) gekoppeld moet worden aan de zaak. Deze afweging wordt gemaakt aan de hand van de instelling //Sectie: DSO en Item: AltijdNieuwNNP//. Indien deze instelling aanstaat wordt er bij het uitvoeren van deze wizard altijd een nieuw contactpersoon aangemaakt. Indien deze instelling niet aanstaat komt er een controle of er reeds een contactpersoon bestaat in tbcontactadressen met de achternaam en het e-mailadres van het contactpersoon in de samenwerkingsruimte. Indien dit het geval is wordt dat contactadres gekoppeld aan de zaak en worden eventueel afwijkende waarden overschreven met de waarden uit de samenwerkingsruimte.
-Een SWF ruimte heeft een status/toestand: voorheen waren de opties voor de status OPEN of GESLOTEN. Daar is vanaf 1.32 (SWF v5 versie) bijgekomen de status INITIALISATIE.
+Indien er nog geen contactadres bestaat met deze waarden OF bovenstaande instelling staat aan dan zal er een nieuw contactadres aangemaakt worden waarbij de achternaam, het e-mailadres, het telefoonnummer en de bedrijfsnaam van het contactadres gevuld worden met de waarden uit de samenwerkingsruimte.
-De status INITIALISATIE wordt door het SWF zelf aan de SWF ruimte gegeven. En wordt toegepast in de volgende twee situaties:
-  * 1. direct na het starten van de samenwerking waarbij ook het verzoek wordt opgehaald (alleen indien verzoeknummer is gevuld bij de SWF ruimte), en
-  * 2. als (een aanvulling op) een verzoek wordt opgehaald
-De status INITIALISATIE geeft aan dat nog het een ander klaargezet wordt in het SWF en dat het beter is te wachten totdat de status weer op OPEN staat alvorens documenten op te halen.
-Een aantal acties zijn niet mogelijk als de SWF ruimte status INITIALISATIE heeft:
-  * De samenwerking sluiten
-  * Het ophalen van een aanvulling op een verzoek starten
-OpenWave geeft nette meldingen mocht zo'n actie toch worden uitgevoerd. Het verversen van de SWF ruimte (al dan niet handmatig) zorgt ervoor dat zodra het SWF de ruimte weer op OPEN zet, dit ook in OpenWave zichtbaar wordt.
-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 en de status (dvstatus) wordt op GESLOTEN gezet. Deze kolom ddverwijderd kan ook weer worden leeggemaakt indien bij een volgende synchronisatie-actie de ruimte toch weer blijkt te bestaan. Ook de status zal in deze gevallen hersteld worden naar OPEN.
+De wizard is uit te voeren indien:
+  * De hoofdzaak niet geblokkeerd is;
+  * De medewerker de juiste compartimentsrechten heeft;
+  * De medewerker het recht heeft om contactpersonen te koppelen (tbomgrechten.dlcomgcadins);
+  * Er bij het beheer een adresrol bestaat waarbij het vinkje //Is rol voor extern contactpersoon uit de SWF ruimte// (dlswfexterncontact) aanstaat. Let op: dit is slechts bij één adresrol aan te vinken.
+  * De naam en het e-mailadres van het externe contactpersoon in de SWF ruimte gevuld is.
+  * Het contactpersoon reeds bij de zaak is toegevoegd.
+==== Sluiten en verwijderen van de SWF ruimte ====
+Het sluiten van de SWF ruimte betekent het zetten van status = GESLOTEN. Maar zal niet resulteren in het daadwerkelijk verwijderen van de ruimte in het SWF.
 Het sluiten van de SWF ruimte is niet mogelijk als er bij het SWF nog openstaande actieverzoeken bestaan in de ruimte. Bij het uitvoeren van de wizard voor afsluiten van de SWF ruimte zal de wizard de door het SWF doorgegeven foutmelding tonen aan de medewerker mocht het afsluiten van de ruimte niet lukken.
-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.
+Het Beëindigen van de ruimte in het SWF kan pas als de status gesloten heeft en zorgt voor het daadwerkelijk verwijderen van de ruimte in het SWF.
 ===== Aanwijzen/Wijzigen van de samenwerkingspartners =====
@@ Regel 115: / Regel 157: @@
 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 ===
+==== Wijzigen privilege van samenwerkingspartner ====
 In het blok //Ketenpartners// is de knop //Wijzig ketenpartner privilege// zichtbaar indien:
   * de medewerker wijzigrechten op de samenwerkingsruimte (tbomgrechten.dlcomgswfedt) heeft
@@ Regel 221: / Regel 263: @@
 **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 medewerker.
-===== Toevoegen extern contactpersoon aan zaak =====
-In het detailscherm van de SWF ruimte is een knop waarmee handmatig het externe contactpersoon van de SWF ruimte toegevoegd kan worden aan de omgevingszaak.
-De knop is zichtbaar indien de medewerker het recht heeft om contactpersonen te koppelen (tbomgrechten.dlcomgcadins).
-De wizard is uit te voeren indien:
-  * De hoofdzaak niet geblokkeerd is;
-  * De medewerker de juiste compartimentsrechten heeft;
-  * De medewerker het recht heeft om contactpersonen te koppelen (tbomgrechten.dlcomgcadins);
-  * Er bij het beheer een adresrol bestaat waarbij het vinkje //Is rol voor extern contactpersoon uit de SWF ruimte// (dlswfexterncontact) aanstaat. Let op: dit is slechts bij één adresrol aan te vinken.
-  * De naam en het e-mailadres van het externe contactpersoon in de SWF ruimte gevuld is.
-  * Het contactpersoon reeds bij de zaak is toegevoegd.
-De wizard maakt een afweging of er een nieuw contactpersoon moet worden aangemaakt of dat er een bestaand contactpersoon (indien aanwezig) gekoppeld moet worden aan de zaak. Deze afweging wordt gemaakt aan de hand van de instelling //Sectie: DSO en Item: AltijdNieuwNNP//.
-Indien deze instelling aanstaat wordt er bij het uitvoeren van deze wizard altijd een nieuw contactpersoon aangemaakt. Indien deze instelling niet aanstaat komt er een controle of er reeds een contactpersoon bestaat in tbcontactadressen met de achternaam en het e-mailadres van het contactpersoon in de samenwerkingsruimte. Indien dit het geval is wordt dat contactadres gekoppeld aan de zaak en worden eventueel afwijkende waarden overschreven met de waarden uit de samenwerkingsruimte.
-Indien er nog geen contactadres bestaat met deze waarden OF bovenstaande instelling staat aan dan zal er een nieuw contactadres aangemaakt worden waarbij de achternaam, het e-mailadres, het telefoonnummer en de bedrijfsnaam van het contactadres gevuld worden met de waarden uit de samenwerkingsruimte.
 ===== Uitgaande Actieverzoeken =====