Aller au contenu principal
Accueil Brio. Centre d'aide

Utiliser la norme xAPI dans une production multimédia

Qu'est-ce que la norme xAPI et à quoi sert-elle?
Comment paramétrer une production multimédia xAPI?
Conseils avant de rendre votre contenu disponible
Comprendre un fichier de données xAPI

Qu’est-ce que la norme xAPI et à quoi sert-elle? 

xAPI (Experience API) est une norme destinée principalement aux objets d’apprentissage ainsi qu’aux environnements numériques d’apprentissage. Cette norme permet de transférer des métadonnées.

La norme xAPI a pour objectif de générer des traces des actions effectuées par un apprenant dans une production multimédia. Ces traces ou événements, qui peuvent être captés par le code informatique, sont basés sur le principe «Qui fait quoi» (acteur-action-objet). Chaque événement capté enregistre de façon normalisée l’action effectuée sur le contenu par l’apprenant.

L’utilisation de la norme xAPI dans les productions multimédias permet, par exemple, de déterminer: 

  • le moment où un apprenant a débuté le visionnement d'une production multimédia;
  • le moment où un apprenant a terminé de visionner une production multimédia ou si cette action est toujours en cours;
  • le temps qu’a pris un apprenant pour compléter le visionnement d'une production multimédia;
  • le statut global (réussite ou échec) d'une production multimédia et/ou le statut de chacune des réponses d’un questionnaire.

Pour plus d'informations sur xAPI, consultez le site https://xapi.com/ (en anglais).

Comment paramétrer une production multimédia xAPI?

Pour qu'une production multimédia enregistrée avec la norme xAPI fonctionne correctement dans Brio, il faut effectuer certains paramétrages:

  • Publier ou exporter vers un LMS (Learning Management System);
  • Choisir l’option xAPI (parfois nommée Tincan ou API Tincan ou encore eXperience API);
  • Déterminer les paramètres de succès si cela est nécessaire;
  • S’assurer que la formation se complète automatiquement.
    L'événement de fin est généralement déclenché par la production multimédia. Si ce n’est pas le cas, l'événement doit être paramétré (avec une action, une question, une page ou une diapositive) afin de déterminer la complétion de la production multimédia.

Les versions des logiciels énumérés ci-dessous supportent la norme de publication xAPI. Pour plus de détails, consultez leur site de soutien technique.

Conseils avant de rendre votre contenu disponible

1.

Lors du téléversement d'une production multimédia dans Brio, assurez-vous de choisir le bon fichier de démarrage, sans quoi celle-ci ne pourra fonctionner et les données ne seront pas récoltées.

Un fichier de démarrage correspond à la page d'accueil d'une production. En général, le nom du fichier de démarrage se termine par ".html" et contient "index". Il doit être sélectionné pour permettre la consultation de la production.

Pour plus d’information, consultez la procédure Ajouter une production multimédia à partir d'un dossier compressé.

2.

Il est recommandé de tester votre production multimédia à l'aide d'un compte participant pour vous assurer qu'elle enregistre bien les informations souhaitées avant d'ouvrir le site.

Les données xAPI d'une production multimédia ne tiennent compte que des actions posées par les participants. Les tests faits par un formateur ne sont donc pas comptabilisés dans le fichier Excel.

3.

Pour consulter l’avancement des participants dans la production multimédia xAPI, assurez-vous que le panneau affiche trois états (production terminée, commencée et non commencée) et que vous êtes en mesure de télécharger le rapport xAPI. Si ce n’est pas le cas, téléversez à nouveau votre production multimédia. Pour plus d’information, consulter la page Consulter la progression des participants dans une production multimédia.

Avis

Le statut d’avancement des participants pour une production multimédia s’affiche dans les sites de formation créés ou copiés après le 13 avril 2023. Pour activer le suivi d’avancement sur un site créé avant cette date, contactez-nous.

Comprendre un fichier de données xAPI

Un fichier de données xAPI contient les informations détaillées des actions effectuées par les participants dans une production multimédia. Ces données sont générées automatiquement par la production multimédia et non par la plateforme Brio. Pour savoir comment télécharger ce fichier Excel, consultez la page Exporter un rapport des traces xAPI.

En fonction du logiciel utilisé et de la manière dont la production multimédia est configurée, il est possible que certaines informations dans le fichier Excel varient ou soient absentes.

Exemple: certains logiciels ne renvoient pas de durée sur le verbe d’action « answered ».

Chaque ligne du fichier correspond à une action réalisée par un participant sur un élément de la production multimédia. Les éléments peuvent correspondre à différentes parties de la production: un questionnaire, une activité, une section ou même à la production dans son ensemble. 

Tableau descriptif des données xAPI du fichier Excel

Titres des colonnesInformations sur l'action posée par un participant
GroupeNom du groupe du participant.
NomPrénom et nom du participant.
Adresse courrielAdresse courriel du participant.
Action poséeVerbe d'action généré automatiquement par la production multimédia.
DuréeTemps passé sur l’élément donné ou sur la production dans son entier.
Nom de l'activitéNom de l'élément sur lequel l'action a été posée.
Le nom de l’élément peut être configuré manuellement dans le logiciel de création de la production multimédia ou être généré automatiquement.
QuestionQuestion, description, consigne ou texte générique fourni par la production multimédia.
RéponseRéponse ou code alphanumérique (exemple : A) généré par la production multimédia.
SuccèsIndique si la réponse fournie à une question correspond à la valeur paramétrée dans le logiciel de création de la production.
ComplétéIndique si l’élément (exemple : la question, la partie d'activité ou l'activité) est considérée comme complété.
Fichier JSONToutes les données brutes générées par la production multimédia.
Le fichier JSON est utile à des fins d’analyse de la production multimédia par des développeurs, entre autres. Les colonnes du fichier sont produites à partir de certaines de ces données. Des informations additionnelles s’affichent également dans cette colonne.