Auftrags-Controller: PDF-Download: nur Dateien aus session_files erlauben.
[kivitendo-erp.git] / doc / dokumentation.xml
index 67c8da2..c7f3400 100644 (file)
 
     <itemizedlist>
       <listitem>
-        <para>im kivitendo-Forum: <ulink
+        <para>im Community-Forum: <ulink
         url="https://forum.kivitendo.org:32443">https://forum.kivitendo.org:32443</ulink></para>
       </listitem>
+      <listitem>
+        <para>im Kunden-Forum: <ulink
+        url="http://redmine.kivitendo-premium.de/projects/forum/boards/">http://redmine.kivitendo-premium.de/projects/forum/boards/</ulink></para>
+      </listitem>
       <listitem>
         <para>in der doc/UPGRADE Datei im doc-Verzeichnis der Installation</para>
       </listitem>
@@ -513,8 +517,15 @@ psql template1</programlisting>
 
         führen Sie die folgenden Kommandos aus:</para>
 
-        <programlisting>create language 'plpgsql';
+        <programlisting>CREATE EXTENSION IF NOT EXISTS plpgsql;
+\q</programlisting>
+
+       <note>
+        <para><literal>CREATE EXTENSION</literal> ist seit Version 9.1 die bevorzugte Syntax um die Sprache <literal>plpgsql</literal> anzulegen. In diesen Versionen ist die Extension meist auch schon vorhanden. Sollten Sie eine ältere Version von Postgres haben, benutzen Sie stattdessen den folgenden Befehl.</para>
+        <programlisting>CREATE LANGUAGE 'plpgsql';
 \q</programlisting>
+       </note>
+
       </sect2>
 
       <sect2 id="Datenbankbenutzer-anlegen">
@@ -556,10 +567,11 @@ exit</programlisting>
         anderen Datei hinzu, die beim Starten des Webservers eingelesen
         wird:</para>
 
-        <programlisting>AddHandler cgi-script .pl
+        <programlisting>AliasMatch ^/kivitendo-erp/[^/]+\.pl /var/www/kivitendo-erp/dispatcher.pl
 Alias /kivitendo-erp/ /var/www/kivitendo-erp/
 
 &lt;Directory /var/www/kivitendo-erp&gt;
+ AddHandler cgi-script .pl
  Options ExecCGI Includes FollowSymlinks
 &lt;/Directory&gt;
 
@@ -574,6 +586,9 @@ Alias /kivitendo-erp/ /var/www/kivitendo-erp/
         <note>
           <para>Vor den einzelnen Optionen muss bei einigen Distributionen ein
           Plus ‘<literal>+</literal>’ gesetzt werden.</para>
+          <para>Bei einigen Distribution (Ubuntu ab 14.04, Debian ab 8.2) muss noch explizit
+          das cgi-Modul mittels <programlisting>a2enmod cgi</programlisting> aktiviert
+          werden.</para>
         </note>
 
         <para>Auf einigen Webservern werden manchmal die Grafiken und
@@ -756,6 +771,15 @@ Alias       /url/for/kivitendo-erp-fcgid/          /path/to/kivitendo-erp/</prog
           FastCGI-Version.</para>
         </sect3>
       </sect2>
+      <sect2>
+        <title>Weitergehende Konfiguration</title>
+          <para>Für einen deutlichen Sicherheitsmehrwert sorgt die Ausführung von kivitendo
+          nur über https-verschlüsselten Verbindungen, sowie weiteren Zusatzmassnahmen,
+          wie beispielsweise Basic Authenticate.
+          Die Konfigurationsmöglichkeiten sprengen allerdings den Rahmen dieser Anleitung, hier ein
+          Hinweis auf einen entsprechenden <ulink
+        url="http://redmine.kivitendo-premium.de/boards/1/topics/142">Foreneintrag (Stand Sept. 2015)</ulink></para>
+      </sect2>
     </sect1>
 
     <sect1 id="config.task-server">
@@ -992,7 +1016,7 @@ ln -s $(pwd)/kivitendo-task-server.service /etc/systemd/system/</programlisting>
       <sect2 id="Administratorpasswort">
         <title>Administratorpasswort</title>
 
-        <para>Das Passwort, das zum Zugriff auf das Aministrationsinterface
+        <para>Das Passwort, das zum Zugriff auf das Administrationsinterface von kivitendo
         benutzt wird, wird ebenfalls in dieser Datei gespeichert. Es kann auch
         nur dort und nicht mehr im Administrationsinterface selber geändert
         werden. Der Parameter dazu heißt <varname>admin_password</varname> im
@@ -1437,11 +1461,13 @@ ln -s $(pwd)/kivitendo-task-server.service /etc/systemd/system/</programlisting>
 
       <para>kivitendo bringt drei alternative Vorlagensätze mit:</para>
       <itemizedlist>
