X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;ds=sidebyside;f=doc%2Fhtml%2Fch03s08.html;h=8f7f1db8a3180d4cf242c47b30abcdb471c11f3f;hb=8da82ce0e57e5ae5a05f4fec2dea1fb049aadf10;hp=2bb4eac920dd6a66fcd4624c03b38188ad38df3d;hpb=8a1f99fd8bc7c8ee80eae18cc0ed052c48fb93aa;p=kivitendo-erp.git diff --git a/doc/html/ch03s08.html b/doc/html/ch03s08.html index 2bb4eac92..8f7f1db8a 100644 --- a/doc/html/ch03s08.html +++ b/doc/html/ch03s08.html @@ -1,42 +1,62 @@
-Parallel zum alten WebDAV gibt es eine Datei-Management-Sytem, daà Dateien - verschiedenen Typs verwaltet. Dies können
aus ERP-Daten per LaTeX Template erzeugte PDF-Dokumente,
zu bestimmten ERP-Daten gehörende Anhangdateien unterschiedlichen Formats,
per Scanner eingelesene PDF-Dateien,
per Email empfangene Dateianhänge unterschiedlichen Formats,
sowie speziel an Artikel hochgeladene Bilder sein.
Ãber eine vom Speichermedium unabhängige Zwischenschicht werden die Dateien und ihre Versionen in der Datenbank verwaltet. Darunter können verschiedene Implementierungen (Backends) gleichzeitig existieren: -
Dateisystem,
WebDAV,
Schnittstelle zu externem Dokumenten-Management-System,
andere Datenbank,
etc ...
Es gibt unterschiedliche Typen von Dateien, jedem Typ läÃt sich in der - Mandantenkonfigurierung ein bestimmtes Backend zuordnen. -
"document", das sind entweder generierte,eingescannte oder hochgeladene PDF-Dateien, - die zu bestimmten ERP-Daten (ERP-Objekte, wi z.B. Rechnung, Lieferschein) gehören.
"attachment", zusätzlich hochgeladene Dokumente, die an bestimmte ERP-Objekte angehängt werden, - z.B. technische Zeichnungen,AufmaÃe. Diese können auch an Artikeln, - Lieferanten und Kunden hinterlegt sein
"image", Bilder an Artikeln. Diese können auch verkleinert in einer Vorschau (Thumbnail) - angezeigt werden.
Zusätzlich werden in der Datenbank zu den Dateien neben der Zuordnung zu ERP-Objekten, des Dateityps - des Dateinamens und des Backends in dem die Datei gespeichert ist auch die Quelle der Datei notiert: -
"created" , vom System erzeugte Dokumente"
"uploaded", hochgeladene Dokumente
"email", vom Mailsystem empfangene Dateien
"scanner[1]", von einem oder mehreren Scannern erzeugte Dateien. Existieren mehrere Scanner, - so sind diese durch unterschiedliche Quellennamen zu definieren
Je nach Dateityp sind nur bestimmte Quellen zulässig. So gibt es für "attachment" und "image" nur - die Quelle "uploaded". Für "document" gibt es auf jeden Fall die Quelle "created". - Die Quellen "scanner" und "email" müssen derzeit in der Datenbank konfiguriert werden (siehe Datenbank-Konfigurierung.
Die Daten werden bei den ERP-Objekten als extra Reiter dargestellt. - Eine Verkaufsrechnung z.B. hat die - Reiter "Dokumente" und "Dateianhänge.
Bei den Dateianhängen wird immer nur die aktuelle Version einer Datei angezeigt. - Wird eine Datei mit gleichem Namen hochgeladen, so wird eine neue Version der Datei erstellt. - Vorher wird der Anwender durch einen Dialog ob er eine neue Version anlegen will oder - ob er die Datei umbenennen will, falls es eine neue Datei sein soll.
Es können mehrere Dateien gleichzeitig hochgeladen werden, - solange in Summe die maximale GröÃe nicht überschritten wird. - (siehe Mandantenkonfigurierung -
Sind keine weiteren Quellen für Dokumente konfiguriert, so gibt es nur "erzeugte Dokumente". - Es werden alle Versionen der generierten Datei angezeigt. Für Verkaufsrechnungen kommen keine - anderen Quellen zur Geltung. Werden entsprechend - Datenbank-Konfigurierung zusätzliche Quellen konfiguriert, so sind diese z.B. bei - Einkaufsrechnungen sichtbar:
Statt des Löschens wird hier die Datei zurück zur Quelle verschoben. Somit kann die Datei anschlieÃend - an ein anderes ERP-Objekt angehängt werden.
Derzeit sind "Titel" und "Beschreibung" noch nicht genutzt. Sie sind bisher nur bei Bildern relevant.
Unter dem Reiter Features im Abschnit Dateimanagement ist - neben dem "alten" WebDAV das Dateimangement general zu- und abschaltbar, sowie die Zuordnung der - Dateitypen zu Backends. Die Löschbarkeit von Dateien sowie die maximale UploadgröÃe sind Backend-unabhängig
Die einzelnen Backends sind einzeln einschaltbar. Spezifische Backend-Konfigurierungen sind hier - noch ergänzbar.
Unter dem Reiter Allgemeine Dokumentenanhänge - kann für alle ERP-Dokumente ( Angebote, Aufträge, Lieferscheine, Rechnungen im Verkauf und Einkauf ) - allgemeingültige Anhänge hochgeladen werden.
Diese Anhänge werden beim Generieren von PDF-Dateien an die ERP-Dokumente angehängt, - z.B. AGBs oder aktuelle Angebote. Es werden in dem Fall die Daten kopiert, sodaà an den ERP-Dokumenten immer - die Anhänge zum Generierungszeitpunkt eingebettet sind. -
Die zusätzlichen Quellen für email oder ein oder mehrere Scanner sind derzeit vom Administrator - direkt in der Datenbanktablle "user_preferences" einzurichten. Die "value" ist im JSON-Format - mit den jeweiligen Werten des Verzeichnisses und der Beschreibung der Quelle.
+3.8. Dateiverwaltung (Mini-DMS) \ No newline at end of file +Parallel zum alten WebDAV gibt es ein Datei-Management-System, + das Dateien verschiedenen Typs verwaltet. Dies können
aus ERP-Daten per LaTeX Template erzeugte + PDF-Dokumente,
zu bestimmten ERP-Daten gehörende Anhangdateien + unterschiedlichen Formats,
per Scanner eingelesene PDF-Dateien,
per E-Mail empfangene Dateianhänge unterschiedlichen + Formats,
sowie speziel für Artikel hochgeladene Bilder sein.
Ãber eine vom Speichermedium unabhängige Zwischenschicht werden + die Dateien und ihre Versionen in der Datenbank verwaltet. Darunter + können verschiedene Implementierungen (Backends) gleichzeitig + existieren:
Dateisystem
WebDAV
Schnittstelle zu externen + Dokumenten-Management-Systemen
andere Datenbank
etc ...
Es gibt unterschiedliche Typen von Dateien. Jedem Typ läÃt sich + in der Mandantenkonfiguration ein bestimmtes Backend zuordnen.
"document": Das sind entweder generierte, eingescannte oder + hochgeladene PDF-Dateien, die zu bestimmten ERP-Daten + (ERP-Objekte, wie z.B. Rechnung, Lieferschein) gehören.
"attachment": zusätzlich hochgeladene Dokumente, die an + bestimmte ERP-Objekte angehängt werden, z.B. technische + Zeichnungen, AufmaÃe. Diese können auch für Artikel, Lieferanten + und Kunden hinterlegt sein.
"image": Bilder für Artikel. Diese können auch verkleinert + in einer Vorschau (Thumbnail) angezeigt werden.
Zusätzlich werden in der Datenbank zu den Dateien neben der + Zuordnung zu ERP-Objekten, Dateityp Dateinamen und Backend, in dem die + Datei gespeichert ist, auch die Quelle der Datei notiert:
"created": vom System erzeugte Dokumente"
"uploaded": hochgeladene Dokumente
"email": vom Mail-System empfangene Dateien
"scanner[1]": von einem oder mehreren Scannern erzeugte + Dateien. Existieren mehrere Scanner, so sind diese durch + unterschiedliche Quellennamen zu definieren.
Je nach Dateityp sind nur bestimmte Quellen zulässig. So gibt es + für "attachment" und "image" nur die Quelle "uploaded". Für "document" + gibt es auf jeden Fall die Quelle "created". Die Quellen "scanner" und + "email" müssen derzeit in der Datenbank konfiguriert werden (siehe + Datenbank-Konfigurierung).
Die Daten werden bei den ERP-Objekten als extra Reiter + dargestellt. Eine Verkaufsrechnung z.B. hat die Reiter "Dokumente" und + "Dateianhänge".
Bei den Dateianhängen wird immer nur die aktuelle Version einer + Datei angezeigt. Wird eine Datei mit gleichem Namen hochgeladen, so + wird eine neue Version der Datei erstellt. Vorher wird der Anwender + durch einen Dialog gefragt, ob er eine neue Version anlegen will oder + ob er die Datei umbenennen will, falls es eine neue Datei sein + soll.
Es können mehrere Dateien gleichzeitig hochgeladen werden, + solange in Summe die maximale GröÃe nicht überschritten wird (siehe + Mandantenkonfigurierung).
Sind keine weiteren Quellen für Dokumente konfiguriert, so gibt + es nur "erzeugte Dokumente". Es werden alle Versionen der generierten + Datei angezeigt. Für Verkaufsrechnungen kommen keine anderen Quellen + zur Geltung. Werden entsprechend der Datenbank-Konfigurierung zusätzliche Quellen konfiguriert, + so sind diese z.B. bei Einkaufsrechnungen sichtbar:
Statt des Löschens wird hier die Datei zurück zur Quelle + verschoben. Somit kann die Datei anschlieÃend an ein anderes + ERP-Objekt angehängt werden.
Derzeit sind "Titel" und "Beschreibung" noch nicht genutzt. Sie + sind bisher nur bei Bildern relevant.
Unter dem Reiter Features + im Abschnitt Dateimanagement ist neben dem "alten" WebDAV das + Dateimangement generell zu- und abschaltbar, sowie die Zuordnung + der Dateitypen zu Backends. Die Löschbarkeit von Dateien, sowie + die maximale UploadgröÃe sind Backend-unabhängig
Die einzelnen Backends sind einzeln einschaltbar. + Spezifische Backend-Konfigurierungen sind hier noch + ergänzbar.
Unter dem Reiter Allgemeine + Dokumentenanhänge kann für alle ERP-Dokumente ( + Angebote, Aufträge, Lieferscheine, Rechnungen im Verkauf und + Einkauf ) allgemeingültige Anhänge hochgeladen werden.
Diese Anhänge werden beim Generieren von PDF-Dateien an die + ERP-Dokumente angehängt, z.B. AGBs oder aktuelle Angebote. Es + werden in dem Fall die Daten kopiert, sodass an den ERP-Dokumenten + immer die Anhänge zum Generierungszeitpunkt eingebettet + sind.
Die zusätzlichen Quellen für "email" oder ein oder mehrere + Scanner sind derzeit vom Administrator direkt in der + Datenbanktabelle "user_preferences" einzurichten. Die "value" ist im + JSON-Format mit den jeweiligen Werten des Verzeichnisses und der + Beschreibung der Quelle.
id | login | namespace | version | key | value ----+-----------+--------------+---------+----------+--------------------------- 1 | #default# | file_sources | 0.00000 | scanner1 | @@ -45,9 +65,12 @@ {"dir":"/var/tmp/scanner2","desc":"Scanner Verkauf"} 3 | #default# | file_sources | 0.00000 | emails | {"dir":"/var/tmp/emails","desc":"Empfangene Mails" } -Es ist daran gedacht, statt dem default Eintrag später für bestimmte Benutzer ('login') bestimmte Quellen zuzulassen, - dies wird nach Bedarf implementiert.
Dort ist im Abschnitt [paths] der relative oder absolute Pfad zum Dokumentenwurzelverzeichnis einzutragen. - Dieser muss für den Webserver schreib- und lesbar sein, jedoch nicht ausführbar.
+Es ist daran gedacht, statt dem Default-Eintrag später für + bestimmte Benutzer ('login') bestimmte Quellen zuzulassen. Dies wird + nach Bedarf implementiert.
Dort ist im Abschnitt [paths] der relative oder absolute Pfad + zum Dokumentenwurzelverzeichnis einzutragen. Dieser muss für den + Webserver schreib- und lesbar sein, jedoch nicht ausführbar.
[paths] document_path = /var/local/kivi_documents -Unter diesem Wurzelverzeichnis wird pro Mandant automatisch ein Unterverzeichnis mit der ID des Mandanten angelegt
Unter diesem Wurzelverzeichnis wird pro Mandant automatisch + ein Unterverzeichnis mit der ID des Mandanten angelegt.