Script Python permettant de lire des maquettes de formation dans un fichier Excel (ou csv/texte) et de les convertir dans le format JSON utilisé par la fonction d'importation de maquettes de Pégase. Données injectables dans cette version :
- Descripteurs des objets de maquette
- Les champs Enquêtes
- Les champs Syllabus
Il est également possible de préciser si un objet est un PIA.
Note
Testé sur ODF R26
Précision sur la fonction d'import de maquettes de Pégase : cette dernière ne permet pas la mise à jour d'objets déjà présents dans l'environnement où se fait l'import, les objets déjà présents dans Pégase sont simplement pris en lieu et place de ceux décrits dans l'Excel d'import.
maquettes-xl2json.py fichier_excel ou répertoire- Il est possible de spécifier plusieurs noms de fichiers à la suite, qui seront traités successivement.
- Il est également possible de spécifier un ou plusieurs répertoires : dans ce cas, chacun d'eux sera parcouru récursivement et tout Excel trouvé sera traité.
Tip
Pour déterminer les onglets à traiter dans un fichier Excel, on ajoute la liste des onglets (séparés par :) après le nom du fichier.
Par exemple maquettes-xl2json.py ma_maquette.xlsx:2:3:5 pour traiter les onglets 2, 3 et 5.
- Si aucun onglet n'est indiqué, c'est le 1er onglet de l'Excel est traité
- Si on a juste
:derrière le nom de fichier, tous les onglets sont traités - On peut aussi spécifier un nom d'onglet ou un début de nom : les onglets commençant par ce nom seront tous analysés
Par ailleurs, la commande peut contenir les paramètres suivants :
| Option | Description |
|---|---|
| -a | Affiche un message d'aide |
| -n | Spécifie la liste des maquettes à renvoyer au format JSON (séparées par des virgules). Si l'option n'est pas présente, toutes les racines (ie les noeuds de maquette sans parents) sont renvoyées |
| -b | Convertit chaque maquette du flux de sortie en base64 |
| -l | Libellés non obligatoires (un libellé type sera généré automatiquement pour l'import) |
| -d | Affiche des messages d'information pour suivre le déroulé de l'execution de la commande |
| -g | Vérifie que les objets de type GROUPEMENT ont bien une plage de choix spécifiée, le script échoue si ce n'est pas le cas |
| -c | Utilitaire : renvoie la liste des codes trouvés en entrée (fichiers Excel, textes ou entrée standard) |
Le format Excel des maquettes est flexible. Les colonnes attendues obligatoirement sont :
- La colonne Type objet
- La colonne Code objet
- La colonne Libellé (celle-ci pouvant être rendue optionnelle via l'option de commande -l)
Toutes les autres colonnes sont optionnelles.
Par ailleurs, l'ordre des colonnes n'est pas figé et d'autres colonnes (commentaires, formules, zones de validation, bref tout ce qu'Excel sait si bien faire) peuvent être insérées là où cela vous est nécessaire. La seule contrainte est de garder le bon entête de colonne (le libellé sur fond bleu dans la maquette type).
En chaînant le script maquettes-xl2json.py avec le script d'upload vers Pégase maquettes-upload.py, on obtient une fonctionnalité d'upload direct de maquettes au format Excel vers Pégase.
Par exemple :
maquettes-xl2json.py maquette-type.xslx | maquettes-upload.py inalco BAS ESPACE-TESTpour téléverser dans Pégase la maquette du fichier maquette-type.xlsx vers l'instance bac à sable (BAS) de l'Inalco, dans l'espace de travail ESPACE-TEST.