1 Allgemein
2 Notation
- 2.1 Struktur
- 2.2 Konfiguration
- 2.3 Wochentage
- 2.4 DateRange
- 2.5 TupleType
- 2.6 Tags
- 2.7 Regel abhängig von Objekt und Auftragsdaten
  - 2.7.1 Syntax filterTerm
  - 2.7.2 Syntax filterRegEx
    - 2.7.2.1 Beispiel
3 Demo-Beispiel mit Kommentar

Allgemein

Die Zeitscheibe definiert, welche Lohnart in welcher Periode und mit welchen Bedingungen angewendet werden soll.

Die Konfiguration wird in der Systemkonfiguration zusammengestellt.

Hierfür werden alle Bedingungen vom Detail zur Allgemeinheit konfiguriert jeweils für

Arbeit - work (Auftragsbuchung)
Fahrzeiten - drive / codrive (Fahrer und Beifahrer)
aktive - aktive (nicht zugeordnete Tätigkeiten)

Vorgehen:

Sonderzeiten (Urlaub, Krankenstand,…)
Sonn- und Feiertagsarbeit - mit und ohne Bereitschaft
Samstag - mit und ohne Bereitschaft
Wochendienste (Vier- und Fünftagewoche)

Notation

Struktur

Basisdaten:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<timeSliceModel>
  <ruleSet>
    	<fromTime>22:00</fromTime>                     <!-- VON -->  
  		<endTime>06:00</endTime>                       <!-- BIS -->
  		<addOn>true</addOn>                            <!-- OPTIONAL -->
  		<hourlyBased>false</hourlyBased>               <!-- OPTONAL -->
		<dayOfWeek>*</dayOfWeek>                       <!-- TAGE -->
        <dateRange>09.09.-10.09.</dateRange>           <!-- GÜLTIGKEIT ZEITRAUM -->
		<tupleType>work_drive_codrive</tupleType>      <!-- ART -->
        <standbytime>Rufbereitschaft</standbytime>     <!-- OPTIONAL -->
		<maxWorkday>false</maxWorkday>                 <!-- VON -->
		<minWorkday>false</minWorkday>                 <!-- VON -->
        <factor>50.00</factor>                         <!-- OPTIONAL -->
  		<hourlyBased>false</hourlyBased>               <!-- OPTIONAL -->
		<matchingWT>*LOHNART*</matchingWT>             <!-- LOHNART -->
  </ruleSet>
</timeSliceModel>

Konfiguration

Um alle Sonderzeiten pauschal auch ohne Abschluss für die Berechnung heranzuziehen:

<acceptAllUnconfirmedSonderzeit>true</acceptAllUnconfirmedSonderzeit>

Sonst explizite Angabe in der Zeitscheibe:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<timeSliceModel>
    <unconfirmedSonderzeit>Präsenzdienst</unconfirmedSonderzeit>
    <unconfirmedSonderzeit>Schulung</unconfirmedSonderzeit>
    <unconfirmedSonderzeit>Umzug</unconfirmedSonderzeit>
    <unconfirmedSonderzeit>Urlaub</unconfirmedSonderzeit>
    ...
    <ruleSet> ...

Wochentage

Für den <dayOfWeek> -Tag sind folgende Werte zulässig:

Deutsch	Englisch	Beschreibung

Deutsch	Englisch	Beschreibung
`*`	`*`	Regel zieht für jeden Tag
`montag`	`monday`	Nur Montage
`dienstag`	`tuesday`	Nur Dienstage
`mittwoch`	`wednesday`	Nur Mittwoche
`donnerstag`	`thursday`	Nur Donnerstage
`freitag`	`friday`	Nur Freitage
`montag-donnerstag`	`monday-thursday`	Montag bis inkl. Donnerstag
`montag-freitag`	`monday-friday`	Montag bis inkl. Freitag
`montag-samstag`	`monday-saturday`	Montag bis inkl. Samstag
`samstag`	`saturday`	Samstag
`sonntag`	`sunday`	Sonn- und Feiertage
`nur sonntag`	`sunday only`	Nur Sonntage wenn kein Feiertag
`feiertag`	`holiday`	Jeder Feiertag
`hlabendsylvester`	`24th31st`	Regel zieht für den 24.12. sowie 31.12.
`feiertag am samstag`	`holiday on saturday`	Regel zieht für Feiertage an einem Samstag
`feiertag am sonntag`	`holiday on sunday`	Regel zieht für Feiertage an einem Sonntag
`dd.MM.[yyyy]` `dd.MM.[yyyy],dd.MM,[yyyy]...` `dd.MM.-dd.MM`	`dd.MM.[yyyy]` `dd.MM.[yyyy],dd.MM,[yyyy]...` `dd.MM.-dd.MM`	Regel für bestimmte Tage / Zeitraum zb. zwischen 24.12. und 06.01

Die Bezeichner können beliebig deutsch oder englisch verwendet werden; die Groß-Kleinschreibung spielt keine Rolle.

