[OBSOLÈTE] Synchroniser les utilisateurs avec Personio (connecteur historique)

  • Mise à jour

Connecteur obsolète : Ce connecteur est obsolète et n'est plus proposé pour de nouvelles intégrations. Si vous utilisez déjà ce connecteur, cet article est fourni à titre de référence.

Pour les nouvelles intégrations, contactez votre CSP pour discuter du connecteur alternatif recommandé et de son tarif.

Qui peut utiliser cette fonctionnalité ?

  • Cette fonctionnalité nécessite l'intégration Personio. Contactez votre Account Manager pour en savoir plus.
  • Les administrateurs plateforme peuvent configurer l’intégration, une fois qu’elle a été activée par votre Solution Architect.
  • Cette fonctionnalité est uniquement disponible sur l'application Web.

Aperçu de l'intégration Personio

Vous pouvez synchroniser vos utilisateurs Personio vers votre plateforme 360Learning. Cette intégration permet d'effectuer les actions suivantes :

  • Choisir le compte qui sera administrateur du connecteur.
  • Choisir le groupe où les utilisateurs Personio seront synchronisés dans 360Learning.
  • Synchroniser des champs Personio spécifiques dans 360Learning.
  • (optionnel) Synchroniser des champs Personio sous forme de champs personnalisés dans 360Learning.
  • (optionnel) Synchroniser les utilisateurs dans une structure de groupes 360Learning dont la hiérarchie représente votre organigramme Personio.

Lors de son activation, l'intégration effectuera les actions suivantes :

  • Ajouter les utilisateurs Personio synchronisés dans 360Learning, s’ils n’existaient pas déjà.
  • Modifier les valeurs des champs synchronisés des utilisateurs dans 360Learning avec les valeurs de Personio.

💡 Le connecteur ne supprimera pas, ni ne synchronisera, les utilisateurs qui existent uniquement dans 360Learning.

Calendrier de synchronisation

La synchronisation démarre automatiquement une fois par jour à 02:00 AM heure d'Europe centrale (CET/CEST).

Configurer l’intégration

Avant de commencer à configurer l’intégration dans 360Learning, quelques étapes de préparation sont nécessaires.

Étape 1 : générez les clés API Personio

💡  Lien Article Personio : Comment générer et gérer les identifiants API pour les données du personnel

Vous devez, tout d'abord, générer les clés API Personio avec les permissions API suivantes :

  • Employee data: Read only
  • Absence data: No access
  • Attendance data: No access
  • Documents: No access
  • Attendance data: No access
  • Documents: No access

Étape 2 : contactez 360Learning

Après avoir généré les clés API Personio, envoyez un email à votre CSP ou SA, avec les informations suivantes :

  • Nom de l'intégration : Personio.
  • Domaine Personio : l'adresse URL de votre application Personio.
  • Clés API personio : valeurs des champs client_id, client_Secret.
  • Identifiant du groupe 360Learning : n'indiquez que les identifiants des groupes que vous synchroniserez avec Personio.
  • Adresse email de l’administrateur 360Learning du connecteur : l’utilisateur qui sera l’administrateur du connecteur doit avoir des droits d’administrateur sur le groupe synchronisé.
  • (OPTIONNEL) Champs personnalisés : si vous souhaitez synchroniser des champs Personio dans des champs personnalisés 360Learning, indiquez pour chaque champ son nom dans l'API Personio et le nom que vous souhaitez afficher dans 360Learning.
  • (OPTIONNEL) Structure de groupe : Si vous souhaitez synchroniser vos utilisateurs dans une structure hiérarchique basée sur les champs Personio, incluez les noms des champs API Personio. Votre Architecte Support organisera un atelier pour vous aider à déterminer la meilleure hiérarchie pour refléter la Structure organisationnelle de Personio.

Une fois ces informations transmises, votre Solution Architect vous contactera pour compléter la configuration et mettre en place un scénario de test avec vous. Une fois la phase de test terminée, ils activeront l’intégration sur votre plateforme en production.

Étape 3 : testez l'intégration

Lorsque votre Solution Architect active le connecteur sur votre plateforme, il ou elle vous fournira une URL de test.

L'instance de test ne synchronise pas automatiquement les données depuis Personio vers 360Learning. Lors de la réalisation de vos tests, contactez votre Solution Architect afin qu'il ou elle lance manuellement les scripts de synchronisation.

Exemple :

  • L’URL de votre plateforme de production est : myacademy.360learning.com
  • Votre URL de test sera quelque chose comme : myacademy.360mocc.com:14532

Ce que vous devez également savoir sur l'instance de test :

  • Aucune modification faite sur votre instance de production n’est reportée sur votre instance de test.
  • Aucune modification faite sur votre instance de test n’est reportée sur votre instance de production.
  • L’instance de test n’envoie aucun email.
  • L’instance de test est temporaire. Si vous ne pouvez plus vous y connecter alors que vous souhaitez poursuivre les tests, contactez votre Solution Architect afin qu'il ou elle redémarre l'instance de test.

Suggestions de scénarios de test

💡 Lors de la réalisation de vos tests, n'oubliez pas de contacter votre Solution Architect afin qu'il ou elle lance manuellement les scripts de synchronisation.

  • Tous les utilisateurs actifs de Personio doivent être visibles en tant qu’apprenants dans vos groupes synchronisés.
  • Les données issues de Personio ont été correctement copiées vers les champs 360Learning correspondants pour chaque utilisateur synchronisé.
  • Si vous modifiez un utilisateur dans Personio, ses champs doivent être modifiés dans 360Learning après l’action de synchronisation.
  • Si vous ajoutez un utilisateur dans Personio, il doit être créé dans 360Learning après l’action de synchronisation.
  • Si vous supprimez un utilisateur dans Personio, il doit être supprimé de 360Learning après l’action de synchronisation.

Étape 4 : activez l’intégration en production

Lorsque vous avez terminé tous vos tests, et êtes satisfait des les résultats, vous pouvez demander à votre Solution Architect de déployer le connecteur sur votre plateforme de production.

Une fois l’intégration en production, les administrateurs plateforme peuvent l’activer sur des groupes spécifiques :

  1. Dans la barre latérale gauche, survolez le groupe avec lequel vous synchronisez des données, puis cliquez sur vector.svgParamètres.
    • Si settings.svgParamètres n’apparaît pas dans votre barre latérale, cliquez d’abord sur le groupe, puis sur settings.svgParamètres en haut à droite de la section principale.
  2. Dans le menu de gauche, cliquez sur Integrations.svgConnecteurs.
  3. Dans la colonne de gauche, cliquez sur ConnecteursGérer les connecteurs.
  4. Cliquez sur Personio.
  5. Vérifiez les informations d’API et cliquez sur Mettre en place le connecteur.

Les utilisateurs synchronisés recevront une notification mail avec l’email qu’ils peuvent utiliser pour se connecter et un mot de passe temporaire qu’ils devront modifier lors de leur première connexion.

Plus d'informations sur l'intégration Personio

Données synchronisées par défaut

Par défaut, les champs utilisateur suivants de Personio sont synchronisés :

💡 L’intégration synchronise uniquement les employés dont le statut est active, onboarding ou leave dans Personio. Elle ne synchronisera pas les utilisateurs Personio dont le statut est inactive.

Nom du champ API Personio Endroit où le champ est visible dans Personio Nom du champ 360Learning
employee_id Employee Information → Public Profile External id
first_name Employee Information → Public Profile Prénom
last_name Employee Information → Public Profile Nom
email Employee Information → Public Profile Email
position Employee Information → Public Profile Titre / Fonction
supervisor Employee Information → HR Information Manager

Par défaut, le connecteur utilise l’adresse e‑mail des utilisateurs pour faire la correspondance des profils entre BambooHR et 360Learning.

Cependant, vous avez la possibilité de configurer le connecteur pour prioriser l'identifiant externe (un identifiant unique de votre SIRH) pour la réconciliation des utilisateurs. Ceci est recommandé si vos identifiants externes sont les plus fiables et cohérents pour vos utilisateurs.

Fonctionnalités optionnelles

Synchroniser des champs personnalisés

En plus des champs synchronisés par défaut, vous pouvez ajouter n’importe quel champ de l'API Personio sous forme de champs personnalisés 360Learning.

Pour ajouter des champs supplémentaires, procédez comme suit :

