Projekt

Allgemein

Profil

« Zurück | Weiter » 

Revision c6dd542b

Von Moritz Bunkus vor fast 9 Jahren hinzugefügt

  • ID c6dd542b51ae9549ad42a54f9023b905412bbab9
  • Vorgänger 6162711f
  • Nachfolger 0fce1b51

Task-Server: Mandantenfähigkeit

Unterschiede anzeigen:

SL/Controller/Admin.pm
6 6 

  		




  7
  7
  
    
use IO::Dir;


  		




  8
  8
  
    
use List::Util qw(first);


  		




  
  9
  
    
use List::UtilsBy qw(sort_by);


  		




  9
  10
  
    

  		




  10
  11
  
    
use SL::Common ();


  		




  11
  12
  
    
use SL::DB::AuthUser;


  		




  ......




  672
  673
  
    
  return undef;


  		




  673
  674
  
    
}


  		




  674
  675
  
    

  		




  
  676
  
    
sub is_user_used_for_task_server {


  		




  
  677
  
    
  my ($self, $user) = @_;


  		




  
  678
  
    

  		




  
  679
  
    
  return undef if !$user;


  		




  
  680
  
    
  return join ', ', sort_by { lc } map { $_->name } @{ SL::DB::Manager::AuthClient->get_all(where => [ task_server_user_id => $user->id ]) };


  		




  
  681
  
    
}


  		




  
  682
  
    

  		




  
  683
  
    

  		




  675
  684
  
    
1;


  		












  

    
      SL/DB/MetaSetup/AuthClient.pm
    
  





  10
  10
  
    
__PACKAGE__->meta->schema('auth');


  		




  11
  11
  
    

  		




  12
  12
  
    
__PACKAGE__->meta->columns(


  		




  13
  
  
    
  dbhost     => { type => 'text', not_null => 1 },


  		




  14
  
  
    
  dbname     => { type => 'text', not_null => 1 },


  		




  15
  
  
    
  dbpasswd   => { type => 'text', not_null => 1 },


  		




  16
  
  
    
  dbport     => { type => 'integer', default => 5432, not_null => 1 },


  		




  17
  
  
    
  dbuser     => { type => 'text', not_null => 1 },


  		




  18
  
  
    
  id         => { type => 'serial', not_null => 1 },


  		




  19
  
  
    
  is_default => { type => 'boolean', default => 'false', not_null => 1 },


  		




  20
  
  
    
  name       => { type => 'text', not_null => 1 },


  		




  
  13
  
    
  dbhost              => { type => 'text', not_null => 1 },


  		




  
  14
  
    
  dbname              => { type => 'text', not_null => 1 },


  		




  
  15
  
    
  dbpasswd            => { type => 'text', not_null => 1 },


  		




  
  16
  
    
  dbport              => { type => 'integer', default => 5432, not_null => 1 },


  		




  
  17
  
    
  dbuser              => { type => 'text', not_null => 1 },


  		




  
  18
  
    
  id                  => { type => 'serial', not_null => 1 },


  		




  
  19
  
    
  is_default          => { type => 'boolean', default => 'false', not_null => 1 },


  		




  
  20
  
    
  name                => { type => 'text', not_null => 1 },


  		




  
  21
  
    
  task_server_user_id => { type => 'integer' },


  		




  21
  22
  
    
);


  		




  22
  23
  
    

  		




  23
  24
  
    
__PACKAGE__->meta->primary_key_columns([ 'id' ]);


  		




  ......




  27
  28
  
    
  [ 'name' ],


  		




  28
  29
  
    
);


  		




  29
  30
  
    

  		




  
  31
  
    
__PACKAGE__->meta->foreign_keys(


  		




  
  32
  
    
  task_server_user => {


  		




  
  33
  
    
    class       => 'SL::DB::AuthUser',


  		




  
  34
  
    
    key_columns => { task_server_user_id => 'id' },


  		




  
  35
  
    
  },


  		




  
  36
  
    
);


  		




  
  37
  
    

  		




  30
  38
  
    
1;


  		




  31
  39
  
    
;


  		












  

    
      SL/DBConnect/Cache.pm
    
  





  43
  43
  
    
  %cache = ();


  		




  44
  44
  
    
}


  		




  45
  45
  
    

  		




  
  46
  
    
sub disconnect_all_and_clear {


  		




  
  47
  
    
  $_->disconnect for values %cache;


  		




  
  48
  
    
  %cache = ();


  		




  
  49
  
    
}


  		




  
  50
  
    

  		




  46
  51
  
    
