projekt kivitendo

use DateTime;

use List::Util qw(any);

sub create_job {

  $_[0]->create_standard_job('7 3 1 * *'); # every first day of month at 03:07

}

  # convert date from string to object

  my $from_date;

  my $to_date;

  $from_date = DateTime->from_kivitendo($self->params->{from_date});

  $to_date   = DateTime->from_kivitendo($self->params->{to_date});

  # DateTime->from_kivitendo returns undef if the string cannot be parsed. Therefore test the result.

  $to_date->add(days => 1); # to get all from the to_date, because of the time part (15.12.2020 23.59 > 15.12.2020)

  { name => "Text::CSV_XS",    version => '0.23',  url => "http://search.cpan.org/~hmbrand/",   debian => 'libtext-csv-xs-perl' },

  { name => "Text::Iconv",     version => '1.2',   url => "http://search.cpan.org/~mpiotr/",    debian => 'libtext-iconv-perl' },

  { name => "Text::Unidecode",                     url => "http://search.cpan.org/~sburke/",    debian => 'libtext-unidecode-perl' },

  { name => "URI",             version => '1.35',  url => "http://search.cpan.org/~gaas/",      debian => 'liburi-perl' },

  { name => "XML::LibXML",                         url => "https://metacpan.org/pod/XML::LibXML", debian => 'libxml-libxml-perl' },

  { name => "XML::Writer",     version => '0.602', url => "http://search.cpan.org/~josephw/",   debian => 'libxml-writer-perl' },

Wichtige Hinweise zum Upgrade von älteren Versionen

===================================================

Die Abwärtskompatibilität zur Lagermengen-Berechnung in Lieferscheinen wurde

aufgehoben. Wer nicht mit Workflows arbeitet (nicht empfohlen) muss diese

          <listitem>

            <para><literal>Text::Iconv</literal></para>

          </listitem>

          <listitem>

            <para><literal>Text::Unidecode</literal></para>

          </listitem>

          <listitem>

            <para><literal>URI</literal></para>

          </listitem>

  libdaemon-generic-perl libfile-flock-perl libfile-slurp-perl\

  libfile-mimeinfo-perl libpbkdf2-tiny-perl libregexp-ipv6-perl \

  libdatetime-event-cron-perl libexception-class-perl libcam-pdf-perl \

</programlisting>

<para>Sollten Pakete nicht zu Verfügung stehen, so können diese auch mittels CPAN installiert werden. Ferner muss für Ubuntu das Repository "Universe" aktiv sein (s.a. Anmerkungen).</para>

          <note id="ubuntu-universe">

                     <code class="literal">Text::Iconv</code>

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

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

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

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

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

        sind auch in 2.6.1 weiterhin mit ausgeliefert, wurden in einer

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

        empfohlen diese Module zusammen mit den anderen als Bibliotheken zu

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

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

  libconfig-std-perl libdatetime-perl libdbd-pg-perl libdbi-perl \

  libdaemon-generic-perl libfile-flock-perl libfile-slurp-perl\

  libfile-mimeinfo-perl libpbkdf2-tiny-perl libregexp-ipv6-perl \

  libdatetime-event-cron-perl libexception-class-perl libcam-pdf-perl \

</pre><p>Sollten Pakete nicht zu Verfügung stehen, so können diese auch mittels CPAN installiert werden. Ferner muss für Ubuntu das Repository "Universe" aktiv sein (s.a. Anmerkungen).</p><div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="system/docbook-xsl/images/note.png"></td><th align="left"><a name="ubuntu-universe"></a>Anmerkung</th></tr><tr><td align="left" valign="top"><p>Die Perl Pakete für Ubuntu befinden sich im "Universe" Repository. Falls dies nicht aktiv ist, kann dies mit folgendem Aufruf aktiviert werden:

