Stornos bei EK-Rechnungen verbieten, solange SEPA-Exports verknüpft sind

[mfinanz.git] / doc / dokumentation.xml

diff --git a/doc/dokumentation.xml b/doc/dokumentation.xml
index b4ad88303f3411ea685eaa4c406484c5c9da2a9c..5fe1f6200994a7ebc913f3108fa4c13916233df6 100644 (file)
--- a/doc/dokumentation.xml
+++ b/doc/dokumentation.xml
@@ -2,7 +2,8 @@
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
 <book id="kivitendo-documentation" lang="de">
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
 <book id="kivitendo-documentation" lang="de">

-  <title>kivitendo 3.5.1-beta: Installation, Konfiguration, Entwicklung</title>
+  <title>kivitendo 3.5.1: Installation, Konfiguration,
+  Entwicklung</title>

 
   <chapter id="Aktuelle-Hinweise">
     <title>Aktuelle Hinweise</title>
 
   <chapter id="Aktuelle-Hinweise">
     <title>Aktuelle Hinweise</title>


@@ -330,11 +331,13 @@
         </itemizedlist>
 
         <para>Seit Version größer v3.5.0 sind die folgenden Pakete
         </itemizedlist>
 
         <para>Seit Version größer v3.5.0 sind die folgenden Pakete

-        hinzugekommen: <literal>Text::Unidecode, LWP::Authen::Digest,
-        LWP::UserAgent</literal></para>
+        hinzugekommen: <literal>Text::Unidecode</literal>,
+        <literal>LWP::Authen::Digest</literal>,
+        <literal>LWP::UserAgent</literal></para>

 
         <para>Seit Version v3.4.0 sind die folgenden Pakete hinzugekommen:
 
         <para>Seit Version v3.4.0 sind die folgenden Pakete hinzugekommen:

-        <literal>Algorithm::CheckDigits</literal><literal>PBKDF2::Tiny</literal></para>
+        <literal>Algorithm::CheckDigits</literal>,
+        <literal>PBKDF2::Tiny</literal></para>

 
         <para>Seit Version v3.2.0 sind die folgenden Pakete hinzugekommen:
         <literal>GD</literal>, <literal>HTML::Restrict</literal>,
 
         <para>Seit Version v3.2.0 sind die folgenden Pakete hinzugekommen:
         <literal>GD</literal>, <literal>HTML::Restrict</literal>,


@@ -372,7 +375,7 @@
           <title>Debian und Ubuntu</title>
 
           <para>Für Debian und Ubuntu stehen die meisten der benötigten
           <title>Debian und Ubuntu</title>
 
           <para>Für Debian und Ubuntu stehen die meisten der benötigten

-          Perl-Pakete als Debian-Pakete zur Verfügung. Sie können mit
+          Pakete als Debian-Pakete zur Verfügung. Sie können mit

           folgendem Befehl installiert werden:</para>
 
           <programlisting>apt install  apache2 libarchive-zip-perl libclone-perl \
           folgendem Befehl installiert werden:</para>
 
           <programlisting>apt install  apache2 libarchive-zip-perl libclone-perl \


@@ -385,11 +388,12 @@
   libtext-iconv-perl liburi-perl libxml-writer-perl libyaml-perl \
   libimage-info-perl libgd-gd2-perl libapache2-mod-fcgid \
   libfile-copy-recursive-perl postgresql libalgorithm-checkdigits-perl \
   libtext-iconv-perl liburi-perl libxml-writer-perl libyaml-perl \
   libimage-info-perl libgd-gd2-perl libapache2-mod-fcgid \
   libfile-copy-recursive-perl postgresql libalgorithm-checkdigits-perl \

-  libcrypt-pbkdf2-perl git libcgi-pm-perl libtext-unidecode-perl libwww-perl
+  libcrypt-pbkdf2-perl git libcgi-pm-perl libtext-unidecode-perl libwww-perl\
+  postgresql-contrib aqbanking-tools poppler-utils

 </programlisting>
 
 </programlisting>
 

-          <para>Für das Paket HTML::Restrict gibt es kein Debian-Paket, dies
-          muß per CPAN installiert werden. Unter Ubuntu funktioniert das
+          <para>Für einige Perl Pakete gibt es kein Debian-Paket, dies
+          muß per CPAN installiert werden. Unter Ubuntu funktioniert das für das benötige Paket HTML::Restrict

           mit:</para>
 
           <programlisting>apt-get install build-essential
           mit:</para>
 
           <programlisting>apt-get install build-essential


@@ -449,7 +453,9 @@ cpan HTML::Restrict</programlisting>
         <para>Debian und Ubuntu: <programlisting>apt install aqbanking-tools
         </programlisting></para>
 
         <para>Debian und Ubuntu: <programlisting>apt install aqbanking-tools
         </programlisting></para>
 

