Справочная документация разработчика службы организации Reporting Service

Мақала
11/24/2024

В этой статье содержатся сведения для разработчиков и запрашивающих пользователей, реализующих службу отчетов организации Microsoft Learn. Мы также рекомендуем ознакомиться со статьей по рекомендациям по использованию службы Learn, заметками о выпуске и часто задаваемыми вопросами о разработке.

Словарь данных

Наборы данных, относящиеся к конкретному арендатору

Данные, относящиеся к конкретному арендатору, предоставляются в наборах данных Achievements, Certifications, Progress и Users.

Внимание

В userId данных для конкретного клиента используется идентификатор пользователя профиля Learn, который отличается от идентификатора объекта Microsoft Entra ObjectId.

Чтобы получить записи хода выполнения с displayName для пользователей в клиенте:

Присоединение собственных данных objectId Microsoft Entra к набору данных пользователей для конкретного клиентаAADObjectId
Присоединение к набору данных пользователейuserIdклиента к progressuserId
Выберите собственные данные displayName Microsoft Entra и применимые данные о ходе выполнения.

При скачивании сведений о пользователе в Центре администрирования Microsoft Entra экспорт будет содержать displayName и другие свойства в формате CSV.

Достижения

Набор данных Achievements содержит сведения обо всех наградах, полученных пользователями этого арендатора (как правило, в результате прохождения модулей и схем обучения). После завершения модуля пользователи получат значок и после завершения пути обучения, они получат трофей.

Достижения пользователей отображаются на действующем сайте в профилях пользователей. (Пример.)

tenantId	userId	awardReason	awardType	awardUid	Тип источника	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}

Примененные навыки

Набор данных "Примененные навыки" содержит сведения обо всех примененных навыках, которые пользователи в этом клиенте заработали, как правило, в результате завершения сеансов лаборатории. После успешного завершения сеанса лаборатории пользователи могут получить навык.

tenantId	userId	appliedSkillsUid	labProfileName	экзаменЫcoredDate
{guid}	{guid}	application-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}

Сертификация

Набор данных Certifications содержит сведения обо всех сертификатах, которые все еще активны или срок действия которых истек в течение последних двух лет, полученных пользователями в этом арендаторе в результате сдачи одного или нескольких экзаменов (в соответствии с требованиями сертификации).

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 содержит информацию о том, сколько баллов опыта пользователи этого арендатора заработали за выполнение частей материала (таких, как отдельные уроки, полные модули и схемы обучения). Не все содержимое равно, поэтому пользователи могут заработать больше очков, если он содержит интерактивность, или если они выполнили проверку знаний 100 % в первый раз.

tenantId	userId	XPReason	Тип источника	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}

Пользователи

Набор данных Users содержит сведения обо всех пользователях, на которых есть ссылки в других наборах данных, относящихся к конкретному арендатору. Обратите внимание, что этот набор данных не содержит никаких сведений о персональных данных. Это userId идентификатор пользователя профиля Learn, который отличается от Идентификатора объекта Microsoft Entra (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.

Дополнительные сведения о примененных навыках и их связи с другими типами контента см. в разделе "Примененные навыки" статьи "Типы контента Learn".

appliedSkillsUid	title	URL-адрес	уровни	продукты	роли	Предметы	задачи
application-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"]	["искусственный интеллект"]	["Создание ресурса компьютерного зрения", "Анализ изображений", "Создание пользовательской модели анализа изображений", "Обучение и оценка модели","Использование пользовательской модели"]
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"]	["Создание бота", "Создание расширения обмена сообщениями", "Создание веб-перехватчиков", "Создание вкладки Teams", "Интеграция Microsoft Graph в приложение Teams", "Распространение приложения Teams"]

HierarchyCertification

Набор данных HierarchyCertification содержит сведения из каталога обо всех программах сертификации в Microsoft Learn.

Дополнительные сведения о сертификации и их связи с другими типами контента см. в разделе "Сертификация" статьи "Типы контента Learn".

certificationUid	type	title	Итоги	URL-адрес	iconUrl	уровни	продукты	роли	exams
certification.azure-administrator	0	Microsoft Certified: Azure Administrator Associate (Сертификация Майкрософт. Помощник Администратора Azure)	Администраторы 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	уровни	продукты	роли	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 содержит сопоставление модулей со схемами обучения. (Примечание: один и тот же модуль может использоваться в нескольких схемах обучения.)

Дополнительные сведения о модулях и путях обучения и их связи с другими типами контента см . в разделе " Модуль" и разделе "Схема обучения" статьи "Типы контента 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	точек	уровни	продукты	роли	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

Следующие шаги

Просмотрите приведенные ниже ресурсы, чтобы помочь вам в процессе разработки:

Бөлісу құралы: