Synchroniser des utilisateurs avec BambooHR

  • Mise à jour

Cette fonctionnalité nécessite la Solution HCM Connect. Contactez votre Account Manager pour en savoir plus.

Vous pouvez synchroniser des utilisateurs de BambooHR vers 360Learning. En particulier, vous pouvez :

  • choisir l’endroit où les utilisateurs seront synchronisés dans 360Learning (groupe plateforme, ou un groupe privé spécifique) ;
  • choisir l’administrateur du connecteur (les utilisateurs synchronisés seront considérés invités par cet utilisateur dans 360Learning) ;
  • synchroniser tous les utilisateurs du SIRH ou uniquement un sous-ensemble ;
  • synchroniser des champs BambooHR personnalisés sous forme de champs personnalisés dans 360Learning ;
  • synchroniser les utilisateurs dans une structure hiérarchique de groupes (au lieu de synchroniser tous les utilisateurs dans un groupe unique).

Lors de son activation, le connecteur effectuera les actions suivantes :

  • ajouter les utilisateurs BambooHR 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 BambooHR.

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

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

Nom du champ API dans BambooHR Endroit où le champ est visible dans BambooHR Nom du champ dans 360Learning
workEmail (clé primaire) Personal → Contact → Work Email Email
firstName Personal → Basic Information → First Name Prénom
lastName Personal → Basic Information → Last Name Nom de famille
workPhone TéléphonePersonal → Contact → Work Phone Téléphone
jobTitle Job → Job Information → Job Title Titre / Fonction
linkedin Personal → Social Links → LinkedIn URL LinkedIn
supervisor Job → Job Information → Reports To Manager

Une fois le connecteur configuré, il effectuera une synchronisation quotidienne, à minuit :

  • si un champ utilisateur possède une valeur différente dans 360Learning et BambooHR, la valeur de BambooHR remplace celle de 360Learning ;
  • si un utilisateur synchronisé est supprimé dans BambooHR, il sera supprimé dans 360Learning ;
  • si un utilisateur synchronisé est supprimé dans 360Learning (mais pas dans BambooHR), il sera recréé dans 360Learning. 

Il s’agit d’une synchronisation à sens unique (BambooHR → 360Learning). Le connecteur n’écrit aucune information dans BambooHR.

Étape 1 : choisissez le groupe synchronisé dans 360Learning

Vous pouvez synchroniser des utilisateurs dans 360Learning avec le groupe plateforme, ou un groupe privé spécifique. Les utilisateurs BambooHR seront ajoutés dans (et synchronisés avec) ce groupe uniquement.

Notez les éléments suivants :

Étape 2 : choisissez l’administrateur du connecteur

L’administrateur du connecteur doit avoir des droits d'administrateur sur le groupe synchronisé.

Les utilisateurs synchronisés seront considérés invités par cet utilisateur dans 360Learning.

Notez les éléments suivants :

  • e‑mail de l'utilisateur avec les droits d'administrateur sur le groupe synchronisé.

Étape 3 (facultative) : choisissez le filtre sur les utilisateurs BambooHR

Par défaut, tous les utilisateurs du directory de BambooHR seront synchronisés avec le groupe choisi à l’étape 1 dans 360Learning.

Vous pouvez choisir de synchroniser uniquement certains utilisateurs de BambooHR, en fonction de la valeur de leurs champs.

Par exemple, vous pouvez synchroniser uniquement les utilisateurs avec la valeur Paris dans le champ Location. Dans l’exemple ci-dessous, uniquement Ada Lovelace et Annie Easley seront synchronisées :

{
	"name": "Ada Lovelace",
	"location": "Paris"
}
{
	"name": "Karen Jones",
	"location": "London"
}
{
	"name": "Annie Easley",
	"location": "Paris"
}

Vous pouvez filtrer les utilisateurs sur plusieurs champs ; dans ce cas, les utilisateurs devront correspondre aux valeurs dans tous les champs choisis (règle logique AND).

Vous pouvez également filtrer les utilisateurs sur plusieurs valeurs d’un même champ ; dans ce cas, les utilisateurs devront correspondre à une valeur parmi celles choisies (règle logique OR).

Si vous souhaitez filtrer les utilisateurs, notez les éléments suivants :

Étape 4 (facultative) : choisissez des champs personnalisés

En plus des champs synchronisés par défaut, vous pouvez ajouter n’importe quel champ BambooHR (standard ou personnalisé) sous forme de champs personnalisés 360Learning, tant que ce champ est accessible par son ID via l’API BambooHR. Vous pouvez voir la liste complète des éléments accessibles pour votre plateforme avec la route API suivante :

  • https://api.bamboohr.com/api/gateway.php/mycompany/v1/meta/fields