-        <para>OpenSuSE: <programlisting>zypper install aqbanking-tools</programlisting></para>
+        <para>Fedora: <programlisting>dnf install aqbanking</programlisting></para>
+
+        <para>openSUSE: <programlisting>zypper install aqbanking-tools</programlisting></para>

 
         <para>Seit Version v3.4.1 wird generell zum Feststellen der
         Seitenanzahl von PDF_Dokumenten 'pdfinfo' benötigt was im Paket
 
         <para>Seit Version v3.4.1 wird generell zum Feststellen der
         Seitenanzahl von PDF_Dokumenten 'pdfinfo' benötigt was im Paket


@@ -458,7 +464,9 @@ cpan HTML::Restrict</programlisting>
         <para>Debian und Ubuntu: <programlisting>apt install poppler-utils
         </programlisting></para>
 
         <para>Debian und Ubuntu: <programlisting>apt install poppler-utils
         </programlisting></para>
 

-        <para>OpenSuSE: <programlisting>zypper install poppler-tools</programlisting></para>
+        <para>Fedora: <programlisting>dnf install poppler-utils</programlisting></para>
+
+        <para>openSUSE: <programlisting>zypper install poppler-tools</programlisting></para>

       </sect2>
     </sect1>
 
       </sect2>
     </sect1>
 


@@ -500,7 +508,7 @@ tar xvzf kivitendo-erp-3.4.1.tgz</programlisting>
       restlichen Dateien müssen für diesen Benutzer lesbar sein. Die Benutzer-
       und Gruppennamen sind bei verschiedenen Distributionen unterschiedlich
       (z.B. bei Debian/Ubuntu <constant>www-data</constant>, bei Fedora
       restlichen Dateien müssen für diesen Benutzer lesbar sein. Die Benutzer-
       und Gruppennamen sind bei verschiedenen Distributionen unterschiedlich
       (z.B. bei Debian/Ubuntu <constant>www-data</constant>, bei Fedora

-      <constant>apache</constant> oder bei OpenSUSE
+      <constant>apache</constant> oder bei openSUSE

       <constant>wwwrun</constant>).</para>
 
       <para>Der folgende Befehl ändert den Besitzer für die oben genannten
       <constant>wwwrun</constant>).</para>
 
       <para>Der folgende Befehl ändert den Besitzer für die oben genannten


@@ -524,11 +532,11 @@ git clone https://github.com/kivitendo/kivitendo-erp.git
 cd kivitendo-erp/
 git checkout `git tag -l | egrep -ve "(alpha|beta|rc)" | tail -1`</programlisting>
         Erläuterung: Der Befehl wechselt zur letzten Stable-Version (git tag
 cd kivitendo-erp/
 git checkout `git tag -l | egrep -ve "(alpha|beta|rc)" | tail -1`</programlisting>
         Erläuterung: Der Befehl wechselt zur letzten Stable-Version (git tag

-        -l listet alle Tags auf, das egrep schmeisst alle Einträge mit alpha, beta
-        oder rc raus und das tail gibt davon den obersten Treffer zurück).
-        Sehr sinnvoll ist es, direkt im Anschluss einen eigenen Branch zu
-        erzeugen, um bspw. seine eigenen Druckvorlagen-Anpassungen damit zu
-        verwalten. Hierfür reicht ein simples <programlisting>  git checkout -b meine_eigenen_änderungen</programlisting>
+        -l listet alle Tags auf, das egrep schmeisst alle Einträge mit alpha,
+        beta oder rc raus und das tail gibt davon den obersten Treffer
+        zurück). Sehr sinnvoll ist es, direkt im Anschluss einen eigenen
+        Branch zu erzeugen, um bspw. seine eigenen Druckvorlagen-Anpassungen
+        damit zu verwalten. Hierfür reicht ein simples <programlisting>  git checkout -b meine_eigenen_änderungen</programlisting>

         nach dem letzten Kommando (weiterführende Informationen <ulink
         url="http://www-cs-students.stanford.edu/~blynn/gitmagic/index.html">
         Git Magic</ulink>).</para>
         nach dem letzten Kommando (weiterführende Informationen <ulink
         url="http://www-cs-students.stanford.edu/~blynn/gitmagic/index.html">
         Git Magic</ulink>).</para>


@@ -848,32 +856,36 @@ psql template1</programlisting> führen Sie die folgenden Kommandos aus:</para>
 \q</programlisting>
         </note>
       </sect2>
 \q</programlisting>
         </note>
       </sect2>

+

       <sect2 id="Erweiterung-für-trigram">
       <sect2 id="Erweiterung-für-trigram">

-        <title>Erweiterung für Trigraph Prozeduren</title>
+        <title>Erweiterung für Trigram Prozeduren</title>
+
+        <para>Ab Version 3.5.1 wird die Trigram-Index-Erweiterung benötigt.
+        Diese wird mit dem SQL-Updatescript
+        sql/Pg-upgrade2/trigram_extension.sql und Datenbank-Super-Benutzer
+        Rechten automatisch installiert. Dazu braucht der
+        DatenbankSuperbenutzer "postgres" ein Passwort.</para>

 
 

