Microsoft Learn 組織のレポート サービスを使用するためのベスト プラクティス
この記事では、Learn 組織のレポート サービスを使用するためのベスト プラクティスについて説明します。
Microsoft Learn データ アクセスと共有に関する契約について
このデータ共有サービスを使用すると、自分の組織のテナント ID でサインインした Learn ユーザーの Learn データを自分の組織と Microsoft が共有できるように、お客様は Microsoft Learn データ アクセスおよび共有契約を承認し、これに同意するものとみなされます。 Microsoft Learn 組織のレポート サービスを使用し、運用環境で出力を含める前に、この契約をお読みになり、内容を把握してください。
このサービスで提供されるデータを可視化するために使用するレポート ソリューションを計画する
Microsoft Learn 組織のレポート サービスにより、組織に生の修了データが提供されます。また、既定ではダッシュボードがありません。 データを取得し、それを CSV にエクスポートしてすばやくデータを表示することはできますが、インパクトのあるものにするには、結合する必要があります。
SQL DB ストレージ用の Learn 組織のレポート Power BI テンプレートには、標準的なデータ可視化機能が多数備わっていますが、お好みのレポート ソリューションも使用できます。 どのようなものを使いたいのかをあらかじめ計画しておくと、設定プロセスの一部としてデータ ストレージに接続することができます。
Learn のコンテンツ モデルを理解する
Microsoft Learn 組織のレポート サービスの回答を効果的に使用するためには、Microsoft Learn で利用可能なコンテンツ タイプと相互の関係性を理解することが重要です。 詳細については、Learn のコンテンツ タイプに関する記事をご覧ください。
注目すべき点:
- UID は "Unique ID" の略で、各コンテンツ オブジェクトに対して一意となるものです。 UID が変更されると、たとえタイトルや他のメタデータが同じであっても、そのコンテンツは新しいオブジェクトとみなされます。
- モジュールは、Learn トレーニング カタログ内のコア オブジェクトです。 これらはすべて、シナリオまたは概念をその中で端から端まで教えるという意味で、単独で機能します。前提条件となるモジュールを受講する必要はありません。 中には、これだけで、ラーニング パスの一部ではないものもあります。 また、より高度なコンセプトを構築するために、1 つまたは複数のラーニング パスにまとめられている場合もあります。 モジュールはラーニング パスの一部である必要はなく、1 つまたは複数のラーニング パスの一部であることもあり得ます。
- ユニットは独立したコンテンツとして書かれているわけではありません。 それらは、モジュールの特定の順序で実施されることが意図されています。 このため、モジュール詳細ページと最初のユニットへのリンクが含まれており、ユーザーはそこから始めてコンテンツを進めることができます。
Learn でのローカライズのしくみと、ローカライズされたコンテンツが組織のレポート出力にどのように反映されるかを理解する
Microsoft Learn のサイトでは 65 を超えるロケールがサポートされており、コンテンツの多くはこれらのロケールに翻訳されています。 Microsoft はコンテンツで教えられている製品が利用可能なすべての言語においてコンテンツを利用できるようにすることを目指していますが、すべてのロケール エクスペリエンスでコンテンツが翻訳されているわけではありません。
ロケールのレコードに関連する翻訳がない場合、サイト上のコンテンツと API の応答は、既定で英語に "フォールバック" されます。 API 出力の場合、フォールバックが発生すると、他のロケールの応答に英語のメタデータが表示されるようになります。 ただし、メイン コンテンツがフォールバックされても、コンテンツへの URL はそのロケールを指したままとなります。その理由は、ユーザーがそのロケールでサイトを引き続き移動できるようにするためです (翻訳されたヘッダー/フッター、および翻訳が利用できるその他のすべてのリンクが表示されます)。
英語のコンテンツの更新が公開されると、Microsoft のローカライズ パイプラインは、できるだけ早く、通常は元の変更から数日以内にローカライズ版を更新できるように作業します。 サポートされているロケールの完全な一覧は、サイト フッターから確認できます (サイトを表示している言語へのリンクを選択してください)。
Microsoft のトレーニング コンテンツの修了レコードは、ロケールに依存しません。つまり、ローカライズ版のコンテンツは、Microsoft のユーザー トレーニングの修了レコードでは、個別のオブジェクトとして区別されません。 ユーザーがどの言語でトレーニングを修了しても、オブジェクト全体の履修単位を受け取ることになり、どの言語で修了したかという参照情報は保存されません。 つまり、お使いの学習エクスペリエンスに Learn 組織のレポート サービス データを実装する場合に、この点を考慮する必要があります。コンテンツ オブジェクトを個別のオブジェクトとして読み込む場合は、ユーザーがどの言語でトレーニングを修了しても、他の言語での単位を取得し、再受験する必要がないように、両者が等価であることを示す実装を行う必要があるのです。
Learn でのコンテンツのバージョン管理のしくみと、それが組織のレポート出力にどのように反映されるかを理解する
注目すべきは、コンテンツが常に更新されていることです。 通常、更新情報は 1 日に 2 回発行されます。 ちょっとしたテキストの変更などのマイナーなものから、大幅な改訂、追加、削除などのメジャーなものまであります。 一般的に、コンテンツ ポートフォリオは、何千人もの共同作成者を擁する大規模で高度に管理されたオープンソース プロジェクトとして管理されており、そのため、常に変更が行われています。 運用システムで Learn 組織のレポート サービスのデータを使用するならば、このことを認識し、ご自分のシステムでそれを処理できるようにしておく必要があります。
新しいコンテンツ オブジェクトが追加されると、それらは応答に新しいオブジェクト (UID で識別) として表示されます。 コンテンツに変更が加えられたときは、その last_modified の値で判別できます。 コンテンツが削除されると、応答から削除されます。 API 応答の中のコンテンツが更新されるのは少し遅れることもありますが、ユーザーはそのコンテンツへの URL をたどれば、常に最新の情報を見ることができます。 削除された場合は、古い URL から新しいコンテンツやエクスペリエンスにリダイレクトされます。
現時点では、コンテンツのバージョンを表すものは last_modified の日付以外にはありません。
組織のレポート サービスの制限事項を理解する
組織のレポート サービス機能の概要に関する記事で制限事項をご確認ください。
データを定期的に最新の情報に更新する
Learn 組織のレポート サービス データのカタログ情報を使用して、ビジネス プロセスをサポートしたり、サイト エクスペリエンスの一部として顧客向けに表示したりしている場合は、少なくとも 1 日に 1 回はコンテンツを更新するようにしてください。
注目すべきは、コンテンツが常に更新されていることです。 通常、更新情報は 1 日に 2 回発行されます。 ちょっとしたテキストの変更などのマイナーなものから、大幅な改訂、追加、削除などのメジャーなものまであります。 一般的に、コンテンツ ポートフォリオは、何千人もの共同作成者を擁する大規模で高度に管理されたオープンソース プロジェクトとして管理されており、そのため、常に変更が行われています。 運用システムで組織のレポート サービスのデータを使用するならば、このことを認識し、お客様のシステムでそれを処理できるようにしておく必要があります。
参加済み Microsoft Entra 情報が定期的に更新されていることを確認する
各入力候補レコードが誰を参照しているかを把握するには、組織レポート データセット データを Microsoft Entra 情報に参加させて、入力候補レコードと共に名前が表示されるようにする必要があります。 Microsoft Entra 参加済みデータを更新しない場合、入力候補レコードに古い人事データが含まれているか、関連付けられている PII データが欠落している可能性があります。
開発者向けドキュメントを参照する
Learn 組織のレポート サービスの開発者向けドキュメントには、応答の一部として提供されるデータの完全なリストと、優れた学習エクスペリエンスをサポートするために各フィールドをどのように使用することが推奨されるかについて記載されています。
次のステップ
Learn 組織のレポート サービスのサポートの詳細については、次の記事をご覧ください。