projekt kivitendo

<para>Analog stehen die benutzerdefinierten Variablen für Ansprechpersonen mit dem Namenspräfix <varname>cp_cvar_</varname> zur Verfügung.</para>

<para>Die Klassifizierung von Artikeln dient einer weiteren Gliederung,

um zum Beispiel den Einkauf vom Verkauf zu trennen, gekennzeichnet

durch eine Beschreibung (z.B. "Einkauf") und ein Kürzel (z.B. "E").

Für jede Klassifizierung besteht eine Beschreibung und eine Abkürzung

die normalerweise aus einem Zeichen besteht, kann aber auf mehrere

Zeichen erweitert werden, falls zur Unterscheidung notwendig. Sinnvoll

sind jedoch nur maximal 2 Zeichen.</para>

<para>Für das Attribut "separat ausweisen" stehen in den LaTeX-Vorlagen

die Variable <emphasis role="bold">&lt;%non_separate_subtotal%&gt;

</emphasis>zur Verfügung, die alle nicht separat auszuweisenden

Artikelkosten saldiert, sowie pro separat auszuweisenden

Klassifizierungen die Variable<emphasis role="bold">&lt;

%separate_X_subtotal%&gt;</emphasis>, wobei X das Kürzel der

Klassifizierung ist.</para>

<para>Parallel zum alten WebDAV gibt es ein Datei-Management-System, das Dateien

verschiedenen Typs verwaltet. Dies können</para>

<para>per E-Mail empfangene Dateianhänge unterschiedlichen Formats,</para>

<para>Schnittstelle zu externen Dokumenten-Management-Systemen</para>

<para>Es gibt unterschiedliche Typen von Dateien. Jedem Typ läßt sich in der

Mandantenkonfiguration ein bestimmtes Backend zuordnen.

</para>

<para>"document": Das sind entweder generierte, eingescannte oder hochgeladene PDF-Dateien,

die zu bestimmten ERP-Daten (ERP-Objekte, wie z.B. Rechnung, Lieferschein) gehören.</para>

<para>"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.</para>

<para>"image": Bilder für Artikel. Diese können auch verkleinert in einer Vorschau (Thumbnail)

angezeigt werden.</para>

<para>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:

</para>

<para> "created": vom System erzeugte Dokumente"</para>

<para> "uploaded": hochgeladene Dokumente</para>

<para> "email": vom Mail-System empfangene Dateien</para>

<para> "scanner[1]": von einem oder mehreren Scannern erzeugte Dateien. Existieren mehrere Scanner,

so sind diese durch unterschiedliche Quellennamen zu definieren.</para>

<para>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 <xref linkend="file_management.dbconfig"/>).</para>

<para>Die Daten werden bei den ERP-Objekten als extra Reiter dargestellt.

Eine Verkaufsrechnung z.B. hat die

Reiter "Dokumente" und "Dateianhänge".</para>

<para>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.</para>

solange in Summe die maximale Größe nicht überschritten wird

(siehe <xref linkend="file_management.clientconfig"/>).</para>

<para>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

<xref linkend="file_management.dbconfig"/> zusätzliche Quellen konfiguriert, so sind diese z.B. bei

Einkaufsrechnungen sichtbar:</para>

<sect3 id="file_management.clientconfig" xreflabel="Mandantenkonfigurierung">

<para>Unter dem Reiter <emphasis role="bold">Features</emphasis> 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</para>

<screenshot>

<screeninfo>Mandantenkonfig Reiter "Features"</screeninfo>

<mediaobject>

<imageobject>

<imagedata width="500" fileref="images/DMS-ClientConfig.png"/>

</imageobject>

</mediaobject>

</screenshot>

<para>Die einzelnen Backends sind einzeln einschaltbar. Spezifische Backend-Konfigurierungen sind hier

noch ergänzbar.</para>

</sect4>

<para>Unter dem Reiter <emphasis role="bold">Allgemeine Dokumentenanhänge</emphasis>

kann für alle ERP-Dokumente ( Angebote, Aufträge, Lieferscheine, Rechnungen im Verkauf und Einkauf )

allgemeingültige Anhänge hochgeladen werden.</para>

<screenshot>

<screeninfo>Mandantenkonfig Reiter "Allgemeine Dokumentenanhänge"</screeninfo>

<mediaobject>

<imageobject>

<imagedata width="500" fileref="images/DMS-Allgemeine-Dokumentenanhaenge.png"/>

</imageobject>

</mediaobject>

</screenshot>

<para>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.

</para>

</sect4>

<para>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.</para>

<para>Es ist daran gedacht, statt dem Default-Eintrag später für bestimmte Benutzer ('login') bestimmte Quellen zuzulassen.

Dies wird nach Bedarf implementiert.</para>

<para>Unter diesem Wurzelverzeichnis wird pro Mandant automatisch ein Unterverzeichnis mit der ID des Mandanten angelegt.</para>

Onlineshopbestellungen zu verwalten und zu bearbeiten. </para>

<para/>

Apache) und ein Datenbankserver (PostgreSQL) in einer aktuellen Version

(s.a. Liste der unterstützten Betriebssysteme) benötigt.</p><p>Zusätzlich benötigt kivitendo einige Perl-Pakete, die nicht

</p></li></ul></div><p>Seit Version größer v3.5.0 sind die folgenden Pakete hinzugekommen:

<code class="literal">Text::Unidecode</code>