-        <para>In der Datenbank <literal>template1</literal> muss die
-        Unterstützung für Trigram Indexes eingerichet werden.
-        Melden Sie sich dafür als Benutzer “postgres” an der Datenbank an:

         <programlisting>su - postgres
         <programlisting>su - postgres

-psql template1</programlisting> führen Sie die folgenden Kommandos aus:</para>
+psql
+\password postgres

 
 

-        <programlisting>CREATE EXTENSION IF NOT EXISTS pg_trgm;
+Eingabe Passwort

 \q</programlisting>
 
 \q</programlisting>
 

-        <note>
-          <para><literal>pg_trgm</literal> ist je nach Distribution
-          nicht im Standard-Paket von Postgres enthalten. Ein
-
-       <programlisting>select * from pg_available_extensions where name ='pg_trgm';</programlisting>
-        in template1 sollte entsprechend erfolgreich sein.
-        Andernfalls muss das Paket nachinstalliert werden, bspw. bei debian/ubuntu
+        <para>Benutzername Postgres und Passwort können jetzt beim Anlegen
+        einer Datenbank bzw. bei Updatescripten, die SuperuserRechte
+        benötigen, eingegeben werden.</para>

 
 

-        <programlisting>apt install potgresql-contrib</programlisting>
-          </para>
+        <note>
+          <para><literal>pg_trgm</literal> ist je nach Distribution nicht im
+          Standard-Paket von Postgres enthalten. Ein <programlisting>select * from pg_available_extensions where name ='pg_trgm';</programlisting>
+          in template1 sollte entsprechend erfolgreich sein. Andernfalls muss
+          das Paket nachinstalliert werden, bspw. bei debian/ubuntu
+          <programlisting>apt install postgresql-contrib</programlisting></para>

         </note>
       </sect2>
 
         </note>
       </sect2>
 

-

       <sect2 id="Datenbankbenutzer-anlegen">
         <title>Datenbankbenutzer anlegen</title>
 
       <sect2 id="Datenbankbenutzer-anlegen">
         <title>Datenbankbenutzer anlegen</title>
 


@@ -1236,7 +1248,7 @@ Alias       /url/for/kivitendo-erp-fcgid/          /path/to/kivitendo-erp/</prog
 
         <sect3>
           <title>SystemV-basierende Systeme (z.B. ältere Debian, ältere
 
         <sect3>
           <title>SystemV-basierende Systeme (z.B. ältere Debian, ältere

-          OpenSUSE, ältere Fedora)</title>
+          openSUSE, ältere Fedora)</title>

 
           <para>Kopieren Sie die Datei
           <filename>scripts/boot/system-v/kivitendo-task-server</filename>
 
           <para>Kopieren Sie die Datei
           <filename>scripts/boot/system-v/kivitendo-task-server</filename>


@@ -1254,7 +1266,7 @@ insserv kivitendo-task-server</programlisting>
             </listitem>
 
             <listitem>
             </listitem>
 
             <listitem>

-              <para>Ältere OpenSUSE und ältere Fedora:</para>
+              <para>Ältere openSUSE und ältere Fedora:</para>

 
               <programlisting>chkconfig --add kivitendo-task-server</programlisting>
             </listitem>
 
               <programlisting>chkconfig --add kivitendo-task-server</programlisting>
             </listitem>


@@ -8366,11 +8378,14 @@ $self-&gt;{more_texts} = {
         angegeben werden. Der hier angegebene Benutzer muss weiterhin das
         Recht haben, Datenbanken anzulegen und zu löschen.</para>
 
         angegeben werden. Der hier angegebene Benutzer muss weiterhin das
         Recht haben, Datenbanken anzulegen und zu löschen.</para>
 

-        <para>Der so angegebene Benutzer muss nicht zwingend über Super-User-Rechte verfügen. Allerdings gibt es einige Datenbank-Upgrades,
-        die genau diese Rechte benötigen. Für den Fall kann man in diesem Konfigurationsabschnitt einen weiteren Benutzeraccount angeben,
-        der dann über Super-User-Rechte verfügt, und mit dem die betroffenen Upgrades durchgeführt werden. In der
-        Beispiel-Konfigurationsdatei finden Sie die benötigten Parameter.</para>
-
+        <para>Der so angegebene Benutzer muss nicht zwingend über
+        Super-User-Rechte verfügen. Allerdings gibt es einige
+        Datenbank-Upgrades, die genau diese Rechte benötigen. Für den Fall
+        kann man in diesem Konfigurationsabschnitt einen weiteren
+        Benutzeraccount angeben, der dann über Super-User-Rechte verfügt, und
+        mit dem die betroffenen Upgrades durchgeführt werden. In der
+        Beispiel-Konfigurationsdatei finden Sie die benötigten
+        Parameter.</para>

       </sect2>
 
       <sect2 id="devel.testsuite.execution">
       </sect2>
 
       <sect2 id="devel.testsuite.execution">