Transformez vos Documents Google en Quiz d’Évaluation Interactifs : Un Guide Technique Pas à Pas avec Google Apps Script

Problématique

Dans un contexte d’examen ou évaluation générale de formation, vous avez élaboré un questionnaire d’évaluation à choix multiple. Votre questionnaire compte plus de 75 questions, vous trouvez fastidieux de recopier manuellement chaque question et option de réponses dans Google Forms, saviez-vous qu’il existe une méthode pour automatiser ce processus ?
C’est la problématique que nous avons essayé de répondre pour faciliter la production des Quiz d’évaluation interactives pour les enseignants de tous les établissements de l’Université de Yaoundé 1.

Cet article vous guide pas à pas pour transformer votre document Google Docs en un quiz interactif et auto-correctif grâce à Google Apps Script.

Pourquoi utiliser Google Forms pour vos quiz ?

Google Forms est un outil puissant et gratuit pour créer des quiz et des sondages. Il offre de nombreux avantages :

Facilité d’utilisation : Son interface intuitive permet de créer des questions de différents types (choix multiple, cases à cocher, etc.) sans compétences techniques avancées.
Correction automatique : En activant le mode « Quiz », vous pouvez définir les réponses correctes et attribuer des points, permettant une correction automatique des évaluations.
Collecte et analyse des résultats : Les réponses sont automatiquement enregistrées dans une feuille de calcul Google Sheets, facilitant l’analyse des performances.
Personnalisation : Vous pouvez personnaliser l’apparence de votre quiz avec des thèmes, des images et des sections.

Automatiser la création de quiz à partir d’un Google Doc : Le pouvoir de Google Apps Script

Si vous avez un document Google Docs bien structuré contenant vos questions, options, réponses correctes et même des explications, Google Apps Script peut vous faire gagner un temps précieux en automatisant la création de votre quiz dans Google Forms.

Prérequis :

Un compte Google avec accès à Google Drive (Google Docs et Google Forms).
Un minimum de familiarité avec l’interface Google Apps Script (aucune expérience en programmation n’est strictement nécessaire, mais un certain confort avec l’informatique est utile).
Un document Google Docs formaté de manière claire et cohérente pour vos questions de quiz.

Format de votre document Google Docs : La Clé du Succès

Pour que le script fonctionne correctement, votre document Google Docs doit suivre une structure précise. Voici un exemple du modèle utilisé:

Règles de formatage :

Chaque question doit commencer par Question N :, où N est le numéro de la question.
Le texte de la question suit sur la ligne suivante.
Les options de réponse doivent être précédées d’une lettre majuscule (A, B, C, D, et parfois E) suivie d’un point (.).
La réponse correcte doit être marquée par (Correct) à la fin de l’option.
Une explication (feedback) pour la question doit suivre après les options, précédée du mot Explication sur une nouvelle ligne.

Développement du Script Google Apps Script : Étape par Étape

1. Ouvrez l’éditeur Google Apps Script.

Dans le menu de votre document, cliquez sur « Extensions » > « Apps Script ».

2. Fonction Principale et Accès au Document :

Le script commence par définir une fonction nommée creerQuizDepuisDocument(). C’est cette fonction qui sera exécutée. Les lignes suivantes permettent d’accéder au document Google Docs actif et à son contenu.

function creerQuizDepuisDoc() {
//Recuper l'ID du document
	var numid = DocumentApp.getActiveDocument().getId();
	// Ouvre le document Google Doc à partir de son ID
	var doc = DocumentApp.openById(numid);
	var contenu = doc.getBody().getText();
	// ... le reste du code ...
}

3. Création du Formulaire et Activation du Quiz :

Ensuite, nous créons un nouveau formulaire Google et activons le mode quiz pour permettre la notation et le feedback.

const form = FormApp.create(doc.getName());
form.setIsQuiz(true);
form.setCollectEmail(true); // Collecter les adresses e-mail (facultatif)

4. Découper le texte en différentes questions :

Nous utiliserons la fonction split pour découper le texte en tableau de questions suivant le formatage.

var questions = contenu.split(/\n(?=Question \d+ :)/);

5. Traitement de chaque Question :

Ayant déjà découpé le texte en tableau de question, il suffit de prendre chaque question et effectuer le traitement. Une question est constituée de deux sections. La première porte sur la question elle-même, la seconde porte sur l’explication.
– Séparation des deux sections:

// Sépare chaque question de son explication
var sections = questionTexte.trim().split(/Explication\n/);
var explication = sections[1] ? sections[1].trim() : '';

