Documentação de referência para desenvolvedores do serviço de Relatórios Organizacionais do Learn

Este artigo fornece informações para desenvolvedores e solicitantes que implementam o serviço de Relatórios Organizacionais do Microsoft Learn. Também recomendamos conferir o artigo de melhores práticas, as notas sobre a versão e as perguntas frequentes do serviço de Relatórios Organizacionais do Learn para dar suporte ao seu percurso de desenvolvimento.

Dicionário de dados

Conjuntos de dados específicos do locatário

Os dados específicos do locatário são fornecidos pelos conjuntos de dados Conquistas, Certificações, Progresso e Usuários.

Importante

O userId nos dados específicos do locatário é o identificador de usuário do perfil do Learn, que é diferente do ObjectId do Microsoft Entra.

Para obter os registros de Progresso com o displayName dos usuários no seu locatário:

• Ingresse seus dados objectId do Microsoft Entra com o conjunto de dados Usuários específico do locatário AADObjectId
• Ingresse no conjunto de dados Usuários userId específico do locatário para Progresso userId
• Selecione seus dados displayName do Microsoft Entra e os dados de progresso aplicáveis.

Quando você Baixar detalhes do usuário no Centro de administração do Microsoft Entra, a exportação incluirá displayName e outras propriedades no formato CSV.

Conquistas

O conjunto de dados Conquistas contém informações sobre todos os prêmios que os usuários desse locatário obtiveram, normalmente como resultado da conclusão de módulos e de roteiros de aprendizagem. Após a conclusão do módulo, os usuários receberão um selo e, após a conclusão do caminho de aprendizagem, eles ganharão um troféu.

As conquistas do usuário são mostradas no site ao vivo exibindo o perfil de um usuário. (Exemplo)

tenantId	userId	awardReason	awardType	awardUid	SourceType	SourceUid	AwardedOn
{guid}	{guid}	badge.module.basic.completed	Selo	learn.intro-to-compute.badge	Módulo	learn.intro-to-compute	{datetimeoffset}
{guid}	{guid}	trophy.path.basic.completed	Troféu	learn.cloud-foundations.trophy	LearningPath	learn.cloud-foundations	{datetimeoffset}

Applied Skills

O conjunto de dados Applied Skills contém informações sobre todas as habilidades aplicadas que os usuários deste locatário ganharam, normalmente como resultado da conclusão de sessões de laboratório. Após a conclusão bem-sucedida da sessão de laboratório, os usuários podem ganhar uma habilidade.

tenantId	userId	appliedSkillsUid	labProfileName	examScoredDate
{guid}	{guid}	applied-skill.build-azure-ai-vision-solution	APL-3004: Criar uma solução de Visão de IA do Azure	{datetime}
{guid}	{guid}	applied-skill.build-collaborative-apps-microsoft-teams	APL-4001: Criar aplicativos colaborativos para o Microsoft Teams	{datetime}

Certificações

O conjunto de dados Certificações contém informações sobre todas as certificações que os usuários deste locatário receberam que ainda estão ativas ou expiraram nos últimos dois anos, em decorrência da conclusão de um ou mais exames (conforme necessário para a certificação).

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

Os valores de data {int} são formatados como YYYYMMDD.

Progresso

O conjunto de dados Progress contém informações sobre quantos pontos XP os usuários desse locatário conquistaram por concluir partes do conteúdo (como unidades individuais, módulos completos e roteiros de aprendizagem). Nem todo o conteúdo é igual, portanto os usuários podem ganhar mais pontos se ele contiver interatividade ou se eles concluíram uma verificação de conhecimentos com 100% de acerto de primeira.

tenantId	userId	XPReason	SourceType	SourceUid	XP	AwardedOn
{guid}	{guid}	points.unit.basic.completed	Unidade	learn.intro-to-compute.1-introduction	100	{datetimeoffset}
{guid}	{guid}	points.module.basic.completed	Módulo	learn.create-azure-account	200	{datetimeoffset}
{guid}	{guid}	points.path.basic.completed	LearningPath	learn.cloud-foundations	2.100	{datetimeoffset}

Usuários

O conjunto de dados Usuários contém informações de todos os usuários referenciados nos outros conjuntos de dados específicos do locatário. Observe que este conjunto de dados não contém informações PII. O userId é o identificador de usuário do perfil do Learn, que é diferente do ObjectId do Microsoft Entra (AADObjectId). Ao relatar, você precisará unir esses dados à sua lista de usuários do Microsoft Entra para ver uma lista mais holística de informações do usuário em relação aos outros dados.

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

Conjuntos de dados do Microsoft Learn