</p><pre class="programlisting">add-apt-repository universe</pre><p>

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

          installiert werden:</p><pre class="programlisting">dnf install httpd mod_fcgid postgresql-server postgresql-contrib\

  perl-Algorithm-CheckDigits perl-Archive-Zip perl-CPAN perl-Class-XSAccessor \

  perl-Params-Validate perl-Regexp-IPv6 perl-Rose-DB perl-Rose-DB-Object \

  perl-Rose-Object perl-Sort-Naturally perl-String-ShellQuote \

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

  http://download.opensuse.org/repositories/devel:languages:perl/openSUSE_Leap_15.2/ \

  "devel:languages:perl"

          </pre><pre class="programlisting">zypper addrepo -f \

  texlive-upca

          </pre><p>Zusätzlich müssen einige Pakete aus dem CPAN installiert

          werden. Dazu können Sie die folgenden Befehle anwenden:</p><pre class="programlisting">cpan DateTime::event::Cron DateTime::Set FCGI \

                     <code class="literal">poppler-utils</code> 'pdfinfo' zum Erkennen der Seitenanzahl bei der PDF-Generierung</p></li><li class="listitem"><p>

                     <code class="literal">Postgres Trigram-Index</code> Für datenbankoptimierte Suchanfragen. Bspw. im Paket <code class="literal">postgresql-contrib</code> enthalten</p></li></ul></div><p>Debian und Ubuntu: </p><pre class="programlisting">apt install postgresql-contrib poppler-utils</pre><p>

            </p><p>Fedora: </p><pre class="programlisting">dnf install poppler-utils postgresql-contrib</pre><p>

<html><head>

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

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

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

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

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

          die normale Version erreichbar, und unter

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

        Kivitendo unterstützt, dass Benutzerauthentifizierung über den Webserver mittels des »Basic«-HTTP-Authentifizierungs-Schema erfolgt

        (siehe <a class="ulink" href="https://tools.ietf.org/html/rfc7617" target="_top">RFC 7617</a>). Dazu ist es aber nötig, dass der dabei vom Client

        mitgeschickte Header <code class="constant">Authorization</code> vom Webserver an Kivitendo über die Umgebungsvariable

        <code class="constant">HTTP_AUTHORIZATION</code> weitergegeben wird, was standardmäßig nicht der Fall ist. Für Apache kann dies über die

        folgende Konfigurationsoption aktiviert werden:

        Aufgrund von aktuellen (Mitte 2020) Sicherheitswarnungen für git basierte Webanwendungen ist die mitausgelieferte .htaccess

        restriktiver geworden und verhindert somit das Auslesen von git basierten Daten.

        Für debian/ubuntu muss das Modul mod_rewrite einmalig so aktiviert werden:

          Require all denied

        &lt;/DirectoryMatch&gt;</pre><p>

        von kivitendo nur über https-verschlüsselten Verbindungen, sowie

        weiteren Zusatzmassnahmen, wie beispielsweise Basic Authenticate. Die

        Konfigurationsmöglichkeiten sprengen allerdings den Rahmen dieser

        Anleitung, hier ein Hinweis auf einen entsprechenden <a class="ulink" href="http://redmine.kivitendo-premium.de/boards/1/topics/142" target="_top">Foreneintrag

        (Stand Sept. 2015)</a> und einen aktuellen (Stand Mai 2017) <a class="ulink" href="https://mozilla.github.io/server-side-tls/ssl-config-generator/" target="_top">

  Organisatorisch empfehlen wir hier die enge Zusammenarbeit mit einem kivitendo Partner der auch in der

Lage ist weiterführende Fragen in Bezug auf Datenschutz und Datensicherheit zu beantworten.