– Traitement de la question:
La question est constituée de 3 parties, à savoir l’indicateur de question qui est représenté par “Question X:”, la question elle-même et les options de réponse. Seules les deux dernières parties sont importantes pour notre formulaire. Il sera donc question de fractionner en ligne pour éliminer l’indicateur de question et de constituer la question et les options de réponses.

// Fractionne en lignes pour isoler et supprimer "Question X :"
var lignes = sections[0].split('\n');
lignes.shift(); // Supprime la ligne "Question X :"
var titreQuestion = lignes.shift().trim(); // Récupère la vraie question
var optionsTexte = lignes.join('\n');

6. Identifier les Options de Réponse

Nous recherchons ensuite les lignes qui commencent par une lettre (A-E) suivie d’un point pour identifier les options de réponse. Nous vérifions également si l’option est marquée comme correcte.

// Parcourt chaque option de réponse pour déterminer les bonnes réponses
optionsTexte.split('\n').forEach(function(option){
	// Supprime les lettres (A., B., etc.) devant les options
	var opt = option.replace(/^[A-Z]\.\s*/, '').trim();
	if(opt){
		var estCorrect = opt.includes('(correct)') || opt.includes('(Correct)');
		opt = opt.replace(/\(correct\)|\(Correct\)/, '').trim();
		choix.push(opt);
		if (estCorrect) bonnesReponses.push(opt);
	}
});

7. Traitement des options de réponse et l’ajout au formulaire :

En premier lieu, il sera question de savoir si c’est une question à réponse multiple ou unique. La connaissance de cela nous permet de déterminer l’élément approprié pour notre formulaire (Multiple Choice ou Checkbox). Le reste consiste à ajouter chaque option dans notre élément (item) et indiquer si c’est la bonne réponse ou non. À la fin de l’ajout des options, nous configurons la question en mode quiz.

// Vérifie s'il y a plusieurs bonnes réponses ou une seule
if (bonnesReponses.length > 1) {
	// Question à choix multiples
	item = form.addCheckboxItem().setTitle(titreQuestion);
	item.setChoices(choix.map(function(choixTexte){
		return item.createChoice(choixTexte, bonnesReponses.includes(choixTexte));
		}));
} else {
	// Question à choix unique
	item = form.addMultipleChoiceItem().setTitle(titreQuestion);
	item.setChoices(choix.map(function(choixTexte){
		return item.createChoice(choixTexte, choixTexte === bonnesReponses[0]);
		}));
}
// Configure la question en mode quiz
item.setPoints(1);
item.setRequired(true);

8. Traitement de l’Explication (feedback) :

Sachant que nous avons déjà notre section Explication, il suffit juste de l’ajouter à l’Item. Nous avons opté de mettre l’explication à la fois quand la réponse est correcte ou non. De mon expérience d’enseignant, beaucoup d’étudiant cochent souvent au hasard lorsqu’ils n’ont pas d’idée de réponse. Etant dans une logique pédagogique, notre souci premier est que chacun puisse comprendre la réponse à travers l’explication.

// Ajoute l'explication comme feedback après chaque réponse
if (explication) {
	var feedback = FormApp.createFeedback().setText(explication).build();
	item.setFeedbackForCorrect(feedback)
.	setFeedbackForIncorrect(feedback);
}

9. Code Final Complet :

Le code final est disponible à ce lien https://github.com/tlcyprien/doc2quiz

Exécution du Script :

Sauvegardez le script.
Assurez-vous que la fonction creerQuizDepuisDoc est sélectionnée.
Cliquez sur l’icône d’exécution (le triangle « Play »).
Autorisez le script si nécessaire.

Accéder à Votre Nouveau Formulaire Google:

Une fois l’exécution terminée, un nouveau formulaire Google sera créé dans votre Google Drive.

Vérification et configuration de votre quiz :

Ouvrez le formulaire créé et vérifiez les questions, les options, les réponses correctes et le feedback. Vous pouvez également ajuster les points et d’autres paramètres du formulaire.

Conclusion : Un Outil Puissant à Votre Portée

Avec ce guide détaillé, vous pouvez désormais créer vos propres quiz interactifs à partir de documents Google Docs en utilisant la puissance de Google Apps Script. Ce processus vous fera gagner du temps et vous permettra de vous concentrer sur la qualité de votre contenu d’évaluation.
Pour les enseignants de l’Université de Yaoundé 1 qui découvrent cette solution, connectez vous avec votre compte institutionnel sur Google Workspace, faites la recherche de l’application Doc2Quiz sur Google Workspace Marketplace.

N’oubliez pas de partager votre retour d’expérience avec nous.
PS: en exécutant cette application ou script, vous devez vous même cocher la réponse juste pour la première question. Le reste est correct. Ceci vous amènera à suivre notre recommandation de vérification du formulaire si ça résout exactement votre problème.