Revision f8309cb7
Von Moritz Bunkus vor fast 13 Jahren hinzugefügt
| doc/html/ch01.html | ||
|---|---|---|
| 1 |
<html><head> |
|
| 2 |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
|
| 3 |
<title>Kapitel 1. Aktuelle Hinweise</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="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="index.html" title="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="prev" href="index.html" title="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="next" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"></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">Kapitel 1. Aktuelle Hinweise</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="index.html">Zur?ck</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch02.html">Weiter</a></td></tr></table><hr></div><div class="chapter" title="Kapitel 1. Aktuelle Hinweise"><div class="titlepage"><div><div><h2 class="title"><a name="Aktuelle-Hinweise"></a>Kapitel 1. Aktuelle Hinweise</h2></div></div></div><p>Aktuelle Installations- und Konfigurationshinweise gibt es:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>auf der Lx-Office-Homepage unter <a class="ulink" href="http://lx-office.org/index.php?id=dokumentation" target="_top">http://lx-office.org/index.php?id=dokumentation</a> |
|
| 4 |
</p></li><li class="listitem"><p>im Lx-Office-Wiki unter Dokumentation (<a class="ulink" href="http://wiki.lx-office.org/index.php/Lx-Office_ERP" target="_top">http://wiki.lx-office.org/index.php/Lx-Office_ERP</a>)</p></li><li class="listitem"><p>im Lx-Office-Forum: <a class="ulink" href="http://www.lx-office.org/forum/" target="_top">http://www.lx-office.org/forum/</a> |
|
| 5 |
</p></li></ul></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="index.html">Zur?ck</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch02.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">Lx-Office: Installation, Konfiguration, Entwicklung </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> Kapitel 2. Installation und Grundkonfiguration</td></tr></table></div></body></html> |
|
| doc/html/ch02.html | ||
|---|---|---|
| 1 |
<html><head> |
|
| 2 |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
|
| 3 |
<title>Kapitel 2. Installation und Grundkonfiguration</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="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="index.html" title="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="prev" href="ch01.html" title="Kapitel 1. Aktuelle Hinweise"><link rel="next" href="ch02s02.html" title="2.2. Manuelle Installation des Programmpaketes"></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">Kapitel 2. Installation und Grundkonfiguration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01.html">Zur?ck</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch02s02.html">Weiter</a></td></tr></table><hr></div><div class="chapter" title="Kapitel 2. Installation und Grundkonfiguration"><div class="titlepage"><div><div><h2 class="title"><a name="config"></a>Kapitel 2. Installation und Grundkonfiguration</h2></div></div></div><div class="sect1" title="2.1. Ben?tigte Software und Pakete"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Ben%C3%B6tigte-Software-und-Pakete"></a>2.1. Ben?tigte Software und Pakete</h2></div></div></div><div class="sect2" title="2.1.1. Betriebssystem"><div class="titlepage"><div><div><h3 class="title"><a name="Betriebssystem"></a>2.1.1. Betriebssystem</h3></div></div></div><p>Lx-Office ist f?r Linux konzipiert, und sollte auf jedem |
|
| 4 |
unixoiden Betriebssystem zum Laufen zu kriegen sein. Getestet ist |
|
| 5 |
diese Version im speziellen auf Debian und Ubuntu, grunds?tzlich wurde |
|
| 6 |
bei der Auswahl der Pakete aber darauf R?cksicht genommen, dass es |
|
| 7 |
ohne gro?e Probleme auf den derzeit aktuellen verbreiteten |
|
| 8 |
Distributionen l?uft.</p><p>Anfang 2012 sind das folgende Systeme, von denen bekannt ist, dass Lx-Office auf ihnen l?uft:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Ubuntu 8.04 LTS Hardy Heron, 10.04 LTS Lucid Lynx bis 11.10 Oneiric Ocelot</p></li><li class="listitem"><p>Debian 5.0 Lenny und 6.0 Squeeze</p></li><li class="listitem"><p>openSUSE 11.2 und 11.3</p></li><li class="listitem"><p>SuSE Linux Enterprice Server 11</p></li><li class="listitem"><p>Fedora 13 bis 15</p></li></ul></div><p>Ubuntu 8.04 LTS hat zus?tzlich die Schwierigkeit, dass die |
|
| 9 |
Module im Archiv recht alt sind, und das viele der ben?tigten Module |
|
| 10 |
nicht einfach zu installieren sind. Daf?r sollte es kurz nach dem |
|
| 11 |
Release ein eigenes .deb geben.</p><p>Alternativ dazu kann die normale Installation durchgef?hrt |
|
| 12 |
werden (siehe <a class="xref" href="ch02s02.html" title="2.2. Manuelle Installation des Programmpaketes">Manuelle Installation des Programmpaketes</a>), wenn vorher |
|
| 13 |
ein Kompatibilit?tspaket installiert wird, das die fehlenden Pakete |
|
| 14 |
bereitstellt. Das Paket ist auf <a class="ulink" href="https://sourceforge.net/projects/lx-office/files/Lx-Office%20ERP/2.6.2/" target="_top">Sourceforge</a> |
|
| 15 |
unter dem Namen <code class="filename">lx-erp-perl-libs-compat-v2.tar.gz</code> |
|
| 16 |
hinterlegt.</p><p>Zur Installation das Paket in das entpackte Lx-Office |
|
| 17 |
Verzeichnis entpacken:</p><pre class="programlisting">tar xzf lx-erp-perl-libs-compat-v2.tar.gz /path/to/lx-office/</pre><p>Zus?tzlich m?ssen dann noch die folgenden Pakete installiert |
|
| 18 |
weerden</p><pre class="programlisting">apt-get install libbit-vector-perl libsub-exporter-perl libclone-perl libclass-factory-util-perl</pre><p>Danach sollte der Installationscheck (siehe <a class="xref" href="ch02.html#Pakete" title="2.1.2. Pakete">Pakete</a>) die enthaltenen Pakete erkennen.</p></div><div class="sect2" title="2.1.2. Pakete"><div class="titlepage"><div><div><h3 class="title"><a name="Pakete"></a>2.1.2. Pakete</h3></div></div></div><p>Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist |
|
| 19 |
Apache) und ein Datenbankserver (PostgreSQL, mindestens v8.2) |
|
| 20 |
ben?tigt.</p><p>Zus?tzlich ben?tigt Lx-Office die folgenden Perl-Pakete, die |
|
| 21 |
nicht Bestandteil einer Standard-Perl-Installation sind:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>parent</p></li><li class="listitem"><p>Archive::Zip</p></li><li class="listitem"><p>Config::Std</p></li><li class="listitem"><p>DateTime</p></li><li class="listitem"><p>DBI</p></li><li class="listitem"><p>DBD::Pg</p></li><li class="listitem"><p>Email::Address</p></li><li class="listitem"><p>JSON</p></li><li class="listitem"><p>List::MoreUtils</p></li><li class="listitem"><p>Params::Validate</p></li><li class="listitem"><p>PDF::API2</p></li><li class="listitem"><p>Rose::Object</p></li><li class="listitem"><p>Rose::DB</p></li><li class="listitem"><p>Rose::DB::Object</p></li><li class="listitem"><p>Template</p></li><li class="listitem"><p>Text::CSV_XS</p></li><li class="listitem"><p>Text::Iconv</p></li><li class="listitem"><p>URI</p></li><li class="listitem"><p>XML::Writer</p></li><li class="listitem"><p>YAML</p></li></ul></div><p>Gegen?ber Version 2.6.0 sind zu dieser Liste 2 Pakete |
|
| 22 |
hinzugekommen, <code class="literal">URI</code> und |
|
| 23 |
<code class="literal">XML::Writer</code> sind notwendig. Ohne startet Lx-Office |
|
| 24 |
nicht.</p><p>Gegen?ber Version 2.6.1 sind <code class="literal">parent</code>, |
|
| 25 |
<code class="literal">DateTime</code>, <code class="literal">Rose::Object</code>, |
|
| 26 |
<code class="literal">Rose::DB</code> und <code class="literal">Rose::DB::Object</code> |
|
| 27 |
neu hinzugekommen. <code class="literal">IO::Wrap</code> wurde entfernt.</p><p>Gegen?ber Version 2.6.3 ist <code class="literal">JSON</code> neu |
|
| 28 |
hinzugekommen.</p><p> |
|
| 29 |
<code class="literal">Email::Address</code> und |
|
| 30 |
<code class="literal">List::MoreUtils</code> sind schon l?nger feste |
|
| 31 |
Abh?ngigkeiten, wurden aber bisher mit Lx-Office mitgeliefert. Beide |
|
| 32 |
sind auch in 2.6.1 weiterhin mit ausgeliefert, wurden in einer |
|
| 33 |
zuk?nftigen Version aber aus dem Paket entfernt werden. Es wird |
|
| 34 |
empfohlen diese Module zusammen mit den anderen als Bibliotheken zu |
|
| 35 |
installieren.</p><p>Die zu installierenden Pakete k?nnen in den verschiedenen |
|
| 36 |
Distributionen unterschiedlich hei?en.</p><p>F?r Debian oder Ubuntu ben?tigen Sie diese Pakete:</p><pre class="programlisting">apt-get install apache2 postgresql libparent-perl libarchive-zip-perl \ |
|
| 37 |
libdatetime-perl libdbi-perl libdbd-pg-perl libpg-perl \ |
|
| 38 |
libemail-address-perl liblist-moreutils-perl libpdf-api2-perl \ |
|
| 39 |
librose-object-perl librose-db-perl librose-db-object-perl \ |
|
| 40 |
libtemplate-perl libtext-csv-xs-perl libtext-iconv-perl liburi-perl \ |
|
| 41 |
libxml-writer-perl libyaml-perl libconfig-std-perl \ |
|
| 42 |
libparams-validate-perl libjson-perl</pre><p>F?r Fedora Core ben?tigen Sie diese Pakete:</p><pre class="programlisting">yum install httpd postgresql-server perl-parent perl-DateTime \ |
|
| 43 |
perl-DBI perl-DBD-Pg perl-Email-Address perl-List-MoreUtils \ |
|
| 44 |
perl-PDF-API2 perl-Rose-Object perl-Rose-DB perl-Rose-DB-Object \ |
|
| 45 |
perl-Template-Toolkit perl-Text-CSV_XS perl-Text-Iconv perl-URI \ |
|
| 46 |
perl-XML-Writer perl-YAML</pre><p>F?r OpenSuSE ben?tigen Sie diese Pakete:</p><pre class="programlisting">zypper install apache2 postgresql-server perl-Archive-Zip \ |
|
| 47 |
perl-DateTime perl-DBI perl-DBD-Pg perl-MailTools perl-List-MoreUtils \ |
|
| 48 |
perl-PDF-API2 perl-Template-Toolkit perl-Text-CSV_XS perl-Text-Iconv \ |
|
| 49 |
perl-URI perl-XML-Writer perl-YAML</pre><p>Bei openSuSE 11 ist <code class="literal">parent</code> bereits enthalten, |
|
| 50 |
und braucht nicht nachinstalliert werden. Die |
|
| 51 |
<code class="literal">Rose::*</code> Pakete sind derzeit nicht f?r SuSE gepackt, |
|
| 52 |
und m?ssen anderweitig nachinstalliert werden.</p><p>Lx-Office enth?lt ein Script, mit dem ?berpr?ft werden kann, ob |
|
| 53 |
alle ben?tigten Perl-Module installiert sind. Der Aufruf lautet wie |
|
| 54 |
folgt:</p><pre class="programlisting">./scripts/installation_check.pl</pre></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch01.html">Zur?ck</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch02s02.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">Kapitel 1. Aktuelle Hinweise </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.2. Manuelle Installation des Programmpaketes</td></tr></table></div></body></html> |
|
| doc/html/ch02s02.html | ||
|---|---|---|
| 1 |
<html><head> |
|
| 2 |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
|
| 3 |
<title>2.2. Manuelle Installation des Programmpaketes</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="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="next" href="ch02s03.html" title="2.3. Lx-Office-Konfigurationsdatei"></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">2.2. Manuelle Installation des Programmpaketes</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02.html">Zur?ck</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s03.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.2. Manuelle Installation des Programmpaketes"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Manuelle-Installation-des-Programmpaketes"></a>2.2. Manuelle Installation des Programmpaketes</h2></div></div></div><p>Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.6.3.tgz) wird |
|
| 4 |
im Dokumentenverzeichnis des Webservers (z.B. |
|
| 5 |
<code class="filename">/var/www/html/</code>, |
|
| 6 |
<code class="filename">/srv/www/htdocs</code> oder |
|
| 7 |
<code class="filename">/var/www/</code>) entpackt:</p><pre class="programlisting">cd /var/www tar xvzf |
|
| 8 |
lxoffice-erp-2.6.2.tgz</pre><p>Ver?ndern Sie evtl. noch den Namen des Verzeichnisses mit</p><pre class="programlisting">mv lxoffice-erp/ lx-erp/</pre><p>Alternativ k?nnen Sie auch einen Alias in der |
|
| 9 |
Webserverkonfiguration benutzen, um auf das tats?chliche |
|
| 10 |
Installationsverzeichnis zu verweisen.</p><p>Die Verzeichnisse <code class="filename">users</code>, |
|
| 11 |
<code class="filename">spool</code> und <code class="filename">webdav</code> m?ssen f?r |
|
| 12 |
den Benutzer beschreibbar sein, unter dem der Webserver l?uft. Die |
|
| 13 |
restlichen Dateien m?ssen f?r diesen Benutzer lesbar sein. Der |
|
| 14 |
Benutzername ist bei verschiedenen Distributionen unterschiedlich (z.B. |
|
| 15 |
bei Debian/Ubuntu <code class="constant">www-data</code>, bei Fedora core |
|
| 16 |
<code class="constant">apache</code> oder bei OpenSuSE |
|
| 17 |
<code class="constant">wwwrun</code>).</p><p>Der folgende Befehl ?ndert den Besitzer f?r die oben genannten |
|
| 18 |
Verzeichnisse auf einem Debian/Ubuntu-System:</p><pre class="programlisting">chown -R www-data lx-office-erp/users lx-office-erp/spool lx-office-erp/webdav</pre><p>Weiterhin muss der Webserver-Benutzer im Verzeichnis |
|
| 19 |
<code class="filename">templates</code> Verzeichnisse f?r jeden neuen Benutzer, |
|
| 20 |
der in lx-office angelegt wird, anlegen d?rfen:</p><pre class="programlisting">chgrp www-data lx-office-erp/templates |
|
| 21 |
chmod g+w lx-office-erp/templates</pre></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02.html">Zur?ck</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s03.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">Kapitel 2. Installation und Grundkonfiguration </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.3. Lx-Office-Konfigurationsdatei</td></tr></table></div></body></html> |
|
| doc/html/ch02s03.html | ||
|---|---|---|
| 1 |
<html><head> |
|
| 2 |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
|
| 3 |
<title>2.3. Lx-Office-Konfigurationsdatei</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="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s02.html" title="2.2. Manuelle Installation des Programmpaketes"><link rel="next" href="ch02s04.html" title="2.4. Anpassung der PostgreSQL-Konfiguration"></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">2.3. Lx-Office-Konfigurationsdatei</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s02.html">Zur?ck</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s04.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.3. Lx-Office-Konfigurationsdatei"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="config.config-file"></a>2.3. Lx-Office-Konfigurationsdatei</h2></div></div></div><div class="sect2" title="2.3.1. Einf?hrung"><div class="titlepage"><div><div><h3 class="title"><a name="config.config-file.introduction"></a>2.3.1. Einf?hrung</h3></div></div></div><p> |
|
| 4 |
Seit Lx-Office 2.6.3. gibt es nur noch eine Konfigurationsdatei die ben?tigt wird: <code class="filename">config/lx_office.conf</code> (kurz: |
|
| 5 |
"die Hauptkonfigurationsdatei"). Diese muss bei der Erstinstallation von Lx-Office bzw. der Migration von ?lteren Versionen angelegt |
|
| 6 |
werden. |
|
| 7 |
</p><p> |
|
| 8 |
Als Vorlage dient die Datei <code class="filename">config/lx_office.conf.default</code> (kurz: "die Default-Datei"): |
|
| 9 |
</p><pre class="programlisting">$ cp config/lx_office.conf.default config/lx_office.conf</pre><p> |
|
| 10 |
Die Default-Datei wird immer zuerst eingelesen. Werte, die in der Hauptkonfigurationsdatei stehen, ?berschreiben die |
|
| 11 |
Werte aus der Default-Datei. Die Hauptkonfigurationsdatei muss also nur die Abschintte und Werte |
|
| 12 |
enthalten, die von denen der Default-Datei abweichen. |
|
| 13 |
</p><p> |
|
| 14 |
Diese Hauptkonfigurationsdatei ist dann eine installationsspezifische Datei, d.h. sie enth?lt bspw. lokale Passw?rter und wird auch |
|
| 15 |
nicht im Versionsmanagement (git) verwaltet. |
|
| 16 |
</p><p> |
|
| 17 |
Die Konfiguration ist ferner serverabh?ngig, d.h. f?r alle Mandaten, bzw. Datenbanken gleich. |
|
| 18 |
</p></div><div class="sect2" title="2.3.2. Abschnitte und Parameter"><div class="titlepage"><div><div><h3 class="title"><a name="config.config-file.sections-parameters"></a>2.3.2. Abschnitte und Parameter</h3></div></div></div><p> |
|
| 19 |
Die Konfigurationsdatei besteht aus mehreren Teilen, die entsprechend kommentiert sind: |
|
| 20 |
</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p> |
|
| 21 |
<code class="literal">authentication</code> |
|
| 22 |
</p></li><li class="listitem"><p> |
|
| 23 |
<code class="literal">authentication/database</code> |
|
| 24 |
</p></li><li class="listitem"><p> |
|
| 25 |
<code class="literal">authentication/ldap</code> |
|
| 26 |
</p></li><li class="listitem"><p> |
|
| 27 |
<code class="literal">system</code> |
|
| 28 |
</p></li><li class="listitem"><p> |
|
| 29 |
<code class="literal">features</code> |
|
| 30 |
</p></li><li class="listitem"><p> |
|
| 31 |
<code class="literal">paths</code> |
|
| 32 |
</p></li><li class="listitem"><p> |
|
| 33 |
<code class="literal">applications</code> |
|
| 34 |
</p></li><li class="listitem"><p> |
|
| 35 |
<code class="literal">environment</code> |
|
| 36 |
</p></li><li class="listitem"><p> |
|
| 37 |
<code class="literal">print_templates</code> |
|
| 38 |
</p></li><li class="listitem"><p> |
|
| 39 |
<code class="literal">task_server</code> |
|
| 40 |
</p></li><li class="listitem"><p> |
|
| 41 |
<code class="literal">periodic_invoices</code> |
|
| 42 |
</p></li><li class="listitem"><p> |
|
| 43 |
<code class="literal">console</code> |
|
| 44 |
</p></li><li class="listitem"><p> |
|
| 45 |
<code class="literal">debug</code> |
|
| 46 |
</p></li></ul></div><p> |
|
| 47 |
Die ?blicherweise wichtigsten Parameter, die am Anfang einzustellen oder zu kontrollieren sind, sind: |
|
| 48 |
</p><pre class="programlisting">[authentication] |
|
| 49 |
admin_password = geheim |
|
| 50 |
|
|
| 51 |
[authentication/database] |
|
| 52 |
host = localhost |
|
| 53 |
port = 5432 |
|
| 54 |
db = lxerp_auth |
|
| 55 |
user = postgres |
|
| 56 |
password = |
|
| 57 |
|
|
| 58 |
[system] |
|
| 59 |
eur = 1 |
|
| 60 |
dbcharset = UTF-8</pre><p> |
|
| 61 |
Nutzt man wiederkehrende Rechnungen, kann man unter <code class="varname">[periodic_invoices]</code> den Login eines Benutzers angeben, der |
|
| 62 |
nach Erstellung der Rechnungen eine entsprechende E-Mail mit Informationen ?ber die erstellten Rechnungen bekommt. |
|
| 63 |
</p><p> |
|
| 64 |
Nutzt man den <a class="link" href="ch02s06.html" title="2.6. Der Task-Server">Taskserver</a> f?r <a class="link" href="ch03.html#features.periodic-invoices" title="3.1. Wiederkehrende Rechnungen">wiederkehrende Rechnungen</a>, muss unter <code class="varname">[task_server]</code> ein Login eines |
|
| 65 |
Benutzers angegeben werden, mit dem sich der Taskserver an Lx-Office bei der Datenbank anmeldet, die dem Benutzer zugewiesen ist. |
|
| 66 |
</p><p> |
|
| 67 |
F?r Entwickler finden sich unter <code class="varname">[debug]</code> wichtige Funktionen, um die Fehlersuche zu erleichtern. |
|
| 68 |
</p></div><div class="sect2" title="2.3.3. Versionen vor 2.6.3"><div class="titlepage"><div><div><h3 class="title"><a name="config.config-file.prior-versions"></a>2.3.3. Versionen vor 2.6.3</h3></div></div></div><p> |
|
| 69 |
In ?lteren Lx-Office Versionen gab es im Verzeichnis <code class="filename">config</code> die Dateien <code class="filename">authentication.pl</code> |
|
| 70 |
und <code class="filename">lx-erp.conf</code>, die jeweils Perl-Dateien waren. Es gab auch die M?glichkeit, eine lokale Version der |
|
| 71 |
Konfigurationsdatei zu erstellen (<code class="filename">lx-erp-local.conf</code>). Dies ist ab 2.6.3 nicht mehr m?glich, aber auch nicht mehr |
|
| 72 |
n?tig. |
|
| 73 |
</p><p> |
|
| 74 |
Beim Update von einer Lx-Office-Version vor 2.6.3 auf 2.6.3 oder j?nger m?ssen die Einstellungen aus den alten Konfigurationsdateien |
|
| 75 |
manuell ?bertragen und die alten Konfigurationsdateien anschlie?end gel?scht oder verschoben werden. Ansonsten zeigt Lx-Office eine |
|
| 76 |
entsprechende Fehlermeldung an. |
|
| 77 |
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s02.html">Zur?ck</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s04.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.2. Manuelle Installation des Programmpaketes </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.4. Anpassung der PostgreSQL-Konfiguration</td></tr></table></div></body></html> |
|
| doc/html/ch02s04.html | ||
|---|---|---|
| 1 |
<html><head> |
|
| 2 |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
|
| 3 |
<title>2.4. Anpassung der PostgreSQL-Konfiguration</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="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s03.html" title="2.3. Lx-Office-Konfigurationsdatei"><link rel="next" href="ch02s05.html" title="2.5. Webserver-Konfiguration"></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">2.4. Anpassung der PostgreSQL-Konfiguration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s03.html">Zur?ck</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s05.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.4. Anpassung der PostgreSQL-Konfiguration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Anpassung-der-PostgreSQL-Konfiguration"></a>2.4. Anpassung der PostgreSQL-Konfiguration</h2></div></div></div><p>PostgreSQL muss auf verschiedene Weisen angepasst werden.</p><div class="sect2" title="2.4.1. Zeichens?tze/die Verwendung von UTF-8"><div class="titlepage"><div><div><h3 class="title"><a name="Zeichens%C3%A4tze-die-Verwendung-von-UTF-8"></a>2.4.1. Zeichens?tze/die Verwendung von UTF-8</h3></div></div></div><p>Lx-Office kann komplett mit UTF-8 als Zeichensatz verwendet |
|
| 4 |
werden. Dabei gibt es zwei Punkte zu beachten: PostgreSQL muss in |
|
| 5 |
Version 8.2 oder neuer benutzt werden, und der |
|
| 6 |
PostgreSQL-Datenbankcluster muss ebenfalls mit UTF-8 als Locale |
|
| 7 |
angelegt worden sein.</p><p>Dieses ist kann ?berpr?ft werden: ist das Encoding der Datenbank “template1” “UTF8”, so kann auch Lx-Office mit UTF-8 |
|
| 8 |
betrieben werden. Andernfalls ist es notwendig, einen neuen Datenbankcluster mit UTF-8-Encoding anzulegen und diesen zu |
|
| 9 |
verwenden. Unter Debian und Ubuntu kann dies z.B. f?r PostgreSQL 8.2 mit dem folgenden Befehl getan werden:</p><pre class="programlisting">pg_createcluster --locale=de_DE.UTF-8 --encoding=UTF-8 8.2 clustername</pre><p>Die Datenbankversionsnummer muss an die tats?chlich verwendete Versionsnummer angepasst werden.</p><p>Unter anderen Distributionen gibt es ?hnliche Methoden.</p><p>Wurde PostgreSQL nicht mit UTF-8 als Encoding initialisiert und |
|
| 10 |
ist ein Neuanlegen eines weiteren Clusters nicht m?glich, so kann |
|
| 11 |
Lx-Office mit ISO-8859-15 als Encoding betrieben werden.</p><p>Das Encoding einer Datenbank kann in <span class="command"><strong>psql</strong></span> mit <code class="literal">\l</code> gepr?ft werden.</p></div><div class="sect2" title="2.4.2. ?nderungen an Konfigurationsdateien"><div class="titlepage"><div><div><h3 class="title"><a name="%C3%84nderungen-an-Konfigurationsdateien"></a>2.4.2. ?nderungen an Konfigurationsdateien</h3></div></div></div><p>In der Datei <code class="filename">postgresql.conf</code>, die je nach |
|
| 12 |
Distribution in verschiedenen Verzeichnissen liegen kann (z.B. |
|
| 13 |
<code class="filename">/var/lib/pgsql/data/</code> oder |
|
| 14 |
<code class="filename">/etc/postgresql/</code>, muss sichergestellt werden, dass |
|
| 15 |
TCP/IP-Verbindungen aktiviert sind. Das Verhalten wird ?ber den |
|
| 16 |
Parameter <code class="varname">listen_address</code> gesteuert. Laufen |
|
| 17 |
PostgreSQL und Lx-Office auf demselben Rechner, so kann dort der Wert |
|
| 18 |
<code class="literal">localhost</code> verwendet werden. Andernfalls m?ssen |
|
| 19 |
Datenbankverbindungen auch von anderen Rechnern aus zugelassen werden, |
|
| 20 |
was mit dem Wert <code class="literal">*</code> geschieht.</p><p>In der Datei <code class="filename">pg_hba.conf</code>, die im gleichen |
|
| 21 |
Verzeichnis wie die <code class="filename">postgresql.conf</code> zu finden sein |
|
| 22 |
sollte, m?ssen die Berichtigungen f?r den Zugriff ge?ndert werden. |
|
| 23 |
Hier gibt es mehrere M?glichkeiten. Eine besteht darin, lokale |
|
| 24 |
Verbindungen immer zuzulassen:</p><pre class="programlisting">local all all trust |
|
| 25 |
host all all 127.0.0.1 255.0.0.0 trust</pre><p>Besser ist es, f?r eine bestimmte Datenbank Zugriff nur per |
|
| 26 |
Passwort zuzulassen. Beispielsweise:</p><pre class="programlisting">local all lxoffice password |
|
| 27 |
host all lxoffice 127.0.0.1 255.255.255.255 password</pre></div><div class="sect2" title="2.4.3. Erweiterung f?r servergespeicherte Prozeduren"><div class="titlepage"><div><div><h3 class="title"><a name="Erweiterung-f%C3%BCr-servergespeicherte-Prozeduren"></a>2.4.3. Erweiterung f?r servergespeicherte Prozeduren</h3></div></div></div><p>In der Datenbank <code class="literal">template1</code> muss die |
|
| 28 |
Unterst?tzung f?r servergespeicherte Prozeduren eingerichet werden. |
|
| 29 |
Melden Sie sich daf?r als Benutzer “postgres” an der Datenbank an, und |
|
| 30 |
f?hren Sie die folgenden Kommandos aus:</p><pre class="programlisting">create language 'plpgsql';</pre></div><div class="sect2" title="2.4.4. Datenbankbenutzer anlegen"><div class="titlepage"><div><div><h3 class="title"><a name="Datenbankbenutzer-anlegen"></a>2.4.4. Datenbankbenutzer anlegen</h3></div></div></div><p>Wenn Sie nicht den Datenbanksuperuser “postgres” zum Zugriff |
|
| 31 |
benutzen wollen, so sollten Sie bei PostgreSQL einen neuen Benutzer |
|
| 32 |
anlegen. Ein Beispiel, wie Sie einen neuen Benutzer anlegen |
|
| 33 |
k?nnen:</p><pre class="programlisting">su - postgres createuser -d -P lxoffice</pre><p>Wenn Sie sp?ter einen Datenbankzugriff konfigurieren, ver?ndern |
|
| 34 |
Sie den evtl. voreingestellten Benutzer “postgres” auf “lxoffice” bzw. |
|
| 35 |
den hier gew?hlten Benutzernamen.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s03.html">Zur?ck</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s05.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.3. Lx-Office-Konfigurationsdatei </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.5. Webserver-Konfiguration</td></tr></table></div></body></html> |
|
| doc/html/ch02s05.html | ||
|---|---|---|
| 1 |
<html><head> |
|
| 2 |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
|
| 3 |
<title>2.5. Webserver-Konfiguration</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="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s04.html" title="2.4. Anpassung der PostgreSQL-Konfiguration"><link rel="next" href="ch02s06.html" title="2.6. Der Task-Server"></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">2.5. Webserver-Konfiguration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s04.html">Zur?ck</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s06.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.5. Webserver-Konfiguration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Apache-Konfiguration"></a>2.5. Webserver-Konfiguration</h2></div></div></div><div class="sect2" title="2.5.1. Grundkonfiguration mittels CGI"><div class="titlepage"><div><div><h3 class="title"><a name="d0e508"></a>2.5.1. Grundkonfiguration mittels CGI</h3></div></div></div><div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="../../../../system/docbook-xsl/images/note.png"></td><th align="left">Anmerkung</th></tr><tr><td align="left" valign="top"><p>F?r einen deutlichen Performanceschub sorgt die Ausf?hrung |
|
| 4 |
mittels FastCGI/FCGI. Die Einrichtung wird ausf?hrlich im Abschnitt |
|
| 5 |
<a class="xref" href="ch02s05.html#Apache-Konfiguration.FCGI" title="2.5.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 |
|
| 6 |
Webserverkonfigurationsdatei <code class="literal">httpd.conf</code> eingestellt |
|
| 7 |
werden. F?gen Sie den folgenden Abschnitt dieser Datei oder einer |
|
| 8 |
anderen Datei hinzu, die beim Starten des Webservers eingelesen |
|
| 9 |
wird:</p><pre class="programlisting">AddHandler cgi-script .pl |
|
| 10 |
Alias /lx-erp/ /var/www/lx-erp/ |
|
| 11 |
|
|
| 12 |
<Directory /var/www/lx-erp> |
|
| 13 |
Options ExecCGI |
|
| 14 |
Includes FollowSymlinks |
|
| 15 |
</Directory> |
|
| 16 |
|
|
| 17 |
<Directory /var/www/lx-erp/users> |
|
| 18 |
Order Deny,Allow |
|
| 19 |
Deny from All |
|
| 20 |
</Directory></pre><p>Ersetzen Sie dabei die Pfade durch diejenigen, in die Sie vorher |
|
| 21 |
das Lx-Office-Archiv entpacket haben.</p><div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="../../../../system/docbook-xsl/images/note.png"></td><th align="left">Anmerkung</th></tr><tr><td align="left" valign="top"><p>Vor den einzelnen Optionen muss bei einigen Distributionen ein Plus ‘<code class="literal">+</code>’ gesetzt werden.</p></td></tr></table></div><p>Auf einigen Webservern werden manchmal die Grafiken und |
|
| 22 |
Style-Sheets nicht ausgeliefert. In solchen F?llen hat es oft |
|
| 23 |
geholfen, die folgende Option in die Konfiguration aufzunehmen:</p><pre class="programlisting">EnableSendfile Off</pre></div><div class="sect2" title="2.5.2. Konfiguration f?r FastCGI/FCGI"><div class="titlepage"><div><div><h3 class="title"><a name="Apache-Konfiguration.FCGI"></a>2.5.2. Konfiguration f?r FastCGI/FCGI</h3></div></div></div><div class="sect3" title="2.5.2.1. Was ist FastCGI?"><div class="titlepage"><div><div><h4 class="title"><a name="Apache-Konfiguration.FCGI.WasIstEs"></a>2.5.2.1. Was ist FastCGI?</h4></div></div></div><p>Direkt aus <a class="ulink" href="http://de.wikipedia.org/wiki/FastCGI" target="_top">Wikipedia</a> |
|
| 24 |
kopiert:</p><p> |
|
| 25 |
[<span class="citation"> FastCGI ist ein Standard f?r die Einbindung |
|
| 26 |
externer Software zur Generierung dynamischer Webseiten in einem |
|
| 27 |
Webserver. FastCGI ist vergleichbar zum Common Gateway Interface |
|
| 28 |
(CGI), wurde jedoch entwickelt, um dessen Performance-Probleme zu |
|
| 29 |
umgehen. </span>] |
|
| 30 |
</p></div><div class="sect3" title="2.5.2.2. Warum FastCGI?"><div class="titlepage"><div><div><h4 class="title"><a name="Apache-Konfiguration.FCGI.Warum"></a>2.5.2.2. Warum FastCGI?</h4></div></div></div><p>Perl Programme (wie Lx-Office eines ist) werden nicht statisch |
|
| 31 |
kompiliert. Stattdessen werden die Quelldateien bei jedem Start |
|
| 32 |
?bersetzt, was bei kurzen Laufzeiten einen Gro?teil der Laufzeit |
|
| 33 |
ausmacht. W?hrend SQL Ledger einen Gro?teil der Funktionalit?t in |
|
| 34 |
einzelne Module kapselt, um immer nur einen kleinen Teil laden zu |
|
| 35 |
m?ssen, ist die Funktionalit?t von Lx-Office soweit gewachsen, dass |
|
| 36 |
immer mehr Module auf den Rest des Programms zugreifen. Zus?tzlich |
|
| 37 |
benutzen wir umfangreiche Bibliotheken um Funktionalt?t nicht selber |
|
| 38 |
entwickeln zu m?ssen, die zus?tzliche Ladezeit kosten. All dies |
|
| 39 |
f?hrt dazu dass ein Lx-Office Aufruf der Kernmasken mittlerweile |
|
| 40 |
deutlich l?nger dauert als fr?her, und dass davon 90% f?r das Laden |
|
| 41 |
der Module verwendet wird.</p><p>Mit FastCGI werden nun die Module einmal geladen, und danach |
|
| 42 |
wird nur die eigentliche Programmlogik ausgef?hrt.</p></div><div class="sect3" title="2.5.2.3. Getestete Kombinationen aus Webservern und Plugin"><div class="titlepage"><div><div><h4 class="title"><a name="Apache-Konfiguration.FCGI.WebserverUndPlugin"></a>2.5.2.3. Getestete Kombinationen aus Webservern und Plugin</h4></div></div></div><p>Folgende Kombinationen sind getestet:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Apache 2.2.11 (Ubuntu) und mod_fcgid.</p></li><li class="listitem"><p>Apache 2.2.11 (Ubuntu) und mod_fastcgi.</p></li></ul></div><p>Dabei wird mod_fcgid empfohlen, weil mod_fastcgi seit geraumer |
|
| 43 |
Zeit nicht mehr weiter entwickelt wird. Im Folgenden wird auf |
|
| 44 |
mod_fastcgi nicht mehr explizit eingegangen.</p><p>Als Perl Backend wird das Modul <code class="filename">FCGI.pm</code> |
|
| 45 |
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> |
|
| 46 |
FCGI 0.69 und h?her ist extrem strict in der Behandlung von Unicode, und verweigert bestimmte Eingaben von Lx-Office. Falls es |
|
| 47 |
Probleme mit Umlauten in Ihrere Installation gibt, muss auf die Vorg?ngerversion FCGI 0.68 ausgewichen werden. |
|
| 48 |
</p><p> |
|
| 49 |
Mit CPAN l?sst sie sich die Vorg?ngerversion wie folgt installieren: |
|
| 50 |
</p><pre class="programlisting">force install M/MS/MSTROUT/FCGI-0.68.tar.gz</pre></td></tr></table></div></div><div class="sect3" title="2.5.2.4. Konfiguration des Webservers"><div class="titlepage"><div><div><h4 class="title"><a name="Apache-Konfiguration.FCGI.Konfiguration"></a>2.5.2.4. Konfiguration des Webservers</h4></div></div></div><p>Bevor Sie versuchen, eine Lx-Office Installation unter FCGI |
|
| 51 |
laufen zu lassen, empfliehlt es sich die Installation ersteinmal |
|
| 52 |
unter CGI aufzusetzen. FCGI macht es nicht einfach Fehler zu |
|
| 53 |
debuggen die beim ersten aufsetzen auftreten k?nnen. Sollte die |
|
| 54 |
Installation schon funktionieren, lesen Sie weiter.</p><p>Zuerst muss das FastCGI-Modul aktiviert werden. Dies kann |
|
| 55 |
unter Debian/Ubuntu z.B. mit folgendem Befehl geschehen:</p><pre class="programlisting">a2enmod fcgid</pre><p>Die Konfiguration f?r die Verwendung von Lx-Office mit FastCGI |
|
| 56 |
erfolgt durch Anpassung der vorhandenen <code class="function">Alias</code>- |
|
| 57 |
und <code class="function">Directory</code>-Direktiven. Dabei wird zwischen |
|
| 58 |
dem Installationspfad von Lx-Office im Dateisystem |
|
| 59 |
("<code class="filename">/path/to/lx-office-erp</code>") und der URL
|
|
| 60 |
unterschieden, unter der Lx-Office im Webbrowser erreichbar ist |
|
| 61 |
("<code class="filename">/url/for/lx-office-erp</code>").</p><p>Folgender Konfigurationsschnipsel funktioniert mit
|
|
| 62 |
mod_fastcgi:</p><pre class="programlisting">AliasMatch ^/url/for/lx-office-erp/[^/]+\.pl /path/to/lx-office-erp/dispatcher.fcgi |
|
| 63 |
Alias /url/for/lx-office-erp/ /path/to/lx-office-erp/ |
|
| 64 |
|
|
| 65 |
<Directory /path/to/lx-office-erp> |
|
| 66 |
AllowOverride All |
|
| 67 |
Options ExecCGI Includes FollowSymlinks |
|
| 68 |
Order Allow,Deny |
|
| 69 |
Allow from All |
|
| 70 |
</Directory> |
|
| 71 |
|
|
| 72 |
<DirectoryMatch /path/to/lx-office-erp/users> |
|
| 73 |
Order Deny,Allow |
|
| 74 |
Deny from All |
|
| 75 |
</DirectoryMatch></pre><p>Seit mod_fcgid-Version 2.6.3 gelten sehr kleine Grenzen f?r |
|
| 76 |
die maximale Gr??e eines Requests. Diese sollte wie folgt |
|
| 77 |
hochgesetzt werden:</p><pre class="programlisting">FcgidMaxRequestLen 10485760</pre><p>Das ganze sollte dann so aussehen:</p><pre class="programlisting">AddHandler fcgid-script .fpl |
|
| 78 |
AliasMatch ^/url/for/lx-office-erp/[^/]+\.pl /path/to/lx-office-erp/dispatcher.fpl |
|
| 79 |
Alias /url/for/lx-office-erp/ /path/to/lx-office-erp/ |
|
| 80 |
FcgidMaxRequestLen 10485760 |
|
| 81 |
|
|
| 82 |
<Directory /path/to/lx-office-erp> |
|
| 83 |
AllowOverride All |
|
| 84 |
Options ExecCGI Includes FollowSymlinks |
|
| 85 |
Order Allow,Deny |
|
| 86 |
Allow from All |
|
| 87 |
</Directory> |
|
| 88 |
|
|
| 89 |
<DirectoryMatch /path/to/lx-office-erp/users> |
|
| 90 |
Order Deny,Allow |
|
| 91 |
Deny from All |
|
| 92 |
</DirectoryMatch></pre><p>Hierdurch wird nur ein zentraler Dispatcher gestartet. Alle |
|
| 93 |
Zugriffe auf die einzelnen Scripte werden auf diesen umgeleitet. |
|
| 94 |
Dadurch, dass zur Laufzeit ?fter mal Scripte neu geladen werden, |
|
| 95 |
gibt es hier kleine Performance-Einbu?en.</p><p>Es ist m?glich, die gleiche Lx-Office Version parallel unter |
|
| 96 |
CGI und FastCGI zu betreiben. Daf?r bleiben die Directorydirektiven |
|
| 97 |
wie oben beschrieben, die URLs werden aber umgeleitet:</p><pre class="programlisting"># Zugriff ?ber CGI |
|
| 98 |
Alias /url/for/lx-office-erp /path/to/lx-office-erp |
|
| 99 |
|
|
| 100 |
# Zugriff mit mod_fcgid: |
|
| 101 |
AliasMatch ^/url/for/lx-office-erp-fcgid/[^/]+\.pl /path/to/lx-office-erp/dispatcher.fpl |
|
| 102 |
Alias /url/for/lx-office-erp-fcgid/ /path/to/lx-office-erp/</pre><p>Dann ist unter <code class="filename">/url/for/lx-office-erp/</code> die normale Version erreichbar, und unter |
|
| 103 |
<code class="constant">/url/for/lx-office-erp-fcgid/</code> die FastCGI-Version.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s04.html">Zur?ck</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s06.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.4. Anpassung der PostgreSQL-Konfiguration </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.6. Der Task-Server</td></tr></table></div></body></html> |
|
| doc/html/ch02s06.html | ||
|---|---|---|
| 1 |
<html><head> |
|
| 2 |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
|
| 3 |
<title>2.6. Der Task-Server</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="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s05.html" title="2.5. Webserver-Konfiguration"><link rel="next" href="ch02s07.html" title="2.7. Benutzerauthentifizierung und Administratorpasswort"></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">2.6. Der Task-Server</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s05.html">Zur?ck</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s07.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.6. Der Task-Server"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="config.task-server"></a>2.6. Der Task-Server</h2></div></div></div><p>Der Task-Server ist ein Prozess, der im Hintergrund l?uft, in |
|
| 4 |
regelm??igen Abst?nden nach abzuarbeitenden Aufgaben sucht und diese zu |
|
| 5 |
festgelegten Zeitpunkten abarbeitet (?hnlich wie Cron). Dieser Prozess |
|
| 6 |
wird bisher nur f?r die Erzeugung der wiederkehrenden Rechnungen |
|
| 7 |
benutzt, wird aber in Zukunft deutlich mehr Aufgaben ?bertragen |
|
| 8 |
bekommen.</p><div class="sect2" title="2.6.1. Verf?gbare und notwendige Konfigurationsoptionen"><div class="titlepage"><div><div><h3 class="title"><a name="Konfiguration-des-Task-Servers"></a>2.6.1. Verf?gbare und notwendige Konfigurationsoptionen</h3></div></div></div><p>Die Konfiguration erfolgt ?ber den Abschnitt |
|
| 9 |
<code class="literal">[task_server]</code> in der Datei |
|
| 10 |
<code class="filename">config/lx_office.conf</code>. Die dort verf?gbaren |
|
| 11 |
Optionen sind:</p><div class="variablelist"><dl><dt><span class="term"> |
|
| 12 |
<code class="varname">login</code> |
|
| 13 |
</span></dt><dd><p> |
|
| 14 |
g?ltiger Lx-Office-Benutzername, der benutzt wird, um die zu verwendende Datenbankverbindung auszulesen. Der Benutzer muss in |
|
| 15 |
der Administration angelegt werden. Diese Option muss angegeben werden. |
|
| 16 |
</p></dd><dt><span class="term"> |
|
| 17 |
<code class="varname">run_as</code> |
|
| 18 |
</span></dt><dd><p> |
|
| 19 |
Wird der Server vom Systembenutzer <code class="literal">root</code> gestartet, so wechselt er auf den mit <code class="literal">run_as</code> |
|
| 20 |
angegebenen Systembenutzer. Der Systembenutzer muss dieselben Lese- und Schreibrechte haben, wie auch der Webserverbenutzer |
|
| 21 |
(siehe see <a class="xref" href="ch02s02.html" title="2.2. Manuelle Installation des Programmpaketes">Manuelle Installation des Programmpaketes</a>). Daher ist es sinnvoll, hier denselben Systembenutzer |
|
| 22 |
einzutragen, unter dem auch der Webserver l?uft. |
|
| 23 |
</p></dd><dt><span class="term"> |
|
| 24 |
<code class="varname">debug</code> |
|
| 25 |
</span></dt><dd><p> |
|
| 26 |
Schaltet Debug-Informationen an und aus. |
|
| 27 |
</p></dd></dl></div></div><div class="sect2" title="2.6.2. Automatisches Starten des Task-Servers beim Booten"><div class="titlepage"><div><div><h3 class="title"><a name="Einbinden-in-den-Boot-Prozess"></a>2.6.2. Automatisches Starten des Task-Servers beim Booten</h3></div></div></div><p>Der Task-Server verh?lt sich von seinen Optionen her wie ein |
|
| 28 |
regul?res SystemV-kompatibles Boot-Script. Au?erdem wechselt er beim |
|
| 29 |
Starten automatisch in das Lx-Office-Installationsverzeichnis.</p><p>Deshalb ist es m?glich, ihn durch Setzen eines symbolischen |
|
| 30 |
Links aus einem der Runlevel-Verzeichnisse heraus in den Boot-Prozess |
|
| 31 |
einzubinden. Da das bei neueren Linux-Distributionen aber nicht |
|
| 32 |
zwangsl?ufig funktioniert, werden auch Start-Scripte mitgeliefert, die |
|
| 33 |
anstelle eines symbolischen Links verwendet werden k?nnen.</p><div class="sect3" title="2.6.2.1. SystemV-basierende Systeme (z.B. Debian, OpenSuSE, Fedora Core)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e692"></a>2.6.2.1. SystemV-basierende Systeme (z.B. Debian, OpenSuSE, Fedora |
|
| 34 |
Core)</h4></div></div></div><p>Kopieren Sie die Datei |
|
| 35 |
<code class="filename">scripts/boot/system-v/lx-office-task-server</code> |
|
| 36 |
nach <code class="filename">/etc/init.d/lx-office-task-server</code>. Passen |
|
| 37 |
Sie in der kopierten Datei den Pfad zum Task-Server an (Zeile |
|
| 38 |
<code class="literal">DAEMON=....</code>). Binden Sie das Script in den |
|
| 39 |
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 lx-office-task-server defaults |
|
| 40 |
# Nur bei Debian Squeeze und neuer: |
|
| 41 |
insserv lx-office-task-server</pre></li><li class="listitem"><p>OpenSuSE und Fedora Core:</p><pre class="programlisting">chkconfig --add lx-office-task-server</pre></li></ul></div><p>Danach kann der Task-Server mit dem folgenden Befehl gestartet werden: <span class="command"><strong>/etc/init.d/lx-office-task-server |
|
| 42 |
start</strong></span> |
|
| 43 |
</p></div><div class="sect3" title="2.6.2.2. Upstart-basierende Systeme (z.B. Ubuntu)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e722"></a>2.6.2.2. Upstart-basierende Systeme (z.B. Ubuntu)</h4></div></div></div><p>Kopieren Sie die Datei |
|
| 44 |
<code class="filename">scripts/boot/upstart/lx-office-task-server.conf</code> |
|
| 45 |
nach <code class="filename">/etc/init/lx-office-task-server.conf</code>. |
|
| 46 |
Passen Sie in der kopierten Datei den Pfad zum Task-Server an (Zeile |
|
| 47 |
<code class="literal">exec ....</code>).</p><p>Danach kann der Task-Server mit dem folgenden Befehl gestartet werden: <span class="command"><strong>service lx-office-task-server |
|
| 48 |
start</strong></span> |
|
| 49 |
</p></div></div><div class="sect2" title="2.6.3. Wie der Task-Server gestartet und beendet wird"><div class="titlepage"><div><div><h3 class="title"><a name="Prozesskontrolle"></a>2.6.3. Wie der Task-Server gestartet und beendet wird</h3></div></div></div><p>Der Task-Server wird wie folgt kontrolliert:</p><pre class="programlisting">./scripts/task_server.pl Befehl</pre><p> |
|
| 50 |
<code class="literal">Befehl</code> ist dabei eine der folgenden |
|
| 51 |
Optionen:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p> |
|
| 52 |
<code class="literal">start</code> startet eine neue Instanz des |
|
| 53 |
Task-Servers. Die Prozess-ID wird innerhalb des |
|
| 54 |
<code class="filename">users</code>-Verzeichnisses abgelegt.</p></li><li class="listitem"><p> |
|
| 55 |
<code class="literal">stop</code> beendet einen laufenden |
|
| 56 |
Task-Server.</p></li><li class="listitem"><p> |
|
| 57 |
<code class="literal">restart</code> beendet und startet ihn |
|
| 58 |
neu.</p></li><li class="listitem"><p> |
|
| 59 |
<code class="literal">status</code> berichtet, ob der Task-Server |
|
| 60 |
l?uft.</p></li></ul></div><p>Der Task-Server wechselt beim Starten automatisch in das |
|
| 61 |
Lx-Office-Installationsverzeichnis.</p><p>Dieselben Optionen k?nnen auch f?r die SystemV-basierenden |
|
| 62 |
Runlevel-Scripte benutzt werden (siehe oben).</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s05.html">Zur?ck</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s07.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.5. Webserver-Konfiguration </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.7. Benutzerauthentifizierung und Administratorpasswort</td></tr></table></div></body></html> |
|
| doc/html/ch02s07.html | ||
|---|---|---|
| 1 |
<html><head> |
|
| 2 |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
|
| 3 |
<title>2.7. Benutzerauthentifizierung und Administratorpasswort</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="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s06.html" title="2.6. Der Task-Server"><link rel="next" href="ch02s08.html" title="2.8. Benutzer- und Gruppenverwaltung"></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">2.7. Benutzerauthentifizierung und Administratorpasswort</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s06.html">Zur?ck</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s08.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.7. Benutzerauthentifizierung und Administratorpasswort"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Benutzerauthentifizierung-und-Administratorpasswort"></a>2.7. Benutzerauthentifizierung und Administratorpasswort</h2></div></div></div><p>Informationen ?ber die Einrichtung der Benutzerauthentifizierung, |
|
| 4 |
?ber die Verwaltung von Gruppen und weitere Einstellungen</p><div class="sect2" title="2.7.1. Grundlagen zur Benutzerauthentifizierung"><div class="titlepage"><div><div><h3 class="title"><a name="Grundlagen-zur-Benutzerauthentifizierung"></a>2.7.1. Grundlagen zur Benutzerauthentifizierung</h3></div></div></div><p>Lx-Office verwaltet die Benutzerinformationen in einer |
|
| 5 |
Datenbank, die im folgenden “Authentifizierungsdatenbank” genannt |
|
| 6 |
wird. F?r jeden Benutzer kann dort eine eigene Datenbank f?r die |
|
| 7 |
eigentlichen Finanzdaten hinterlegt sein. Diese beiden Datenbanken |
|
| 8 |
k?nnen, m?ssen aber nicht unterschiedlich sein.</p><p>Im einfachsten Fall gibt es f?r Lx-Office nur eine einzige |
|
| 9 |
Datenbank, in der sowohl die Benutzerinformationen als auch die Daten |
|
| 10 |
abgelegt werden.</p><p>Zus?tzlich erm?glicht es Lx-Office, dass die Benutzerpassw?rter |
|
| 11 |
entweder gegen die Authentifizierungsdatenbank oder gegen einen |
|
| 12 |
LDAP-Server ?berpr?ft werden.</p><p>Welche Art der Passwort?berpr?fung Lx-Office benutzt und wie |
|
| 13 |
Lx-Office die Authentifizierungsdatenbank erreichen kann, wird in der |
|
| 14 |
Konfigurationsdatei <code class="filename">config/lx_office.conf</code> |
|
| 15 |
festgelegt. Diese muss bei der Installation und bei einem Upgrade von |
|
| 16 |
einer Version vor v2.6.0 angelegt werden. Eine |
|
| 17 |
Beispielkonfigurationsdatei |
|
| 18 |
<code class="filename">config/lx_office.conf.default</code> existiert, die als |
|
| 19 |
Vorlage benutzt werden kann.</p></div><div class="sect2" title="2.7.2. Administratorpasswort"><div class="titlepage"><div><div><h3 class="title"><a name="Administratorpasswort"></a>2.7.2. Administratorpasswort</h3></div></div></div><p>Das Passwort, das zum Zugriff auf das Aministrationsinterface benutzt wird, wird ebenfalls in dieser Datei gespeichert. Es |
|
| 20 |
kann auch nur dort und nicht mehr im Administrationsinterface selber ge?ndert werden. Der Parameter dazu hei?t |
|
| 21 |
<code class="varname">admin_password</code> im Abschnitt <code class="varname">[authentication]</code>.</p></div><div class="sect2" title="2.7.3. Authentifizierungsdatenbank"><div class="titlepage"><div><div><h3 class="title"><a name="Authentifizierungsdatenbank"></a>2.7.3. Authentifizierungsdatenbank</h3></div></div></div><p>Die Verbindung zur Authentifizierungsdatenbank wird mit den Parametern in <code class="varname">[authentication/database]</code> |
|
| 22 |
konfiguriert. Hier sind die folgenden Parameter anzugeben:</p><div class="variablelist"><dl><dt><span class="term"> |
|
| 23 |
<code class="literal">host</code> |
|
| 24 |
</span></dt><dd><p>Der Rechnername oder die IP-Adresse des Datenbankservers</p></dd><dt><span class="term"> |
|
| 25 |
<code class="literal">port</code> |
|
| 26 |
</span></dt><dd><p>Die Portnummer des Datenbankservers, meist 5432</p></dd><dt><span class="term"> |
|
| 27 |
<code class="literal">db</code> |
|
| 28 |
</span></dt><dd><p>Der Name der Authentifizierungsdatenbank</p></dd><dt><span class="term"> |
|
| 29 |
<code class="literal">user</code> |
|
| 30 |
</span></dt><dd><p>Der Benutzername, mit dem sich Lx-Office beim Datenbankserver anmeldet (z.B. "<code class="literal">postgres</code>")</p></dd><dt><span class="term"> |
|
| 31 |
<code class="literal">password</code> |
|
| 32 |
</span></dt><dd><p>Das Passwort f?r den Datenbankbenutzer</p></dd></dl></div><p>Die Datenbank muss noch nicht existieren. Lx-Office kann sie |
|
| 33 |
automatisch anlegen (mehr dazu siehe unten).</p></div><div class="sect2" title="2.7.4. Passwort?berpr?fung"><div class="titlepage"><div><div><h3 class="title"><a name="Passwort%C3%BCberpr%C3%BCfung"></a>2.7.4. Passwort?berpr?fung</h3></div></div></div><p>Lx-Office unterst?tzt Passwort?berpr?fung auf zwei Arten: gegen die Authentifizierungsdatenbank und gegen einen externen LDAP- |
|
| 34 |
oder Active-Directory-Server. Welche davon benutzt wird, regelt der Parameter <code class="varname">module</code> im Abschnitt |
|
| 35 |
<code class="varname">[authentication]</code>.</p><p>Sollen die Benutzerpassw?rter in der Authentifizierungsdatenbank gespeichert werden, so muss der Parameter |
|
| 36 |
<code class="varname">module</code> den Wert <code class="literal">DB</code> enthalten. In diesem Fall k?nnen sowohl der Administrator als auch die |
|
| 37 |
Benutzer selber ihre Psasw?rter in Lx-Office ?ndern.</p><p>Soll hingegen ein externer LDAP- oder Active-Directory-Server benutzt werden, so muss der Parameter <code class="varname">module</code> |
|
| 38 |
auf <code class="literal">LDAP</code> gesetzt werden. In diesem Fall m?ssen zus?tzliche Informationen ?ber den LDAP-Server im Abschnitt |
|
| 39 |
<code class="literal">[authentication/ldap]</code> angegeben werden:</p><div class="variablelist"><dl><dt><span class="term"> |
|
| 40 |
<code class="literal">host</code> |
|
| 41 |
</span></dt><dd><p>Der Rechnername oder die IP-Adresse des LDAP- oder Active-Directory-Servers. Diese Angabe ist zwingend |
|
| 42 |
erforderlich.</p></dd><dt><span class="term"> |
|
| 43 |
<code class="literal">port</code> |
|
| 44 |
</span></dt><dd><p>Die Portnummer des LDAP-Servers; meist 389.</p></dd><dt><span class="term"> |
|
| 45 |
<code class="literal">tls</code> |
|
| 46 |
</span></dt><dd><p>Wenn Verbindungsverschl?sselung gew?nscht ist, so diesen Wert auf ‘<code class="literal">1</code>’ setzen, andernfalls auf |
|
| 47 |
‘<code class="literal">0</code>’ belassen</p></dd><dt><span class="term"> |
|
| 48 |
<code class="literal">attribute</code> |
|
| 49 |
</span></dt><dd><p>Das LDAP-Attribut, in dem der Benutzername steht, den der Benutzer eingegeben hat. F?r Active-Directory-Server ist dies |
|
| 50 |
meist ‘<code class="literal">sAMAccountName</code>’, f?r andere LDAP-Server hingegen ‘<code class="literal">uid</code>’. Diese Angabe ist zwingend |
|
| 51 |
erforderlich.</p></dd><dt><span class="term"> |
|
| 52 |
<code class="literal">base_dn</code> |
|
| 53 |
</span></dt><dd><p>Der Abschnitt des LDAP-Baumes, der durchsucht werden soll. Diese Angabe ist zwingend erforderlich.</p></dd><dt><span class="term"> |
|
| 54 |
<code class="literal">filter</code> |
|
| 55 |
</span></dt><dd><p>Ein optionaler LDAP-Filter. Enth?lt dieser Filter das Wort <code class="literal"><%login%></code>, so wird dieses durch den |
|
| 56 |
vom Benutzer eingegebenen Benutzernamen ersetzt. Andernfalls wird der LDAP-Baum nach einem Element durchsucht, bei dem das oben |
|
| 57 |
angegebene Attribut mit dem Benutzernamen identisch ist.</p></dd><dt><span class="term"> |
|
| 58 |
<code class="literal">bind_dn</code> und <code class="literal">bind_password</code> |
|
| 59 |
</span></dt><dd><p>Wenn der LDAP-Server eine Anmeldung erfordert, bevor er durchsucht werden kann (z.B. ist dies bei Active-Directory-Servern |
|
| 60 |
der Fall), so kann diese hier angegeben werden. F?r Active-Directory-Server kann als ‘<code class="literal">bind_dn</code>’ entweder eine |
|
| 61 |
komplette LDAP-DN wie z.B. ‘<code class="literal">cn=Martin Mustermann,cn=Users,dc=firmendomain</code>’ auch nur der volle Name des |
|
| 62 |
Benutzers eingegeben werden; in diesem Beispiel also ‘<code class="literal">Martin Mustermann</code>’.</p></dd></dl></div></div><div class="sect2" title="2.7.5. Name des Session-Cookies"><div class="titlepage"><div><div><h3 class="title"><a name="Name-des-Session-Cookies"></a>2.7.5. Name des Session-Cookies</h3></div></div></div><p>Sollen auf einem Server mehrere Lx-Office-Installationen aufgesetzt werden, so m?ssen die Namen der Session-Cookies f?r alle |
|
| 63 |
Installationen unterschiedlich sein. Der Name des Cookies wird mit dem Parameter <code class="varname">cookie_name</code> im Abschnitt |
|
| 64 |
<code class="varname">[authentication]</code>gesetzt.</p><p>Diese Angabe ist optional, wenn nur eine Installation auf dem |
|
| 65 |
Server existiert.</p></div><div class="sect2" title="2.7.6. Anlegen der Authentifizierungsdatenbank"><div class="titlepage"><div><div><h3 class="title"><a name="Anlegen-der-Authentifizierungsdatenbank"></a>2.7.6. Anlegen der Authentifizierungsdatenbank</h3></div></div></div><p>Nachdem alle Einstellungen in |
|
| 66 |
<code class="filename">config/lx_office.conf</code> vorgenommen wurden, muss |
|
| 67 |
Lx-Office die Authentifizierungsdatenbank anlegen. Dieses geschieht |
|
| 68 |
automatisch, wenn Sie sich im Administrationsmodul anmelden, das unter |
|
| 69 |
der folgenden URL erreichbar sein sollte:</p><p> |
|
| 70 |
<a class="ulink" href="http://localhost/lx-erp/admin.pl" target="_top">http://localhost/lx-erp/admin.pl</a> |
|
| 71 |
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s06.html">Zur?ck</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s08.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.6. Der Task-Server </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.8. Benutzer- und Gruppenverwaltung</td></tr></table></div></body></html> |
|
| doc/html/ch02s08.html | ||
|---|---|---|
| 1 |
<html><head> |
|
| 2 |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
|
| 3 |
<title>2.8. Benutzer- und Gruppenverwaltung</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="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s07.html" title="2.7. Benutzerauthentifizierung und Administratorpasswort"><link rel="next" href="ch02s09.html" title="2.9. Drucken mit Lx-Office"></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">2.8. Benutzer- und Gruppenverwaltung</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s07.html">Zur?ck</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s09.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.8. Benutzer- und Gruppenverwaltung"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Benutzer--und-Gruppenverwaltung"></a>2.8. Benutzer- und Gruppenverwaltung</h2></div></div></div><p>Nach der Installation m?ssen Benutzer, Gruppen und Datenbanken |
|
| 4 |
angelegt werden. Dieses geschieht im Administrationsmen?, das Sie unter |
|
| 5 |
folgender URL finden:</p><p> |
|
| 6 |
<a class="ulink" href="http://localhost/lx-erp/admin.pl" target="_top">http://localhost/lx-erp/admin.pl</a> |
|
| 7 |
</p><p>Verwenden Sie zur Anmeldung das Password, dass Sie in der Datei |
|
| 8 |
<code class="filename">config/lx_office.conf</code> eingetragen haben.</p><div class="sect2" title="2.8.1. Zusammenh?nge"><div class="titlepage"><div><div><h3 class="title"><a name="Zusammenh%C3%A4nge"></a>2.8.1. Zusammenh?nge</h3></div></div></div><p>Lx-Office verwendet eine Datenbank zum Speichern all seiner |
|
| 9 |
Informationen wie Kundendaten, Artikel, Angebote, Rechnungen etc. Um |
|
| 10 |
mit Lx-Office arbeiten zu k?nnen, muss eine Person einen |
|
| 11 |
Benutzeraccount haben. Jedem Benutzeraccount wiederum wird genau eine |
|
| 12 |
Datenbank zugewiesen, mit der dieser Benutzer arbeiten kann. Es ist |
|
| 13 |
m?glich und normal, dass mehreren Benutzern die selbe Datenbank |
|
| 14 |
zugewiesen wird, sodass sie alle mit den selben Daten arbeiten |
|
| 15 |
k?nnen.</p><p>Die Basisdaten der Benutzer, die in der Administration |
|
| 16 |
eingegeben werden k?nnen, werden in einer zweiten Datenbank |
|
| 17 |
gespeichert, der bereits erw?hnten Authentifizierungsdatenbank. Diese |
|
| 18 |
ist also den Produktivdaten enthaltenden Datenbanken vorgeschaltet. |
|
| 19 |
Pro Lx-Office-Installation gibt es nur eine |
|
| 20 |
Authentifizierungsdatenbank, aber beliebig viele Datenbanken mit |
|
| 21 |
Firmendaten.</p><p>Lx-Office kann seinen Benutzern Zugriff auf bestimmte |
|
| 22 |
Funktionsbereiche erlauben oder verbieten. Wird der Zugriff nicht |
|
| 23 |
gestattet, so werden der entsprechenden Men?punkte auch nicht |
|
| 24 |
angezeigt. Diese Rechte werden ebenfalls in der |
|
| 25 |
Authentifizierungsdatenbank gespeichert.</p><p>Um Rechte verteilen zu k?nnen, verwendet Lx-Office ein |
|
| 26 |
Gruppen-Prinzip. Einer Gruppe kann der Zugriff auf bestimmte Bereiche |
|
| 27 |
erlaubt werden. Ein Benutzer wiederum kann Mitglied in einer oder |
|
| 28 |
mehrerer Gruppen sein. Der Benutzer hat Zugriff auf alle diejenigen |
|
| 29 |
Funktionen, die mindestens einer Gruppe erlaubt sind, in der der |
|
| 30 |
Benutzer Mitglied ist.</p><p>Die allgemeine Reihenfolge, in der Datenbanken, Gruppen und |
|
| 31 |
Benutzer angelegt werden sollten, lautet:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Datenbank anlegen</p></li><li class="listitem"><p>Gruppen anlegen</p></li><li class="listitem"><p>Benutzer anlegen</p></li><li class="listitem"><p>Benutzer den Gruppen zuordnen</p></li></ol></div></div><div class="sect2" title="2.8.2. Datenbanken anlegen"><div class="titlepage"><div><div><h3 class="title"><a name="Datenbanken-anlegen"></a>2.8.2. Datenbanken anlegen</h3></div></div></div><p>Zuerst muss eine Datenbank angelegt werden. Verwenden Sie f?r |
|
| 32 |
den Datenbankzugriff den vorhin angelegten Benutzer (in unseren |
|
| 33 |
Beispielen ist dies ‘<code class="literal">lxoffice</code>’).</p><p>Wenn Sie f?r die Lx-Office-Installation nicht den europ?ischen |
|
| 34 |
Schriftsatz ISO-8859-15 sondern UTF-8 (Unicode) benutzen wollen, so |
|
| 35 |
m?ssen Sie vor dem Anlegen der Datenbank in der Datei |
|
| 36 |
<code class="filename">config/lx_office.conf</code> die Variable |
|
| 37 |
<code class="literal">dbcharset</code> im Abschnitt <code class="literal">system</code> |
|
| 38 |
auf den Wert ‘<code class="literal">UTF-8</code>’ setzen. Zus?tzlich muss beim |
|
| 39 |
Anlegen der Datenbank ‘<code class="literal">UTF-8 Unicode</code>’ als |
|
| 40 |
Schriftsatz ausgew?hlt werden.</p><p>Bitte beachten Sie, dass alle Datenbanken den selben Zeichensatz |
|
| 41 |
verwenden m?ssen, da diese Einstellungen momentan global in Lx-Office |
|
| 42 |
vorgenommen wird und nicht nach Datenbank unterschieden werden kann. |
|
| 43 |
Auch die Authentifizierungsdatenbank muss mit diesem Zeichensatz |
|
| 44 |
angelegt worden sein.</p></div><div class="sect2" title="2.8.3. Gruppen anlegen"><div class="titlepage"><div><div><h3 class="title"><a name="Gruppen-anlegen"></a>2.8.3. Gruppen anlegen</h3></div></div></div><p>Eine Gruppe wird in der Gruppenverwaltung angelegt. Ihr muss ein |
|
| 45 |
Name gegeben werden, eine Beschreibung ist hingegen optional. Nach dem |
|
| 46 |
Anlegen k?nnen Sie die verschiedenen Bereiche w?hlen, auf die |
|
| 47 |
Mitglieder dieser Gruppe Zugriff haben sollen.</p><p>Benutzergruppen sind unabh?ngig von Datenbanken, da sie in der |
|
| 48 |
Authentifizierungsdatenbank gespeichert werden. Sie gelten f?r alle |
|
| 49 |
Datenbanken, die in dieser Installation verwaltet werden.</p></div><div class="sect2" title="2.8.4. Benutzer anlegen"><div class="titlepage"><div><div><h3 class="title"><a name="Benutzer-anlegen"></a>2.8.4. Benutzer anlegen</h3></div></div></div><p>Beim Anlegen von Benutzern werden f?r viele Parameter |
|
| 50 |
Standardeinstellungen vorgenommen, die den Gepflogenheiten des |
|
| 51 |
deutschen Raumes entsprechen.</p><p>Zwingend anzugeben sind der Loginname sowie die komplette |
|
| 52 |
Datenbankkonfiguration. Wenn die Passwortauthentifizierung ?ber die |
|
| 53 |
Datenbank eingestellt ist, so kann hier auch das Benutzerpasswort |
|
| 54 |
gesetzt bzw. ge?ndert werden. Ist hingegen die LDAP-Authentifizierung |
|
| 55 |
aktiv, so ist das Passwort-Feld deaktiviert.</p><p>In der Datenbankkonfiguration m?ssen die Zugriffsdaten einer der |
|
| 56 |
eben angelegten Datenbanken eingetragen werden.</p></div><div class="sect2" title="2.8.5. Gruppenmitgliedschaften verwalten"><div class="titlepage"><div><div><h3 class="title"><a name="Gruppenmitgliedschaften-verwalten"></a>2.8.5. Gruppenmitgliedschaften verwalten</h3></div></div></div><p>Nach dem Anlegen von Benutzern und Gruppen m?ssen Benutzer den |
|
| 57 |
Gruppen zugewiesen werden. Dazu gibt es zwei M?glichkeiten:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>In der Gruppenverwaltung w?hlt man eine Gruppe aus. Im |
|
| 58 |
folgenden Dialog kann man dann einzeln die Benutzer der Gruppe |
|
| 59 |
hinzuf?gen.</p></li><li class="listitem"><p>In der Gruppenverwaltung w?hlt man das Tool zur Verwaltung |
|
| 60 |
der Gruppenmitgliedschaft. Hier wird eine Matrix angezeigt, die |
|
| 61 |
alle im System angelegten Gruppen und Benutzer enth?lt. Durch |
|
| 62 |
Setzen der H?kchen wird der Benutzer in der ausgew?hlten Zeile der |
|
| 63 |
Gruppe in der ausgew?hlten Spalte hinzugef?gt.</p></li></ol></div></div><div class="sect2" title="2.8.6. Migration alter Installationen"><div class="titlepage"><div><div><h3 class="title"><a name="Migration-alter-Installationen"></a>2.8.6. Migration alter Installationen</h3></div></div></div><p>Wenn Lx-Office 2.6.2 ?ber eine ?ltere Version installiert wird, |
|
| 64 |
in der die Benutzerdaten noch im Dateisystem im Verzeichnis |
|
| 65 |
<code class="literal">users</code> verwaltet wurden, so bietet Lx-Office die |
|
| 66 |
M?glichkeit, diese Benutzerdaten automatisch in die |
|
| 67 |
Authentifizierungsdatenbank zu ?bernehmen. Dies geschieht, wenn man |
|
| 68 |
sich nach dem Update der Installation das erste Mal im |
|
| 69 |
Administrationsbereich anmeldet. Findet Lx-Office die Datei |
|
| 70 |
<code class="literal">users/members</code>, so wird der Migrationsprozess |
|
| 71 |
gestartet.</p><p>Der Migrationsprozess ist nahezu vollautomatisch. Alle |
|
| 72 |
Benutzerdaten k?nnen ?bernommen werden. Nach den Benutzerdaten bietet |
|
| 73 |
Lx-Office noch die M?glichkeit an, dass automatisch eine |
|
| 74 |
Benutzergruppe angelegt wird. Dieser Gruppe wird Zugriff auf alle |
|
| 75 |
Funktionen von Lx-Office gew?hrt. Alle migrierten Benutzern werden |
|
| 76 |
Mitglied in dieser Gruppe. Damit wird das Verhalten von Lx-Office bis |
|
| 77 |
Version 2.4.3 inklusive wiederhergestellt, und die Benutzer k?nnen |
|
| 78 |
sich sofort wieder anmelden und mit dem System arbeiten.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s07.html">Zur?ck</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s09.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.7. Benutzerauthentifizierung und Administratorpasswort </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.9. Drucken mit Lx-Office</td></tr></table></div></body></html> |
|
| doc/html/ch02s09.html | ||
|---|---|---|
| 1 |
<html><head> |
|
| 2 |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
|
| 3 |
<title>2.9. Drucken mit Lx-Office</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="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s08.html" title="2.8. Benutzer- und Gruppenverwaltung"><link rel="next" href="ch02s10.html" title="2.10. OpenDocument-Vorlagen"></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">2.9. Drucken mit Lx-Office</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s08.html">Zur?ck</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s10.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.9. Drucken mit Lx-Office"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Drucken-mit-Lx-Office"></a>2.9. Drucken mit Lx-Office</h2></div></div></div><p>Das Drucksystem von Lx-Office benutzt von Haus aus LaTeX Vorlagen. |
|
| 4 |
Um drucken zu k?nnen, braucht der Server ein geeignetes LaTeX System. Am |
|
| 5 |
einfachsten ist dazu eine <code class="literal">texlive</code> Installation. Unter |
|
| 6 |
Debianoiden Betriebssystemen sind das die Pakete:</p><p> |
|
| 7 |
<code class="literal">texlive-latex-base texlive-latex-extra |
|
| 8 |
texlive-fonts-recommended</code> |
|
| 9 |
</p><p>Diese hinteren beiden enthalten Bibliotheken und Schriftarten die |
|
| 10 |
von den Standardvorlagen verwendet werden.</p><p>TODO: rpm Pakete.</p><p>In den allermeisten Installationen sollte drucken jetzt schon |
|
| 11 |
funktionieren. Sollte ein Fehler auftreten wirft TeX sehr lange |
|
| 12 |
Fehlerbeschreibungen, der eigentliche Fehler ist immer die erste Zeite |
|
| 13 |
die mit einem Ausrufezeichen anf?ngt. H?ufig auftretende Fehler sind zum |
|
| 14 |
Beispiel:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>! LaTeX Error: File `eurosym.sty' not found. Die entsprechende |
|
| 15 |
LaTeX-Bibliothek wurde nicht gefunden. Das tritt vor allem bei |
|
| 16 |
Vorlagen aus der Community auf. Installieren Sie die entsprechenden |
|
| 17 |
Pakete.</p></li><li class="listitem"><p>! Package inputenc Error: Unicode char \u8:桜 not set up for |
|
| 18 |
use with LaTeX. Dieser Fehler tritt auf, wenn sie versuchen mit |
|
| 19 |
einer Standardinstallation exotische utf8 Zeichen zu drucken. |
|
| 20 |
TeXLive unterst?tzt von Haus nur romanische Schriften und muss mit |
|
| 21 |
diversen Tricks dazu gebracht werden andere Zeichen zu akzeptieren. |
|
| 22 |
Adere TeX Systeme wie XeTeX schaffen hier Abhilfe.</p></li></ul></div><p>Wird garkein Fehler angezeigt sondern nur der Name des Templates, |
|
| 23 |
hei?t das normalerweise, dass das LaTeX Binary nicht gefunden wurde. |
|
| 24 |
Pr?fen Sie den Namen in der Konfiguration (Standard: |
|
| 25 |
<code class="literal">pdflatex</code>), und stellen Sie sicher, dass pdflatex |
|
| 26 |
(oder das von Ihnen verwendete System) vom Webserver ausgef?hrt werden |
|
| 27 |
darf.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s08.html">Zur?ck</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s10.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.8. Benutzer- und Gruppenverwaltung </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.10. OpenDocument-Vorlagen</td></tr></table></div></body></html> |
|
| doc/html/ch02s10.html | ||
|---|---|---|
| 1 |
<html><head> |
|
| 2 |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
|
| 3 |
<title>2.10. OpenDocument-Vorlagen</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="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s09.html" title="2.9. Drucken mit Lx-Office"><link rel="next" href="ch02s11.html" title="2.11. Konfiguration zur Einnahmen?berschussrechnung/Bilanzierung: EUR"></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">2.10. OpenDocument-Vorlagen</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s09.html">Zur?ck</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s11.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.10. OpenDocument-Vorlagen"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="OpenDocument-Vorlagen"></a>2.10. OpenDocument-Vorlagen</h2></div></div></div><p>Lx-Office unterst?tzt die Verwendung von Vorlagen im |
|
| 4 |
OpenDocument-Format, wie es OpenOffice.org ab Version 2 erzeugt. |
|
| 5 |
Lx-Office kann dabei sowohl neue OpenDocument-Dokumente als auch aus |
|
| 6 |
diesen direkt PDF-Dateien erzeugen. Um die Unterst?tzung von |
|
| 7 |
OpenDocument-Vorlagen zu aktivieren muss in der Datei |
|
| 8 |
<code class="filename">config/lx_office.conf</code> die Variable |
|
| 9 |
<code class="literal">opendocument</code> im Abschnitt |
|
| 10 |
<code class="literal">print_templates</code> auf ‘<code class="literal">1</code>’ stehen. |
|
| 11 |
Dieses ist die Standardeinstellung.</p><p>Weiterhin muss in der Datei |
|
| 12 |
<code class="filename">config/lx_office.conf</code> die Variable |
|
| 13 |
<code class="literal">dbcharset</code> im Abschnitt <code class="literal">system</code> auf |
|
| 14 |
die Zeichenkodierung gesetzt werden, die auch bei der Speicherung der |
|
| 15 |
Daten in der Datenbank verwendet wird. Diese ist in den meisten F?llen |
|
| 16 |
"UTF-8".</p><p>W?hrend die Erzeugung von reinen OpenDocument-Dateien keinerlei |
|
| 17 |
weitere Software ben?tigt, wird zur Umwandlung dieser Dateien in PDF |
|
| 18 |
OpenOffice.org ben?tigt. Soll dieses Feature genutzt werden, so muss |
|
| 19 |
neben OpenOffice.org ab Version 2 auch der “X virtual frame buffer” |
|
| 20 |
(xvfb) installiert werden. Bei Debian ist er im Paket “xvfb” enthalten. |
|
| 21 |
Andere Distributionen enthalten ihn in anderen Paketen.</p><p>Nach der Installation m?ssen in der Datei |
|
| 22 |
<code class="filename">config/lx_config.conf</code> zwei weitere Variablen |
|
| 23 |
angepasst werden: <code class="literal">openofficeorg_writer</code> muss den |
|
| 24 |
vollst?ndigen Pfad zur OpenOffice.org Writer-Anwendung enthalten. |
|
| 25 |
<code class="literal">xvfb</code> muss den Pfad zum “X virtual frame buffer” |
|
| 26 |
enthalten. Beide stehen im Abschnitt |
|
| 27 |
<code class="literal">applications</code>.</p><p>Zus?tzlich gibt es zwei verschiedene Arten, wie Lx-Office mit |
|
| 28 |
OpenOffice kommuniziert. Die erste Variante, die benutzt wird, wenn die |
|
| 29 |
Variable <code class="literal">$openofficeorg_daemon</code> gesetzt ist, startet |
|
| 30 |
ein OpenOffice, das auch nach der Umwandlung des Dokumentes gestartet |
|
| 31 |
bleibt. Bei weiteren Umwandlungen wird dann diese laufende Instanz |
|
| 32 |
benutzt. Der Vorteil ist, dass die Zeit zur Umwandlung deutlich |
|
| 33 |
reduziert wird, weil nicht f?r jedes Dokument ein OpenOffice gestartet |
|
| 34 |
werden muss. Der Nachteil ist, dass diese Methode Python und die |
|
| 35 |
Python-UNO-Bindings ben?tigt, die Bestandteil von OpenOffice 2 |
|
| 36 |
sind.</p><p>Ist <code class="literal">$openofficeorg_daemon</code> nicht gesetzt, so |
|
| 37 |
wird f?r jedes Dokument OpenOffice neu gestartet und die Konvertierung |
|
| 38 |
mit Hilfe eines Makros durchgef?hrt. Dieses Makro muss in der |
|
| 39 |
Dokumentenvorlage enthalten sein und |
|
| 40 |
“Standard.Conversion.ConvertSelfToPDF()” hei?en. Die Beispielvorlage |
|
| 41 |
‘<code class="literal">templates/mastertemplates/German/invoice.odt</code>’ |
|
| 42 |
enth?lt ein solches Makro, das in jeder anderen Dokumentenvorlage |
|
| 43 |
ebenfalls enthalten sein muss.</p><p>Als letztes muss herausgefunden werden, welchen Namen |
|
| 44 |
OpenOffice.org Writer dem Verzeichnis mit den Benutzereinstellungen |
|
| 45 |
gibt. Unter Debian ist dies momentan |
|
| 46 |
<code class="literal">~/.openoffice.org2</code>. Sollte der Name bei Ihrer |
|
| 47 |
OpenOffice.org-Installation anders sein, so muss das Verzeichnis |
|
| 48 |
<code class="literal">users/.openoffice.org2</code> entsprechend umbenannt werden. |
|
| 49 |
Ist der Name z.B. einfach nur <code class="literal">.openoffice</code>, so w?re |
|
| 50 |
folgender Befehl auszuf?hren:</p><p> |
|
| 51 |
<code class="literal">mv users/.openoffice.org2 |
|
| 52 |
users/.openoffice</code> |
|
| 53 |
</p><p>Dieses Verzeichnis, wie auch das komplette |
|
| 54 |
<code class="literal">users</code>-Verzeichnis, muss vom Webserver beschreibbar |
|
| 55 |
sein. Dieses wurde bereits erledigt (siehe <a class="xref" href="ch02s02.html" title="2.2. Manuelle Installation des Programmpaketes">Manuelle Installation des Programmpaketes</a>), kann aber erneut |
|
| 56 |
?berpr?ft werden, wenn die Konvertierung nach PDF fehlschl?gt.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s09.html">Zur?ck</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s11.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.9. Drucken mit Lx-Office </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.11. Konfiguration zur Einnahmen?berschussrechnung/Bilanzierung: EUR</td></tr></table></div></body></html> |
|
| doc/html/ch02s11.html | ||
|---|---|---|
| 1 |
<html><head> |
|
| 2 |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
|
| 3 |
<title>2.11. Konfiguration zur Einnahmen?berschussrechnung/Bilanzierung: EUR</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="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s10.html" title="2.10. OpenDocument-Vorlagen"><link rel="next" href="ch02s12.html" title="2.12. Lx-Office ERP verwenden"></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">2.11. Konfiguration zur Einnahmen?berschussrechnung/Bilanzierung: EUR</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s10.html">Zur?ck</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s12.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.11. Konfiguration zur Einnahmen?berschussrechnung/Bilanzierung: EUR"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="config.eur"></a>2.11. Konfiguration zur Einnahmen?berschussrechnung/Bilanzierung: EUR</h2></div></div></div><div class="sect2" title="2.11.1. Einf?hrung"><div class="titlepage"><div><div><h3 class="title"><a name="config.eur.introduction"></a>2.11.1. Einf?hrung</h3></div></div></div><p> |
|
| 4 |
Lx-Office besa? bis inklusive Version 2.6.3 einen Konfigurationsparameter namens <code class="varname">eur</code>, der sich in der |
|
| 5 |
Konfigurationsdatei <code class="filename">config/lx_office.conf</code> befindet. Somit galt er f?r alle Mandanten, die in dieser |
|
| 6 |
Installation benutzt wurden. |
|
| 7 |
</p><p> |
|
| 8 |
Mit der nachfolgenden Version wurde der Parameter zum Einen in die Mandantendatenbank verschoben und dabei auch gleich in drei |
|
| 9 |
Einzelparameter aufgeteilt, mit denen sich das Verhalten genauer steuern l?sst. |
|
| 10 |
</p></div><div class="sect2" title="2.11.2. Konfigurationsparameter"><div class="titlepage"><div><div><h3 class="title"><a name="config.eur.parameters"></a>2.11.2. Konfigurationsparameter</h3></div></div></div><p> |
|
| 11 |
Es gibt drei Parameter, die die Gewinnermittlungsart, Versteuerungsart und die Warenbuchungsmethode regeln: |
|
| 12 |
</p><div class="variablelist"><dl><dt><span class="term"> |
|
| 13 |
<code class="varname">profit_determination</code> |
|
| 14 |
</span></dt><dd><p> |
|
| 15 |
Dieser Parameter legt die Berechnungsmethode f?r die Gewinnermittlung fest. Er enth?lt entweder <code class="literal">balance</code> f?r |
|
| 16 |
Betriebsverm?gensvergleich/Bilanzierung oder <code class="literal">income</code> f?r die Einnahmen-?berschuss-Rechnung. |
|
| 17 |
</p></dd><dt><span class="term"> |
|
| 18 |
<code class="varname">accounting_method</code> |
|
| 19 |
</span></dt><dd><p> |
|
| 20 |
Dieser Parameter steuert die Buchungs- und Berechnungsmethoden f?r die Versteuerungsart. Er enth?lt entweder |
|
| 21 |
<code class="literal">accrual</code> f?r die Soll-Versteuerung oder <code class="literal">cash</code> f?r die Ist-Versteuerung. |
|
| 22 |
</p></dd><dt><span class="term"> |
|
| 23 |
<code class="varname">inventory_system</code> |
|
| 24 |
</span></dt><dd><p> |
|
| 25 |
Dieser Parameter legt die Warenbuchungsmethode fest. Er enth?lt entweder <code class="literal">perpetual</code> f?r die Bestandsmethode |
|
| 26 |
oder <code class="literal">periodic</code> f?r die Aufwandsmethode. |
|
| 27 |
</p></dd></dl></div><p> |
|
| 28 |
Zum Vergleich der Funktionalit?t bis und nach 2.6.3: <code class="varname">eur</code> = 1 bedeutete Einnahmen-?berschuss-Rechnung, |
|
| 29 |
Ist-Versteuerung und Aufwandsmethode. <code class="varname">eur</code> = 0 bedeutete hingegen Bilanzierung, Soll-Versteuerung und |
|
| 30 |
Bestandsmethode. |
|
| 31 |
</p><p> |
|
| 32 |
Die Konfiguration "<code class="varname">eur</code>" unter <code class="varname">[system]</code> in der <a class="link" href="ch02s03.html" title="2.3. Lx-Office-Konfigurationsdatei">Konfigurationsdatei</a> |
|
| 33 |
<code class="filename">config/lx_office.conf</code> wird nun nicht mehr ben?tigt und |
|
| 34 |
kann entfernt werden. Dies muss manuell geschehen. |
|
| 35 |
</p></div><div class="sect2" title="2.11.3. Festlegen der Parameter"><div class="titlepage"><div><div><h3 class="title"><a name="config.eur.setting-parameters"></a>2.11.3. Festlegen der Parameter</h3></div></div></div><p> |
|
| 36 |
Beim Anlegen eines neuen Mandanten bzw. einer neuen Datenbank in der Admininstration k?nnen diese Optionen nun unabh?ngig |
|
| 37 |
voneinander eingestellt werden. |
|
| 38 |
</p><p> |
|
| 39 |
Beim Upgrade bestehender Mandanten wird eur ausgelesen und die Variablen werden so gesetzt, da? sich an der Funktionalit?t nichts |
|
| 40 |
?ndert. |
|
| 41 |
</p><p> |
|
| 42 |
Die aktuelle Konfiguration wird unter Nummernkreise und Standardkonten unter dem neuen Punkt "Einstellungen" angezeigt (read-only). |
|
| 43 |
Eine sp?tere ?nderung ist f?r einen bestehenden Mandanten nicht mehr m?glich. Dies war auch vorher nicht m?glich, bzw. vorhandene |
|
| 44 |
Daten wurden so belassen und haben damit die Ergebnisse verf?lscht. |
|
| 45 |
</p></div><div class="sect2" title="2.11.4. Bemerkungen zu Bestandsmethode"><div class="titlepage"><div><div><h3 class="title"><a name="config.eur.inventory-system-perpetual"></a>2.11.4. Bemerkungen zu Bestandsmethode</h3></div></div></div><p> |
|
| 46 |
Die Bestandsmethode ist eigentlich eine sehr elegante Methode, funktioniert in Lx-Office aber nur unter bestimmten Bedingungen: |
|
| 47 |
Voraussetzung ist, da? auch immer alle Einkaufsrechnungen gepflegt werden, und man beim Jahreswechsel nicht mit einer leeren |
|
| 48 |
Datenbank anf?ngt, da bei jedem Verkauf anhand der gesamten Rechnungshistorie der Einkaufswert der Ware nach dem FIFO-Prinzip aus |
|
| 49 |
den Einkaufsrechnungen berechnet wird. |
|
| 50 |
</p><p> |
|
| 51 |
Die Bestandsmethode kann vom Prinzip her also nur funktioneren, wenn man mit den Buchungen bei Null anf?ngt, und man kann auch nicht |
|
| 52 |
im laufenden Betrieb von der Aufwandsmethode zur Bestandsmethode wechseln. |
|
| 53 |
</p></div><div class="sect2" title="2.11.5. Bekannte Probleme"><div class="titlepage"><div><div><h3 class="title"><a name="config.eur.knonw-issues"></a>2.11.5. Bekannte Probleme</h3></div></div></div><p> |
|
| 54 |
Bei bestimmten Berichten kann man derzeit noch inviduell einstellen, ob man nach Ist- oder Sollversteuerung auswertet, und es werden |
|
| 55 |
im Code Variablen wie $accrual oder $cash gesetzt. Diese Codestellen wurden noch nicht angepasst, sondern nur die, wo bisher |
|
| 56 |
die Konfigurationsvariable <code class="varname">$::lx_office_conf{system}->{eur}</code> ausgewertet wurde.
|
|
| 57 |
</p><p> |
|
| 58 |
Es fehlen Hilfetext beim Neuanlegen eines Mandanten, was die Optionen bewirken, z.B. mit zwei Standardf?llen. |
|
| 59 |
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s10.html">Zur?ck</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s12.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.10. OpenDocument-Vorlagen </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.12. Lx-Office ERP verwenden</td></tr></table></div></body></html> |
|
| doc/html/ch02s12.html | ||
|---|---|---|
| 1 |
<html><head> |
|
| 2 |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
|
| 3 |
<title>2.12. Lx-Office ERP verwenden</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="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s11.html" title="2.11. Konfiguration zur Einnahmen?berschussrechnung/Bilanzierung: EUR"><link rel="next" href="ch03.html" title="Kapitel 3. Features und Funktionen"></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">2.12. Lx-Office ERP verwenden</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s11.html">Zur?ck</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch03.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.12. Lx-Office ERP verwenden"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Lx-Office-ERP-verwenden"></a>2.12. Lx-Office ERP verwenden</h2></div></div></div><p>Nach erfolgreicher Installation ist der Loginbildschirm unter |
|
| 4 |
folgender URL erreichbar:</p><p> |
|
| 5 |
<a class="ulink" href="http://localhost/lx-office-erp/login.pl" target="_top">http://localhost/lx-office-erp/login.pl</a> |
|
| 6 |
</p><p>Die Administrationsseite erreichen Sie unter:</p><p> |
|
| 7 |
<a class="ulink" href="http://localhost/lx-office-erp/admin.pl" target="_top">http://localhost/lx-office-erp/admin.pl</a> |
|
| 8 |
</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s11.html">Zur?ck</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch03.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.11. Konfiguration zur Einnahmen?berschussrechnung/Bilanzierung: EUR </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> Kapitel 3. Features und Funktionen</td></tr></table></div></body></html> |
|
| doc/html/ch03.html | ||
|---|---|---|
| 1 |
<html><head> |
|
| 2 |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
|
| 3 |
<title>Kapitel 3. Features und Funktionen</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="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="index.html" title="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="prev" href="ch02s12.html" title="2.12. Lx-Office ERP verwenden"><link rel="next" href="ch03s02.html" title="3.2. Dokumentenvorlagen und verf?gbare Variablen"></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">Kapitel 3. Features und Funktionen</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s12.html">Zur?ck</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch03s02.html">Weiter</a></td></tr></table><hr></div><div class="chapter" title="Kapitel 3. Features und Funktionen"><div class="titlepage"><div><div><h2 class="title"><a name="features"></a>Kapitel 3. Features und Funktionen</h2></div></div></div><div class="sect1" title="3.1. Wiederkehrende Rechnungen"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="features.periodic-invoices"></a>3.1. Wiederkehrende Rechnungen</h2></div></div></div><div class="sect2" title="3.1.1. Einf?hrung"><div class="titlepage"><div><div><h3 class="title"><a name="features.periodic-invoices.introduction"></a>3.1.1. Einf?hrung</h3></div></div></div><p> |
|
| 4 |
Wiederkehrende Rechnungen werden als normale Auftr?ge definiert und konfiguriert, mit allen dazugeh?rigen Kunden- und |
|
| 5 |
Artikelangaben. Die konfigurierten Auftr?ge werden sp?ter automatisch in Rechnungen umgewandelt, so als ob man den Workflow benutzen |
|
| 6 |
w?rde, und auch die Auftragsnummer wird ?bernommen, sodass alle wiederkehrenden Rechnungen, die aus einem Auftrag erstellt wurden, |
|
| 7 |
sp?ter leicht wiederzufinden sind. |
|
| 8 |
</p></div><div class="sect2" title="3.1.2. Konfiguration"><div class="titlepage"><div><div><h3 class="title"><a name="features.periodic-invoices.configuration"></a>3.1.2. Konfiguration</h3></div></div></div><p> |
|
| 9 |
Um einen Auftrag f?r wiederkehrende Rechnung zu konfigurieren, findet sich beim Bearbeiten des Auftrags ein neuer Knopf |
|
| 10 |
"Konfigurieren", der ein neues Fenster ?ffnet, in dem man die n?tigen Parameter einstellen kann. Hinter dem Knopf wird au?erdem noch |
|
| 11 |
angezeigt, ob der Auftrag als wiederkehrende Rechnung konfiguriert ist oder nicht. |
|
| 12 |
</p><p> |
|
| 13 |
Folgende Parameter kann man konfigurieren: |
|
| 14 |
</p><div class="variablelist"><dl><dt><span class="term">Status</span></dt><dd><p> |
|
| 15 |
Bei aktiven Rechnungen wird automatisch eine Rechnung erstellt, wenn die Periodizit?t erreicht ist (z.B. Anfang eines neuen |
|
| 16 |
Monats). |
|
| 17 |
</p><p> |
|
| 18 |
Ist ein Auftrag nicht aktiv, so werden f?r ihn auch keine wiederkehrenden Rechnungen erzeugt. Stellt man nach l?ngerer |
|
| 19 |
nicht-aktiver Zeit einen Auftrag wieder auf aktiv, wird beim n?chsten Periodenwechsel f?r alle Perioden, seit der letzten aktiven |
|
| 20 |
Periode, jeweils eine Rechnung erstellt. M?chte man dies verhindern, muss man vorher das Startdatum neu setzen. |
|
| 21 |
</p><p> |
|
| 22 |
F?r gek?ndigte Auftr?ge werden nie mehr Rechnungen erstellt. Man kann sich diese Auftr?ge aber gesondert in den Berichten anzeigen |
|
| 23 |
lassen. |
|
| 24 |
</p></dd><dt><span class="term">Periodizit?t</span></dt><dd><p> |
|
| 25 |
Ob monatlich, quartalsweise oder j?hrlich auf neue Rechnungen ?berpr?ft werden soll. F?r jede Periode seit dem Startdatum wird |
|
| 26 |
?berpr?ft, ob f?r die Periode (beginnend immer mit dem ersten Tag der Periode) schon eine Rechnung erstellt wurde. Unter Umst?nden |
|
| 27 |
k?nnen bei einem Startdatum in der Vergangenheit gleich mehrere Rechnungen erstellt werden. |
|
| 28 |
</p></dd><dt><span class="term">Buchen auf</span></dt><dd><p> |
|
| 29 |
Das Forderungskonto, in der Regel "Forderungen aus Lieferungen und Leistungen". Das Gegenkonto ergibt sich aus den Buchungsgruppen |
|
| 30 |
der betreffenden Waren. |
|
| 31 |
</p></dd><dt><span class="term">Startdatum</span></dt><dd><p> |
|
| 32 |
ab welchem Datum auf Rechnungserstellung gepr?ft werden soll |
|
| 33 |
</p></dd><dt><span class="term">Enddatum</span></dt><dd><p> |
|
| 34 |
ab wann keine Rechnungen mehr erstellt werden sollen |
|
| 35 |
</p></dd><dt><span class="term">Automatische Verl?ngerung um x Monate</span></dt><dd><p> |
|
| 36 |
Sollen die wiederkehrenden Rechnungen bei Erreichen des eingetragenen Enddatums weiterhin erstellt werden, so kann man hier die |
|
| 37 |
Anzahl der Monate eingeben, um die das Enddatum automatisch nach hinten geschoben wird. |
|
| 38 |
</p></dd><dt><span class="term">Drucken</span></dt><dd><p> |
|
| 39 |
Sind Drucker konfiguriert, so kann man sich die erstellten Rechnungen auch gleich ausdrucken lassen. |
|
| 40 |
</p></dd></dl></div><p> |
|
| 41 |
Nach Erstellung der Rechnungen kann eine E-Mail mit Informationen zu den erstellten Rechnungen verschickt werden. Konfiguriert wird |
|
| 42 |
dies in der <a class="link" href="ch02s03.html#config.config-file.sections-parameters" title="2.3.2. Abschnitte und Parameter">Konfigurationsdatei</a> |
|
| 43 |
|
|
| 44 |
<code class="filename">config/lx_office.conf</code> im Abschnitt <code class="varname">[periodic_invoices]</code>. |
|
| 45 |
</p></div><div class="sect2" title="3.1.3. Auflisten"><div class="titlepage"><div><div><h3 class="title"><a name="features.periodic-invoices.reports"></a>3.1.3. Auflisten</h3></div></div></div><p> |
|
| 46 |
Unter Verkauf->Berichte->Auftr?ge finden sich zwei neue Checkboxen, "Wiederkehrende Rechnungen aktiv" und |
|
| 47 |
"Wiederkehrende Rechnungen inaktiv", mit denen man sich einen ?berglick ?ber die wiederkehrenden Rechnungen verschaffen |
|
| 48 |
kann. |
|
| 49 |
</p></div><div class="sect2" title="3.1.4. Erzeugung der eigentlichen Rechnungen"><div class="titlepage"><div><div><h3 class="title"><a name="features.periodic-invoices.task-server"></a>3.1.4. Erzeugung der eigentlichen Rechnungen</h3></div></div></div><p> |
|
| 50 |
Die zeitliche und periodische ?berpr?fung, ob eine wiederkehrende Rechnung automatisch erstellt werden soll, geschieht durch den |
|
| 51 |
<a class="link" href="ch02s06.html" title="2.6. Der Task-Server">Taskserver</a>, einen externen Dienst, der automatisch beim Start des Servers gestartet |
|
| 52 |
werden sollte. |
|
| 53 |
</p></div><div class="sect2" title="3.1.5. Erste Rechnung f?r aktuellen Monat erstellen"><div class="titlepage"><div><div><h3 class="title"><a name="features.periodic-invoices.create-for-current-month"></a>3.1.5. Erste Rechnung f?r aktuellen Monat erstellen</h3></div></div></div><p> |
|
| 54 |
Will man im laufenden Monat eine monatlich wiederkehrende Rechnung inkl. des laufenden Monats starten, stellt man das Startdatum auf |
|
| 55 |
den Monatsanfang und wartet ein paar Minuten, bis der Taskserver den neu konfigurieren Auftrag erkennt und daraus eine Rechnung |
|
| 56 |
generiert hat. Alternativ setzt man das Startdatum auf den Monatsersten des Folgemonats und erstellt die erste Rechnung direkt |
|
| 57 |
manuell ?ber den Workflow. |
|
| 58 |
</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s12.html">Zur?ck</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch03s02.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.12. Lx-Office ERP verwenden </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 3.2. Dokumentenvorlagen und verf?gbare Variablen</td></tr></table></div></body></html> |
|
| doc/html/ch03s02.html | ||
|---|---|---|
| 1 |
<html><head> |
|
| 2 |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
|
| 3 |
<title>3.2. Dokumentenvorlagen und verf?gbare Variablen</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="Lx-Office: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="prev" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="next" href="ch03s03.html" title="3.3. Excel-Vorlagen"></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">3.2. Dokumentenvorlagen und verf?gbare Variablen</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03.html">Zur?ck</a> </td><th width="60%" align="center">Kapitel 3. Features und Funktionen</th><td width="20%" align="right"> <a accesskey="n" href="ch03s03.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="3.2. Dokumentenvorlagen und verf?gbare Variablen"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="dokumentenvorlagen-und-variablen"></a>3.2. Dokumentenvorlagen und verf?gbare Variablen</h2></div></div></div><div class="sect2" title="3.2.1. Einf?hrung"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.einf%C3%BChrung"></a>3.2.1. Einf?hrung</h3></div></div></div><p>Dies ist eine Auflistung der Standard-Dokumentenvorlagen und |
|
| 4 |
aller zur Bearbeitung verf?gbaren Variablen. Eine Variable wird in |
|
| 5 |
einer Vorlage durch ihren Inhalt ersetzt, wenn sie in der Form |
|
| 6 |
<code class="function"><%variablenname%></code> verwendet wird. F?r |
|
| 7 |
LaTeX- und HTML-Vorlagen kann man die Form dieser Tags auch ver?ndern |
|
| 8 |
(siehe <a class="xref" href="ch03s02.html#dokumentenvorlagen-und-variablen.tag-style" title="3.2.4. Anfang und Ende der Tags ver?ndern">Anfang und Ende der Tags ver?ndern</a>).</p><p>Fr?her wurde hier nur ?ber LaTeX gesprochen. Inzwischen |
|
| 9 |
unterst?tzt Lx-Office aber auch OpenDocument-Vorlagen. Sofern es nicht |
|
| 10 |
ausdr?cklich eingeschr?nkt wird, gilt das im Folgenden gesagte f?r |
|
| 11 |
alle Vorlagenarten.</p><p>Insgesamt sind technisch gesehen eine ganze Menge mehr Variablen |
|
| 12 |
verf?gbar als hier aufgelistet werden. Die meisten davon k?nnen |
|
| 13 |
allerdings innerhalb einer solchen Vorlage nicht sinnvoll verwendet |
|
| 14 |
werden. Wenn eine Auflistung dieser Variablen gewollt ist, so kann |
|
| 15 |
diese wie folgt erhalten werden:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p> |
|
| 16 |
<code class="filename">SL/Form.pm</code> ?ffnen und am Anfang die |
|
| 17 |
Zeile "<span class="command"><strong>use Data::Dumper;</strong></span>" einf?gen.</p></li><li class="listitem"><p>In <code class="filename">Form.pm</code> die Funktion |
|
| 18 |
<code class="function">parse_template</code> suchen und hier die Zeile |
|
| 19 |
<span class="command"><strong>print(STDERR Dumper($self));</strong></span> einf?gen.</p></li><li class="listitem"><p>Einmal per Browser die gew?nschte Vorlage "benutzen", z.B. |
|
| 20 |
ein PDF f?r eine Rechnung erzeugen.</p></li><li class="listitem"><p>Im <code class="filename">error.log</code> Apache steht die Ausgabe |
|
| 21 |
der Variablen <code class="varname">$self</code> in der Form <code class="varname">'key' |
|
| 22 |
=> 'value',</code>. Alle <code class="varname">key</code>s sind |
|
| 23 |
verf?gbar.</p></li></ul></div></div><div class="sect2" title="3.2.2. Variablen ausgeben"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.variablen-ausgeben"></a>3.2.2. Variablen ausgeben</h3></div></div></div><p>Um eine Variable auszugeben, m?ssen sie einfach nur zwischen die |
|
| 24 |
Tags geschrieben werden, also z.B. |
|
| 25 |
<code class="varname"><%variablenname%></code>.</p><p>Optional kann man auch mit Leerzeichen getrennte Flags angeben, |
|
| 26 |
die man aber nur selten brauchen wird. Die Syntax sieht also so aus: |
|
| 27 |
<code class="varname"><%variablenname FLAG1 FLAG2%></code>. Momentan |
|
| 28 |
werden die folgenden Flags unterst?tzt:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p> |
|
| 29 |
<code class="option">NOFORMAT</code> gilt nur f?r Zahlenwerte und gibt |
|
| 30 |
den Wert ohne Formatierung, also ohne Tausendertrennzeichen mit |
|
| 31 |
mit einem Punkt als Dezimaltrennzeichen aus. N?tzlich z.B., wenn |
|
| 32 |
damit in der Vorlage z.B. von LaTeX gerechnet werden soll.</p></li><li class="listitem"><p> |
|
| 33 |
<code class="option">NOESCAPE</code> unterdr?ckt das Escapen von |
|
| 34 |
Sonderzeichen f?r die Vorlagensprache. Wenn also in einer |
|
| 35 |
Variablen bereits g?ltiger LaTeX-Code steht und dieser von LaTeX |
|
| 36 |
auch ausgewertet und nicht wortw?rtlich angezeigt werden soll, so |
|
| 37 |
ist dieses Flag sinnvoll.</p></li></ul></div><p>Beispiel:</p><pre class="programlisting"><%quototal NOFORMAT%></pre></div><div class="sect2" title="3.2.3. Verwendung in Druckbefehlen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.verwendung-in-druckbefehlen"></a>3.2.3. Verwendung in Druckbefehlen</h3></div></div></div><p>In der Admininstration k?nnen Drucker definiert werden. Auch im |
|
| 38 |
dort eingebbaren Druckbefehl k?nnen die hier aufgelisteten Variablen |
|
| 39 |
und Kontrollstrukturen verwendet werden. Ihr Inhalt wird dabei nach |
|
| 40 |
den Regeln der g?ngigen Shells formatiert, sodass Sonderzeichen wie |
|
| 41 |
<code class="function">`...`</code> nicht zu unerw?nschtem Verhalten |
|
| 42 |
f?hren.</p><p>Dies erlaubt z.B. die Definition eines Faxes als Druckerbefehl, |
|
| 43 |
f?r das die Telefonnummer eines Ansprechpartners als Teil der |
|
| 44 |
Kommandozeile verwendet wird. F?r ein fiktives Kommando k?nnte das |
|
| 45 |
z.B. wie folgt aussehen:</p><pre class="programlisting">send_fax --number <%if cp_phone2%><%cp_phone2%><%else%><%cp_phone1%><%end%></pre></div><div class="sect2" title="3.2.4. Anfang und Ende der Tags ver?ndern"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.tag-style"></a>3.2.4. Anfang und Ende der Tags ver?ndern</h3></div></div></div><p>Der Standardstil f?r Tags sieht vor, dass ein Tag mit dem |
|
| 46 |
Kleinerzeichen und einem Prozentzeichen beginnt und mit dem |
|
| 47 |
Prozentzeichen und dem Gr??erzeichen endet, beispielsweise |
|
| 48 |
<code class="function"><%customer%></code>. Da diese Form aber z.B. in |
|
| 49 |
LaTeX zu Problemen f?hren kann, weil das Prozentzeichen dort |
|
| 50 |
Kommentare einleitet, kann pro HTML- oder LaTeX-Dokumentenvorlage der |
|
| 51 |
Stil umgestellt werden.</p><p>Dazu werden in die Datei Zeilen geschrieben, die mit dem f?r das |
|
| 52 |
Format g?ltigen Kommentarzeichen anfangen, dann |
|
| 53 |
<code class="function">config:</code> enthalten, die entsprechende Option |
|
| 54 |
setzen und bei HTML-Dokumentenvorlagen mit dem Kommentarendzeichen |
|
| 55 |
enden. Beispiel f?r LaTeX:</p><pre class="programlisting">% config: tag-style=($ $)</pre><p>Dies w?rde Lx-Office dazu veranlassen, Variablen zu ersetzen, |
|
| 56 |
wenn sie wie folgt aussehen: <code class="function">($customer$)</code>. Das |
|
| 57 |
?quivalente Beispiel f?r HTML-Dokumentenvorlagen sieht so aus:</p><pre class="programlisting"><!-- config: tag-style=($ $) --></pre></div><div class="sect2" title="3.2.5. Zuordnung von den Dateinamen zu den Funktionen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.zuordnung-dateinamen"></a>3.2.5. Zuordnung von den Dateinamen zu den Funktionen</h3></div></div></div><p>Diese folgende kurze Auflistung zeigt, welche Vorlage bei |
|
| 58 |
welcher Funktion ausgelesen wird. Dabei ist die Dateiendung |
|
| 59 |
"<code class="filename">.ext</code>" geeignet zu ersetzen: |
|
| 60 |
"<code class="filename">.tex</code>" f?r LaTeX-Vorlagen und |
|
| 61 |
"<code class="filename">.odt</code>" f?r OpenDocument-Vorlagen.</p><div class="variablelist"><dl><dt><span class="term"> |
|
| 62 |
<code class="filename">bin_list.ext</code> |
|
| 63 |
</span></dt><dd><p>Lagerliste</p></dd><dt><span class="term"> |
|
| 64 |
<code class="filename">check.ext</code> |
|
| 65 |
</span></dt><dd><p>?</p></dd><dt><span class="term"> |
|
| 66 |
<code class="filename">invoice.ext</code> |
|
| 67 |
</span></dt><dd><p>Rechnung</p></dd><dt><span class="term"> |
|
| 68 |
<code class="filename">packing_list.ext</code> |
|
| 69 |
</span></dt><dd><p>Packliste</p></dd><dt><span class="term"> |
|
| 70 |
<code class="filename">pick_list.ext</code> |
|
| 71 |
</span></dt><dd><p>Sammelliste</p></dd><dt><span class="term"> |
|
| 72 |
<code class="filename">purchase_delivery_order.ext</code> |
|
| 73 |
</span></dt><dd><p>Lieferschein (Einkauf)</p></dd><dt><span class="term"> |
|
| 74 |
<code class="filename">purcharse_order.ext</code> |
|
| 75 |
</span></dt><dd><p>Bestellung an Lieferanten</p></dd><dt><span class="term"> |
|
| 76 |
<code class="filename">request_quotation.ext</code> |
|
| 77 |
</span></dt><dd><p>Anfrage an Lieferanten</p></dd><dt><span class="term"> |
|
| 78 |
<code class="filename">sales_delivery_order.ext</code> |
|
| 79 |
</span></dt><dd><p>Lieferschein (Verkauf)</p></dd><dt><span class="term"> |
|
| 80 |
<code class="filename">sales_order.ext</code> |
|
| 81 |
</span></dt><dd><p>Bestellung</p></dd><dt><span class="term"> |
|
| 82 |
<code class="filename">sales_quotation.ext</code> |
|
| 83 |
</span></dt><dd><p>Angebot an Kunden</p></dd><dt><span class="term"> |
|
| 84 |
<code class="filename">zahlungserinnerung.ext</code> |
|
| 85 |
</span></dt><dd><p>Mahnung (Dateiname im Programm konfigurierbar)</p></dd><dt><span class="term"> |
|
| 86 |
<code class="filename">zahlungserinnerung_invoice.ext</code> |
|
| 87 |
</span></dt><dd><p>Rechnung ?ber Mahngeb?hren (Dateiname im Programm |
|
| 88 |
konfigurierbar)</p></dd></dl></div></div><div class="sect2" title="3.2.6. Sprache, Drucker und E-Mail"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.dateinamen-erweitert"></a>3.2.6. Sprache, Drucker und E-Mail</h3></div></div></div><p>Angeforderte Sprache und Druckerk?rzel in den Dateinamen mit |
|
| 89 |
eingearbeitet. So wird aus der Vorlage |
|
| 90 |
<code class="filename">sales_order.ext</code> bei Sprache |
|
| 91 |
<code class="function">de</code> und Druckerk?rzel <code class="function">lpr2</code> |
|
| 92 |
der Vorlagenname <code class="filename">sales_order_de_lpr2.ext</code>. |
|
| 93 |
Zus?tzlich k?nnen f?r E-Mails andere Vorlagen erstellt werden, diese |
|
| 94 |
bekommen dann noch das K?rzel <code class="filename">_email</code>, der |
|
| 95 |
vollst?ndige Vorlagenname w?re dann |
|
| 96 |
<code class="filename">sales_order_email_de_lpr2.ext</code>. In allen F?llen |
|
| 97 |
kann eine Standarddatei <code class="filename">default.ext</code> hinterlegt |
|
| 98 |
werden. Diese wird verwendet, wenn keine der anderen Varianten |
|
| 99 |
gefunden wird.</p><p>Die vollst?ndige Suchreihenfolge f?r einen Verkaufsauftrag mit |
|
| 100 |
der Sprache "de" und dem Drucker "lpr2", der per E-Mail im Format PDF |
|
| 101 |
verschickt wird, ist:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p> |
|
| 102 |
<code class="filename">sales_order_email_de_lpr2.tex</code> |
|
| 103 |
</p></li><li class="listitem"><p> |
|
| 104 |
<code class="filename">sales_order_de_lpr2.tex</code> |
|
| 105 |
</p></li><li class="listitem"><p> |
|
| 106 |
<code class="filename">sales_order.tex</code> |
|
| 107 |
</p></li><li class="listitem"><p> |
|
| 108 |
<code class="filename">default.tex</code> |
|
| 109 |
</p></li></ol></div><p>Die kurzen Varianten dieser Vorlagentitel m?ssen dann entweder |
|
| 110 |
Standardwerte anzeigen, oder die angeforderten Werte selbst auswerten, |
|
| 111 |
siehe dazu <a class="xref" href="ch03s02.html#dokumentenvorlagen-und-variablen.allgemeine-variablen.meta" title="3.2.7.1. Metainformationen zur angeforderten Vorlage">Metainformationen zur angeforderten Vorlage</a>.</p></div><div class="sect2" title="3.2.7. Allgemeine Variablen, die in allen Vorlagen vorhanden sind"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.allgemeine-variablen"></a>3.2.7. Allgemeine Variablen, die in allen Vorlagen vorhanden |
|
| 112 |
sind</h3></div></div></div><div class="sect3" title="3.2.7.1. Metainformationen zur angeforderten Vorlage"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.allgemeine-variablen.meta"></a>3.2.7.1. Metainformationen zur angeforderten Vorlage</h4></div></div></div><p>Diese Variablen liefern Informationen dar?ber welche Variante |
|
| 113 |
einer Vorlage der Benutzer angefragt hat. Sie sind n?tzlich f?r |
|
| 114 |
Vorlagenautoren, die aus einer zentralen Layoutvorlage die einzelnen |
|
| 115 |
Formulare einbinden m?chten.</p><div class="variablelist"><dl><dt><span class="term"> |
|
| 116 |
<code class="varname">template_meta.formname</code> |
|
| 117 |
</span></dt><dd><p>Basisname der Vorlage. Identisch mit der <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.zuordnung-dateinamen" title="3.2.5. Zuordnung von den Dateinamen zu den Funktionen">Zurordnung |
|
| 118 |
zu den Dateinamen</a> ohne die Erweiterung. Ein |
|
| 119 |
Verkaufsauftrag enth?lt hier |
|
| 120 |
<code class="constant">sales_order</code>.</p></dd><dt><span class="term"> |
|
| 121 |
<code class="varname">template_meta.language.description</code> |
|
| 122 |
</span></dt><dd><p>Beschreibung der verwendeten Sprache</p></dd><dt><span class="term"> |
|
| 123 |
<code class="varname">template_meta.language.template_code</code> |
|
| 124 |
</span></dt><dd><p>Vorlagen?rzel der verwendeten Sprache, identisch mit dem |
|
| 125 |
K?rzel das im Dateinamen verwendetet wird.</p></dd><dt><span class="term"> |
|
| 126 |
<code class="varname">template_meta.language.output_numberformat</code> |
|
| 127 |
</span></dt><dd><p>Zahlenformat der verwendeten Sprache in der Form |
|
| 128 |
"<code class="constant">1.000,00</code>". Experimentell! Nur |
|
| 129 |
interessant f?r Vorlagen die mit unformatierten Werten |
|
| 130 |
arbeiten.</p></dd><dt><span class="term"> |
|
| 131 |
<code class="varname">template_meta.language.output_dateformat</code> |
|
| 132 |
</span></dt><dd><p>Datumsformat der verwendeten Sprache in der Form |
|
| 133 |
"<code class="constant">dd.mm.yyyy</code>". Experimentell! Nur |
|
| 134 |
interessant f?r Vorlagen die mit unformatierten Werten |
|
| 135 |
arbeiten.</p></dd><dt><span class="term"> |
|
| 136 |
<code class="varname">template_meta.format</code> |
|
| 137 |
</span></dt><dd><p>Das angeforderte Format. Kann im Moment die Werte |
|
| 138 |
<code class="constant">pdf</code>, <code class="constant">postscript</code>, |
|
| 139 |
<code class="constant">html</code>, <code class="constant">opendocument</code>, |
|
| 140 |
<code class="constant">opendocument_pdf</code> und |
|
| 141 |
<code class="constant">excel</code> enthalten.</p></dd><dt><span class="term"> |
|
| 142 |
<code class="varname">template_meta.extension</code> |
|
| 143 |
</span></dt><dd><p>Dateierweiterung, wie im Dateinamen. Wird aus |
|
| 144 |
<code class="constant">format</code> entschieden.</p></dd><dt><span class="term"> |
|
| 145 |
<code class="varname">template_meta.media</code> |
|
| 146 |
</span></dt><dd><p>Ausgabemedium. Kann zur Zeit die Werte |
|
| 147 |
<code class="constant">screen</code> f?r Bildschirm, |
|
| 148 |
<code class="constant">email</code> f?r E-Mmail (triggert das |
|
| 149 |
<code class="constant">_email</code> K?rzel im Dateinamen), |
|
| 150 |
<code class="constant">printer</code> f?r Drucker, und |
|
| 151 |
<code class="constant">queue</code> f?r Warteschlange enthalten.</p></dd><dt><span class="term"> |
|
| 152 |
<code class="varname">template_meta.printer.description</code> |
|
| 153 |
</span></dt><dd><p>Beschreibung des ausgew?hlten Druckers</p></dd><dt><span class="term"> |
|
| 154 |
<code class="varname">template_meta.printer.template_code</code> |
|
| 155 |
</span></dt><dd><p>Vorlagen?rzel des ausgew?hlten Druckers, identisch mit |
|
| 156 |
dem K?rzel das im Dateinamen verwendetet wird.</p></dd></dl></div></div><div class="sect3" title="3.2.7.2. Stammdaten von Kunden und Lieferanten"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.allgemeine-variablen.kunden-lieferanten"></a>3.2.7.2. Stammdaten von Kunden und Lieferanten</h4></div></div></div><div class="variablelist"><dl><dt><span class="term"> |
|
| 157 |
<code class="varname">account_number</code> |
|
| 158 |
</span></dt><dd><p>Kontonummer</p></dd><dt><span class="term"> |
|
| 159 |
<code class="varname">bank</code> |
|
| 160 |
</span></dt><dd><p>Name der Bank</p></dd><dt><span class="term"> |
|
| 161 |
<code class="varname">bank_code</code> |
|
| 162 |
</span></dt><dd><p>Bankleitzahl</p></dd><dt><span class="term"> |
|
| 163 |
<code class="varname">bic</code> |
|
| 164 |
</span></dt><dd><p>Bank-Identifikations-Code (Bank Identifier Code, |
|
| 165 |
BIC)</p></dd><dt><span class="term"> |
|
| 166 |
<code class="varname">business</code> |
|
| 167 |
</span></dt><dd><p>Kunden-/Lieferantentyp</p></dd><dt><span class="term"> |
|
| 168 |
<code class="varname">city</code> |
|
| 169 |
</span></dt><dd><p>Stadt</p></dd><dt><span class="term"> |
|
| 170 |
<code class="varname">contact</code> |
|
| 171 |
</span></dt><dd><p>Kontakt</p></dd><dt><span class="term"> |
|
| 172 |
<code class="varname">country</code> |
|
| 173 |
</span></dt><dd><p>Land</p></dd><dt><span class="term"> |
|
| 174 |
<code class="varname">cp_email</code> |
|
| 175 |
</span></dt><dd><p>Email des Ansprechpartners</p></dd><dt><span class="term"> |
|
| 176 |
<code class="varname">cp_givenname</code> |
|
| 177 |
</span></dt><dd><p>Vorname des Ansprechpartners</p></dd><dt><span class="term"> |
|
| 178 |
<code class="varname">cp_greeting</code> |
|
| 179 |
</span></dt><dd><p>Anrede des Ansprechpartners</p></dd><dt><span class="term"> |
|
| 180 |
<code class="varname">cp_name</code> |
|
| 181 |
</span></dt><dd><p>Name des Ansprechpartners</p></dd><dt><span class="term"> |
|
| 182 |
<code class="varname">cp_phone1</code> |
|
| 183 |
</span></dt><dd><p>Telefonnummer 1 des Ansprechpartners</p></dd><dt><span class="term"> |
|
| 184 |
<code class="varname">cp_phone2</code> |
|
| 185 |
</span></dt><dd><p>Telefonnummer 2 des Ansprechpartners</p></dd><dt><span class="term"> |
|
| 186 |
<code class="varname">cp_title</code> |
|
| 187 |
</span></dt><dd><p>Titel des Ansprechpartners</p></dd><dt><span class="term"> |
|
| 188 |
<code class="varname">creditlimit</code> |
|
| 189 |
</span></dt><dd><p>Kreditlimit</p></dd><dt><span class="term"> |
|
| 190 |
<code class="varname">customeremail</code> |
|
| 191 |
</span></dt><dd><p>Email des Kunden; nur f?r Kunden</p></dd><dt><span class="term"> |
|
| 192 |
<code class="varname">customerfax</code> |
|
| 193 |
</span></dt><dd><p>Faxnummer des Kunden; nur f?r Kunden</p></dd><dt><span class="term"> |
|
| 194 |
<code class="varname">customernotes</code> |
|
| 195 |
</span></dt><dd><p>Bemerkungen beim Kunden; nur f?r Kunden</p></dd><dt><span class="term"> |
|
| 196 |
<code class="varname">customernumber</code> |
|
| 197 |
</span></dt><dd><p>Kundennummer; nur f?r Kunden</p></dd><dt><span class="term"> |
|
| 198 |
<code class="varname">customerphone</code> |
|
| 199 |
</span></dt><dd><p>Telefonnummer des Kunden; nur f?r Kunden</p></dd><dt><span class="term"> |
|
| 200 |
<code class="varname">discount</code> |
|
| 201 |
</span></dt><dd><p>Rabatt</p></dd><dt><span class="term"> |
|
| 202 |
<code class="varname">email</code> |
|
| 203 |
</span></dt><dd><p>Emailadresse</p></dd><dt><span class="term"> |
|
| 204 |
<code class="varname">fax</code> |
|
| 205 |
</span></dt><dd><p>Faxnummer</p></dd><dt><span class="term"> |
|
| 206 |
<code class="varname">homepage</code> |
|
| 207 |
</span></dt><dd><p>Homepage</p></dd><dt><span class="term"> |
|
| 208 |
<code class="varname">iban</code> |
|
| 209 |
</span></dt><dd><p>Internationale Kontonummer (International Bank Account |
|
| 210 |
Number, IBAN)</p></dd><dt><span class="term"> |
|
| 211 |
<code class="varname">language</code> |
|
| 212 |
</span></dt><dd><p>Sprache</p></dd><dt><span class="term"> |
|
| 213 |
<code class="varname">name</code> |
|
| 214 |
</span></dt><dd><p>Firmenname</p></dd><dt><span class="term"> |
|
| 215 |
<code class="varname">payment_description</code> |
|
| 216 |
</span></dt><dd><p>Name der Zahlart</p></dd><dt><span class="term"> |
|
| 217 |
<code class="varname">payment_terms</code> |
|
| 218 |
</span></dt><dd><p>Zahlungskonditionen</p></dd><dt><span class="term"> |
|
| 219 |
<code class="varname">phone</code> |
|
| 220 |
</span></dt><dd><p>Telefonnummer</p></dd><dt><span class="term"> |
|
| 221 |
<code class="varname">shiptocity</code> |
|
| 222 |
</span></dt><dd><p>Stadt (Lieferadresse) <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a> |
|
| 223 |
</p></dd><dt><span class="term"> |
|
| 224 |
<code class="varname">shiptocontact</code> |
|
| 225 |
</span></dt><dd><p>Kontakt (Lieferadresse) <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a> |
|
| 226 |
</p></dd><dt><span class="term"> |
|
| 227 |
<code class="varname">shiptocountry</code> |
|
| 228 |
</span></dt><dd><p>Land (Lieferadresse) <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a> |
|
| 229 |
</p></dd><dt><span class="term"> |
|
| 230 |
<code class="varname">shiptodepartment1</code> |
|
| 231 |
</span></dt><dd><p>Abteilung 1 (Lieferadresse) <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a> |
|
| 232 |
</p></dd><dt><span class="term"> |
|
| 233 |
<code class="varname">shiptodepartment2</code> |
|
| 234 |
</span></dt><dd><p>Abteilung 2 (Lieferadresse) <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a> |
|
| 235 |
</p></dd><dt><span class="term"> |
|
| 236 |
<code class="varname">shiptoemail</code> |
|
| 237 |
</span></dt><dd><p>Email (Lieferadresse) <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a> |
|
| 238 |
</p></dd><dt><span class="term"> |
|
| 239 |
<code class="varname">shiptofax</code> |
|
| 240 |
</span></dt><dd><p>Fax (Lieferadresse) <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a> |
|
| 241 |
</p></dd><dt><span class="term"> |
|
| 242 |
<code class="varname">shiptoname</code> |
|
| 243 |
</span></dt><dd><p>Firmenname (Lieferadresse) <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a> |
|
| 244 |
</p></dd><dt><span class="term"> |
|
| 245 |
<code class="varname">shiptophone</code> |
|
| 246 |
</span></dt><dd><p>Telefonnummer (Lieferadresse) <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a> |
|
| 247 |
</p></dd><dt><span class="term"> |
|
| 248 |
<code class="varname">shiptostreet</code> |
|
| 249 |
</span></dt><dd><p>Stra?e und Hausnummer (Lieferadresse) <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a> |
|
| 250 |
</p></dd><dt><span class="term"> |
|
| 251 |
<code class="varname">shiptozipcode</code> |
|
| 252 |
</span></dt><dd><p>Postleitzahl (Lieferadresse) <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a> |
|
| 253 |
</p></dd><dt><span class="term"> |
|
| 254 |
<code class="varname">street</code> |
|
| 255 |
</span></dt><dd><p>Stra?e und Hausnummer</p></dd><dt><span class="term"> |
|
| 256 |
<code class="varname">taxnumber</code> |
|
| 257 |
</span></dt><dd><p>Steuernummer</p></dd><dt><span class="term"> |
|
| 258 |
<code class="varname">ustid</code> |
|
| 259 |
</span></dt><dd><p>Umsatzsteuer-Identifikationsnummer</p></dd><dt><span class="term"> |
|
| 260 |
<code class="varname">vendoremail</code> |
|
| 261 |
</span></dt><dd><p>Email des Lieferanten; nur f?r Lieferanten</p></dd><dt><span class="term"> |
|
| 262 |
<code class="varname">vendorfax</code> |
|
| 263 |
</span></dt><dd><p>Faxnummer des Lieferanten; nur f?r Lieferanten</p></dd><dt><span class="term"> |
|
| 264 |
<code class="varname">vendornotes</code> |
|
| 265 |
</span></dt><dd><p>Bemerkungen beim Lieferanten; nur f?r Lieferanten</p></dd><dt><span class="term"> |
|
| 266 |
<code class="varname">vendornumber</code> |
|
| 267 |
</span></dt><dd><p>Lieferantennummer; nur f?r Lieferanten</p></dd><dt><span class="term"> |
|
| 268 |
<code class="varname">vendorphone</code> |
|
| 269 |
</span></dt><dd><p>Telefonnummer des Lieferanten; nur f?r |
|
| 270 |
Lieferanten</p></dd><dt><span class="term"> |
|
| 271 |
<code class="varname">zipcode</code> |
|
| 272 |
</span></dt><dd><p>Postleitzahl</p></dd></dl></div><div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="../../../../system/docbook-xsl/images/note.png"></td><th align="left"><a name="dokumentenvorlagen-und-variablen.anmerkung-shipto"></a>Anmerkung</th></tr><tr><td align="left" valign="top"><p>Anmerkung: Sind die <code class="varname">shipto*</code>-Felder in den |
|
| 273 |
Stammdaten nicht eingetragen, so haben die Variablen |
|
| 274 |
<code class="varname">shipto*</code> den gleichen Wert wie die die |
|
| 275 |
entsprechenden Variablen der Lieferdaten. Das bedeutet, dass sich |
|
| 276 |
einige <code class="varname">shipto*</code>-Variablen so nicht in den |
|
| 277 |
Stammdaten wiederfinden sondern schlicht Kopien der |
|
| 278 |
Lieferdatenvariablen sind (z.B. |
|
| 279 |
<code class="varname">shiptocontact</code>).</p></td></tr></table></div></div><div class="sect3" title="3.2.7.3. Informationen ?ber den Bearbeiter"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.allgemein-bearbeiter"></a>3.2.7.3. Informationen ?ber den Bearbeiter</h4></div></div></div><div class="variablelist"><dl><dt><span class="term"> |
|
| 280 |
<code class="varname">employee_address</code> |
|
| 281 |
</span></dt><dd><p>Adressfeld</p></dd><dt><span class="term"> |
|
| 282 |
<code class="varname">employee_businessnumber</code> |
|
| 283 |
</span></dt><dd><p>Firmennummer</p></dd><dt><span class="term"> |
|
| 284 |
<code class="varname">employee_company</code> |
|
| 285 |
</span></dt><dd><p>Firmenname</p></dd><dt><span class="term"> |
|
| 286 |
<code class="varname">employee_co_ustid</code> |
|
| 287 |
</span></dt><dd><p>Usatzsteuer-Identifikationsnummer</p></dd><dt><span class="term"> |
|
| 288 |
<code class="varname">employee_duns</code> |
|
| 289 |
</span></dt><dd><p>DUNS-Nummer</p></dd><dt><span class="term"> |
|
| 290 |
<code class="varname">employee_email</code> |
|
| 291 |
</span></dt><dd><p>Email</p></dd><dt><span class="term"> |
|
| 292 |
<code class="varname">employee_fax</code> |
|
| 293 |
</span></dt><dd><p>Fax</p></dd><dt><span class="term"> |
|
| 294 |
<code class="varname">employee_name</code> |
|
| 295 |
</span></dt><dd><p>voller Name</p></dd><dt><span class="term"> |
|
| 296 |
<code class="varname">employee_signature</code> |
|
| 297 |
</span></dt><dd><p>Signatur</p></dd><dt><span class="term"> |
|
| 298 |
<code class="varname">employee_taxnumber</code> |
|
| 299 |
</span></dt><dd><p>Steuernummer</p></dd><dt><span class="term"> |
|
| 300 |
<code class="varname">employee_tel</code> |
|
| 301 |
</span></dt><dd><p>Telefonnummer</p></dd></dl></div></div><div class="sect3" title="3.2.7.4. Informationen ?ber den Bearbeiter"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.allgemein-verkaeufer"></a>3.2.7.4. Informationen ?ber den Bearbeiter</h4></div></div></div><div class="variablelist"><dl><dt><span class="term"> |
|
| 302 |
<code class="varname">salesman_address</code> |
|
| 303 |
</span></dt><dd><p>Adressfeld</p></dd><dt><span class="term"> |
|
| 304 |
<code class="varname">salesman_businessnumber</code> |
|
| 305 |
</span></dt><dd><p>Firmennummer</p></dd><dt><span class="term"> |
|
| 306 |
<code class="varname">salesman_company</code> |
|
| 307 |
</span></dt><dd><p>Firmenname</p></dd><dt><span class="term"> |
|
| 308 |
<code class="varname">salesman_co_ustid</code> |
|
| 309 |
</span></dt><dd><p>Usatzsteuer-Identifikationsnummer</p></dd><dt><span class="term"> |
|
| 310 |
<code class="varname">salesman_duns</code> |
|
| 311 |
</span></dt><dd><p>DUNS-Nummer</p></dd><dt><span class="term"> |
|
| 312 |
<code class="varname">salesman_email</code> |
|
| 313 |
</span></dt><dd><p>Email</p></dd><dt><span class="term"> |
|
| 314 |
<code class="varname">salesman_fax</code> |
|
| 315 |
</span></dt><dd><p>Fax</p></dd><dt><span class="term"> |
|
| 316 |
<code class="varname">salesman_name</code> |
|
| 317 |
</span></dt><dd><p>voller Name</p></dd><dt><span class="term"> |
|
| 318 |
<code class="varname">salesman_signature</code> |
|
| 319 |
</span></dt><dd><p>Signatur</p></dd><dt><span class="term"> |
|
| 320 |
<code class="varname">salesman_taxnumber</code> |
|
| 321 |
</span></dt><dd><p>Steuernummer</p></dd><dt><span class="term"> |
|
| 322 |
<code class="varname">salesman_tel</code> |
|
| 323 |
</span></dt><dd><p>Telefonnummer</p></dd></dl></div></div><div class="sect3" title="3.2.7.5. Variablen f?r die einzelnen Steuern"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.allgemein-steuern"></a>3.2.7.5. Variablen f?r die einzelnen Steuern</h4></div></div></div><div class="variablelist"><dl><dt><span class="term"> |
|
| 324 |
<code class="varname">tax</code> |
|
| 325 |
</span></dt><dd><p>Steuer</p></dd><dt><span class="term"> |
|
| 326 |
<code class="varname">taxbase</code> |
|
| 327 |
</span></dt><dd><p>zu versteuernder Betrag</p></dd><dt><span class="term"> |
|
| 328 |
<code class="varname">taxdescription</code> |
|
| 329 |
</span></dt><dd><p>Name der Steuer</p></dd><dt><span class="term"> |
|
| 330 |
<code class="varname">taxrate</code> |
|
| 331 |
</span></dt><dd><p>Steuersatz</p></dd></dl></div></div></div><div class="sect2" title="3.2.8. Variablen in Rechnungen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.invoice"></a>3.2.8. Variablen in Rechnungen</h3></div></div></div><div class="sect3" title="3.2.8.1. Allgemeine Variablen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.invoice-allgemein"></a>3.2.8.1. Allgemeine Variablen</h4></div></div></div><div class="variablelist"><dl><dt><span class="term"> |
|
| 332 |
<code class="varname">creditremaining</code> |
|
| 333 |
</span></dt><dd><p>Verbleibender Kredit</p></dd><dt><span class="term"> |
|
| 334 |
<code class="varname">currency</code> |
|
| 335 |
</span></dt><dd><p>W?hrung</p></dd><dt><span class="term"> |
|
| 336 |
<code class="varname">cusordnumber</code> |
|
| 337 |
</span></dt><dd><p>Bestellnummer beim Kunden</p></dd><dt><span class="term"> |
|
| 338 |
<code class="varname">deliverydate</code> |
|
| 339 |
</span></dt><dd><p>Lieferdatum</p></dd><dt><span class="term"> |
|
| 340 |
<code class="varname">duedate</code> |
|
| 341 |
</span></dt><dd><p>F?lligkeitsdatum</p></dd><dt><span class="term"> |
|
| 342 |
<code class="varname">globalprojectnumber</code> |
|
| 343 |
</span></dt><dd><p>Projektnummer des ganzen Beleges</p></dd><dt><span class="term"> |
|
| 344 |
<code class="varname">globalprojectdescription</code> |
|
| 345 |
</span></dt><dd><p>Projekbeschreibung des ganzen Beleges</p></dd><dt><span class="term"> |
|
| 346 |
<code class="varname">intnotes</code> |
|
| 347 |
</span></dt><dd><p>Interne Bemerkungen</p></dd><dt><span class="term"> |
|
| 348 |
<code class="varname">invdate</code> |
|
| 349 |
</span></dt><dd><p>Rechnungsdatum</p></dd><dt><span class="term"> |
|
| 350 |
<code class="varname">invnumber</code> |
|
| 351 |
</span></dt><dd><p>Rechnungsnummer</p></dd><dt><span class="term"> |
|
| 352 |
<code class="varname">invtotal</code> |
|
| 353 |
</span></dt><dd><p>gesamter Rechnungsbetrag</p></dd><dt><span class="term"> |
|
| 354 |
<code class="varname">notes</code> |
|
| 355 |
</span></dt><dd><p>Bemerkungen der Rechnung</p></dd><dt><span class="term"> |
|
| 356 |
<code class="varname">orddate</code> |
|
| 357 |
</span></dt><dd><p>Auftragsdatum</p></dd><dt><span class="term"> |
|
| 358 |
<code class="varname">ordnumber</code> |
|
| 359 |
</span></dt><dd><p>Auftragsnummer, wenn die Rechnung aus einem Auftrag |
|
| 360 |
erstellt wurde</p></dd><dt><span class="term"> |
|
| 361 |
<code class="varname">payment_description</code> |
|
| 362 |
</span></dt><dd><p>Name der Zahlart</p></dd><dt><span class="term"> |
|
| 363 |
<code class="varname">payment_terms</code> |
|
| 364 |
</span></dt><dd><p>Zahlungskonditionen</p></dd><dt><span class="term"> |
|
| 365 |
<code class="varname">quodate</code> |
|
| 366 |
</span></dt><dd><p>Angebotsdatum</p></dd><dt><span class="term"> |
|
| 367 |
<code class="varname">quonumber</code> |
|
| 368 |
</span></dt><dd><p>Angebotsnummer</p></dd><dt><span class="term"> |
|
| 369 |
<code class="varname">shippingpoint</code> |
|
| 370 |
</span></dt><dd><p>Versandort</p></dd><dt><span class="term"> |
|
| 371 |
<code class="varname">shipvia</code> |
|
| 372 |
</span></dt><dd><p>Transportmittel</p></dd><dt><span class="term"> |
|
| 373 |
<code class="varname">subtotal</code> |
|
| 374 |
</span></dt><dd><p>Zwischensumme aller Posten ohne Steuern</p></dd><dt><span class="term"> |
|
| 375 |
<code class="varname">total</code> |
|
| 376 |
</span></dt><dd><p>Restsumme der Rechnung (Summe abz?glich bereits |
|
| 377 |
bezahlter Posten)</p></dd><dt><span class="term"> |
|
| 378 |
<code class="varname">transaction_description</code> |
|
| 379 |
</span></dt><dd><p>Vorgangsbezeichnung</p></dd><dt><span class="term"> |
|
| 380 |
<code class="varname">transdate</code> |
|
| 381 |
</span></dt><dd><p>Auftragsdatum wenn die Rechnung aus einem Auftrag |
|
| 382 |
erstellt wurde</p></dd></dl></div></div><div class="sect3" title="3.2.8.2. Variablen f?r jeden Posten auf der Rechnung"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.invoice-posten"></a>3.2.8.2. Variablen f?r jeden Posten auf der Rechnung</h4></div></div></div><div class="variablelist"><dl><dt><span class="term"> |
|
| 383 |
<code class="varname">bin</code> |
|
| 384 |
</span></dt><dd><p>Stellage</p></dd><dt><span class="term"> |
|
| 385 |
<code class="varname">description</code> |
|
| 386 |
</span></dt><dd><p>Artikelbeschreibung</p></dd><dt><span class="term"> |
|
| 387 |
<code class="varname">discount</code> |
|
| 388 |
</span></dt><dd><p>Rabatt als Betrag</p></dd><dt><span class="term"> |
|
| 389 |
<code class="varname">discount_sub</code> |
|
| 390 |
</span></dt><dd><p>Zwischensumme mit Rabatt</p></dd><dt><span class="term"> |
|
| 391 |
<code class="varname">drawing</code> |
|
| 392 |
</span></dt><dd><p>Zeichnung</p></dd><dt><span class="term"> |
|
| 393 |
<code class="varname">ean</code> |
|
| 394 |
</span></dt><dd><p>EAN-Code</p></dd><dt><span class="term"> |
|
| 395 |
<code class="varname">image</code> |
|
| 396 |
</span></dt><dd><p>Grafik</p></dd><dt><span class="term"> |
|
| 397 |
<code class="varname">linetotal</code> |
|
| 398 |
</span></dt><dd><p>Zeilensumme (Anzahl * Einzelpreis)</p></dd><dt><span class="term"> |
|
| 399 |
<code class="varname">longdescription</code> |
|
| 400 |
</span></dt><dd><p>Langtext</p></dd><dt><span class="term"> |
|
| 401 |
<code class="varname">microfiche</code> |
|
| 402 |
</span></dt><dd><p>Mikrofilm</p></dd><dt><span class="term"> |
|
| 403 |
<code class="varname">netprice</code> |
|
| 404 |
</span></dt><dd><p>Nettopreis</p></dd><dt><span class="term"> |
|
| 405 |
<code class="varname">nodiscount_linetotal</code> |
|
| 406 |
</span></dt><dd><p>Zeilensumme ohne Rabatt</p></dd><dt><span class="term"> |
|
| 407 |
<code class="varname">nodiscount_sub</code> |
|
| 408 |
</span></dt><dd><p>Zwischensumme ohne Rabatt</p></dd><dt><span class="term"> |
|
| 409 |
<code class="varname">number</code> |
|
| 410 |
</span></dt><dd><p>Artikelnummer</p></dd><dt><span class="term"> |
|
| 411 |
<code class="varname">ordnumber_oe</code> |
|
| 412 |
</span></dt><dd><p>Auftragsnummer des Originalauftrags, wenn die Rechnung |
|
| 413 |
aus einem Sammelauftrag erstellt wurde</p></dd><dt><span class="term"> |
|
| 414 |
<code class="varname">p_discount</code> |
|
| 415 |
</span></dt><dd><p>Rabatt in Prozent</p></dd><dt><span class="term"> |
|
| 416 |
<code class="varname">partnotes</code> |
|
| 417 |
</span></dt><dd><p>Die beim Artikel gespeicherten Bemerkungen</p></dd><dt><span class="term"> |
|
| 418 |
<code class="varname">partsgroup</code> |
|
| 419 |
</span></dt><dd><p>Warengruppe</p></dd><dt><span class="term"> |
|
| 420 |
<code class="varname">price_factor</code> |
|
| 421 |
</span></dt><dd><p>Der Preisfaktor als Zahl, sofern einer eingestellt |
|
| 422 |
ist</p></dd><dt><span class="term"> |
|
| 423 |
<code class="varname">price_factor_name</code> |
|
| 424 |
</span></dt><dd><p>Der Name des Preisfaktors, sofern einer eingestellt |
|
| 425 |
ist</p></dd><dt><span class="term"> |
|
| 426 |
<code class="varname">projectnumber</code> |
|
| 427 |
</span></dt><dd><p>Projektnummer</p></dd><dt><span class="term"> |
|
| 428 |
<code class="varname">projectdescription</code> |
|
| 429 |
</span></dt><dd><p>Projektbeschreibung</p></dd><dt><span class="term"> |
|
| 430 |
<code class="varname">qty</code> |
|
| 431 |
</span></dt><dd><p>Anzahl</p></dd><dt><span class="term"> |
|
| 432 |
<code class="varname">reqdate</code> |
|
| 433 |
</span></dt><dd><p>Lieferdatum</p></dd><dt><span class="term"> |
|
| 434 |
<code class="varname">runningnumber</code> |
|
| 435 |
</span></dt><dd><p>Position auf der Rechnung (1, 2, 3...)</p></dd><dt><span class="term"> |
|
| 436 |
<code class="varname">sellprice</code> |
|
| 437 |
</span></dt><dd><p>Verkaufspreis</p></dd><dt><span class="term"> |
|
| 438 |
<code class="varname">serialnumber</code> |
|
| 439 |
</span></dt><dd><p>Seriennummer</p></dd><dt><span class="term"> |
|
| 440 |
<code class="varname">tax_rate</code> |
|
| 441 |
</span></dt><dd><p>Steuersatz</p></dd><dt><span class="term"> |
|
| 442 |
<code class="varname">transdate_oe</code> |
|
| 443 |
</span></dt><dd><p>Auftragsdatum des Originalauftrags, wenn die Rechnung |
|
| 444 |
aus einem Sammelauftrag erstellt wurde</p></dd><dt><span class="term"> |
|
| 445 |
<code class="varname">unit</code> |
|
| 446 |
</span></dt><dd><p>Einheit</p></dd><dt><span class="term"> |
|
| 447 |
<code class="varname">weight</code> |
|
| 448 |
</span></dt><dd><p>Gewicht</p></dd></dl></div><p>F?r jeden Posten gibt es ein Unterarray mit den Informationen |
|
| 449 |
?ber Lieferanten und Lieferantenartikelnummer. Diese m?ssen mit |
|
| 450 |
einer <code class="function">foreach</code>-Schleife ausgegeben werden, da |
|
| 451 |
f?r jeden Artikel mehrere Lieferanteninformationen hinterlegt sein |
|
| 452 |
k?nnen. Die Variablen daf?r lauten:</p><div class="variablelist"><dl><dt><span class="term"> |
|
| 453 |
<code class="varname">make</code> |
|
| 454 |
</span></dt><dd><p>Lieferant</p></dd><dt><span class="term"> |
|
| 455 |
<code class="varname">model</code> |
|
| 456 |
</span></dt><dd><p>Lieferantenartikelnummer</p></dd></dl></div></div><div class="sect3" title="3.2.8.3. Variablen f?r die einzelnen Zahlungseing?nge"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.invoice-zahlungen"></a>3.2.8.3. Variablen f?r die einzelnen Zahlungseing?nge</h4></div></div></div><div class="variablelist"><dl><dt><span class="term"> |
|
| 457 |
<code class="varname">payment</code> |
|
| 458 |
</span></dt><dd><p>Betrag</p></dd><dt><span class="term"> |
|
| 459 |
<code class="varname">paymentaccount</code> |
|
| 460 |
</span></dt><dd><p>Konto</p></dd><dt><span class="term"> |
|
| 461 |
<code class="varname">paymentdate</code> |
|
| 462 |
</span></dt><dd><p>Datum</p></dd><dt><span class="term"> |
|
| 463 |
<code class="varname">paymentmemo</code> |
|
| 464 |
</span></dt><dd><p>Memo</p></dd><dt><span class="term"> |
|
| 465 |
<code class="varname">paymentsource</code> |
|
| 466 |
</span></dt><dd><p>Beleg</p></dd></dl></div></div><div class="sect3" title="3.2.8.4. Benutzerdefinierte Kunden- und Lieferantenvariablen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.benutzerdefinierte-variablen-vc"></a>3.2.8.4. Benutzerdefinierte Kunden- und Lieferantenvariablen</h4></div></div></div><p>Die vom Benutzer definierten Variablen f?r Kunden und |
|
| 467 |
Lieferanten stehen beim Ausdruck von Einkaufs- und Verkaufsbelegen |
|
| 468 |
ebenfalls zur Verf?gung. Ihre Namen setzen sich aus dem Pr?fix |
|
| 469 |
<code class="varname">vc_cvar_</code> und dem vom Benutzer festgelegten |
|
| 470 |
Variablennamen zusammen.</p><p>Beispiel: Der Benutzer hat eine Variable namens |
|
| 471 |
<code class="varname">number_of_employees</code> definiert, die die Anzahl der |
|
| 472 |
Mitarbeiter des Unternehmens enth?lt. Diese Variable steht dann |
|
| 473 |
unter dem Namen <code class="varname">vc_cvar_number_of_employees</code> zur |
|
| 474 |
Verf?gung.</p></div></div><div class="sect2" title="3.2.9. Variablen in Mahnungen und Rechnungen ?ber Mahngeb?hren"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.dunning"></a>3.2.9. Variablen in Mahnungen und Rechnungen ?ber Mahngeb?hren</h3></div></div></div><div class="sect3" title="3.2.9.1. Namen der Vorlagen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.dunning-vorlagennamen"></a>3.2.9.1. Namen der Vorlagen</h4></div></div></div><p>Die Namen der Vorlagen werden im System-Men? vom Benutzer |
|
| 475 |
eingegeben. Wird f?r ein Mahnlevel die Option zur automatischen |
|
| 476 |
Erstellung einer Rechnung ?ber die Mahngeb?hren und Zinsen |
|
| 477 |
aktiviert, so wird der Name der Vorlage f?r diese Rechnung aus dem |
|
| 478 |
Vorlagenname f?r diese Mahnstufe mit dem Zusatz |
|
| 479 |
<code class="constant">_invoice</code> gebildet. Weiterhin werden die K?rzel |
|
| 480 |
f?r die ausgew?hlte Sprache und den ausgew?hlten Drucker |
|
| 481 |
angeh?ngt.</p></div><div class="sect3" title="3.2.9.2. Allgemeine Variablen in Mahnungen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.dunning-allgemein"></a>3.2.9.2. Allgemeine Variablen in Mahnungen</h4></div></div></div><p>Die Variablen des Verk?ufers stehen wie gewohnt als |
|
| 482 |
<code class="varname">employee_...</code> zur Verf?gung. Die Adressdaten des |
|
| 483 |
Kunden stehen als Variablen <code class="varname">name</code>, |
|
| 484 |
<code class="varname">street</code>, <code class="varname">zipcode</code>, |
|
| 485 |
<code class="varname">city</code>, <code class="varname">country</code>, |
|
| 486 |
<code class="varname">department_1</code>, <code class="varname">department_2</code>, |
|
| 487 |
und <code class="varname">email</code> zur Verf?gung.</p><p>Weitere Variablen beinhalten:</p><div class="variablelist"><dl><dt><span class="term"> |
|
| 488 |
<code class="varname">dunning_date</code> |
|
| 489 |
</span></dt><dd><p>Datum der Mahnung</p></dd><dt><span class="term"> |
|
| 490 |
<code class="varname">dunning_duedate</code> |
|
| 491 |
</span></dt><dd><p>F?lligkeitsdatum f?r diese Mahhnung</p></dd><dt><span class="term"> |
|
| 492 |
<code class="varname">dunning_id</code> |
|
| 493 |
</span></dt><dd><p>Mahnungsnummer</p></dd><dt><span class="term"> |
|
| 494 |
<code class="varname">fee</code> |
|
| 495 |
</span></dt><dd><p>Kummulative Mahngeb?hren</p></dd><dt><span class="term"> |
|
| 496 |
<code class="varname">interest_rate</code> |
|
| 497 |
</span></dt><dd><p>Zinssatz per anno in Prozent</p></dd><dt><span class="term"> |
|
| 498 |
<code class="varname">total_amount</code> |
|
| 499 |
</span></dt><dd><p>Gesamter noch zu zahlender Betrag als |
|
| 500 |
<code class="function">fee</code> + <code class="function">total_interest</code> |
|
| 501 |
+ <code class="function">total_open_amount</code> |
|
| 502 |
</p></dd><dt><span class="term"> |
|
| 503 |
<code class="varname">total_interest</code> |
|
| 504 |
</span></dt><dd><p>Zinsen per anno ?ber alle Rechnungen</p></dd><dt><span class="term"> |
|
| 505 |
<code class="varname">total_open_amount</code> |
|
| 506 |
</span></dt><dd><p>Summe ?ber alle offene Betr?ge der Rechnungen</p></dd></dl></div></div><div class="sect3" title="3.2.9.3. Variablen f?r jede gemahnte Rechnung in einer Mahnung"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.dunning-details"></a>3.2.9.3. Variablen f?r jede gemahnte Rechnung in einer Mahnung</h4></div></div></div><div class="variablelist"><dl><dt><span class="term"> |
|
| 507 |
<code class="varname">dn_amount</code> |
|
| 508 |
</span></dt><dd><p>Rechnungssumme (brutto)</p></dd><dt><span class="term"> |
|
| 509 |
<code class="varname">dn_duedate</code> |
|
| 510 |
</span></dt><dd><p>Originales F?lligkeitsdatum der Rechnung</p></dd><dt><span class="term"> |
|
| 511 |
<code class="varname">dn_dunning_date</code> |
|
| 512 |
</span></dt><dd><p>Datum der Mahnung</p></dd><dt><span class="term"> |
|
| 513 |
<code class="varname">dn_dunning_duedate</code> |
|
| 514 |
</span></dt><dd><p>F?lligkeitsdatum der Mahnung</p></dd><dt><span class="term"> |
|
| 515 |
<code class="varname">dn_fee</code> |
|
| 516 |
</span></dt><dd><p>Kummulative Mahngeb?hr</p></dd><dt><span class="term"> |
|
| 517 |
<code class="varname">dn_interest</code> |
|
| 518 |
</span></dt><dd><p>Zinsen per anno f?r diese Rechnung</p></dd><dt><span class="term"> |
|
| 519 |
<code class="varname">dn_invnumber</code> |
|
| 520 |
</span></dt><dd><p>Rechnungsnummer</p></dd><dt><span class="term"> |
|
| 521 |
<code class="varname">dn_linetotal</code> |
|
| 522 |
</span></dt><dd><p>Noch zu zahlender Betrag (ergibt sich aus |
|
| 523 |
<code class="varname">dn_open_amount</code> + <code class="varname">dn_fee</code> |
|
| 524 |
+ <code class="varname">dn_interest</code>)</p></dd><dt><span class="term"> |
|
| 525 |
<code class="varname">dn_netamount</code> |
|
| 526 |
</span></dt><dd><p>Rechnungssumme (netto)</p></dd><dt><span class="term"> |
|
| 527 |
<code class="varname">dn_open_amount</code> |
|
| 528 |
</span></dt><dd><p>Offener Rechnungsbetrag</p></dd><dt><span class="term"> |
|
| 529 |
<code class="varname">dn_ordnumber</code> |
|
| 530 |
</span></dt><dd><p>Bestellnummer</p></dd><dt><span class="term"> |
|
| 531 |
<code class="varname">dn_transdate</code> |
|
| 532 |
</span></dt><dd><p>Rechnungsdatum</p></dd><dt><span class="term"> |
|
| 533 |
<code class="varname">dn_curr</code> |
|
| 534 |
</span></dt><dd><p>W?hrung, in der die Rechnung erstellt wurde. (Die |
|
| 535 |
Rechnungsbetr?ge sind aber immer in der Hauptw?hrung)</p></dd></dl></div></div><div class="sect3" title="3.2.9.4. Variablen in automatisch erzeugten Rechnungen ?ber Mahngeb?hren"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.dunning-invoice"></a>3.2.9.4. Variablen in automatisch erzeugten Rechnungen ?ber |
|
| 536 |
Mahngeb?hren</h4></div></div></div><p>Die Variablen des Verk?ufers stehen wie gewohnt als |
|
| 537 |
<code class="varname">employee_...</code> zur Verf?gung. Die Adressdaten des |
|
| 538 |
Kunden stehen als Variablen <code class="varname">name</code>, |
|
| 539 |
<code class="varname">street</code>, <code class="varname">zipcode</code>, |
|
| 540 |
<code class="varname">city</code>, <code class="varname">country</code>, |
|
| 541 |
<code class="varname">department_1</code>, <code class="varname">department_2</code>, |
|
| 542 |
und <code class="varname">email</code> zur Verf?gung.</p><p>Weitere Variablen beinhalten:</p><div class="variablelist"><dl><dt><span class="term"> |
|
| 543 |
<code class="varname">duedate</code> |
|
| 544 |
</span></dt><dd><p>F?lligkeitsdatum der Rechnung</p></dd><dt><span class="term"> |
|
| 545 |
<code class="varname">dunning_id</code> |
|
| 546 |
</span></dt><dd><p>Mahnungsnummer</p></dd><dt><span class="term"> |
|
| 547 |
<code class="varname">fee</code> |
|
| 548 |
</span></dt><dd><p>Mahngeb?hren</p></dd><dt><span class="term"> |
|
| 549 |
<code class="varname">interest</code> |
|
| 550 |
</span></dt><dd><p>Zinsen</p></dd><dt><span class="term"> |
|
| 551 |
<code class="varname">invamount</code> |
|
| 552 |
</span></dt><dd><p>Rechnungssumme (ergibt sich aus <code class="varname">fee</code> + |
|
| 553 |
<code class="varname">interest</code>)</p></dd><dt><span class="term"> |
|
| 554 |
<code class="varname">invdate</code> |
|
| 555 |
</span></dt><dd><p>Rechnungsdatum</p></dd><dt><span class="term"> |
|
| 556 |
<code class="varname">invnumber</code> |
|
| 557 |
</span></dt><dd><p>Rechnungsnummer</p></dd></dl></div></div></div><div class="sect2" title="3.2.10. Variablen in anderen Vorlagen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.andere-vorlagen"></a>3.2.10. Variablen in anderen Vorlagen</h3></div></div></div><div class="sect3" title="3.2.10.1. Einf?hrung"><div class="titlepage"><div><div><h4 class="title"><a name="d0e3643"></a>3.2.10.1. Einf?hrung</h4></div></div></div><p>Die Variablen in anderen Vorlagen sind ?hnlich wie in der |
|
| 558 |
Rechnung. Allerdings hei?en die Variablen, die mit |
|
| 559 |
<code class="varname">inv</code> beginnen, jetzt anders. Bei den Angeboten |
|
| 560 |
fangen sie mit <code class="varname">quo</code> f?r "quotation" an: |
|
| 561 |
<code class="varname">quodate</code> f?r Angebotsdatum etc. Bei Bestellungen |
|
| 562 |
wiederum fangen sie mit <code class="varname">ord</code> f?r "order" an: |
|
| 563 |
<code class="varname">ordnumber</code> f?r Bestellnummer etc.</p><p>Manche Variablen sind in anderen Vorlagen hingegen gar nicht |
|
| 564 |
vorhanden wie z.B. die f?r bereits verbuchte Zahlungseing?nge. Dies |
|
| 565 |
sind Variablen, die vom Gesch?ftsablauf her in der entsprechenden |
|
| 566 |
Vorlage keine Bedeutung haben oder noch nicht belegt sein |
|
| 567 |
k?nnen.</p><p>Im Folgenden werden nur wichtige Unterschiede zu den Variablen |
|
| 568 |
in Rechnungen aufgef?hrt.</p></div><div class="sect3" title="3.2.10.2. Angebote und Preisanfragen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.andere-vorlagen-quotations"></a>3.2.10.2. Angebote und Preisanfragen</h4></div></div></div><div class="variablelist"><dl><dt><span class="term"> |
|
| 569 |
<code class="varname">quonumber</code> |
|
| 570 |
</span></dt><dd><p>Angebots- bzw. Anfragenummer</p></dd><dt><span class="term"> |
|
| 571 |
<code class="varname">reqdate</code> |
|
| 572 |
</span></dt><dd><p>G?ltigkeitsdatum (bei Angeboten) bzw. Lieferdatum (bei |
|
| 573 |
Preisanfragen)</p></dd><dt><span class="term"> |
|
| 574 |
<code class="varname">transdate</code> |
|
| 575 |
</span></dt><dd><p>Angebots- bzw. Anfragedatum</p></dd></dl></div></div><div class="sect3" title="3.2.10.3. Auftragsbest?tigungen und Lieferantenauftr?ge"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.andere-vorlagen-orders"></a>3.2.10.3. Auftragsbest?tigungen und Lieferantenauftr?ge</h4></div></div></div><div class="variablelist"><dl><dt><span class="term"> |
|
| 576 |
<code class="varname">ordnumber</code> |
|
| 577 |
</span></dt><dd><p>Auftragsnummer</p></dd><dt><span class="term"> |
|
| 578 |
<code class="varname">reqdate</code> |
|
| 579 |
</span></dt><dd><p>Lieferdatum</p></dd><dt><span class="term"> |
|
| 580 |
<code class="varname">transdate</code> |
|
| 581 |
</span></dt><dd><p>Auftragsdatum</p></dd></dl></div></div><div class="sect3" title="3.2.10.4. Lieferscheine (Verkauf und Einkauf)"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.andere-vorlagen-delivery-orders"></a>3.2.10.4. Lieferscheine (Verkauf und Einkauf)</h4></div></div></div><div class="variablelist"><dl><dt><span class="term"> |
|
| 582 |
<code class="varname">cusordnumber</code> |
|
| 583 |
</span></dt><dd><p>Bestellnummer des Kunden (im Verkauf) bzw. Bestellnummer |
|
| 584 |
des Lieferanten (im Einkauf)</p></dd><dt><span class="term"> |
|
| 585 |
<code class="varname">donumber</code> |
|
| 586 |
</span></dt><dd><p>Lieferscheinnummer</p></dd><dt><span class="term"> |
|
| 587 |
<code class="varname">transdate</code> |
|
| 588 |
</span></dt><dd><p>Lieferscheindatum</p></dd></dl></div><p>F?r jede Position eines Lieferscheines gibt es ein Unterarray |
|
| 589 |
mit den Informationen dar?ber, von welchem Lager und Lagerplatz aus |
|
| 590 |
die Waren verschickt wurden (Verkaufslieferscheine) bzw. auf welchen |
|
| 591 |
Lagerplatz sie eingelagert wurden. Diese m?ssen mittels einer |
|
| 592 |
<code class="function">foreach</code>-Schleife ausgegeben werden. Diese |
|
| 593 |
Variablen sind:</p><div class="variablelist"><dl><dt><span class="term"> |
|
| 594 |
<code class="varname">si_bin</code> |
|
| 595 |
</span></dt><dd><p>Lagerplatz</p></dd><dt><span class="term"> |
|
| 596 |
<code class="varname">si_chargenumber</code> |
|
| 597 |
</span></dt><dd><p>Chargennummer</p></dd><dt><span class="term"> |
|
| 598 |
<code class="varname">si_bestbefore</code> |
|
| 599 |
</span></dt><dd><p>Mindesthaltbarkeit</p></dd><dt><span class="term"> |
|
| 600 |
<code class="varname">si_number</code> |
|
| 601 |
</span></dt><dd><p>Artikelnummer</p></dd><dt><span class="term"> |
|
| 602 |
<code class="varname">si_qty</code> |
|
| 603 |
</span></dt><dd><p>Anzahl bzw. Menge</p></dd><dt><span class="term"> |
|
| 604 |
<code class="varname">si_runningnumber</code> |
|
| 605 |
</span></dt><dd><p>Positionsnummer (1, 2, 3 etc)</p></dd><dt><span class="term"> |
|
| 606 |
<code class="varname">si_unit</code> |
|
| 607 |
</span></dt><dd><p>Einheit</p></dd><dt><span class="term"> |
|
| 608 |
<code class="varname">si_warehouse</code> |
|
| 609 |
</span></dt><dd><p>Lager</p></dd></dl></div></div><div class="sect3" title="3.2.10.5. Variablen f?r Sammelrechnung"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.andere-vorlagen-statement"></a>3.2.10.5. Variablen f?r Sammelrechnung</h4></div></div></div><div class="variablelist"><dl><dt><span class="term"> |
|
| 610 |
<code class="varname">c0total</code> |
|
| 611 |
</span></dt><dd><p>Gesamtbetrag aller Rechnungen mit F?lligkeit < 30 |
|
| 612 |
Tage</p></dd><dt><span class="term"> |
|
| 613 |
<code class="varname">c30total</code> |
|
| 614 |
</span></dt><dd><p>Gesamtbetrag aller Rechnungen mit F?lligkeit >= 30 |
|
| 615 |
und < 60 Tage</p></dd><dt><span class="term"> |
|
| 616 |
<code class="varname">c60total</code> |
|
| 617 |
</span></dt><dd><p>Gesamtbetrag aller Rechnungen mit F?lligkeit >= 60 |
|
| 618 |
und < 90 Tage</p></dd><dt><span class="term"> |
|
| 619 |
<code class="varname">c90total</code> |
|
| 620 |
</span></dt><dd><p>Gesamtbetrag aller Rechnungen mit F?lligkeit >= 90 |
|
| 621 |
Tage</p></dd><dt><span class="term"> |
|
| 622 |
<code class="varname">total</code> |
|
| 623 |
</span></dt><dd><p>Gesamtbetrag aller Rechnungen</p></dd></dl></div><p>Variablen f?r jede Rechnungsposition in Sammelrechnung:</p><div class="variablelist"><dl><dt><span class="term"> |
|
| 624 |
<code class="varname">invnumber</code> |
|
| 625 |
</span></dt><dd><p>Rechnungsnummer</p></dd><dt><span class="term"> |
|
| 626 |
<code class="varname">invdate</code> |
|
| 627 |
</span></dt><dd><p>Rechnungsdatum</p></dd><dt><span class="term"> |
|
| 628 |
<code class="varname">duedate</code> |
|
| 629 |
</span></dt><dd><p>F?lligkeitsdatum</p></dd><dt><span class="term"> |
|
| 630 |
<code class="varname">amount</code> |
|
| 631 |
</span></dt><dd><p>Summe der Rechnung</p></dd><dt><span class="term"> |
|
| 632 |
<code class="varname">open</code> |
|
| 633 |
</span></dt><dd><p>Noch offener Betrag der Rechnung</p></dd><dt><span class="term"> |
|
| 634 |
<code class="varname">c0</code> |
|
| 635 |
</span></dt><dd><p>Noch offener Rechnungsbetrag mit F?lligkeit < 30 |
|
| 636 |
Tage</p></dd><dt><span class="term"> |
|
| 637 |
<code class="varname">c30</code> |
|
| 638 |
</span></dt><dd><p>Noch offener Rechnungsbetrag mit F?lligkeit >= 30 und |
|
| 639 |
< 60 Tage</p></dd><dt><span class="term"> |
|
| 640 |
<code class="varname">c60</code> |
|
| 641 |
</span></dt><dd><p>Noch offener Rechnungsbetrag mit F?lligkeit >= 60 und |
|
| 642 |
< 90 Tage</p></dd><dt><span class="term"> |
|
| 643 |
<code class="varname">c90</code> |
|
| 644 |
</span></dt><dd><p>Noch offener Rechnungsbetrag mit F?lligkeit >= 90 |
|
| 645 |
Tage</p></dd></dl></div></div></div><div class="sect2" title="3.2.11. Bl?cke, bedingte Anweisungen und Schleifen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.bloecke"></a>3.2.11. Bl?cke, bedingte Anweisungen und Schleifen</h3></div></div></div><div class="sect3" title="3.2.11.1. Einf?rhung"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.bloecke.einfuehrung"></a>3.2.11.1. Einf?rhung</h4></div></div></div><p>Der Parser kennt neben den Variablen einige weitere |
|
| 646 |
Konstrukte, die gesondert behandelt werden. Diese sind wie |
|
| 647 |
Variablennamen in spezieller Weise markiert: |
|
| 648 |
<span class="command"><strong><%anweisung%> ... <%end%></strong></span> |
|
| 649 |
</p><p>Anmerkung zum <span class="command"><strong><%end%></strong></span>: Der besseren |
|
| 650 |
Verst?ndlichkeit halber kann man nach dem <span class="command"><strong>end</strong></span> |
|
| 651 |
noch beliebig weitere W?rter schreiben, um so zu markieren, welche |
|
| 652 |
Anweisung (z.B. <span class="command"><strong>if</strong></span> oder |
|
| 653 |
<span class="command"><strong>foreach</strong></span>) damit abgeschlossen wird.</p><p>Beispiel: Lautet der Beginn eines Blockes z.B. |
|
| 654 |
<span class="command"><strong><%if type == "sales_quotation"%></strong></span>, so k?nnte |
|
| 655 |
er mit <span class="command"><strong><%end%></strong></span> genauso abgeschlossen werden |
|
| 656 |
wie mit <span class="command"><strong><%end if%></strong></span> oder auch |
|
| 657 |
<span class="command"><strong><%end type == "sales_quotation"%></strong></span>.</p></div><div class="sect3" title="3.2.11.2. Der if-Block"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.bloecke.if"></a>3.2.11.2. Der if-Block</h4></div></div></div><pre class="programlisting"><%if variablenname%> |
|
| 658 |
... |
|
| 659 |
<%end%></pre><p>Eine normale "if-then"-Bedingung. Die Zeilen zwischen dem "if" |
|
| 660 |
und dem "end" werden nur ausgegeben, wenn die Variable |
|
| 661 |
<code class="varname">variablenname</code> gesetzt und ungleich 0 ist.</p><p>Die Bedingung kann auch negiert werden, indem das Wort |
|
| 662 |
<code class="function">not</code> nach dem <code class="filename">if</code> verwendet |
|
| 663 |
wird. Beispiel:</p><pre class="programlisting"><%if not cp_greeting%> |
|
| 664 |
... |
|
| 665 |
<%end%></pre><p>Zus?tzlich zu dem einfachen Test, ob eine Variable gesetzt ist |
|
| 666 |
oder nicht, bietet dieser Block auch die M?glichkeit, den Inhalt |
|
| 667 |
einer Variablen mit einer festen Zeichenkette oder einer anderen |
|
| 668 |
Variablen zu vergleichen. Ob der Vergleich mit einer Zeichenkette |
|
| 669 |
oder einer anderen Variablen vorgenommen wird, h?ngt davon ab, ob |
|
| 670 |
die rechte Seite des Vergleichsoperators in Anf?hrungszeichen |
|
| 671 |
gesetzt wird (Vergleich mit Zeichenkette) oder nicht (Vergleich mit |
|
| 672 |
anderer Variablen). Zwei Beispiele, die beide Vergleiche |
|
| 673 |
zeigen:</p><pre class="programlisting"><%if var1 == "Wert"%></pre><p>Testet die Variable <code class="varname">var1</code> auf |
|
Auch abrufbar als: Unified diff
Erzeugte PDF- und HTML-Varianten der Dokumentation