Vous déposez le .zip dans une activité « Paquetage SCORM » et Moodle répond par un message d'erreur. En anglais, le plus courant est : « Incorrect file package - missing imsmanifest.xml or AICC structure ». Le module, lui, fonctionnait très bien chez le prestataire.
Dans la plupart des cas, le cours n'a rien. C'est l'emballage qui est fautif. Voici les sept causes, de la plus fréquente à la plus rare.
1. Le manifeste n'est pas à la racine du zip
C'est la cause numéro un. Le fichier imsmanifest.xml doit se trouver directement à la racine de l'archive. La documentation de Moodle le dit sans détour : il doit être immédiatement dans le dossier du SCORM, pas dans un dossier à l'intérieur.
L'erreur vient d'un geste banal : on fait un clic droit sur le dossier du cours pour le compresser. Le zip contient alors mon-cours/imsmanifest.xml au lieu de imsmanifest.xml.
Correction. Ouvrez le dossier, sélectionnez tout son contenu, puis compressez la sélection. Ou laissez un outil remonter le contenu à la racine.
2. Le manifeste est mal nommé
Sur un serveur Linux, ce qui est le cas de la plupart des Moodle, IMSmanifest.xml et imsmanifest.xml sont deux fichiers différents. Le nom doit être écrit entièrement en minuscules.
Correction. Renommez le fichier, puis refaites le zip depuis l'intérieur du dossier.
3. Le manifeste est absent
Certains exports ne produisent pas de manifeste : une publication « Web » au lieu de « LMS », un module généré par une IA qui a oublié le fichier, un dossier copié à moitié.
Correction. Republiez au format SCORM depuis l'outil auteur si vous l'avez. Sinon, le manifeste peut être reconstruit : il suffit de connaître la page de lancement du cours et la liste des fichiers.
4. Le manifeste est invalide
Le fichier existe, mais Moodle n'arrive pas à le lire. Les défauts les plus courants :
- une balise mal fermée après une modification à la main ;
- aucune organisation déclarée : le manifeste ne décrit aucun parcours à lancer ;
- des identifiants utilisés deux fois ;
- aucune ressource déclarée comme module suivi (SCO). Dans ce dernier cas, le cours se lance parfois, mais n'enregistre ni progression ni score.
Correction. Reconstruire le manifeste est plus sûr que de le rafistoler ligne à ligne.
5. Le zip contient des fichiers parasites ou des chemins Windows
Une archive créée sur Mac embarque un dossier __MACOSX et des fichiers .DS_Store. Certaines archives créées sous Windows enregistrent les chemins avec des barres obliques inversées (\) au lieu de barres obliques (/). Le LMS ne trouve alors ni les images ni les scripts.
Correction. Supprimez les fichiers système et refaites l'archive avec un outil qui écrit des chemins standards.
6. Des fichiers sont déclarés mais absents
Le manifeste liste des fichiers qui ne sont pas dans le zip. Beaucoup de LMS laissent passer ; les plus stricts refusent l'import. Même quand l'import passe, l'apprenant tombera sur une image manquante ou une page blanche.
Une variante courante : le fichier existe, mais son nom diffère par une majuscule (Logo.PNG au lieu de logo.png). Sur un poste Windows, cela fonctionne. Sur le serveur, non.
Correction. Alignez les noms, ou retirez du manifeste les fichiers qui n'existent plus.
7. Le fichier est trop lourd ou dans la mauvaise version
Deux causes qui ne tiennent pas au package lui-même :
- La taille. Chaque Moodle a une limite d'envoi, fixée par l'administrateur. Un package chargé de vidéos la dépasse vite. Compressez les images, ou demandez un relèvement de la limite.
- La version. La documentation de Moodle indique que SCORM 1.2 est pris en charge et que SCORM 2004 ne l'est pas. Si votre prestataire a publié en SCORM 2004, demandez une publication en 1.2. Le choix entre les deux est détaillé dans SCORM 1.2 ou SCORM 2004.
Le diagnostic en une minute
| Ce que vous observez | Cause probable |
|---|---|
| Message « manifeste manquant » alors que le fichier est là | Manifeste dans un sous-dossier (cause 1) ou mal nommé (cause 2) |
| L'envoi s'interrompt avant tout message | Taille (cause 7) |
| L'import passe, le cours affiche une page blanche | Chemins ou fichiers absents (causes 5 et 6) |
| L'import passe, le cours s'ouvre, rien n'est enregistré | Aucune ressource déclarée comme SCO (cause 4) |
| Le cours fonctionne, la progression se perd | Autre sujet : voir Progression SCORM perdue |
Et sur les autres LMS ?
Les causes 1 à 6 valent pour tout LMS : elles tiennent à la norme, pas à Moodle. Seuls les messages changent. Certains LMS sont plus stricts que Moodle sur les identifiants en double et les fichiers déclarés mais absents. Si vous débutez avec la norme, le guide SCORM du responsable formation pose les bases.
Questions fréquentes
Puis-je corriger le zip sans l'outil auteur ?
Oui pour les sept causes de cette page : elles concernent l'archive et le manifeste, pas le contenu du cours.
Le module marchait sur la plateforme du prestataire. Pourquoi pas chez moi ?
Parce que les LMS n'ont pas la même tolérance. Un serveur Windows ignore les majuscules, un serveur Linux non. Un LMS accepte un manifeste approximatif, un autre le rejette.
Faut-il redemander une livraison au prestataire ?
Pour un manifeste mal placé ou un zip mal fait, la correction prend moins de temps que le courriel.
Réparer sans ouvrir le zip
Déposez le package dans le correcteur SCORM. Le diagnostic classe chaque point en bloquant, risque ou conseil, propose la réparation quand elle est sûre, et vous laisse tester le résultat dans un lecteur qui simule un LMS. C'est gratuit, et l'analyse se fait dans votre navigateur.