Toon documenten met StUF zaak/DMS

Indien gewerkt wordt met StUF-Zaken (zaak/DMS koppeling) dan worden een geefLijstZaakDocument _Lv01 en geefZaakDocumentLezen_lv01 vraagberichten uitgestuurd. De volgende instellingen zijn daarbij onontbeerlijk.

Voor het openen van een document dat in het DMS staat via OnlyOffice: zie het betreffende kopje bij Toon documenten en download.

De externe zaak/DMS code moet gevuld zijn (dvintzaakcode):

• voor de omgevingszaken, handhaving, inrichting, bouw/sloop en APV/overig en milieu/gebruik kijkt het programma hiertoe naar de zaak zelf
• bij inspecties, kijkt het programma ook naar de kolom externe zaak/dms code van de inspectiekaart zelf
• bij bezwaar/beroep, kijkt het programma ook naar de kolom externe zaak/dmscode (dvintzaakcode) van de bezwaar/beroep kaart zelf
• bij adviezen geldt dat het programma kijkt naar instelling Sectie: Programma en Item: AdviesIsZaak:
  • indien deze is aangevinkt dan kijkt het programma naar de externe zaak/DMS code van de advieskaart zelf
  • anders (instelling is niet aangevinkt of deze bestaat niet) bij adviezen: dan kijkt het programma naar de externe zaak/DMS code van de bijbehorende hoofdzaak (dus omgeving, handhaving, overig).

In alle gevallen bekijkt OpenWave eerst de gemeente waar de zaak speelt waarvoor de documenten opgevraagd worden. Voor credentials, stuurgegevens en endpoint kijkt het programma naar de kaart in tb33gemeente (beheerportaal-Nieuw) die voor de betreffende gemeente is. Wordt daar geen informatie gevonden, dan valt OpenWave terug op de algemene stufzaak/DMS instellingen.

Een uitzondering hierop is de situatie dat een zaak speelt bij een gemeente die gedefinieerd is in een compartiment terwijl de zaak zelf niet door dat compartiment wordt behandeld, maar door de host. In dat laatste geval valt OpenWave ook terug op de algemene stufzaak/DMS instellingen uit tbinitialisatie (beheertegel Configuratie). Sectie: KoppelingDocNaarDms:

• Item: Ontvangstadres_BeantwoordVraag. De kolom Tekst moet gevuld worden met juiste endpoint van de DMS-service
• Item: HTTPSoapAction_geefLijstZaakdocumenten_Lv01. De kolom Tekst moet gevuld worden met juiste soapaction:
  • indien zaak/DMS dan http://www.egem.nl/StUF/sector/zkn/0310/geefLijstZaakdocumenten_Lv01
  • indien (oude) stufzaken dan http://www.egem.nl/StUF/sector/zkn/0310/zakLv01
• Item: HTTPSoapAction_geefZaakdocumentLezen_Lv01. De kolom Tekst moet gevuld worden met juiste soapaction:
  • indien zaak/DMS dan http://www.egem.nl/StUF/sector/zkn/0310/geefZaakdocumentLezen_Lv01
  • indien (oude) stufzaken dan http://www.egem.nl/StUF/sector/zkn/0310/edcLv01
• Item: Ontvanger_applicatie. De kolom Tekst met de ontvanger
• Item: Ontvanger_organisatie. De kolom Tekst met de organisatie
• Item: Ontvanger_administratie. De kolom Tekst met de administratie
• Item: Ontvanger_gebruiker. De kolom Tekst met de gebruiker
• Item: Zender_applicatie. De kolom Tekst met de ontvanger
• Item: Zender_organisatie. De kolom Tekst met de organisatie
• Item: Zender_administratie. De kolom Tekst met de administratie
• Item: Zender_gebruiker. De kolom Tekst met de gebruiker.

LET OP: de soapactions kunnen ingesloten moeten zijn met dubbele quootjes, dus bijvoorbeeld:

"http://www.egem.nl/StUF/sector/zkn/0310/geefZaakdocumentLezen"

Als de instelling Sectie: KoppelingDOCNAARDMS en Item: HTTPAuthenticatieNaam bestaat en is aangevinkt dan wordt de verzending over HTTPS geautoriseerd met :

• authenticatienaam is kolom Tekst van de instelling Sectie: KoppelingDOCNAARDMS en Item: HTTPAuthenticatieNaam
• authenticatiepass is kolom Tekst van de instelling Sectie: KoppelingDOCNAARDMS en Item: HTTPAuthenticatiePass. Zie ook: 2-way encryptie van externe wachtwoorden
• in de kolom Tekst van de instelling Sectie: KoppelingDOCNAARDMS en Item: HTTPAuthenticatieType kan desgewenst het authenticatietype worden ingevuld: NTLM (versie 1) of Basic (default waarde)
• In de kolom Tekst van de instelling Sectie: KoppelingDOCNAARDMS en Item: Domein kan desgewenst het domein worden ingevuld.

