Passer au contenu principal
Administrator Guide
Dernière mise à jour : 2025-03-14
Concept : importer des événements de pointage

Concept : importer des événements de pointage

Vous pouvez importer des données d’un système d’enregistrement des heures de tierce partie dans Workday Time Tracking à l’aide des services Web
Put Time Clock Events
ou
Import Time Clock Events
. Ces services Web importent des données de pointage brutes sous forme d’événements de pointage que Workday met en correspondance pour créer des blocs d’heures et exécuter des calculs. Les travailleurs peuvent modifier les blocs d’heures avant de les soumettre.

Importer des lots volumineux d’événements de pointage

Si vous utilisez le service Web
Put Time Clock Events
pour importer plus de 1 000 transactions de pointage, l’intégration peut prendre un certain temps et bloquer d’autres processus Workday. Dans ce cas, utilisez le service Web
Import Time Clock Events
.
Utilisez le service Web
Import Time Clock Events
lorsque vous devez importer des lots de 1 000 ou plus événements de pointage de manière occasionnelle. Exemple : importation d’événements de pointage pour les tests de mise en œuvre ou chargement d’un seul lot volumineux après l’échec d’une intégration avec un système tiers. Le service Web
Import Time Clock Events
s’exécute en tant que traitement en arrière-plan, de sorte qu’il ne retarde pas l’exécution simultanée des autres tâches Workday.
La structure du service Web d’importation vous permet d’utiliser le Créateur d’interfaces Entreprise de Workday. Pour récupérer les erreurs de traitement après avoir utilisé l’option
Import Time Clock Events
, vous pouvez utiliser :
  • Le service Web
    Get Import Process Messages
    .
  • Le rapport
    Événements de pointage non traités
    .

Importer des petits lots d’événements de pointage

Utilisez l’opération du service Web public
Put Time Clock Events
lorsque vous devez importer des événements de pointage d’un système tiers en temps quasi réel. Le système tiers doit mettre en file d’attente les événements de pointage par lots et lancer un appel au service Web
Put Time Put Time Clock Events
. Si Workday ne peut pas recevoir de lot, le système tiers doit continuer à mettre les événements de pointage en file d’attente jusqu’à ce que Workday soit disponible.
Lorsque vous utilisez le service Web
Put Time Clock Events
, nous vous recommandons de faire ce qui suit :
  • Envoyer les événements de pointage dans leur forme brute et non déjà mis en correspondance avec des blocs d’heures ou traités d’une quelconque façon.
  • Envoyer les lots toutes les 2 à 5 minutes.
  • Envoyer les événements de pointage dans l’ordre d’occurrence pour maximiser l’exactitude de la mise en correspondance avec les blocs d’heures par Workday.
  • Ne pas envoyer de lot contenant plus de 150 transactions de pointage. Si vous avez plus de 150 transactions de pointage à envoyer, divisez-les en lots plus petits.

Champs obligatoires

Les événements de pointage importés dans Workday doivent inclure les détails suivants :
Champ
Remarques
Date et heure de l’événement de pointage
La date et l’heure de l’événement de pointage. Si vous ne précisez pas de décalage de fuseau horaire, Workday suppose un décalage UTC de zéro.
Clock Event Type Reference
Workday accepte quatre types d’événements de pointage :
Entrée
,
Sortie
,
Pause
et
Repas
.
Numéro d’employé
Code de poste
Obligatoire si le travailleur a des emplois multiples et que le type d’événement de pointage est
Entrée
.
Time Clock Event ID
Obligatoire pour les transactions de modification et de suppression afin que Workday puisse repérer l’événement de pointage à modifier ou à supprimer.
Supprimer l'événement de pointage
Lorsque l’élément est signalé, le système désigne la transaction comme une suppression.
Si vous importez une suppression, les seuls champs obligatoires sont :
  • Time Clock Event ID
  • Supprimer l'événement de pointage
Tous les autres champs sont facultatifs.

Erreurs et validations

Les données acceptées par l’opération du service Web peuvent néanmoins ne pas être valides dans Time Tracking. Workday exécute un ensemble distinct de validations sur les données une fois qu’elles sont traitées dans le service Web et qu’elles indiquent des transactions de pointage non valides. Workday ne fait pas correspondre les transactions de pointage non valides aux blocs d’heures, mais les considère plutôt comme des erreurs jusqu’à ce que vous corrigiez ces transactions. Utilisez la tâche
Mettre à jour les événements de pointage non valides
pour afficher, corriger ou omettre les transactions erronées.
Des valeurs non valides ou manquantes dans ces champs indiquent un événement de pointage erroné jusqu’à ce qu’il soit corrigé :
  • Numéro d’employé
  • Code de poste
  • Date et heure de l’événement de pointage
  • Clock Event Type Reference
Les champs ci-dessous sont facultatifs, mais s’ils sont envoyés, ils doivent représenter des valeurs valides dans Workday. Des valeurs non valides indiquent un événement de pointage erroné jusqu’à ce qu’il soit corrigé. Ces champs s’appliquent uniquement aux types d’événements de pointage
Entrée
. Si le code d’entrée des heures est vide, Workday applique le code d’entrée des heures par défaut du modèle d’entrée des heures du travailleur.
  • Code d’entrée des heures
  • Identifiant du projet
  • Identifiant de la tâche
  • Calcul du taux de remplacement
  • Unité d’exploitation
  • Centre de coûts
  • Organisation personnalisée 01 - Organisation personnalisée 10
  • Worktag personnalisé 01
    -
    Worktag personnalisé 15
  • Fonds
  • Subvention
  • Profil d’emploi
  • Emplacement
  • Programme
  • Région

Modification et suppression des données des événements de pointage

Vous pouvez modifier ou supprimer des événements de pointage à l’aide du service Web
Put Time Clock Events
. Lorsque vous importez une transaction de modification à l’aide du service Web, incluez l’identifiant de l’événement de pointage dans le fichier. Lorsque vous importez des transactions de modification, Workday remplace les détails existants de l’événement de pointage par les détails de la nouvelle transaction. Incluez tous les détails que vous voulez conserver en plus des champs modifiés. Lors de l’importation d’une transaction de suppression, définissez le champ
Supprimer l’événement de pointage
à
Y
(pour Oui).
En plus d’importer les modifications et les suppressions, vous pouvez gérer les événements de pointage directement dans Workday.
Rapport ou tâche
Éléments à prendre en compte
Tâche Mettre à jour des événements de pointage non valides pour des travailleurs
.
Les gestionnaires et les administrateurs peuvent modifier ou ignorer les événements de pointage non valides des subordonnés directs du gestionnaire.
Rapport
Historique de pointage
.
Vous pouvez modifier et supprimer tout type d’événement de pointage.