次の方法で共有

Learn 組織のレポート サービス開発者向けリファレンスのドキュメント

  • [アーティクル]

この記事は、Microsoft Learn 組織のレポート サービスを実装する開発者と要求者のための情報を提供します。 また、今後の開発に役立つ Learn の組織向けサービスのベスト プラクティスの記事、リリース ノート、よく寄せられる質問も確認することをお勧めします。

データ辞書

テナント固有のデータセット

テナント固有のデータは、実績、認定資格、進捗状況、ユーザーのデータ セット別に提供されます。

重要

テナント固有データの userId は、Learn プロファイル ユーザー識別子です。これは Microsoft Entra ObjectId とは異なります。

ご自分のテナント内のユーザーの displayName を含む進行状況レコードを取得するには:

  • 独自の Microsoft Entra データの objectId をテナント固有の Users データセットの AADObjectId と結合します
  • テナント固有の Users データセットの userId を Progress の userId に結合します
  • 独自の Microsoft Entra データの displayName と該当する進行状況データを選択します。

Microsoft Entra 管理センターでユーザーの詳細をダウンロードすると、エクスポートには displayName とその他のプロパティが CSV 形式で含まれます。

実績

実績データセットには、このテナントのユーザーが獲得したすべてのアワードに関する情報が含まれています。通常は、モジュールとラーニング パスを修了した結果です。 モジュールを修了するとユーザーはバッジを獲得し、ラーニング パスを修了するとトロフィーを獲得します。

ユーザーの実績は、ユーザーのプロファイルを表示することでライブ サイトに表示されます。 (例)

tenantId userId awardReason awardType awardUid SourceType SourceUid AwardedOn
{guid} {guid} badge.module.basic.completed バッジ learn.intro-to-compute.badge モジュール learn.intro-to-compute {datetimeoffset}
{guid} {guid} trophy.path.basic.completed トロフィー learn.cloud-foundations.trophy LearningPath learn.cloud-foundations {datetimeoffset}

適用されたスキル

Applied Skills データセットには、通常はラボ セッションの完了の結果、このテナント内のユーザーが獲得したすべての Applied Skills に関する情報が含まれます。 ラボ セッションの完了に成功すると、ユーザーはスキルを獲得できます。

tenantId userId appliedSkillsUid labProfileName examScoredDate
{guid} {guid} applied-skill.build-azure-ai-vision-solution APL-3004:Azure AI Vision ソリューションを構築する {datetime}
{guid} {guid} applied-skill.build-collaborative-apps-microsoft-teams APL-4001:Microsoft Teams 用のコラボレーション アプリを構築する {datetime}

認定資格

認定資格データセットには、このテナントのユーザーが 1 つ以上の試験 (認定資格に必要なもの) を完了した結果、過去 2 年間に取得した、まだ有効である、または期限切れのすべての認定資格についての情報が含まれています。

tenantID userId AwardType TranscriptName SourceUid AwardedOn CertificationStartDate CertificationEndDate StayCurrentEligibilityStartDate
{guid} {guid} 認定資格 Microsoft Certified: Azure AI Engineer Associate certification.azure-ai-engineer {int} {int} {int} {int}
{guid} {guid} 認定資格 Microsoft Certified: Power Platform Fundamentals certification.power-platform-fundamentals {int} {int} {int} {int}

日付 {int} の値は YYYYMMDD として書式設定されます。

進捗状況

Progress データセットには、このテナントのユーザーがコンテンツの一部 (個々のユニット、完全なモジュール、ラーニング パスなど) から取得した XP ポイントの数に関する情報が含まれています。 すべてのコンテンツが同じであるとは限りません。そのため、ユーザーは、インタラクティビティが含まれている場合、または初めて知識チェックで 100% を修了した場合に、より多くのポイントを獲得できます。

tenantId userId XPReason SourceType SourceUid XP AwardedOn
{guid} {guid} points.unit.basic.completed ユニット learn.intro-to-compute.1-introduction 100 {datetimeoffset}
{guid} {guid} points.module.basic.completed モジュール learn.create-azure-account 200 {datetimeoffset}
{guid} {guid} points.path.basic.completed LearningPath learn.cloud-foundations 2100 {datetimeoffset}

ユーザー

ユーザー データセットには、他のテナント固有のデータセットで参照されているすべてのユーザーの情報が含まれています。 このデータセットには PII 情報が含まれていないことに注意してください。 userId は、Learn プロファイルのユーザー識別子です。これは Microsoft Entra ObjectId (AADObjectId) とは異なります。 レポートを作成するときは、他のデータに対するユーザー情報のより包括的な一覧を表示するために、このデータを Microsoft Entra ユーザーの一覧に結合する必要があります。

tenantId userId AADObjectId CreatedOn
{guid} {guid} {guid} {datetime}

Microsoft Learn データセット

(個々のテナントに固有ではない) Microsoft Learn データは、HierarchyAppliedSkills、HierarchyCertification、HierarchyLearningPath、HierarchyLearningPathModule、HierarchyModule、HierarchyUnit データセットによって提供されます。