sub _args2str {


  		




  47
  52
  
    
  my (@args) = @_;


  		




  48
  53
  
    

  		












  

    
      config/kivitendo.conf.default
    
  





  146
  146
  
    
openofficeorg_daemon_port = 2002


  		




  147
  147
  
    

  		




  148
  148
  
    
[task_server]


  		




  149
  
  
    
# kivitendo client (either its name or its database ID) for database


  		




  150
  
  
    
# access (both 'client' and 'login' are required)


  		




  151
  
  
    
client =


  		




  152
  
  
    
# kivitendo user (login) name to use for certain jobs (both 'client'


  		




  153
  
  
    
# and 'login' are required)


  		




  154
  
  
    
login =


  		




  155
  149
  
    
# Set to 1 for debug messages in /tmp/kivitendo-debug.log


  		




  156
  150
  
    
debug = 0


  		




  157
  151
  
    
# Chose a system user the daemon should run under when started as root.


  		












  

    
      doc/UPGRADE
    
  





  14
  14
  
    
  aktualisiert. Für Benutzer der empfohlenen FastCGI Anbindung ändert sich


  		




  15
  15
  
    
  nichts.


  		




  16
  16
  
    

  		




  
  17
  
    
* Der Task-Server ist nun mandantenfähig. Für jeden Mandanten, für den


  		




  
  18
  
    
  der Task-Server laufen soll, muss in der Administrationsoberfläche


  		




  
  19
  
    
  in der Konfiguration des Mandanten hinterlegt werden, welchen


  		




  
  20
  
    
  kivitendo-Benutzer der Task-Server nutzen soll. Ist bei einem


  		




  
  21
  
    
  Mandanten kein Benutzer hinterlegt, so ignoriert der Task-Server


  		




  
  22
  
    
  diesen Mandanten.


  		




  
  23
  
    

  		




  
  24
  
    
  Im Gegenzug wurden die beiden Konfigurations-Einstellungen »client«


  		




  
  25
  
    
  und »login« aus dem Abschnitt [task_server] entfernt. Der


  		




  
  26
  
    
  Task-Server prüft beim Starten allerdings, ob diese Einstellungen


  		




  
  27
  
    
  noch existieren und verweigert den Start mit einer hilfreichen


  		




  
  28
  
    
  Fehlermeldung, solange sie noch vorhanden sind.


  		




  
  29
  
    

  		




  17
  30
  
    
Upgrade auf v3.3.0


  		




  18
  31
  
    
==================


  		




  19
  32
  
    

  		












  

    
      doc/dokumentation.xml
    
  





  419
  419
  
    
        <para>kivitendo bringt eine eigene Komponente zur zeitgesteuerten Ausführung bestimmter Aufgaben mit, den <link


  		




  420
  420
  
    
        linkend="config.task-server">Taskserver</link>. Er wird u.a. für Features wie die <link


  		




  421
  421
  
    
        linkend="features.periodic-invoices">wiederkehrenden Rechnungen</link> benötigt, erledigt aber auch andere erforderliche Aufgaben


  		




  422
  
  
    
        und muss daher in Betrieb genommen werden. Der Taskserver benötigt zwei Konfigurationseinstellungen, die unter


  		




  423
  
  
    
        <varname>[task_server]</varname> anzugeben sind: ein Mandant (entweder der Mandantenname oder eine Datenbank-ID, Variable


  		




  424
  
  
    
        <varname>client</varname>), aus dem die Datenbankkonfiguration entnommen wird, sowie ein Login (Variable <varname>login</varname>)


  		




  425
  
  
    
        eines Benutzers, der für gewisse Dinge wie die Rechnungserstellung als Verkäufer eingetragen wird.</para>


  		




  
  422
  
    
        und muss daher in Betrieb genommen werden. Seine Einrichtung wird im Abschnitt <link linkend="config.task-server">Task-Server</link>


  		




  
  423
  
    
        genauer beschrieben.</para>


  		




  426
  424
  
    

  		




  427
  425
  
    
        <para>Für Entwickler finden sich unter <varname>[debug]</varname>


  		




  428
  426
  
    
        wichtige Funktionen, um die Fehlersuche zu erleichtern.</para>


  		




  ......




  789
  787
  
    
      diese zu festgelegten Zeitpunkten abarbeitet (ähnlich wie Cron). Dieser Prozess wird u.a. für die Erzeugung der wiederkehrenden


  		




  790
  788
  
    
      Rechnungen und weitere essenzielle Aufgaben benutzt.</para>


  		




  791
  789
  
    

  		




  
  790
  
    
      <para>Der Task-Server muss einmalig global in der Konfigurationsdatei konfiguriert werden. Danach wird er für jeden Mandanten, für den


  		




  
  791
  
    
      er laufen soll, in der Adminsitrationsmaske eingeschaltet.</para>


  		




  
  792
  
    

  		




  
  793
  
    
      <para>Beachten Sie, dass der Task-Server in den Boot-Vorgang Ihres Servers integriert werden muss, damit er automatisch gestartet


  		




  
  794
  
    
      wird. Dies kann kivitendo nicht für Sie erledigen.</para>


  		




  
  795
  
    

  		




  792
  796
  
    
      <sect2 id="Konfiguration-des-Task-Servers">


  		




  793
  797
  
    
        <title>Verfügbare und notwendige Konfigurationsoptionen</title>


  		




  794
  798
  
    

  		




  ......




  798
  802
  
    
        Optionen sind:</para>


  		




  799
  803
  
    

  		




  800
  804
  
    
        <variablelist>


  		




  801
  
  
    
          <varlistentry>


  		




  802
  
  
    
            <term><varname>client</varname></term>


  		




  803
  
  
    

  		




  804
  
  
    
            <listitem>


  		




  805
  
  
    
              <para>Name oder Datenbank-ID eines vorhandenen kivitendo-Mandanten, der benutzt wird, um die zu verwendende


  		




  806
  
  
    
              Datenbankverbindung auszulesen. Der Mandant muss in der Administration angelegt werden. Diese Option muss angegeben


  		




  807
  
  
    
              werden.</para>


  		




  808
  
  
    

  		




  809
  
  
    
              <para>Diese Option kam mit Release v3.x.0 hinzu und muss daher in Konfigurationen, die von älteren Versionen aktualisiert


  		




  810
  
  
    
              wurden, ergänzt werden.</para>


  		




  811
  
  
    
            </listitem>


  		




  812
  
  
    
          </varlistentry>


  		




  813
  
  
    

  		




  814
  
  
    
          <varlistentry>


  		




  815
  
  
    
            <term><varname>login</varname></term>


  		




  816
  
  
    

  		




  817
  
  
    
            <listitem>


  		




  818
  
  
    
              <para>gültiger kivitendo-Benutzername, der z.B. als Verkäufer beim Erzeugen wiederkehrender Rechnungen benötigt wird. Der


  		




  819
  
  
    
              Benutzer muss in der Administration angelegt werden. Diese Option muss angegeben werden.</para>


  		




  820
  
  
    
            </listitem>


  		




  821
  
  
    
          </varlistentry>


  		




  822
  
  
    

  		




  823
  805
  
    
          <varlistentry>


  		




  824
  806
  
    
            <term><varname>run_as</varname></term>


  		




  825
  807
  
    

  		




  ......




  830
  812
  
    
              Lese- und Schreibrechte haben, wie auch der Webserverbenutzer


  		




  831
  813
  
    
              (siehe see <xref


  		




  832
  814
  
    
              linkend="Manuelle-Installation-des-Programmpaketes" />). Daher


  		




  833
  
  
    
              ist es sinnvoll, hier denselben Systembenutzer einzutragen,


  		




  
  815
  
    
              ist es erforderlich, hier denselben Systembenutzer einzutragen,


  		




  834
  816
  
    
              unter dem auch der Webserver läuft.</para>


  		




  835
  817
  
    
            </listitem>


  		




  836
  818
  
    
          </varlistentry>


  		




  ......




  845
  827
  
    
        </variablelist>


  		




  846
  828
  
    
      </sect2>


  		




  847
  829
  
    

  		




  
  830
  
    
      <sect2 id="Konfiguration-der-Mandanten-fuer-den-Task-Servers">


  		




  
  831
  
    
        <title>Konfiguration der Mandanten für den Task-Server</title>


  		




  
  832
  
    

  		




  
  833
  
    
        <para>Ist der Task-Server grundlegend konfiguriert, so muss anschließend jeder Mandant, für den der Task-Server laufen soll,


  		




  
  834
  
    
        einmalig konfiguriert werden. Dazu kann in der Maske zum Bearbeiten von Mandanten im Administrationsbereich eine


  		




  
  835
  
    
        kivitendo-Benutzerkennung ausgewählt werden, unter der der Task-Server seine Arbeit verrichtet.</para>


  		




  
  836
  
    

  		




  
  837
  
    
        <para>Ist in dieser Einstellung keine Benutzerkennung ausgewählt, so wird der Task-Server für diesen Mandanten keine Aufgaben


  		




  
  838
  
    
        ausführen.</para>


  		




  
  839
  
    
      </sect2>


  		




  
  840
  
    

  		




  848
  841
  
    
      <sect2 id="Einbinden-in-den-Boot-Prozess">


  		




  849
  842
  
    
        <title>Automatisches Starten des Task-Servers beim Booten</title>


  		




  850
  843
  
    

  		












  

    
      doc/html/ch01.html
    
  





  1
  1
  
    
<html><head>


  		




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


  		




  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="kivitendo 3.3.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="index.html" title="kivitendo 3.3.0: Installation, Konfiguration, Entwicklung"><link rel="prev" href="index.html" title="kivitendo 3.3.0: 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>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<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>im Community-Forum: <a class="ulink" href="https://forum.kivitendo.org:32443" target="_top">https://forum.kivitendo.org:32443</a>


  		




  
  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="kivitendo 3.3.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="index.html" title="kivitendo 3.3.0: Installation, Konfiguration, Entwicklung"><link rel="prev" href="index.html" title="kivitendo 3.3.0: 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>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<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>im Community-Forum: <a class="ulink" href="https://forum.kivitendo.de:32443" target="_top">https://forum.kivitendo.de:32443</a>


  		




  4
  4
  
    
            </p></li><li class="listitem"><p>im Kunden-Forum: <a class="ulink" href="http://redmine.kivitendo-premium.de/projects/forum/boards/" target="_top">http://redmine.kivitendo-premium.de/projects/forum/boards/</a>


  		




  5
  5
  
    
            </p></li><li class="listitem"><p>in der doc/UPGRADE Datei im doc-Verzeichnis der Installation</p></li><li class="listitem"><p>Im Schulungs- und Dienstleistungsangebot der entsprechenden kivitendo-Partner: <a class="ulink" href="http://www.kivitendo.de/partner.html" target="_top">http://www.kivitendo.de/partner.html</a>


  		




  6
  6
  
    
            </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>&nbsp;</td><td width="20%" align="center">&nbsp;</td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch02.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">kivitendo 3.3.0: Installation, Konfiguration, Entwicklung&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;Kapitel 2. Installation und Grundkonfiguration</td></tr></table></div></body></html>


  		












  

    
      doc/html/ch02s04.html
    
  





  61
  61
  
    
        <code class="varname">[periodic_invoices]</code> den Login eines Benutzers


  		




  62
  62
  
    
        angeben, der nach Erstellung der Rechnungen eine entsprechende E-Mail


  		




  63
  63
  
    
        mit Informationen über die erstellten Rechnungen bekommt.</p><p>kivitendo bringt eine eigene Komponente zur zeitgesteuerten Ausführung bestimmter Aufgaben mit, den <a class="link" href="ch02s07.html" title="2.7. Der Task-Server">Taskserver</a>. Er wird u.a. für Features wie die <a class="link" href="ch03.html#features.periodic-invoices" title="3.1. Wiederkehrende Rechnungen">wiederkehrenden Rechnungen</a> benötigt, erledigt aber auch andere erforderliche Aufgaben


  		




  64
  
  
    
        und muss daher in Betrieb genommen werden. Der Taskserver benötigt zwei Konfigurationseinstellungen, die unter


  		




  65
  
  
    
        <code class="varname">[task_server]</code> anzugeben sind: ein Mandant (entweder der Mandantenname oder eine Datenbank-ID, Variable


  		




  66
  
  
    
        <code class="varname">client</code>), aus dem die Datenbankkonfiguration entnommen wird, sowie ein Login (Variable <code class="varname">login</code>)


  		




  67
  
  
    
        eines Benutzers, der für gewisse Dinge wie die Rechnungserstellung als Verkäufer eingetragen wird.</p><p>Für Entwickler finden sich unter <code class="varname">[debug]</code>


  		




  
  64
  
    
        und muss daher in Betrieb genommen werden. Seine Einrichtung wird im Abschnitt <a class="link" href="ch02s07.html" title="2.7. Der Task-Server">Task-Server</a>


  		




  
  65
  
    
        genauer beschrieben.</p><p>Für Entwickler finden sich unter <code class="varname">[debug]</code>


  		




  68
  66
  
    
        wichtige Funktionen, um die Fehlersuche zu erleichtern.</p></div><div class="sect2" title="2.4.3. Versionen vor 2.6.3"><div class="titlepage"><div><div><h3 class="title"><a name="config.config-file.prior-versions"></a>2.4.3. Versionen vor 2.6.3</h3></div></div></div><p>In älteren kivitendo Versionen gab es im Verzeichnis


  		




  69
  67
  
    
        <code class="filename">config</code> die Dateien


  		




  70
  68
  
    
        <code class="filename">authentication.pl</code> und


  		












  

    
      doc/html/ch02s06.html
    
  





  1
  1
  
    
<html><head>


  		




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


  		




  3
  
  
    
   <title>2.6. 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="kivitendo 3.3.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s05.html" title="2.5. Anpassung der PostgreSQL-Konfiguration"><link rel="next" href="ch02s07.html" title="2.7. 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.6. Webserver-Konfiguration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s05.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch02s07.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.6. Webserver-Konfiguration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Apache-Konfiguration"></a>2.6. Webserver-Konfiguration</h2></div></div></div><div class="sect2" title="2.6.1. Grundkonfiguration mittels CGI"><div class="titlepage"><div><div><h3 class="title"><a name="d0e757"></a>2.6.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


  		




  
  3
  
    
   <title>2.6. 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="kivitendo 3.3.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s05.html" title="2.5. Anpassung der PostgreSQL-Konfiguration"><link rel="next" href="ch02s07.html" title="2.7. 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.6. Webserver-Konfiguration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s05.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch02s07.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.6. Webserver-Konfiguration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Apache-Konfiguration"></a>2.6. Webserver-Konfiguration</h2></div></div></div><div class="sect2" title="2.6.1. Grundkonfiguration mittels CGI"><div class="titlepage"><div><div><h3 class="title"><a name="d0e751"></a>2.6.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
  4
  
    
          mittels FastCGI/FCGI. Die Einrichtung wird ausführlich im Abschnitt


  		




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


  		




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


  		




  ......




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


  		




  106
  106
  
    
          die normale Version erreichbar, und unter


  		




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


  		




  108
  
  
    
          FastCGI-Version.</p></div></div><div class="sect2" title="2.6.3. Weitergehende Konfiguration"><div class="titlepage"><div><div><h3 class="title"><a name="d0e902"></a>2.6.3. Weitergehende Konfiguration</h3></div></div></div><p>Für einen deutlichen Sicherheitsmehrwert sorgt die Ausführung von kivitendo


  		




  
  108
  
    
          FastCGI-Version.</p></div></div><div class="sect2" title="2.6.3. Weitergehende Konfiguration"><div class="titlepage"><div><div><h3 class="title"><a name="d0e896"></a>2.6.3. Weitergehende Konfiguration</h3></div></div></div><p>Für einen deutlichen Sicherheitsmehrwert sorgt die Ausführung von kivitendo


  		




  109
  109
  
    
          nur über https-verschlüsselten Verbindungen, sowie weiteren Zusatzmassnahmen,


  		




  110
  110
  
    
          wie beispielsweise Basic Authenticate.


  		




  111
  111
  
    
          Die Konfigurationsmöglichkeiten sprengen allerdings den Rahmen dieser Anleitung, hier ein


  		












  

    
      doc/html/ch02s07.html
    
  





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


  		




  3
  3
  
    
   <title>2.7. 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="kivitendo 3.3.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s06.html" title="2.6. Webserver-Konfiguration"><link rel="next" href="ch02s08.html" title="2.8. 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.7. Der Task-Server</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s06.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch02s08.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.7. Der Task-Server"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="config.task-server"></a>2.7. Der Task-Server</h2></div></div></div><p>Der Task-Server ist ein Prozess, der im Hintergrund läuft, in regelmäßigen Abständen nach abzuarbeitenden Aufgaben sucht und


  		




  4
  4
  
    
      diese zu festgelegten Zeitpunkten abarbeitet (ähnlich wie Cron). Dieser Prozess wird u.a. für die Erzeugung der wiederkehrenden


  		




  5
  
  
    
      Rechnungen und weitere essenzielle Aufgaben benutzt.</p><div class="sect2" title="2.7.1. Verfügbare und notwendige Konfigurationsoptionen"><div class="titlepage"><div><div><h3 class="title"><a name="Konfiguration-des-Task-Servers"></a>2.7.1. Verfügbare und notwendige Konfigurationsoptionen</h3></div></div></div><p>Die Konfiguration erfolgt über den Abschnitt


  		




  
  5
  
    
      Rechnungen und weitere essenzielle Aufgaben benutzt.</p><p>Der Task-Server muss einmalig global in der Konfigurationsdatei konfiguriert werden. Danach wird er für jeden Mandanten, für den


  		




  
  6
  
    
      er laufen soll, in der Adminsitrationsmaske eingeschaltet.</p><p>Beachten Sie, dass der Task-Server in den Boot-Vorgang Ihres Servers integriert werden muss, damit er automatisch gestartet


  		




  
  7
  
    
      wird. Dies kann kivitendo nicht für Sie erledigen.</p><div class="sect2" title="2.7.1. Verfügbare und notwendige Konfigurationsoptionen"><div class="titlepage"><div><div><h3 class="title"><a name="Konfiguration-des-Task-Servers"></a>2.7.1. Verfügbare und notwendige Konfigurationsoptionen</h3></div></div></div><p>Die Konfiguration erfolgt über den Abschnitt


  		




  6
  8
  
    
        <code class="literal">[task_server]</code> in der Datei


  		




  7
  9
  
    
        <code class="filename">config/kivitendo.conf</code>. Die dort verfügbaren


  		




  8
  10
  
    
        Optionen sind:</p><div class="variablelist"><dl><dt><span class="term">


  		




  9
  
  
    
                     <code class="varname">client</code>


  		




  10
  
  
    
                  </span></dt><dd><p>Name oder Datenbank-ID eines vorhandenen kivitendo-Mandanten, der benutzt wird, um die zu verwendende


  		




  11
  
  
    
              Datenbankverbindung auszulesen. Der Mandant muss in der Administration angelegt werden. Diese Option muss angegeben


  		




  12
  
  
    
              werden.</p><p>Diese Option kam mit Release v3.x.0 hinzu und muss daher in Konfigurationen, die von älteren Versionen aktualisiert


  		




  13
  
  
    
              wurden, ergänzt werden.</p></dd><dt><span class="term">


  		




  14
  
  
    
                     <code class="varname">login</code>


  		




  15
  
  
    
                  </span></dt><dd><p>gültiger kivitendo-Benutzername, der z.B. als Verkäufer beim Erzeugen wiederkehrender Rechnungen benötigt wird. Der


  		




  16
  
  
    
              Benutzer muss in der Administration angelegt werden. Diese Option muss angegeben werden.</p></dd><dt><span class="term">


  		




  17
  11
  
    
                     <code class="varname">run_as</code>


  		




  18
  12
  
    
                  </span></dt><dd><p>Wird der Server vom Systembenutzer <code class="literal">root</code>


  		




  19
  13
  
    
              gestartet, so wechselt er auf den mit <code class="literal">run_as</code>


  		




  20
  14
  
    
              angegebenen Systembenutzer. Der Systembenutzer muss dieselben


  		




  21
  15
  
    
              Lese- und Schreibrechte haben, wie auch der Webserverbenutzer


  		




  22
  16
  
    
              (siehe see <a class="xref" href="ch02s03.html" title="2.3. Manuelle Installation des Programmpaketes">Manuelle Installation des Programmpaketes</a>). Daher


  		




  23
  
  
    
              ist es sinnvoll, hier denselben Systembenutzer einzutragen,


  		




  
  17
  
    
              ist es erforderlich, hier denselben Systembenutzer einzutragen,


  		




  24
  18
  
    
              unter dem auch der Webserver läuft.</p></dd><dt><span class="term">


  		




  25
  19
  
    
                     <code class="varname">debug</code>


  		




  26
  
  
    
                  </span></dt><dd><p>Schaltet Debug-Informationen an und aus.</p></dd></dl></div></div><div class="sect2" title="2.7.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.7.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


  		




  
  20
  
    
                  </span></dt><dd><p>Schaltet Debug-Informationen an und aus.</p></dd></dl></div></div><div class="sect2" title="2.7.2. Konfiguration der Mandanten für den Task-Server"><div class="titlepage"><div><div><h3 class="title"><a name="Konfiguration-der-Mandanten-fuer-den-Task-Servers"></a>2.7.2. Konfiguration der Mandanten für den Task-Server</h3></div></div></div><p>Ist der Task-Server grundlegend konfiguriert, so muss anschließend jeder Mandant, für den der Task-Server laufen soll,


  		




  
  21
  
    
        einmalig konfiguriert werden. Dazu kann in der Maske zum Bearbeiten von Mandanten im Administrationsbereich eine


  		




  
  22
  
    
        kivitendo-Benutzerkennung ausgewählt werden, unter der der Task-Server seine Arbeit verrichtet.</p><p>Ist in dieser Einstellung keine Benutzerkennung ausgewählt, so wird der Task-Server für diesen Mandanten keine Aufgaben


  		




  
  23
  
    
        ausführen.</p></div><div class="sect2" title="2.7.3. Automatisches Starten des Task-Servers beim Booten"><div class="titlepage"><div><div><h3 class="title"><a name="Einbinden-in-den-Boot-Prozess"></a>2.7.3. Automatisches Starten des Task-Servers beim Booten</h3></div></div></div><p>Der Task-Server verhält sich von seinen Optionen her wie ein


  		




  27
  24
  
    
        reguläres SystemV-kompatibles Boot-Script. Außerdem wechselt er beim


  		




  28
  25
  
    
        Starten automatisch in das kivitendo-Installationsverzeichnis.</p><p>Deshalb ist es möglich, ihn durch Setzen eines symbolischen


  		




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


  		




  30
  27
  
    
        einzubinden. Da das bei neueren Linux-Distributionen aber nicht


  		




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


  		




  32
  
  
    
        anstelle eines symbolischen Links verwendet werden können.</p><div class="sect3" title="2.7.2.1. SystemV-basierende Systeme (z.B. Debian, ältere OpenSUSE, ältere Fedora Core)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e980"></a>2.7.2.1. SystemV-basierende Systeme (z.B. Debian, ältere OpenSUSE, ältere Fedora Core)</h4></div></div></div><p>Kopieren Sie die Datei


  		




  
  29
  
    
        anstelle eines symbolischen Links verwendet werden können.</p><div class="sect3" title="2.7.3.1. SystemV-basierende Systeme (z.B. Debian, ältere OpenSUSE, ältere Fedora Core)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e965"></a>2.7.3.1. SystemV-basierende Systeme (z.B. Debian, ältere OpenSUSE, ältere Fedora Core)</h4></div></div></div><p>Kopieren Sie die Datei


  		




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


  		




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


  		




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


  		




  ......




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


  		




  38
  35
  
    
# Nur bei Debian Squeeze und neuer:


  		




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


  		




  40
  
  
    
          werden:</p><pre class="programlisting">/etc/init.d/kivitendo-task-server start</pre></div><div class="sect3" title="2.7.2.2. Upstart-basierende Systeme (z.B. Ubuntu)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e1009"></a>2.7.2.2. Upstart-basierende Systeme (z.B. Ubuntu)</h4></div></div></div><p>Kopieren Sie die Datei


  		




  
  37
  
    
          werden:</p><pre class="programlisting">/etc/init.d/kivitendo-task-server start</pre></div><div class="sect3" title="2.7.3.2. Upstart-basierende Systeme (z.B. Ubuntu)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e994"></a>2.7.3.2. Upstart-basierende Systeme (z.B. Ubuntu)</h4></div></div></div><p>Kopieren Sie die Datei


  		




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


  		




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


  		




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


  		




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


  		




  45
  
  
    
          werden:</p><pre class="programlisting">service kivitendo-task-server start</pre></div><div class="sect3" title="2.7.2.3. systemd-basierende Systeme (z.B. neure OpenSUSE, neuere Fedora Core)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e1027"></a>2.7.2.3. systemd-basierende Systeme (z.B. neure OpenSUSE, neuere Fedora Core)</h4></div></div></div><p>Verlinken Sie die Datei <code class="filename">scripts/boot/systemd/kivitendo-task-server.service</code> nach


  		




  
  42
  
    
          werden:</p><pre class="programlisting">service kivitendo-task-server start</pre></div><div class="sect3" title="2.7.3.3. systemd-basierende Systeme (z.B. neure OpenSUSE, neuere Fedora Core)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e1012"></a>2.7.3.3. systemd-basierende Systeme (z.B. neure OpenSUSE, neuere Fedora Core)</h4></div></div></div><p>Verlinken Sie die Datei <code class="filename">scripts/boot/systemd/kivitendo-task-server.service</code> nach


  		




  46
  43
  
    
          <code class="filename">/etc/systemd/system/</code>. Passen Sie in der kopierten Datei den Pfad zum Task-Server an (Zeile


  		




  47
  44
  
    
          <code class="literal">ExecStart=....</code> und <code class="literal">ExecStop=...</code>). Binden Sie das Script in den Boot-Prozess ein.


  		




  48
  45
  
    
          </p><p>Alle hierzu benötigten Befehle sehen so aus:</p><pre class="programlisting">cd /var/www/kivitendo-erp/scripts/boot/systemd


  		




  49
  46
  
    
ln -s $(pwd)/kivitendo-task-server.service /etc/systemd/system/</pre><p>Danach kann der Task-Server mit dem folgenden Befehl gestartet


  		




  50
  
  
    
          werden:</p><pre class="programlisting">systemctl start kivitendo-task-server.service</pre></div></div><div class="sect2" title="2.7.3. Wie der Task-Server gestartet und beendet wird"><div class="titlepage"><div><div><h3 class="title"><a name="Prozesskontrolle"></a>2.7.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>


  		




  
  47
  
    
          werden:</p><pre class="programlisting">systemctl start kivitendo-task-server.service</pre></div></div><div class="sect2" title="2.7.4. Wie der Task-Server gestartet und beendet wird"><div class="titlepage"><div><div><h3 class="title"><a name="Prozesskontrolle"></a>2.7.4. 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>


  		




  51
  48
  
    
               <code class="literal">Befehl</code> ist dabei eine der folgenden


  		




  52
  49
  
    
        Optionen:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>


  		




  53
  50
  
    
                     <code class="literal">start</code> startet eine neue Instanz des


  		




  ......




  60
  57
  
    
                     <code class="literal">status</code> berichtet, ob der Task-Server


  		




  61
  58
  
    
            läuft.</p></li></ul></div><p>Der Task-Server wechselt beim Starten automatisch in das


  		




  62
  59
  
    
        kivitendo-Installationsverzeichnis.</p><p>Dieselben Optionen können auch für die SystemV-basierenden


  		




  63
  
  
    
        Runlevel-Scripte benutzt werden (siehe oben).</p></div><div class="sect2" title="2.7.4. Task-Server mit mehreren Mandanten"><div class="titlepage"><div><div><h3 class="title"><a name="Prozesskontrolle2"></a>2.7.4. Task-Server mit mehreren Mandanten</h3></div></div></div><p>Beim Task-Server werden der zu verwendende Mandant und Login-Name des Benutzers, unter dem der Task-Server laufen soll, in die


  		




  
  60
  
    
        Runlevel-Scripte benutzt werden (siehe oben).</p></div><div class="sect2" title="2.7.5. Task-Server mit mehreren Mandanten"><div class="titlepage"><div><div><h3 class="title"><a name="Prozesskontrolle2"></a>2.7.5. Task-Server mit mehreren Mandanten</h3></div></div></div><p>Beim Task-Server werden der zu verwendende Mandant und Login-Name des Benutzers, unter dem der Task-Server laufen soll, in die


  		




  64
  61
  
    
        Konfigurationsdatei geschrieben. Hat man mehrere Mandanten, muss man auch mehrere Konfigurationsdateien anlegen.</p><p>Die Konfigurationsdatei ist eine Kopie der Datei kivitendo.conf, wo in der Kategorie <code class="varname">[task_server]</code> die


  		




  65
  62
  
    
        gewünschten Werte für <code class="varname">client</code> und <code class="varname">login</code> eingetragen werden.</p><p>Der alternative Task-Server wird dann mit folgendem Befehl


  		




  66
  63
  
    
        gestartet:</p><pre class="programlisting">./scripts/task_server.pl -c config/DATEINAME.conf</pre></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>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch02s08.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.6. Webserver-Konfiguration&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;2.8. Benutzerauthentifizierung und Administratorpasswort</td></tr></table></div></body></html>


  		












  

    
      doc/html/ch02s08.html
    
  





  43
  43
  
    
        <code class="varname">[authentication]</code>.</p><p>Sollen die Benutzerpasswörter in der Authentifizierungsdatenbank


  		




  44
  44
  
    
        gespeichert werden, so muss der Parameter <code class="varname">module</code>


  		




  45
  45
  
    
        den Wert <code class="literal">DB</code> enthalten. In diesem Fall können sowohl


  		




  46
  
  
    
        der Administrator als auch die Benutzer selber ihre Psaswörter in


  		




  
  46
  
    
        der Administrator als auch die Benutzer selber ihre Passwörter in


  		




  47
  47
  
    
        kivitendo ändern.</p><p>Soll hingegen ein externer LDAP- oder Active-Directory-Server


  		




  48
  48
  
    
        benutzt werden, so muss der Parameter <code class="varname">module</code> auf


  		




  49
  49
  
    
        <code class="literal">LDAP</code> gesetzt werden. In diesem Fall müssen


  		












  

    
      doc/html/ch03s03.html
    
  





  121
  121
  
    
                        <code class="varname">template_meta.language.description</code>


  		




  122
  122
  
    
                     </span></dt><dd><p>Beschreibung der verwendeten Sprache</p></dd><dt><span class="term">


  		




  123
  123
  
    
                        <code class="varname">template_meta.language.template_code</code>


  		




  124
  
  
    
                     </span></dt><dd><p>Vorlagenürzel der verwendeten Sprache, identisch mit dem


  		




  
  124
  
    
                     </span></dt><dd><p>Vorlagenkürzel der verwendeten Sprache, identisch mit dem


  		




  125
  125
  
    
                Kürzel das im Dateinamen verwendetet wird.</p></dd><dt><span class="term">


  		




  126
  126
  
    
                        <code class="varname">template_meta.language.output_numberformat</code>


  		




  127
  127
  
    
                     </span></dt><dd><p>Zahlenformat der verwendeten Sprache in der Form


  		




  ......




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


  		




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


  		




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


  		




  577
  
  
    
                     </span></dt><dd><p>Rechnungsnummer</p></dd></dl></div></div></div><div class="sect2" title="3.3.10. Variablen in anderen Vorlagen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.andere-vorlagen"></a>3.3.10. Variablen in anderen Vorlagen</h3></div></div></div><div class="sect3" title="3.3.10.1. Einführung"><div class="titlepage"><div><div><h4 class="title"><a name="d0e5115"></a>3.3.10.1. Einführung</h4></div></div></div><p>Die Variablen in anderen Vorlagen sind ähnlich wie in der


  		




  
  577
  
    
                     </span></dt><dd><p>Rechnungsnummer</p></dd></dl></div></div></div><div class="sect2" title="3.3.10. Variablen in anderen Vorlagen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.andere-vorlagen"></a>3.3.10. Variablen in anderen Vorlagen</h3></div></div></div><div class="sect3" title="3.3.10.1. Einführung"><div class="titlepage"><div><div><h4 class="title"><a name="d0e5100"></a>3.3.10.1. Einführung</h4></div></div></div><p>Die Variablen in anderen Vorlagen sind ähnlich wie in der


  		




  578
  578
  
    
          Rechnung. Allerdings heißen die Variablen, die mit


  		




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


  		




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


  		












  

    
      doc/html/ch04.html
    
  





  1
  1
  
    
<html><head>


  		




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


  		




  3
  
  
    
   <title>Kapitel 4. Entwicklerdokumentation</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.3.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="index.html" title="kivitendo 3.3.0: Installation, Konfiguration, Entwicklung"><link rel="prev" href="ch03s05.html" title="3.5. Mandantenkonfiguration Lager"><link rel="next" href="ch04s02.html" title="4.2. Entwicklung unter FastCGI"></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 4. Entwicklerdokumentation</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s05.html">Zurück</a>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch04s02.html">Weiter</a></td></tr></table><hr></div><div class="chapter" title="Kapitel 4. Entwicklerdokumentation"><div class="titlepage"><div><div><h2 class="title"><a name="d0e5753"></a>Kapitel 4. Entwicklerdokumentation</h2></div></div></div><div class="sect1" title="4.1. Globale Variablen"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="devel.globals"></a>4.1. Globale Variablen</h2></div></div></div><div class="sect2" title="4.1.1. Wie sehen globale Variablen in Perl aus?"><div class="titlepage"><div><div><h3 class="title"><a name="d0e5759"></a>4.1.1. Wie sehen globale Variablen in Perl aus?</h3></div></div></div><p>Globale Variablen liegen in einem speziellen namespace namens


  		




  
  3
  
    
   <title>Kapitel 4. Entwicklerdokumentation</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.3.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="index.html" title="kivitendo 3.3.0: Installation, Konfiguration, Entwicklung"><link rel="prev" href="ch03s05.html" title="3.5. Mandantenkonfiguration Lager"><link rel="next" href="ch04s02.html" title="4.2. Entwicklung unter FastCGI"></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 4. Entwicklerdokumentation</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s05.html">Zurück</a>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch04s02.html">Weiter</a></td></tr></table><hr></div><div class="chapter" title="Kapitel 4. Entwicklerdokumentation"><div class="titlepage"><div><div><h2 class="title"><a name="d0e5738"></a>Kapitel 4. Entwicklerdokumentation</h2></div></div></div><div class="sect1" title="4.1. Globale Variablen"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="devel.globals"></a>4.1. Globale Variablen</h2></div></div></div><div class="sect2" title="4.1.1. Wie sehen globale Variablen in Perl aus?"><div class="titlepage"><div><div><h3 class="title"><a name="d0e5744"></a>4.1.1. Wie sehen globale Variablen in Perl aus?</h3></div></div></div><p>Globale Variablen liegen in einem speziellen namespace namens


  		




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


  		




  5
  5
  
    
        globs global und die meisten speziellen Variablen sind...


  		




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


  		




  ......




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


  		




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


  		




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


  		




  28
  
  
    
              des scopes zurückgesetzt</p></dd></dl></div></div><div class="sect2" title="4.1.2. Warum sind globale Variablen ein Problem?"><div class="titlepage"><div><div><h3 class="title"><a name="d0e5860"></a>4.1.2. Warum sind globale Variablen ein Problem?</h3></div></div></div><p>Das erste Problem ist <span class="productname">FCGI</span>™.</p><p>


  		




  
  28
  
    
              des scopes zurückgesetzt</p></dd></dl></div></div><div class="sect2" title="4.1.2. Warum sind globale Variablen ein Problem?"><div class="titlepage"><div><div><h3 class="title"><a name="d0e5845"></a>4.1.2. Warum sind globale Variablen ein Problem?</h3></div></div></div><p>Das erste Problem ist <span class="productname">FCGI</span>™.</p><p>


  		




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


  		




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


  		




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


  		




  ......




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


  		




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


  		




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


  		




  42
  
  
    
        schnell ein Tippfehler einschleichen.</p></div><div class="sect2" title="4.1.3. Kanonische globale Variablen"><div class="titlepage"><div><div><h3 class="title"><a name="d0e5893"></a>4.1.3. Kanonische globale Variablen</h3></div></div></div><p>Um dieses Problem im Griff zu halten gibt es einige wenige


  		




  
  42
  
    
        schnell ein Tippfehler einschleichen.</p></div><div class="sect2" title="4.1.3. Kanonische globale Variablen"><div class="titlepage"><div><div><h3 class="title"><a name="d0e5878"></a>4.1.3. Kanonische globale Variablen</h3></div></div></div><p>Um dieses Problem im Griff zu halten gibt es einige wenige


  		




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


  		




  44
  44
  
    
        vorgegebenen Eigenschaften, und alles andere sollte anderweitig


  		




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


  		




  ......




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


  		




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


  		




  64
  64
  
    
        Folgenden eine kurze Erläuterung der bestimmten vorgegebenen


  		




  65
  
  
    
        Eigenschaften (Konventionen):</p><div class="sect3" title="4.1.3.1. $::form"><div class="titlepage"><div><div><h4 class="title"><a name="d0e5957"></a>4.1.3.1. $::form</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Ist ein Objekt der Klasse


  		




  
  65
  
    
        Eigenschaften (Konventionen):</p><div class="sect3" title="4.1.3.1. $::form"><div class="titlepage"><div><div><h4 class="title"><a name="d0e5942"></a>4.1.3.1. $::form</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Ist ein Objekt der Klasse


  		




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


  		




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


  		




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


  		




  ......




  110
  110
  
    
  push @{ $form-&gt;{TEMPLATE_ARRAYS}{number} },          $form-&gt;{"partnumber_$i"};


  		




  111
  111
  
    
  push @{ $form-&gt;{TEMPLATE_ARRAYS}{description} },     $form-&gt;{"description_$i"};


  		




  112
  112
  
    
  # ...


  		




  113
  
  
    
}</pre></div><div class="sect3" title="4.1.3.2. %::myconfig"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6041"></a>4.1.3.2. %::myconfig</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Das einzige Hash unter den globalen Variablen</p></li><li class="listitem"><p>Wird spätestens benötigt wenn auf die Datenbank


  		




  
  113
  
    
}</pre></div><div class="sect3" title="4.1.3.2. %::myconfig"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6026"></a>4.1.3.2. %::myconfig</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Das einzige Hash unter den globalen Variablen</p></li><li class="listitem"><p>Wird spätestens benötigt wenn auf die Datenbank


  		




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


  		




  115
  115
  
    
              extern serialisiert werden, weil da auch der Datenbankzugriff


  		




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


  		




  ......




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


  		




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


  		




  124
  124
  
    
          Informationen über den Benutzer die über die


  		




  125
  
  
    
          Administrator-Schnittstelle eingegeben wurden.</p></div><div class="sect3" title="4.1.3.3. $::locale"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6080"></a>4.1.3.3. $::locale</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Objekt der Klasse "Locale"</p></li><li class="listitem"><p>Wird pro Request erstellt</p></li><li class="listitem"><p>Muss auch für Tests und Scripte immer verfügbar


  		




  
  125
  
    
          Administrator-Schnittstelle eingegeben wurden.</p></div><div class="sect3" title="4.1.3.3. $::locale"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6065"></a>4.1.3.3. $::locale</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Objekt der Klasse "Locale"</p></li><li class="listitem"><p>Wird pro Request erstellt</p></li><li class="listitem"><p>Muss auch für Tests und Scripte immer verfügbar


  		




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


  		




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


  		




  128
  
  
    
          Zahlen- und Datumsformatierungen laufen über dieses Objekt.</p></div><div class="sect3" title="4.1.3.4. $::lxdebug"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6098"></a>4.1.3.4. $::lxdebug</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Objekt der Klasse "LXDebug"</p></li><li class="listitem"><p>Wird global gecached</p></li><li class="listitem"><p>Muss immer verfügbar sein, in nahezu allen


  		




  
  128
  
    
          Zahlen- und Datumsformatierungen laufen über dieses Objekt.</p></div><div class="sect3" title="4.1.3.4. $::lxdebug"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6083"></a>4.1.3.4. $::lxdebug</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Objekt der Klasse "LXDebug"</p></li><li class="listitem"><p>Wird global gecached</p></li><li class="listitem"><p>Muss immer verfügbar sein, in nahezu allen


  		




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


  		




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


  		




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


  		




  ......




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


  		




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


  		




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


  		




  138
  
  
    
