nanoDMS

Dokumentenverwaltungssystem

Tips & Tricks


Autor: W.Nagy

Creative Commons Attribution-ShareAlike 2.0 license
Navigieren in dieser Präsentation durch Pfeiltasten
↑ vorherige Seite, ↓ Folgeseite.
Diese Präsentation ist erstellt mit S5

Inhalt

Hintergrund

In dieser Präsentation werden verschiedenen Aspekte mit dem Umgang des DMS diskutiert.

Aufrufen von Groovyskripten - Vorbereitung

Die ist eine Möglichkeit des unterliegenden Frameworks (mFrame). Es ermöglicht den Entwickler Skripte zu verwenden, welche nicht im mframe.xml eingebunden sind aufzurufen. Das Plugin dazu ist
./WEB-INF/classes/scripts/CallScriptController.groovy

Um auf das Plugin zugreifen zu können, muss erst das Recht dazu freigeschalten werden.
Die geschieht in der Datei ./WEB-INF/mframe.xml. Im Eintrag
   <entry path="/scripts">
    <controller path="CallScriptController.groovy" />
    <display value="no" />
    <rights value="ADMIN,NANODMS-ADMIN" />
   </entry>
ist das Recht 'NANODMS-ADMIN' einzutragen.

Aufrufen von Groovyskripten - Skripte

Skripte werden in das Verzeichnis ./WEB-INF/classes/scripts/src eingetragen.
Aufrufen des Plugin:
Das Skriptplugin wird nach dem einloggen als Administrator mit dem URL
http://localhost:8080/nanodms/start.groovy?path=/scripts
aufgerufen. Es wird eine Auswahl aller vorhandener Skripte angezeigt. Durch Klicken auf das Skriptsymbol wird das Skript gestartet.

Hello World Skript

Erstellen einer Datei namens 'HelloWorld.groovy'. In das Skript wird der Befehl
render "Hallo World!" notiert. Nach dem Aufruf des URLs kann das Skript gestartet werden.

Aufrufen von Groovyskripten - Hintergrund

Die Skripte werden als Controller behandelt. Es sind alle Möglichkeiten eines Controllers von mFrame vorhanden.
Beispiel (anzeigen aller Dokumente):

import helper.nanodms.domain.DocumentDomain

DocumentDomain document = new DocumentDomain(db:db.dbh)

document.eachDomain() {
   render "${document.docName}<br />"
   }

Angepasste JS und CSS Dateien

Die CSS und JS Dateien sind im Verzeichnis
<approot>/WEB-INF/classes/helper/nanodms
gespeichert.
Um eine versionsresistente Anspassung vorzunehmen können diese an einer anderen Stelle gehalten werden.
Beispiel:
Anlegen eines Verzeichnisses<approot >/conf Dort könne die Unterverzeichnisse js und css angelegt werden. In diese werden die Ihalte der Verzeichnisse des DMS kopiert.
Aufrufkonfiguration:
Das DMS wird im Konstroller NanoDMSController.groovy aufgerufen. Dieses ist im Verzeichnis <approot>/WEB-INF/classes/MVC/root/dms gespeichert. In diesem Kontroller sind folgende Zeilen einzufügen:
nano.jsPath='conf/js'
nano.cssPath='conf/css'

Zugrifsrechtsszenarien - Hintergrund

Das DMS ist mit umfangreichen Möglichkeiten die Zugriffsrechte auf Dokumente zu steueren ausgestattet.
Die Zugriffsrechte werden auf ein Verzeichnis bezogen. Diese basieren auf Gruppenzugehöhrigkeit des angemeldeten Benutzers. Die Zuordnung erfolgt in der Administrationskonsole in der Funktion Groupmanger.Siehe dazu das Administrationshandbuch.

Zugrifsrechtsszenarien - Szenario 1

Beschreibung

Es sollen Verzeichnisse für jeden Benutzer eingerichtet werden, auf welche genau dieser Benutzer Schreib- und Leserechte besitzt. Daneben solle es ein allgemeines Verzeichnis geben, auf welche alle Benutzer Schreib- und Leserechte haben. Die Idee dahinter ist, dass Dokumente im privaten Verzeichnis erstellt und gewartet werden. Sind diese zu Veröffentlichung bereit, werden diese in das allgmein zugängliche Verzeichnis (common) verschoben. Dies ist die Einstellung der Demoversion.

Verzeichnisbaum


/users
 +-- /user-2
 +-- /user-2
 +-- /common
  1. Anlegen der Hauptgruppen USER-COMMON
  2. Zuordnen der Gruppen zu den Usern. Jeder User muß in der Gruppe USER-COMMON sein.
  3. Anpassen der Eigentumsrechte

Vorgehen

In der Eigenschaften Maske des Verzeichnis /common sind die Rechte für die Gruppe USER-COMMON auf rwd zu setzen.
Den Verzeichnissen user-1 und user-2 sind in den Eigenschaften die Option 'Eigentümer' entsprechend anzupassen. Die Eigentumsoption des Verzeichnisses common ist unerheblich es sollte aber aus Sicherheitsgründen "admin" sein.

Zugrifsrechtsszenarien - Szenario 2

Beschreibung

Es gibt einen oder mehrer Administratoren, welche Dokumente aufladen und entfernen können. Alle anderen Benutzer dürfen nur lesend zugreifen. Das Leserecht von Unterverzeichnissen kann auch noch weiter eingeschränkt werden.

Verzeichnisbaum


+-- documents
   +-- Bereich-1
   +-- Bereich-2
  1. Anlegen der Hauptgruppen ADMIN, BEREICH-1, BEREICH-2
  2. Zuordnen der Gruppen zu den Usern.
  3. Anpassen der Eigentumsrechte

Vorgehen

In den Eingenschften des Verzeichnis documents hat die Gruppe ADMIN Lese- und Schreibrechte.
Die Ordner Bereich1- und Bereich-2 sind die gewünschten Leseberechtigungen vergeben. />