Trouvez ci-dessous les réponses aux questions fréquentes sur l’API d’approvisionnement.
Préambule
Cette intégration nécessite des compétences en développement logiciel lié aux API.
Pour configurer une intégration, vous devez être un administrateur Workleap.
Pour extraire les données d’engagement ou de feedback d’Officevibe, visitez api.officevibe.com.
Gestion de l’invitation des membres
Comment m’assurer que les membres sont invités pendant la synchronisation ?
Activez l’invitation automatique dans les paramètres de l’API d’approvisionnement (Paramètres > Provisionnement > Paramètres de l’API d’approvisionnement).
Puis-je tester mon intégration sans inviter de membres ?
Oui. Pour tester sans inviter de membres :
Désactivez l’invitation automatique dans les paramètres de l’API d’approvisionnement (Paramètres > Provisionnement > Paramètres de l’API d’approvisionnement).
Les membres sont créés, mais ne sont pas invités tant que cela n’est pas fait manuellement.
Comment inviter des membres manuellement ?
Assurez-vous que les membres ont accès à au moins un produit Workleap.
Accédez à la liste des utilisateurs (Paramètres > Utilisateurs).
Sélectionnez les utilisateurs à inviter.
Cliquez sur le menu à trois points.
Sélectionnez Inviter.
Remarque : L’activation de l’invitation automatique ne réinvite pas les utilisateurs déjà présents dans Workleap.
Attribution des rôles d’administrateur et de gestionnaire
Puis-je gérer les rôles d’administrateur et de dirigeant via l’API d’approvisionnement ?
Non. Ces rôles doivent être attribués manuellement depuis la plateforme.
Que se passe-t-il si un administrateur est absent du fichier members.csv ?
Les administrateurs actifs ne sont pas désactivés.
Les administrateurs créés ou invités ne sont pas supprimés.
Pour supprimer un administrateur, modifiez ses permissions ou supprimez manuellement son compte.
Gestion des fichiers CSV
Comment les fichiers CSV sont-ils remplis ?
Les données sont importées à partir d’un SIRH ou d’un autre annuaire d’employés.
Conseil : Utilisez un script pour mettre à jour et synchroniser régulièrement les fichiers CSV.
Les fichiers CSV prennent-ils en charge les caractères spéciaux ?
Oui. Des caractères comme « ñ » et « í » sont synchronisés correctement.
Comment mettre à jour les noms d’équipe sans perdre de données ?
Assurez-vous que les équipes existent dans Workleap et ajoutez un externalTeamId unique.
Synchronisez une première fois avec le fichier teams.csv en utilisant les noms d’équipe existants.
Synchronisez à nouveau avec les nouveaux noms d’équipe, tout en conservant le même externalTeamId.
Puis-je conserver des équipes dans Workleap sans les inclure dans les fichiers CSV ?
Non. Les équipes absentes des fichiers CSV sont supprimées.
Exception : Les équipes basées sur des règles ne sont pas affectées par l’API d’approvisionnement.
J’ai déjà une intégration d’approvisionnement avec l’ancienne API de Workleap. Mon script existant fonctionne-t-il toujours ?
Oui, mais vous devez générer une nouvelle clé API.
Remarque : Bien que l’API d’approvisionnement soit conçue pour fonctionner avec le format CSV de l’ancienne API, nous recommandons fortement de mettre à jour vos fichiers de script afin d’assurer le bon fonctionnement de votre intégration.
Segments et propriétés
Puis-je créer des segments via l’API d’approvisionnement ?
Non. Les segments ne peuvent pas être créés, modifiés ou supprimés via l’API d’approvisionnement.
Puis-je créer de nouvelles propriétés et valeurs de propriété ?
L’API d’approvisionnement peut attribuer des valeurs à des propriétés existantes.
Les nouvelles valeurs de propriété doivent être créées manuellement avant attribution.
Tests et gestion des erreurs
Puis-je tester l’API d’approvisionnement avant de la déployer en production ?
Oui. Demandez un environnement de test à support@workleap.com.
Messages d’erreur fréquents
Message d’erreur | Solution |
Accès refusé en raison d’une clé d’abonnement invalide | Utilisez une clé valide pour un abonnement actif. |
La clé API n’est pas valide | Vérifiez que la clé n’a pas été révoquée. |
Fichiers CSV requis manquants | Transmettez des fichiers valides : members.csv, teams.csv, team-mappings.csv. |
Erreur de synchronisation des fichiers CSV | Vérifiez la validité et le format des fichiers. |
Mise à jour automatique des affectations d’équipe
Que se passe-t-il lorsque les affectations d’équipe changent ?
Si des modifications sont faites dans le SIRH et que l’API synchronise les fichiers CSV, les mises à jour sont appliquées automatiquement lors de la prochaine synchronisation.
Réduction des tâches manuelles
Utilisez des scripts pour mettre à jour les fichiers CSV à partir de votre SIRH.
Planifiez l’exécution du script PowerShell de l’API d’approvisionnement à l’aide d’une tâche planifiée Windows.
Identifiants requis dans les fichiers CSV
Que sont les identifiants externes dans les en-têtes CSV ?
Type d’ID | Description |
Member ID | Identifiant unique pour chaque membre (externalMemberId dans members.csv). |
Team ID | Identifiant unique pour chaque équipe (externalTeamId dans teams.csv). |
Sub-team ID | Utilisé pour attribuer des sous-équipes (externalSubteamId dans team-mappings.csv). |
Remarque : Évitez d’utiliser le nom d’un gestionnaire comme identifiant d’équipe, car un changement d’ID pourrait créer une nouvelle équipe et entraîner une perte de données historiques.
Attribution des membres, gestionnaires et sous-équipes
Attribuer un membre d’équipe
Colonne | Valeur |
externalTeamId | ID de l’équipe depuis teams.csv |
externalMemberId | ID du membre depuis members.csv |
externalSubteamId | (Laisser vide) |
isMember | TRUE |
isManager | FALSE |
Attribuer un gestionnaire d’équipe
Colonne | Valeur |
externalTeamId | ID de l’équipe depuis teams.csv |
externalMemberId | ID du membre depuis members.csv |
externalSubteamId | (Laisser vide) |
isMember | FALSE |
isManager | TRUE |
Attribuer une sous-équipe
Colonne | Valeur |
externalTeamId | ID de l’équipe parente depuis teams.csv |
externalMemberId | (Laisser vide) |
externalSubteamId | ID de la sous-équipe depuis teams.csv |
isMember | (Laisser vide) |
isManager | (Laisser vide) |