Informations supplémentaires concernant la synchronisation des champs personnalisés :

  • Les champs personnalisés contenant des valeurs de date (telles que la date d'embauche ou la date de début) sont créés en tant que champs de type date dans 360Learning. Tous les autres champs personnalisés sont créés en tant que champs de type chaîne. Les valeurs de date de Personio sont attendues au format AAAA-MM-JJ'T'HH:MM:SSZ.
  • Si vous supprimez le champ personnalisé d'un utilisateur dans 360Learning mais pas dans Personio, l'intégration ajoutera le champ personnalisé à l'utilisateur dans 360Learning lors de la prochaine synchronisation.
  • Si vous supprimez un champ personnalisé de 360Learning mais pas de Personio, l'intégration recréera et ajoutera le champ personnalisé aux utilisateurs lors de la prochaine synchronisation.
  • Si le titre d’un champ personnalisé synchronisé est renommé dans 360Learning, un nouveau champ personnalisé est créé et ajouté au profil des utilisateurs lors de la prochaine synchronisation. Le champ personnalisé renommé existe toujours dans 360Learning mais est enlevé de tous les utilisateurs synchronisés.
  • Si un champ personnalisé non synchronisé est ajouté à un utilisateur synchronisé dans 360Learning, le champ personnalisé sera conservé sur le profil de l’utilisateur à la prochaine synchronisation.

Filtrer des utilisateurs

Vous pouvez définir des filtres pour limiter le traitement des utilisateurs en fonction des valeurs contenues dans le payload.

Par défaut, les filtres sont appliqués uniquement aux utilisateurs actifs. Si vous voulez appliquer vos filtres de synchronisation aux utilisateurs inactifs également, contactez votre CSP pour activer ce paramètre.

Activer les utilisateurs actifs lorsque des doublons inactifs existent

Les doublons surviennent lorsque les utilisateurs partagent le même identifiant (adresse e-mail ou ID externe, selon votre méthode de rapprochement). Lorsque des doublons sont détectés, ces utilisateurs ne sont pas créés ou mis à jour dans 360Learning.

Dans certaines situations—telles que la mobilité interne ou la transition d'un ancien employé externe vers un rôle interne—vous pourriez avoir besoin de provisionner un utilisateur actif même si un profil inactif avec le même identifiant existe déjà.

Vous pouvez activer Provisionner les utilisateurs actifs lorsqu'il existe des doublons inactifs pour autoriser ce comportement.

Exemple (réconciliation par email) :

Les deux utilisateurs partagent la même adresse email, ce qui crée un doublon.

Avec l'option désactivée (par défaut) : Les deux utilisateurs sont ignorés. Ni l'un ni l'autre n'est créé ou mis à jour, car ils sont considérés comme des doublons.

Avec l'option activée : L'utilisateur inactif est ignoré, permettant la création/mise à jour de l'utilisateur actif.

Contactez votre CSP pour activer ce paramètre.

Synchroniser la structure de groupe

Par défaut, les utilisateurs Personio seront synchronisés dans un groupe unique de 360Learning. Vous pouvez choisir de les synchroniser dans une structure hiérarchique de groupes, en fonction de la valeur de leurs champs.

Si vous souhaitez utiliser cette fonctionnalité, contactez votre Solution Architect, qui organisera un atelier avec vous, afin de déterminer la meilleure hiérarchie pour représenter votre structure organisationnelle.

💡 Le connecteur ne crée aucun groupe. Si les valeurs des champs d’un utilisateur synchronisé ne correspondent à aucun groupe existant dans 360Learning, l’utilisateur est ajouté au groupe synchronisé du niveau le plus haut dans la hiérarchie des groupes.

Si vous souhaitez activer la synchronisation par structure hiérarchique de groupes, notez les éléments suivants :

  • Les noms de champs API Personio pour chaque niveau hiérarchique. (Exemple : office et department sont des noms de champs API Personio.)
  • Pour chaque champ, le niveau dans la hiérarchie des groupes. (Dans l'exemple, office est de niveau 1 et department est de niveau 2.)
  • Pour chaque champ, les valeurs possibles. (Dans l’exemple, les valeurs possibles pour office sont New York et Paris. Les valeurs possibles pour department sont Support et HR.)

Dans l'exemple, quelle serait la structure de groupes dans 360Learning ?

  • Top level : le groupe synchronisé
  • Niveau 1 : office
  • Niveau 2 : department

personio_groups_.png

Visitez notre blog pour plus de ressources sur le Collaborative Learning.

Cet article vous a-t-il été utile ?

Utilisateurs qui ont trouvé cela utile : 1 sur 1


Vous avez d’autres questions ? Envoyer une demande