projekt kivitendo

{ name => "CGI", version => '3.43', url => "http://search.cpan.org/~leejo/", debian => 'libcgi-pm-perl' }, # 4.09 is not core anymore (perl 5.20)

{ name => "Clone", url => "http://search.cpan.org/~rdf/", debian => 'libclone-perl' },

{ name => "Config::Std", url => "http://search.cpan.org/~dconway/", debian => 'libconfig-std-perl' },

{ name => "DateTime", url => "http://search.cpan.org/~drolsky/", debian => 'libdatetime-perl' },

{ name => "DateTime::Format::Strptime", url => "http://search.cpan.org/~drolsky/", debian => 'libdatetime-format-strptime-perl' },

{ name => "DateTime::Set", version => '0.12', url => "http://search.cpan.org/~fglock/", debian => 'libdatetime-set-perl' },

{ name => "DBI", version => '1.50', url => "http://search.cpan.org/~timb/", debian => 'libdbi-perl' },

{ name => "DBD::Pg", version => '1.49', url => "http://search.cpan.org/~dbdpg/", debian => 'libdbd-pg-perl' },

{ name => "Digest::SHA", url => "http://search.cpan.org/~mshelor/", debian => 'libdigest-sha-perl' },

{ name => "Email::Address", version => '1.888', url => "http://search.cpan.org/~rjbs/", debian => 'libemail-address-perl' },

{ name => "Email::MIME", url => "http://search.cpan.org/~rjbs/", debian => 'libemail-mime-perl' },

{ name => "FCGI", version => '0.72', url => "http://search.cpan.org/~mstrout/", debian => 'libfcgi-perl' },

{ name => "File::Copy::Recursive", url => "http://search.cpan.org/~dmuey/", debian => 'libfile-copy-recursive-perl' },

{ name => "File::MimeInfo", url => "http://search.cpan.org/~michielb/", debian => 'libfile-mimeinfo-perl' },

{ name => "GD", url => "http://search.cpan.org/~lds/", debian => 'libgd-gd2-perl', },

{ name => 'HTML::Parser', url => 'http://search.cpan.org/~gaas/', debian => 'libhtml-parser-perl', },

{ name => "Image::Info", url => "http://search.cpan.org/~srezic/", debian => 'libimage-info-perl' },

{ name => "JSON", url => "http://search.cpan.org/~makamaka", debian => 'libjson-perl' },

{ name => "List::MoreUtils", version => '0.30', url => "http://search.cpan.org/~vparseval/", debian => 'liblist-moreutils-perl' },

{ name => "Rose::Object", url => "http://search.cpan.org/~jsiracusa/", debian => 'librose-object-perl' },

{ name => "Rose::DB", url => "http://search.cpan.org/~jsiracusa/", debian => 'librose-db-perl' },

{ name => "Rose::DB::Object", version => 0.788, url => "http://search.cpan.org/~jsiracusa/", debian => 'librose-db-object-perl' },

{ name => "Set::Crontab", version => '1.03', url => "http://search.cpan.org/~ams/", },

{ name => "String::ShellQuote", version => 1.01, url => "http://search.cpan.org/~rosch/", debian => 'libstring-shellquote-perl' },

{ name => "Sort::Naturally", url => "http://search.cpan.org/~sburke/", debian => 'libsort-naturally-perl' },

Einige Default-Module die als Fallback zu Verfügung standen, werden ab

dieser Version nicht mehr mit ausgeliefert.

und die entsprechenden Module installieren.

ohne große Probleme auf den derzeit aktuellen verbreiteten

Distributionen läuft.</para>

dass kivitendo auf ihnen läuft:</para>

<itemizedlist>

<listitem>

<para>8.0 "Jessie"</para>

</listitem>

</itemizedlist>

</listitem>

<listitem>

</listitem>

<listitem>

<para><literal>YAML</literal></para>

</listitem>

</itemizedlist>

<para>Seit Version größer v3.5.0 sind die folgenden Pakete

hinzugekommen: <literal>Text::Unidecode</literal>,

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\

</programlisting>

<para>Ab Ubuntu Version 18.04 LTS sind alle benötigten Pakete in der Distributions verfügbar.</para>

Das geht bspw. für das benötige Paket HTML::Restrict mit:</para>

<programlisting>apt-get install build-essential

<itemizedlist>

<listitem>

</listitem>

<listitem>

</listitem>

<listitem>

</listitem>

</itemizedlist>

<para>Als Perl Backend wird das Modul <filename>FCGI.pm</filename>

verwendet.</para>

diese Version im speziellen auf Debian und Ubuntu, grundsätzlich wurde

bei der Auswahl der Pakete aber darauf Rücksicht genommen, dass es

ohne große Probleme auf den derzeit aktuellen verbreiteten

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