Erläuterung: Der Befehl wechselt zur letzten Stable-Version (git tag -l listet

alle Tags auf, das egrep schmeisst alle Einträge mit beta oder rc raus und

das tail gibt davon den obersten Treffer zurück).

Git Magic</a>).</p><p>

Ein beispielhafter Workflow für Druckvorlagen-Anpassungen von 3.4.1 nach 3.5:

</p><pre class="programlisting">

default_manager = german</pre><p>Für kivitendo Installationen in der Schweiz sollte hier <code class="varname">german</code>

durch <code class="varname">swiss</code> ersetzt werden.</p><p>Die Einstellung <code class="varname">default_manager = swiss</code> bewirkt:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Beim Erstellen einer neuen Datenbank in der kivitendo Administration

werden automatisch die Standard-Werte für die Schweiz voreingestellt:

Währung CHF, 5er-Rundung, Schweizer KMU-Kontenplan, Sollversteuerung,

Aufwandsmethode, Bilanzierung (die Werte können aber manuell angepasst werden).</p></li><li class="listitem"><p>Einstellen der Standardkonten für Rundungserträge und -aufwendungen

(unter Mandantenkonfiguration → Standardkonten veränderbar)</p></li><li class="listitem"><p>das verwendete Zahlenformat wird auf <code class="varname">1'000.00</code> eingestellt

(unter Programm → Benutzereinstellungen veränderbar)</p></li><li class="listitem"><p>DATEV-Automatik und UStVA werden nicht angezeigt, Erfolgsrechnung

ersetzt GUV ( unter Mandantenkonfiguration → Features veränderbar)</p></li></ul></div><p>Nutzt man wiederkehrende Rechnungen, kann man unter

(Stand Sept. 2015)</a> und einen aktuellen (Stand Mai 2017)

<a class="ulink" href="https://mozilla.github.io/server-side-tls/ssl-config-generator/" target="_top">

Dies kann kivitendo nicht für Sie erledigen.</p><p>Da der Taskserver als Perlscript läuft, wird Arbeitsspeicher,

der einmal benötigt wurde, nicht mehr an das Betriebssystem zurückgegeben,

beansprucht. Es ist deshalb sinnvoll, dass der Taskserver in regelmässigen

Abständen neu gestartet wird.</p><div class="sect2" title="2.7.1. Verfügbare und notwendige Konfigurationsoptionen"><div class="titlepage"><div><div><h3 class="title"><a name="Konfiguration-des-Task-Servers"></a>2.7.1. Verfügbare und notwendige Konfigurationsoptionen</h3></div></div></div><p>Die Konfiguration erfolgt über den Abschnitt

anstelle eines symbolischen Links verwendet werden können.</p><div class="sect3" title="2.7.3.1. SystemV-basierende Systeme (z.B. ältere Debian, ältere OpenSUSE, ältere Fedora)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e1142"></a>2.7.3.1. SystemV-basierende Systeme (z.B. ältere Debian, ältere OpenSUSE,

ältere Fedora)</h4></div></div></div><p>Kopieren Sie die Datei

Fedora, neuere Ubuntu und neuere Debians)</h4></div></div></div><p>Kopieren Sie die Datei <code class="filename">scripts/boot/systemd/kivitendo-task-server.service</code> nach

<code class="filename">/etc/systemd/system/</code>. Passen Sie in der kopierten Datei den Pfad zum Task-Server an (Zeilen

<code class="literal">ExecStart=....</code> und <code class="literal">ExecStop=...</code>).</p><p>Machen Sie anschließend das Script systemd bekannt, und binden Sie es in den Boot-Prozess ein. Dazu führen Sie die folgenden

Befehl aus:</p><pre class="programlisting">systemctl daemon-reload

systemctl enable kivitendo-task-server.service</pre><p>Wenn Sie den Task-Server jetzt sofort starten möchten, anstatt den Server neu zu starten, so können Sie das mit dem

folgenden Befehl tun:</p><pre class="programlisting">systemctl start kivitendo-task-server.service</pre></div></div><div class="sect2" title="2.7.4. Wie der Task-Server gestartet und beendet wird"><div class="titlepage"><div><div><h3 class="title"><a name="Prozesskontrolle"></a>2.7.4. Wie der Task-Server gestartet und beendet wird</h3></div></div></div><p>Der Task-Server wird wie folgt kontrolliert:</p><pre class="programlisting">./scripts/task_server.pl Befehl</pre><p>

die vom Parser nicht korrekt gelesen werden kann.</p><p>Mahnungen können unter folgenden Einschränkungen mit den odt-Vorlagen

im Vorlagensatz rev-odt erzeugt werden:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>als Druckoption steht nur 'PDF(OpenDocument/OASIS)' zur

Verfügung, das heisst, die Mahnungen werden als PDF-Datei ausgegeben.

</p></li><li class="listitem"><p>für jede Rechnung muss eine eigene Mahnung erzeugt werden

PDF-Datei zusammengefasst</p><p>Die Vorlagen zahlungserinnerung.odt sowie mahnung.odt sind für das

Erstellen einer Zahlungserinnerung bzw. Mahnung selbst vorgesehen, die

Vorlage mahnung_invoice.odt für das Erstellen einer Rechnung über die

verrechneten Mahngebühren und Verzugszinsen.</p><p>Zur Zeit gibt es in kivitendo noch keine Möglichkeit,

OpenDocument-Format, wie es LibreOffice oder OpenOffice (ab Version 2) erzeugen.

