Recherche

[OBSOLÈTE] Synchroniser les utilisateurs depuis votre SIRH via un fichier CSV (connecteur historique)

  • Mise à jour

Connecteur obsolète - Pour les implémentations existantes uniquement : Ce connecteur n'est plus disponible pour les nouvelles intégrations. Si vous utilisez ce connecteur, cette documentation reste disponible à titre de référence. Pour les nouvelles intégrations, veuillez contacter votre CSP afin de discuter du connecteur alternatif recommandé et de sa tarification.

Section GÉNÉRAL

Vous pouvez synchroniser les utilisateurs depuis votre SIRH dans 360Learning, en important un fichier CSV contenant la valeur des champs utilisateur sur un serveur FTP dédié (que nous vous mettons à disposition). Le principal avantage de la synchronisation des utilisateurs réside dans la suppression des doublons, et la simplification des processus RH. Aucun développement n’est nécessaire pour configurer ni maintenir cette synchronisation.

Cette méthode offre plus de flexibilité qu’une intégration spécifique, et s’adapte à n’importe quel SIRH permettant l’export des champs utilisateur au format CSV. Elle a notamment été validée pour Foederis, Hibob, Skillup et Workday.

  • Les fichiers CSV téléversés sur notre serveur SFTP sont supprimés après 30 jours.
  • Vous pouvez activer la fonctionnalité de chiffrement pour ajouter une couche de sécurité à la synchronisation. Pour plus d’informations, voir Chiffrer le fichier CSV pour le connecteur SIRH.

synchroniser les champs du profil utilisateur 360Learning (email, prénom, nom, organisation, titre, langue, manager) ;

  • synchroniser n’importe quel champ du SIRH sous forme de champ du profil utilisateur 360Learning (email, prénom, nom, organisation, titre, langue, manager) ou de champ personnalisé 360Learning ;
  • 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 comme invités par cet utilisateur sur 360Learning) ;
  • synchroniser tous les utilisateurs du SIRH ou uniquement un sous-ensemble ;
  • 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 ou modifier les utilisateurs dans 360Learning marqués comme Actifs dans le fichier CSV ;
  • supprimer dans 360Learning les utilisateurs marqués Inactifs dans le CSV.

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

Il s’agit d’une synchronisation à sens unique. Le connecteur n’écrit aucune information dans votre SIRH :

  • si un champ utilisateur possède une valeur différente dans 360Learning et le CSV, la valeur du CSV remplace celle de 360Learning ;
  • si un utilisateur est supprimé dans 360Learning (mais marqué comme actif dans le fichier CSV), il sera recréé dans 360Learning.

Une fois le connecteur configuré, il effectuera une synchronisation deux fois par jour :

  • 06 h 30, heure d'Europe centrale (UTC+1)
  • 23 h 30, heure d'Europe centrale (UTC+1)

L'heure de fin de la synchronisation dépend de la quantité de données synchronisées.

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

Vous pouvez ajouter/modifier des utilisateurs dans 360Learning avec le groupe plateforme, ou un groupe privé spécifique. Les utilisateurs de votre SIRH 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 les permissions 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 :

  • L'email de l'utilisateur ayant les permissions d'administrateur sur le groupe synchronisé.

Étape 3 : choisissez si les nouveaux utilisateurs doivent recevoir une notification

Par défaut, les utilisateurs créés dans 360Learning 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 choisir de désactiver cette notification mail et de gérer la communication à votre manière.

Notez les éléments suivants :

  • Création silencieuse d’utilisateurs :
    • faux : Valeur par défaut. Les utilisateurs recevront une notification par email lorsqu'ils seront créés dans 360Learning.
    • ou true (les utilisateurs ne recevront aucune notification lors de leur création).

Étape 4 (facultative) : choisissez la méthode de rapprochement (reconciliation) des utilisateurs

Par défaut, le connecteur utilise les adresses e‑mail de vos utilisateurs pour mettre à jour leurs profils dans 360Learning. Il est donc préférable que vos utilisateurs utilisent la même adresse e‑mail dans tous votre système.

