Concevoir un parcours de l'Académie

Les parcours de l'Académie se conçoivent dans Académie > Conception des parcours (/academy/admin), réservé aux administrateurs et au groupe Administrateurs de l'Académie.

Créer un parcours

Nouveau parcours (/academy/admin/new) demande :

• un code : minuscules, chiffres et tirets (par exemple service-desk-v4). Il apparaît dans l'adresse du parcours et ne change plus ;
• un nom dans au moins une des langues actives.

Le parcours est créé avec une première version en brouillon, invisible des apprenants.

Régler la version

La page d'une version (/academy/admin/versions/{id}) réunit ses réglages et ses étapes. Seul un brouillon se modifie.

• Nom et description : une saisie par langue active ; une langue laissée vide affiche la langue de l'instance.
• Version du produit : la version majeure visée, en texte libre (par exemple V4).
• Public autorisé : les groupes qui voient le parcours dans leur catalogue. Aucun groupe coché : tout utilisateur connecté.
• Certification préparée : l'intitulé de la certification que le parcours prépare, facultatif. Elle est délivrée par la réussite de l'examen du parcours. Réglez sa validité en mois (24 par défaut) ou cochez N'expire pas pour une attestation, le groupe accordé aux certifiés tant que la certification est valide, et, pour un parcours de mise à jour, le parcours dont il prolonge la certification.
• Certification exigée pour s'inscrire : un autre parcours dont la certification valide est un prérequis.
• Ordre strict des étapes : activé par défaut, une étape obligatoire non réussie verrouille les suivantes.
• Relancer après (jours sans activité) : un apprenant inscrit qui n'avance plus reçoit un rappel, une fois par période sans activité. Vide : le réglage de l'instance (14 jours) ; 0 : aucune relance.

Les étapes

Ajouter une étape propose quatre natures :

• Leçon : un article de la base de connaissances, lu dans l'Académie sans être copié. Recherchez un article publié par son titre, ou saisissez la clé de la documentation livrée (par exemple tima/tickets/creer-un-ticket) : la clé reste valable quand la documentation est réimportée. Un parcours peut citer un article réservé (une catégorie lue par certains groupes seulement, ou une base interne) : ses apprenants inscrits le lisent quand même, captures d'écran comprises, depuis l'Académie. Seul l'article de l'étape leur est ouvert : le même article ouvert depuis la base de connaissances, et les autres articles vers lesquels il renvoie, restent soumis aux droits habituels. Un article dépublié n'est jamais affiché, et les apprenants perdent cet accès si le parcours est retiré du catalogue ou s'ils sortent de son public. Vous ne pouvez citer qu'un article qui existe et que vous pouvez lire vous-même, même pour une étape facultative : la recherche ne propose que ceux-là, et un article introuvable ou que vous ne lisez pas est refusé à l'enregistrement de l'étape comme à la publication. Si la clé de la documentation existe dans plusieurs bases, elle est refusée comme ambiguë : choisissez l'article dans la liste, il est alors cité par son identifiant (une clé saisie en plus est ignorée). À la publication, l'article vérifié est figé : les apprenants lisent celui-là, et s'il disparaît, la leçon est indisponible jusqu'à la publication d'une nouvelle version. Un parcours promu par un GOLIVE est publié sans tenir compte des droits de lecture de l'opérateur ; ses articles doivent seulement exister sans ambiguïté.
• Quiz : un formulaire de nature « quiz ». Sans module de quiz disponible, l'étape reste indisponible pour les apprenants.
• Travaux pratiques : une mission (un article de la base de connaissances, choisi comme pour une leçon) et des vérifications. Choisissez l'instance vérifiée : l'instance de l'apprenant (il déclare son adresse et une clé d'API de lab), son bac à sable personnel, ou aucune si l'étape n'a que des corrections humaines.
• Examen : le quiz d'examen (un formulaire « quiz », passé en mode examen : jamais les bonnes réponses) puis, si vous en ajoutez sur la page de l'étape, des labs d'examen (vérifications comme pour des travaux pratiques, avec une mission facultative) à réussir dans un délai en jours (7 par défaut). Un seul examen par version. La page avertit quand le vivier de questions du quiz d'examen compte moins de trois fois le nombre de questions tirées : les questions se répéteraient d'une tentative à l'autre.

Une étape peut être facultative. Les flèches changent l'ordre des étapes, le crayon ouvre l'étape (/academy/admin/steps/{id}) et la corbeille la supprime. La liste signale un article ou un quiz introuvable ou non publié.

Les vérifications des travaux pratiques

