Createxo

Réponses à un exercice

Un exercice OEF peut accepter les réponses des utilisateurs de manière très variée. Outre le choix multiple ou la réponse libre, on trouve de nombreuses autres possibilités. La réponse donnée par l'utilisateur est analysée selon la nature du type. D'autre part, il est possible d'afficher des commentaires ciblés quand la réponse tombe sous une certaine condition (pour avertir d'une erreur typique par exemple). Actuellement, jusqu'à 100 réponses simultanées peuvent être demandées dans un exercice sous l'implémentation actuelle.

La syntaxe est la suivante (les 3 derniers champs sont optionnels) :

\answer{Texte}{\reponse}{type=...}{option=...}{weight=...}

La longueur de Texte est limitée à 40 caractères.

Le paramètre type

Chaque réponse peut prendre indépendamment l'un des types suivants.

Types de base

• Auto (default) détermination automatique de certains types de base.
• Texte brut (raw) la comparaison se fait par des options.
• Nombre (numeric) la comparison se fait numériquement avec une précision fixée.
• Fonction numérique (function) la comparaison se fait numériquement.
• Équation numérique (equation) la comparaison se fait numériquement.
• Expression mathématique (algexp litexp formal) comparaison formelle.
• Texte (case nocase atext) des mots ou des phrases.
• Réponse à choix multiples (checkbox click menu radio mark flashcard multipleclick) .

Types spécifiques ou avancés

• Formule brute d'une molécule (chemformula) en chimie.
• Dessiner une molécule (chemdraw) en chimie.
• Sélectionner des atomes ou des liaisons d'une molécule (chemclick) .
• Équation chimique (chemeq) avec analyse d'équilibre.
• Ensemble de caractères (chset) .
• Objets à glisser-déposer (clickfill dragfill) qui peuvent être du texte, des images.
• Mettre en couleur des pavés (clicktile) .
• Mettre à l'heure une horloge (clock) .
• Composer (compose) en utilisant des composantes fournies.
• Nombre complexe (complex) la comparison se fait numériquement avec une précision fixée.
• Clic sur une image (coord) dans une zone prédéfinie.
• Correspondance (correspond) entre deux listes d'objets.
• Mots croisés (crossword) .
• Déplacement de pièces sur un échiquier (chessgame) .
• Dessin utilisant canvasdraw (draw) permettant des tracés d'un type d'objets (points, droites ...).
• Dessin utilisant canvasdraw (multidraw) permettant des tracés de plusieurs types (points, droites, images, text ...).
• Géométrie dynamique (geogebra) utilisation de l'applet GeoGebra.
• Clic sur des atomes en 3D (jmolclick) nécessite l'applet Jmol.
• Géométrie dynamique (jsxgraph) utilisation de l'applet JSXGraph.
• Dessin utilisant JSXgraph (jsxgraphcurve) permettant des tracés avec des formes prédéfinies ou libres.
• Texte (keyboard) tapé à partir du clavier proposé.
• Matrice numérique (matrix) au sens mathématique ; la comparaison se fait numériquement coefficient par coefficient.
• Nombre rationnel (numexp) la comparison se fait de façon formelle.
• Reconstituer une image (puzzle) présentée comme un puzzle.
• Nombres dans une zone (range) tout ce qui est dans la zone est accepté.
• Mise en ordre (reorder) d'une liste d'objets.
• Ensemble fini (set fset aset) avec une analyse textuelle ou numérique.
• Nombre (sigunits) avec possibilité de demander une unité et un nombre de chiffres significatifs.
• Texte (symtext) outil avancé d'identification de textes.
• Nombre avec unité (units) pour la physique.
• Vecteur (vector) comparaison numérique des composantes.
• Liste de mots (wlist) .
• Mémoire (time) .

Insertion des champs de réponse dans le texte de l'énoncé

Il est possible d'inclure des champs de réponse dans l'énoncé des exercices sous format html par la commande embed. Les réponses et choix doivent être définis de façon habituelle. Des conditions particulières sont indiquées dans la documentation des types de réponses.

• \embed{choice 1} insérer le premier choix multiple dans le texte.
• \embed{reply 2} insérer la deuxième réponse libre dans le texte.
• \embed{reply 1,5} peut avoir plusieurs significations suivant le type de réponse. En général, cela signifie : insérer la première réponse libre avec la taille du champ de réponse égale à 5. Par contre, si le type de reply 1 est parmi checkbox, click, radio, \embed{reply 1,5} insère seulement l'un des choix (le numéro 5 dans ce cas) dans le format correspondant au type. Cela permet l'insertion de choix dans différentes structures de texte (en liste, dans un tableau, ...).

  Attention: Dans le cas du type menu, il faut obligatoirement mettre \embed{reply 1} sans deuxième argument.