Remplacez mycompany par le vrai nom de votre plateforme dans l’URL https://mycompany.bamboohr.com/.

Le champ personnalisé dans 360Learning sera affiché au format nom_du_champ: valeur_du_champ (par exemple, si un champ est intitulé Location et qu'un utilisateur a la valeur Paris, le titre du champ personnalisé dans 360Learning sera Location, et la valeur du champ personnalisé sera Paris).

Si vous souhaitez synchroniser des champs sous forme de champs personnalisés, notez les éléments suivants :

  • pour chaque champ, son nom API dans BambooHR ;
  • pour chaque champ, le nom que vous souhaitez afficher dans 360Learning (il peut être différent de celui de BambooHR).

Règles supplémentaires pour la synchronisation des champs personnalisés

  • Si un champ personnalisé synchronisé est enlevé du profil d’un utilisateur dans 360Learning, il sera ajouté à nouveau à son profil lors de la prochaine synchronisation.
  • Si un champ personnalisé synchronisé est supprimé de la plateforme dans 360Learning, il sera recréé et ajouté à nouveau au profil des 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.

Étape 5 (facultative) : choisissez la structure de synchronisation des groupes

Par défaut, les utilisateurs BambooHR 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.

mceclip0.png

Dans l’exemple ci-dessus, la structure de groupes est :

  • (Top level : groupe synchronisé.)
  • Niveau 1 : location.
  • Niveau 2 : division.

Le connecteur ne crée aucun groupe : si les valeurs des champs d’un utilisateur synchronisé ne correspond à aucun groupe existant dans 360Learning, ou correspond à plusieurs groupes, l’utilisateur est ajouté au groupe synchronisé de niveau maximum (le plus haut dans la hiérarchie).

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

  • le nom API dans BambooHR des champs correspondant à chaque niveau dans la hiérarchie (dans l’exemple ci-dessus : location et division) ;
  • pour chaque champ, le niveau dans la hiérarchie des groupes (dans l’exemple ci-dessus, location est niveau 1, et division est niveau 2) ;
  • pour chaque champ, les valeurs possibles (dans l’exemple ci-dessus, les valeurs possibles pour location sont New York et Paris, et les valeurs possibles pour division sont Marketing, Sales, et HR).

Étape 6 : demandez l’activation du connecteur BambooHR

Envoyez un email à votre CSP ou Solution Architect pour demander l'activation du connecteur BambooHR, avec les éléments suivants :

Étape 7 : testez le connecteur

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

Exemple :

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

Cette instance de test est une copie de votre instance de production au moment où elle a été créée. Elle vit séparément de votre instance de production.

  • Aucune modification faite sur votre instance de production n'est reportée sur votre instance de test.
  • Inversement, 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 une plateforme de test et de développement, et sera supprimée sans avertissement au bout de quelques jours. Si vous avez besoin d'une nouvelle instance de test, contactez votre Solution Architect.

La synchronisation des utilisateurs sur l’instance de test doivent être faits manuellement par votre Solution Architect ; elle ne possède pas de synchronisation quotidienne automatique.

Suggestions de scénarios de test

  • Tous les utilisateurs actifs de BambooHR doivent être visibles en tant qu’apprenants dans votre groupe synchronisé.
  • Vérifiez que tous les utilisateurs sont correctement ajoutés.
  • Si vous modifiez un utilisateur dans BambooHR, ses champs doivent être modifiés dans 360Learning après l’action de synchronisation.
  • Si vous ajoutez un utilisateur dans BambooHR, il doit être créé dans 360Learning après l’action de synchronisation.
  • Si vous supprimez un utilisateur dans BambooHR, il doit être supprimé de 360Learning après l’action de synchronisation.

N'oubliez pas de contacter votre Solution Architect afin qu'il ou elle lance manuellement les scripts de synchronisation.

Étape 8 : déployez le connecteur BambooHR en production

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

Les utilisateurs synchronisés recevront une notification mail, avec :

  • l'email qu'ils peuvent utiliser pour se connecter ;
  • un mot de passe temporaire qu’ils devront modifier lors de leur première connexion.

Vous pouvez également recevoir une notification récapitulative après chaque synchronisation. Contactez votre Solution Architect pour définir la liste des destinataires de cet email.

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 : 0 sur 0

Vous avez d’autres questions ? Envoyer une demande