Une fois l'étape enregistrée, ouvrez-la (crayon) : la section Vérifications des travaux pratiques liste ses vérifications et Ajouter une vérification en crée une. L'étape est réussie quand toutes passent. Trois natures :

• Appel de l'API : une route de l'API v1 de l'instance, appelée en lecture (/api/v1/…), et une condition sur la réponse — le code HTTP, l'élément existe, la valeur d'un champ (égal, différent, au moins, au plus…) ou le nombre d'éléments d'une liste. Le chemin désigne ce qu'on contrôle : items, items[0].name, ou items[code=SUPPORT_N2].members (le premier élément dont le champ vaut la valeur). Exemple : « un groupe SUPPORT_N2 existe et compte au moins 2 membres ». Aucun code n'est jamais envoyé à l'instance.
• Vérification fournie : proposée par un module ou par votre produit (par exemple « l'instance a activé sa licence de lab »), avec ses éventuels paramètres (nom=valeur, un par ligne).
• Correction humaine : l'apprenant dépose un livrable selon vos consignes ; un correcteur le valide ou le refuse.

Pour chaque vérification, rédigez un libellé et, pour les vérifications automatiques, une aide affichée en cas d'échec : elle oriente l'apprenant sans lui donner la solution.

Corriger les livrables

Les correcteurs (groupe Correcteurs de l'Académie) trouvent les livrables dans Académie > Corrections des labs (/academy/review) : parcours, étape, apprenant, consignes et note de l'apprenant, fichier à télécharger. Valider ou Refuser (un refus exige un commentaire, que l'apprenant lit). Personne ne corrige son propre livrable.

Publier

Publier met la version au catalogue. La publication est refusée tant que la version n'a pas de nom, d'étape obligatoire, ou qu'une étape est incomplète (leçon sans article, quiz sans formulaire, travaux pratiques sans mission ni vérification, ou avec des vérifications automatiques mais sans instance vérifiée) ; le message liste les points à corriger.

Si une version était déjà publiée, elle est archivée : elle n'accepte plus d'inscription, mais les apprenants qui la suivent continuent sur elle. Ils sont invités à passer à la nouvelle version, en gardant les étapes réussies qui n'ont pas changé.

Faire évoluer un parcours

Une version publiée ou archivée ne se modifie plus. Nouvelle version crée un brouillon recopié de la dernière version ; les étapes recopiées gardent leur identité, ce qui permet de conserver la réussite d'un apprenant qui migre.

Retirer du catalogue archive la version publiée : le parcours disparaît du catalogue, les inscriptions en cours continuent.

Un parcours conçu sur une instance de recette passe en production par le GOLIVE (type « Parcours de formation ») : la version publiée y devient une nouvelle version publiée, avec ses quiz et ses articles. Les inscriptions et la progression ne voyagent jamais, et un parcours que la production a retiré du catalogue n'y est pas republié.

Certifications et examens

Le bouton Certifications de la liste des parcours (/academy/admin/certifications) présente les certifications délivrées : numéro, apprenant, organisation au jour de la délivrance, dates et état, avec un filtre par état. Le PDF de chacune se télécharge ici. Révoquer demande un motif et est définitif : la certification passe à l'état révoqué et le groupe accordé est retiré. Le bouton Examens (/academy/admin/exams) liste toutes les tentatives d'examen : apprenant, date, durée, score du quiz, langue et issue. Il n'y a pas de surveillance des examens : leur valeur vient des labs pratiques et du tirage des questions.

Tableau de bord

Le bouton Tableau de bord de la liste des parcours (/academy/admin/dashboard) donne les totaux — inscriptions, parcours terminés (et leur taux), certifications valides —, puis le détail par parcours et par organisation. Par organisation sur la ligne d'un parcours restreint le second tableau à ce parcours. L'organisation est celle de l'apprenant au jour de son inscription (ou de la délivrance, pour une certification) ; les apprenants sans organisation sont regroupés sous Sans organisation.

Bacs à sable des apprenants

Le bouton Bacs à sable de la liste des parcours (/academy/admin/sandboxes) présente le bac à sable de chaque apprenant : parcours, état (et message d'erreur du fournisseur), dernière visite, date et motif de suppression prévue. Supprimer supprime un bac à sable tout de suite, sans préavis : l'apprenant perd tout ce qu'il y a fait. Afficher les supprimés ajoute l'historique.

Les bacs à sable sont créés par un fournisseur installé avec votre produit. Sans fournisseur, la page l'indique et les travaux pratiques sur bac à sable sont indisponibles.