Vous pouvez également choisir d'utiliser l'ID unique de l'utilisateur de votre SIRH. C'est une bonne option si ces ID sont le moyen le plus fiable et cohérent d'identifier vos utilisateurs. Si vous souhaitez explorer cette option, contactez votre Customer Success Partner (CSP).

Étape 5 : créez un fichier CSV avec les champs utilisateurs

Étape 5.1 : initialisez le fichier CSV

Créez un fichier CSV (en UTF-8) de la liste de vos utilisateurs, avec les colonnes suivantes :

  • uniqueId (clé primaire) : Identifiant unique de l'utilisateur. Vous pouvez utiliser l'ID utilisateur de votre SIRH, ou toute autre valeur, tant qu'elle est unique pour chaque utilisateur et qu'elle ne change pas dans le temps. Cette valeur ne sera pas affichée dans 360Learning. Nous vous suggérons de conserver un index de ces valeurs pour chaque utilisateur, afin d'éviter des conflits entre utilisateurs ultérieurement.
  • status : si l’utilisateur doit être créé/modifié ou supprimé. Il s’agit d’une indication pour le connecteur et ne correspond à aucun champ 360Learning. Les valeurs possibles sont les suivantes :
    • Active : l’utilisateur sera créé ou modifié avec les valeurs du fichier CSV.
    • N’importe quelle autre valeur : l’utilisateur sera supprimé de 360Learning.
  • email : adresse email de l’utilisateur.
    • Vous pouvez utiliser cette colonne pour modifier l’adresse email d’un utilisateur dans 360Learning (car la clé primaire est le uniqueId).

Assurez-vous que chaque utilisateur est listé une seule fois dans le fichier.

Étape 5.2 : ajoutez les champs

Vous pouvez synchroniser les champs utilisateurs 360Learning suivants :

Ces champs sont optionnels, en particulier dans les situations suivantes :

  • Si vous les ajoutez comme colonnes au fichier CSV, les valeurs 360Learning seront écrasées par celles du fichier CSV (si les valeurs sont vides dans le fichier CSV, les champs de 360Learning seront effacées).
  • Si vous ne les ajoutez pas comme colonnes au fichier CSV, les champs correspondants dans 360Learning ne seront pas modifiés.

Pour synchroniser un champ, ajoutez-le comme entête de colonne au fichier CSV, puis notez la correspondance entre le nom de l’entête et le titre du champ 360Learning. Nous recommandons les noms d’entête suivants pour la correspondance :

  • firstName (correspondant au champ 360Learning Prénom) ;
  • lastName (correspondant au champ 360Learning Nom) ;
  • organization (correspondant au champ 360Learning Organisation).
  • title (correspondant au champ 360Learning Titre / Fonction) ;
  • managerId (correspondant au champ 360Learning Manager).

Si vous utilisez un troisième champ pour le nom d’utilisateur (comme Preferred name ou Nickname) dans votre SIRH, contactez votre Solution Architect pour qu’il puisse adapter la correspondance.

Étape 5.3 : ajoutez les champs personnalisés

En plus des champs de profil utilisateur, vous pouvez mapper n'importe quel champ de votre SIRH à un champ personnalisé 360Learning pour l'utilisateur.

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).

Pour ajouter une date en tant que champ personnalisé, utilisez le format de chaîne date heure : AAAA-MM-JJ.

Pour synchroniser un champ sous la forme d’un champ personnalisé, ajoutez-le comme entête de colonne au fichier CSV, puis notez la correspondance entre le nom_du_champ que vous souhaitez afficher dans le champ personnalisé 360Learning. Par exemple :

  • location (correspondant au champ personnalisé 360Learning Location) ;
  • department (correspondant au champ personnalisé 360Learning Department).

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

  • Si un champ personnalisé synchronisé est retiré d'un utilisateur dans 360Learning, il sera rajouté à l'utilisateur lors de la prochaine synchronisation.
  • Si un champ personnalisé synchronisé est supprimé de la plateforme 360Learning, il est recréé et ajouté à l'utilisateur 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.4 : remplissez le CSV avec les données utilisateur