$main::lxdebug-&gt;message(0, 'Wer bin ich? Kunde oder Lieferant:' . $form-&gt;{vc});</pre></div><div class="sect3" title="4.1.3.5. $::auth"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6135"></a>4.1.3.5. $::auth</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Objekt der Klasse "SL::Auth"</p></li><li class="listitem"><p>Wird global gecached</p></li><li class="listitem"><p>Hat eine permanente DB Verbindung zur Authdatenbank</p></li><li class="listitem"><p>Wird nach jedem Request resettet.</p></li></ul></div><p>


  		




  
  138
  
    
$main::lxdebug-&gt;message(0, 'Wer bin ich? Kunde oder Lieferant:' . $form-&gt;{vc});</pre></div><div class="sect3" title="4.1.3.5. $::auth"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6120"></a>4.1.3.5. $::auth</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Objekt der Klasse "SL::Auth"</p></li><li class="listitem"><p>Wird global gecached</p></li><li class="listitem"><p>Hat eine permanente DB Verbindung zur Authdatenbank</p></li><li class="listitem"><p>Wird nach jedem Request resettet.</p></li></ul></div><p>


  		




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


  		




  140
  140
  
    
          Rechte des aktuellen Users abzufragen. Obwohl diese Informationen


  		




  141
  141
  
    
          vom aktuellen User abhängen wird das Objekt aus


  		




  142
  142
  
    
          Geschwindigkeitsgründen nur einmal angelegt und dann nach jedem


  		




  143
  143
  
    
          Request kurz resettet.</p><p>Dieses Objekt kapselt auch den gerade aktiven Mandanten. Dessen Einstellungen können über


  		




  144
  144
  
    
          <code class="literal">$::auth-&gt;client</code> abgefragt werden; Rückgabewert ist ein Hash mit den Werten aus der Tabelle


  		




  145
  
  
    
          <code class="literal">auth.clients</code>.</p></div><div class="sect3" title="4.1.3.6. $::lx_office_conf"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6164"></a>4.1.3.6. $::lx_office_conf</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Objekt der Klasse


  		




  
  145
  
    
          <code class="literal">auth.clients</code>.</p></div><div class="sect3" title="4.1.3.6. $::lx_office_conf"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6149"></a>4.1.3.6. $::lx_office_conf</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Objekt der Klasse


  		




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


  		




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


  		




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


  		




  ......




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


  		




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


  		




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


  		




  155
  
  
    
            Hashkeys, sind also nicht gegen Tippfehler abgesichert.</p></td></tr></table></div></div><div class="sect3" title="4.1.3.7. $::instance_conf"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6200"></a>4.1.3.7. $::instance_conf</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Objekt der Klasse


  		




  
  155
  
    
            Hashkeys, sind also nicht gegen Tippfehler abgesichert.</p></td></tr></table></div></div><div class="sect3" title="4.1.3.7. $::instance_conf"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6185"></a>4.1.3.7. $::instance_conf</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Objekt der Klasse


  		




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


  		




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


  		




  158
  158
  
    
          ist hier eine Mandantendatenbank. Beispielsweise überprüft


  		




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


  		




  160
  
  
    
          ob die berüchtigte Bestandsmethode zur Anwendung kommt.</p></div><div class="sect3" title="4.1.3.8. $::dispatcher"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6221"></a>4.1.3.8. $::dispatcher</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Objekt der Klasse


  		




  
  160
  
    
          ob die berüchtigte Bestandsmethode zur Anwendung kommt.</p></div><div class="sect3" title="4.1.3.8. $::dispatcher"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6206"></a>4.1.3.8. $::dispatcher</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Objekt der Klasse


  		




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


  		




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


  		




  163
  163
  
    
          global gespeichert wird. Wird vermutlich irgendwann in einem anderen


  		




  164
  
  
    
          Objekt untergebracht.</p></div><div class="sect3" title="4.1.3.9. $::request"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6239"></a>4.1.3.9. $::request</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Hashref (evtl später Objekt)</p></li><li class="listitem"><p>Wird pro Request neu initialisiert.</p></li><li class="listitem"><p>Keine Unterstruktur garantiert.</p></li></ul></div><p>


  		




  
  164
  
    
          Objekt untergebracht.</p></div><div class="sect3" title="4.1.3.9. $::request"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6224"></a>4.1.3.9. $::request</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Hashref (evtl später Objekt)</p></li><li class="listitem"><p>Wird pro Request neu initialisiert.</p></li><li class="listitem"><p>Keine Unterstruktur garantiert.</p></li></ul></div><p>


  		




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


  		




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


  		




  167
  167
  
    
          at a distance benutzt werden, sondern um lokales memoizing zu


  		




  ......




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


  		




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


  		




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


  		




  177
  
  
    
              Wrappermethode</p></li></ul></div></div></div><div class="sect2" title="4.1.4. Ehemalige globale Variablen"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6281"></a>4.1.4. Ehemalige globale Variablen</h3></div></div></div><p>Die folgenden Variablen waren einmal im Programm, und wurden


  		




  178
  
  
    
        entfernt.</p><div class="sect3" title="4.1.4.1. $::cgi"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6286"></a>4.1.4.1. $::cgi</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>war nötig, weil cookie Methoden nicht als


  		




  
  177
  
    
              Wrappermethode</p></li></ul></div></div></div><div class="sect2" title="4.1.4. Ehemalige globale Variablen"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6266"></a>4.1.4. Ehemalige globale Variablen</h3></div></div></div><p>Die folgenden Variablen waren einmal im Programm, und wurden


  		




  
  178
  
    
        entfernt.</p><div class="sect3" title="4.1.4.1. $::cgi"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6271"></a>4.1.4.1. $::cgi</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>war nötig, weil cookie Methoden nicht als


  		




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


  		




  180
  180
  
    
              Klassennamespace gehalten wird und über Requestgrenzen


  		




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


  		




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


  		




  183
  
  
    
                     </p></li></ul></div></div><div class="sect3" title="4.1.4.2. $::all_units"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6302"></a>4.1.4.2. $::all_units</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>war nötig, weil einige Funktionen in Schleifen zum Teil


  		




  
  183
  
    
                     </p></li></ul></div></div><div class="sect3" title="4.1.4.2. $::all_units"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6287"></a>4.1.4.2. $::all_units</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>war nötig, weil einige Funktionen in Schleifen zum Teil


  		




  184
  184
  
    
              ein paar hundert mal pro Request eine Liste der Einheiten


  		




  185
  185
  
    
              brauchen, und de als Parameter durch einen Riesenstack von


  		




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


  		




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


  		




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


  		




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


  		




  190
  
  
    
              gelesen.</p></li></ul></div></div><div class="sect3" title="4.1.4.3. %::called_subs"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6321"></a>4.1.4.3. %::called_subs</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>wurde benutzt um callsub deep recursions


  		




  
  190
  
    
              gelesen.</p></li></ul></div></div><div class="sect3" title="4.1.4.3. %::called_subs"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6306"></a>4.1.4.3. %::called_subs</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>wurde benutzt um callsub deep recursions


  		




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


  		




  192
  192
  
    
              möglichen Rekursioenen darstellt, und da nie welche


  		




  193
  193
  
    
              auftreten.</p></li><li class="listitem"><p>komplette recursion protection wurde entfernt.</p></li></ul></div></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s05.html">Zurück</a>&nbsp;</td><td width="20%" align="center">&nbsp;</td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch04s02.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">3.5. Mandantenkonfiguration Lager&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;4.2. Entwicklung unter FastCGI</td></tr></table></div></body></html>


  		












  

    
      doc/html/index.html
    
  





  1
  1
  
    
