Suivez votre progression
Accueil Trailhead
Accueil Trailhead

Création d’une version myTrailhead

Objectifs de formation

Une fois cette unité terminée, vous pourrez :

  • Décrire ce qu’est une version
  • Créer et ajouter des éléments à une version
  • Expliquer les opérations de publication d’une version
  • Décrire les actions possibles selon le statut de la version
  • Expliquer les changements opérés dans myTrailhead lorsque vous publiez une version

Introduction

La société Pure Aloe crée des crèmes hydratantes à base d’aloe vera. Grâce au brillant succès de ses produits sur le marché, l’entreprise se développe rapidement. Pure Aloe veut s’assurer que tous ses employés peuvent acquérir les compétences dont ils ont besoin pour réussir. Pure Aloe s’est donc inscrite sur myTrailhead. 

L’équipe myTrailhead de Pure Aloe crée et publie du contenu destiné aux membres du personnel de l’entreprise. Elle crée des modules, c’est-à-dire des contenus courts qui portent sur une compétence ou un sujet en particulier. Elle crée également des parcours, c’est-à-dire des ensembles de modules abordant des sujets semblables, organisés en parcours d’apprentissage guidés couvrant un sujet plus large.

Marisol est la responsable de version myTrailhead chez Pure Aloe. Elle supervise le flux de publication myTrailhead de l’entreprise. Dans son travail, elle utilise l’application Trailmaker Release. Grâce à celle-ci, elle crée, gère et publie les versions de contenu myTrailhead de Pure Aloe. 

Qu’est-ce qu’une version ?

Pour le dire simplement, une version est une liste de modules et de parcours que l’équipe myTrailhead prévoit de publier. Avec une version, Marisol peut :

  • Upsert du contenu, c’est-à-dire publier un nouveau contenu ou mettre à jour un contenu existant
  • Archiver du contenu publié
  • Restaurer du contenu auparavant archivé

Les versions sont essentielles à la publication du contenu myTrailhead. Si un module ou un parcours ne figure pas dans une version, il ne peut pas être publié.

Ce module s’adresse en priorité aux responsables de version myTrailhead disposant des autorisations adéquates pour créer et gérer des versions myTrailhead. Si ce n’est pas votre cas, vous pouvez continuer votre lecture pour apprendre comment votre responsable de version travaille. Cependant, vous ne pourrez pas suivre les étapes dans un Trailhead Playground, car myTrailhead n’est pas disponible dans les Trailhead Playgrounds.

Création d’une version

Commençons par le début. Comment Marisol crée-t-elle une version ? 

  1. Marisol se connecte à myTrailhead, clique sur l’avatar situé en regard de son nom, puis sélectionne Trailmaker.
  2. Dans la barre de navigation, elle clique sur Versions.
  3. Sur la page d’espace de noms, elle clique sur Nouvelle version.

Page d’espace de noms dans Trailmaker Release affichant le bouton Nouvelle version

  1. Elle saisit le nom de la version, par exemple Juillet Dragée. Trailmaker Release génère le nom d’API de la version en fonction du titre, mais Marisol peut le modifier ultérieurement, si elle le souhaite.
  2. Elle clique sur Créer.

Écran Création d’une version dans Trailmaker Release

Rien de sorcier.

Ajout d’éléments à une version

Une fois qu’elle a créé une version, Marisol a deux possibilités pour ajouter des modules et des parcours à la liste. Elle peut ajouter ces éléments individuellement ou, si elle dispose d’une longue liste d’éléments, elle peut charger un fichier .csv. 

Par exemple, Marisol peut ajouter des éléments un par un à une version, dans l’attente du contenu que lui enverra Cindy, la rédactrice myTrailhead de Pure Aloe. Elle peut également charger un fichier .csv qui répertorie au moins 20 éléments à mettre à jour.

Cindy peut aussi ajouter des éléments à une version. Lorsqu’elle charge un module ou un parcours dans une version depuis Trailmaker Content, elle ajoute automatiquement l’élément à la liste de la version, si le contenu n’y figure pas encore. Pour en savoir plus sur ce processus, consultez Concepts de base de Trailmaker Content