<code class="literal">XML::Writer</code>

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

<code class="literal">YAML</code>

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

<code class="literal">LWP::Authen::Digest</code>,

<code class="literal">LWP::UserAgent</code>

sind auch in 2.6.1 weiterhin mit ausgeliefert, wurden in einer

zukünftigen Version aber aus dem Paket entfernt werden. Es wird

empfohlen diese Module zusammen mit den anderen als Bibliotheken zu

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

folgendem Befehl installiert werden:</p><pre class="programlisting">apt install apache2 libarchive-zip-perl libclone-perl \

libconfig-std-perl libdatetime-perl libdbd-pg-perl libdbi-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\

Das geht bspw. für das benötige Paket HTML::Restrict mit:</p><pre class="programlisting">apt-get install build-essential

RPM-Pakete zur Verfügung. Sie können mit folgendem Befehl

installiert werden:</p><pre class="programlisting">dnf install httpd mod_fcgid perl-Archive-Zip perl-Clone perl-DBD-Pg \

perl-DBI perl-DateTime perl-Email-Address perl-Email-MIME perl-FCGI \

perl-Template-Toolkit perl-Text-CSV_XS perl-Text-Iconv perl-URI \

perl-XML-Writer perl-YAML perl-parent postgresql-server perl-CPAN \

perl-Algorithm-CheckDigits perl-GD perl-Class-XSAccessor perl-Text-Balanced perl-libwww-perl</pre><p>Zusätzlich müssen einige Pakete aus dem CPAN installiert

RPM-Pakete zur Verfügung. Sie können mit folgendem Befehl

installiert werden:</p><pre class="programlisting">zypper install apache2 apache2-mod_fcgid perl-Archive-Zip perl-Clone \

perl-Config-Std perl-DBD-Pg perl-DBI perl-DateTime perl-Email-Address \

perl-Sort-Naturally perl-Template-Toolkit perl-Text-CSV_XS perl-Text-Iconv \

perl-URI perl-XML-Writer perl-YAML perl-CPAN \

perl-Algorithm-CheckDigits perl-GD perl-Class-XSAccessor postgresql-server perl-libwwww-perl</pre><p>Zusätzlich müssen einige Pakete aus dem CPAN installiert

'aqbanking-tools' benötigt.</p><p>Debian und Ubuntu: </p><pre class="programlisting">apt install aqbanking-tools

</pre><p>

</p><p>Fedora: </p><pre class="programlisting">dnf install aqbanking</pre><p>

<html><head>

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

mittels FastCGI/FCGI. Die Einrichtung wird ausführlich im Abschnitt

<a class="xref" href="ch02s06.html#Apache-Konfiguration.FCGI" title="2.6.2. Konfiguration für FastCGI/FCGI">Konfiguration für FastCGI/FCGI</a> beschrieben.</p></td></tr></table></div><p>Der Zugriff auf das Programmverzeichnis muss in der Apache

Webserverkonfigurationsdatei <code class="literal">httpd.conf</code> eingestellt

führt dazu dass ein kivitendo Aufruf der Kernmasken mittlerweile

deutlich länger dauert als früher, und dass davon 90% für das Laden

der Module verwendet wird.</p><p>Mit FastCGI werden nun die Module einmal geladen, und danach

verwendet.</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>FCGI-Versionen ab 0.69 und bis zu 0.71 inklusive sind extrem

strict in der Behandlung von Unicode, und verweigern bestimmte

Eingaben von kivitendo. Falls es Probleme mit Umlauten in Ihrer

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

openSUSE, ä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

<code class="literal">DAEMON=....</code>). Binden Sie das Script in den

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

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

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

<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

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 der

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

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 auswählen

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 → Makrosicherheit</p></li><li class="listitem"><p>Sicherheitslevel auf "Mittel" einstellen (Diese

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

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

existierenden Artikel verwendet und ist gültig für Verkauf und

Einkauf)</p></li></ul></div><p>Es können weitere Klassifizierungen angelegt werden. So kann es

alle gleichzeitg gültig sein können</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>gültig für Verkauf - dieser Artikel kann im Verkauf genutzt

werden</p></li><li class="listitem"><p>gültig für Einkauf - dieser Artikel kann im Einkauf genutzt

werden</p></li><li class="listitem"><p>separat ausweisen - hierzu gibt es zur Dokumentengenerierung

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

Verpackungsmaterial <span class="bold"><strong>

Buchstaben dargestellt. Der erste Buchstabe ist eine Lokalisierung des

Artikel-Typs ('P','A','S'), deutsch 'W', 'E', und 'D' für Ware

Erzeugnis oder Dienstleistung und ggf. weiterer Typen.</p><p>Der zweite Buchstabe (und ggf. auch ein dritter, falls nötig)