<html><head>


  		




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


  		




  3
  
  
    
   <title>kivitendo 3.3.0: Installation, Konfiguration, Entwicklung</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.3.0: Installation, Konfiguration, Entwicklung"><link rel="next" href="ch01.html" title="Kapitel 1. Aktuelle Hinweise"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">kivitendo 3.3.0: Installation, Konfiguration, Entwicklung</th></tr><tr><td width="20%" align="left">&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch01.html">Weiter</a></td></tr></table><hr></div><div lang="de" class="book" title="kivitendo 3.3.0: Installation, Konfiguration, Entwicklung"><div class="titlepage"><div><div><h1 class="title"><a name="kivitendo-documentation"></a>kivitendo 3.3.0: Installation, Konfiguration, Entwicklung</h1></div></div><hr></div><div class="toc"><p><b>Inhaltsverzeichnis</b></p><dl><dt><span class="chapter"><a href="ch01.html">1. Aktuelle Hinweise</a></span></dt><dt><span class="chapter"><a href="ch02.html">2. Installation und Grundkonfiguration</a></span></dt><dd><dl><dt><span class="sect1"><a href="ch02.html#Installation-%C3%9Cbersicht">2.1. Übersicht</a></span></dt><dt><span class="sect1"><a href="ch02s02.html">2.2. Benötigte Software und Pakete</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s02.html#Betriebssystem">2.2.1. Betriebssystem</a></span></dt><dt><span class="sect2"><a href="ch02s02.html#Pakete">2.2.2. Benötigte Perl-Pakete installieren</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s03.html">2.3. Manuelle Installation des Programmpaketes</a></span></dt><dt><span class="sect1"><a href="ch02s04.html">2.4. kivitendo-Konfigurationsdatei</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s04.html#config.config-file.introduction">2.4.1. Einführung</a></span></dt><dt><span class="sect2"><a href="ch02s04.html#config.config-file.sections-parameters">2.4.2. Abschnitte und Parameter</a></span></dt><dt><span class="sect2"><a href="ch02s04.html#config.config-file.prior-versions">2.4.3. Versionen vor 2.6.3</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s05.html">2.5. Anpassung der PostgreSQL-Konfiguration</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s05.html#Zeichens%C3%A4tze-die-Verwendung-von-UTF-8">2.5.1. Zeichensätze/die Verwendung von Unicode/UTF-8</a></span></dt><dt><span class="sect2"><a href="ch02s05.html#%C3%84nderungen-an-Konfigurationsdateien">2.5.2. Änderungen an Konfigurationsdateien</a></span></dt><dt><span class="sect2"><a href="ch02s05.html#Erweiterung-f%C3%BCr-servergespeicherte-Prozeduren">2.5.3. Erweiterung für servergespeicherte Prozeduren</a></span></dt><dt><span class="sect2"><a href="ch02s05.html#Datenbankbenutzer-anlegen">2.5.4. Datenbankbenutzer anlegen</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s06.html">2.6. Webserver-Konfiguration</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s06.html#d0e757">2.6.1. Grundkonfiguration mittels CGI</a></span></dt><dt><span class="sect2"><a href="ch02s06.html#Apache-Konfiguration.FCGI">2.6.2. Konfiguration für FastCGI/FCGI</a></span></dt><dt><span class="sect2"><a href="ch02s06.html#d0e902">2.6.3. Weitergehende Konfiguration</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s07.html">2.7. Der Task-Server</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s07.html#Konfiguration-des-Task-Servers">2.7.1. Verfügbare und notwendige Konfigurationsoptionen</a></span></dt><dt><span class="sect2"><a href="ch02s07.html#Einbinden-in-den-Boot-Prozess">2.7.2. Automatisches Starten des Task-Servers beim Booten</a></span></dt><dt><span class="sect2"><a href="ch02s07.html#Prozesskontrolle">2.7.3. Wie der Task-Server gestartet und beendet wird</a></span></dt><dt><span class="sect2"><a href="ch02s07.html#Prozesskontrolle2">2.7.4. Task-Server mit mehreren Mandanten</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s08.html">2.8. Benutzerauthentifizierung und Administratorpasswort</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s08.html#Grundlagen-zur-Benutzerauthentifizierung">2.8.1. Grundlagen zur Benutzerauthentifizierung</a></span></dt><dt><span class="sect2"><a href="ch02s08.html#Administratorpasswort">2.8.2. Administratorpasswort</a></span></dt><dt><span class="sect2"><a href="ch02s08.html#Authentifizierungsdatenbank">2.8.3. Authentifizierungsdatenbank</a></span></dt><dt><span class="sect2"><a href="ch02s08.html#Passwort%C3%BCberpr%C3%BCfung">2.8.4. Passwortüberprüfung</a></span></dt><dt><span class="sect2"><a href="ch02s08.html#Name-des-Session-Cookies">2.8.5. Name des Session-Cookies</a></span></dt><dt><span class="sect2"><a href="ch02s08.html#Anlegen-der-Authentifizierungsdatenbank">2.8.6. Anlegen der Authentifizierungsdatenbank</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s09.html">2.9. Mandanten-, Benutzer- und Gruppenverwaltung</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s09.html#Zusammenh%C3%A4nge">2.9.1. Zusammenhänge</a></span></dt><dt><span class="sect2"><a href="ch02s09.html#Mandanten-Benutzer-Gruppen">2.9.2. Mandanten, Benutzer und Gruppen</a></span></dt><dt><span class="sect2"><a href="ch02s09.html#Datenbanken-anlegen">2.9.3. Datenbanken anlegen</a></span></dt><dt><span class="sect2"><a href="ch02s09.html#Gruppen-anlegen">2.9.4. Gruppen anlegen</a></span></dt><dt><span class="sect2"><a href="ch02s09.html#Benutzer-anlegen">2.9.5. Benutzer anlegen</a></span></dt><dt><span class="sect2"><a href="ch02s09.html#Mandanten-anlegen">2.9.6. Mandanten anlegen</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s10.html">2.10. Drucker- und Systemverwaltung</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s10.html#Druckeradministration">2.10.1. Druckeradministration</a></span></dt><dt><span class="sect2"><a href="ch02s10.html#System">2.10.2. System sperren / entsperren</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s11.html">2.11. E-Mail-Versand aus kivitendo heraus</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s11.html#config.sending-email.sendmail">2.11.1. Versand über lokalen E-Mail-Server</a></span></dt><dt><span class="sect2"><a href="ch02s11.html#config.sending-email.smtp">2.11.2. Versand über einen SMTP-Server</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s12.html">2.12. Drucken mit kivitendo</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s12.html#Vorlagenverzeichnis-anlegen">2.12.1. Vorlagenverzeichnis anlegen</a></span></dt><dt><span class="sect2"><a href="ch02s12.html#Vorlagen-RB">2.12.2. Der Druckvorlagensatz RB</a></span></dt><dt><span class="sect2"><a href="ch02s12.html#f-tex">2.12.3. f-tex</a></span></dt><dt><span class="sect2"><a href="ch02s12.html#Vorlagen-rev-odt">2.12.4. Der Druckvorlagensatz rev-odt</a></span></dt><dt><span class="sect2"><a href="ch02s12.html#allgemeine-hinweise-zu-latex">2.12.5. Allgemeine Hinweise zu LaTeX Vorlagen</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s13.html">2.13. OpenDocument-Vorlagen</a></span></dt><dt><span class="sect1"><a href="ch02s14.html">2.14. Konfiguration zur Einnahmenüberschussrechnung/Bilanzierung:


  		




  
  3
  
    
   <title>kivitendo 3.3.0: Installation, Konfiguration, Entwicklung</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.3.0: Installation, Konfiguration, Entwicklung"><link rel="next" href="ch01.html" title="Kapitel 1. Aktuelle Hinweise"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">kivitendo 3.3.0: Installation, Konfiguration, Entwicklung</th></tr><tr><td width="20%" align="left">&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch01.html">Weiter</a></td></tr></table><hr></div><div lang="de" class="book" title="kivitendo 3.3.0: Installation, Konfiguration, Entwicklung"><div class="titlepage"><div><div><h1 class="title"><a name="kivitendo-documentation"></a>kivitendo 3.3.0: Installation, Konfiguration, Entwicklung</h1></div></div><hr></div><div class="toc"><p><b>Inhaltsverzeichnis</b></p><dl><dt><span class="chapter"><a href="ch01.html">1. Aktuelle Hinweise</a></span></dt><dt><span class="chapter"><a href="ch02.html">2. Installation und Grundkonfiguration</a></span></dt><dd><dl><dt><span class="sect1"><a href="ch02.html#Installation-%C3%9Cbersicht">2.1. Übersicht</a></span></dt><dt><span class="sect1"><a href="ch02s02.html">2.2. Benötigte Software und Pakete</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s02.html#Betriebssystem">2.2.1. Betriebssystem</a></span></dt><dt><span class="sect2"><a href="ch02s02.html#Pakete">2.2.2. Benötigte Perl-Pakete installieren</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s03.html">2.3. Manuelle Installation des Programmpaketes</a></span></dt><dt><span class="sect1"><a href="ch02s04.html">2.4. kivitendo-Konfigurationsdatei</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s04.html#config.config-file.introduction">2.4.1. Einführung</a></span></dt><dt><span class="sect2"><a href="ch02s04.html#config.config-file.sections-parameters">2.4.2. Abschnitte und Parameter</a></span></dt><dt><span class="sect2"><a href="ch02s04.html#config.config-file.prior-versions">2.4.3. Versionen vor 2.6.3</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s05.html">2.5. Anpassung der PostgreSQL-Konfiguration</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s05.html#Zeichens%C3%A4tze-die-Verwendung-von-UTF-8">2.5.1. Zeichensätze/die Verwendung von Unicode/UTF-8</a></span></dt><dt><span class="sect2"><a href="ch02s05.html#%C3%84nderungen-an-Konfigurationsdateien">2.5.2. Änderungen an Konfigurationsdateien</a></span></dt><dt><span class="sect2"><a href="ch02s05.html#Erweiterung-f%C3%BCr-servergespeicherte-Prozeduren">2.5.3. Erweiterung für servergespeicherte Prozeduren</a></span></dt><dt><span class="sect2"><a href="ch02s05.html#Datenbankbenutzer-anlegen">2.5.4. Datenbankbenutzer anlegen</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s06.html">2.6. Webserver-Konfiguration</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s06.html#d0e751">2.6.1. Grundkonfiguration mittels CGI</a></span></dt><dt><span class="sect2"><a href="ch02s06.html#Apache-Konfiguration.FCGI">2.6.2. Konfiguration für FastCGI/FCGI</a></span></dt><dt><span class="sect2"><a href="ch02s06.html#d0e896">2.6.3. Weitergehende Konfiguration</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s07.html">2.7. Der Task-Server</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s07.html#Konfiguration-des-Task-Servers">2.7.1. Verfügbare und notwendige Konfigurationsoptionen</a></span></dt><dt><span class="sect2"><a href="ch02s07.html#Konfiguration-der-Mandanten-fuer-den-Task-Servers">2.7.2. Konfiguration der Mandanten für den Task-Server</a></span></dt><dt><span class="sect2"><a href="ch02s07.html#Einbinden-in-den-Boot-Prozess">2.7.3. Automatisches Starten des Task-Servers beim Booten</a></span></dt><dt><span class="sect2"><a href="ch02s07.html#Prozesskontrolle">2.7.4. Wie der Task-Server gestartet und beendet wird</a></span></dt><dt><span class="sect2"><a href="ch02s07.html#Prozesskontrolle2">2.7.5. Task-Server mit mehreren Mandanten</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s08.html">2.8. Benutzerauthentifizierung und Administratorpasswort</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s08.html#Grundlagen-zur-Benutzerauthentifizierung">2.8.1. Grundlagen zur Benutzerauthentifizierung</a></span></dt><dt><span class="sect2"><a href="ch02s08.html#Administratorpasswort">2.8.2. Administratorpasswort</a></span></dt><dt><span class="sect2"><a href="ch02s08.html#Authentifizierungsdatenbank">2.8.3. Authentifizierungsdatenbank</a></span></dt><dt><span class="sect2"><a href="ch02s08.html#Passwort%C3%BCberpr%C3%BCfung">2.8.4. Passwortüberprüfung</a></span></dt><dt><span class="sect2"><a href="ch02s08.html#Name-des-Session-Cookies">2.8.5. Name des Session-Cookies</a></span></dt><dt><span class="sect2"><a href="ch02s08.html#Anlegen-der-Authentifizierungsdatenbank">2.8.6. Anlegen der Authentifizierungsdatenbank</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s09.html">2.9. Mandanten-, Benutzer- und Gruppenverwaltung</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s09.html#Zusammenh%C3%A4nge">2.9.1. Zusammenhänge</a></span></dt><dt><span class="sect2"><a href="ch02s09.html#Mandanten-Benutzer-Gruppen">2.9.2. Mandanten, Benutzer und Gruppen</a></span></dt><dt><span class="sect2"><a href="ch02s09.html#Datenbanken-anlegen">2.9.3. Datenbanken anlegen</a></span></dt><dt><span class="sect2"><a href="ch02s09.html#Gruppen-anlegen">2.9.4. Gruppen anlegen</a></span></dt><dt><span class="sect2"><a href="ch02s09.html#Benutzer-anlegen">2.9.5. Benutzer anlegen</a></span></dt><dt><span class="sect2"><a href="ch02s09.html#Mandanten-anlegen">2.9.6. Mandanten anlegen</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s10.html">2.10. Drucker- und Systemverwaltung</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s10.html#Druckeradministration">2.10.1. Druckeradministration</a></span></dt><dt><span class="sect2"><a href="ch02s10.html#System">2.10.2. System sperren / entsperren</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s11.html">2.11. E-Mail-Versand aus kivitendo heraus</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s11.html#config.sending-email.sendmail">2.11.1. Versand über lokalen E-Mail-Server</a></span></dt><dt><span class="sect2"><a href="ch02s11.html#config.sending-email.smtp">2.11.2. Versand über einen SMTP-Server</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s12.html">2.12. Drucken mit kivitendo</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch02s12.html#Vorlagenverzeichnis-anlegen">2.12.1. Vorlagenverzeichnis anlegen</a></span></dt><dt><span class="sect2"><a href="ch02s12.html#Vorlagen-RB">2.12.2. Der Druckvorlagensatz RB</a></span></dt><dt><span class="sect2"><a href="ch02s12.html#f-tex">2.12.3. f-tex</a></span></dt><dt><span class="sect2"><a href="ch02s12.html#Vorlagen-rev-odt">2.12.4. Der Druckvorlagensatz rev-odt</a></span></dt><dt><span class="sect2"><a href="ch02s12.html#allgemeine-hinweise-zu-latex">2.12.5. Allgemeine Hinweise zu LaTeX Vorlagen</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch02s13.html">2.13. OpenDocument-Vorlagen</a></span></dt><dt><span class="sect1"><a href="ch02s14.html">2.14. Konfiguration zur Einnahmenüberschussrechnung/Bilanzierung:


  		




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


  		




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


  		




  6
  
  
    
        Formularen</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch03s04.html">3.4. Excel-Vorlagen</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch03s04.html#excel-templates.summary">3.4.1. Zusammenfassung</a></span></dt><dt><span class="sect2"><a href="ch03s04.html#excel-templates.usage">3.4.2. Bedienung</a></span></dt><dt><span class="sect2"><a href="ch03s04.html#excel-templates.syntax">3.4.3. Variablensyntax</a></span></dt><dt><span class="sect2"><a href="ch03s04.html#excel-templates.limitations">3.4.4. Einschränkungen</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch03s05.html">3.5. Mandantenkonfiguration Lager</a></span></dt></dl></dd><dt><span class="chapter"><a href="ch04.html">4. Entwicklerdokumentation</a></span></dt><dd><dl><dt><span class="sect1"><a href="ch04.html#devel.globals">4.1. Globale Variablen</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch04.html#d0e5759">4.1.1. Wie sehen globale Variablen in Perl aus?</a></span></dt><dt><span class="sect2"><a href="ch04.html#d0e5860">4.1.2. Warum sind globale Variablen ein Problem?</a></span></dt><dt><span class="sect2"><a href="ch04.html#d0e5893">4.1.3. Kanonische globale Variablen</a></span></dt><dt><span class="sect2"><a href="ch04.html#d0e6281">4.1.4. Ehemalige globale Variablen</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch04s02.html">4.2. Entwicklung unter FastCGI</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch04s02.html#devel.fcgi.general">4.2.1. Allgemeines</a></span></dt><dt><span class="sect2"><a href="ch04s02.html#devel.fcgi.exiting">4.2.2. Programmende und Ausnahmen</a></span></dt><dt><span class="sect2"><a href="ch04s02.html#devel.fcgi.globals">4.2.3. Globale Variablen</a></span></dt><dt><span class="sect2"><a href="ch04s02.html#devel.fcgi.performance">4.2.4. Performance und Statistiken</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch04s03.html">4.3. SQL-Upgradedateien</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch04s03.html#db-upgrade-files.introduction">4.3.1. Einführung</a></span></dt><dt><span class="sect2"><a href="ch04s03.html#db-upgrade-files.format">4.3.2. Format der Kontrollinformationen</a></span></dt><dt><span class="sect2"><a href="ch04s03.html#db-upgrade-files.format-perl-files">4.3.3. Format von in Perl geschriebenen Datenbankupgradescripten</a></span></dt><dt><span class="sect2"><a href="ch04s03.html#db-upgrade-files.dbupgrade-tool">4.3.4. Hilfsscript dbupgrade2_tool.pl</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch04s04.html">4.4. Translations and languages</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch04s04.html#translations-languages.introduction">4.4.1. Introduction</a></span></dt><dt><span class="sect2"><a href="ch04s04.html#translations-languages.character-set">4.4.2. Character set</a></span></dt><dt><span class="sect2"><a href="ch04s04.html#translations-languages.file-structure">4.4.3. File structure</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch04s05.html">4.5. Die kivitendo-Test-Suite</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch04s05.html#devel.testsuite.intro">4.5.1. Einführung</a></span></dt><dt><span class="sect2"><a href="ch04s05.html#devel.testsuite.prerequisites">4.5.2. Voraussetzungen</a></span></dt><dt><span class="sect2"><a href="ch04s05.html#devel.testsuite.execution">4.5.3. 


  		




  
  6
  
    
        Formularen</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch03s04.html">3.4. Excel-Vorlagen</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch03s04.html#excel-templates.summary">3.4.1. Zusammenfassung</a></span></dt><dt><span class="sect2"><a href="ch03s04.html#excel-templates.usage">3.4.2. Bedienung</a></span></dt><dt><span class="sect2"><a href="ch03s04.html#excel-templates.syntax">3.4.3. Variablensyntax</a></span></dt><dt><span class="sect2"><a href="ch03s04.html#excel-templates.limitations">3.4.4. Einschränkungen</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch03s05.html">3.5. Mandantenkonfiguration Lager</a></span></dt></dl></dd><dt><span class="chapter"><a href="ch04.html">4. Entwicklerdokumentation</a></span></dt><dd><dl><dt><span class="sect1"><a href="ch04.html#devel.globals">4.1. Globale Variablen</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch04.html#d0e5744">4.1.1. Wie sehen globale Variablen in Perl aus?</a></span></dt><dt><span class="sect2"><a href="ch04.html#d0e5845">4.1.2. Warum sind globale Variablen ein Problem?</a></span></dt><dt><span class="sect2"><a href="ch04.html#d0e5878">4.1.3. Kanonische globale Variablen</a></span></dt><dt><span class="sect2"><a href="ch04.html#d0e6266">4.1.4. Ehemalige globale Variablen</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch04s02.html">4.2. Entwicklung unter FastCGI</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch04s02.html#devel.fcgi.general">4.2.1. Allgemeines</a></span></dt><dt><span class="sect2"><a href="ch04s02.html#devel.fcgi.exiting">4.2.2. Programmende und Ausnahmen</a></span></dt><dt><span class="sect2"><a href="ch04s02.html#devel.fcgi.globals">4.2.3. Globale Variablen</a></span></dt><dt><span class="sect2"><a href="ch04s02.html#devel.fcgi.performance">4.2.4. Performance und Statistiken</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch04s03.html">4.3. SQL-Upgradedateien</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch04s03.html#db-upgrade-files.introduction">4.3.1. Einführung</a></span></dt><dt><span class="sect2"><a href="ch04s03.html#db-upgrade-files.format">4.3.2. Format der Kontrollinformationen</a></span></dt><dt><span class="sect2"><a href="ch04s03.html#db-upgrade-files.format-perl-files">4.3.3. Format von in Perl geschriebenen Datenbankupgradescripten</a></span></dt><dt><span class="sect2"><a href="ch04s03.html#db-upgrade-files.dbupgrade-tool">4.3.4. Hilfsscript dbupgrade2_tool.pl</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch04s04.html">4.4. Translations and languages</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch04s04.html#translations-languages.introduction">4.4.1. Introduction</a></span></dt><dt><span class="sect2"><a href="ch04s04.html#translations-languages.character-set">4.4.2. Character set</a></span></dt><dt><span class="sect2"><a href="ch04s04.html#translations-languages.file-structure">4.4.3. File structure</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch04s05.html">4.5. Die kivitendo-Test-Suite</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch04s05.html#devel.testsuite.intro">4.5.1. Einführung</a></span></dt><dt><span class="sect2"><a href="ch04s05.html#devel.testsuite.prerequisites">4.5.2. Voraussetzungen</a></span></dt><dt><span class="sect2"><a href="ch04s05.html#devel.testsuite.execution">4.5.3. 


  		




  7
  7
  
    
          Existierende Tests ausführen


  		




  8
  8
  
    
        </a></span></dt><dt><span class="sect2"><a href="ch04s05.html#devel.testsuite.meaning_of_scripts">4.5.4. 


  		




  9
  9
  
    
          Bedeutung der verschiedenen Test-Scripte


  		












  

    
      locale/de/all
    
  





  915
  915
  
    
  'Do not check for duplicates' => 'Nicht nach Dubletten suchen',


  		




  916
  916
  
    
  'Do not link to a project.'   => 'Nicht mit einem Projekt verknüpfen.',


  		




  917
  917
  
    
  'Do not modify this position' => 'Diese Position nicht verändern',


  		




  
  918
  
    
  'Do not run the task server for this client' => 'Task-Server nicht für diesen Mandanten ausführen',


  		




  918
  919
  
    
  'Do not set default buchungsgruppe' => 'Nie Standardbuchungsgruppe setzen',


  		




  919
  920
  
    
  'Do not set this bin'         => 'Diesen Lagerplatz nicht setzen',


  		




  920
  921
  
    
  'Do not set this comment'     => 'Diesen Kommentar nicht setzen',


  		




  ......




  2261
  2262
  
    
  'Rule for vendor must not be empty' => 'Eine Lieferantenbedingung darf nicht leer sein',


  		




  2262
  2263
  
    
  'Run JavaScript unit tests'   => 'JavaScript-Unit-Tests ausführen',


  		




  2263
  2264
  
    
  'Run at'                      => 'Ausgeführt um',


  		




  
  2265
  
    
  'Run task server for this client with the following user' => 'Task-Server für diesen Mandanten mit der folgenden BenutzerIn ausführen',


  		




  2264
  2266
  
    
  'Run tests'                   => 'Tests ausführen',


  		




  2265
  2267
  
    
  'SAVED'                       => 'Gespeichert',


  		




  2266
  2268
  
    
  'SAVED FOR DUNNING'           => 'Gespeichert',


  		




  ......




  2893
  2895
  
    
  'The unit in row %d has been used in the meantime and cannot be changed anymore.' => 'Die Einheit in Zeile %d wurde in der Zwischenzeit benutzt und kann nicht mehr ge&auml;ndert werden.',


  		




  2894
  2896
  
    
  'The units have been saved.'  => 'Die Einheiten wurden gespeichert.',


  		




  2895
  2897
  
    
  'The user can chose which client to connect to during login.' => 'Bei der Anmeldung kann der Benutzer auswählen, welchen Mandanten er benutzen möchte.',


  		




  
  2898
  
    
  'The user cannot be deleted as it is used in the following clients: #1' => 'Die BenutzerIn kann nicht gelöscht werden, da sie für die folgenden Mandanten benötigt wird: #1',


  		




  2896
  2899
  
    
  'The user could not be deleted.' => 'Der Benutzer konnte nicht gelöscht werden.',


  		




  2897
  2900
  
    
  'The user group could not be deleted.' => 'Die Benutzergurppe konnte nicht gelöscht werden.',


  		




  2898
  2901
  
    
  'The user group has been created.' => 'Die Benutzergruppe wurde erstellt.',


  		












  

    
      scripts/task_server.pl
    
  





  32
  32
  
    
