openwave:1.30:applicatiebeheer:probleemoplossing:programmablokken:upload_document

Upload document

Met de knop Upload op de detailschermen van omgeving, inrichting, APV/overig en handhaving, alsmede vanuit de advies en inspectie detailschermen kunnen met een wizard een of meer documenten aangewezen worden en vervolgens geüpload naar fileshare of DMS.

De uploadfunctie kan ook door een apparaat of automatisch proces worden aangeroepen (bijlagen van DSO). Zie Verwerken DSO-bijlagen

De uploadfunctie kan ook worden aangeroepen vanuit de Toon documenten en download met de VerplaatsNaarDMS-knop. Zichtbaar en enabled in de hybride situatie dat zowel van de fileserver gebruikt wordt gemaakt als van een DMS onder StUF zaak/DMS. De inlogger kan een document dat op de fileserver staat en waar de gele balk op staat, met deze knop - na invulling van verplichte metadata - in het DMS plaatsen (mits de bovenliggende zaak een zaakidentificatienummer heeft). Het betrokken fileserver-document daarbij wordt verplaatst naar een kopiemap: zie instelling kolom Tekst van Sectie: KoppelingDOCNAARDMS en Item: MapKopieVerplaatsteFiles.

De bestandnamen van de up te loaden files mogen niet groter dan 500 tekens zijn.

  • De gebruiker moet lid zijn van een rechtengroep die het recht: uploaden en creëren van documenten heeft voor de betreffende module (omgeving, APV/overig, inrichting, bouw/sloop, handhaving en milieu/gebruik), EN
  • de zaak of inrichting mag niet geblokkeerd zijn:
    • voor uploads vanuit een advieskaart en vanuit een bezwaar/beroepskaart geldt hierbij dat gekeken wordt naar de blokkering van de onderliggende zaak
    • voor uploads vanuit een inspectiekaart geldt dat de zaak geblokkeerd is indien één van onderstaande items waar is:
      • de afgerond datum van de inspectietrajectkaart is gevuld
      • de instelling Sectie: InspectieMilieu en Item: NietBlokkerenMetHoofdzaak is NIET aangevinkt (of bestaat niet) EN de blokkering van de onderliggende zaak is WEL gevuld.
  • Indien de zaak/inrichting, waarbij de upload plaatsvindt, NIET valt onder een compartiment dan:
    • indien de instelling Sectie: Documenten en Item: OphalenViaFileserver aangevinkt is EN ook de instelling Sectie: Documenten en Item: OphalenViaDMS aangevinkt is dan zal de uploadwizard aan de gebruiker vragen waar de upload geplaatst moet worden (fileshare OF DMS). Indien er maar één van deze instellingen is aangevinkt wordt deze vraag niet gesteld
    • indien OphalenViaDMS aangevinkt is, dan moet ook de instelling aangevinkt staan met Sectie: KoppelingDOCNAARDMS en Item: Methode en Tekst = StUF-ZAKEN 310 of CMIS 1.0.
  • Indien de zaak/inrichting WEL valt onder een compartiment dan:
    • indien de kolom documenten opslag fileserver op de betreffende compartimentskaart (beheerportaal-Nieuw) aangevinkt is EN ook de kolom documenten opslag DMS aangevinkt is dan zal de uploadwizard aan de gebruiker vragen waar de upload geplaatst moet worden (fileshare OF DMS). Indien er maar één van deze instellingen is aangevinkt wordt deze vraag niet gesteld
    • indien de kolom documenten opslag DMS aangevinkt is, dan moet ook de de kolom dms methode op die compartimentskaart gevuld zijn met StUF-ZAKEN 310 of CMIS 1.0.

Zie schema Schema Upload naar welke mappen/endpoints.

