Довідкова документація розробника служби звітування організації

У цій статті наведено відомості для розробників і запитів, які впроваджують службу звітування про організацію Microsoft Learn. Ми також рекомендуємо ознайомитися зі статтею Практичні поради щодо служби Learn Organizational, Нотатки про випуск і Запитання й відповіді , щоб підтримати шлях розвитку.

Словник даних

Набори даних для певного клієнта

Дані клієнта надаються наборами даних "Досягнення", "AppliedSkills", "Сертифікації", "Перебіг виконання" та "Користувачі ".

Важливо!

У userId даних клієнта міститься ідентифікатор користувача профілю Learn, який відрізняється від ідентифікатора Microsoft Entra ObjectId.

Щоб отримати записи про перебіг виконання за допомогою displayName для користувачів у клієнті, виконайте наведені нижче дії.

  • Приєднайте власні дані objectId Microsoft Entra за допомогою набору даних користувачів , пов'язаних із клієнтом AADObjectId
  • Приєднайтеся до набору даних користувачів , які стосуються userId конкретного клієнта, до перебігу виконанняuserId
  • Виберіть власні дані displayName Microsoft Entra та відповідні дані про перебіг виконання.

Коли ви завантажуєте відомості про користувача в Центрі адміністрування Microsoft Entra, експорт включатиме displayName та інші властивості у форматі CSV.

Досягнення

Набір даних "Досягнення" містить відомості про всі нагороди, які отримали користувачі в цьому клієнті, як правило, в результаті завершення модулів і навчальних шляхів. Після завершення модуля користувачі отримають емблему, і після завершення навчального шляху вони отримають трофей.

Досягнення користувачів відображаються на динамічному сайті, переглядаючи профіль користувача. (Приклад)

tenantId (Ідентифікатор клієнта) ідентифікатор користувача awardReason awardType awardUid Тип джерела Ідентифікатор джерела 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}

Застосовані об'єми

Набір даних AppliedSkills містить відомості про всі застосовані навички, які заробили користувачі в цьому клієнті, зазвичай в результаті завершення сеансів лабораторії. Після успішного завершення сеансу лабораторії користувачі можуть заробляти навички.

tenantId (Ідентифікатор клієнта) ідентифікатор користувача 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}

Сертифікації

Набір даних "Сертифікації " містить відомості про всі сертифікації, які отримали користувачі в цьому клієнті, які ще активні або термін дії яких минув протягом останніх двох років, у результаті виконання одного або кількох іспитів (відповідно до вимог сертифікації).