DateRange

Zeitscheiben-Regeln können zusätzlich auf bestimmte Einzeltage oder Zeiträume eingeschränkt werden:

Format	Beispiel	Beschreibung

Format

Beispiel

Beschreibung

dd.MM.[yyyy]

15.08.

15.08.2026

gültig für einen definierten Kalendertag; optional mit Einschränkung auf Kalenderjahr

dd.MM.[yyyy],dd.MM.[yyyy],...

15.08.,15.09.,15.10.

15.08.2026,15.09.2026,15.10.2026

gültige für eine Liste (Komma-getrennt) von Kalendertagen; optional (je Eintrag): Kalenderjahr

dd.MM.[yyyy]-dd.MM.[yyyy]

Zeitraum von-bis

Optional Kalenderjahr

Zu beachten: ungültige Kalendertage (bspw. 30.02.) führen dazu, dass die Regel als nicht zutreffend ignoriert wird - so als ob das Datum/der Datumsbereich nicht zutrifft.

TupleType

Unter dem Begriff TupleType <tupleType> ist die Art der Tätigkeit zu verstehen die mit der Regel adressiert werden soll.

Zur Auswahl stehen:

TupleType	Beschreibung

TupleType	Beschreibung
`arbeit` (`work`)	Arbeit an einem Termin
`aktiv` (`active`)	Arbeitszeit (d.h. zwischen Tagesbeginn-Buchung und Tagesende-Buchung) die nicht auf einem Termin gearbeitet wird (work)
`fahren bzw. beifahren` (`drive / co_drive`)	Fahrzeit, entweder als Fahrer (kleines Lenkrad-Symbol das an einen Fußball erinnert) bzw. Beifahrer
`Arbeiten und (Bei-)Fahren` `(work_drive_codrive`)	Wenn die Fahrt- und Arbeitszeiten gleich geregelt sind, können diese in einer Regel zusammengefasst werden. Aktivzeiten gehören einzeln geregelt!
`sonderzeit` (`specialtime`)	Zeit auf einer Sonderzeit; die Sonderzeit ist in dem Fall in einem Tag anzugeben. Bsp.: `<tupleType>Sonderzeit</tupleType>` `<sonderzeit>Sonderurlaub</sonderzeit>`
`bereitschaft (standbytime)`	Gebuchte Bereitschaften werden von dieser Regel erfasst. Optional kann die Regel auf eine bestimmte Art von Bereitschaft eingeschränkt werden. Bsp.: `<tupleType>Bereitschaft</tupleType>` `<standbytime>Rufbereitschaft</standbytime>`
`pause` (`break`)	Gebuchte Pausen können damit auf Lohnbuchungen umgelegt werden; bspw. um bei Pausen zw. Lohn- und Faktur zu unterscheiden

Regel abhängig von Objekt und Auftragsdaten

Mitunter ist es notwendig unterschiedliche Lohnarten oder Zeit-Regeln für verschiedene Auftrags/Objekt/Kunden zu hinterlegen.

So könnten Großkunden andere Faktur-Lohnarten zugeordnet haben oder abhängig von der erforderlichen Qualifikation bei einem Auftrag andere Regeln angewendet werden.

Dazu ist es möglich bei jeder Regel <ruleSet> ein Filter-Kriterium anzugeben. Bitte beachten: es zieht wie immer die erste Regel; d.h. Regeln mit zusätzlichen Einschränkungen immer über die generellen Regeln legen.

Syntax filterTerm

filterTerm	Beispiel

filterTerm	Beispiel

filterTerm	Beispiel

filterTerm

Beispiel

{Mitarbeiter-Optionparameter}

{Qualifikation}

wie bei allen Attributen in der Zeitscheibe werden auch hier Mitarbeiter-OptionParameter vorab durch die Werte des jw. MA ersetzt

{task.attribute}

{project.attribute}

{customer.attribute}

{project.zip}

auf alle Attribute (PLZ, Bezeichnung, Nummer, …) kann mit dieser einfachen Punkt-Syntax zugegriffen werden.

Ausgenommen ist der Verrechnungskunde/Billing-Customer; dieser wir aktuell nicht unterstützt.

{task.optionparameterParameterName}

...

{project.optionparameterKategorie}

(Achtung: Groß-Kleinschreibung beachten!)

wie bei den internen Attributen (siehe oben) ist es auch möglich auf OptionParameter der jw. Entitäten (Aufgabe/Objekt/Kunde) zuzugreifen.

Syntax filterRegEx

Der filterRegEx Parameter erlaubt ein Regular-Expression-Muster. Am besten auf https://regex101.com/ austesten.

Im filterTerm kann auf Attribute und OptionParameter von task, project und customer Zugegriffen werden. Für OptionParameter des Mitarbeiters ist die einfache Syntax {OptionParameter-Name} wie auch sonst überall in der Zeitscheibe gültig.