projekt kivitendo

        Unter <productname>FCGI</productname> 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.</para>

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

        und alles andere sollte anderweitig umhergereicht werden.</para>

        <para>Damit diese nicht erneut als Müllhalde missbraucht werden, im Folgenden

        eine kurze Erläuterung der bestimmten vorgegebenen Eigenschaften (Konventionen):</para>

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

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

          Sicherheit bringen. </para>

          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:

          <programlisting>

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

            $::myconfig{numberformat} = $numberformat;

            # (...) div Berechnungen

            $::myconfig{numberformat} = $saved_numberformat;

          </programlisting>

          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.</para>

          <varname>$::form-&gt;{var}</varname>.

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

          man häufiger solche Konstrukte:

          <programlisting>

            [%- IF business %]

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

            [%- END %]

         </programlisting>

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

        <function>$form->parse_html_template</function> wird explizit noch ein zusätzlicher Hash

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

          <function>$form->parse_html_template("is/form_header", \%TMPL_VAR);</function>

          Innerhalb von Schleifen wird

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

          in Schleife läuft:

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

         </programlisting>

                 </sect3>

              für diesen user drinsteht.</para>

          <varname>%::myconfig</varname>.

          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.

        </para>

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

          Beispielsweise so:

          <programlisting>

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

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

          </programlisting>

          <para>Globale Konfiguration. Configdateien werden zum Start gelesen

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

          <para>Beispielsweise ist über den Konfigurationseintrag [debug]

                die Debug- und Trace-Log-Datei wie folgt konfiguriert und verfügbar:</para>

file = /tmp/lx-office-debug.log</programlisting>

          ist hier eine Mandantendatenbank.

          Beispielsweise überprüft

          <programlisting>$::instance_conf->get_inventory_system eq 'perpetual'</programlisting>

          ob die berüchtigte Bestandsmethode zur Anwendung kommt.</para>

       <varlistentry>

        <term><varname>ignore</varname></term>

        <listitem>

         <para>

          Optional. Falls der Wert auf 1 (true) steht, wird das Skript bei der Anmeldung ignoriert und entsprechend nicht ausgeführt.

         </para>

        </listitem>

       </varlistentry>

         Die maximale Zeilenlänge ist nicht beschränkt. Zeilenlängen unterhalb von 79 Zeichen helfen unter bestimmten Bedingungen, aber