question.moodle {SARP.moodle}

Créer une question Moodle au format XML

Description

Ces fonctions permettent de créer une question pour Moodle au format XML.

Usage

question.moodle( type = "cloze",
                 titre = "Question...", texte, reponses = NULL,
                 penalite = NA, note = NA, commentaire.global = NA,
                 idnum = NA,
                 autres.codes = NULL,
                 fichier.xml = get( "fichier.xml",
                                    envir = SARP.Moodle.env ) )

debut_question.moodle( type,
                       titre, texte, 
                       penalite = NA, note = NA, 
                       commentaire.global = NA, idnum = NA,
                       fichier.xml = get( "fichier.xml",
                                          envir = SARP.Moodle.env ) )

fin_question.moodle( fichier.xml = get( "fichier.xml",
                                        envir = SARP.Moodle.env ) )

Arguments

texte

Le texte 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. Il correspond à l'élément entre les balises <questiontext> et </questiontext> de la question. C'est le seul argument obligatoire.

type

Le type de question à créer (élément type de la balise <question>). Vecteur contenant une seule chaîne de caractères.

titre

L'intitulé de la question, en HTML. Il correspond à l'élément entre les balises <name> et </name> de la question. Indiquez NULL pour ne pas donner de titre.

reponses

Un vecteur. Chaque élément correspond à une réponse possible, c'est-à-dire à un champ délimité par les balises <answer> et </answer>. Attention, les valeurs de de ce vecteur sont indiquées telles qu'elles dans le fichier XML, sans être protégées : n'utilisez des formats particuliers qu'avec précaution, ou en les protégeant manuellement par une balise <![CDATA[...]]> — ce que font les fonctions de création de question prédéfinies, si nécessaire.

Pour indiquer des commentaires (champs <feedback>), créez un vecteur de chaînes de caractères de même longueur que celui des réponses et associez-le aux réponses comme attribut, de nom commentaire. Utilisez NA pour laisser un commentaire vide.

Par défaut, la première réponse est considérée comme parfaitement correcte (100% de la note) et toutes les autres comme fausses (0%). Pour indiquer des fractions pour chaque note, créez un vecteur numérique de même longueur que le nombre de réponses et associez-le aux réponses comme attribut, de nom fractions.

commentaire.global

Un vecteur de chaînes de caractère, de longueur 1, correspondant au retour à indiquer globalement (champ délimité par les balises <generalfeedback> et </generalfeedback> ). Utilisez NA ou NULL pour ne pas indiquer de commentaire.

note

La note associée à cette question (champ délimité par les balises <defaultgrade> et </defaultgrade> ). Doit être un vecteur numérique avec un seul élément. Utilisez NA pour ne pas indiquer de note.

penalite

La pénalité à utiliser en cas de tentatives multiples, si le premier essai est incorrect (champ délimité par les balises <penalty> et </penalty> ). Doit être un vecteur numérique avec un seul élément. Utilisez NA pour ne pas indiquer de pénalité.

idnum

Un entier qui identifie de façon unique la question. L'unicité s'entend au sein de la catégorie à laquelle appartient la question. SARP.moodle vérifie l'unicité pour la catégorie en cours, mais ne peut évidemment pas vérifier qu'il n'y a pas déjà dans la base des questions avec cet identifiant... Attention, à chaque appel à categorie.moodle, la liste des identifiants est remise à zéro.

autres.codes

Un vecteur de chaînes de caractère, correspondant aux valeurs à donner à des champs optionnels de la question. Ils sont écrits dans l'ordre. Le nom des champs est déterminé à partir du nom des éléments du vecteur.

fichier.xml

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

Details

Cette fonction est la fonction principale, appelée par toutes les autres fonctions de création d'une question Moodle. Les autres fonctions étant d'usage plus simple, n'utilisez cette fonction que pour des cas non-prévus par les fonctions spécialisées.

Value

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

Author(s)

Emmanuel Curis [e-mail]

See Also

numerique.moodle, qcm.moodle qroc.moodle, question_libre.moodle, question_ouverte.moodle, vrai_faux.moodle

Examples

## Not run: 
# Commencer un nouveau questionnaire
q <- debuter_xml.moodle( "exemple.question" )

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

# Une question vrai-faux (en utilisant le type binaire)
reponses <- c( "Vrai", "Faux" )
attr( reponses, "commentaire" ) <- c( "Bravo !", "Elle n'est pas plate" )
attr( reponses, "fractions" ) <- c( 100, 0 )
question.moodle( type  = "truefalse", titre = "Question binaire",
                 texte = "La Terre est ronde", reponses = reponses )

# On termine le questionnaire
finir_xml.moodle( )

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

## End(Not run)