Passer au contenu principal

Installation et configuration de BL Connect avec Edusign

B
Écrit par Benjamin Okoh

Ce guide explique pas à pas comment installer et paramétrer BL Connect pour assurer la synchronisation entre votre logiciel de gestion (Berger-Levrault) et Edusign.

Le connecteur BL Connect Edusign permet de synchroniser un certain nombre d'informations entre BL Scolarité et Planification et Edusign. Ces synchronisations quotidiennes permettent d'alimenter automatiquement BL Scolarité avec les absences des étudiants.

⚠ Cette procĂ©dure nĂ©cessite d'ĂȘtre respectĂ©e pour que toutes les informations soient bien synchronisĂ©es. En cas de doute, contactez votre rĂ©fĂ©rent Edusign et Berger Levrault.

Veuillez consulter ce document en complément : Dossier_Installation_BLConnect_Edusign.pdf

Étape 1 – PrĂ©parer votre environnement Berger Levrault

✅ PrĂ©-requis techniques

  • Disposer d’un accĂšs administrateur au serveur hĂ©bergeant Berger Levrault

  • L'installation du programme BL_Connect Edusign

Étape 2 – Installation de BL Connect

  1. Se rapprocher de Berger Levrault pour l'installation du connecteur

  2. Vérifiez que les services nécessaires sont bien lancés.

Étape 3 – ParamĂ©trer votre espace BL ScolaritĂ© et Planification

Vos espaces Berger Levrault doivent ĂȘtre bien Ă  jour avec un certain niveau d'informations, afin d'assurer une bonne synchronisation des contenus.

Renseignez les informations suivantes dans les profils étudiants dans BL Scolarité:

  • Adresses mails (choisir entre principale et secondaire pour la synchronisation)

  • Champ GRP EDUSIGN dans l'onglet "Personnalisation" de la fiche Ă©tudiante doit ĂȘtre complĂ©tĂ© avec les groupes Ă©tudiants sous le format souhaitĂ© (ou utilisĂ© dans BL Planif si vous l'avez)

Si vous utilisez BL Planification :

  • Adresses mails des intervenants/formateurs bien complĂ©tĂ©e dans leur fiche

Étape 4 – ParamĂ©trer l'interface EDUSIGN

  1. Ouvrez le fichier de configuration BLCONNECT_EDUSIGN.INI.

  2. Renseignez les informations suivantes :

    • API Key fournie par Edusign.

    • ParamĂštres de connexion spĂ©cifiques Ă  votre Ă©tablissement.

    • L’ID Edusign doit ĂȘtre automatiquement inscrit dans le champ Code RFID.

Étape 5 – Planifier les synchronisations automatiques

Nous recommandons de planifier 3 synchronisations par jour :

  • Le matin (avant le dĂ©but des cours).

  • Entre 12h et 14h.

  • En fin de journĂ©e.

Cela garantit que les apprenants, groupes et sessions soient toujours Ă  jour.

Étape 6 – Planification d'un cours pour synchronisation des cours et remontĂ©e des absences par la suite

Dans la fiche de planification de chaque cours, les donnĂ©es suivantes doivent ĂȘtre absolument complĂ©tĂ©es si l'on souhaite que les informations soient bien transmises Ă  Edusign pour crĂ©er les feuilles de prĂ©sence :

  • Cours confirmĂ©

  • Case pĂ©dagogie directe cochĂ©e

  • Affichage sur le planning des promotions cochĂ©

  • Groupe complĂ©tĂ© ou promotion complĂšte choisie

  • Un formateur rattachĂ© Ă  la session

  • Une salle rattachĂ©e Ă  la session

Une fois la planification descendue vers Edusign, vous allez pouvoir réaliser l'émargement et traiter les absences dans Edusign.

Une fois ces étapes réalisées, les absences (justifiées et injustifiées) sont récupérées directement par BL depuis Edusign lors de la synchronisation suivante :

  • Les absences seront remontĂ©es automatiquement, sans besoin de saisie par les Ă©quipes

  • Si une absence justifiĂ©e est remontĂ©e, un lien vers le justificatif sera disponible directement dans la fiche BL ScolaritĂ© de l'Ă©tudiant

  • Si c'est un cours facultatif, aucune absence ne sera remontĂ©e

