Book Workinghours

Interface Client

• API: book-workinghours
• Variant: standard

Der Prozess book-workinghours dient dazu, alle genehmigten (approved) Arbeitszeiten für bereits abgeschlossene Perioden im System zu verbuchen.

Ablauf im Überblick

Der Prozess führt folgende Schritte auf der Datenbank aus (Prozedur proc_book_workinghours):

1. Filterung der Perioden: Es werden alle Perioden identifiziert, deren Enddatum (ped_end) in der Vergangenheit oder am heutigen Tag liegt.
2. Identifizierung der Arbeitszeiten: Innerhalb dieser Perioden werden alle Einträge im Arbeitszeit-Workflow (t_worktime_workflow_status) gesucht, die:
   • Bereits genehmigt wurden (wws_approved_timestamp ist gesetzt).
   • Noch nicht verbucht wurden (wws_booking_timestamp ist NULL).
   • Ab dem Jahr 2023 genehmigt wurden (Sicherheitsfilter - Ältere, unverbuchte Einträge wurden nicht verbucht).
3. Verbuchung: Für alle gefundenen Datensätze wird der Zeitstempel der Verbuchung (wws_booking_timestamp) auf die aktuelle Systemzeit gesetzt.

Dieser Schritt ist Voraussetzung dafür, dass die Arbeitszeiten in nachgelagerten Exporten (z. B. für die Lohnabrechnung) als “verbucht” betrachtet werden können.

Konfiguration

Der Prozess wird über den Interface Client (Porter) gestartet. Die Konfiguration erfolgt in einer YAML-Datei.

Beispiel Konfiguration (bookWorkinghours.yaml)

tenant: "ihr_tenant"
url: "https://api.chronapp.com"
description: "Book confirmed working hours"
sso:
  url: "https://sso.chronapp.com/realms/"
  client: "chronapp-porter"
  secret: "ihr_secret"
jdbcurl: "jdbc:sqlserver://ihr_server;database=ihr_db;..."
exp:
  - api: "book-workinghours"
    variant: "standard"