myTrailhead リリースの作成

学習の目的

この単元を完了すると、次のことができるようになります。

  • リリースとは何かを説明する。
  • 項目を作成してリリースに追加する。
  • リリースの操作について説明する。
  • リリースのさまざまな状況で実行可能なアクションについて説明する。
  • リリースを公開すると myTrailhead がどのように変化するかを説明する。

はじめに

Pure Aloe 社は、アロエベラを原料とするモイスチャーローションとクリームを生産しています。製品が市場で大きな成功を収めていることから、同社は急速に成長しています。Pure Aloe では、すべての従業員が成功を収めるために必要なスキルを習得できるようにしたいと考えています。そこで、myTrailhead にサインアップしました。 

Pure Aloe の myTrailhead チームは、同社のスタッフのみを対象としたコンテンツを作成して公開しています。具体的には、モジュール、つまり、特定のスキルやトピックについて詳しく説明する単元別のコンテンツを作成します。そして、類似性のあるモジュールをまとめたトレイルという、関連トピックのガイド付き学習パスも作成しています。

Marisol は、Pure Aloe の myTrailhead リリースマネージャで、同社の myTrailhead の公開フローを取りまとめています。Marisol の業務に欠かせないのが Trailmaker Release アプリケーションです。Trailmaker Release を使用して、Marisol は Pure Aloe の myTrailhead コンテンツリリースを作成、管理、公開しています。 

リリースとは?

リリースとは基本的に、myTrailhead チームが公開予定のモジュールやトレイルのリストです。Marisol はリリースを使用して、次のことを行うことができます。

  • コンテンツを更新/挿入する。つまり、新しいコンテンツを公開するか、既存のコンテンツを更新します。
  • 公開済みコンテンツをアーカイブする。
  • 以前にアーカイブしたコンテンツを復元する。

myTrailhead コンテンツの公開においてリリースは極めて重要です。モジュールまたはトレイルがリリースにリストされていない場合は公開できません。

このモジュールでは、あなたが myTrailhead リリースマネージャで、myTrailhead リリースを作成して管理する適切な権限を有することを前提としています。上記に該当しない場合でも、このまま読み進めれば、リリースマネージャがどのようにして業務を遂行しているのかを学ぶことができます。ただし、myTrailhead は Trailhead Playground で使用できないため、記載の手順を Trailhead Playground で実行することはできません。

リリースの作成

まず何よりも、Marisol はどのようにしてリリースを作成しているのでしょうか? 

  1. myTrailhead にログインして、自身の名前の横にあるアバターをクリックし、[Trailmaker] を選択します。
  2. ナビゲーションバーで、[Releases (リリース)] をクリックします。
  3. 名前空間ページで、[New Release (新規リリース)] をクリックします。

Trailmaker Release の名前空間ページ。[New Release (新規リリース)] ボタンが示されています。

  1. リリースの名前を入力します (ここでは「July Jellybean」とします)。このタイトルに基づいて Trailmaker Release がリリースの API 参照名を生成しますが、Marisol が必要に応じて変更できます。
  2. [Create (作成)] をクリックします。

Trailmaker Release の [Create a release (リリースの作成)] 画面

簡単でしょう。

項目のリリースへの追加

Marisol がリリースを作成した後でモジュールやトレイルをリストに追加する場合、2 通りのオプションがあります。項目を個別に追加することも可能ですが、項目数が多い場合には、.csv ファイルをアップロードする方法でも追加できます。 

たとえば、Pure Aloe の myTrailhead ライターである Cindy からコンテンツが送信されてくる予定になっている場合、Marisol は個々の項目をリリースに追加することができます。あるいは、更新する 20 以上の項目がリストされた .csv ファイルをアップロードすることもできます。

Cindy も項目をリリースに追加できます。Cindy の場合は、Trailmaker Content からモジュールまたはトレイルをリリースにアップロードすると、項目が自動的にリリースリストに追加されます (ただし、コンテンツがまだリストにない場合に限ります)。このプロセスについての詳細は、「Trailmaker Content の基本」を参照してください。 

個別の項目のリリースへの追加

