Les éléments inclus dans le fichier tar.gz lors d'un export de cours
L'export d'un cours génère automatiquement une archive .tar.gz qui contient l'ensemble de votre cours.
Il n'est pas possible de faire un export partiel.
Tout ce qui relève de l'architecture et du contenu du cours est inclus dans l'archive. Tout ce qui relève des données utilisateurs (inscriptions, résultats au quiz, forum...) est exclu.
Pourquoi faire un import/export ?
Vous permet de :
Effectuer une sauvegarde.
Préserver une copie du cours à un stade donné.
Éditer directement le code XML.
Partager votre cours avec d'autres membres de l'équipe pédagogique.
Quels sont les éléments pris en compte dans un import/export ?
Éléments inclus dans l'archive (remplacent ceux sur la plateforme lors d'un import) | Éléments non inclus dans l'archive (non remplacés à l'import) |
Toutes les valeurs entrées dans les paramètres avancés | Les données utilisateurs (inscriptions, traces, réponses aux quiz) |
La structure de votre cours : sections, sous-sections, unités, composants, structure du forum (mais pas les contenus) dates et droits associés | Le contenu des forums, mails, et discussions |
Les dates et détails | Les membres de l'équipe pédagogique |
Les paramétrages des activités, exercices, quiz, problèmes | Les réponses et résultats aux évaluations |
Les paramètres avancés, dont le paramétrage de contenus externes introduits par module LTI, les activités paramétrées en langage MATLAB, la synchronisation des clefs API | |
Les annonces | |
Les fichiers et uploads |
Quand faire un import/export ?
Régulièrement, au moment de la création du MOOC et avant chaque modification que vous pressentez majeure (utilisation de composants avancés de type formules mathématiques ou nécessitant de modifier du code XML, CSS). Après la fin du cours, pour en conserver une copie.
Comment exporter votre cours depuis le Studio
L'export d'un cours se fait côté Studio (https://studio.fun-mooc.fr).
Onglet Outils > Exporter puis cliquer sur le bouton bleu "Exporter le contenu du cours".
Ne pas fermer la page tant que le téléchargement du fichier n'a pas commencé.
Vous obtenez un fichier compressé au format .tar.gz. à conserver en sauvegarde et pour un import ultérieur si nécessaire.
L'affichage peut varier selon votre navigateur.
Importer l'archive dans votre cours
Avant toute manipulation, vérifiez bien que vous vous situez dans le bon cours car cette action est irréversible.
Ouvrez le studio (https://studio.fun-mooc.fr).
Dans votre cours qui a été créé par l'équipe FUN, allez dans l'onglet Outils > Importer > Cliquez sur le bouton vert "Choisissez un fichier à importer".
Dans la fenêtre de navigation de votre ordinateur (l'apparence peut varier), choisissez le fichier .tar.gz que vous avez exporté.
Dans le studio de la production, cliquez sur "Remplacer mon cours avec celui ci-dessus".
L'opération est irréversible.
Pendant le chargement, veuillez ne pas fermer la fenêtre de votre navigateur. Vous pouvez suivre la progression du chargement :
Une fois le cours bien importé, le message s'affiche en vert et vous pouvez visualiser votre cours en cliquant sur le bouton bleu "Visualiser le plan mis à jour" :
Dans quel cas un import peut mal se passer, et que faire ?
Avant tout import, et avant/après de grosses modifications, nous vous suggérons d'exporter votre cours pour en faire une sauvegarde (conserver dans des dossiers distincts les exports des différents cours que vous gérez). Ainsi, en cas de problème technique ou d'erreur de manipulation, vous pourrez vous appuyer sur la dernière archive sauvegardée.
Cas 1 : disparition de contenu
Exemple, vous avez travaillé certains contenus sur deux instances Open edX. Vous importez votre cours de votre plateforme Open edX dédiée vers la plateforme FUN, sans avoir mis à jour le contenu de votre plateforme pour qu'il tienne compte des modifications faites sur FUN. Après import sur FUN, vous avez donc des contenus qui ont disparu.
Le cas est plus critique pour un quiz que pour une annonce ou la modification d'une ressource pédagogique. En effet, dans les quiz, si les apprenants ont déjà répondu, leurs résultats disparaîtraient de leur page de progression.
Si vous avez une sauvegarde valide de votre cours sous forme d'archive, vous pouvez la réimporter, alors les quiz réapparaîtront et les apprenants retrouveront les quiz et leurs notes.
Si, en revanche, vous n'aviez pas fait de sauvegarde de votre cours et que ni votre plateforme, ni votre cours sur FUN ne sont à jour, vous serez obligés de recréer les contenus manquants qui seront considérés par la plateforme comme de nouvelles activités. Les apprenants devront alors refaire les quiz. Il faudra donc les informer de l'incident et du fait qu'ils doivent répondre à nouveau aux quiz.
Bonnes pratiques pour éviter ce problème :
Faire des sauvegardes de votre cours avant/après chaque modification importante, comme expliqué plus haut.
Vous assurer que le contenu sur votre plateforme est bien à jour avant d'y apporter des modifications supplémentaires.
Bien savoir où vous avez travaillé / savoir quelle version est la plus à jour.
Cas 2 : contenus publiés passés en brouillon
Vous finalisez votre contenu sur votre plateforme, toutes les dates sont bonnes, toutes les modifications sont publiées, toutes les sections et sous-sections apparaissent en vert. Après l'import vers FUN-MOOC, vous constatez que certaines sections sont en brouillon (« non-publiées ») alors que vous les aviez publiées sur votre plateforme avant l’import.
La plateforme est prudente et conserve les brouillons lorsqu'on tente de les remplacer par une version publiée. Les brouillons que vous trouverez en production sont ceux de la version précédente de votre cours avant import.
Si vous publiez ces brouillons, vous republierez l'ancienne version de FUN et écraserez la nouvelle version que vous venez d'importer.
Pour forcer l’affichage de la version contenue dans l’archive d’export, il faut cliquer sur « Supprimer les changements » sur la page concepteur.
Le mieux restant de s’assurer qu’il n’y a pas de brouillons non désirés dans le cours qui va être écrasé lors de l’opération.
Réflexes à adopter pour éviter ces problèmes
Faire des sauvegardes de votre cours avant/après chaque modification importante, comme expliqué plus haut.
Vous assurer que le contenu sur votre plateforme est bien à jour.
Vous assurer que les sections et sous-sections sont bien publiées sur votre plateforme avant d'exporter votre archive.
Vous assurer que du côté de la plateforme FUN, il n'y a pas de contenus en brouillons avant de procéder à l'import de votre plateforme vers FUN-MOOC.
Une fois l’import réalisé, vérifier que le plan du cours est correct : la bonne reprise des dates et des statuts de publication, en comparant les deux versions qui doivent donc être à l'identique.