kivitendo kann dabei sowohl neue OpenDocument-Dokumente als auch aus

diesen direkt PDF-Dateien erzeugen. Um die Unterstützung von

LibreOffice oder OpenOffice benötigt. Soll dieses Feature genutzt werden, so muss

neben LibreOffice oder OpenOffice auch der “X virtual frame buffer”

(xvfb) installiert werden. Bei Debian ist er im Paket “xvfb” enthalten.

Andere Distributionen enthalten ihn in anderen Paketen.</p><p>Nach der Installation müssen in der Datei

<code class="literal">applications</code> zwei weitere Variablen

angepasst werden:</p><p>

<code class="literal">openofficeorg_writer</code> muss den

vollständigen Pfad zu LibreOffice oder OpenOffice enthalten.

Dabei dürfen keine Anführungszeichen eingesetzt werden.</p><p>Beispiel für Debian oder Ubuntu:</p><pre class="programlisting">openofficeorg_writer = /usr/bin/libreoffice</pre><p>

LibreOffice bzw. OpenOffice kommuniziert. Die erste Variante, die benutzt

wird, wenn die Variable <code class="literal">$openofficeorg_daemon</code> gesetzt

ist, startet ein LibreOffice oder OpenOffice, das auch nach der Umwandlung

des Dokumentes gestartet bleibt. Bei weiteren Umwandlungen wird dann diese

laufende Instanz benutzt. Der Vorteil ist, dass die Zeit zur Umwandlung

deutlich reduziert wird, weil nicht für jedes Dokument ein LibreOffice bzw.

OpenOffice gestartet werden muss. Der Nachteil ist, dass diese Methode

Python und die Python-UNO-Bindings benötigt, die Bestandteil von LibreOffice

bzw. OpenOffice sind.</p><div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="system/docbook-xsl/images/note.png"></td><th align="left">Anmerkung</th></tr><tr><td align="left" valign="top"><p>Für die Verbindung zu LibreOffice bzw. OpenOffice wird

<code class="filename">/usr/bin/python</code> benutzt.

Sollte dies nicht der richtige sein, so kann man mit zwei

Konfigurationsvariablen entscheiden, welcher Python-Interpreter

genutzt wird. Mit der Option <code class="literal">python_uno</code> aus dem

Abschnitt <code class="literal">applications</code> wird der Interpreter selber

wird für jedes Dokument LibreOffice bzw. OpenOffice neu gestartet

und die Konvertierung mit Hilfe eines Makros durchgeführt. Dieses

Makro muss in der Dokumentenvorlage enthalten sein und

‘<code class="literal">templates/print/rev-odt/invoice.odt</code>’

enthält ein solches Makro, das in jeder anderen Dokumentenvorlage

ebenfalls enthalten sein muss.</p><p>Als letztes muss herausgefunden werden, welchen Namen

OpenOffice bzw. LibreOffice dem Verzeichnis mit den Benutzereinstellungen

gibt. Unter Debian ist dies momentan

<code class="literal">~/.config/libreoffice</code>. kivitendo verwendet das

Verzeichnis <code class="literal">users/.openoffice.org2</code>.

Eventuell muss dieses Verzeichnis umbenannt werden.</p><p>Dieses Verzeichnis, wie auch das komplette

sein. Dieses wurde bereits erledigt (siehe <a class="xref" href="ch02s03.html" title="2.3. Manuelle Installation des Programmpaketes">Manuelle Installation des Programmpaketes</a>), kann aber

erneut überprüft werden, wenn die Konvertierung nach PDF

fehlschlägt.</p><div class="sect2" title="2.13.1. OpenDocument (odt) Druckvorlagen mit Makros"><div class="titlepage"><div><div><h3 class="title"><a name="d0e2233"></a>2.13.1. OpenDocument (odt) Druckvorlagen mit Makros</h3></div></div></div><p>OpenDocument Vorlagen können Makros enthalten, welche komplexere

ein Drucker eingerichtet werden:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Druckeradministration → Drucker hinzufügen</p></li><li class="listitem"><p>Mandant wählen</p></li><li class="listitem"><p>Druckerbeschreibung → aussagekräftiger Text: wird in

der Auftrags- bzw. Rechnungsmaske als Auswahl angezeigt (z.B.

mit Einzahlungsschein Bank xy)</p></li><li class="listitem"><p>Druckbefehl → beliebiger Text (hat für das Erzeugen

von Aufträgen oder Rechnungen als odt-Datei keine Bedeutung,

darf aber nicht leer sein)</p></li><li class="listitem"><p>Vorlagenkürzel → besr bzw. selbst gewähltes

Vorlagensuffix (muss genau der Zeichenfolge entsprechen, die

zwischen "invoice_" bzw. "sales_order_" und ".odt"

steht.)</p></li><li class="listitem"><p>speichern</p></li></ul></div></div><div class="sect3" title="2.13.1.3. Benutzereinstellungen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2275"></a>2.13.1.3. Benutzereinstellungen</h4></div></div></div><p>Wer den Ausdruck mit Einzahlungsschein als Standardeinstellung

konfigurieren:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Programm → Benutzereinstellungen →

Druckoptionen</p></li><li class="listitem"><p>Standardvorlagenformat → OpenDocument/OASIS</p></li><li class="listitem"><p>Standardausgabekanal → Bildschirm</p></li><li class="listitem"><p>Standarddrucker → gewünschte Druckerbeschreibung

