Zum Hauptinhalt wechseln
Administrator Guide
Zuletzt aktualisiert: 2025-03-14
Konzept: Stempeluhrereignisse importieren

Konzept: Stempeluhrereignisse importieren

Sie können Daten aus einem Zeiterfassungssystem eines Drittanbieters über die Webservices
Put Time Clock Events
oder
Import Time Clock Events
in Workday Time Tracking importieren. Diese Webservices importieren unformatierte Uhrzeitdaten als Stempeluhrereignisse, die Workday abgleicht, um Zeitblöcke und Berechnungen zu erstellen. Mitarbeiter können die Zeitblöcke bearbeiten, bevor sie sie übermitteln.

Große Batches mit Stempeluhrereignissen importieren

Wenn Sie mehr als 1.000 Stempeluhrtransaktionen mit
Put Time Clock Events
importieren, kann die Integration sehr viel Zeit in Anspruch nehmen und andere Workday-Prozesse blockieren. Verwenden Sie in diesem Fall den Webservice
Import Time Clock Events
.
Verwenden Sie den Webservice
Import Time Clock Events
, wenn Sie ab und zu große Mengen von 1.000 oder mehr Stempeluhrereignissen importieren müssen. Beispiel: Sie importieren Stempeluhrereignisse für Implementierungstests oder das Laden eines einzelnen großen Batches, nachdem die Integration mit einem Drittanbietersystem fehlgeschlagen ist.
Import Time Clock Events
wird als Hintergrundprozess ausgeführt, sodass andere Workday-Aufgaben, die gleichzeitig ausgeführt werden, nicht blockiert werden.
Mit dem Webservice-Muster zum Importieren können Sie den Workday Enterprise Interface Builder (EIB) verwenden. Um Verarbeitungsfehler nach der Verwendung von
Import Time Clock Events
abzurufen, können Sie Folgendes verwenden:
  • Webservice
    Get Import Process Messages
    .
  • Bericht
    Nicht verarbeitete Stempeluhrereignisse
    .

Kleine Batches mit Stempeluhrereignissen importieren

Verwenden Sie den öffentlichen Webservicevorgang
Put Time Clock Events
, wenn Sie Stempeluhrereignisse aus einem Drittanbietersystem nahezu in Echtzeit importieren müssen. Das Drittanbietersystem sollte Stempeluhrereignisse in Batches einreihen und einen Aufruf von
Put Time Clock Events
initiieren. Wenn Workday keinen Batch empfangen kann, muss das Drittanbietersystem weiterhin Stempeluhrereignisse in die Warteschlange stellen, bis Workday verfügbar ist.
Bei Verwendung des Webservices
Put Time Clock Events
empfehlen wir Folgendes:
  • Senden Sie Stempeluhrereignisse in ihrer unformatierten Form (nicht mit Zeitblöcken abgeglichen oder auf andere Weise verarbeitet).
  • Senden Sie Batches alle 2-5 Minuten.
  • Senden Sie Stempeluhrereignisse in der Reihenfolge, in der sie aufgetreten sind, damit Workday sie so genau wie möglich in Zeitblöcke einordnet.
  • Senden Sie keinen Batch mit mehr als 150 Stempeluhrtransaktionen. Wenn Sie mehr als 150 Stempeluhrtransaktionen senden möchten, teilen Sie sie in kleinere Batches auf.

Erforderliche Felder

Die in Workday importierten Stempeluhrereignisse müssen folgende Details enthalten:
Feld
Anmerkungen
Datum/Zeit des Stempeluhrereignisses
Datum und Uhrzeit des Stempeluhrereignisses. Wenn Sie keinen Zeitversatz bei Zeitzonen angeben, geht Workday von einem UTC-Zeitversatz von 0 aus.
Clock Event Type Reference
Workday unterstützt 4 Arten von Stempeluhrereignissen:
Anmelden
,
Abmelden
,
Pause
und
Essen
.
Personalnummer
Stellen-ID
Erforderlich, wenn der Mitarbeiter mehrere Tätigkeiten ausübt und der Typ des Stempeluhrereignisses
Anmelden
ist.
Time Clock Event ID
Erforderlich für Bearbeitungs- und Löschtransaktionen, damit Workday erkennen kann, welches Stempeluhrereignis bearbeitet oder gelöscht werden soll.
Stempeluhrereignis löschen
Wenn markiert, wird die Transaktion als Löschung identifiziert.
Wenn Sie eine Löschung importieren, sind nur folgende Felder erforderlich:
  • Time Clock Event ID
  • Stempeluhrereignis löschen
