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

&lt;/Directory&gt;

&lt;DirectoryMatch /path/to/kivitendo-erp/users&gt;

&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-&gt;{TEMPLATE_ARRAYS}{number} }, $form-&gt;{"partnumber_$i"};

push @{ $form-&gt;{TEMPLATE_ARRAYS}{description} }, $form-&gt;{"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>