SARP.moodle (version 1.2.3)

qcm.moodle: Créer une question à choix (réponse unique ou réponses multiples)

Description

Cette fonction permet de créer une question de type QCM ou QCU, dans laquelle la ou les bonnes réponses sont à cocher dans une liste de réponses prédéfinie.

Usage

qcm.moodle( texte, bonnes.reponses, mauvaises.reponses,
            commentaires = NULL, fractions = list( "Bonnes" = NULL, "Fausses" = NULL ),
            unique = ( length( bonnes.reponses ) == 1 ), melanger = TRUE,
            titre = "QCM...",
            numerotation = c( "none", "abc", "ABCD", "123" ),
            fichier.xml = get( "fichier.xml", envir = SARP.Moodle.env ),
            commentaire.global = NA, penalite = NA, note.question = NA,
            idnum = NA,
            temps, instructions = TRUE, tags = NULL, internat = FALSE )

Value

Aucune valeur n'est renvoyée par cette fonction.

Arguments

texte

L'énoncé de la question (une chaîne de caractères). Cet énoncé peut contenir n'importe quel caractère (codage en UTF-8) et n'importe quelles balises HTML.

bonnes.reponses

Un vecteur de chaînes de caractères correspondant aux intitulés des bonnes réponses. Il doit y avoir au moins une bonne réponse.

mauvaises.reponses

Un vecteur de chaînes de caractères correspondant aux intitulés des mauvaises réponses.

commentaires

Un vecteur de chaînes de caractères, correspondant au retour à indiquer pour chacune des réponses, dans l'ordre dans lequel elles sont passées, en commençant par les bonnes réponses. Utilisez NA pour laisser un commentaire vide.

fractions

Une liste de deux éléments, contenant les pourcentage de note associés à chaque réponse. Ces deux éléments doivent être intitulés Bonnes (pour les bonnes réponses) et Fausses (pour les mauvaises réponses) ; s'ils sont indiqués, ce doivent être des vecteurs numériques ayant le même nombre d'éléments que la liste des réponses. Par défaut (si l'élément vaut NULL), chaque bonne réponse est affectée de la même fraction de note, de sorte que l'on atteigne 100 % en cochant toutes les bonnes réponses. De la même façon, les mauvaises réponses sont affectées d'une fraction négative de sorte que cocher toutes les mauvaises réponses annule le fait de cocher toutes les bonnes réponses, sans donner une note négative.

Les fractions doivent être comprises entre 0 (exclus) et 100 pour les bonnes réponses ; elles doivent être négatives pour les mauvaises réponses. Si ce n'est pas le cas, ou si la somme des fractions des bonnes réponse ne vaut pas 100, un avertissement est donné, mais la question est tout de même créée. Toutefois, si toutes les fractions des mauvaises réponses sont positives, elles sont considérées négatives sans avertissement.

unique

Si TRUE, indique que l'on ne peut cocher qu'une seule bonne réponse.

melanger

Si TRUE, indique que l'ordre des réponses doit être choisi aléatoirement à chaque affichage de la question. Sinon, l'ordre est celui défini dans le fichier. Actuellement, cela correspond à l'ensemble des bonnes réponses dans l'ordre indiqué, suivi de l'ensemble des mauvaises réponses dans l'ordre indiqué.

titre

L'intitulé de la question, en HTML.

numerotation

Le type de numérotation à utiliser pour les différentes réponses. Ces numéros sont ajoutés par Moodle lors de l'affichage de la question. Seules les quatre valeurs indiquées sont reconnues par Moodle. Vous pouvez abréger en n'utilisant que la première lettre.

fichier.xml

Le fichier correspondant au questionnaire qui contiendra cette question (par défaut, le dernier créé).

commentaire.global, penalite, note.question, idnum, tags

Options communes à toutes les questions Moodle, voyez debut_question.moodle.

temps

Le temps conseillé pour répondre à la question, en minutes.

instructions

Faut-il afficher, avant les réponses possibles, le texte générique de Moodle rappelant les instructions (typiquement, “Veuillez choisir au moins une réponse”)? (Oui si TRUE, non si FALSE).

internat

Par défaut, le QCM créé est un QCM Moodle classique (type multichoice). Si TRUE, génère un QCM avec notation similaire à celle du concours de l'internat en pharmacie (notation en fonction du nombre de discordances entre les cases cochées et ce qu'il aurait fallu cocher ou non). Attention, ce type (sngmultichoice) ne fonctionnera que si le plugin moodle approprié est installé.

Author

Emmanuel Curis

Details

La question générée avec cette fonction est une question de type multichoice (sauf si internat = TRUE, elle est alors de type sngmultichoice, qui nécessite un plugin additionnel).

Cette fonction est une interface simplifiée pour la fonction question.moodle.

See Also

numerique.moodle, qroc.moodle, question_ouverte.moodle, vrai_faux.moodle

Examples

if (FALSE) {
# Commencer un nouveau questionnaire
q <- debuter_xml.moodle( "exemple.QCM" )

# Catégorie : exemples
categorie.moodle( "Exemples SARP/QCM" )

# Le format par défaut, avec deux bonnes réponses et trois mauvaises,
qcm.moodle( "Quels sont les fruits de la liste ci-dessous ?",
            c( "Orange", "Tomate" ), c( "Pomme de terre", "Carotte", "Navet" ) )

# Deux bonnes réponses, deux mauvaises réponses, avec commentaires
#   et fractions inégales
qcm.moodle( "Indiquez les romanciers de la liste ci-dessous.",
            c( "Eugène SUE", "Alexandre DUMAS" ),
            c( "Labiche", "Ronsard" ),
            commentaires = c( "Bravo !", NA,
                 "C'est un auteur de pièces de théâtre", "C'est un poète" ),
            fractions = list( "Bonnes"  = c( 75, 25 ),
                              "Fausses" = c( -50, -100 ) ) )

# On termine le questionnaire
finir_xml.moodle( )

# Importez le fichier exemple.QCM.xml dans Moodle pour voir le résultat...
print(
"Importez le fichier exemple.QCM.xml dans Moodle pour voir le résultat..." )
}