Verschillen
Dit geeft de verschillen weer tussen de geselecteerde revisie en de huidige revisie van de pagina.
Vorige revisie | |||
— | openwave:1.31:applicatiebeheer:probleemoplossing:programmablokken:toon_documenten_en_download [2025/01/23 11:37] (huidige) – [Hernoemen (wijzigen metadata) van document] Charlie Kluin | ||
---|---|---|---|
Regel 1: | Regel 1: | ||
+ | ====== Toon documenten en bewerk/ | ||
+ | |||
+ | Met de knop //Docs// op de detail- en portalschermen van omgeving, inrichting, APV/overig, bouw/sloop, horeca, infoaanvragen en handhaving alsmede vanuit de advies, bezwaarberoep en inspectie detailschermen kan een lijst getoond worden van documenten bij een zaak. Indien de instelling //Sectie: Documenten Item: Documentregistratie// | ||
+ | Staat deze instelling uit dan worden alle documenten bij de zaak getoond worden die op dat moment worden aangetroffen in het DMS of op de fileserver. | ||
+ | |||
+ | ===== Rechten ===== | ||
+ | |||
+ | De gebruiker moet kijkrechten hebben bij de betreffende module (omgeving, inrichting, horeca, milieu/ | ||
+ | |||
+ | Indien echter de documenten worden opgehaald vanuit een inspectiezaak geldt dat het programma kijkt naar de inspectiekijkrechten van de betreffende module. Zo ook voor adviezen: het programma kijkt naar de advieskijkrechten van de betreffende module. Zo ook voor bezwaarberoep: | ||
+ | |||
+ | Daarnaast geldt dat indien de instelling //Sectie: Documenten Item: Documentregistratie// | ||
+ | |||
+ | Indien deze instelling NIET is aangevinkt dan moet de gebruiker het recht //Inzien documenten buiten registratie om// hebben voor de betreffende module (bijv. tbomgrechten.dlcomgcorvsb). | ||
+ | |||
+ | |||
+ | ===== Compartimentsrecht (zie hieronder bij triggers) ===== | ||
+ | |||
+ | Het compartimentsrecht is OK indien: | ||
+ | * de inlogger lid is van een compartiment dan moet het betreffende compartiment het zaaktype van de bovenliggende zaak bevatten en de gemeente waar die zaak speelt. Indien de documenten aan een inspectietraject of een bezwaar/ | ||
+ | * de inlogger GEEN lid is van een compartiment en de documenten die getoond worden horen bij een adviesdeelzaak of bij een hoofdzaak, dan mag de combinatie van het zaaktype van de bovenliggende zaak en de gemeente waar die zaak speelt in geen enkel compartiment voor komen | ||
+ | * de inlogger GEEN lid is van een compartiment en de documenten die getoond worden horen bij een inspectietraject c.q. bezwaar/ | ||
+ | |||
+ | ===== OLO-bijlagen verplaatsen van fileshare ===== | ||
+ | |||
+ | Het kan zijn dat OpenWave eerst moet zorgen dat - indien de documenten worden opgevraagd bij een omgevingszaak- OLO-bijlagen eerst op de juiste plek moeten worden gestald. Dit geldt alleen voor de situatie dat OpenWave via een digi-koppelaar rechtstreeks berichten ontvangt van het OLO waarbij de OLO-bijlagen door die digi-koppelaar op een vooraf afgesproken verplaatsmap op een fileshare worden geplaatst (de andere mogelijkheid is namelijk dat de digi-koppelaar de bijlagen aan de OpenWave uploadservice aanbiedt: zie [[openwave: | ||
+ | |||
+ | OpenWave gaat onderzoeken of er OLO-bijlagen zijn indien de kolom //Tekst// van de instelling //Sectie: KoppelingDOCNAARDMS en Item: InboxmapOLO// | ||
+ | |||
+ | De waarde van //Item: InboxmapOLO// | ||
+ | |||
+ | Bij afspraak worden door de DIGI-koppelaar achter deze map submappen gemaakt op OLO-nummer. Op die mappen en op submappen achter die OLO-nummermappen worden vervolgens door de DIGI-koppelaar de bijlagen geplaatst bijv.: | ||
+ | < | ||
+ | // | ||
+ | // | ||
+ | // | ||
+ | </ | ||
+ | Zowel op de map 1234 als op de submappen submap_A en Submap_B kunnen één of meer bijlagen staan. | ||
+ | |||
+ | Bij het opvragen van de documentenlijst bij een OpenWave zaak (omgeving) waarbij het OLO-nummer is gevuld (EN - indien het DMS met StUF/Zaak wordt benaderd - de DMS-zaakcode (dvintzaakcode) gevuld is), zal het programma de OLO-bijlagen die aangetroffen worden op en achter de bijbehorende verplaatsmap verplaatsen naar het DMS of naar een andere map op de fileshare. Dit gebeurt doordat het programma intern haar eigen uploadfile-API aanroept. | ||
+ | Bij plaatsing van de OLO-bijlage via STUF Zaken kijkt het programma: | ||
+ | * wat betreft het documenttype naar kolom //Tekst// van instelling //Sectie: KoppelingDOCNAARDMS en Item: OloDocType// | ||
+ | * wat betreft metadata vertrouwelijkheid naar kolom //Tekst// van instelling //Sectie: KoppelingDOCNAARDMS en Item: OloVertrouwelijkheid// | ||
+ | * wat betreft auteur: deze krijgt de waarde onbekend. | ||
+ | Het programma maakt daarna de verplaatsmap (inbox + OLO-nummer) leeg. | ||
+ | |||
+ | Daarna pas wordt de reguliere Toon-Documentenlijst getoond waarin dan ook de OLO-bijlagen zichtbaar zouden moeten zijn. Op het moment dat deze lijst wordt getoond kan het echter zo zijn dat nog niet alle bijlagen reeds zijn aangekomen op plaats van bestemming (bijv. bij stuf zaak/DMS gaat het om asynchrone verwerking). De gebruiker zou dan een tweede keer om de lijst moeten vragen. | ||
+ | Wanneer het verplaatsen is mislukt dan zijn de niet verplaatste bijlages zichtbaar via de beheertegel //Mislukte OLO-bijlages// | ||
+ | |||
+ | Het verplaatsen van de documenten op de fileshare naar de machine waar de WSAS op draait (al vanwaar de documenten naar de plaats van bestemming worden geredigeerd) kan nog eens extra gemonitord worden via de messagelog door de instelling //Sectie: InboxmapOLO en Item: Messagelog// | ||
+ | |||
+ | |||
+ | ==== Waarvandaan ==== | ||
+ | |||
+ | Zie ook: [[openwave: | ||
+ | |||
+ | De documenten bij een zaak worden gehaald uit het DMS en/of de fileshare. | ||
+ | * Indien de zaak valt onder een compartiment dan kijkt OpenWave naar de betrokken compartimentskaart (beheertegel // | ||
+ | * Indien geen compartiment dan: | ||
+ | * uit het DMS indien de instelling //Sectie: Documenten// | ||
+ | * vanaf de fileshare indien de instelling //Sectie: Documenten// | ||
+ | * Indien het gaat om het DMS dan moet de instelling met //Sectie: KoppelingDOCNAARDMS// | ||
+ | * ' | ||
+ | * OF 'CMIS 1.0'\\ De instelling StUF-ZAKEN 310 kan door het programma worden overruled naar CMIS 1.0 (in de hybride situatie dat er zowel documenten via CMIS als stuf zaak/DMS zijn op te halen) mits: | ||
+ | * de kolom //Tekst// van de instelling //Sectie: koppelingDOCNAARDMS en Item: Ontvangstadres_cmis// | ||
+ | * EN de kolom dvintzaakcode (externe zaakcode) van de zaak leeg is. | ||
+ | |||
+ | Indien fileshare dan kan het zijn dat de gebruiker eerst een **keuze moet maken uit één of meer mappen**. De documenten die getoond worden in de lijst zijn die van de aangevinkte mappen + alle documenten van eventuele submappen. Bepaalde submappen kunnen echter worden uitgesloten met de instelling //Sectie: Documenten Item: geensubmapmetsubstring1// | ||
+ | |||
+ | Het scherm met aan te vinken mappen wordt getoond indien: | ||
+ | * de instelling //Sectie: Documenten, Item: OphalenNaMapkeuze// | ||
+ | * EN - indien geen compartiment - dan moet //Sectie: Documenten Item: OphalenViaFileserver// | ||
+ | * EN - indien geen compartiment - dan moet //Sectie: Documenten Item: OphalenViaDms// | ||
+ | * EN - indien WEL compartiment - dan moet de kolom //ophalen fileserver// | ||
+ | * EN - indien WEL compartiment - dan moet de kolom //ophalen dms// van het betreffende compartiment NIET aangevinkt zijn | ||
+ | * EN //Sectie: Documenten Item: MultipleDownload// | ||
+ | * Indien //Getal1// van //Sectie: Documenten, Item: OphalenNaMapkeuze// | ||
+ | * Indien er geen of maar één map is met documenten, dan wordt het mapkeuzescherm niet getoond. | ||
+ | * Indien er geen mapkeuze wordt gemaakt, dan worden alle documenten van alle mappen opgehaald. | ||
+ | Met //Getal2// van //Sectie: Documenten, Item: OphalenNaMapkeuze// | ||
+ | <adm example> | ||
+ | Voorbeeld: | ||
+ | * //Getal2// = 2 en de mapnaam | ||
+ | * //Getal2// = 1 en de mapnaam | ||
+ | Heeft //Getal2// geen waarde of 0 of het aantal is groter dan het aantal onderdelen in de mapnaam dan geldt dat de mapnaam ongewijzigd blijft. | ||
+ | </ | ||
+ | |||
+ | Indien fileshare zie verder bij [[openwave: | ||
+ | Indien StUF-ZAKEN 310 zie verder bij [[openwave: | ||
+ | |||
+ | Indien CMIS 1.0 zie verder bij [[openwave: | ||
+ | |||
+ | ===== Openen van document ===== | ||
+ | Door te klikken op een actieve regel zal OpenWave volgens onderstaand schema te werk gaan:\\ | ||
+ | |||
+ | {{openwave: | ||
+ | |||
+ | **Ad 1. Check op registratie en vertrouwelijkheid**\\ | ||
+ | |||
+ | Indien de kolom van het registratievakje van het document is gevuld met een potloodicoontje (dat wil zeggen dat het document is geregistreerd) EN | ||
+ | de instelling //Getal2// van //Sectie: Documenten en Item: Documentregistratie// | ||
+ | |||
+ | Indien het document in OpenWave is geregistreerd (tbcorrespondentie), | ||
+ | |||
+ | **Ad 2. Kan document geopend worden via aanroep explorer (alleen indien browser = Firefox)**\\ | ||
+ | Indien vertrouwelijkheid OK dan: | ||
+ | * indien het aangewezen document van de filserver komt | ||
+ | * EN het IP-adres van de huidige sessie (tbsessions) van de gebruiker voldoet aan het masker gedefinieerd in de kolom IpRange van een van de regels van de tabel tbipranges, waarbij de kolom dlhyperlink aangevinkt is | ||
+ | * EN kolom //Getal2// van //Sectie: Documenten Item: OphalenViaFileserver// | ||
+ | DAN wordt het document via een hyperlink geopend: dat wil zeggen via < | ||
+ | |||
+ | **Ad 3. Kan document geopend worden met lokale MS Word of MS-Excel via Office URI-scheme**\\ | ||
+ | Indien vertrouwelijkheid OK dan: | ||
+ | * indien het aangewezen document van de fileserver komt | ||
+ | * EN het IP-adres van de huidige sessie (tbsessions) van de gebruiker voldoet aan het masker gedefinieerd in de kolom IpRange van een van de regels van de tabel tbipranges, waarbij de kolom dlhyperlink aangevinkt is | ||
+ | * EN kolom //Getal2// van //Sectie: Documenten Item: OphalenViaFileserver// | ||
+ | * EN de bovenliggende zaak is niet geblokkeerd | ||
+ | DAN wordt het document via Office URI-scheme geopend: bijvoorbeeld '' | ||
+ | |||
+ | In dit verband geldt nog wel het volgende: | ||
+ | * indien de inlogger een medewerker is van de host organisatie dan moet het document zich bevinden op de fileserver va de host | ||
+ | * indien de inlogger een medewerker is van het compartiment dan moet het document zich bevinden op de fileserver van het compartiment (te benaderen met satellite). | ||
+ | Zo niet, - dus een medewerker van de host vraagt een document van een compartiment, | ||
+ | |||
+ | |||
+ | **Ad 4. Kan document geopend worden met OnlyOffice**\\ | ||
+ | |||
+ | Indien vertrouwelijkheid OK en de instellingen zijn dusdanig dat het programma geen poging doet het bestand via een hyperlink met firefox of Office URI-scheme te openen dan: | ||
+ | * indien de instelling //Sectie: Documenten Item: OnlyOffice// | ||
+ | * EN de extensie van dat document komt voor in de kolom //Tekst// van deze instelling (extensies gescheiden door puntkomma, dus bijv. docx; | ||
+ | * EN de instelling //Sectie: OWB Item: TussenMapOnlyOfficeDownloadFiles// | ||
+ | * EN de instelling //Sectie: OWB Item: TussenMapOnlyOfficeUploadFiles// | ||
+ | dan zal het document als serverdocument worden geopend met OnlyOffice (mits geïnstalleerd). | ||
+ | |||
+ | Indien de bovenliggende zaak is geblokkeerd, | ||
+ | |||
+ | **Ad 5 Het aangewezen document wordt gedownload maar direct geopend met browser** | ||
+ | |||
+ | Indien vertrouwelijkheid OK en de instellingen zijn dusdanig dat het programma geen poging doet het bestand via een hyperlink met IE of Office URI-scheme of via OnlyOffice te openen dan - mits de extensie van het document voorkomt in de kolom //Tekst// van de instelling //Sectie: OWB en Item: DocumentBrowser// | ||
+ | De opgesomde extensies van de instelling moeten gescheiden zijn door een puntkomma dus bijv. //' | ||
+ | |||
+ | **Ad 6. Het document wordt gedownload naar device van gebruiker** | ||
+ | |||
+ | Indien vertrouwelijkheid OK, dan zal in alle andere gevallen (geen OnlyOffice, geen IE, Office URI-scheme) het programma reageren op het dubbelklikken op een regel alsof er één document is aangevinkt en de downloadknop wordt gebruikt. | ||
+ | |||
+ | Dat wil zeggen dat het document wordt gedownload naar de device van de gebruiker. De instellingen van MS-Windows explorer op grond van de extensie van het document bepalen vervolgens of en met welk pakket het document automatisch geopend wordt. | ||
+ | |||
+ | ===== Hernoemen (wijzigen metadata) van document ===== | ||
+ | |||
+ | Deze functie is toegankelijk via wizardknop linksonder. Hernoemen kan voor documenten die zich in een DMS (dat benaderd wordt via stuf zaak/DMS) bevinden of op een fileshare staan. Hernoemen of synchroniseren van een document dat geregistreerd is (dus in tbcorrespondentie opgenomen) kan alleen via de lijst // | ||
+ | |||
+ | Indien het document op een fileshare staat kan alleen de documentnaam worden gewijzigd. Indien het document in een DMS staat (dat benaderd wordt via stuf zaak/DMS) kunnen titel, vertrouwelijkheid, | ||
+ | * Indien de instelling //Sectie: koppelingDOCNAARDMS // en //Item: RichtingalsExtraElement// | ||
+ | * Vanaf versie 1.31.2, indien de instelling //Sectie: koppelingDOCNAARDMS // en //Item: WijzigdocGeenCreatiedd// | ||
+ | * Indien de instelling //Sectie: Documenten// | ||
+ | |||
+ | ===== Triggers===== | ||
+ | |||
+ | De wizardknop linksonder is zichtbaar en enabled indien: | ||
+ | * de zaak waar de geregistreerde documenten aan verbonden zijn NIET is geblokkeerd | ||
+ | * EN compartimentsrechten OK | ||
+ | * EN de gebruiker het recht //Wijzigen metadata (hernoemen) van ongeregistreerde documenten// | ||
+ | Voor het hernoemen van een document op de fileshare geldt: | ||
+ | * EN – indien de bovenliggende zaak NIET speelt in een compartiment - dan moet //Sectie: Documenten, Item: Ophalenviafileserver// | ||
+ | * EN - indien de bovenliggende zaak WEL speelt in een compartiment | ||
+ | Voor het hernoemen van een document in het DMS geldt: | ||
+ | |||
+ | Indien: | ||
+ | * de bovenliggende zaak NIET speelt in een compartiment dan: | ||
+ | * moet de instelling //Sectie: KoppelingDocnaarDMS, | ||
+ | * EN de instelling //Sectie: KoppelingDocNaarDms en Item: methode// is aangevinkt en kolom //Tekst// heeft waarde StUF-ZAKEN 310 | ||
+ | * wanneer de bovenliggende zaak WEL speelt in een compartiment dan | ||
+ | * moet de kolom // | ||
+ | * EN de kolom // | ||
+ | * EN de kolom //dldms// van het betreffende tbcompartiment moet aangevinkt zijn. | ||
+ | |||
+ | |||
+ | ==== Knoppen linksonder ==== | ||
+ | **Downloadknop** | ||
+ | |||
+ | Indien de instelling //Sectie: Documenten// | ||
+ | |||
+ | Indien er meer dan één document is aangevinkt dan worden deze met het indrukken van de download-knop gezipt in DownloadOpenWave' | ||
+ | |||
+ | Indien er maar één document gedownload wordt dan gebeurt dit onder zijn eigen documentfilenaam. Wel dezelfde restrictie op MaxUploadMbGrootte. Het lijkt er op dat met Internet Explorer er een maximum bestaat van 19 files in de zipfile. | ||
+ | |||
+ | Er kan een afwijkende zipfilenaam worden geconstrueerd indien de kolom //Tekst// van de instelling //Sectie: Documenten en Item: Downloadzipfilenaam// | ||
+ | |||
+ | In dat geval is de naam van de zipfile de waarde van deze kolom Tekst waarbij | ||
+ | * %date% vervangen wordt door TimeStamp | ||
+ | * %login% wordt vervangen door de medewerkerscode van de inlogger | ||
+ | * %hoofdzaaknr% wordt vervangen door de wavezaakcode | ||
+ | * %hoofddmsnr% wordt vervangen door de externe zaak/DMS code | ||
+ | * %adres% wordt vervangen door het adres + de woonplaats | ||
+ | |||
+ | |||
+ | Verder moet de downloadmap op de webserver bekend zijn: het tussenstation tussen DMS/ | ||
+ | Kolom //Tekst// van de //Sectie: OWB en Item: TussenMapDownloadFiles// | ||
+ | Deze downloadMapnaam moet eindigen op '/ | ||
+ | |||
+ | Tenslotte zal de programmatuur zelf deze downloadmap op de webserver regelmatig opschonen. Files ouder dan het aantal uur dat is ingesteld in kolom //Getal1// van de instelling //Sectie: OWB Item: MaxUurDownload// | ||
+ | |||
+ | **Refreshknop** | ||
+ | |||
+ | Indien: | ||
+ | * De documenten worden opgevraagd vanuit een omgevingszaak | ||
+ | * EN instelling //Sectie: KoppelingDOCNAARDMS Item: InboxmapOLO// | ||
+ | OF | ||
+ | * de instelling //Sectie: Documenten Item: StartAutomUploadSchermNaUpload// | ||
+ | dan is een refreshknop zichtbaar en enabled, waarmee nogmaals de documentenlijst kan worden opgehaald. De tijdspanne die nodig is om de OLO-bijlagen bijvoorbeeld in het DMS te stallen OF uploads op hun juiste plek te brengen heeft OpenWave namelijk niet altijd in de hand. | ||
+ | |||
+ | **Registreerknop** | ||
+ | |||
+ | Zichtbaar en enabled indien: | ||
+ | * de gebruiker het //' | ||
+ | * EN het compartimentsrecht is OK. | ||
+ | * EN de bovenliggende zaak NIET is geblokkeerd | ||
+ | Met deze knop worden de geselecteerde documenten geregistreerd, | ||
+ | Bij het registreren (= een kaart aanmaken in tbcorrespondentie) wordt de inlogger als registreerder geboekt. Zie verder [[openwave: | ||
+ | |||
+ | De gebruiker dient ook nog correspondentie wijzigrechten te hebben (bijv. tbomgrechten.dlcomgcoredt). LET OP: indien een lijst wordt getoond vanuit een inspectietraject kijkt het programma naar de correspondentie-wijzigrechten van de module. Het kan echter zijn dan een inspectietraject zowel gekoppeld is aan bijvoorbeeld een inrichting als aan een handhavingszaak (als vanuit het traject een handhaving is gemaakt met de daartoe bestemde functie). In dat laatste geval prevaleert het correspondentie-wijzigrecht van de handhavingszaak (tbhhrechten.dlchahcoredt), | ||
+ | |||
+ | **Uploadknop** | ||
+ | Zichtbaar indien: | ||
+ | * bovenliggende zaak niet is geblokkeerd | ||
+ | * de instelling //Sectie: Documenten, Item: OphalenViaDms// | ||
+ | * indien OphalenViaDms aangevinkt dan moet de kolom //Tekst// bij instelling //Sectie: KoppelingDocnaardms Item: Methode// de waarde StUF-ZAKEN 310 OF CMIS 1.0 hebben en aangevinkt staan (of in geval van compartiment dan met de kolom // | ||
+ | * EN - alleen in geval van StUF-ZAKEN 310 – dan moet de externe zaak/DMS code (dvintzaakcode) in de bovenliggende zaak gevuld zijn. | ||
+ | * Compartimentsrechten OK | ||
+ | Enabled indien de inlogger het // | ||
+ | |||
+ | **VerplaatsNaarDMS-knop** | ||
+ | |||
+ | Zichtbaar en enabled indien: | ||
+ | * compartimentsrecht OK | ||
+ | * EN in de hybride situatie dat zowel van de fileserver gebruikt wordt gemaakt als van een DMS onder StUF zaak/DMS. | ||
+ | Dat betekent dat zowel de instelling //Sectie: Documenten Item: OphalenViaFileserver// | ||
+ | |||
+ | De inlogger kan het actieve document (die met de gele balk) met deze knop - na invulling van verplichte metadata - in het DMS plaatsen (uploaden). Het programma controleert daarbij of het document wel op de fileserver staat en of de bovenliggende zaak een zaakidentificatienummer heeft). | ||
+ | |||
+ | Het betrokken fileserver-document daarbij wordt ook verplaatst naar een kopiemap: zie instelling kolom //Tekst// van //Sectie: KoppelingDOCNAARDMS en Item: MapKopieVerplaatsteFiles// | ||
+ | |||
+ | Wat betreft de verplichte metadata: indien in de documentnaam de substring ' | ||
+ | |||
+ | Indien de documentnaam inderdaad de substring ' | ||
+ | |||
+ | **Wizardknop Hernoemen van document** | ||
+ | |||
+ | Zie hierboven onder kopje //Hernoemen van Document//. | ||
+ | |||