Marisol が項目を個別にリリースに追加する場合は、Trailmaker Release で作成したリリースに移動します。 

1.リリースページで、[Add Content (コンテンツの追加)] をクリックします。

2.追加するモジュールまたはトレイルの API 参照名を入力します。この場合は、「pure-aloe-sales-goals」と入力します。

3.コンテンツタイプを選択します。この場合は、[Module (モジュール)] です。

4.操作を選択します。ここでは、[Upsert (更新/挿入)] を選択します。

5.別のモジュール (またはトレイル) も個別に追加する場合は、[Add (追加)] をクリックします。他に追加するものがない場合は、[Save (保存)] をクリックします。

Trailmaker Release の [Add to release (リリースへの追加)] 画面。リリースに追加する個別の項目が示されています。

複数の項目をリリースに同時に追加

Marisol が複数の項目をリリースに一度に追加する場合は、追加する各項目の API 参照名が必要です。API 参照名とは、特定のコンテンツを指す一意の ID です。Cindy がモジュールまたはトレイルを作成すると、そのコンテンツのタイトルに基づいて Trailmaker Content が API 参照名を生成します。myTrailhead では、各モジュールやトレイルの API 参照名が、コンテンツの URL の最後のフラッシュの後に示されます。

Marisol が API 参照名を確認したら、.csv ファイルに、api_name、type、operation を列ヘッダーとするテーブルを作成します。このテーブルに、リリースに追加するモジュールとトレイルをリストします。次に例を示します。

api_name
type
operation
pure-aloe-sales-goals
module
upsert
sell-well-at-pure-aloe
trail
upsert
navigate-your-pure-aloe-career
trail
upsert
pure-aloe-sales-challenges
module
archive
pure-aloe-annual-meeting-prep
module
restore

続いて、Trailmaker Release のリリースページに移動します。 

1.リリースページで、[Add Content (コンテンツの追加)] をクリックします。

2.[Import (インポート)] をクリックします。

Trailmaker Release の [Add to release (リリースに追加)] 画面。.csv ファイルから複数の項目をリリースに追加する [Import (インポート)] ボタンが示されています。

3..csv ファイルに移動して選択し、[Open (開く)] をクリックします。.csv ファイルの全項目が、[Add to release (リリースに追加)] 画面に表示されます。

Trailmaker Release の [Add to release (リリースに追加)] 画面。アップロードした .csv ファイルからリリースに追加された複数の項目が示されています。

4.[Save (保存)] をクリックします。

どちらの場合も、Marisol が行っていることは、リリースリストをコンパイルすることです。新規コンテンツまたは修正済みコンテンツの更新/挿入プロセスを完了するためには、Cindy が Trailmaker Content からコンテンツをアップロードする必要があります。

リリースの操作

リリースリストの各項目に、次の 3 種類の操作のいずれかを指定します。Marisol は各項目をリリースリストに追加するときに、操作を選択しています。

  • Upsert (更新/挿入) - 新しいコンテンツを myTrailhead に追加するか、既存のコンテンツを更新する。
  • Archive (アーカイブ) - 公開済みコンテンツが myTrailhead に表示されないようにする。
  • Restore (復元) - アーカイブ済みコンテンツを再び表示する。

リリースページに、リリースの項目ごとに選択した操作が表示されます。

Trailmaker Release のリリースページ。リリースの各項目に選択された操作が示されています。

Marisol が公開するほとんどは、新しいコンテンツか、既存のコンテンツへの修正です。そのため大半は、[Upsert (更新/挿入)] が選択されます(Cindy が Trailmaker Content のコンテンツをリリースに追加した場合は、デフォルトで操作が [Upsert (更新/挿入)] に設定されます)。

時として、会社のプロセスが変更された場合などにコンテンツが古くなることがあります。Marisol が古くなったコンテンツを myTrailhead から削除する場合は、[Archive (アーカイブ)] を選択します(Trailblazer がアーカイブされたモジュールのバッチを獲得している場合、そのバッチは維持されます)。

