X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2Fdokumentation.xml;h=5b311bc8700904edbfdd709ad7d9c29f424e1a24;hb=94b28d720a9568407d76f874ef07b212093b1dc6;hp=463106c46510f312ae589d31a1a3dd90224af3af;hpb=f3c78a027b8d2709c41f803852706c72cc355eb2;p=kivitendo-erp.git diff --git a/doc/dokumentation.xml b/doc/dokumentation.xml index 463106c46..5b311bc87 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 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 + + Allgemeine Variablen in Mahnungen - Die Variablen des Verkäufers stehen wie gewohnt als - employee_... zur Verfügung. Die Adressdaten des - Kunden stehen als Variablen name, + Die Variablen des Bearbeiters, bzw. Verkäufers stehen wie gewohnt als + employee_... bzw. salesman_... zur Verfügung. + Werden mehrere Rechnungen in einer Mahnung zusammengefasst, so werden + die Metadaten (Bearbeiter, Abteilung, etc) der ersten angemahnten Rechnung + im Ausdruck genommen. + Die Adressdaten des Kunden stehen als Variablen name, street, zipcode, city, country, department_1, department_2, - und email zur Verfügung. + und email zur Verfügung. Der Ansprechpartner cp_... + steht auch zu Verfügung, wird allerdings auch nur von der ersten angemahnten Rechnung (s.o.) + genommen. Weitere Variablen beinhalten: @@ -6220,7 +6252,8 @@ Beschreibung: <%description%> Vorschläge für weitere (z.B. branchenspezifische) Kontenpläne bitte an empfang@revamp-it.ch senden. - + + Artikelklassifizierung @@ -6329,6 +6362,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. + + + @@ -6611,8 +6855,7 @@ Beschreibung: <%description%> - Enthält unter anderem Listenbegrenzung vclimit, - Datumsformat dateformat und Nummernformat numberformat + Enthält unter anderem Datumsformat dateformat und Nummernformat numberformat @@ -7778,7 +8021,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.