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 | |
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 |
Personal → Social Links → LinkedIn URL | ||
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 :
- ID du groupe synchronisé (cliquez ici pour plus d'informations sur la récupération de l'ID d'un groupe).
É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 :
- pour chaque champ, son nom API dans BambooHR ;
- les valeurs acceptées pour chaque champ.
É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.
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
etdivision
) ; - pour chaque champ, le niveau dans la hiérarchie des groupes (dans l’exemple ci-dessus,
location
est niveau 1, etdivision
est niveau 2) ; - pour chaque champ, les valeurs possibles (dans l’exemple ci-dessus, les valeurs possibles pour
location
sontNew York
etParis
, et les valeurs possibles pourdivision
sontMarketing
,Sales
, etHR
).
É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 :
- Nom de l'intégration
- BambooHR
- Domaine de votre instance BambooHR
- https://mycompany.bamboohr.com/ (remplacez
mycompany
par votre URL réelle)
- https://mycompany.bamboohr.com/ (remplacez
- Clé API de votre instance BambooHR
- voir la documentation BambooHR sur la récupération de la clé API (un compte administrateur BambooHR est nécessaire)
-
Groupe synchronisé
- ID du groupe
-
Administrateur du connecteur
- Adresse e‑mail de l’utilisateur
-
Filtre pour les utilisateurs synchronisés (facultatif)
- pour chaque champ, son nom API dans BambooHR ;
- les valeurs acceptées pour chaque champ.
-
Champs personnalisés (facultatif)
- 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).
-
Structure de synchronisation des groupes (facultatif)
- le nom API dans BambooHR des champs correspondant à chaque niveau dans la hiérarchie ;
- pour chaque champ, son niveau dans la hiérarchie ;
- pour chaque champ, les valeurs possibles.
É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.