-        <listitem><para>Standard</para></listitem>
-        <listitem><para>f-tex</para></listitem>
         <listitem><para>RB</para></listitem>
+        <listitem><para>f-tex</para></listitem>
+        <listitem><para>rev-odt</para></listitem>
       </itemizedlist>
 
+      <para>Der ehemalige Druckvorlagensatz "Standard" wurde mit der Version 3.3 entfernt, da er nicht mehr gepflegt wurde.</para>
+
       <sect2 id="Vorlagenverzeichnis-anlegen" xreflabel="Vorlagenverzeichnis anlegen">
         <title>Vorlagenverzeichnis anlegen</title>
         <para>Es lässt sich ein initialer Vorlagensatz erstellen. Die LaTeX-System-Abhängigkeiten hierfür kann man prüfen mit:</para>
@@ -1458,7 +1484,7 @@ ln -s $(pwd)/kivitendo-task-server.service /etc/systemd/system/</programlisting>
 
         <orderedlist>
           <listitem><para><option>Vorlagen auswählen</option>: Wählen Sie hier den Vorlagensatz aus, der kopiert werden soll
-          (<filename>Standard</filename>, <filename>f-tex</filename> oder <filename>RB</filename>.)</para></listitem>
+          (<filename>RB</filename>, <filename>f-tex</filename> oder <filename>odt-rev</filename>.)</para></listitem>
           <listitem><para><option>Neuer Name</option>: Der Verzeichnisname für den neuen Vorlagensatz. Dieser kann im Rahmen der üblichen
           Bedingungen für Verzeichnisnamen frei gewählt werden.</para></listitem>
         </orderedlist>
@@ -1470,11 +1496,22 @@ ln -s $(pwd)/kivitendo-task-server.service /etc/systemd/system/</programlisting>
 
 
       </sect2>
-      <sect2 id="Vorlagen-Standard">
-        <title>Standard</title>
 
-        <para>Der Standard-Vorlagensatz von kivitendo. Wie unter <ulink url="https://www.kivitendo.de">https://www.kivitendo.de</ulink> zu
-        sehen.</para>
+      <sect2 id="Vorlagen-RB">
+        <title>Der Druckvorlagensatz RB</title>
+
+        <para>Hierbei handelt es sich um einen vollständigen LaTeX Dokumentensatz mit alternativem Design. Die odt oder html-Varianten sind nicht gepflegt.</para>
+        <para>Die konzeptionelle Idee der Vorlagen wird <ulink
+          url="http://www.kivitendo-support.de/vortraege/Lx-Office%20Anwendertreffen%20LaTeX-Druckvorlagen-Teil3-finale.pdf">hier</ulink>
+          auf Folie 5 bis 10 vorgestellt. Informationen zur Anpassung an die eigenen Firmendaten finden sich in der Datei Readme.tex im Vorlagenverzeichnis.</para>
+
+        <para>Eine kurze Übersicht der Features:</para>
+          <itemizedlist>
+            <listitem><para>Mehrsprachenfähig, mit Deutscher und Englischer Übersetzung</para></listitem>
+            <listitem><para>Zentrale Konfigurationsdateien, die für alle Belege benutzt werden, z.B. für Kopf- und Fußzeilen, und Infos wie Bankdaten</para></listitem>
+            <listitem><para>mehrere vordefinierte Varianten für Logos/Hintergrundbilder</para></listitem>
+            <listitem><para>Berücksichtigung für Steuerzonen "EU mit USt-ID Nummer" oder "Außerhalb EU"</para></listitem>
+          </itemizedlist>
 
       </sect2>
 
@@ -1634,21 +1671,43 @@ ln -s $(pwd)/kivitendo-task-server.service /etc/systemd/system/</programlisting>
         </sect3>
       </sect2>
 
-      <sect2 id="Vorlagen-RB">
-        <title>Der Druckvorlagensatz RB</title>
+      <sect2 id="Vorlagen-rev-odt">
+        <title>Der Druckvorlagensatz rev-odt</title>
 