auswählen (z.B. mit Einzahlungsschein Bank xy)</p></li><li class="listitem"><p>Anzahl Kopien → leer</p></li><li class="listitem"><p>speichern</p></li></ul></div></div><div class="sect3" title="2.13.1.4. Aufbau und nötige Anpassungen der Vorlagen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2299"></a>2.13.1.4. Aufbau und nötige Anpassungen der Vorlagen</h4></div></div></div><p>In der Vorlage sind als Modul "BESR" 4 Makros gespeichert, die

angepasst werden:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Extras → Optionen → Sicherheit →

Makrosicherheit</p></li><li class="listitem"><p>Sicherheitslevel auf "Mittel" einstellen (Diese

der entsprechenden Nachfrage "Makros ausführen" auswählen.

</p><p>

<title>2.14. Nomenklatur</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s13.html" title="2.13. OpenDocument-Vorlagen"><link rel="next" href="ch02s15.html" title="2.15. Konfiguration zur Einnahmenüberschussrechnung/Bilanzierung: EUR"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.14. Nomenklatur</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s13.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch02s15.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.14. Nomenklatur"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="nomenclature"></a>2.14. Nomenklatur</h2></div></div></div><div class="sect2" title="2.14.1. Datum bei Buchungen"><div class="titlepage"><div><div><h3 class="title"><a name="booking.dates"></a>2.14.1. Datum bei Buchungen</h3></div></div></div><p>Seit der Version 3.5 werden für Buchungen in kivitendo einheitlich

folgende Bezeichnungen verwendet:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>

<code class="option">Erfassungsdatum</code> (en: <code class="option">Entry Date</code>,

code: <code class="option">Gldate</code>)</p><p>bezeichnet das Datum, an dem die Buchung in kivitendo erfasst wurde.

</p></li><li class="listitem"><p>

<code class="option">Buchungsdatum</code> (en: <code class="option">Booking Date</code>,

code: <code class="option">Transdate</code>)</p><p>bezeichnet das buchhaltungstechnisch für eine Buchung relevante

Datum</p><p>Das <code class="option">Rechnungsdatum</code> bei Verkaufs- und

<code class="option">Buchungsdatum</code> angezeigt werden kann, erscheint hier

im Fall von Rechnungen das Rechnungsdatum.</p></li><li class="listitem"><p>Bezieht sich ein verbuchter Beleg auf einen Zeitpunkt, der nicht mit

dem Buchungsdatum übereinstimmt, so kann dieses Datum momentan in kivitendo

nur unter Bemerkungen erfasst werden.</p><p>Möglicherweise wird für solche Fälle in einer späteren Version von

kivitendo ein dritter Datumswert für Buchungen erstellt. (Beispiel:

Einkaufsbeleg stammt aus einem früheren Jahr, das bereits

buchhaltungstechnisch abgeschlossen wurde, und muss deshalb später

verbucht werden.)</p></li></ul></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s13.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch02s15.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.13. OpenDocument-Vorlagen&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;2.15. Konfiguration zur Einnahmenüberschussrechnung/Bilanzierung:

</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Sollversteuerung</p></li><li class="listitem"><p>Aufwandsmethode</p></li><li class="listitem"><p>Bilanzierung</p></li></ul></div><p>

Diese Einstellungen werden automatisch beim Erstellen einer neuen

Datenbank vorausgewählt, wenn in <code class="filename">config/kivitendo.conf</code> unter

<code class="varname">[system]</code>

<code class="literal">default_manager = swiss</code> eingestellt ist.

</p><p>Beim Upgrade bestehender Mandanten wird eur ausgelesen und die

<span class="guimenu">System</span> →

<span class="guisubmenu">Kontenübersicht</span> → <span class="guimenuitem">Konto

erfassen</span> das Konto angelegt.</p><div class="screenshot"><div class="mediaobject"><img src="images/skr04-update-3804/konto3804.png"></div></div><p>Als Zweites muss Steuergruppe 13 für Konto 3803 angepasst

<span class="guisubmenu">Steuern</span> →

<span class="guimenuitem">Erfassen</span> auswählen und die Werte aus dem

Screenshot übernehmen.</p><div class="screenshot"><div class="mediaobject"><img src="images/skr04-update-3804/steuer3804.png"></div></div><p>Als Nächstes sind alle Konten anzupassen, die als

<title>2.18. Erfolgsrechnung</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s17.html" title="2.17. Verhalten des Bilanzberichts"><link rel="next" href="ch02s19.html" title="2.19. Rundung in Verkaufsbelegen"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.18. Erfolgsrechnung</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s17.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch02s19.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.18. Erfolgsrechnung"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="config.erfolgsrechnung"></a>2.18. Erfolgsrechnung</h2></div></div></div><p>Seit der Version 3.4.1 existiert in kivitendo der Bericht <span class="bold"><strong>

Erfolgsrechnung</strong></span>.</p><p>Die Erfolgsrechnung kann in der Mandantenkonfiguration unter Features

an- oder abgeschaltet werden. Mit der Einstellung <code class="varname">default_manager = swiss

</code> in der <code class="filename">config/kivitendo.conf</code> wird beim neu Erstellen

einer Datenbank automatisch die Anzeige der Erfolgsrechnung im Menü <span class="guimenu">Berichte

</span> ausgewählt und ersetzt dort die GUV.</p><p>Im Gegensatz zur GUV werden bei der Erfolgsrechnung sämtliche Aufwands- und

Erlöskonten einzeln aufgelistet (analog zur Bilanz), sortiert nach ERTRAG und AUFWAND.</p><p>Bei den Konteneinstellungen muss bei jedem Konto, das in der Erfolgsrechnung

erscheinen soll, unter <code class="varname">Sonstige Einstellungen/Erfolgsrechnung</code>

entweder <code class="literal">01.Ertrag</code> oder <code class="literal">06.Aufwand</code> ausgewählt

werden.</p><p>Wird bei einem Erlöskonto <code class="literal">06.Aufwand</code> ausgewählt,

so wird dieses Konto als Aufwandsminderung unter AUFWAND aufgelistet.</p><p>Wird bei einem Aufwandskonto <code class="literal">01.Ertrag</code> ausgewählt,

so wird dieses Konto als Ertragsminderung unter ERTRAG aufgelistet.</p><p>Soll bei einer bereits bestehenden Buchhaltung in Zukunft zusätzlich

die Erfolgsrechnung als Bericht verwendet werden, so müssen die Einstellungen

zu allen Erlös- und Aufwandskonten unter <code class="varname">Sonstige

Einstellungen/Erfolgsrechnung</code> überprüft und allenfalls neu gesetzt werden.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s17.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch02s19.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.17. Verhalten des Bilanzberichts&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;2.19. Rundung in Verkaufsbelegen</td></tr></table></div></body></html>

<title>2.19. Rundung in Verkaufsbelegen</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s18.html" title="2.18. Erfolgsrechnung"><link rel="next" href="ch02s20.html" title="2.20. Einstellungen pro Mandant"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.19. Rundung in Verkaufsbelegen</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s18.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch02s20.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.19. Rundung in Verkaufsbelegen"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="config.rounding"></a>2.19. Rundung in Verkaufsbelegen</h2></div></div></div><p>In der Schweiz hat die kleinste aktuell benutzte Münze den Wert von 5 Rappen (0.05 CHF).</p><p>Auch wenn im elektronischen Zahlungsverkehr Beträge mit einer Genauigkeit

von 0.01 CHF verwendet werden können, ist es trotzdem nach wie vor üblich,

Rechnungen mit auf 0.05 CHF gerundeten Beträgen auszustellen.</p><p>In kivitendo kann seit der Version 3.4.1 die Einstellung für eine solche

Rundung pro Mandant / Datenbank festgelegt werden.</p><p>Die Einstellung wird beim Erstellen der Datenbank bei <code class="literal">Genauigkeit</code>

festgelegt. Sie kann anschliessend über das Webinterface von kivitendo nicht mehr

verändert werden.</p><p>Abhängig vom Wert für <code class="varname">default_manager</code> in

<code class="filename">config/kivitendo.conf</code> werden dabei folgende

Werte voreingestellt:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>0.05 (default_manager = swiss)</p></li><li class="listitem"><p>0.01 (default_manager = german)</p></li></ul></div><p>Der Wert wird in der Datenbank in der Tabelle <code class="varname">defaults

und Verkaufsgutschriften wird der Endbetrag inkl. MWST gerundet,

wenn dieser nicht der eingestellten Genauigkeit entspricht.</p><p>Beim Buchen einer Verkaufsrechnung wird der Rundungsbetrag

Standardkonten für Rundungserträge bzw. Rundungsaufwendungen gebucht.</p><p>(Die berechnete MWST wird durch den Rundungsbetrag nicht mehr verändert.)</p><p>Die in den Druckvorlagen zur Verfügung stehenden Variablen

<span class="bold"><strong>Achtung:</strong></span> Werden Verkaufsbelege

in anderen Währungen als der Standardwährung erstellt, so muss in

kivitendo ab Version 3.4.1 die Genauigkeit 0.01 verwendet werden.</p><p>Das heisst, Firmen in der Schweiz, die teilweise Verkaufsrechnungen

in Euro oder anderen Währungen erstellen wollen, müssen beim Erstellen

der Datenbank als Genauigkeit 0.01 wählen und können zur Zeit die

5er Rundung noch nicht nutzen.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s18.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch02s20.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.18. Erfolgsrechnung&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;2.20. Einstellungen pro Mandant</td></tr></table></div></body></html>

Sofern es nicht ausdrücklich eingeschränkt wird, gilt das im

Folgenden gesagte für alle Vorlagenarten.</p><p>Insgesamt sind technisch gesehen eine ganze Menge mehr Variablen

</span></dt><dd><p>Betrag, um den <code class="varname">invtotal</code> gerundet wurde

(kann positiv oder negativ sein)</p></dd><dt><span class="term">

Präfix <code class="varname">shiptocvar_</code>.</p></div></div><div class="sect2" title="3.3.9. Variablen in Mahnungen und Rechnungen über Mahngebühren"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.dunning"></a>3.3.9. Variablen in Mahnungen und Rechnungen über Mahngebühren</h3></div></div></div><div class="sect3" title="3.3.9.1. Namen der Vorlagen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.dunning-vorlagennamen"></a>3.3.9.1. Namen der Vorlagen</h4></div></div></div><p>Die Namen der Vorlagen werden im System-Menü vom Benutzer

angehängt.</p></div><div class="sect3" title="3.3.9.2. Allgemeine Variablen in Mahnungen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.dunning-allgemein"></a>3.3.9.2. Allgemeine Variablen in Mahnungen</h4></div></div></div><p>Die Variablen des Bearbeiters, bzw. Verkäufers stehen wie gewohnt als

<code class="varname">employee_...</code> bzw. <code class="varname">salesman_...</code> zur Verfügung.

Werden mehrere Rechnungen in einer Mahnung zusammengefasst, so werden

die Metadaten (Bearbeiter, Abteilung, etc) der ersten angemahnten Rechnung

im Ausdruck genommen.</p><p>Die Adressdaten des Kunden stehen als Variablen <code class="varname">name</code>,

<code class="varname">street</code>, <code class="varname">zipcode</code>,

<code class="varname">city</code>, <code class="varname">country</code>,

<code class="varname">department_1</code>, <code class="varname">department_2</code>,

und <code class="varname">email</code> zur Verfügung. Der Ansprechpartner <code class="varname">cp_...</code>

steht auch zu Verfügung, wird allerdings auch nur von der ersten angemahnten Rechnung (s.o.)

genommen.</p><p>Weitere Variablen beinhalten:</p><div class="variablelist"><dl><dt><span class="term">

</span></dt><dd><p>Rechnungsnummer</p></dd></dl></div></div></div><div class="sect2" title="3.3.10. Variablen in anderen Vorlagen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.andere-vorlagen"></a>3.3.10. Variablen in anderen Vorlagen</h3></div></div></div><div class="sect3" title="3.3.10.1. Einführung"><div class="titlepage"><div><div><h4 class="title"><a name="d0e5630"></a>3.3.10.1. Einführung</h4></div></div></div><p>Die Variablen in anderen Vorlagen sind ähnlich wie in der

<title>3.5. Mandantenkonfiguration Lager</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="prev" href="ch03s04.html" title="3.4. Excel-Vorlagen"><link rel="next" href="ch03s06.html" title="3.6. Schweizer Kontenpläne"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.5. Mandantenkonfiguration Lager</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s04.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 3. Features und Funktionen</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch03s06.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="3.5. Mandantenkonfiguration Lager"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="features.warehouse"></a>3.5. Mandantenkonfiguration Lager</h2></div></div></div><p>

Die Lagerverwaltung in kivitendo funktioniert standardmässig wie folgt: Wird ein Lager mit einem Lagerplatz angelegt, so gibt es die

Möglichkeit hier über den Menüpunkt Lager entsprechende Warenbewegungen durchzuführen. Ferner kann jede Position eines Lieferscheins

ein-, bzw. ausgelagert werden (Einkauf-, bzw. Verkauf). Es können beliebig viele Lager mit beliebig vielen Lagerplätzen abgebildet

werden. Die Lagerbewegungen über einen Lieferschein erfolgt durch Anklicken jeder Einzelposition und das Auswählen dieser Position zu

einem Lager mit Lagerplatz. Dieses Verfahren lässt sich schrittweise vereinfachen, je nachdem wie die Einstellungen in der

Mandatenkonfiguration gesetzt werden.

</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>

(Fehlbestand, o.ä.) konfiguriert sein.</p></li></ul></div><p>

Zusätzliche Funktionshinweise:

</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>

<title>3.6. Schweizer Kontenpläne</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="prev" href="ch03s05.html" title="3.5. Mandantenkonfiguration Lager"><link rel="next" href="ch03s07.html" title="3.7. Artikelklassifizierung"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.6. Schweizer Kontenpläne</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s05.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 3. Features und Funktionen</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch03s07.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="3.6. Schweizer Kontenpläne"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="features.swiss-charts-of-accounts"></a>3.6. Schweizer Kontenpläne</h2></div></div></div><p>Seit der Version 3.5 stehen in kivitendo 3 Kontenpläne für

den Einsatz in der Schweiz zur Verfügung, einer für Firmen und

Organisationen, die nicht mehrwertsteuerpflichtig sind, einer

für Firmen, die mehrwertsteuerpflichtig sind und einer speziell

für Vereine.</p><p>Die Kontenpläne orientieren sich am in der Schweiz üblicherweise

verwendeten KMU-Kontenrahmen und sind mit der Revision des Schweizerischen

Obligationenrechts (OR) vom 1.1.2013 kompatibel, insbesondere

<code class="literal">Art.957a Abs.2</code>.</p><p>Beim Vereinskontenplan sind standardmässig nur die Konten 1100

(Debitoren CHF) und 1101 (Debitoren EUR) als Buchungskonten im Verkauf

sowie die Konten 2000 (Kreditoren CHF) und 2001 (Kreditoren EUR) als

Buchungskonten im Einkauf vorgesehen. Weitere Konten können bei Bedarf

in den Konto-Detaileinstellungen als Einkaufs- oder Verkaufskonten

konfiguriert werden.</p><p>Die Möglichkeit, Saldosteuersätze zu verwenden ist in der aktuellen

Version von kivitendo noch nicht integriert.</p><p>Trotzdem können auch Firmen, die per Saldosteuersatz mit der

Eidgenössischen Steuerverwaltung abrechnen, kivitendo bereits nutzen.

Dazu wird der Kontenplan mit MWST ausgewählt. Anschliessend müssen

alle Aufwandskonten editiert werden und dort der Steuersatz auf 0%

gesetzt werden.</p><p>So werden bei Kreditorenbuchungen keine Vorsteuern verbucht.</p><p>Bezugssteuern für aus dem Ausland bezogene Dienstleistungen müssen

manuell verbucht werden.</p><p>Wünsche für Anpassungen an den Schweizer Kontenplänen sowie

Vorschläge für weitere (z.B. branchenspezifische) Kontenpläne

bitte an <code class="literal">empfang@revamp-it.ch</code> senden.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s05.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch03s07.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">3.5. Mandantenkonfiguration Lager&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;3.7. Artikelklassifizierung</td></tr></table></div></body></html>

<title>3.7. Artikelklassifizierung</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="prev" href="ch03s06.html" title="3.6. Schweizer Kontenpläne"><link rel="next" href="ch03s08.html" title="3.8. Dateiverwaltung (Mini-DMS)"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.7. Artikelklassifizierung</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s06.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 3. Features und Funktionen</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch03s08.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="3.7. Artikelklassifizierung"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="features.part_classification"></a>3.7. Artikelklassifizierung</h2></div></div></div><div class="sect2" title="3.7.1. Übersicht"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6298"></a>3.7.1. Übersicht</h3></div></div></div><p>Die Klassifizierung von Artikeln dient einer weiteren Gliederung,

um zum Beispiel den Einkauf vom Verkauf zu trennen, gekennzeichnet

durch eine Beschreibung (z.B. "Einkauf") und ein Kürzel (z.B. "E").

Für jede Klassifizierung besteht eine Beschreibung und eine Abkürzung

die normalerweise aus einem Zeichen besteht, kann aber auf mehrere

Zeichen erweitert werden, falls zur Unterscheidung notwendig. Sinnvoll

sind jedoch nur maximal 2 Zeichen.</p></div><div class="sect2" title="3.7.2. Basisklassifizierung"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6303"></a>3.7.2. Basisklassifizierung</h3></div></div></div><p>Als Basisklassifizierungen gibt es</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Einkauf</p></li><li class="listitem"><p>Verkauf</p></li><li class="listitem"><p>Handelsware</p></li><li class="listitem"><p>Produktion</p></li><li class="listitem"><p>- keine - (diese wird bei einer Aktualisierung für alle

z.B. für separat auszuweisende Artikel folgende Klassen geben:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Lieferung (Logistik, Transport) mit Kürzel L</p></li><li class="listitem"><p>Material (Verpackungsmaterial) mit Kürzel M</p></li></ul></div></div><div class="sect2" title="3.7.3. Attribute"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6333"></a>3.7.3. Attribute</h3></div></div></div><p>Bisher haben die Klassifizierungen folgende Attribute, die auch

(LaTeX) eine zusätzliche Variable</p></li></ul></div><p>Für das Attribut "separat ausweisen" stehen in den LaTeX-Vorlagen

die Variable <span class="bold"><strong>&lt;%non_separate_subtotal%&gt;

</strong></span>zur Verfügung, die alle nicht separat auszuweisenden

Artikelkosten saldiert, sowie pro separat auszuweisenden

Klassifizierungen die Variable<span class="bold"><strong>&lt;

%separate_X_subtotal%&gt;</strong></span>, wobei X das Kürzel der

Klassifizierung ist.</p><p>Im obigen Beispiel wäre das für Lieferkosten <span class="bold"><strong>&lt;%separate_L_subtotal%&gt;</strong></span> und für

&lt;%separate_M_subtotal%&gt;</strong></span>.</p></div><div class="sect2" title="3.7.4. Zwei-Zeichen Abkürzung"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6364"></a>3.7.4. Zwei-Zeichen Abkürzung</h3></div></div></div><p>Der Typ des Artikels und die Klassifizierung werden durch zwei

<title>3.8. Dateiverwaltung (Mini-DMS)</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="prev" href="ch03s07.html" title="3.7. Artikelklassifizierung"><link rel="next" href="ch04.html" title="Kapitel 4. Entwicklerdokumentation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.8. Dateiverwaltung (Mini-DMS)</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s07.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 3. Features und Funktionen</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch04.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="3.8. Dateiverwaltung (Mini-DMS)"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="features.file_managment"></a>3.8. Dateiverwaltung (Mini-DMS)</h2></div></div></div><div class="sect2" title="3.8.1. Übersicht"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6376"></a>3.8.1. Übersicht</h3></div></div></div><p>Parallel zum alten WebDAV gibt es ein Datei-Management-System, das Dateien

verschiedenen Typs verwaltet. Dies können</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>aus ERP-Daten per LaTeX Template erzeugte PDF-Dokumente,</p></li><li class="listitem"><p>zu bestimmten ERP-Daten gehörende Anhangdateien unterschiedlichen Formats,</p></li><li class="listitem"><p>per Scanner eingelesene PDF-Dateien,</p></li><li class="listitem"><p>per E-Mail empfangene Dateianhänge unterschiedlichen Formats,</p></li><li class="listitem"><p>sowie speziel für Artikel hochgeladene Bilder sein.</p></li></ol></div><div class="screenshot"><div class="mediaobject"><img src="images/DMS-Overview.png"></div></div></div><div class="sect2" title="3.8.2. Struktur"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6403"></a>3.8.2. Struktur</h3></div></div></div><p>Ü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:

</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Dateisystem</p></li><li class="listitem"><p>WebDAV</p></li><li class="listitem"><p>Schnittstelle zu externen Dokumenten-Management-Systemen</p></li><li class="listitem"><p>andere Datenbank</p></li><li class="listitem"><p>etc ...</p></li></ul></div><p>Es gibt unterschiedliche Typen von Dateien. Jedem Typ läßt sich in der

Mandantenkonfiguration ein bestimmtes Backend zuordnen.

</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>"document": Das sind entweder generierte, eingescannte oder hochgeladene PDF-Dateien,

die zu bestimmten ERP-Daten (ERP-Objekte, wie z.B. Rechnung, Lieferschein) gehören.</p></li><li class="listitem"><p>"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.</p></li><li class="listitem"><p>"image": Bilder für Artikel. Diese können auch verkleinert in einer Vorschau (Thumbnail)

angezeigt werden.</p></li></ul></div><p>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:

</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p> "created": vom System erzeugte Dokumente"</p></li><li class="listitem"><p> "uploaded": hochgeladene Dokumente</p></li><li class="listitem"><p> "email": vom Mail-System empfangene Dateien</p></li><li class="listitem"><p> "scanner[1]": von einem oder mehreren Scannern erzeugte Dateien. Existieren mehrere Scanner,

so sind diese durch unterschiedliche Quellennamen zu definieren.</p></li></ul></div><p>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 <a class="xref" href="ch03s08.html#file_management.dbconfig" title="3.8.4.2. Datenbank-Konfigurierung">Datenbank-Konfigurierung</a>).</p></div><div class="sect2" title="3.8.3. Anwendung"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6455"></a>3.8.3. Anwendung</h3></div></div></div><p>Die Daten werden bei den ERP-Objekten als extra Reiter dargestellt.