Maintenant que le fichier CSV contient toutes les colonnes nécessaires, vous pouvez le remplir avec les données des utilisateurs. Vous trouverez ci-dessous un aperçu du format requis pour chaque colonne (vous pouvez télécharger un modèle CSV).

  • uniqueId (clé primaire) : chaîne de caractères.
    • Rappel : cette valeur doit être unique et permanente pour chaque utilisateur.
  • status : « Active » (l’utilisateur sera créé ou modifié avec les valeurs du fichier CSV) ou n’importe quelle autre valeur (l’utilisateur sera supprimé dans 360Learning).
  • email : adresse email, en lettres minuscules.
  • firstName : chaîne de caractères.
  • lastName : chaîne de caractères.
  • organization : chaîne de caractères.
  • title : chaîne de caractères.
  • managerId : valeur du champ uniqueId d’un autre utilisateur.
  • language : chaîne de caractères.
    • Si votre SIRH le permet, utilisez les codes ISO 639-1. Sinon, utilisez des noms explicites pour chaque langue, et nous créerons une correspondance avec les valeurs autorisées dans 360Learning.
    • Vous pouvez consulter la liste des langues disponibles dans notre article Modifier la langue de la plateforme.
  • location (ou n’importe quel autre champ devant être synchronisé comme un champ personnalisé) : chaîne de caractères.

Étape 5.5 : définissez une nomenclature pour le fichier CSV

Pour autoriser la modification du fichier CSV après son envoi sur le serveur FTP, nous traitons uniquement les fichiers qui ont un préfixe et une extension en particulier.

Par défaut, le préfixe est hris, et l’extension est tsv (par exemple, hris-360learning.tsv).

Vous pouvez utiliser ces valeurs par défaut, ou définir d’autres valeurs.

Si vous activez la fonctionnalité de chiffrement, le connecteur peut traiter les fichiers avec l'extension que vous avez définie et avec l'extension de chiffrement. Par exemple, si le nom de fichier attendu est hris-360learning.tsv, les noms suivants sont acceptés :

  • hris-360learning.tsv
  • hris-360learning.tsv.pgp
  • hris-360learning.tsv.gpg

Étape 6 (facultative) : choisissez le filtre sur les utilisateurs SIRH

Par défaut, tous les utilisateurs dans le fichier CSV seront synchronisés avec le groupe de destination dans 360Learning.

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

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 :

uniqueId,statut,email,prénom,nom,lieu
0001,Actif,ada@computer.org,Ada,Lovelace,Paris
0002,Actif,karen@computer.org,Karen,Jones,London
0003,Actif,annie@computer.org,Annie,Easley,Paris