Ajout d’éléments individuels à une version

Pour ajouter des éléments un par un à une version, Marisol accède à la version qu’elle a créée dans Trailmaker Release. 

1. Sur la page de la version, elle clique sur Ajouter du contenu.

2. Elle saisit le nom d’API du module ou du parcours qu’elle ajoute. Par exemple : objectifs-vente-pure-aloe.

3. Elle sélectionne le type de contenu. Par exemple : Module.

4. Elle choisit l’opération. Par exemple : Upsert.

5. Pour ajouter individuellement un autre module (ou parcours), elle clique sur Ajouter. Autrement, elle clique sur Enregistrer.

Écran Ajouter à la version dans Trailmaker Release affichant un élément individuel à ajouter à la version

Ajout simultané de plusieurs éléments à une version

Pour ajouter plusieurs éléments à une version en une seule fois, Marisol a besoin du nom d’API de chaque élément qu’elle souhaite ajouter. Un nom d’API est un identifiant unique qui renvoie vers un élément de contenu. Lorsque Cindy crée un module ou un parcours, Trailmaker Content crée son nom d’API en fonction de son titre. Sur myTrailhead, le nom d’API de chaque module et chaque parcours apparaît dans l’URL du contenu, après la dernière barre oblique.

Une fois qu’elle dispose des noms d’API, Marisol crée un tableau dans un fichier .csv avec comme en-têtes de colonne nom_api, type et opération. Dans ce tableau, elle répertorie chaque module et parcours qu’elle souhaite ajouter à la version. Par exemple :

nom_api
type
opération
objectifs-vente-pure-aloe
module
upsert
ventes-reussies-chez-pure-aloe
parcours
upsert
gestion-carriere-chez-pure-aloe
parcours
upsert
defis-vente-pure-aloe
module
archive
prepa-reunion-annuelle-pure-aloe
module
restaurer

Elle se rend ensuite sur la page de la version dans Trailmaker Release. 

1. Sur la page de la version, elle clique sur Ajouter du contenu.

2. Elle clique sur Importer.

Écran Ajouter à la version dans Trailmaker Release affichant le bouton Importer, qui permet d’ajouter plusieurs éléments à la version à partir d’un fichier .csv.

3. Elle accède à son fichier .csv, le sélectionne et clique sur Ouvrir. Tous les éléments de son fichier .csv apparaissent sur l’écran Ajouter à la version.

Écran Ajouter à la version dans Trailmaker Release affichant plusieurs éléments ajoutés à la version à partir d’un fichier .csv chargé

4. Elle clique sur Enregistrer.

Dans les deux cas, Marisol compile la liste de la version. Pour achever le processus d’upsert du contenu nouvellement créé ou modifié, Cindy doit encore charger le contenu depuis Trailmaker Content.

Opérations de publication de la version

Chaque élément de la liste de la version comporte l’une des trois opérations suivantes. Marisol sélectionne l’opération lorsqu’elle ajoute chaque élément à la liste de la version.

  • Upsert permet d’ajouter du nouveau contenu à myTrailhead ou de mettre à jour le contenu existant.
  • Archiver permet de masquer du contenu publié de myTrailhead.
  • Restaurer permet de réafficher du contenu archivé qui avait été masqué.

L’opération sélectionnée pour chaque élément de la version apparaît sur la page de la version.

Page de la version dans Trailmaker Release affichant l’opération sélectionnée pour chaque élément de la version.

La plupart du temps, Marisol publie de nouveaux contenus ou corrige des contenus existants. Elle sélectionne donc en général Upsert (lorsque Cindy ajoute du contenu à une version depuis Trailmaker Content, l’opération est définie par défaut sur Upsert).

Parfois, du contenu devient obsolète, par exemple en cas de changement des processus de l’entreprise. Pour supprimer du contenu obsolète de myTrailhead, Marisol sélectionne Archiver (cependant, tout Trailblazer ayant gagné le badge associé à un module archivé peut le conserver).