tenantID (ідентифікатор клієнта) ідентифікатор користувача Тип нагороди Ім'я стенограми Ідентифікатор джерела AwardedOn Дата початку сертифікації Дата отримання сертифікації Дата початку постійного запуску
{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.

Перебіг виконання

Набір даних "Перебіг виконання " містить відомості про кількість балів XP, які користувачі в цьому клієнті заробили на заповненні фрагментів вмісту (наприклад, окремих одиниць, повних модулів і навчальних шляхів). Не весь вміст дорівнює, тому користувачі можуть заробляти більше балів, якщо він містив інтерактивність, або якщо вони виконали перевірку знань 100% перший раз.

tenantId (Ідентифікатор клієнта) ідентифікатор користувача XPReason Тип джерела Ідентифікатор джерела Екстремальне програмування 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 (Ідентифікатор клієнта) ідентифікатор користувача AADObjectId Створено
{guid} {guid} {guid} {datetime}

Набори даних Microsoft Learn

Дані Microsoft Learn (не характерні для окремого клієнта) надаються наборами даних HierarchyAppliedSkills, HierarchyCertification, HierarchyLearningPath, HierarchyLearningPathModule, HierarchyModule та HierarchyUnit .

ІєрархіяAppliedSkills

Набір даних HierarchyAppliedSkills містить відомості про каталог про всі застосовані навички в Microsoft Learn.

Докладні відомості про застосовані навички та їх відношення до інших типів вмісту див. в розділі Прикладні навички в статті Відомості про типи вмісту.

appliedSkillsUid назва URL-адреса Рівнів Продукти ролі Предметів Завдання
applied-skill.build-azure-ai-vision-solution Створення рішення Azure AI Vision /credentials/applied-skills/build-azure-ai-vision-solution/ ["intermediate"] ["azure-computer-vision"] ["розробник","ai-engineer","maker"] ["штучний інтелект"] ["Створення ресурсу комп'ютерного бачення","Аналіз зображень","Створення спеціальної моделі аналізу зображень","Навчання та оцінка моделі","Використання спеціальної моделі"]
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"] ["розробник"] ["backend-development","frontend-development","custom-app-development"] ["Створіть бот","Створіть розширення для обміну повідомленнями","Створення веб-команд","Створення вкладки Teams","Інтеграція Microsoft Graph у програму Teams","Розповсюдження програми Teams"]

ІєрархіяСертифікація

Набір даних HierarchyCertification містить відомості каталогу про всі сертифікації в Microsoft Learn.

Щоб дізнатися більше про сертифікації та їх відношення до інших типів вмісту, див. розділ Сертифікація в статті Відомості про типи вмісту.

certificationUid тип назва зведення URL-адреса iconUrl (Url-адреса піктограми) Рівнів Продукти ролі Іспити
certification.azure-administrator 0 Сертифікована корпорація Майкрософт: 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"] ["адміністратор"] ["exam.az-104"]

ІєрархіяДобір даних у програміPath

Набір даних HierarchyLearningPath містить відомості про каталог для всіх навчальних шляхів у Microsoft Learn.

Щоб дізнатися більше про навчальні шляхи та як вони пов'язані з іншими типами вмісту, перегляньте розділ Навчальні шляхи в статті Відомості про типи вмісту.

LearningPathUid назва URL-адреса durationInMinutes Очок iconUrl (Url-адреса піктограми) Рівнів Продукти ролі Мови
learn.create-serverless-applications Створення застосунків без сервера /training/paths/create-serverless-applications/ 517 1925 /training/achievements/create-serverless-applications.svg ["початківець","проміжний"] ["azure","azure-functions","azure-portal","azure-cosmos-db","azure-storage","azure-cloud-shell"] ["розробник","студент"] ["powershell"]

ІєрархіяНалаштисний модульPath

Набір даних HierarchyLearningPathModule містить зіставлення модулів із навчальними шляхами. (Примітка. Модуль може бути частиною кількох навчальних шляхів.)

Щоб дізнатися більше про модулі та навчальні шляхи, а також про те, як вони пов'язані з іншими типами вмісту, див. розділ Модулі та навчальний шлях у статті Відомості про типи вмісту.

LearningPathUid Ідентифікатор модуля
learn.security-ops-sentinel azure.query-data-sentinel
learn.architect-data-platform learn.access-data-with-cosmos-db-and-sql-api

Ієрархія модуля

Набір даних HierarchyModule містить відомості про каталог для всіх модулів (курсів).

Щоб дізнатися більше про модулі та способи їхнього зв'язування з іншими типами вмісту, див. розділ Модуль у статті Відомості про типи вмісту.

moduleUid (Ідентифікатор модуля) назва URL-адреса iconUrl (Url-адреса піктограми) durationInMinutes Очок Рівнів Продукти ролі Мови
learn.languages.powershell-write-first Напишіть перший код PowerShell /training/modules/powershell-write-first/ /training/achievements/powershell/powershell-write-first-code.svg 17 200 ["початківець"] ["dotnet"] ["розробник","студент"] ["powershell"]

Ієрархія

Набір даних HierarchyUnit містить відомості про каталог для всіх одиниць (частин модулів).

Щоб дізнатися більше про одиниці та як вони пов'язані з іншими типами вмісту, перегляньте розділ "Одиниці " в статті Відомості про типи вмісту.

unitUid (Ідентифікатор одиниці вимірювання) назва 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

Наступні кроки

Ознайомтеся з наведеними нижче ресурсами, щоб допомогти вам у розвитку:

  • Last updated on