Alle anderen Felder sind optional.

Fehler und Validierungen

Daten, die vom Webservicevorgang akzeptiert werden, sind in der Zeiterfassung möglicherweise immer noch ungültig. Workday führt einen separaten Satz von Validierungen für die Daten durch, nachdem diese den Webservicevorgang durchlaufen haben, und kennzeichnet ungültige Stempeluhrtransaktionen. Workday gleicht ungültige Stempeluhrtransaktionen nicht mit Zeitblöcken ab, sondern kennzeichnet sie als Fehler, bis Sie die Transaktion korrigieren. Verwenden Sie die Aufgabe
Ungültige Stempeluhrereignisse verwalten
, um fehlerhafte Transaktionen anzuzeigen, zu korrigieren oder zu ignorieren.
Ungültige oder fehlende Werte in den folgenden Feldern führen dazu, dass das Stempeluhrereignis bis zur Korrektur als fehlerhaft angezeigt wird:
  • Personalnummer
  • Stellen-ID
  • Datum/Zeit des Stempeluhrereignisses
  • Clock Event Type Reference
Die folgenden Felder sind optional. Wenn sie jedoch gesendet werden, müssen die Werte in Workday gültig sein. Ungültige Werte führen dazu, dass die Stempeluhrtransaktion fehlerhaft ist, bis sie korrigiert wird. Diese Felder gelten nur für die Stempeluhrereignisart
Anmelden
. Wenn der Zeiteingabecode leer ist, wendet Workday den Standardzeitcode aus der Zeiteingabevorlage des Mitarbeiters an.
  • Zeiteingabecode
  • Projekt-ID
  • Aufgaben-ID
  • Überschreibungssatz
  • Geschäftseinheit
  • Kostenstelle
  • Benutzerdefinierte Organisation 01 - Benutzerdefinierte Organisation 10
  • Benutzerdefiniertes Worktag 01
    -
    Benutzerdefiniertes Worktag 15
  • Geldmittel
  • Fördermittel
  • Tätigkeitsprofil
  • Standort
  • Programm
  • Region

Stempeluhrereignisdaten bearbeiten und löschen

Sie können Stempeluhrereignisse mit dem Webservice
Put Time Clock Events
bearbeiten oder löschen. Wenn Sie eine Bearbeitungstransaktion über den Webservice importieren, geben Sie die ID des Stempeluhrereignisses in der Datei an. Wenn Sie Bearbeitungstransaktionen importieren, ersetzt Workday die vorhandenen Details zum Stempeluhrereignis durch die Details der neuen Transaktion. Fügen Sie alle Details ein, die Sie zusätzlich zu den bearbeiteten Feldern beibehalten möchten. Wenn Sie eine Löschtransaktion importieren, setzen Sie das Feld
Delete Time Clock Event
auf
Y
(für Ja).
Sie können nicht nur Bearbeitungen und Löschungen importieren, sondern auch Stempeluhrereignisse direkt in Workday verwalten.
Bericht oder Aufgabe
Überlegungen
Aufgabe
Ungültige Stempeluhrereignisse für Mitarbeiter verwalten
.
Manager und Administratoren können ungültige Stempeluhrereignisse für die direkt unterstellten Mitarbeiter des Managers bearbeiten oder ignorieren.
Bericht
Stempeluhrhistorie
.
Sie können jede Art von Stempeluhrereignis bearbeiten und löschen.