projekt kivitendo

        Unter <span class="productname">FCGI</span>&#8482; m?ssen diese Sachen aber wieder

        Datenbankverbindungen, weil die sehr lange zum Initialisieren

        dies hat, seit der Einf?hrung, u.a. schon so manche langwierige Bug-Suche verk?rzt.

        Da globale Variablen aber implizit mit Package angegeben werden, werden

        die nicht gepr?ft, und somit kann sich 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="d0e4383"></a>4.1.3. Kanonische globale Variablen</h3></div></div></div><p>Um dieses Problem im Griff zu halten gibt es einige wenige

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

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

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

        eine kurze Erl?uterung der bestimmten vorgegebenen Eigenschaften (Konventionen):</p><div class="sect3" title="4.1.3.1. $::form"><div class="titlepage"><div><div><h4 class="title"><a name="d0e4447"></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

          hei?t, alles was einem lieb ist (alle Variablen die einem ans Herz

          gewachsen sind), sollte man vor einem Aufruf (!) von zum

          Sicherheit bringen. </p>

          Z.B. das vom Benutzer eingestellte Zahlenformat, bevor man Berechnung in einem

          bestimmten Format durchf?hrt (SL/Form.pm Zeile 3552, Stand version 2.7beta), um

          dies hinterher wieder auf den richtigen Wert zu setzen:

          <pre class="programlisting">

            my $saved_numberformat    = $::myconfig{numberformat};

            $::myconfig{numberformat} = $numberformat;

            # (...) div Berechnungen

            $::myconfig{numberformat} = $saved_numberformat;

          </pre><p>Das Objekt der Klasse Form hat leider im Moment noch viele

          zentrale Funktionen die vom internen Zustand abh?ngen, deshalb

          bitte nie einfach zerst?ren oder ?berschreiben (zumindestens nicht kurz

          vor einem Release oder in Absprache ?ber bspw. die devel-Liste ;-).

          Es geht ziemlich sicher etwas kaputt.</p><p>

          <code class="varname">$::form-&gt;{var}</code>.

          Nochmal von der anderen Seite erl?utert, innerhalb von (Web-)Templates sieht

          man h?ufiger solche Konstrukte:

          </p><pre class="programlisting">

            [%- IF business %]

            # (... Zeig die Auswahlliste Kunden-/Lieferantentyp an

            [%- END %]

         </pre><p>

        Entweder wird hier dann $::form->{business} ausgewertet oder aber der Funktion

        <code class="function">$form-&gt;parse_html_template</code> wird explizit noch ein zus?tzlicher Hash

        ?bergeben, der dann auch in den (Web-)Templates zu Verf?gung steht, bspw. so:

          <code class="function">$form-&gt;parse_html_template("is/form_header", \%TMPL_VAR);</code>

          Innerhalb von Schleifen wird

          bevorzugt, wenn vorhanden.</p>

          Zum Beispiel in SL/DO.pm welche ?ber alle Positionen eines Lieferscheins

          in Schleife l?uft:

          <pre class="programlisting">

            for $i (1 .. $form->{rowcount}) {

              (...)

              push @{ $form->{TEMPLATE_ARRAYS}{runningnumber} },   $position;

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

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

         </pre></div><div class="sect3" title="4.1.3.2. %::myconfig"><div class="titlepage"><div><div><h4 class="title"><a name="d0e4529"></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

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

          <code class="varname">%::myconfig</code>.

          Innerhalb der Anwendungen sind dies ?berwiegend die Daten, die sich

          unter Programm->Einstellungen befinden, bzw. die Informationen ?ber den

          Benutzer die ?ber die Administrator-Schnittstelle (admin.pl) eingegeben wurden.

        </p></div><div class="sect3" title="4.1.3.3. $::locale"><div class="titlepage"><div><div><h4 class="title"><a name="d0e4562"></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

          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="d0e4580"></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

          denen man flott Informationen ins Log (tmp/lx-office-debug.log) packen kann.</p>

          Beispielsweise so:

          <pre class="programlisting">

            $main::lxdebug->message(0, 'Meine Konfig:' . Dumper (%::myconfig));

            $main::lxdebug->message(0, 'Wer bin ich? Kunde oder Lieferant:' . $form->{vc});

          </pre></div><div class="sect3" title="4.1.3.5. $::auth"><div class="titlepage"><div><div><h4 class="title"><a name="d0e4616"></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>

          Request kurz resettet.</p></div><div class="sect3" title="4.1.3.6. $::lx_office_conf"><div class="titlepage"><div><div><h4 class="title"><a name="d0e4637"></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

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

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

          Programm die Konfiguration ?ndern kann oder sollte.</p><p>Beispielsweise ist ?ber den Konfigurationseintrag [debug]

                die Debug- und Trace-Log-Datei wie folgt konfiguriert und verf?gbar:</p><pre class="programlisting">[debug]

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

            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="d0e4673"></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

          ist hier eine Mandantendatenbank.

          Beispielsweise ?berpr?ft

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

          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="d0e4694"></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

          Objekt untergebracht.</p></div><div class="sect3" title="4.1.3.9. $::request"><div class="titlepage"><div><div><h4 class="title"><a name="d0e4712"></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>

              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="d0e4754"></a>4.1.4. Ehemalige globale Variablen</h3></div></div></div><p>Die folgenden Variablen waren einmal im Programm, und wurden

        entfernt.</p><div class="sect3" title="4.1.4.1. $::cgi"><div class="titlepage"><div><div><h4 class="title"><a name="d0e4759"></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

                     </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="d0e4775"></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

              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="d0e4794"></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