Configurer une source de contenu externe
Prérequis : les options LMS et Contenu externe sur votre compte. Sans la première, la sous-page LMS n’apparaît pas ; sans la seconde, le bloc n’apparaît pas sur cette sous-page.
Configurer une source de contenu externe
Prérequis : les options LMS et Contenu externe sur votre compte. Sans la première, la sous-page LMS n’apparaît pas ; sans la seconde, le bloc n’apparaît pas sur cette sous-page.
Droits nécessaires : l’entrée Configuration du menu s’ouvre avec le droit Modifier la personnalisation. ⚠️ Le droit Éditer / ajouter les intégrations IT, coché sur le profil administrateur et décoché sur le profil adjoint, ne suffit pas à ouvrir ce menu.
Une source décrit un fournisseur : son adresse, sa façon de vous authentifier, et ce qu’il sait renvoyer à la fin. Une fois déclarée, elle sert de point d’ancrage à autant de capsules que vous voulez. Pour les fournisseurs déjà câblés, voyez plutôt Edflex ou Stellia.
Où ajouter une source
Configuration › Intégration › LMS, bloc Configuration de contenu externe, en bas de la page. Le lien Ajouter une nouvelle configuration de contenu externe ouvre le formulaire.
⚠️ Ce n’est pas sur la sous-page Services externes. Cette sous-page voisine porte Slack, Stripe, Lucca et consorts, pas les sources de contenu externe.
Les sources appartiennent au compte, pas à un département. La sous-page LMS n’a d’ailleurs pas de version départementale : sélectionner un département vous renvoie sur une autre page de configuration.
Le formulaire
Nom de la configuration est le seul champ toujours obligatoire. C’est ce nom, et lui seul, qui identifiera la source dans les capsules : deux sources homonymes deviennent impossibles à distinguer.
Authentification commande tout le reste du formulaire. Quatre valeurs, affichées telles quelles, sans traduction :
| Valeur | Champs demandés | Confirmable dès que |
|---|---|---|
| NONE | Type d’affichage, Source, URL, Récupération des résultats | le type d’affichage et la source sont choisis |
| APIKEY | les mêmes, plus Nom de la clé et Valeur de la clé | les deux champs de clé sont remplis |
| LTI | URL, Clé, Secret, Récupération des résultats | l’URL et le secret sont remplis |
| TALENTSOFT | URL seulement | l’URL est remplie |
Source n’a qu’une valeur possible, REST : ce n’est pas un mode d’authentification, c’est le type de source. Type d’affichage en propose trois, Deeplinking, Iframe et Nouvelle fenêtre, et n’apparaît qu’en NONE et en APIKEY.
En NONE, Beedeez construit le lien et l’ouvre. En APIKEY, Beedeez appelle d’abord votre URL avec la clé en en-tête et ouvre le lien que vous renvoyez. En LTI, Beedeez émet un lancement LTI 1.0 signé et transporte l’identité de l’apprenant ; le formulaire ne propose alors aucun choix d’affichage, c’est toujours une iframe. En TALENTSOFT, la source se règle seule sur REST, iframe, sans récupération de résultats.
Dans le champ URL, Beedeez remplace au lancement les marqueurs :userId, :userHashedId, :ownerId, :resourceId et :userExternalId. Le dernier suppose que l’apprenant porte un identifiant externe pour votre compte, sinon le lancement échoue.
⚠️ L’iframe échoue silencieusement chez beaucoup de fournisseurs. Ils refusent d’être affichés dans un cadre, et l’apprenant voit une zone blanche sans message. Testez avant de choisir ce mode.
Confirmer ne suffit pas à enregistrer
Confirmer ferme la modale et range la source dans les modifications en attente de la page. Rien n’est encore envoyé au serveur.
Pour l’enregistrer réellement, cliquez sur Tout sauvegarder, en bas de la colonne de gauche. Ce bouton reste grisé tant qu’aucune modification n’est en attente, et les pages de configuration qui en portent une sont signalées dans cette même colonne.
⚠️ Quitter la page sans cette étape perd la source. Un message vous demande alors de confirmer votre départ ou d’enregistrer.
Récupération des résultats
Ce champ décide si le fournisseur peut dire qu’un apprenant a terminé. Aucune, Url de retour, et Stellia si votre compte a l’option correspondante.
Le réglage porte sur la source, jamais sur une capsule ni sur le compte entier. Toutes les capsules servies par cette source remontent, ou aucune. Tant que vous n’avez pas touché au champ, il reste vide et se comporte comme Aucune.
Sur Url de retour, Beedeez fabrique lui-même l’adresse de rappel et la transmet au fournisseur à chaque lancement : une par apprenant, par capsule et par tentative. Rien à saisir de votre côté, rien à copier depuis le back-office. Le contrat d’appel est décrit dans Faire remonter une complétion depuis un outil tiers.
L’adresse contient un identifiant aléatoire valable 100 jours, réutilisé à chaque relancement de la même tentative. Aucun bouton de l’interface ne permet de l’invalider avant terme.
Le piège
En LTI, l’adresse de rappel part toujours. Le paramètre personnalisé custom_callbackurl est ajouté au lancement même quand Récupération des résultats vaut Aucune. Un fournisseur consciencieux la lira et l’appellera, et recevra un 404 à chaque appel. Rien dans le back-office ne signale ce refus : de votre côté, les capsules restent simplement à zéro.
Si vous partez en LTI et que vous attendez des complétions, réglez Récupération des résultats sur Url de retour dès la création de la source.
Ce que ça ne fait pas
- Aucun test de connexion. L’enregistrement n’appelle jamais le fournisseur. Une URL fausse ne se voit qu’au premier lancement par un apprenant.
- Aucune liste de ressources. Beedeez n’interroge pas le fournisseur pour savoir ce qu’il contient : l’identifiant de chaque ressource se saisit à la main dans la capsule.
- Aucune remontée en APIKEY. Ce mode ne transmet jamais d’adresse de rappel, quelle que soit la valeur de Récupération des résultats.
Une source et les capsules qui s’en servent
Le nombre de sources n’est pas limité. Côté capsule, un contenu externe se branche par deux champs : Configuration, qui liste vos sources par leur nom, et Ressource, l’identifiant du contenu chez le fournisseur.
Modifier une source s’applique immédiatement à toutes les capsules qui la désignent : changer l’URL ou le mode d’authentification les déplace toutes d’un coup. La supprimer les casse toutes de la même façon, et le contenu ne s’ouvre plus. Rien ne vous prévient au moment de la suppression, et aucune liste ne montre quelles capsules dépendent d’une source : tenez ce recensement à part avant de toucher à une source en production.
Pour aller plus loin
- Enrichir vos capsules avec du contenu externe : les façons d’amener du contenu du dehors, et laquelle choisir.
- Faire remonter une complétion depuis un outil tiers : le contrat d’appel derrière Url de retour.
- Intégrer une page ou un outil web (Genially, Klaxoon…) : la voie courte quand le fournisseur ne demande aucune authentification.
- La bibliothèque Edflex dans vos capsules : un connecteur dédié, sans source à déclarer.
- Parcours adaptatif Stellia : le seul cas qui utilise la valeur Stellia de Récupération des résultats.