• \embed{reply 1,AxBxC} peut avoir plusieurs significations selon le type :
  • dans le cas où le type est clickfill ou dragfill, A et B sont les tailles horizontale et verticale (en pixels) d'une case, et C est le nombre de cases que contient le champ de réponses.
  • dans le cas où le type est correspond, A est la taille verticale des items, B et C sont respectivement la taille horizontale des colonnes de gauche et de droite.
  • Dans le cas de réponses de type texte libre, d'autres lignes peuvent être ajoutées permettant de personnaliser le style du champ de réponses. De plus, si la première ligne supplémentaire est le mot default, le champ aura la classe de style css wims_oef_input : le gestionnaire du site ou l'enseignant peuvent alors le configurer de manière générale. Par exemple, pour le type numeric,

    \embed{reply 1,12
    default}

    ou

    \embed{reply 1,12
    style="font-size:18px;background-color:#e8ffff;border:1px solid #3333CC;"}

• \embed{reply 1,numero, pick_numero} Dans le cas où le type est un choix multiple, insère le choix n°numero dans le texte, mais en lui donnant l'apparence "pick_numero". Typiquement, cela permet d'avoir des choix assez simples (A,B,C), mais dont l'apparence est complexe (formules mathématique par exemple).

  \statement{
  
    
  1:\embed{reply 1,1, \(\frac{1}{2}\)}
    
  2:\embed{reply 1,2, \(\frac{1}{3}\)}
    
  3:\embed{reply 1,3, \(\frac{1}{4}\)}
  
  }
  \answer{}{1;1,2,3}{type=radio}{option=noanalyzeprint}
  

  Dans ce cas, il vaut mieux désactiver pour l'instant l'analyse de la réponse (bogue à corriger) car elle peut être difficilement compréhensible.

  Il ne faut pas mettre la commande \embed dans une balise <p> mais plutôt <div>, l'analyse de la réponse fait par le logiciel pouvant mettre des balises qui ne peuvent pas être incluses dans la balise <p>.

  Le paramètre optionnel weight

  Il permet d'imposer un poids aux questions posées.

  Exemple :

  \answer{}{1}{type=numeric}{weight=8}
  \answer{}{1}{type=numeric}{weight=2}
  

  Le niveau de sévérité sera aussi pris en compte lors du calcul fait et le pourcentage sera pris sur un pourcentage fixé par le niveau de sévérité.

  Il est possible de mettre des variables dans weight dans la mesure où elles sont définies avant le \statement.

  Exemple :

  \text{w = \t = 1 ? 1 : 2}
  \answer{}{1}{type=numeric}{weight=\w}
  \answer{}{1}{type=numeric}{weight=3}
  

  Le paramètre optionnel option

  Dans le cas de plusieurs options, elles sont séparées par des espaces. Par exemple, option=split noanalyzeprint Les options possibles à la suite d'une instruction \answer ou \condition sont
  • option=default="" : L'option default est commune à toutes les réponses libres : cette option peut prendre la forme default="valeur_par_défaut". Si l'utilisateur donne une réponse vide, c'est la valeur_par_défaut qui remplace. Un message d'avertissement s'affiche au moment où la réponse est envoyée que l'on peut supprimer en rajoutant nocheck dans les mots d'option.
  • option=split : Dans le cas d'une réponse dont le type est correspond, checkbox ou mark, la notation tient compte des réponses justes, même si elles ne le sont pas toutes.
  • option=nonstop : Dans le cas d'un exercice à étapes, les questions suivantes sont posées même en cas de réponses fausses.
  • option=noanalyzeprint : Le texte automatique d'analyse de réponses n'est pas affiché. C'est donc à l'auteur de l'exercice de fournir un feedback convenable. Cela est utile dans certains types comme le type mark où le texte automatique est souvent inadéquat. Le score subsiste ainsi que l'indication sur la justesse de la réponse.
  • A la suite d'une instruction condition, option=hide : La condition sera utilisée pour l'analyse de la réponse mais ne sera pas affichée.
  D'autres options sont utilisables dans des types particuliers de réponses. Par exemple, dans les réponses proposant d'écrire dans un champ libre, des symboles peuvent être ajoutés pour faciliter la rédaction sous la forme option=symbols=[liste de symboles] (pas d'espaces dans les symboles). Par exemple

  \answer{}{alpha+2*beta-5}{type=formal}{option=symbols=[alpha beta]}
  

  Pour des précisions sur les autres options, revenir à la documentation du type de réponse.
  

  Nom	Option
  algexp	symbols=" "
  aset	symbols=" "
  atext	symbols=" "
  case	noreaccent symbols=" "
  checkbox	color=" " eqweight nolegend shuffle show sort split nolabel
  chemdraw	help image=" " match=" " svg allH onlyheteroH
  chemeq	symbols=" "
  chemformula	symbols=" " order=no or hill or [list of some atoms] latex
  chessgame	color=" " nogoodprint
  chset	norepeat symbols=" "
  click	eqweight multiple nolegend shuffle sort split detag nolabel
  clickfill	align=" " noorder transparent
  clock	button=" " clocktype=" " init=" "
  complex	absolute comma j precision symbols=" "
  compose	linkword=" " shuffle
  coord	feedback=" "
  correspond	split
  crossword	allhelp color=" " tooltip
  dragfill	align=" " noorder transparent
  draw	color=" " precision=" " eqweight split default="empty"
  equation	eqsign=yes symbols=" "
  flashcard	color=" " eqweight nolegend shuffle show sort split nolabel
  formal	symbols=" "
  fset	symbols=" "
  function	integer symbols=" "
  jmolclick	eqweight split
  jsxgraph	precision=" " color1=" " color2=" "
  jsxgraphcurve	color1=" " color2=" " precision=" "
  keyboard	keyboard=" "
  litexp	symbols=" "
  mark	color=" " eqweight nolegend shuffle show sort split nolabel
  matrix	split_coeff split_column split_row
  menu	eqweight multiple nolegend shuffle sort split detag nolabel
  multidraw	color=" " eqweight split default="empty"
  multipleclick	color=" " eqweight nolegend shuffle show sort split nolabel
  nocase	noreaccent symbols=" "
  numeric	absolute comma nolegend symbols=" "
  numexp	noreduction symbols=" "
  puzzle	text
  radio	eqweight multiple nolegend shuffle sort split detag nolabel
  range	symbols=" "
  raw	symbols=" "
  set	distinct_inputs repeat symbols=" "
  symtext	symbols=" "
  vector	symbols=" "

  Les tests de conditions

  Dans certaines circonstances, il est souhaitable que les réponses libres soient testées par des conditions spéciales (questions avec plusieurs bonnes réponses, exercices demandant des exemples, réponses déterminées par des inégalités, etc). Ceci peut être réalisé de la façon suivante.

  Si la bonne réponse à une question libre est une variable non définie auparavant, la réponse à cette question sera stockée dans cette variable. Cette variable peut ensuite être utilisée pour implémenter des conditions de test. Le score de l'exercice est alors calculé selon le nombre de conditions de test qui sont satisfaites, au lieu du nombre de réponses qui coïncident avec les bonnes réponses.

  Jusqu'à 10 conditions simultanées peuvent être définies dans un exercice, sous l'implémentation actuelle. Seules les réponses numériques peuvent être ainsi testées. La syntaxe est (le dernier champ est optionnel)

  \condition{texte d'affichage}{conditions de test}{weight=...}
  

  Voici quelques exemples de conditions de test (\rep1 et \rep2 sont des variables non définies qui apparaissent dans des définitions de réponses libres, comme décrit ci-dessus.) Liste complète des relations

  
  

  Condition	signification
  \rep1>=0 and \rep1<=1	Bon si rep1 est dans l'intervalle [0,1].
  \rep1=1 or \rep1=3 or \rep1=5	Bon si rep1 est 1, 3 ou 5.
  (\rep1)*(\rep2)=6 and (\rep1)+(\rep2)=5	Bon si rep1 et rep2 sont les deux racines du polynôme x2-5x+6.
  sin(\rep1)=0	Bon si rep1 est un multiple de .

  
  Voir aide sur le format oef pour la syntaxe de définition des réponses.

  ---

  Cette page n'est pas dans son apparence habituelle parce que WIMS n'a pas pu reconnaître votre navigateur web.
  Afin de tester le navigateur que vous utilisez, veuillez taper le mot wims ici : puis appuyez sur ``Entrer''.

  Veuillez noter que les pages WIMS sont générées interactivement; elles ne sont pas des fichiers HTML ordinaires. Elles doivent être utilisées interactivement EN LIGNE. Il est inutile pour vous de les ramasser par un programme robot.