projekt kivitendo

                  <code class="literal">Daten:</code>In diesem Feld können optionale Parameter für den Hintergrund im YAML-Format gesetzt werden.</p></li></ul></div><div class="sect2" title="2.9.1. SetNumberRange"><div class="titlepage"><div><div><h3 class="title"><a name="Hintergrund-Job SetNumberRange"></a>2.9.1. SetNumberRange</h3></div></div></div><p>Der Hintergrund-Job <code class="literal">SetNumberRange</code> kann entweder jährlich oder monatlich/täglich den Nummernkreis verändern. Der Standardmodus 'jährlich' kodiert die nächste Jahreszahl in alle Nummernkreise und initialisiert diese von Beginn, bpsw. 202500001. Zusätzlich bleiben Präfixe in den Nummernkreis erhalten und es gibt drei konfigurierbare Parameter in diesem Modus:</p><p>Der jährliche Modus (default) akzeptiert im Feld <code class="literal">Daten</code> drei optionale Parameter, nämlich <code class="literal">digit_year</code>, <code class="literal">multiplier</code> so wie <code class="literal">current_year</code>.</p><p> 

</pre><p>Falls der Parameter <code class="literal">current_year</code> bspw. so gesetzt ist:

</p><pre class="programlisting">current_year: 1</pre><p>

 wird der Nummernkreis nicht um eins hochgezählt. Das ist sinnvoll wenn vom 31.12. auf den 01.01. sowieso keine Rechnungsläufe stattfinden und man die Nummernkreise dann am 01.01. des neuen Jahres automatisch hochsetzen möchte. </p><p>Wir gehen jetzt beispielhaft von einer letzten Rechnungsnummer von RE2019456 aus. Demnach sollte ab Januar 2020 die erste Nummer RE2020001 sein. Da der Task auch Präfixe berücksichtigt, kann dies mit folgenden JSON-kodierten Werten umgesetzt werden:</p><p>

digits_year: 4</pre><p>Dieser Job müsste dann zwingend vor Mitternacht des 31.12. ausgeführt werden.</p><p>

               <code class="literal">Daten:</code>

            </p><pre class="programlisting">multiplier: 100

digits_year: 4

current_year: 1</pre><p>Mit dieser Einstellung kann der Job auf 00:01h des 01.01. gesetzt werden.</p><p>Der (wahrscheinliche) monatliche Modus wird über den Parameter <code class="literal">monthly</code> gesteuert und erzeugt standardmäßig folgende Nummernkreise JJ-MM-000, bspw. am 01.04.2025 25-04-000. Dieser Modus akzeptiert die zwei optionalen Parameter <code class="literal">monthly_postfix</code> für die Überlagerung am Ende der Zeichenkette und <code class="literal">monthly_strftime</code> für die beliebige Formatierung der strftime C-Methode, s.a. <a class="ulink" href="https://metacpan.org/pod/DateTime#strftime-Patterns" target="_top">strftime-Patterns</a>.

Folgende Parameter erzeugen am 01.04.2025 folgenden Nummernkreis: 2025-04-01-A0001.

</p><p>

                  <code class="literal">Daten:</code>

               </p><p>

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

monthly: 1

monthly_postfix: '-A0001'

monthly_strftime: '%Y-%m-%d'

</pre><p>

            </p></div><div class="sect2" title="2.9.2. ImportRecordEmails"><div class="titlepage"><div><div><h3 class="title"><a name="Hintergrund-Job ImportRecordEmails"></a>2.9.2. ImportRecordEmails</h3></div></div></div><p> Der Hintergrund-Job <code class="literal">ImportRecordEmails</code> kann vollständig über das Feld Daten konfiguriert werden. Er benötigt folgende Variablen:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>