Os dados do Microsoft Learn (não específicos a um locatário individual) são fornecidos pelos conjuntos de dados HierarchyAppliedSkills, HierarchyCertification, HierarchyLearningPath, HierarchyLearningPathModule, HierarchyModule e HierarchyUnit.

HierarchyAppliedSkills

O conjunto de dados HierarchyAppliedSkills contém informações de catálogo sobre todas as Applied Skills no Microsoft Learn.

Para saber mais sobre as Applied Skills e como elas se relacionam com outros tipos de conteúdo, exiba a seção Applied Skills no artigo Tipos de conteúdo do Learn.

appliedSkillsUid	title	url	níveis	products	funções	assuntos	tarefas
applied-skill.build-azure-ai-vision-solution	Criar uma solução de Visão de IA do Azure	/credentials/applied-skills/build-azure-ai-vision-solution/	["intermediate"]	["azure-computer-vision"]	["developer","ai-engineer","maker"]	["artificial-intelligence"]	["Criar um recurso de pesquisa visual computacional", "Analisar imagens", "Criar um modelo de análise de imagem personalizado","Treinar e avaliar o modelo","Consumir um modelo personalizado"]
applied-skill.build-collaborative-apps-microsoft-teams	Criar aplicativos colaborativos para o 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"]	["Criar um bot","Criar uma extensão de mensagens", "Criar webhooks", "Criar uma guia do Teams","Integrar o Microsoft Graph em um aplicativo do Teams","Distribuir um aplicativo do Teams"]

HierarchyCertification

O conjunto de dados HierarchyCertification contém informações de catálogo sobre todas as Certificações no Microsoft Learn.

Para saber mais sobre certificações e como elas se relacionam com outros tipos de conteúdo, veja a seção Certificação no artigo Tipos de conteúdo do Learn.

certificationUid	tipo	título	resumo	url	iconUrl	níveis	products	funções	exames
certification.azure-administrator	0	Microsoft Certified: Azure Administrator Associate	Os administradores do Azure implementam, gerenciam e monitoram o ambiente do Microsoft Azure de uma organização.	/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

O conjunto de dados HierarchyLearningPath contém informações de catálogo sobre todos os roteiros de aprendizagem no Microsoft Learn.

Para saber mais sobre certificações e como elas se relacionam com outros tipos de conteúdo, veja a seção Roteiros de aprendizagem no artigo Tipos de conteúdo do Learn.

LearningPathUid	título	url	durationInMinutes	pontos	iconUrl	níveis	products	funções	idiomas
learn.create-serverless-applications	Criar aplicativos sem servidor	/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

O conjunto de dados HierarchyLearningPathModule contém o mapeamento de módulos para roteiros de aprendizagem. (Observação: um módulo pode fazer parte de vários roteiros de aprendizagem.)

Para saber mais sobre módulos e roteiros de aprendizagem e como eles se relacionam com outros tipos de conteúdo, veja a seção Módulo e a seção Roteiro de aprendizagem no artigo Tipos de conteúdo do 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

O conjunto de dados HierarchyModule contém informações de catálogo sobre todos os módulos (cursos).

Para saber mais sobre módulos e como eles se relacionam com outros tipos de conteúdo, veja a seção Módulo no artigo Tipos de conteúdo do Learn.

moduleUid	título	url	iconUrl	durationInMinutes	pontos	níveis	products	funções	idiomas
learn.languages.powershell-write-first	Escrever o seu primeiro código do PowerShell	/training/modules/powershell-write-first/	/training/achievements/powershell/powershell-write-first-code.svg	17	200	["beginner"]	["dotnet"]	["developer","student"]	["powershell"]

HierarchyUnit

O conjunto de dados HierarchyUnit contém informações de catálogo sobre todas as unidades (partes de módulos).

Para saber mais sobre unidades e como elas se relacionam com outros tipos de conteúdo, veja a seção Unidades no artigo Tipos de conteúdo do Learn.

unitUid	título	url	durationInMinutes	pontos	moduleUid
learn.azure.query-data-sentinel.1-introduction	Introdução	/training/modules/query-data-sentinel/1-introduction/	5	100	azure.query-data-sentinel
learn.azure.query-data-sentinel.2-exercise-setup	Exercício – Consultar e visualizar dados com as Pastas de Trabalho do Azure Sentinel	/training/modules/query-data-sentinel/2-exercise-setup/	10	100	azure.query-data-sentinel

Próximas etapas

Examine os recursos abaixo para ajudar você em seu percurso de desenvolvimento:

• Melhores práticas do serviço de Relatórios Organizacionais do Learn
• Perguntas frequentes sobre o serviço de Relatórios Organizacionais do Learn
• Notas sobre a versão do serviço de Relatórios Organizacionais do Learn