Synchronisation d'intégration
Récupère employés, contrats et unités d’organisation depuis chaque intégration activée (Entra ID, SHR, Visma OM, Intega HR, …).
Fonctionnement
La synchronisation est une tâche unique qui gère chaque intégration synchronisable :
- Charge les intégrations activées — seules les intégrations activées pour l’espace de travail sont traitées ; les autres sont ignorées silencieusement
- Récupère les données — appelle le fournisseur d’intégration avec l’horodatage de la dernière synchronisation réussie pour que les fournisseurs supportant le delta ne renvoient que ce qui a changé
- Réconcilie — crée les nouvelles entités, met à jour celles qui ont changé, et signale ce qui a été ignoré (par ex. lignes source mal formées)
- Met à jour le statut de synchronisation — enregistre l’horodatage de début de cette exécution comme
last_sync_aten cas de succès, ou le message d’erreur en cas d’échec. Stocker l’heure de début (pas la fin) garantit que les changements survenus pendant la récupération seront pris au prochain run
Quand elle s’exécute
La tâche s’exécute automatiquement et ne se déclenche que lorsqu’au moins une intégration synchronisable est activée pour l’espace de travail.
Paramètres
| Paramètre | Description |
|---|---|
| Intégration | Optionnel. L’identifiant d’une intégration spécifique (par ex. entraid, shr, vom, integahr). Laisser vide pour synchroniser toutes les intégrations activées |
| Mode test | Lorsque activé, récupère les données et présente les compteurs sans rien écrire en base. Utile pour vérifier les identifiants ou voir ce qu’une intégration ferait |
Résultats de la tâche
Lors de la synchronisation d’une seule intégration, les résultats sont plats :
| Métrique | Description |
|---|---|
employees (avec created, updated, skipped) | Compteurs par bucket pour les employés |
employments (avec created, updated, skipped) | Compteurs par bucket pour les contrats |
org_units (avec created, updated) | Compteurs par bucket pour les unités |
errors | Erreurs signalées par le fournisseur pendant la récupération ou la réconciliation |
Lors de la synchronisation de toutes les intégrations, les résultats sont imbriqués sous chaque identifiant d’intégration.
Les résultats en mode test exposent le nombre d’éléments récupérés (employees, employments, org_units) et un drapeau dry_run: true.
Lorsqu’une exécution est ignorée parce que l’intégration est désactivée ou non configurée, vous verrez skipped: true avec une reason.
Statut de la tâche
Une exécution avec des lignes ignorées ou des erreurs par élément se termine en statut avertissement plutôt que terminé. Les données qui ont été synchronisées sont validées ; les avertissements attirent l’attention sur le reste.
Connexe
- Aperçu des intégrations — paramétrer et configurer chaque intégration
- Statut d’intégration — voir le dernier horodatage de synchronisation et l’erreur pour chaque intégration
Dépannage
| Problème | Solution |
|---|---|
| Saut « non configuré » | L’intégration n’a jamais été paramétrée pour cet espace de travail. Configurez-la sous |
| Saut « désactivée » | L’intégration est configurée mais l’interrupteur est désactivé. Activez-la sur la page de l’intégration |
| Erreur d’identifiants | Vérifiez les identifiants stockés sur la page d’intégration. La tâche les relit à chaque exécution |
| Mêmes employés recréés à chaque exécution | La clé de correspondance est propre à l’intégration. Consultez sa documentation pour le champ utilisé (par ex. matricule, e-mail) |
| Le mode test affiche les bonnes données, l’exécution réelle ne fait rien | Une intégration peut signaler un saut en cours d’exécution (par ex. quand la sync employés est désactivée dans les options avancées). L’exécution se termine avec succès mais rien n’est validé ; last_sync_at n’est volontairement pas avancée |