HierarchyAppliedSkills

HierarchyAppliedSkills データセットには、Microsoft Learn 内のすべての Applied Skills に関するカタログ情報が含まれます。

Applied Skills とこれらがその他のコンテンツ タイプとどのように関係するかの詳細については、Learn コンテンツの種類に関する記事内の Applied Skills に関するセクションを参照してください。

appliedSkillsUid タイトル URL レベル products roles 情報カテゴリ tasks
applied-skill.build-azure-ai-vision-solution Azure AI Vision ソリューションを構築する /credentials/applied-skills/build-azure-ai-vision-solution/ ["intermediate"] ["azure-computer-vision"] ["developer","ai-engineer","maker"] ["artificial-intelligence"] ["コンピューター ビジョン リソースの作成","画像の分析","カスタム画像分析モデルの作成","モデルのトレーニングと評価","カスタム モデルの使用"]
applied-skill.build-collaborative-apps-microsoft-teams Microsoft Teams 用のコラボレーション アプリを構築する /credentials/applied-skills/build-collaborative-apps-microsoft-teams/ ["intermediate"] ["office-teams","ms-graph","entra-id","ms-copilot"] ["developer"] ["backend-development","frontend-development","custom-app-development"] ["ボットの構築","メッセージング拡張機能の作成","Webhook の構築","Teams タブの作成","Microsoft Graph の Teams アプリへの統合","Teams アプリの配布"]

HierarchyCertification

HierarchyCertification データセットには、Microsoft Learn のすべての認定資格に関するカタログ情報が含まれています。

認定資格の詳細と他のコンテンツ タイプとの関連性については、Learn のコンテンツ タイプの記事の認定資格のセクションをご覧ください。

certificationUid type title まとめ url iconUrl レベル products roles exams
certification.azure-administrator 0 Microsoft 認定:Azure Administrator Associate Azure 管理者は、組織の Microsoft Azure 環境を実装、管理、監視します。 /certifications/azure-administrator/ /media/learn/certification/badges/microsoft-certified-associate-badge.svg ["intermediate"] ["azure","azure-virtual-machines","azure-storage","azure-active-directory","azure-virtual-network","azure-resource-manager"] ["administrator"] ["exam.az-104"]

HierarchyLearningPath

HierarchyLearningPath データセットには、Microsoft Learn のすべてのラーニング パスに関するカタログ情報が含まれています。

ラーニング パスの詳細と他のコンテンツ タイプとの関連性については、Learn のコンテンツ タイプの記事のラーニング パスのセクションをご覧ください。

LearningPathUid title url durationInMinutes ポイント iconUrl レベル products roles languages
learn.create-serverless-applications サーバーレス アプリケーションの作成 /training/paths/create-serverless-applications/ 517 1925 /training/achievements/create-serverless-applications.svg ["beginner","intermediate"] ["azure","azure-functions","azure-portal","azure-cosmos-db","azure-storage","azure-cloud-shell"] ["developer","student"] ["powershell"]

HierarchyLearningPathModule

HierarchyLearningPathModule データセットには、モジュールからラーニング パスへのマッピングが含まれています。 (注: 1 つのモジュールが、複数のラーニング パスに含まれている可能性があります)。

モジュールとラーニング パスの詳細と他のコンテンツ タイプとの関連性については、Learn のコンテンツ タイプの記事のモジュールのセクションとラーニング パスのセクションをご覧ください。

LearningPathUid ModuleUid
learn.security-ops-sentinel azure.query-data-sentinel
learn.architect-data-platform learn.access-data-with-cosmos-db-and-sql-api

HierarchyModule

HierarchyModule データセットには、すべてのモジュール (コース) に関するカタログ情報が含まれています。

モジュールの詳細と他のコンテンツ タイプとの関連性については、Learn のコンテンツ タイプの記事のモジュールのセクションをご覧ください。

moduleUid title url iconUrl durationInMinutes ポイント レベル products roles languages
learn.languages.powershell-write-first PowerShell のコードを初めて記述する /training/modules/powershell-write-first/ /training/achievements/powershell/powershell-write-first-code.svg 17 200 ["beginner"] ["dotnet"] ["developer","student"] ["powershell"]

HierarchyUnit

HierarchyUnit データセットには、すべてのユニット (モジュールの一部) に関するカタログ情報が含まれています。

ユニットの詳細と他のコンテンツ タイプとの関連性については、Learn のコンテンツ タイプの記事のユニットのセクションをご覧ください。

unitUid title url durationInMinutes ポイント moduleUid
learn.azure.query-data-sentinel.1-introduction はじめに /training/modules/query-data-sentinel/1-introduction/ 5 100 azure.query-data-sentinel
learn.azure.query-data-sentinel.2-exercise-setup 演習 - Azure Sentinel ブックを使用してデータのクエリと視覚化を行う /training/modules/query-data-sentinel/2-exercise-setup/ 10 100 azure.query-data-sentinel

次のステップ

以下のリソースを確認して、今後の開発にお役立てください。