Documentation
Guide de programmation
Programmation d'un exercice
Méta-Données d'un Exercice

Méta-Données d'un Exercice

Durant le cycle de vie d'un exercice, la plateforme va générer des méta-données pour tracer l'activité de l'apprenant et vous fournir des informations sur l'exercice. Ces méta-données sont utilisables à l'intérieur de tous les scripts de la sandbox (builder, grader, hint.next etc.) et sont accessibles via la variable meta.

Nombre total de tentatives

  • meta.attemps : Le nombre de fois que l'apprenant a essayé de résoudre l'exercice. Seulement les tentatives valides (grade >= 0) sont comptabilisées. Cette valeur est remise à 0 à chaque fois que l'élève choisit de changer la question.
  • meta.totalAttemps : La somme de toutes les tentatives valides. Cette valeur n'est pas remise à 0 à chaque fois que l'élève choisit de changer la question.

La liste des notes obtenues

  • meta.grades : La liste des notes obtenues par l'apprenant de la première à la dernière tentative.
  • meta.grades[0] : La note de la première tentative.
  • meta.grades[meta.grades.length - 1] : La note de la dernière tentative.

Savoir si des aides ont été demandées

  • meta.consumedHints : Le nombre d'aides demandées par l'apprenant. Cette valeur est remise à 0 à chaque fois que l'élève choisit de changer la question.

Savoir si la solution a été affichée

  • meta.showSolution : Un booléen qui indique si l'apprenant a affiché la solution ou non. Cette valeur est remise à false à chaque fois que l'élève choisit de changer la question.

Savoir si l'exercice est la première question de la séance

  • meta.isInitialBuild : Un booléen à true au lancement de l'exercice et défini à false à partir du moment où l'apprenant change de question.

Cas d'usage

En utilisant ces méta-données, vous pouvez par exemple afficher un message d'encouragement à l'apprenant lorsqu'il réussit l'exercice du premier coup, faire des exercices de plus en plus difficiles en fonctions des dernières notes...

Pour afficher le contenu des métadonnées, vous pouvez utiliser le filtre dump de nunjucks à l'intérieur de l'une des clés d'affichage (form, statement etc.). Par exemple : {{ meta | dump(2) }}

⚠️

Les méta-données sont utilisables uniquement en lecture, toute modification de ces données sera ignorée par la plateforme.