Unabhängig davon empfehlen wir im Webserver Bereich die Aktivierung und Konfiguration des Moduls modsecurity für den Apache2, damit

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

        einzubinden. Da das bei neueren Linux-Distributionen aber nicht

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

          openSUSE, ältere Fedora)</h4></div></div></div><p>Kopieren Sie die Datei

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

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

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

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

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

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

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

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

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

          Fedora, neuere Ubuntu und neuere Debians)</h4></div></div></div><p>Kopieren Sie die Datei

          <code class="filename">scripts/boot/systemd/kivitendo-task-server.service</code>

          nach <code class="filename">/etc/systemd/system/</code>. Passen Sie in der

      einfachsten ist dazu eine <code class="literal">texlive</code> Installation. Unter

      debianoiden Betriebssystemen installiert man die Pakete mit:</p><p>

            </p><pre class="programlisting">apt install texlive-base-bin texlive-latex-recommended texlive-fonts-recommended \

         </p><p>Für Fedora benötigen Sie die folgenden Pakete:</p><p>

            </p><pre class="programlisting">dnf install texlive-collection-latex texlive-collection-latexextra \

  texlive-collection-latexrecommended texlive-collection-langgerman \

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

      <code class="literal">users</code>-Verzeichnis, muss vom Webserver beschreibbar

      sein. Dieses wurde bereits erledigt (siehe <a class="xref" href="ch02s03.html" title="2.3. Manuelle Installation des Programmpaketes">Manuelle Installation des Programmpaketes</a>), kann aber erneut

        Aufgaben erfüllen.</p><p>Der Vorlagensatz "rev-odt" enthält solche Vorlagen mit <span class="bold"><strong>Schweizer Bank-Einzahlungsscheinen (BESR)</strong></span>.

        Diese Makros haben die Aufgabe, die in den Einzahlungsscheinen

        benötigte Referenznummer und Kodierzeile zu erzeugen. Hier eine kurze

        Beschreibung, wie die Makros aufgebaut sind, und was bei ihrer Nutzung

        zu beachten ist (<span class="bold"><strong>in fett sind nötige einmalige

          Standardvorlage ohne Einzahlungsschein weitere Vorlagen (z.B. mit

          Einzahlungsschein) auswählbar sind, muss für jedes Vorlagen-Suffix

          ein Drucker eingerichtet werden:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Druckeradministration → Drucker hinzufügen</p></li><li class="listitem"><p>Mandant wählen</p></li><li class="listitem"><p>Druckerbeschreibung → aussagekräftiger Text: wird in der

              Aufträgen oder Rechnungen als odt-Datei keine Bedeutung, darf

              aber nicht leer sein)</p></li><li class="listitem"><p>Vorlagenkürzel → besr bzw. selbst gewähltes Vorlagensuffix

              (muss genau der Zeichenfolge entsprechen, die zwischen

          im Rechnungs- bzw. Auftragsformular angezeigt haben möchte, kann

          dies persönlich für sich bei den Benutzereinstellungen

          konfigurieren:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Programm → Benutzereinstellungen → Druckoptionen</p></li><li class="listitem"><p>Standardvorlagenformat → OpenDocument/OASIS</p></li><li class="listitem"><p>Standardausgabekanal → Bildschirm</p></li><li class="listitem"><p>Standarddrucker → gewünschte Druckerbeschreibung auswählen

          aus dem von kivitendo erzeugten odt-Dokument die korrekte

          Referenznummer inklusive Prüfziffer sowie die Kodierzeile in

          OCRB-Schrift erzeugen und am richtigen Ort ins Dokument

              angepasst werden.</strong></span> Dabei ist darauf zu achten, dass

              sich die Positionen der Postkonto-Nummern der Bank, sowie der

              Zeichenfolgen dddfr, DDDREF1, DDDREF2, 609, DDDKODIERZEILE nicht

          odt-Rechnung (analog bei Auftrag)</h4></div></div></div><p>Im Fussbereich der Rechnungsmaske muss neben Rechnung,

          OpenDocument/OASIS und Bildschirm die im Adminbereich erstellte

          Druckerbeschreibung ausgewählt werden, falls diese nicht bereits bei

          den Benutzereinstellungen als persönlicher Standard gewählt

          die Meldung kommt, dass Makros aus Sicherheitsgründen nicht

          ausgeführt werden, so müssen folgende Einstellungen in LibreOffice

          angepasst werden:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Extras → Optionen → Sicherheit → Makrosicherheit</p></li><li class="listitem"><p>Sicherheitslevel auf "Mittel" einstellen (Diese

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

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

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

          Rechnung. Allerdings heißen die Variablen, die mit

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

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

<html><head>

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

        Gliederung, um zum Beispiel den Einkauf vom Verkauf zu trennen,

        gekennzeichnet durch eine Beschreibung (z.B. "Einkauf") und ein Kürzel

        (z.B. "E"). Für jede Klassifizierung besteht eine Beschreibung und

        eine Abkürzung die normalerweise aus einem Zeichen besteht, kann aber

        auf mehrere Zeichen erweitert werden, falls zur Unterscheidung

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

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

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

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

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

        pro separat auszuweisenden Klassifizierungen die Variable<span class="bold"><strong>&lt; %separate_X_subtotal%&gt;</strong></span>, wobei X das

        Kürzel der Klassifizierung ist.</p><p>Im obigen Beispiel wäre das für Lieferkosten <span class="bold"><strong>&lt;%separate_L_subtotal%&gt;</strong></span> und für

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

        Buchstaben dargestellt. Der erste Buchstabe ist eine Lokalisierung des

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

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

<html><head>

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

        das Dateien verschiedenen Typs verwaltet. Dies können</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>aus ERP-Daten per LaTeX Template erzeugte

            PDF-Dokumente,</p></li><li class="listitem"><p>zu bestimmten ERP-Daten gehörende Anhangdateien

            unterschiedlichen Formats,</p></li><li class="listitem"><p>per Scanner eingelesene PDF-Dateien,</p></li><li class="listitem"><p>per E-Mail empfangene Dateianhänge unterschiedlichen

        die Dateien und ihre Versionen in der Datenbank verwaltet. Darunter

        können verschiedene Implementierungen (Backends) gleichzeitig

        existieren:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Dateisystem</p></li><li class="listitem"><p>WebDAV</p></li><li class="listitem"><p>Schnittstelle zu externen

        für "attachment" und "image" nur die Quelle "uploaded". Für "document"

        gibt es auf jeden Fall die Quelle "created". Die Quellen "scanner" und

        "email" müssen derzeit in der Datenbank konfiguriert werden (siehe

        dargestellt. Eine Verkaufsrechnung z.B. hat die Reiter "Dokumente" und

        "Dateianhänge".</p><div class="screenshot"><div class="mediaobject"><img src="images/DMS-Anhaenge.png"></div></div><p>Bei den Dateianhängen wird immer nur die aktuelle Version einer

        Datei angezeigt. Wird eine Datei mit gleichem Namen hochgeladen, so

        so sind diese z.B. bei Einkaufsrechnungen sichtbar:</p><div class="screenshot"><div class="mediaobject"><img src="images/DMS-Dokumente-Scanner.png"></div></div><p>Statt des Löschens wird hier die Datei zurück zur Quelle

        verschoben. Somit kann die Datei anschließend an ein anderes

        ERP-Objekt angehängt werden.</p><p>Derzeit sind "Titel" und "Beschreibung" noch nicht genutzt. Sie

            im Abschnitt Dateimanagement ist neben dem "alten" WebDAV das

            Dateimangement generell zu- und abschaltbar, sowie die Zuordnung

            der Dateitypen zu Backends. Die Löschbarkeit von Dateien, sowie

            die maximale Uploadgröße sind Backend-unabhängig</p><div class="screenshot"><div class="mediaobject"><img src="images/DMS-ClientConfig.png"></div></div><p>Die einzelnen Backends sind einzeln einschaltbar.

            Spezifische Backend-Konfigurierungen sind hier noch

            Dokumentenanhänge</strong></span> kann für alle ERP-Dokumente (

            Angebote, Aufträge, Lieferscheine, Rechnungen im Verkauf und

            Einkauf ) allgemeingültige Anhänge hochgeladen werden.</p><div class="screenshot"><div class="mediaobject"><img src="images/DMS-Allgemeine-Dokumentenanhaenge.png"></div></div><p>Diese Anhänge werden beim Generieren von PDF-Dateien an die

<html><head>

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

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

      unterschiedlichen Shops zugeordnet werden. Bestellungen können aus

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

      Shopware. Weitere Connectoren können dazu programmiert und eingerichtet

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

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

          Artikelstammdaten. Hier können jetzt die Artikel mit

          Stelle können auch beliebig viele Bilder dem Shopartikel zugeordnet

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

          ist es möglich einen Artikel auch mehreren Gruppen

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

          unter verschiedenen Kriterien <alles><nur Preis><nur

          Bestand><Preis und Bestand> an die jeweiligen Shops

        Bestellimportsliste. Hier ist sind Möglichkeiten gegeben Neue

        Bestellungen vom Shop abzuholen, geholte Bestellungen im Stapel oder

        einzeln als Auftrag zu transferieren. Die Liste kann nach

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

            Rechnungsadresse überschreiben" zeigen sich erst, wenn ein Kunde

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

        der Datei SL/ShopConnector/<SHOPCONNECTORNAME>.pm

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

        die Bestellkopfdaten und die Artikeldaten gemapt werden. In dieser

            </p></div><div class="sect2" title="3.10.3. Erstellen von ZUGFeRD Rechnungen in Kivitendo"><div class="titlepage"><div><div><h3 class="title"><a name="features.zugferd.create_zugferd_bills"></a>3.10.3. Erstellen von ZUGFeRD Rechnungen in Kivitendo</h3></div></div></div><p>Für die Erstellung von ZUGFeRD Rechnungen bedarf es in

			kivitendo zwei Dinge:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Die Erstellung muss in der Mandantenkonfiguration

					aktiviert sein</p></li><li class="listitem"><p>Beim mindestens einem Bankkonto muss die Option

				erfolgt unter „System“ → „Mandatenkonfiguration“ → „Features“.

				Im Abschnitt „Einkauf und Verkauf“ finden Sie die Einstellung

				„Verkaufsrechnungen mit ZUGFeRD-Daten erzeugen“.

				Hier besteht die Auswahl zwischen:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>ZUGFeRD-Rechnungen erzeugen</p></li><li class="listitem"><p>ZUGFeRD-Rechnungen im Testmodus erzeugen</p></li><li class="listitem"><p>Keine ZUGFeRD Rechnungen erzeugen</p></li></ul></div><p>Rechnungen die als PDF erzeugt werden, werden je nach

				Bankkonto die Option „Nutzung mit ZUGFeRD“ auf „Ja“ gestellt

				werden.</p></div></div><div class="sect2" title="3.10.4. Einlesen von ZUGFeRD Rechnungen in Kivitendo"><div class="titlepage"><div><div><h3 class="title"><a name="features.zugferd.read_zugferd_bills"></a>3.10.4. Einlesen von ZUGFeRD Rechnungen in Kivitendo</h3></div></div></div><p>Es lassen sich auch Rechnungen von Kreditoren, die im

			ZUGFeRD Format erstellt wurden, nach Kivitendo importieren.

			Hierfür müssen auch zwei Voraussetzungen erfüllt werden:

			</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Beim Lieferanten muss die Umsatzsteuer-ID und das

					Bankkonto hinterlegt sein</p></li><li class="listitem"><p>Für den Kreditoren muss eine Buchungsvorlage existieren.</p></li></ol></div><p>Wenn diese Voraussetzungen erfüllt sind, kann die Rechnung

			Schaltfläche ausgewählt werden und über die Schaltfläche „Import“

			eingeladen werden. Es öffnet sich daraufhin die Kreditorenbuchung.

			Die auslesbaren Daten aus dem eingebetteten XML der PDF Datei

<html><head>

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

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

        globs global und die meisten speziellen Variablen sind...

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

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

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

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

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

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

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

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

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

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

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

        vorgegebenen Eigenschaften, und alles andere sollte anderweitig

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

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

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

        Folgenden eine kurze Erläuterung der bestimmten vorgegebenen

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

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

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

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

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

  # ...

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

              extern serialisiert werden, weil da auch der Datenbankzugriff

              für diesen user drinsteht.</p></li><li class="listitem"><p>Enthält unter anderem Datumsformat dateformat und

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

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

          Informationen über den Benutzer die über die

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

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

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

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

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

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

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

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

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

          Rechte des aktuellen Users abzufragen. Obwohl diese Informationen

          vom aktuellen User abhängen wird das Objekt aus

          Dessen Einstellungen können über

          <code class="literal">$::auth-&gt;client</code> abgefragt werden; Rückgabewert

          ist ein Hash mit den Werten aus der Tabelle

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

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

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

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

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

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

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

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

          ist hier eine Mandantendatenbank. Beispielsweise überprüft

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

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

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

          global gespeichert wird. Wird vermutlich irgendwann in einem anderen

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

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

          at a distance benutzt werden, sondern um lokales memoizing zu

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

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

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

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

              Klassennamespace gehalten wird und über Requestgrenzen

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

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

              ein paar hundert mal pro Request eine Liste der Einheiten

              brauchen, und de als Parameter durch einen Riesenstack von

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

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

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

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

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

              möglichen Rekursioenen darstellt, und da nie welche

              auftreten.</p></li><li class="listitem"><p>komplette recursion protection wurde entfernt.</p></li></ul></div></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s10.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.10. ZUGFeRD Rechnungen&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;4.2. Entwicklung unter FastCGI</td></tr></table></div></body></html>

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

   <title>kivitendo 3.5.6.1: Installation, Konfiguration, Entwicklung</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.6.1: Installation, Konfiguration, Entwicklung"><link rel="next" href="ch01.html" title="Kapitel 1. Aktuelle Hinweise"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">kivitendo 3.5.6.1: Installation, Konfiguration,

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

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

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

        Datenbankupgradescripten</a></span></dt><dt><span class="sect2"><a href="ch04s04.html#db-upgrade-files.dbupgrade-tool">4.4.4. Hilfsscript dbupgrade2_tool.pl</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch04s05.html">4.5. Translations and languages</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch04s05.html#translations-languages.introduction">4.5.1. Introduction</a></span></dt><dt><span class="sect2"><a href="ch04s05.html#translations-languages.character-set">4.5.2. Character set</a></span></dt><dt><span class="sect2"><a href="ch04s05.html#translations-languages.file-structure">4.5.3. File structure</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch04s06.html">4.6. Die kivitendo-Test-Suite</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch04s06.html#devel.testsuite.intro">4.6.1. Einführung</a></span></dt><dt><span class="sect2"><a href="ch04s06.html#devel.testsuite.prerequisites">4.6.2. Voraussetzungen</a></span></dt><dt><span class="sect2"><a href="ch04s06.html#devel.testsuite.execution">4.6.3. Existierende Tests ausführen</a></span></dt><dt><span class="sect2"><a href="ch04s06.html#devel.testsuite.meaning_of_scripts">4.6.4. Bedeutung der verschiedenen Test-Scripte</a></span></dt><dt><span class="sect2"><a href="ch04s06.html#devel.testsuite.create_new">4.6.5. Neue Test-Scripte erstellen</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch04s07.html">4.7. Stil-Richtlinien</a></span></dt><dt><span class="sect1"><a href="ch04s08.html">4.8. Dokumentation erstellen</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch04s08.html#devel.build-doc.introduction">4.8.1. Einführung</a></span></dt><dt><span class="sect2"><a href="ch04s08.html#devel.build-doc.required-software">4.8.2. Benötigte Software</a></span></dt><dt><span class="sect2"><a href="ch04s08.html#devel.build-doc.build">4.8.3. PDFs und HTML-Seiten erstellen</a></span></dt><dt><span class="sect2"><a href="ch04s08.html#devel.build-doc.repository">4.8.4. Einchecken in das Git-Repository</a></span></dt></dl></dd></dl></dd></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left">&nbsp;</td><td width="20%" align="center">&nbsp;</td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch01.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">&nbsp;</td><td width="20%" align="center">&nbsp;</td><td width="40%" align="right" valign="top">&nbsp;Kapitel 1. Aktuelle Hinweise</td></tr></table></div></body></html>

  'Cannot allocate parts.'      => 'Es sind nicht genügend Artikel vorhanden',

  'Cannot change transaction in a closed period!' => 'In einem bereits abgeschlossenen Zeitraum kann keine Buchung verändert werden!',

  'Cannot check correct WebDAV folder' => 'Kann nicht den richtigen WebDAV Pfad überprüfen',

  'Cannot delete account!'      => 'Konto kann nicht gelöscht werden!',

  'Cannot delete customer!'     => 'Kunde kann nicht gelöscht werden!',

  'Cannot delete default account!' => 'Das Standard-Konto kann nicht gelöscht werden!',

  'Detail view'                 => 'Detailanzeige',

  'Details'                     => 'Details',

  'Details (one letter abbreviation)' => 'D',

  'Dial command missing in kivitendo configuration\'s [cti] section' => 'Wählbefehl fehlt im Abschnitt [cti] der kivitendo-Konfiguration',

  'Difference'                  => 'Differenz',

  'Dimensions'                  => 'Abmessungen',

  'Info'                        => 'Info',

  'Information'                 => 'Information',

  'Initial version.'            => 'Initiale Version.',

  'Insert'                      => 'Einfügen',

  'Insert Date'                 => 'Erfassungsdatum',

  'Insert new'                  => 'Hinzufügen',

  'Cannot allocate parts.'      => '',

  'Cannot change transaction in a closed period!' => '',

  'Cannot check correct WebDAV folder' => '',

  'Cannot delete account!'      => '',

  'Cannot delete customer!'     => '',

  'Cannot delete default account!' => '',

  'Detail view'                 => '',

  'Details'                     => '',

  'Details (one letter abbreviation)' => '',

  'Dial command missing in kivitendo configuration\'s [cti] section' => '',

  'Difference'                  => '',

  'Dimensions'                  => '',

  'Info'                        => '',

  'Information'                 => '',

  'Initial version.'            => '',

  'Insert'                      => '',

  'Insert Date'                 => '',

  'Insert new'                  => '',