Indien er gebruik moet worden gemaakt van een client-certificaat (wordt geplaatst op de CONF-map van de WSAS server) dan:

• moet de (file)-naam van dat certificaat worden opgeslagen in de kolom Tekst van Sectie: KoppelingDOCNAARDMS en Item: ClientCertificaatNaam
• het certificaat password in de kolom Tekst van Sectie: KoppelingDOCNAARDMS en Item: ClientCertificaatPassword. Zie ook: 2-way encryptie van externe wachtwoorden
• het certificaattype in de kolom Tekst van Sectie: KoppelingDOCNAARDMS en Item: ClientCertificaatType (default PKCS12).

Indien de instelling Sectie: KoppelingDOCNAARDMS en Item: AllowAllHostnameVerifier aangevinkt is zal de OpenWave Cloud instemmen met een self-signed of verlopen (server)certificaat bij een verbinding onder https.

In het geefLijstZaakDocument_lv01 bericht wordt de normale scope van het bericht uitgevraagd met uitzondering van de tag dct.omschrijving. Dit in verband met verschil tussen de officiele validator en de officiële versie 1.2 beschrijving. De meeste DMS -systemen geven in het antwoordbericht toch de waarde terug, maar niet altijd.

Met het aanvinken van de instelling Sectie: KoppelingDOCNAARDMS en Item: ZakLV01MetDCTOmschrijving, zal <ns:dct.omschrijving xsi:nil=“true/> wel in de scope van het vraagbericht worden opgenomen.

Indien de instelling Sectie: Documenten en Item: Beschrijving aangevinkt is, zal <ns:beschrijving xsi:nil=“true”/> in de scope van het vraagbericht worden opgenomen.

In het geefZaakDocumentLezen_lv01 bericht kan de scope op twee manieren worden gedefinieerd. Standaard gebeurt dat als volgt

<ns:scope>
<ns:object StUF:entiteittype="EDC" StUF:scope="kerngegevens"/>
</ns:scope>

Indien echter de instelling Sectie: KoppelingDOCNAARDMS en Item: StUFGeefDocumentMetScope aangevinkt is dan:

<ns:scope>
<ns:object StUF:entiteittype="EDC" >
<ns:isRelevantVoor StUF:entiteittype="EDCZAK">
<ns:gerelateerde StUF:entiteittype="ZAK">
<ns:identificatie xsi:nil="true"/>
</ns:gerelateerde>
</ns:isRelevantVoor>
</ns:object>
</ns:scope>

In het retourbericht (zakLa01) worden de documenten opgesomd in de gevraagde kolommen <identificatie>, <creatiedatum>, <titel>, <vertrouwelijkheidAanduiding>, <auteur> en <link>.

Optioneel kan de kolom <beschrijving> worden opgevraagd met de instelling Sectie: Documenten en Item: Beschrijving. Wanneer deze instelling aan staat zal er in de documentenlijst een extra kolom Omschrijving zichtbaar zijn.

Mogelijk wordt ook de kolom <dct.omschrijving> geleverd (niet altijd). Default wordt de kolom <dct.omschrijving> in OpenWave getoond in de kolom map.

Default wordt de kolom <titel> in OpenWave getoond in de kolom titel.

Hier kan van afgeweken worden met de instellingen:

• Sectie: KoppelingDOCNAAMDMS en Item: WaveKolomTitelIsStUFTag. In de kolom Tekst kan hier dus bijvoorbeeld komen <dct.omschrijving>
• Sectie: KoppelingDOCNAAMDMS en Item: WaveKolomMapIsStUFTag. In de kolom Tekst kan hier dus bijvoorbeeld komen <titel>.

Het programma gaat de lijst filteren op grond van tag vertrouwelijkAanduiding indien de kolom dvvertrouwelijkheid (mag documenten inzien tot en met vertrouwlijkheidsniveau) van tbrechten (beheertegel Functionele rechten), waar de inlogger toe behoort, een gevulde waarde heeft. Is dat het geval dan worden alleen die documenten getoond waarvoor geldt dat de waarde van de tag <vertrouwelijkAanduiding> LEEG is of een waarde heeft waarvan het vereiste niveau (beheertegel Vertrouwelijkheid) kleiner of gelijk is aan het niveau ingesteld bij de medewerker.

De berichten kunnen gelogd worden op 2 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.
• Indien de instelling Sectie: OWB en Item: Loggen aangevinkt is dan worden de berichten onder een door OpenWave te bepalen naam (bijvoorbeeld 1.1345123012_VanOW_naarZaak) op een logmap van de server geplaatst (om die te zien zijn dus systeembeheerrechten noodzakelijk).