Saiba mais sobre a documentação de referência do desenvolvedor do serviço de Relatório Organizacional

Este artigo fornece informações para desenvolvedores e solicitantes que implementam o serviço Microsoft Learn Organizational Reporting. Também recomendamos que consulte o artigo Aprender práticas recomendadas de serviço organizacional, Notas de versão e Perguntas frequentes para apoiar sua jornada de desenvolvimento.

Dicionário de dados

Conjuntos de dados específicos de inquilinos

Os dados específicos do inquilino são fornecidos pelos conjuntos de dados Conquistas, Certificações, Progresso e Utilizadores.

Importante

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

Para obter registos de Progresso com displayName para utilizadores no seu inquilino:

• Junte seus próprios dados objectId do Microsoft Entra ao conjunto de dados Usuários específicos do locatárioAADObjectId
• Associar o conjunto userId de dados Usuários específicos do locatário ao Progresso userId
• Selecione seus próprios 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 utilizadores deste inquilino ganharam, geralmente como resultado da conclusão de módulos e percursos de aprendizagem. Após a conclusão do módulo, os usuários ganharão um selo e, após a conclusão do caminho de aprendizagem, ganharão um troféu.

As Conquistas do Utilizador são apresentadas no perfil de utilizador no site publicado. (Exemplo)

tenantId	ID de Utilizador	awardReason	Tipo de prémio	awardUid	Tipo de fonte	SourceUid	AwardedOn
{guid}	{guid}	badge.module.basic.completed	Distintivo	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}

Competências Aplicadas

O conjunto de dados Habilidades Aplicadas contém informações sobre todas as Habilidades Aplicadas que os usuários desse locatário ganharam, geralmente 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	ID de Utilizador	appliedSkillsUid	labProfileName	examScoredDate
{guid}	{guid}	applied-skill.build-azure-ai-vision-solution	APL-3004: Criar uma solução Azure AI Vision	{datetime}
{guid}	{guid}	applied-skill.build-collaborative-apps-microsoft-teams	APL-4001: Crie 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 utilizadores deste inquilino 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).

ID do locatário	ID de Utilizador	AwardType	TranscriptName	SourceUid	AwardedOn	CertificaçãoData de Início	CertificaçãoData Final	StayCurrentEligibilityStartDate
{guid}	{guid}	Certificação	Microsoft Certified: Associado de Engenheiro do Azure AI	certification.azure-ai-engineer	{int}	{int}	{int}	{int}
{guid}	{guid}	Certificação	Microsoft Certified: Fundamentos do Power Platform	certification.power-platform-fundamentals	{int}	{int}	{int}	{int}

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

Progresso

O conjunto de dados Progresso contém informações sobre quantos pontos XP os utilizadores neste inquilino conquistaram por concluir partes do conteúdo (como unidades individuais, módulos completos e percursos de aprendizagem). Nem todo o conteúdo é igual, então os usuários podem ganhar mais pontos se contiverem interatividade ou se completarem uma verificação de conhecimento 100% na primeira vez.

tenantId	ID de Utilizador	XPReason	Tipo de fonte	SourceUid	XP	AwardedOn
{guid}	{guid}	points.unit.basic.completed	Unit	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	2100	{datetimeoffset}

Utilizadores

O conjunto de dados Utilizadores contém informações de todos os utilizadores referenciados nos outros conjuntos de dados específicos do inquilino. Observe que esse conjunto de dados não contém nenhuma informação de PII. O userId é o identificador de usuário do perfil do Learn, que é diferente do Microsoft Entra ObjectId (AADObjectId). Ao criar relatórios, 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	ID de Utilizador	AADObjectId	CreatedOn
{guid}	{guid}	{guid}	{datetime}

Conjuntos de dados do Microsoft Learn

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

HierarquiaCompetências Aplicadas

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

Para saber mais sobre Habilidades Aplicadas e como elas se relacionam com outros tipos de conteúdo, consulte a seção Habilidades Aplicadas no artigo Tipos de conteúdo Aprender.

appliedSkillsUid	title	url	níveis	produtos	funções	indivíduos	tarefas
applied-skill.build-azure-ai-vision-solution	Crie uma solução Azure AI Vision	/credentials/applied-skills/build-azure-ai-vision-solution/	["intermediário"]	["azure-computer-vision"]	["desenvolvedor","ai-engineer","maker"]	["inteligência artificial"]	["Criar um recurso de visão 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	Crie aplicativos colaborativos para o Microsoft Teams	/credenciais/habilidades aplicadas/build-collaborative-apps-microsoft-teams/	["intermediário"]	["Office-teams","ms-graph","entra-id","ms-copilot"]	["desenvolvedor"]	["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, consulte a seção Certificação no artigo Aprender tipos de conteúdo.

certificaçãoUid	tipo	title	Resumo	url	iconUrl	níveis	produtos	funções	exams
certification.azure-administrator	0	Microsoft Certified: Azure Administrator Associate	Os administradores do Azure implementam, gerem e monitorizam o ambiente do Microsoft Azure de uma organização.	/certifications/azure-administrator/	/mídia/aprender/certificação/crachás/microsoft-certified-associate-badge.svg	["intermediário"]	["azure","azure-virtual-machines","azure-storage","azure-active-directory","azure-virtual-network","azure-resource-manager"]	["administrator"]	["exame.az-104"]

HierarchyLearningPath

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

Para saber mais sobre os caminhos de aprendizagem e como eles se relacionam com outros tipos de conteúdo, consulte a seção Caminhos de aprendizagem no artigo Tipos de conteúdo do Learn.

LearningPathUid	title	url	durationInMinutes	points	iconUrl	níveis	produtos	funções	idiomas
learn.create-serverless-applications	Criar aplicações sem servidor	/treinamento/caminhos/create-serverless-applications/	517	1925	/formação/realizações/create-serverless-applications.svg	["iniciante","intermediário"]	["azure","azure-functions","azure-portal","azure-cosmos-db","azure-storage","azure-cloud-shell"]	["desenvolvedor","aluno"]	["powershell"]

HierarchyLearningPathModule

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

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

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, consulte a seção Módulo no artigo Aprender tipos de conteúdo.

moduleUid	title	url	iconUrl	durationInMinutes	points	níveis	produtos	funções	idiomas
learn.languages.powershell-write-first	Escreva o seu primeiro código do PowerShell	/treinamento/módulos/powershell-write-first/	/treinamento/conquistas/powershell/powershell-write-first-code.svg	17	200	["beginner"]	["dotnet"]	["desenvolvedor","aluno"]	["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, consulte a seção Unidades no artigo Aprender tipos de conteúdo.

unitUid	title	url	durationInMinutes	points	moduleUid
learn.azure.query-data-sentinel.1-introduction	Introdução	/formação/módulos/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 Livros do Azure Sentinel	/treinamento/módulos/query-data-sentinel/2-exercise-setup/	10	100	azure.query-data-sentinel

Próximos passos

Analise os recursos abaixo para ajudá-lo em sua jornada de desenvolvimento:

• Conheça as práticas recomendadas do serviço de Relatório Organizacional
• Aprenda sobre o serviço de Relatórios Organizacionais: perguntas frequentes
• Conheça as notas de versão do serviço de Relatório Organizacional