Revision 66d42d8d
| doc/dokumentation.xml | ||
|---|---|---|
| 1686 | 1686 |
</itemizedlist> |
| 1687 | 1687 |
<sect2 id="Hintergrund-Job SetNumberRange"> |
| 1688 | 1688 |
<title>SetNumberRange</title> |
| 1689 |
<para> Der Hintergrund-Job <literal>SetNumberRange</literal> akzeptiert im Feld <literal>Daten</literal> zwei Variablen nämlich <literal>digit_year</literal> sowieso <literal>multiplier</literal>.</para><para> <literal>digit_year</literal> kann zwei Werte haben entweder 2 oder 4, darüber wird gesteuert ob die Jahreszahl zwei oder vierstellig kodiert wird (für 2019, dann entweder 19 oder 2019). Der Standardwert ist vierstellig.</para><para> <literal>multiplier</literal> ist ein Vielfaches von 10, darüber wird die erste Nummer im Nummernkreis (die Anzahl der Stellen) wie folgt bestimmt:</para> |
|
| 1689 |
<para>Der Hintergrund-Job <literal>SetNumberRange</literal> 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.</para> |
|
| 1690 |
<para> Dieser Hintergrund-Job akzeptiert im Feld <literal>Daten</literal> drei optionale Parameter, nämlich <literal>digit_year</literal>, <literal>multiplier</literal> so wie <literal>current_year</literal>.</para><para> <literal>digit_year</literal> kann zwei Werte haben entweder 2 oder 4, darüber wird gesteuert ob die Jahreszahl zwei oder vierstellig kodiert wird (für 2019, dann entweder 19 oder 2019). Der Standardwert ist vierstellig.</para><para> <literal>multiplier</literal> ist ein Vielfaches von 10, darüber wird die erste Nummer im Nummernkreis (die Anzahl der Stellen) wie folgt bestimmt:</para> |
|
| 1690 | 1691 |
<programlisting> |
| 1691 | 1692 |
multiplier Nummernkreis 2020 |
| 1692 | 1693 |
10 -> 20200 |
| 1693 | 1694 |
100 -> 202000 |
| 1694 | 1695 |
1000 -> 2020000 |
| 1695 | 1696 |
</programlisting> |
| 1697 |
<para>Falls der Parameter <literal>current_year</literal> bspw. so gesetzt ist: |
|
| 1698 |
<programlisting>current_year: 1</programlisting> |
|
| 1699 |
, 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. </para> |
|
| 1700 |
|
|
| 1696 | 1701 |
<para>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:</para> |
| 1697 | 1702 |
<para><literal>Daten:</literal></para><programlisting>multiplier: 100 |
| 1698 | 1703 |
digits_year: 4</programlisting> |
| 1699 |
<note> |
|
| 1700 |
<para>Der Hintergrundjob nimmt das aktuelle Jahr +1. Daher sollte der Hintergrundjob am 31.12. vor Mitternacht ausgeführt werden, damit im neuen Jahr die Nummernkreise korrekt sind.</para> |
|
| 1701 |
</note> |
|
| 1704 |
<para>Dieser Job müsste dann zwingend vor Mitternacht des 31.12. ausgeführt werden.</para> |
|
| 1705 |
<para><literal>Daten:</literal></para><programlisting>multiplier: 100 |
|
| 1706 |
digits_year: 4 |
|
| 1707 |
current_year: 1</programlisting> |
|
| 1708 |
<para>Mit dieser Einstellung kann der Job auf 00:01h des 01.01. gesetzt werden.</para> |
|
| 1709 |
|
|
| 1702 | 1710 |
|
| 1703 | 1711 |
</sect2> |
| 1704 | 1712 |
<sect2 id="Hintergrund-Job ImportRecordEmails"> |
Auch abrufbar als: Unified diff
Hauptdoku ergänzt