Onderstaande gegevens zijn vooralsnog alleen zinvol bij opslag in een DMS met StUF-ZAKEN 310 (zaak/DMS koppeling).

  • Indien de zaak/inrichting, waarbij de upload plaatsvindt, NIET valt onder een compartiment dan:
    • het verplichten per uploaddocument van een documenttype is afhankelijk van het aangevinkt zijn van de instelling Sectie: KoppelingDOCNAARDMS en Item: DocumenttypeVerplicht
    • het verplichten per uploaddocument van een Titel is afhankelijk van het aangevinkt zijn van de instelling Sectie: KoppelingDOCNAARDMS en Item: TitelVerplicht
    • het verplichten per uploaddocument van een Status is afhankelijk van het aangevinkt zijn van de instelling Sectie: KoppelingDOCNAARDMS en Item: StatusVerplicht
    • het verplichten per uploaddocument van een Vertrouwelijkheidsduiding is afhankelijk van het aangevinkt zijn van de instelling Sectie: KoppelingDOCNAARDMS en Item: VertrouwelijkheidVerplicht
    • het verplichten per uploaddocument van een Auteur is afhankelijk van het aangevinkt zijn van de instelling Sectie: KoppelingDOCNAARDMS en Item: AuteurVerplicht.
  • Indien de zaak/inrichting, waarbij de upload plaatsvindt, WEL valt onder een compartiment dan:
    • het verplichten per uploaddocument van een Documenttype is afhankelijk van het aangevinkt zijn van de kolom Documenttype verplicht bij upload op de betreffende compartimentskaart (beheerportaal-Nieuw)
    • het verplichten per uploaddocument van een Titel is afhankelijk van het aangevinkt zijn van de kolom Titel verplicht bij upload op de betreffende compartimentskaart (beheerportaal-Nieuw)
    • het verplichten per uploaddocument van een Status is afhankelijk van het aangevinkt zijn van de kolom Status verplicht bij upload op de betreffende compartimentskaart (beheerportaal-Nieuw)
    • het verplichten per uploaddocument van een Vertrouwelijkheidsduiding is afhankelijk van het aangevinkt zijn van de kolom Vertrouwelijkheid verplicht bij upload op de betreffende compartimentskaart (beheerportaal-Nieuw)
    • het verplichten per uploaddocument van een Auteur is afhankelijk van het aangevinkt zijn van de kolom Auteur verplicht bij upload op de betreffende compartimentskaart (beheerportaal-Nieuw).
  • Er kan eventueel een richting worden meegegeven in het stuf bericht naar DMS (wordt niet naar compartiment gekeken). Indien zo ingesteld, zal een blok extraElementen worden toegevoegd met attribuutnaam Richting en als waarde uitgaand of inkomend of intern:
    • hiervoor moet bij de handmatige upload, in de wizard een Richting worden gekozen. Zichtbaar indien Sectie: Documentregistreren en DvDocrichting staat aan
    • de instelling Sectie: KoppelingDOCNAARDMS en Item: RichtingalsExtraElement moet bestaan en aangevinkt zijn
    • de instelling Sectie: DocumentRegistreren en Item: AlleHandmatigeUploads moet bestaan en aangevinkt zijn
    • Getal1 van instelling Sectie: Documenten en Item: Documentregistratie heeft de waarde 1

Voor de documenttypes laat het programma de gebruiker per document kiezen uit de gekoppelde documenttypes per OpenWave zaaktype: zie beheerportaal Zaakbeheer

  • zaaktypes omgeving
  • zaaktypes handhaving,
  • zaaktypes APV/overig,
  • soorten inspectietrajecten,
  • soorten bezwaar/beroep,

en de brontabel documenttypen.

Zijn er geen koppelingen bij het betreffende zaaktype gedefinieerd of het gaat om een upload bij een inrichting dan kiest de gebruiker rechtstreeks uit de brontabel documenttypen (Beheer). Indien de inlogger tot een compartiment behoort, zal er bij documenttypen alleen gekozen kunnen worden uit de documenttypen waarvoor in beheer is aangegeven dat deze op compartiment van de inlogger van toepassing zijn.

Status en titel moeten met de hand per document worden ingevuld. Vertrouwelijkheid komt uit een vast dropdownlijstje (beheertegel Vertrouwelijkheid). De auteur wordt bij het uploaden van een aangewezen document gevuld met de vaste waarde 'Onbekend'. Indien het gaat om een zojuist gecreëerd document op basis van een sjabloon dan wordt de auteur gevuld met de medewerkerscode van de inlogger.

Er kan naast de bovengenoemde metadata die wordt meegegeven aan het DMS, ook gekozen worden om aanvullende metadata te kunnen opgeven bij handmatige upload ten behoeve van de documentregistratie (tbcorrespondentie). Dit staat los van of men met fileshare of DMS werkt (kan beiden). N.B. Deze aanvullende metadata (richting- uitzondering zie kopje hierboven Is aanvullende (meta)-informatie verplicht per geüpload document?, definitief) wordt dus niet meegenomen in het Stuf-bericht (in geval van DMS). Eerder was deze metadata alleen mee te geven bij het aanvinken per document door de gebruiker en de wizard voor handmatig registreren van documenten te doorlopen.

