Si l'authentification sur votre communauté Steeple fonctionne via la méthode classique ou par matricules, vous avez la possibilité d'inviter vos utilisateurs via un fichier, et de réaliser plusieurs actions détaillées ci-dessous.
Description de la fonctionnalité
Depuis votre espace Administration, l'accès à cette fonctionnalité s'effectue depuis la page Membres, via le bouton Actions > Approvisionnement par fichier.
En fonction de ce que vous souhaitez faire, vous pouvez ensuite cliquer sur "Choix du mode de synchronisation" pour choisir entre Miroir, Insertion ou Suppression :
✲ Miroir : le contenu de la source sera exactement appliqué sur l'orga, et les utilisateurs absents de la source seront supprimés.
✲ Miroir sans suppression : le contenu de la source sera exactement appliqué sur la communauté, mais les utilisateurs absents de la source sont ignorés.
✲ Insertion et mise à jour : le contenu de la source sera appliqué sur la communauté, mais rien ne sera supprimé.
✲ Insertion : le contenu de la source sera appliqué sur la communauté, mais rien ne sera supprimé ou mis à jour.
✲ Suppression : le contenu de la source sera supprimé de la communauté.
La gestion du fichier à importer
Un template (gabarit) est mis à votre disposition, afin que les données, formats, contraintes... soient fidèles au résultat souhaité. Le gabarit est accessible directement sur l'interface en haut à gauche en cliquant sur Télécharger le template.
Voici les choses à savoir concernant ce fichier et les colonnes qui le composent.
-
Le fichier importé doit forcément être en CSV UTF8 (séparé par des virgules) ou en XLSX.
-
L'ordre des colonnes n'est pas contraint, elles peuvent se présenter dans un ordre différent de celui du gabarit.
- Les colonnes Nom, Prénom sont obligatoires, ainsi que le Matricule
et la Date de naissance dans le cas où vous les utilisez pour authentifier vos utilisateurs. - Il est impératif d'avoir un module Organigramme complet (avec tous les services renseignés) si vous souhaitez intégrer une colonne Service dans votre fichier.
-
Les colonnes ajoutées au gabarit (contenant donc des données non attendues) ne seront pas traitées.
-
Autant de colonnes "communautés" peuvent être ajoutées, à condition que le nom de ces colonnes respecte bien l'attendu.
- ATTENTION : Une colonne Communauté doit correspondre à UNE communauté. Si votre entreprise a plusieurs communautés, alors vous devez avoir autant de colonnes que de communautés.
-
Les informations non renseignées dans une case optionnelle n'écrasent pas les informations déjà présentes dans l'application.
-
Le nom des colonnes est traduit dans les différentes langues supportées par la plateforme (ES, EN, FR, DE), il doit donc correspondre à la langue de la communauté concernée.
Le format des différentes cases du fichier (en particulier celles contenant des nombres) doit être en format texte. Dans le cas contraire, des messages d'erreurs pourraient apparaitre (voir plus bas).
Lancement de l'analyse
Une fois votre fichier prêt, vous pouvez alors le choisir depuis votre ordinateur et lancer l'analyse.
Pas de panique, lancer l'analyse ne signifie que l'import se lance et s'exécute directement. Il s'agit d'abord d'une simulation
Une fois l'analyse lancée, une nouvelle ligne va apparaitre dans l'historique de traitement.
Une fois l'analyse terminée, l'état et le résultat de celle-ci vont apparaitre :
- En cas de Succès, le fichier a bien été lu et vous pouvez, en cliquant sur Visualiser, voir les résultats de la simulation. Si ces résultats sont cohérents, vous pouvez alors exécuter pour de bon l'import !
Il est possible, malgré le succès d'un import, que des avertissements apparaissent dans la visualisation des résultats. Ceux-ci sont simplement des alertes et n'empêchent en rien le bon import. Vous pouvez donc les ignorer.
- En cas d'Echec, cela veut dire que le fichier n'est pas bon et vous allez voir des messages d'erreurs dans les résultats. En résumé :
- ERREUR : Bloquant Des anomalies majeures ont été rencontrées, empêchant le bon traitement du fichier (colonne manquante, donnée obligatoire manquante...).
- AVERTISSEMENT : Non bloquant Des anomalies mineures ont été rencontrées (espace en trop par exemple) mais n'ont pas empêchées le traitement normal des données.
- STATISTIQUES : Non bloquant Indique le nombre de lignes traitées lors du traitement du fichier.
Astuce : La colonne Adresse permet de définir à quel endroit précis se situe l'anomalie détectée dans votre fichier. Il est courant de devoir ajouter +1 aux lignes renseignées pour obtenir la ligne réelle impactée. (exemple : Ligne 265 = il faudra vérifier la ligne 266)
Voici la liste des messages d'avertissements/erreurs que vous pourrez potentiellement rencontrer :
- cleaned_string (AVERTISSEMENT) : "Cellule nettoyée des caractères indésirables"
- must_exist (ERREUR): "La cellule ne peut être vide"
- invalid_header (ERREUR): "Entête de colonne invalide, la première doit contenir le nom des colonnes" (ou une colonne en trop donc non traitée)
- missing_colonne (ERREUR): "Colonne XXXXX manquante"
- invalid_phonenumber (ERREUR): "Numéro de téléphone invalide : format français attendu (+331 23 45 67 89)"
- no_applicable_backend (ERREUR) : "Le format du fichier n'est pas celui attendu"
- not_found (ERREUR) : "Communauté ou service non trouvé"
- must_be_email (ERREUR) : "L'information fournie ne ressemble pas à un email"
- uniq_email (ERREUR): "L'adresse email XXXXX est présente plusieurs fois dans le fichier"
- uniq_personnel_id (ERREUR): "Le matricule XXXXX est présent plusieurs fois dans le fichier"
- upsert_uniq_email (ERREUR): "Il existe déjà une invitation pour cette adresse email XXXXXX"
- upsert_uniq_personnel_id (ERREUR): "Il existe déjà une invitation pour le matricule XXXXXX"
- community_without_admin (ERREUR): "Il n'y aurait plus d'administrateur dans votre communauté à l'issue de l'import, donc le traitement a été annulé"