場合によっては、アーカイブされたコンテンツが再び必要になることがあります。たとえば、Pure Aloe の営業担当を対象に年次総会に向けた準備事項について説明するモジュールです。Marisol は毎年総会の終了後にこのモジュールをアーカイブしています。そして、次の年次総会の数週間前に、[Restore (復元)] を選択して復活させます。

リリースの状況とその意味

リリースに、ライター、バッジデザイナー、ローカライゼーションマネージャなどの複数の担当者が関与することがあります。Marisol はコンテンツのフローを管理し、どのコンテンツがいつ公開されるのかを掌握しています。こうしたフローをスムーズに進行させる目的で、Marisol はリリースの状況を設定しています。

リリースには次の 3 つの状況のいずれかが設定されます。

  • オープン
  • ロック済み
  • 公開済み

リリースの状況がオープンまたはロック済みの場合は、Marisol がこの 2 つの状況を切り替えることができます。

Trailmaker Release のリリースページ。[Status (状況)] 選択リストが示されています。

オープンリリース

状況がオープンのリリースは、Marisol がそのリリースに項目を追加したり、Cindy がそのリリースにコンテンツをアップロードしたりすることができます。Pure Aloe のローカライゼーションマネージャも同じです。そして、各人がコンテンツをプレビューモードで表示できます(プレビューモードでは、ユーザが myTrailhead に未公開コンテンツを表示して、コンテンツの校正、画像のサイズや読みやすさのチェック、テストの試行などを行うことができます)。

では、Marisol がリリースを公開する準備ができた時点で、Cindy がまだモジュールの 1 つを作業している場合にはどうなるのでしょうか? リリースの状況がオープンであれば、Marisol がそのモジュールを今回のリリースから削除し、次回のリリースに追加することが考えられます。Cindy がモジュールの作業を終えたときに、Trailmaker Content を使用して次回のリリースにアップロードできます。

ロック済みリリース

ロック済み状況は、公開の準備ができているコンテンツのみがリリースに含まれていることを Marisol が確認する場合に役立ちます。リリースの状況がロック済みの場合、引き続きユーザがリリース内のコンテンツをプレビューすることはできますが、誰もそのリリースにコンテンツを追加することができません。Marisol はリリースの公開準備を整えるときに、念のために状況をロック済みに変更します。

公開済みリリース

Marisol がリリースを公開すると、その状況が公開済みに永久的に変更されます。公開済みコンテンツを変更する必要がある場合は (誤字の訂正など)、Cindy が修正済みコンテンツを新しいリリースに追加し、Marisol が修正済みバージョンを公開します。

リリースが公開されたときの myTrailhead の変化

Marisol がリリースを作成した時点で、Trailmaker Release がバックグラウンドで myTrailhead に既存の全コンテンツの複製を作成し、予備として保持しています。そして、Cindy が新規コンテンツと修正済みコンテンツをこのリリースに追加します。Marisol がリリースを公開すると、Trailmaker Release が myTrailhead の全コンテンツを、このリリースの内容で上書きします。つまり、Trailmaker Release が複製したコンテンツを再公開し、さらに新規コンテンツと修正済みコンテンツを公開するということです。

リリースが公開されたときに、Marisol が選択した操作に応じて、myTrailhead がどのように変化するのかの例を次に示します。

コンテンツの変更
選択した操作
公開された結果
新規モジュールをリリースに追加
更新/挿入
新規モジュールが myTrailhead に表示される。
既存のモジュールを新しい情報で更新して、そのモジュールをリリースに追加
更新/挿入
新しい情報で更新したモジュールが myTrailhead に表示される。
既存のモジュールをリリースに追加
アーカイブ
モジュールが myTrailhead に表示されなくなる (ユーザがそのモジュールのバッチを獲得している場合、そのバッチは維持される)。
アーカイブ済みモジュールをリリースに追加
復元
モジュールが myTrailhead に再び表示される。
モジュールから単元を削除し、そのモジュールをリリースに追加
更新/挿入
モジュールは引き続き myTrailhead に表示されるが、削除済み単元が表示されなくなる。

次の単元では、Marisol が Trailmaker Release を使用してリリースを管理します。

リソース