Eine Verkaufsrechnung z.B. hat die

Reiter "Dokumente" und "Dateianhänge".</p><div class="screenshot"><div class="mediaobject"><img src="images/DMS-Anhaenge.png"></div></div><p>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.</p><div class="screenshot"><div class="mediaobject"><img src="images/DMS-Anhaenge-hochladen.png"></div></div><p>Es können mehrere Dateien gleichzeitig hochgeladen werden,

solange in Summe die maximale Größe nicht überschritten wird

(siehe <a class="xref" href="ch03s08.html#file_management.clientconfig" title="3.8.4.1. Mandantenkonfiguration">Mandantenkonfigurierung</a>).</p><div class="screenshot"><div class="mediaobject"><img src="images/DMS-Dokumente.png"></div></div><p>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

<a class="xref" href="ch03s08.html#file_management.dbconfig" title="3.8.4.2. Datenbank-Konfigurierung">Datenbank-Konfigurierung</a> zusätzliche Quellen konfiguriert, so sind diese z.B. bei

Einkaufsrechnungen sichtbar:</p><div class="screenshot"><div class="mediaobject"><img src="images/DMS-Dokumente-Scanner.png"></div></div><p>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.</p><p>Derzeit sind "Titel" und "Beschreibung" noch nicht genutzt. Sie sind bisher nur bei Bildern relevant.</p></div><div class="sect2" title="3.8.4. Konfigurierung"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6498"></a>3.8.4. Konfigurierung</h3></div></div></div><div class="sect3" title="3.8.4.1. Mandantenkonfiguration"><div class="titlepage"><div><div><h4 class="title"><a name="file_management.clientconfig"></a>3.8.4.1. Mandantenkonfiguration</h4></div></div></div><div class="sect4" title="3.8.4.1.1. Reiter &#34;Features&#34;"><div class="titlepage"><div><div><h5 class="title"><a name="d0e6504"></a>3.8.4.1.1. Reiter "Features"</h5></div></div></div><p>Unter dem Reiter <span class="bold"><strong>Features</strong></span> 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</p><div class="screenshot"><div class="mediaobject"><img src="images/DMS-ClientConfig.png"></div></div><p>Die einzelnen Backends sind einzeln einschaltbar. Spezifische Backend-Konfigurierungen sind hier

