debuter_xml.moodle {SARP.moodle}

Commencer et terminer un questionnaire Moodle

Description

Ces deux fonctions permettent de commencer et de terminer la génération d'un questionnaire Moodle au format XML.

Usage

debuter_xml.moodle( fichier.xml,
                    n.chiffres = 2, dec = ",",
                    racine = 2004197487,
                    glossaire = FALSE )

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

Arguments

fichier.xml

Pour debuter_xml.moodle, le nom du fichier qui contiendra le questionnaire moodle au format XML. L'extension .xml est automatiquement rajoutée, sauf si elle est déjà présente dans ce nom.

Pour finir_xml.moodle, le fichier correspondant au questionnaire à terminer (par défaut, le dernier créé).

dec

Le séparateur décimal à utiliser dans les textes. Par défaut, la virgule (comme utilisé en français). Il est modifié par options.

n.chiffres

Le nombre de décimales à utiliser pour les sorties au format XML. Attention, cela n'affecte que les valeurs numériques explicitement converties en texte par un appel à la fonction afficher_nombre.moodle.

racine

La racine (graine) à utiliser pour le générateur de nombres aléatoires, afin d'avoir une génération de questionnaires reproductible. Utilisez NA pour ne pas définir la graine.

glossaire

Si TRUE, le fichier XML créé est au format permettant de construire un glossaire. Sinon, c'est le format XML moodle « classique » qui est utilisé.

Details

Lorsque l'on débute un questionnaire avec debuter_xml.moodle, le fichier XML est créé avec son en-tête. Le descripteur de fichier est mémorisé dans l'environnement de la bibliothèque : toutes les fonctions ultérieures utiliseront ce fichier par défaut pour écrire les questions créées. Attention, en cas d'appels multiples pour travailler sur plusieurs questionnaires en parallèle, seul le dernier fichier créé est mémorisé.

Value

La fonction debuter_xml.moodle renvoie un descripteur de fichier correspondant au questionnaire nouvellement créé. Ce descripteur peut être utilisé par toutes les fonctions de la bibliothèque, mais aussi par la fonction cat de R directement, si nécessaire.

La fonction finir_xml.moodle ne renvoie rien.

Author(s)

Emmanuel Curis [e-mail]

See Also

options( OutDec ) pour le choix du séparateur décimal à l'affichage.

Examples

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

# Une question Moodle basique
vrai_faux.moodle( "Cette question a deux réponses" )

# On termine le questionnaire
finir_xml.moodle( )

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

## End(Not run)