use List::Util qw(first);


  		




  33
  33
  
    
use POSIX qw(setuid setgid);


  		




  34
  34
  
    
use SL::Auth;


  		




  
  35
  
    
use SL::DB::AuthClient;


  		




  35
  36
  
    
use SL::DB::BackgroundJob;


  		




  36
  37
  
    
use SL::BackgroundJob::ALL;


  		




  37
  38
  
    
use SL::Form;


  		




  ......




  48
  49
  
    

  		




  49
  50
  
    
sub debug {


  		




  50
  51
  
    
  return if !$lx_office_conf{task_server}->{debug};


  		




  51
  
  
    
  $::lxdebug->message(0, @_);


  		




  
  52
  
    
  $::lxdebug->message(LXDebug::DEBUG1(), join(' ', "task server:", @_));


  		




  
  53
  
    
}


  		




  
  54
  
    

  		




  
  55
  
    
sub enabled_clients {


  		




  
  56
  
    
  return SL::DB::Manager::AuthClient->get_all(where => [ '!task_server_user_id' => undef ]);


  		




  52
  57
  
    
}


  		




  53
  58
  
    

  		




  54
  59
  
    
sub initialize_kivitendo {


  		




  55
  
  
    
  chdir $exe_dir;


  		




  
  60
  
    
  my ($client) = @_;


  		




  56
  61
  
    

  		




  57
  
  
    
  my $login  = $lx_office_conf{task_server}->{login};


  		




  58
  
  
    
  my $client = $lx_office_conf{task_server}->{client};


  		




  
  62
  
    
  chdir $exe_dir;


  		




  59
  63
  
    

  		




  60
  64
  
    
  package main;


  		




  61
  65
  
    

  		




  ......




  64
  68
  
    
  $::locale        = Locale->new($::lx_office_conf{system}->{language});


  		




  65
  69
  
    
  $::form          = Form->new;


  		




  66
  70
  
    
  $::auth          = SL::Auth->new;


  		




  67
  
  
    
  die "No client configured or no client found with the name/ID '$client'" unless $::auth->set_client($client);


  		




  
  71
  
    

  		




  
  72
  
    
  return if !$client;


  		




  
  73
  
    

  		




  
  74
  
    
  $::auth->set_client($client->id);


  		




  
  75
  
    

  		




  
  76
  
    
  $::form->{__ERROR_HANDLER} = sub { die @_ };


  		




  
  77
  
    

  		




  68
  78
  
    
  $::instance_conf = SL::InstanceConfiguration->new;


  		




  69
  79
  
    
  $::request       = SL::Request->new(


  		




  70
  80
  
    
    cgi            => CGI->new({}),


  		




  ......




  76
  86
  
    
  $::auth->restore_session;


  		




  77
  87
  
    
  $::auth->create_or_refresh_session;


  		




  78
  88
  
    

  		




  
  89
  
    
  my $login = $client->task_server_user->login;


  		




  
  90
  
    

  		




  79
  91
  
    
  die "cannot find user $login"            unless %::myconfig = $::auth->read_user(login => $login);


  		




  80
  92
  
    
  die "cannot find locale for user $login" unless $::locale   = Locale->new($::myconfig{countrycode} || $::lx_office_conf{system}->{language});


  		




  81
  
  
    

  		




  82
  
  
    
  $::form->{__ERROR_HANDLER} = sub { die @_ };


  		




  83
  93
  
    
}


  		




  84
  94
  
    

  		




  85
  95
  
    
sub cleanup_kivitendo {


  		




  ......




  93
  103
  
    
  $::form     = undef;


  		




  94
  104
  
    
  $::myconfig = ();


  		




  95
  105
  
    
  $::request  = undef;


  		




  
  106
  
    
  $::auth     = undef;


  		




  
  107
  
    
}


  		




  
  108
  
    

  		




  
  109
  
    
sub clean_before_sleeping {


  		




  96
  110
  
    
  Form::disconnect_standard_dbh;


  		




  
  111
  
    
  SL::DBConnect::Cache->disconnect_all_and_clear;


  		




  
  112
  
    
  SL::DB->db_cache->clear;


  		




  97
  113
  
    
}


  		




  98
  114
  
    

  		




  99
  115
  
    
sub drop_privileges {


  		




  ......




  155
  171
  
    

  		




  156
  172
  
    
  $params{client} = $::auth->client;


  		




  157
  173
  
    

  		




  158
  
  
    
  my $body;


  		




  159
  
  
    
  $template->process($cfg->{email_template}, \%params, \$body);


  		




  160
  
  
    

  		




  161
  
  
    
  Mailer->new(


  		




  162
  
  
    
    from         => $cfg->{email_from},


  		




  163
  
  
    
    to           => $email_to,


  		




  164
  
  
    
    subject      => $cfg->{email_subject},


  		




  165
  
  
    
    content_type => 'text/plain',


  		




  166
  
  
    
    charset      => 'utf-8',


  		




  167
  
  
    
    message      => Encode::decode('utf-8', $body),


  		




  168
  
  
    
  )->send;


  		




  
  174
  
    
  eval {


  		




  
  175
  
    
    my $body;


  		




  
  176
  
    
    $template->process($cfg->{email_template}, \%params, \$body);


  		




  
  177
  
    

  		




  
  178
  
    
    Mailer->new(


  		




  
  179
  
    
      from         => $cfg->{email_from},


  		




  
  180
  
    
      to           => $email_to,


  		




  
  181
  
    
      subject      => $cfg->{email_subject},


  		




  
  182
  
    
      content_type => 'text/plain',


  		




  
  183
  
    
      charset      => 'utf-8',


  		




  
  184
  
    
      message      => Encode::decode('utf-8', $body),


  		




  
  185
  
    
    )->send;


  		




  
  186
  
    

  		




  
  187
  
    
    1;


  		




  
  188
  
    
  } or do {


  		




  
  189
  
    
    debug("Sending a failure notification failed with an exception: $@");


  		




  
  190
  
    
  };


  		




  169
  191
  
    
}


  		




  170
  192
  
    

  		




  171
  193
  
    
sub gd_preconfig {


  		




  ......




  173
  195
  
    

  		




  174
  196
  
    
  SL::LxOfficeConf->read($self->{configfile});


  		




  175
  197
  
    

  		




  176
  
  
    
  die "Missing section [task_server] in config file"                 unless $lx_office_conf{task_server};


  		




  177
  
  
    
  die "Missing key 'login' in section [task_server] in config file"  unless $lx_office_conf{task_server}->{login};


  		




  178
  
  
    
  die "Missing key 'client' in section [task_server] in config file" unless $lx_office_conf{task_server}->{client};


  		




  
  198
  
    
  die "Missing section [task_server] in config file" unless $lx_office_conf{task_server};


  		




  
  199
  
    

  		




  
  200
  
    
  if ($lx_office_conf{task_server}->{login} || $lx_office_conf{task_server}->{client}) {


  		




  
  201
  
    
    print STDERR <<EOT;


  		




  
  202
  
    
ERROR: The keys 'login' and/or 'client' are still present in the


  		




  
  203
  
    
section [task_server] in the configuration file. These keys are


  		




  
  204
  
    
deprecated. You have to configure the clients for which to run the


  		




  
  205
  
    
task server in the web admin interface.


  		




  
  206
  
    

  		




  
  207
  
    
The task server will refuse to start until the keys have been removed from


  		




  
  208
  
    
the configuration file.


  		




  
  209
  
    
EOT


  		




  
  210
  
    
    exit 2;


  		




  
  211
  
    
  }


  		




  179
  212
  
    

  		




  180
  213
  
    
  drop_privileges();


  		




  181
  
  
    
  initialize_kivitendo();


  		




  182
  214
  
    

  		




  183
  215
  
    
  return ();


  		




  184
  216
  
    
}


  		




  185
  217
  
    

  		




  186
  
  
    
sub gd_run {


  		




  187
  
  
    
  while (1) {


  		




  188
  
  
    
    my $ok = eval {


  		




  189
  
  
    
      initialize_kivitendo();


  		




  
  218
  
    
sub run_once_for_all_clients {


  		




  
  219
  
    
  initialize_kivitendo();


  		




  
  220
  
    

  		




  
  221
  
    
  my $clients = enabled_clients();


  		




  
  222
  
    

  		




  
  223
  
    
  foreach my $client (@{ $clients }) {


  		




  
  224
  
    
    debug("Running for client ID " . $client->id . " (" . $client->name . ")");


  		




  190
  225
  
    

  		




  191
  
  
    
      debug("Retrieving jobs");


  		




  
  226
  
    
    my $ok = eval {


  		




  
  227
  
    
      initialize_kivitendo($client);


  		




  192
  228
  
    

  		




  193
  229
  
    
      my $jobs = SL::DB::Manager::BackgroundJob->get_all_need_to_run;


  		




  194
  230
  
    

  		




  195
  
  
    
      debug("  Found: " . join(' ', map { $_->package_name } @{ $jobs })) if @{ $jobs };


  		




  
  231
  
    
      if (@{ $jobs }) {


  		




  
  232
  
    
        debug(" Executing the following jobs: " . join(' ', map { $_->package_name } @{ $jobs }));


  		




  
  233
  
    
      } else {


  		




  
  234
  
    
        debug(" No jobs to execute found");


  		




  
  235
  
    
      }


  		




  196
  236
  
    

  		




  197
  237
  
    
      foreach my $job (@{ $jobs }) {


  		




  198
  238
  
    
        # Provide fresh global variables in case legacy code modifies


  		




  199
  239
  
    
        # them somehow.


  		




  200
  
  
    
        initialize_kivitendo();


  		




  
  240
  
    
        initialize_kivitendo($client);


  		




  201
  241
  
    

  		




  202
  242
  
    
        my $history = $job->run;


  		




  203
  243
  
    

  		




  ......




  214
  254
  
    
    }


  		




  215
  255
  
    

  		




  216
  256
  
    
    cleanup_kivitendo();


  		




  
  257
  
    
  }


  		




  
  258
  
    
}


  		




  
  259
  
    

  		




  
  260
  
    
sub gd_run {


  		




  
  261
  
    
  while (1) {


  		




  
  262
  
    
    run_once_for_all_clients();


  		




  217
  263
  
    

  		




  218
  264
  
    
    debug("Sleeping");


  		




  219
  265
  
    

  		




  
  266
  
    
    clean_before_sleeping();


  		




  
  267
  
    

  		




  220
  268
  
    
    my $seconds = 60 - (localtime)[0];


  		




  221
  269
  
    
    if (!eval {


  		




  222
  270
  
    
      local $SIG{'ALRM'} = sub {


  		












  

    
      sql/Pg-upgrade2-auth/client_task_server.sql
    
  





  
  1
  
    
-- @tag: client_task_server


  		




  
  2
  
    
-- @description: Einstellungen, um eine Task-Server-Instanz für mehrere Mandanten laufen zu lassen


  		




  
  3
  
    
-- @depends: release_3_3_0


  		




  
  4
  
    
ALTER TABLE auth.clients ADD COLUMN task_server_user_id INTEGER;


  		




  
  5
  
    
ALTER TABLE auth.clients ADD FOREIGN KEY (task_server_user_id) REFERENCES auth.user (id);


  		












  

    
      templates/webpages/admin/edit_client.html
    
  





  49
  49
  
    
    [% L.input_tag("client.dbpasswd", SELF.client.dbpasswd, class="contains_dbsettings", type="password") %]


  		




  50
  50
  
    
   </td>


  		




  51
  51
  
    
  </tr>


  		




  
  52
  
    

  		




  
  53
  
    
  <tr>


  		




  
  54
  
    
   <th align="right">[% LxERP.t8("Run task server for this client with the following user") %]</th>


  		




  
  55
  
    
   <td>


  		




  
  56
  
    
    [% L.select_tag("client.task_server_user_id", SELF.all_users, with_empty=1, empty_title=LxERP.t8("Do not run the task server for this client"), title_key="login", default=SELF.client.task_server_user_id) %]


  		




  
  57
  
    
   </td>


  		




  
  58
  
    
  </tr>


  		




  52
  59
  
    
 </table>


  		




  53
  60
  
    

  		




  54
  61
  
    
 <div>


  		












  

    
      templates/webpages/admin/edit_user.html
    
  





  1
  1
  
    
[%- USE HTML %]


  		




  2
  
  
    
[%- USE L %][%- USE LxERP -%]


  		




  
  2
  
    
[%- USE L %][%- USE LxERP -%][%- USE JavaScript -%]


  		




  3
  3
  
    

  		




  4
  4
  
    
[%- INCLUDE 'common/flash.html' %]


  		




  5
  5
  
    

  		




  ......




  157
  157
  
    
 [% L.button_tag("submit_with_action('save_user')", LxERP.t8("Save")) %]


  		




  158
  158
  
    
 [% IF SELF.user.id %]


  		




  159
  159
  
    
  [% L.button_tag("save_as_new()", LxERP.t8("Save as new")) %]


  		




  160
  
  
    
  [% L.button_tag("submit_with_action('delete_user')", LxERP.t8("Delete"), confirm=LxERP.t8("Are you sure?")) %]


  		




  
  160
  
    
  [% L.button_tag("submit_delete()", LxERP.t8("Delete"), confirm=LxERP.t8("Are you sure?")) %]


  		




  161
  161
  
    
 [%- END %]


  		




  162
  162
  
    
</p>


  		




  163
  163
  
    

  		




  ......




  170
  170
  
    
    $("#form").submit();


  		




  171
  171
  
    
  }


  		




  172
  172
  
    

  		




  
  173
  
    
  function submit_delete() {


  		




  
  174
  
    
[% SET used_for_task_server_in_clients = SELF.is_user_used_for_task_server(SELF.user) %]


  		




  
  175
  
    
[% IF used_for_task_server_in_clients %]


  		




  
  176
  
    
   alert('[% LxERP.t8('The user cannot be deleted as it is used in the following clients: #1', used_for_task_server_in_clients) | js %]');


  		




  
  177
  
    
   return false;


  		




  
  178
  
    
[% ELSE %]


  		




  
  179
  
    
    submit_with_action('delete_user');


  		




  
  180
  
    
[% END %]


  		




  
  181
  
    
  }


  		




  
  182
  
    

  		




  173
  183
  
    
  function save_as_new() {


  		




  174
  184
  
    
    $("#user_id").val("");


  		




  175
  185
  
    
    submit_with_action("save_user");


  		












Auch abrufbar als:  Unified diff