noch ergänzbar.</p></div><div class="sect4" title="3.8.4.1.2. Reiter &#34;Allgemeine Dokumentenanhänge&#34;"><div class="titlepage"><div><div><h5 class="title"><a name="d0e6520"></a>3.8.4.1.2. Reiter "Allgemeine Dokumentenanhänge"</h5></div></div></div><p>Unter dem Reiter <span class="bold"><strong>Allgemeine Dokumentenanhänge</strong></span>

kann für alle ERP-Dokumente ( Angebote, Aufträge, Lieferscheine, Rechnungen im Verkauf und Einkauf )

allgemeingültige Anhänge hochgeladen werden.</p><div class="screenshot"><div class="mediaobject"><img src="images/DMS-Allgemeine-Dokumentenanhaenge.png"></div></div><p>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.

</p></div></div><div class="sect3" title="3.8.4.2. Datenbank-Konfigurierung"><div class="titlepage"><div><div><h4 class="title"><a name="file_management.dbconfig"></a>3.8.4.2. Datenbank-Konfigurierung</h4></div></div></div><p>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.</p><pre class="programlisting">

</pre><p>Es ist daran gedacht, statt dem Default-Eintrag später für bestimmte Benutzer ('login') bestimmte Quellen zuzulassen.

Dies wird nach Bedarf implementiert.</p></div><div class="sect3" title="3.8.4.3. kivitendo-Konfigurationsdatei"><div class="titlepage"><div><div><h4 class="title"><a name="file_management.kiviconfig"></a>3.8.4.3. kivitendo-Konfigurationsdatei</h4></div></div></div><p>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.</p><pre class="programlisting">

</pre><p>Unter diesem Wurzelverzeichnis wird pro Mandant automatisch ein Unterverzeichnis mit der ID des Mandanten angelegt.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s07.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch04.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">3.7. Artikelklassifizierung&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;Kapitel 4. Entwicklerdokumentation</td></tr></table></div></body></html>