projekt kivitendo

</Directory>

<DirectoryMatch /path/to/kivitendo-erp/users>

&lt;/DirectoryMatch&gt;</programlisting>

          <warning>

            <programlisting>

  Order Allow,Deny

  Allow from All </programlisting>

          </warning>

          <para>Seit mod_fcgid-Version 2.3.6 gelten sehr kleine Grenzen für

</Directory>

<DirectoryMatch /path/to/kivitendo-erp/users>

&lt;/DirectoryMatch&gt;</pre><div class="warning" title="Warnung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warnung]" src="system/docbook-xsl/images/warning.png"></td><th align="left">Warnung</th></tr><tr><td align="left" valign="top"><p>Wer einen älteren Apache als Version 2.4 im Einsatz hat,

            muss entsprechend die Syntax der Directorydirektiven verändert.

            Statt</p><pre class="programlisting">Require all granted</pre><p>muß man Folgendes einstellen:</p><pre class="programlisting">

  Order Allow,Deny

          die maximale Größe eines Requests. Diese sollte wie folgt

          hochgesetzt werden:</p><pre class="programlisting">FcgidMaxRequestLen 10485760</pre><p>Das Ganze sollte dann so aussehen:</p><pre class="programlisting">AddHandler fcgid-script .fpl

AliasMatch ^/url/for/kivitendo-erp/[^/]+\.pl /path/to/kivitendo-erp/dispatcher.fpl

Alias       /url/for/kivitendo-erp-fcgid/          /path/to/kivitendo-erp/</pre><p>Dann ist unter <code class="filename">/url/for/kivitendo-erp/</code>

          die normale Version erreichbar, und unter

          <code class="constant">/url/for/kivitendo-erp-fcgid/</code> die

        von kivitendo nur über https-verschlüsselten Verbindungen, sowie

        weiteren Zusatzmassnahmen, wie beispielsweise Basic Authenticate. Die

        Konfigurationsmöglichkeiten sprengen allerdings den Rahmen dieser

        Links aus einem der Runlevel-Verzeichnisse heraus in den Boot-Prozess

        einzubinden. Da das bei neueren Linux-Distributionen aber nicht

        zwangsläufig funktioniert, werden auch Start-Scripte mitgeliefert, die

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

          <code class="filename">scripts/boot/system-v/kivitendo-task-server</code>

          nach <code class="filename">/etc/init.d/kivitendo-task-server</code>. Passen

          Boot-Prozess ein. Dies ist distributionsabhängig:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Debian-basierende Systeme:</p><pre class="programlisting">update-rc.d kivitendo-task-server defaults

# Nur bei Debian Squeeze und neuer:

insserv kivitendo-task-server</pre></li><li class="listitem"><p>Ältere OpenSUSE und ältere Fedora:</p><pre class="programlisting">chkconfig --add kivitendo-task-server</pre></li></ul></div><p>Danach kann der Task-Server mit dem folgenden Befehl gestartet

          <code class="filename">scripts/boot/upstart/kivitendo-task-server.conf</code>

          nach <code class="filename">/etc/init/kivitendo-task-server.conf</code>.

          Passen Sie in der kopierten Datei den Pfad zum Task-Server an (Zeile

          <code class="literal">exec ....</code>).</p><p>Danach kann der Task-Server mit dem folgenden Befehl gestartet

          Fedora, neuere Ubuntu und 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

      <code class="literal">users</code>-Verzeichnis, muss vom Webserver beschreibbar

      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

        Aufgaben erfüllen.</p><p>Der Vorlagensatz "rev-odt" enthält solche Vorlagen mit <span class="bold"><strong>Schweizer Bank-Einzahlungsscheinen (BESR)</strong></span>.

        Diese Makros haben die Aufgabe, die in den Einzahlungsscheinen

        benötigte Referenznummer und Kodierzeile zu erzeugen. Hier eine kurze

        Beschreibung, wie die Makros aufgebaut sind, und was bei ihrer Nutzung

        zu beachten ist (<span class="bold"><strong>in fett sind nötige einmalige

          Standardvorlage ohne Einzahlungsschein weitere Vorlagen (z.B. mit

          Einzahlungsschein) auswählbar sind, muss für jedes Vorlagen-Suffix

          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

              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"

          im Rechnungs- bzw. Auftragsformular angezeigt haben möchte, kann

          dies persönlich für sich bei den Benutzereinstellungen

          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

          aus dem von kivitendo erzeugten odt-Dokument die korrekte

          Referenznummer inklusive Prüfziffer sowie die Kodierzeile in

          OCRB-Schrift erzeugen und am richtigen Ort ins Dokument

              angepasst werden.</strong></span> Dabei ist darauf zu achten, dass

              sich die Positionen der Postkonto-Nummern der Bank, sowie der

              Zeichenfolgen dddfr, DDDREF1, DDDREF2, 609, DDDKODIERZEILE nicht

          odt-Rechnung (analog bei Auftrag)</h4></div></div></div><p>Im Fussbereich der Rechnungsmaske muss neben Rechnung,

          OpenDocument/OASIS und Bildschirm die im Adminbereich erstellte

          Druckerbeschreibung ausgewählt werden, falls diese nicht bereits bei

          den Benutzereinstellungen als persönlicher Standard gewählt

          die Meldung kommt, dass Makros aus Sicherheitsgründen nicht

          ausgeführt werden, so müssen folgende Einstellungen in LibreOffice

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

                        <code class="varname">invdate</code>

                     </span></dt><dd><p>Rechnungsdatum</p></dd><dt><span class="term">

                        <code class="varname">invnumber</code>

          Rechnung. Allerdings heißen die Variablen, die mit

          <code class="varname">inv</code> beginnen, jetzt anders. Bei den Angeboten

          fangen sie mit <code class="varname">quo</code> für "quotation" an:

<html><head>

      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

        "main", der von überall erreichbar ist. Darüber hinaus sind bareword

        globs global und die meisten speziellen Variablen sind...

        speziell.</p><p>Daraus ergeben sich folgende Formen:</p><div class="variablelist"><dl><dt><span class="term">

              <code class="varname">$PACKAGE::form</code>.</p></dd><dt><span class="term">

                     <code class="literal">local $form</code>

                  </span></dt><dd><p>Alle Änderungen an <code class="varname">$form</code> werden am Ende

               <span class="productname">SQL-Ledger</span>™ hat fast alles im globalen

        namespace abgelegt, und erwartet, dass es da auch wiederzufinden ist.

        Unter <span class="productname">FCGI</span>™ müssen diese Sachen aber wieder

        dies hat, seit der Einführung, u.a. schon so manche langwierige

        Bug-Suche verkürzt. Da globale Variablen aber implizit mit Package

        angegeben werden, werden die nicht geprüft, und somit kann sich

        globale Variablen, die kanonisch sind, d.h. sie haben bestimmte

        vorgegebenen Eigenschaften, und alles andere sollte anderweitig

        umhergereicht werden.</p><p>Diese Variablen sind im Moment die folgenden neun:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>

                     <code class="varname">$::request</code>

                  </p></li></ul></div><p>Damit diese nicht erneut als Müllhalde missbraucht werden, im

        Folgenden eine kurze Erläuterung der bestimmten vorgegebenen

              "<code class="classname">Form</code>"</p></li><li class="listitem"><p>Wird nach jedem Request gelöscht</p></li><li class="listitem"><p>Muss auch in Tests und Konsolenscripts vorhanden

              sein.</p></li><li class="listitem"><p>Enthält am Anfang eines Requests die Requestparameter vom

              User</p></li><li class="listitem"><p>Kann zwar intern über Requestgrenzen ein Datenbankhandle

  push @{ $form->{TEMPLATE_ARRAYS}{number} },          $form->{"partnumber_$i"};

  push @{ $form->{TEMPLATE_ARRAYS}{description} },     $form->{"description_$i"};

  # ...

              zugegriffen wird</p></li><li class="listitem"><p>Wird bei jedem Request neu erstellt.</p></li><li class="listitem"><p>Enthält die Userdaten des aktuellen Logins</p></li><li class="listitem"><p>Sollte nicht ohne Filterung irgendwo gedumpt werden oder

              extern serialisiert werden, weil da auch der Datenbankzugriff

              für diesen user drinsteht.</p></li><li class="listitem"><p>Enthält unter anderem Listenbegrenzung vclimit,

          überwiegend die Daten, die sich unter <span class="guimenu">Programm</span>

          -&gt; <span class="guimenuitem">Einstellungen</span> befinden, bzw. die

          Informationen über den Benutzer die über die

              sein.</p></li><li class="listitem"><p>Cached intern über Requestgrenzen hinweg benutzte

              Locales</p></li></ul></div><p>Lokalisierung für den aktuellen User. Alle Übersetzungen,

              Funktionen</p></li></ul></div><p>

                  <code class="varname">$::lxdebug</code> stellt Debuggingfunktionen

          bereit, wie "<code class="function">enter_sub</code>" und

          "<code class="function">message</code>" und "<code class="function">dump</code>" mit

          denen man flott Informationen ins Log (tmp/kivitendo-debug.log)

          packen kann.</p><p>Beispielsweise so:</p><pre class="programlisting">$main::lxdebug-&gt;message(0, 'Meine Konfig:' . Dumper (%::myconfig));

                  <code class="varname">$::auth</code> stellt Funktionen bereit um die

          Rechte des aktuellen Users abzufragen. Obwohl diese Informationen

          vom aktuellen User abhängen wird das Objekt aus

          Dessen Einstellungen können über

          <code class="literal">$::auth-&gt;client</code> abgefragt werden; Rückgabewert

          ist ein Hash mit den Werten aus der Tabelle

              "<code class="classname">SL::LxOfficeConf</code>"</p></li><li class="listitem"><p>Global gecached</p></li><li class="listitem"><p>Repräsentation der

              <code class="filename">config/kivitendo.conf[.default]</code>-Dateien</p></li></ul></div><p>Globale Konfiguration. Configdateien werden zum Start gelesen

          und danach nicht mehr angefasst. Es ist derzeit nicht geplant, dass

file_name = /tmp/kivitendo-debug.log</pre><p>ist der Key <code class="varname">file</code> im Programm als

          <code class="varname">$::lx_office_conf-&gt;{debug}{file}</code>

          erreichbar.</p><div class="warning" title="Warnung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warnung]" src="system/docbook-xsl/images/warning.png"></td><th align="left">Warnung</th></tr><tr><td align="left" valign="top"><p>Zugriff auf die Konfiguration erfolgt im Moment über

              "<code class="classname">SL::InstanceConfiguration</code>"</p></li><li class="listitem"><p>wird pro Request neu erstellt</p></li></ul></div><p>Funktioniert wie <code class="varname">$::lx_office_conf</code>,

          speichert aber Daten die von der Instanz abhängig sind. Eine Instanz

          ist hier eine Mandantendatenbank. Beispielsweise überprüft

          </p><pre class="programlisting">$::instance_conf-&gt;get_inventory_system eq 'perpetual'</pre><p>

              "<code class="varname">SL::Dispatcher</code>"</p></li><li class="listitem"><p>wird pro Serverprozess erstellt.</p></li><li class="listitem"><p>enthält Informationen über die technische Verbindung zum

              Server</p></li></ul></div><p>Der dritte Punkt ist auch der einzige Grund warum das Objekt

          global gespeichert wird. Wird vermutlich irgendwann in einem anderen

                  <code class="varname">$::request</code> ist ein generischer Platz um

          Daten "für den aktuellen Request" abzulegen. Sollte nicht für action

          at a distance benutzt werden, sondern um lokales memoizing zu

              <code class="varname">$::request</code>

                     </p></li><li class="listitem"><p>Muss ich von anderen Teilen des Programms lesend drauf

              zugreifen? Dann <code class="varname">$::request</code>, aber Zugriff über

              Klassenfunktionen funktionieren</p></li><li class="listitem"><p>Aufruf als Klasse erzeugt Dummyobjekt was im

              Klassennamespace gehalten wird und über Requestgrenzen

              leaked</p></li><li class="listitem"><p>liegt jetzt unter

              <code class="varname">$::request-&gt;{cgi}</code>

              ein paar hundert mal pro Request eine Liste der Einheiten

              brauchen, und de als Parameter durch einen Riesenstack von

              Funktionen geschleift werden müssten.</p></li><li class="listitem"><p>Liegt jetzt unter

              <code class="varname">$::request-&gt;{cache}{all_units}</code>

                     </p></li><li class="listitem"><p>Wird nur in

              <code class="function">AM-&gt;retrieve_all_units()</code> gesetzt oder

              abzufangen.</p></li><li class="listitem"><p>Wurde entfernt, weil callsub nur einen Bruchteil der

              möglichen Rekursioenen darstellt, und da nie welche

              auftreten.</p></li><li class="listitem"><p>komplette recursion protection wurde entfernt.</p></li></ul></div></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s06.html">Zurück</a>&nbsp;</td><td width="20%" align="center">&nbsp;</td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch04s02.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">3.6. Schweizer Kontenpläne&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;4.2. Entwicklung unter FastCGI</td></tr></table></div></body></html>

<html><head>

      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

      EUR</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s14.html#config.eur.introduction">2.14.1. Einführung</a></span></dt><dt><span class="sect2"><a href="ch02s14.html#config.eur.parameters">2.14.2. Konfigurationsparameter</a></span></dt><dt><span class="sect2"><a href="ch02s14.html#config.eur.setting-parameters">2.14.3. Festlegen der Parameter</a></span></dt><dt><span class="sect2"><a href="ch02s14.html#config.eur.inventory-system-perpetual">2.14.4. Bemerkungen zur Bestandsmethode</a></span></dt><dt><span class="sect2"><a href="ch02s14.html#config.eur.knonw-issues">2.14.5. Bekannte Probleme</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s15.html">2.15. SKR04 19% Umstellung für innergemeinschaftlichen Erwerb</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s15.html#config.skr04-update-3804.introduction">2.15.1. Einführung</a></span></dt><dt><span class="sect2"><a href="ch02s15.html#config.skr04-update-3804.create-chart">2.15.2. Konto 3804 manuell anlegen</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s16.html">2.16. Verhalten des Bilanzberichts</a></span></dt><dt><span class="sect1"><a href="ch02s17.html">2.17. Erfolgsrechnung</a></span></dt><dt><span class="sect1"><a href="ch02s18.html">2.18. Rundung in Verkaufsbelegen</a></span></dt><dt><span class="sect1"><a href="ch02s19.html">2.19. Einstellungen pro Mandant</a></span></dt><dt><span class="sect1"><a href="ch02s20.html">2.20. kivitendo ERP verwenden</a></span></dt></dl></dd><dt><span class="chapter"><a href="ch03.html">3. Features und Funktionen</a></span></dt><dd><dl><dt><span class="sect1"><a href="ch03.html#features.periodic-invoices">3.1. Wiederkehrende Rechnungen</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch03.html#features.periodic-invoices.introduction">3.1.1. Einführung</a></span></dt><dt><span class="sect2"><a href="ch03.html#features.periodic-invoices.configuration">3.1.2. Konfiguration</a></span></dt><dt><span class="sect2"><a href="ch03.html#features.periodic-invoices.variables">3.1.3. Spezielle Variablen</a></span></dt><dt><span class="sect2"><a href="ch03.html#features.periodic-invoices.reports">3.1.4. Auflisten</a></span></dt><dt><span class="sect2"><a href="ch03.html#features.periodic-invoices.task-server">3.1.5. Erzeugung der eigentlichen Rechnungen</a></span></dt><dt><span class="sect2"><a href="ch03.html#features.periodic-invoices.create-for-current-month">3.1.6. Erste Rechnung für aktuellen Monat erstellen</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch03s02.html">3.2. Bankerweiterung</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch03s02.html#features.bank.introduction">3.2.1. Einführung</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch03s03.html">3.3. Dokumentenvorlagen und verfügbare Variablen</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch03s03.html#dokumentenvorlagen-und-variablen.einf%C3%BChrung">3.3.1. Einführung</a></span></dt><dt><span class="sect2"><a href="ch03s03.html#dokumentenvorlagen-und-variablen.variablen-ausgeben">3.3.2. Variablen ausgeben</a></span></dt><dt><span class="sect2"><a href="ch03s03.html#dokumentenvorlagen-und-variablen.verwendung-in-druckbefehlen">3.3.3. Verwendung in Druckbefehlen</a></span></dt><dt><span class="sect2"><a href="ch03s03.html#dokumentenvorlagen-und-variablen.tag-style">3.3.4. Anfang und Ende der Tags verändern</a></span></dt><dt><span class="sect2"><a href="ch03s03.html#dokumentenvorlagen-und-variablen.zuordnung-dateinamen">3.3.5. Zuordnung von den Dateinamen zu den Funktionen</a></span></dt><dt><span class="sect2"><a href="ch03s03.html#dokumentenvorlagen-und-variablen.dateinamen-erweitert">3.3.6. Sprache, Drucker und E-Mail</a></span></dt><dt><span class="sect2"><a href="ch03s03.html#dokumentenvorlagen-und-variablen.allgemeine-variablen">3.3.7. Allgemeine Variablen, die in allen Vorlagen vorhanden

        sind</a></span></dt><dt><span class="sect2"><a href="ch03s03.html#dokumentenvorlagen-und-variablen.invoice">3.3.8. Variablen in Rechnungen</a></span></dt><dt><span class="sect2"><a href="ch03s03.html#dokumentenvorlagen-und-variablen.dunning">3.3.9. Variablen in Mahnungen und Rechnungen über Mahngebühren</a></span></dt><dt><span class="sect2"><a href="ch03s03.html#dokumentenvorlagen-und-variablen.andere-vorlagen">3.3.10. Variablen in anderen Vorlagen</a></span></dt><dt><span class="sect2"><a href="ch03s03.html#dokumentenvorlagen-und-variablen.bloecke">3.3.11. Blöcke, bedingte Anweisungen und Schleifen</a></span></dt><dt><span class="sect2"><a href="ch03s03.html#dokumentenvorlagen-und-variablen.markup">3.3.12. Markup-Code zur Textformatierung innerhalb von

        Datenbankupgradescripten</a></span></dt><dt><span class="sect2"><a href="ch04s03.html#db-upgrade-files.dbupgrade-tool">4.3.4. Hilfsscript dbupgrade2_tool.pl</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch04s04.html">4.4. Translations and languages</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch04s04.html#translations-languages.introduction">4.4.1. Introduction</a></span></dt><dt><span class="sect2"><a href="ch04s04.html#translations-languages.character-set">4.4.2. Character set</a></span></dt><dt><span class="sect2"><a href="ch04s04.html#translations-languages.file-structure">4.4.3. File structure</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch04s05.html">4.5. Die kivitendo-Test-Suite</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch04s05.html#devel.testsuite.intro">4.5.1. Einführung</a></span></dt><dt><span class="sect2"><a href="ch04s05.html#devel.testsuite.prerequisites">4.5.2. Voraussetzungen</a></span></dt><dt><span class="sect2"><a href="ch04s05.html#devel.testsuite.execution">4.5.3. Existierende Tests ausführen</a></span></dt><dt><span class="sect2"><a href="ch04s05.html#devel.testsuite.meaning_of_scripts">4.5.4. Bedeutung der verschiedenen Test-Scripte</a></span></dt><dt><span class="sect2"><a href="ch04s05.html#devel.testsuite.create_new">4.5.5. Neue Test-Scripte erstellen</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch04s06.html">4.6. Stil-Richtlinien</a></span></dt><dt><span class="sect1"><a href="ch04s07.html">4.7. Dokumentation erstellen</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch04s07.html#devel.build-doc.introduction">4.7.1. Einführung</a></span></dt><dt><span class="sect2"><a href="ch04s07.html#devel.build-doc.required-software">4.7.2. Benötigte Software</a></span></dt><dt><span class="sect2"><a href="ch04s07.html#devel.build-doc.build">4.7.3. PDFs und HTML-Seiten erstellen</a></span></dt><dt><span class="sect2"><a href="ch04s07.html#devel.build-doc.repository">4.7.4. Einchecken in das Git-Repository</a></span></dt></dl></dd></dl></dd></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left">&nbsp;</td><td width="20%" align="center">&nbsp;</td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch01.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">&nbsp;</td><td width="20%" align="center">&nbsp;</td><td width="40%" align="right" valign="top">&nbsp;Kapitel 1. Aktuelle Hinweise</td></tr></table></div></body></html>