Étape 7 – ContrĂŽles et dĂ©pannage (checklist dĂ©taillĂ©e)

Ce bloc rassemble les vérifications à effectuer en priorité lorsqu'une synchronisation échoue ou que des données semblent manquantes. Suivez les étapes dans l'ordre :

✅ VĂ©rifications rapides

  • VĂ©rifier que les e-mails des apprenants et intervenants sont bien renseignĂ©s (selon EMAIL_COMM : principal ou secondaire). Attention : si un espace se trouve Ă  la fin de l'adresse mail, cela crĂ©e des gĂȘnes dans la synchronisation

  • Confirmer que le champ GRP EDUSIGN est prĂ©sent et renseignĂ© sur les fiches concernĂ©es.

  • S'assurer que le Bundle/nom de base et les identifiants dans BLCONNECT_EDUSIGN.INI pointent vers les bonnes bases.

  • VĂ©rifier que les tĂąches planifiĂ©es sont actives et que les derniĂšres exĂ©cutions ne prĂ©sentent pas d'erreur.

🔎 Analyse des logs

  • Ouvrir le dossier \Log dans l'installation BL Connect.

  • RepĂ©rer la tranche horaire correspondant Ă  la tentative de synchronisation.

  • Relever les erreurs clefs : connexion DB, timeout, refus d’authentification API, erreur de parsing d’un enregistrement.

  • Cherchez les occurrences des mots clĂ©s : ERROR, EXCEPTION, TIMEOUT, AUTH.

🔧 Actions correctives courantes

  1. Erreur de connexion DB : vĂ©rifier l’hĂŽte/port/credentials dans l’INI ; tester la connexion depuis le serveur (telnet / sqlclient).

  2. Absences ou apprenants manquants : confirmer que les promotions/sessions sont bien dans la fenĂȘtre des synchronisations (7 jours recommandĂ©s) et que le GRP EDUSIGN est renseignĂ©.

  3. Intervenants sans e-mail : compléter les adresses e-mail dans BL Scolarité ; relancer la synchro.

  4. ProblĂšme d’écriture du Code RFID : permissions sur la base BL ; vĂ©rifier qu’aucune contrainte DB empĂȘche la mise Ă  jour.

  5. Échec API Edusign : vĂ©rifier la validitĂ© et la portĂ©e de la clĂ© API transmise (expiration, permissions).

🆘 Quand contacter le support Edusign et BL

Si, aprĂšs ces vĂ©rifications, l’anomalie persiste, contactez le support Edusign avec les Ă©lĂ©ments suivants :

  • Extrait de log (10-20 lignes autour de l’erreur) ;

  • Contenu anonymisĂ© des sections clefs du BLCONNECT_EDUSIGN.INI ;

  • Indication des tĂąches planifiĂ©es (noms & horaires) ;

  • Exemple d’un enregistrement incomplet (ex : fiche apprenant avec champs manquants).

Étape 8 – Checklist finale

  • BL Connect est installĂ© et fonctionnel.

  • Les e-mails apprenants / formateurs sont renseignĂ©s sans espace Ă  la fin

  • Le champ GRP EDUSIGN est rempli.

  • Le fichier BLCONNECT_EDUSIGN.INI est correctement configurĂ©.

  • L’ID Edusign est prĂ©sent dans le champ Code RFID.

  • Les synchronisations automatiques sont programmĂ©es.

💡 Bonnes pratiques

  • Utilisez toujours une adresse e-mail gĂ©nĂ©rique (ex. formation@ecole.fr) pour les notifications.

  • Surveillez rĂ©guliĂšrement les synchronisations dans les logs.

  • Contactez Edusign et BL si une synchronisation Ă©choue plusieurs fois consĂ©cutives.

Votre interface BL Connect x Edusign est maintenant prĂȘte. 🎉

En cas de blocage, ouvrez un ticket support ou contactez directement l’équipe Edusign via le chat.

IcĂŽne de piĂšce jointe
Dossier_Installation_BLConnect_Edusign.pdf
Avez-vous trouvé la réponse à votre question ?