Cet article décrit les déclarations xAPI de progression et d'achèvement qu'Udemy Business envoie à un LMS/LXP tiers.
- Pour découvrir comment configurer l'intégration, consultez l'article Intégration du système de gestion de l'apprentissage Udemy Business : xAPI.
Remarque : l'intégration LMS/LXP est disponible uniquement avec l'abonnement Enterprise.
Autorisation
Déclarations prises en charge
Udemy Business enverra les verbes suivants :
Déclarations de cours :
- Événement de progression : suit la progression du participant dans un cours spécifique.
- Événement d'achèvement : enregistre l'achèvement d'un cours par le participant.
Déclarations de parcours d'apprentissage :
- Événement de progression : suit la progression du participant tout au long d'une série de contenus pédagogiques dans un parcours d'apprentissage donné.
- Événement d'achèvement : indique que le participant a terminé tous les contenus pédagogiques dans un parcours d'apprentissage.
Toutes ces déclarations xAPI sont transmises au système LMS/LXP en quasi temps réel au fur et à mesure que les événements se produisent, garantissant des mises à jour opportunes sur les activités et les réalisations des participants.
Notez que les parcours d'apprentissage comprennent divers types de contenu : des cours Udemy, des cours personnalisés, des parties de cours Udemy, des liens vers des articles, des vidéos externes, des podcasts, une page wiki, etc. Pour les comptes disposant d'Udemy Business Pro, il est également possible d'ajouter une évaluation ou un exercice d'application au parcours d'apprentissage.
Acteur/Actrice
Par défaut, l'acteur de la déclaration xAPI est identifié à l'aide de la propriété mbox (c.-à-d. : adresse e-mail). Toutefois, certains systèmes LMS/LXP ne requièrent pas d'adresse e-mail pour l'accès des participants. Par conséquent, l'identification de l'acteur à l'aide d'un objet account (compte) est également prise en charge. Toutefois, pour l'objet account (compte) utilisé comme identifiant, le LMS/LXP doit fournir l'identifiant lmsUserID du participant à Udemy Business dans le cadre de la procédure d'authentification unique. Reportez-vous à cet article du centre d'aide sur la configuration de l'identifiant lmsUserID dans le cadre de l'authentification unique.
Exemple d'acteur identifié à l'aide de l'objet mbox :
Exemple d'acteur identifié à l'aide de l'objet account (compte) :
Liste des LMS/LXP auxquels nous envoyons un objet account (compte) en tant qu'identifiant d'acteur par défaut :
- LMS SumTotal
Pour les LMS/LXP intégrés à Udemy Business par xAPI et non répertoriés ci-dessus, Udemy fournit par défaut l'identifiant mbox.
Verbe
Déclarations de cours
Progressé
La déclaration de progression est utilisée pour indiquer la progression du participant dans un cours. Le calcul de la progression se base sur le rapport entre les sessions terminées et le nombre total de sessions dans le cours. Par exemple, si un cours contient 4 sessions qui durent respectivement 30 minutes, 40 minutes, 50 minutes et 1 heure et que le participant termine la première session, alors la progression indique 25 % (1/4). La durée des sessions n'est pas prise en compte dans le calcul du pourcentage de progression.
Le pourcentage de progression est indiqué dans l'objet result (résultat) avec l'attribut completion (achèvement) défini sur false (faux). Le pourcentage est indiqué sous forme de scaled score (score gradué) entre 0 et 1.
Exemple de déclaration de progression :
Terminé
La déclaration d'achèvement est utilisée pour indiquer l'achèvement du cours par le participant. À l'instar de la déclaration de progression, la déclaration d'achèvement contient un objet result (résultat) avec l'attribut completion (achèvement) défini sur true (vrai). Le scaled score (score gradué) est défini sur 1 pour indiquer un achèvement à 100 %.
Exemple de déclaration d'achèvement :
Déclarations de parcours d'apprentissage
Progressé
La déclaration de progression indique la progression du participant dans un parcours d'apprentissage. La progression est calculée en fonction de la proportion du contenu pédagogique terminé par rapport au nombre total de contenus pédagogiques dans le parcours d'apprentissage. Par exemple, si un parcours d'apprentissage contient 5 cours, 2 liens et 3 parties de cours, et que le participant termine 3 cours et 2 liens, alors la progression est enregistrée à 50 % (5/10). La durée des chaque contenu n'est pas prise en compte dans le calcul du pourcentage de progression.
Le pourcentage de progression est indiqué dans l'objet result (résultat) avec l'attribut completion (achèvement) défini sur false (faux). Le pourcentage représenté dans les objets d'extension est indiqué sous forme de scaled score (score gradué) entre 0 et 100.
Exemple de déclaration de progression :
Terminé
La déclaration d'achèvement est utilisée pour indiquer l'achèvement du parcours d'apprentissage par le participant. À l'instar de la déclaration de progression, la déclaration d'achèvement contient un objet result (résultat) avec l'attribut completion (achèvement) défini sur true (vrai). Le scaled score (score gradué) est défini sur 100 pour indiquer l'achèvement.
Exemple de déclaration d'achèvement :
Contester
Objet de cours
L'objet de la déclaration est de type Cours et l'identifiant de l'activité est défini sur l'URL du cours pour identifier un objet de cours de manière unique. Exemple de cours UB identifié comme un objet :
Objet de parcours d'apprentissage
L'objet de la déclaration est de type Sélection et l'identifiant de l'activité est défini sur l'URL du parcours d'apprentissage pour identifier un objet de parcours d'apprentissage de manière unique. Exemple de parcours d'apprentissage UB identifié comme un objet :
Pour l'intégration LMS/LXP SumTotal, le champ ID commence par les informations du sous-thème de l'entreprise, qui est sumtotaldemo, comme indiqué dans l'exemple suivant.
L'objet de la déclaration est de type Cours et l'identifiant de l'activité est défini sur l'URL du cours pour identifier un objet de cours de manière unique. Exemple de cours Udemy Business identifié comme un objet :
Remarque : pour référencer l'identifiant d'activité de l'objet à partir de la déclaration xAPI pour le cours correspondant dans la charge utile de l'API du cours, un nouvel attribut xapi_activity_id a été ajouté à l'API du cours.
Gestion des erreurs - Logique des nouvelles tentatives
En cas d'échec de l'envoi de l'événement au LMS/LXP, Udemy Business tente de renvoyer deux fois par jour les déclarations ayant échoué, et ce pendant 5 jours.