Vous pouvez filtrer les utilisateurs sur plusieurs champs. Dans ce cas, les utilisateurs doivent correspondre aux valeurs de tous les champs (et non à un seul d'entre eux).

Vous pouvez filtrer les utilisateurs sur plusieurs valeurs pour un champ donné. Dans ce cas, les utilisateurs peuvent correspondre à l'une ou l'autre de ces valeurs.

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

  • pour chaque champ, le nom de l’entête de sa colonne dans le CSV ;
  • les valeurs acceptées pour chaque champ.

Les filtres s'appliquent aux utilisateurs actifs et inactifs.

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

Par défaut, les utilisateurs synchronisés avec votre SIRH seront ajoutés comme apprenants dans un groupe unique dans 360Learning. Avec la synchronisation avancée des groupes, vous pouvez les synchroniser dans n’importe quels groupes de 360Learning, en fonction des valeurs des champs de votre SIRH.

Pour plus d'information, voir notre article sur la synchronisation avancée des groupes.

Étape 8 (facultative) : activez ou désactivez le chiffrement des fichiers

Par défaut, le connecteur synchronisera les données du fichier CSV en clair.

Vous pouvez activer la fonctionnalité de chiffrement pour ajouter une couche de sécurité à vos données. Le connecteur synchronisera alors uniquement les données provenant des fichiers chiffrés. Pour plus d’informations, voir Chiffrer le fichier CSV pour le connecteur SIRH.

Notez les éléments suivants :

  • Chiffrement :
    • false (valeur par défaut) : le connecteur traite uniquement les fichiers non-chiffrés.
    • true : le connecteur traite uniquement les fichiers chiffrés.

Étape 9 (facultatif) : provisionnez les utilisateurs actifs lorsqu'il existe des doublons inactifs

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, comme 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.

Si vous choisissez d'activer cette option, notez le point suivant :

  • Provisionner les utilisateurs actifs lorsque des doublons inactifs existent : activé

Étape 10 : demandez l'activation du connecteur

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

Étape 11 : testez le connecteur

Lorsque votre Solution Architect active le connecteur sur votre plateforme, il ou elle vous fournira les éléments suivants :

  • l’URL d’une instance de test 360Learning.
    • Par exemple, si votre plateforme de production est myacademy.360learning.com, l’URL de votre instance de test sera quelque chose comme myacademy.360mooc.com:14532.
  • des identifiants de connexion SFTP :
    • une adresse hôte (host) ;
    • un login ;
    • un mot de passe.
  • (Si le chiffrement des données est activé) la clé publique de chiffrement de votre fichier CSV pour l’instance de test.

Si vous préférez importer le CSV sur un serveur FTP que vous contrôlez, partagez-vous à la place des identifiants de votre choix.

Suggestions de scénarios de test

Les étapes recommandées pour tester la synchronisation sont :

  1. Créer le fichier CSV.
  2. (Facultatif) si vous avez activé le chiffrement des données, chiffrez votre fichier CSV avec la clé publique pour l’instance de test.
  3. Connectez-vous au serveur SFTP (avec un client FTP tel que FileZilla) en utilisant les identifiants que nous vous avons envoyés.
  4. Envoyer le fichier CSV sur le serveur.
  5. Demander à votre Solution Architect de lancer le script de synchronisation.
  6. Évaluer les modifications sur votre instance de test.

Voici une suggestion d’éléments à vérifier, pour l’évaluation de la synchronisation :

  • Tous les utilisateurs marqués comme actifs dans le fichier CSV 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 le CSV, ses champs doivent être modifiés dans 360Learning après l'action de synchronisation.
  • Si vous ajoutez un utilisateur dans le CSV, il doit être créé dans 360Learning après l'action de synchronisation.
  • Si vous marquez un utilisateur comme Inactive (ou toute autre valeur que Active) dans le fichier CSV, il doit être supprimé de 360Learning après l'action de synchronisation.

Rappel : sur l’instance de test, les synchronisations s’effectuent manuellement. Contactez votre Solution Architect à chaque fois que vous importez un nouveau fichier CSV sur le serveur FTP.

Détails sur l’instance de test

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.
  • Aucune modification faite sur votre instance de test n'est reportée sur votre instance de production.
  • Nous ne déployons aucune mise à jour produit sur les instances de test.
  • L'instance de test n'envoit aucun email.

L'instance de test est une plateforme de développement et de test. Aucune qualité de service ne lui est attachée. En particulier, elle peut être effacée à tout moment. Si vous ne pouvez plus vous y connecter, demandez à votre Solution Architect de la redémarrer.

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.

Étape 12 : déployez le connecteur en production

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

Si le chiffrement des données est activé sur votre connecteur, votre Solution Architect (SA) vous fournira la clé publique pour l’environnement de production.

Vous pouvez importer plusieurs fichiers CSV sur le serveur FTP. Le connecteur les traitera les uns après les autres, dans l'ordre chronologique de leur ajout.

Une fois activé, les paramètres du connecteur apparaîtront dans la section Connecteurs des paramètres du groupe synchronisé.

Pour visualiser les résultats quotidiens de synchronisation et télécharger les journaux de synchronisation, consultez Voir les résultats de synchronisation du connecteur SIRH.

Vous pouvez également recevoir une notification récapitulative après chaque synchronisation. Contactez votre SA pour définir les destinataires de cette notification.

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