Indien de zaak speelt in een compartiment dan kijkt OpenWave naar of de kolom Handmatige uploads registreren (tbcompartiment.dldocregallehandmuploads) aangevinkt is bij het betreffende compartiment onder de tegel compartimentsrechten in beheerportaal-Nieuw, kolom Gebruikers. Indien de zaak NIET speelt in een compartiment dan kijkt OpenWave naar de instelling Sectie: Documentregisteren en Item: AlleOLODSOUploads. Aangevinkt dan worden in de wizard voor upload documenten ook de velden getoond om metadata op te geven zoals aangegeven met de instellingen bij de documentregistratie. De programmatuur kijkt als volgt naar de instellingen (dus alleen als handmatig upload registreren aan staat!):

  • Documenttype hiervoor geldt bovengenoemde instelling voor DMS EN/OF instelling Sectie: Documentregistreren en Item:DvDoctype staat aan
  • Titel/Korte omschrijving hiervoor geldt bovengenoemde instelling voor DMS EN/OF Sectie: Documentregistreren en DvOmschrijving staat aan
  • Vertrouwelijkheid hiervoor geldt bovengenoemde instelling voor DMS EN/OF Sectie: Documentregistreren en DvVertrouwelijkheid staat aan
  • Richting (uitgaand, binnenkomend, intern). Zichtbaar indien Sectie: Documentregistreren en DvDocrichting staat aan
  • Definitief (ja, nee). Zichtbaar indien Sectie: Documentregistreren en DvStatus staat aan. Is niet hetzelfde als status bij koppelingdocnaardms: daar is het de status die meegegeven wordt in het uitgaande Stuf-bericht. Voor de documentregistratie wordt met dvstatus bedoelt of het om een document gaat met status definitief ja of nee
  • Ontvangstdatum zichtbaar indien Sectie: Documentregistreren en DdOntvangstdatum staat aan.

Indien Getal2 van instelling Sectie: Documenten en Item: DocumentRegistratie de waarde 1 heeft dan zal bij het uploaden van een document dat reeds voorkomt bij de betreffende zaak in tbcorrespondentie (geregistreerde documenten) de kolom dvdocplaats gewijzigd worden in server, ddgewijzigd in vandaag en dvcoderegistreerder met de inlogger. De controle vindt plaats op pad (niet bij stuf zaak/DMS) + documentnaam. De view-kolom dvkanbewerken (het kleurenbolletje van de lijst geregistreerde documenten) wordt daarmee groen mits het document de status uitgaand heeft en nog niet is verstuurd.

  • De instelling Sectie: Documenten en Item: MultipleUpload moet aangevinkt zijn.
  • In Getal1 van Sectie: OWB en Item: MaxUploadMbGrootte kan de maximale toegestane bestandsgrootte voor multiple uploads EN downloads worden ingegeven in Mb (default 50Mb). LET OP: Deze instelling is niet van toepassing op documenten die van buiten naar OpenWave worden binnengeschoten (OLO, DSO, RVO): daar geldt een restrictie die in de PHP.ini staat, waar functioneel beheer NIET bij kan.
  • In de kolom tekst van instelling Sectie: OWB en Item: TussenMapUploadFiles moet de mapnaam op de webserver die gebruikt wordt als uploadmap : het tussenstation tussen DMS/fileshare en het device van de gebruiker. Deze mapnaam MOET eindigen op de karakterreeks: '/openwave/upload/' en beginnen met een '/'.
  • In Getal1: (default: 24) van Sectie: OWB en Item: MaxUurUpload staat het aantal uur waarna de programmatuur zelf de file zal verwijderen. Files ouder dan het aantal uur dat is ingesteld in kolom Getal1 van bovengenoemde instelling worden automatisch verwijderd.
  • Indien Sectie: Documenten en Item: StartAutomUploadSchermNaUpload aangevinkt is dan wordt na het aanwijzen van de te uploaden documenten met de knop 'uitvoeren' automatisch het scherm toon uploads bij deze zaak getoond. Het uploaden (afhankelijk van grootte en aantal documenten) kan nog onder water bezig zijn, zodat de kleurbolletjes bij de eerder aangewezen documenten nog op oranje staan (ben bezig). Onderaan het scherm is daarom een refreshknop geplaatst.
  • Indien Getal1 van Sectie: OWB en Item: VertragingMilSecUploadFile gevuld is, dan wordt deze waarde beschouwd als het aantal milliseconden dat het programma moet wachten na elke file die moet worden geüpload. De ontvangende server kan een probleem hebben met het gelijktijdig ontvangen van berichten.
  • Indien Getal1 van Sectie: OWB en Item: MaxLengteUploadBestandsnaam is gevuld dan kan geen file aangewezen worden waarvan de bestandsnaam inclusief extensie qua lengte groter is dan de waarde van Getal1.

Indien de upload vanuit de tabel adviezen wordt gedaan dan geldt nog het volgende:

  • aan de kolom uploadlog van de betreffende advieszaak wordt een regel met systeemdatum + medewerkerscode en geuploade filenaam toegevoegd
  • indien de instelling Sectie: Adviezen en Item: DateringDoorUpload aangevinkt is EN de kolom Advies retour (tbadviezen.ddadvdatering) is leeg dan wordt deze gevuld met de datum van upload.

Zie voor verdere specifieke instellingen bij de paragrafen:

  • openwave/1.30/applicatiebeheer/probleemoplossing/programmablokken/upload_document.txt
  • Laatst gewijzigd: 2024/05/06 12:44
  • door Lonneke van Dijk