From: Martin Helmling martin.helmling@octosoft.eu Date: Thu, 12 Jan 2017 13:59:45 +0000 (+0100) Subject: Dateimanagement: Dokumentation X-Git-Tag: release-3.5.4~1590 X-Git-Url: http://wagnertech.de/git?a=commitdiff_plain;h=f2e8209c6bf52ac30aeada05270e79ff400782b3;p=kivitendo-erp.git Dateimanagement: Dokumentation --- diff --git a/doc/UPGRADE b/doc/UPGRADE index ee60d8ad2..4303fe650 100644 --- a/doc/UPGRADE +++ b/doc/UPGRADE @@ -7,6 +7,11 @@ Wichtige Hinweise zum Upgrade von älteren Versionen Upgrade auf v3.4.x Unstable =========================== +* Die PDF-Generierung ist erweitert. Beim Massendruck können auch Leerseiten + eingebaut werden, z.B. falls zweiseitg ausgedruckt wird. Statt die Anzahl + Seiten per Ghostscript zu ermitteln wird dazu "pdfinfo" genutzt. + Das muß installiert sein. Der Script "installation_check.pl" prüft dies. + * In der Rechte-Tabelle auth.master_rights wurden alle Positionswerte mit 100 multipliziert, um Lücken für neue Rechte zu schaffen. diff --git a/doc/changelog b/doc/changelog index 3c163d206..dd0f68dbf 100644 --- a/doc/changelog +++ b/doc/changelog @@ -6,6 +6,30 @@ große Features: +- Dateiverwaltung (Mini-DMS) + + parallel zum alten WebDAV gibt es nun eine Datei-Management Lösung, die + über eine Speichermedium unabhängige Zwischenschicht die Dateien in der + Datenbank verwaltet. Darunter können verschiedene Backends existieren. + Aktuell ist dies eine Filesystem-Struktur. + + Modular können weitere Backends eingebunden werden. In Arbeit ist + ein Backend, daß auf die alte WebDAV-Struktur zugreift. + + Es gibt unterschiedliche Typen von Dateien, jedem Typ läßt sich in der + Mandantenkonfigurierung auf ein bestimmtes Backend zuordnen. + + Aktuell gibt es die Dateitypen + - "documents", das sind entweder generierte,eingescannte oder hochgeladene PDF-Dateien + - "attachments", zusätzlich hochgeladene Dokumente, die an bestimmte ERP-Objekte angehängt werden + - "images", hochgeladene Bilder zu Artikeln + + Daneben gibt es Dateiquellen + - "created" , vom System erzeugte Dokumente + - "uploaded", hochgeladene Dokumente + - "scanner1,scanner2" , von einem oder mehreren Scannern erzeugte Dateien + - "email", vom Mailsystem empfangene Dateien + - Artikel-Klassifizierung Die Klassifizierung von Artikeln dient einer weiteren Gliederung um @@ -49,6 +73,8 @@ kleinere neue Features und Detailverbesserungen: - Druckvorlagen Mahnungen: Bearbeiter und Verkäufer-Metadaten auch im Ausdruck zu Verfügung stellen + - PDF-Erzeugen mit Leerseiten für zweiseitiges Drucken (Installation siehe auch UPGRADE Datei) + - SEPA Überweisungen zusätzlich Kunden- oder Lieferantennummer im Verwendungszweck vorbelegen - Dialogbuchen um WebDAV-Funktion erweitert diff --git a/doc/dokumentation.xml b/doc/dokumentation.xml index 35c2c735c..2d77d0069 100644 --- a/doc/dokumentation.xml +++ b/doc/dokumentation.xml @@ -418,6 +418,25 @@ cpan HTML::Restrict cpan Rose::Db::Object + + Andere Pakete installieren + + Seit Version v3.4.0 wird für den Bankimport optional das Paket + 'aqbanking-tools' benötigt. + + Ubuntu: apt install aqbanking-tools + + OpenSuSE: zypper install aqbanking-tools + + Seit Version v3.4.1 wird generell zum Feststellen der + Seitenanzahl von PDF_Dokumenten 'pdfinfo' benötigt was im Paket + 'poppler-utils' enthalten ist. + + Ubuntu: apt install poppler-utils + + OpenSuSE: zypper install poppler-tools + + empfang@revamp-it.ch senden. - + + Artikelklassifizierung @@ -6334,6 +6354,217 @@ Beschreibung: <%description%> Erleichterung mit dargestellt. + + + Dateiverwaltung (Mini-DMS) + + + Übersicht + 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. + + + + Übersicht + + + + + + + + + + Struktur + + Ü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 . + + + + Anwendung + Die Daten werden bei den ERP-Objekten als extra Reiter dargestellt. + Eine Verkaufsrechnung z.B. hat die + Reiter "Dokumente" und "Dateianhänge. + + Reiter "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. + + Reiter "Dateianhänge" + + + + + + + Es können mehrere Dateien gleichzeitig hochgeladen werden, + solange in Summe die maximale Größe nicht überschritten wird. + (siehe + + Reiter "Dokumente" + + + + + + + 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 + zusätzliche Quellen konfiguriert, so sind diese z.B. bei + Einkaufsrechnungen sichtbar: + + Reiter "Dokumente" + + + + + + + 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. + + + + Konfigurierung + + Mandantenkonfigurierung + + Reiter "Features" + 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 + + Mandantenkonfig Reiter "Features" + + + + + + + Die einzelnen Backends sind einzeln einschaltbar. Spezifische Backend-Konfigurierungen sind hier + noch ergänzbar. Für das Backend Dateisystem ist das Wurzelverzeichnis für den Mandanten einzugeben. + + + Reiter "Allgemeine Dokumentenanhänge" + 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. + + Mandantenkonfig Reiter "Allgemeine Dokumentenanhänge" + + + + + + + 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. + + + + + Datenbank-Konfigurierung + 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. + + id | login | namespace | version | key | value +----+-----------+--------------+---------+----------+--------------------------- + 1 | #default# | file_sources | 0.00000 | scanner1 | + {"dir":"/var/tmp/scanner1","desc":"Scanner Einkauf"} + 2 | #default# | file_sources | 0.00000 | scanner2 | + {"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. + + + @@ -7782,7 +8013,7 @@ Support::TestSetup::login(); sein. Dieser wird für die Datenbankverbindung benötigt. Wir keine vollständig initialisierte Umgebung benötigt, so - kann die letzte Zeile Support::TestSetup::login(); + kann die letzte Zeile Support::TestSetup::login(); weggelassen werden, was die Ausführungszeit des Scripts leicht verringert. diff --git a/doc/images/DMS-Allgemeine-Dokumentenanhaenge.png b/doc/images/DMS-Allgemeine-Dokumentenanhaenge.png new file mode 100644 index 000000000..59ad7a655 Binary files /dev/null and b/doc/images/DMS-Allgemeine-Dokumentenanhaenge.png differ diff --git a/doc/images/DMS-Anhaenge-hochladen.png b/doc/images/DMS-Anhaenge-hochladen.png new file mode 100644 index 000000000..cbaed0a90 Binary files /dev/null and b/doc/images/DMS-Anhaenge-hochladen.png differ diff --git a/doc/images/DMS-Anhaenge.png b/doc/images/DMS-Anhaenge.png new file mode 100644 index 000000000..dd7ad1939 Binary files /dev/null and b/doc/images/DMS-Anhaenge.png differ diff --git a/doc/images/DMS-ClientConfig.png b/doc/images/DMS-ClientConfig.png new file mode 100644 index 000000000..1e1fc12e1 Binary files /dev/null and b/doc/images/DMS-ClientConfig.png differ diff --git a/doc/images/DMS-Dokumente-Scanner.png b/doc/images/DMS-Dokumente-Scanner.png new file mode 100644 index 000000000..937891790 Binary files /dev/null and b/doc/images/DMS-Dokumente-Scanner.png differ diff --git a/doc/images/DMS-Dokumente.png b/doc/images/DMS-Dokumente.png new file mode 100644 index 000000000..069660e8a Binary files /dev/null and b/doc/images/DMS-Dokumente.png differ diff --git a/doc/images/DMS-Overview.png b/doc/images/DMS-Overview.png new file mode 100644 index 000000000..25b204e4b Binary files /dev/null and b/doc/images/DMS-Overview.png differ