-        <para>Hierbei handelt es sich um einen vollständigen \LaTeX Dokumentensatz mit alternativem Design. Die odt oder html-Varianten sind nicht gepflegt.</para>
-        <para>Die konzeptionelle Idee der Vorlagen wird <ulink
-          url="http://www.kivitendo-support.de/vortraege/Lx-Office%20Anwendertreffen%20LaTeX-Druckvorlagen-Teil3-finale.pdf">hier</ulink>
-          auf Folie 5 bis 10 vorgestellt. Informationen zur Anpassung an die eigenen Firmendaten finden sich in der Datei Readme.tex im Vorlagenverzeichnis.</para>
+        <para>Hierbei handelt es sich um einen Dokumentensatz der mit odt-Vorlagen erstellt wurde. Es gibt in dem Verzeichnis eine Readme-Datei, die eventuell aktueller als die Dokumentation hier ist.
+Die odt-Vorlagen in diesem Verzeichnis "rev-odt" wurden von revamp-it, Zürich erstellt
+und werden laufend aktualisiert. Ein paar der Formulierungen in den Druckvorlagen entsprechen dem Schweizer Sprachgebrauch, z.B. "Offerte" oder "allfällig".
+        </para>
 
-        <para>Eine kurze Übersicht der Features:</para>
-          <itemizedlist>
-            <listitem><para>Mehrsprachenfähig, mit Deutscher und Englischer Übersetzung</para></listitem>
-            <listitem><para>Zentrale Konfigurationsdateien, die für alle Belege benutzt werden, z.B. für Kopf- und Fußzeilen, und Infos wie Bankdaten</para></listitem>
-            <listitem><para>mehrere vordefinierte Varianten für Logos/Hintergrundbilder</para></listitem>
-            <listitem><para>Berücksichtigung für Steuerzonen "EU mit USt-ID Nummer" oder "Außerhalb EU"</para></listitem>
-          </itemizedlist>
+<para>
+Hinweis zum Einsatz des Feldes "Land" bei den Stammdaten für KundInnen und LieferantInnen,
+sowie bei Lieferadressen:
+Die in diesem Vorlagensatz vorhandenen Vorlagen erwarten für "Land" das entsprechende
+Kürzel, das in Adressen vor die Postleitzahl gesetzt wird.
+Das Feld kann auch komplett leer bleiben.
+Wer dies anders handhaben möchte, muss die Vorlagen entsprechend anpassen.
+</para>
+<para>
+odt-Vorlagen können mit LibreOffice oder OpenOffice editiert
+und den eigenen Bedürfnissen angepasst werden.
+Wichtig beim Editieren von if-Blöcken ist, dass immer der gesamte Block
+überschrieben werden muss und nicht nur Teile davon, da dies sonst oft
+zu einer odt-Datei führt, die vom Parser nicht korrekt gelesen werden kann.
+</para>
+<para>
+Zur Zeit gibt es in kivitendo noch keine Möglichkeit, odt-Vorlagen bei Mahnungen
+einzusetzen. Entsprechende Vorlagen sind deshalb nicht vorhanden.
+</para>
+<para>
+Inwieweit es möglich ist, für die in Version 3.2.0 neu eingeführten Pflichtenhefte
+odt-Vorlagen zu erstellen, sind wir am abklären.
+Wenn dies möglich ist, werden wir in Zukunft auch eine odt-Vorlage für Pflichtenhefte
+in diesem Vorlagensatz zur Verfügung stellen.
+</para>
+<para>
+Fehlermeldungen, Anregungen und Wünsche bitte senden an:
+empfang@revamp-it.ch
+</para>
 
       </sect2>
 
@@ -2131,7 +2190,7 @@ ln -s $(pwd)/kivitendo-task-server.service /etc/systemd/system/</programlisting>
     <title>Features und Funktionen</title>
 
     <sect1 id="features.periodic-invoices"
-           xreflabel="Wiedekehrende Rechnungen">
+           xreflabel="Wiederkehrende Rechnungen">
       <title>Wiederkehrende Rechnungen</title>
 
       <sect2 id="features.periodic-invoices.introduction"
@@ -2531,7 +2590,21 @@ ln -s $(pwd)/kivitendo-task-server.service /etc/systemd/system/</programlisting>
         manuell über den Workflow.</para>
       </sect2>
     </sect1>
-        <sect1 id="dokumentenvorlagen-und-variablen">
+    <sect1 id="features.bank"
+           xreflabel="bankerweiterung">
+      <title>Bankerweiterung</title>
+
+      <sect2 id="features.bank.introduction"
+             xreflabel="Einführung in die Bankerweiterung">
+        <title>Einführung</title>
+
+        <para>Die Beschreibung der Bankerweiterung befindet sich derzeit noch im Wiki und soll von dort später hierhin übernommen werden:</para>
+
+        <para><ulink
+        url="http://redmine.kivitendo-premium.de/projects/forum/wiki/Bankerweiterung">http://redmine.kivitendo-premium.de/projects/forum/wiki/Bankerweiterung</ulink></para>
+      </sect2>
+    </sect1>
+    <sect1 id="dokumentenvorlagen-und-variablen">
       <title>Dokumentenvorlagen und verfügbare Variablen</title>
 
       <sect2 id="dokumentenvorlagen-und-variablen.einführung">