リリースをトラブルシューティングして公開する

学習の目的

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

Trailmaker Release でリリースの健全性を確認できる場所について説明する。
Trailmaker Release のエラーと警告の違いを説明する。
Trailmaker Release でコンテンツを公開する方法を説明する。

リリースの問題を検出する。

「イネーブルメントサイトの基本」、「イネーブルメントサイトの設定」、「イネーブルメントサイトの作成」、「Trailmaker Content の基本」の各モジュールと、このモジュールの単元を通じて、コンテンツ作成者とリリースマネージャーが協力して、会社のイネーブルメントサイトのコンテンツを計画、作成、準備する方法について学習しました。準備されたコンテンツを関係者がイネーブルメントサイトのリリースプレビューで確認できたら、リリースマネージャーはコンテンツの公開準備が整っていることを確認します。

会社の規模によっては、リリースのモジュール、バッジ、アート、画像、ローカライズされたコンテンツなどに貢献する複数の役割がある場合があります。さまざまなコラボレーションが行われているため、コンテンツの公開準備を進めるにあたって問題が発生することがあるのも当然といえます。トレイルに参照先のモジュールがなかったり、単元にテストがなかったり、画像にアクセシビリティ属性がなかったり、といったことが考えられます。幸い、Marisol のようなリリースマネージャーにはこのような問題を監視し、リリースの公開前に解決したことを確認できるツールがあります。

Trailmaker Release のリリースページには、リリースに警告やエラーが含まれている場合に警告アイコンと赤いバナーが表示されます。

Trailmaker Release のリリースページ。エラーや警告のアラートが示されています。

Marisol が赤いバナー内の [View Errors and Warnings (エラーと警告の表示)] リンクをクリックすると、リリースの問題ページに移動します。このページでは、問題がリリースに関するものとコンテンツに関するものの 2 つに分けられています。

Trailmaker Release の問題ページ。リリースのエラーと警告が示されています。

警告やエラーを修正する

警告とは、学習者のコンテンツ体験に影響する問題です。学習者に最高の体験を提供するには、コンテンツ作成者がこの問題を修正することが望ましいですが、公開できないわけではありません。警告には次のようなものがあります。

モジュールに含まれる画像がファイアウォールの外側にあるため、イネーブルメントサイトがアクセスできない。
単元に含まれる HTML コーディングをイネーブルメントサイトに表示するとコンテンツの書式設定がいびつになるため、Trailmaker Content でサポートされていない。
画像に代替テキストがないため、デジタルスクリーンリーダーが視覚障害のあるユーザーに対して画像を説明することができない。

Marisol のリリースには 1 つの警告があります。「Pure Aloe Sales Goals (Pure Aloe の販売目標)」モジュールの 1 つの単元に無効な HTML があるというもので、その原因は画像の 1 つにアクセシビリティのための代替テキストがないことです。

エラーとは、コンテンツの公開の技術的要件に影響する問題で、この場合には Trailmaker でリリースを公開できません。エラーには次のようなものがあります。

リリースリストにモジュールまたはトレイルがあるが、コンテンツのバックパックがリリースに追加されていない。
リリースリストの API 参照名が、別のコンテンツですでに使用されている。

Marisol のリリースには 1 つのエラーがあります。リリースに含まれる「Sell Well at Pure Aloe (Pure Aloe で売上を伸ばす)」トレイルがアップロードされていないというものです。つまり、トレイルのマニフェスト項目がリリースに追加されたものの、トレイルのバックパックが Trailmaker Content からリリースに追加されていないということです。

Trailmaker Content では、Trailmaker Release で報告される前に多くの問題が検出されます。たとえば、Marisol がリリースにモジュールを追加したけれども、バッジアートやテストを含めるのを忘れていた場合、Trailmaker Content にウィンドウが表示され、アイテムが不足していることが通知されます。

このような役に立つツールを使用して Marisol はコンテンツの潜在的な問題を見つけて公開前に解決できます。

リリースを公開する

リリースにエラーや警告がなくなると、リリースページには青いバナーが表示されます。これは、リリースの公開準備が整ったことを示します。

Trailmaker Release のリリースページ。リリースにエラーや警告がなく、いつでも公開できることが示されています。

コンテンツを公開するには、リリースページで [Publish (公開)] をクリックするだけです。

Trailmaker Release のリリースページ。[Publish (公開)] ボタンが示されています。

そうすると確認ウィンドウが表示され、Marisol は最後にキャンセルするか公開を実行するかを選択できます。確認ウィンドウにはリリースで処理される項目数が表示され、エラーや警告が残っていないことを確認できます。

Trailmaker Release の公開確認画面

これで終わりです。2 回のクリックで、ついに Marisol は最新のリリースを営業チームのコンテンツコレクションに公開しました。Pure Aloe の営業チームの学習者は、すべての新しいコンテンツにアクセスできるようになりました。これは、Cindy たちが努力して作成とメンテナンスを行ったためです。

公開コンテンツのバックパックをダウンロードする

Marisol は休憩を取りたいところですが、その前に終わらせるべきタスクがもう 1 つあります。このモジュールを通して、コンテンツをリリース可能にするためには、Marisol と Cindy の両方がローカルの Trailmaker Content ワークスペースにバックパックをインポートする必要があることを見てきました。

前述のとおり、Cindy などのコンテンツ作成者は、ローカルの Trailmaker Content ワークスペースで作業中のコンテンツのバックパックをダウンロードできます。このバックパックを会社のバージョン管理システム (VCS) に送信すれば、Marisol などの他のコラボレーターがコンテンツを見つけて各自のワークスペースにインポートできます。このワークフローを再確認するには、「Trailmaker Content の基本」モジュールを参照してください。

Trailmaker Content からダウンロードしたバックパックには、コンテンツ作成者のワークスペースのコンテンツが反映されていますが、リリースで公開された最新バージョンのコンテンツが反映されているとは限りません。他のコラボレーターがコンテンツを公開する前にバックパックをワークスペースにインポートして、変更している可能性があります。

Marisol が Trailmaker Release アプリケーションの [Released Content (リリース済みコンテンツ)] セクションからバックパックをダウンロードすれば、リリースで公開されたコンテンツの最新バージョンを反映するバックパックを取得できます。

リリース済みモジュールのバックパックをダウンロードするオプションを示す、Trailmaker Release のコンテンツコレクションページの [Released Content (リリース済みコンテンツ)] セクション。

Marisol はバックパックを会社の VCS にチェックインして、他のコラボレーターがリリース済みコンテンツの最新バージョンにアクセスできるようにします。コンテンツ作成者が次回更新を行う際、このバックパックを Trailmaker Content ワークスペースにインポートすれば、最新のリリース済みバージョンで作業していることを確信できます。

このような協力の結果、Pure Aloe チーム全体が Trailhead を利用した新しいイネーブルメントサイトの立ち上げ成功を祝うことができます。