<html><head>

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

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

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

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

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

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

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

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

<html><head>

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

Onlineshopbestellungen zu verwalten und zu bearbeiten.</p><p>Es ist Multishopfähig, d.h. Artikel können mehreren oder

unterschiedlichen Shops zugeordnet werden. Bestellungen können aus

mehreren Shops geholt werden.</p><p>Zur Zeit bietet das Modul nur einen Connector zur REST-Api von

Shopware. Weitere Connectoren können dazu programmiert und eingerichtet

Markers <span class="bold"><strong>"Shopartikel" in den Basisdaten

</strong></span>zeigt sich der Reiter "Shopvariablen" in den

Artikelstammdaten. Hier können jetzt die Artikel mit

Stelle können auch beliebig viele Bilder dem Shopartikel zugeordnet

werden. Artikelbilder gelten für alle Shops.</p><div class="mediaobject"><img src="images/Shop_Artikel.png"></div><p>Die Artikelgruppen werden direkt vom Shopsystem geholt somit

ist es möglich einen Artikel auch mehreren Gruppen

eine Gesamtübersicht. Von hier aus ist es möglich Artikel im Stapel

unter verschiedenen Kriterien &lt;alles&gt;&lt;nur Preis&gt;&lt;nur

Bestand&gt;&lt;Preis und Bestand&gt; an die jeweiligen Shops

Bestellimportsliste. Hier ist sind Möglichkeiten gegeben Neue

Bestellungen vom Shop abzuholen, geholte Bestellungen im Stapel oder

einzeln als Auftrag zu transferieren. Die Liste kann nach

auch der Grund für die Auftragssperre sein.</p></li><li class="listitem"><p>Die Buttons "Auftrag erstellen" und "Kunde mit

Rechnungsadresse überschreiben" zeigen sich erst, wenn ein Kunde

aus dem Listing ausgewählt ist.</p></li><li class="listitem"><p>Es ist aber möglich die Shopbestellung zu löschen.</p></li><li class="listitem"><p>Ist eine Bestellung schon übernommen, zeigen sich an dieser

der Datei SL/ShopConnector/&lt;SHOPCONNECTORNAME&gt;.pm

z.B.:SL/ShopConnector/Shopware.pm</p><p>In dieser Datei gibt es einen Bereich wo die Bestellpostionen,

die Bestellkopfdaten und die Artikeldaten gemapt werden. In dieser

<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 Datumsformat dateformat und

ü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="ch03s09.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.9. Webshop-Api&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>

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

<title>kivitendo 3.5.1: Installation, Konfiguration, Entwicklung</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.1: Installation, Konfiguration, Entwicklung"><link rel="next" href="ch01.html" title="Kapitel 1. Aktuelle Hinweise"></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">kivitendo 3.5.1: Installation, Konfiguration,

Entwicklung</th></tr><tr><td width="20%" align="left">&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch01.html">Weiter</a></td></tr></table><hr></div><div lang="de" class="book" title="kivitendo 3.5.1: Installation, Konfiguration, Entwicklung"><div class="titlepage"><div><div><h1 class="title"><a name="kivitendo-documentation"></a>kivitendo 3.5.1: Installation, Konfiguration,

EUR</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s15.html#config.eur.introduction">2.15.1. Einführung</a></span></dt><dt><span class="sect2"><a href="ch02s15.html#config.eur.parameters">2.15.2. Konfigurationsparameter</a></span></dt><dt><span class="sect2"><a href="ch02s15.html#config.eur.setting-parameters">2.15.3. Festlegen der Parameter</a></span></dt><dt><span class="sect2"><a href="ch02s15.html#config.eur.inventory-system-perpetual">2.15.4. Bemerkungen zur Bestandsmethode</a></span></dt><dt><span class="sect2"><a href="ch02s15.html#config.eur.knonw-issues">2.15.5. Bekannte Probleme</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s16.html">2.16. SKR04 19% Umstellung für innergemeinschaftlichen Erwerb</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s16.html#config.skr04-update-3804.introduction">2.16.1. Einführung</a></span></dt><dt><span class="sect2"><a href="ch02s16.html#config.skr04-update-3804.create-chart">2.16.2. Konto 3804 manuell anlegen</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s17.html">2.17. Verhalten des Bilanzberichts</a></span></dt><dt><span class="sect1"><a href="ch02s18.html">2.18. Erfolgsrechnung</a></span></dt><dt><span class="sect1"><a href="ch02s19.html">2.19. Rundung in Verkaufsbelegen</a></span></dt><dt><span class="sect1"><a href="ch02s20.html">2.20. Einstellungen pro Mandant</a></span></dt><dt><span class="sect1"><a href="ch02s21.html">2.21. 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>