Parfois, le contenu archivé redevient pertinent, par exemple, les modules qui aident les commerciaux de Pure Aloe à se préparer pour leur réunion annuelle. Marisol archive ces modules après chaque réunion annuelle. Dans les semaines précédant la réunion annuelle suivante, elle les réaffiche en sélectionnant Restaurer.

Statuts de la version et leur signification

Plusieurs acteurs peuvent contribuer à une version, par exemple le rédacteur, l’illustrateur des badges et le responsable de la localisation. Marisol maîtrise le flux de contenus et détermine quel contenu est publié à quel moment. Le statut de la version l’aide à maîtriser ce flux.

Une version peut avoir trois statuts distincts :

  • Ouvert
  • Verrouillé
  • Publié

Marisol peut modifier le statut d’une version et le définir sur Ouvert ou Verrouillé.

Page de la version dans Trailmaker Release affichant la liste de sélection du Statut

Versions ouvertes

Lorsque le statut d’une version est Ouvert, Marisol peut y ajouter des éléments et Cindy peut y charger du contenu. Il en va de même pour le responsable de la localisation de Pure Aloe. Par ailleurs, ils peuvent tous voir le contenu en mode d’aperçu (en mode d’aperçu, les utilisateurs peuvent afficher le contenu non publié sur myTrailhead ; ils peuvent alors relire le contenu, vérifier les dimensions et la lisibilité des images et tester les questionnaires).

Cependant, que se passe-t-il si Marisol est prête à publier une version alors que Cindy travaille toujours sur l’un des modules ? Lorsque le statut de la version est Ouvert, Marisol peut supprimer le module de cette version et l’ajouter à la suivante. Une fois que Cindy a fini de travailler sur le module, elle peut utiliser Trailmaker Content pour le charger dans la version suivante.

Versions verrouillées

Le statut Verrouillé permet à Marisol de veiller à ce qu’une version ne contienne que du contenu prêt à être publié. Lorsque le statut d’une version est Verrouillé, les utilisateurs peuvent encore prévisualiser le contenu de la version, mais personne ne peut ajouter de contenu. Quand Marisol se prépare à publier une version, elle change le statut en Verrouillé, par sécurité.

Versions publiées

Une fois que Marisol a publié une version, son statut bascule sur Publié et ce, de manière irréversible. Si le contenu publié doit être modifié, par exemple pour corriger des erreurs, Cindy ajoute le contenu corrigé à une nouvelle version et Marisol publie la version corrigée.

Quels sont les changements apportés à myTrailhead lors de la publication d’une version ?

Quand Marisol crée une version, Trailmaker Release crée une copie en arrière-plan de tout le contenu existant de myTrailhead et le garde de côté. Cindy ajoute ensuite son contenu nouvellement créé ou révisé à la version. Lorsque Marisol publie la version, Trailmaker Release écrase l’intégralité du contenu de myTrailhead avec celui de cette version. En d’autres termes, Trailmaker Release republie le contenu dupliqué et publie le contenu nouvellement créé ou révisé.

Voici quelques exemples de changements opérés sur myTrailhead en fonction de l’opération sélectionnée par Marisol.

Changements de contenu
Opération sélectionnée
Résultat publié
Ajout d’un nouveau module à une version
Upsert
Le nouveau module apparaît sur myTrailhead
Mise à jour d’un module existant avec de nouvelles informations et ajout de ce module à une version
Upsert
Le module mis à jour avec les nouvelles informations apparaît sur myTrailhead
Ajout d’un module existant à une version
Archiver
Le module disparaît de myTrailhead (mais les utilisateurs qui ont obtenu le badge associé à ce module peuvent le conserver)
Ajout d’un module archivé à une version
Restaurer
Le module réapparaît sur myTrailhead
Suppression d’une unité d’un module et ajout de ce module à une version
Upsert
Le module reste sur myTrailhead, mais l’unité supprimée disparaît

Dans l’unité suivante, Marisol utilise Trailmaker Release pour gérer ses versions.

Ressources