Dépannage et publication d’une version
Objectifs de formation
Une fois cette unité terminée, vous pourrez :
- Indiquer où vous pouvez vérifier l’intégrité d’une version dans Trailmaker Release
- Expliquer la différence entre une erreur et un avertissement dans Trailmaker Release
- Décrire comment publier du contenu avec Trailmaker Release
Détection des problèmes dans une version
Tout au long des unités de ce module et des modules Concepts de base des sites enablement, Configuration d’un site enablement, Rédaction pour un site enablement et Concepts de base de Trailmaker Content, nous avons exploré la manière dont les créateurs de contenu et les responsables de versions collaborent pour planifier, créer et préparer du contenu pour le site enablement de votre entreprise. Une fois que ces personnes ont eu la possibilité d’examiner le contenu préparé dans l’aperçu de la version sur votre site enablement, le responsable de versions s’assure que le contenu est prêt à être publié.
Selon la taille de votre entreprise, vous pouvez avoir plusieurs rôles contribuant au contenu d’une version, notamment pour les modules, les illustrations de badge, les images et le contenu localisé. Avec toute cette collaboration, il n’est pas surprenant que parfois, des problèmes apparaissent dans votre contenu alors qu’il s’apprête à être publié. Peut-être qu’il manque un module auquel renvoie un parcours, ou peut-être qu’il manque un questionnaire dans une unité, ou peut-être que les attributs d’accessibilité manquent pour une image. Heureusement, un responsable de versions, comme Marisol, dispose d’un outil pour surveiller ces types de problèmes et s’assurer qu’ils sont résolus avant la publication d’une version.
Dans Trailmaker Release, la page de la version affiche une icône d’avertissement et une bannière rouge lorsque la version contient des avertissements ou des erreurs.
Lorsque Marisol clique sur le lien Afficher les erreurs et les avertissements dans la bannière rouge, elle est redirigée vers la page des problèmes de la version. Cette page répartit les problèmes en deux sections : ceux liés à la version et ceux liés au contenu.
Correction des avertissements et des erreurs
Un avertissement est un problème qui affecte la façon dont les apprenants perçoivent votre contenu. Pour offrir à vos apprenants la meilleure expérience, les créateurs de contenu devront probablement résoudre ces problèmes, mais Trailmaker n’empêche pas la publication. Voici quelques exemples d’avertissements :
- Un module contient une image à laquelle le site enablement ne peut pas accéder, car elle est protégée par un pare-feu.
- Une unité contient du codage HTML non pris en charge par Trailmaker Content, ce qui altère la mise en forme du contenu sur votre site enablement.
- Une image ne contient pas de texte Alt, empêchant donc les lecteurs d’écran de décrire l’image aux utilisateurs malvoyants.
La version de Marisol comporte un avertissement : un module, Objectifs commerciaux de Pure Aloe, contient une unité avec du code HTML non valide, car l’une de ses images manque de texte alternatif d’accessibilité.
Une erreur est un problème relatif aux critères techniques pour la publication de contenu, et Trailmaker vous empêche de publier la version. Voici quelques exemples d’erreurs :
- Un module ou un parcours figure dans la liste de la version, mais l’archive de contenu n’a pas été ajoutée à la version.
- Un nom d’API sur la liste de la version est déjà utilisé pour un autre contenu.
La version de Marisol comporte une erreur : le parcours « Des ventes réussies chez Pure Aloe » inclus dans la version n’a pas été chargé. Cela signifie que l’élément de manifeste du parcours a été ajouté à la version, mais que son archive n’a pas été ajoutée à la version de Trailmaker Content.
Voici un autre secret : Trailmaker Content détecte de nombreux problèmes avant que Trailmaker Release ne les signale. Par exemple, si Marisol ajoute un module à une version mais oublie d’inclure un badge ou un questionnaire, Trailmaker Content affiche une fenêtre pour lui faire savoir que ces éléments sont manquants.
Avec ces outils pratiques, Marisol peut identifier et résoudre les problèmes potentiels dans le contenu avant la publication.
Publication de la version
Lorsqu’une version ne signale plus d’erreurs ou d’avertissements, la page de la version affiche une bannière bleue, ce qui indique que la version est prête à être publiée.
Pour publier le contenu, Marisol n’a qu’à cliquer sur Publier sur la page de la version.
Trailmaker affiche ensuite une fenêtre de confirmation, où Marisol a une dernière chance d’annuler ou de poursuivre la publication. La fenêtre de confirmation répertorie le nombre d’éléments en cours de traitement dans la version et confirme qu’aucune erreur ni aucun avertissement ne subsiste.
Nous avons terminé ! En deux clics, Marisol a enfin publié la dernière version de la collection de contenus pour l’équipe commerciale. Les apprenants de l’équipe commercial de Pure Aloe peuvent désormais accéder à tout le nouveau contenu sur lequel Cindy et les autres participants ont créé et géré.
Téléchargement d’archives de contenu publié
Avant que Marisol ne prenne une pause-café bien méritée, elle a encore une tâche à accomplir. Tout au long de ce module, nous avons vu que Marisol et Cindy devaient importer des archives dans leur espace de travail Trailmaker Content local afin de préparer le contenu à la publication.
Rappelez-vous qu’un créateur de contenu tel que Cindy peut télécharger des archives de contenus sur lesquels il travaille dans son espace de travail Trailmaker Content local. Ensuite, il peut soumettre les archives au système de contrôle de versions (VCS) de son entreprise afin que d’autres collaborateurs, comme Marisol, puissent trouver et importer le contenu dans leur espace de travail. Pour un rappel sur ce flux de travail, consultez le module Concepts de base de Trailmaker Content.
Les archives téléchargées à partir de Trailmaker Content reflètent le contenu de l’espace de travail du créateur de contenu, mais pas nécessairement la version du contenu la plus récemment publiée dans une version. D’autres collaborateurs peuvent avoir importé les archives dans leur espace de travail et apporté des modifications avant de publier le contenu.
Pour obtenir des archives qui reflètent la version la plus récente du contenu publié dans une version, Marisol peut les télécharger à partir de la section dédiée au contenu publié dans l’application Trailmaker Release.
Marisol peut enregistrer l’archive dans le système de contrôle de versions de son entreprise afin que d’autres collaborateurs puissent accéder à la version la plus récente du contenu publié. La prochaine fois qu’un créateur de contenu souhaite effectuer des mises à jour, il peut importer cette archive dans son espace de travail Trailmaker Content pour être sûr de travailler à partir de la version la plus récente.
Les membres de l’équipe de Pure Aloe peuvent tous célébrer ensemble le lancement réussi de leur nouveau site enablement, qui repose sur Trailhead.