X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2Fdokumentation.xml;h=141cb19186bfff11ca001300fc5b097fd5c1277a;hb=30b069f266a6ab59bd8a43f60a19cc4960299735;hp=35c2c735c22f9162495ae8fb52b6a9b50dd38b7b;hpb=aa63ebae1c0a758ec438c594acb328b1f0e5e001;p=kivitendo-erp.git
diff --git a/doc/dokumentation.xml b/doc/dokumentation.xml
index 35c2c735c..141cb1918 100644
--- a/doc/dokumentation.xml
+++ b/doc/dokumentation.xml
@@ -204,6 +204,14 @@
Email::MIME
+
+ MIME::Entity
+
+
+
+ MIME::Parser
+
+
FCGI (nicht Versionen 0.68 bis 0.71
inklusive; siehe File::Copy::Recursive
+
+ File::MimeInfo::Magic
+
+
GD
@@ -418,6 +430,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 +6366,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 +8025,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.