Partilhar via

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 locatário são fornecidos pelos conjuntos de dados Conquistas, Habilidades Aplicadas, Certificações, Progresso e Usuários .

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 de dados UsuáriosuserIddo locatário ao ProgressouserId
  • 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)

Id do arrendatário ID de Utilizador motivoPrémio Tipo de prémio awardUid Tipo de fonte FonteUid PremiadoOn
{GUID} {GUID} crachá.módulo.básico.completo Distintivo aprender.intro-à-computação.distintivo Módulo aprenda.introdução-a-computar {datetimeoffset}
{GUID} {GUID} troféu.caminho.básico.completo Troféu learn.cloud-foundations.trophy Percurso de Aprendizagem learn.cloud-foundations {datetimeoffset}

Competências Aplicadas

O conjunto de dados AppliedSkills 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.

Id do arrendatário ID de Utilizador appliedSkillsUid Nome do Perfil do Laboratório dataDePontuaçãoExame
{GUID} {GUID} applied-skill.criar-solucao-azure-ai-vision APL-3004: Criar uma solução Azure AI Vision {datetime}
{GUID} {GUID} habilidade-aplicada.construir-aplicações-colaborativas-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 Tipo de Prémio Nome da transcrição FonteUid PremiadoOn CertificaçãoData de Início CertificaçãoData Final DataDeInícioDeElegibilidadeAtual
{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 certificação.power-platform-fundamentais {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.

Id do arrendatário ID de Utilizador XPReason Tipo de fonte FonteUid XP PremiadoOn
{GUID} {GUID} pontos.unidade.básico.completado Unidade learn.intro-to-compute.1-introdução 100 {datetimeoffset}
{GUID} {GUID} pontos.módulo.básico.completo Módulo aprender.criar-conta-azure 200 {datetimeoffset}
{GUID} {GUID} pontos.caminho.básico.concluído Percurso de Aprendizagem 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.

Id do arrendatário ID de Utilizador AADObjectId CriadoemOn
{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 título URL níveis produtos funções indivíduos tarefas
applied-skill.criar-solucao-azure-ai-vision Crie uma solução Azure AI Vision /credenciais/competencias-aplicadas/construir-solucao-de-visao-azure-ai/ ["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"]
habilidade-aplicada.construir-aplicações-colaborativas-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"] ["desenvolvimento backend","desenvolvimento frontend","desenvolvimento de aplicações personalizadas"] ["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"]

Certificação de Hierarquia

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 título resumo URL URL do ícone níveis produtos funções exames
certificação azure-administrator 0 Certificado pela Microsoft: 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"] administrador ["exame.az-104"]

HierarquiaCaminho de Aprendizagem

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 título URL duraçãoEmMinutos pontos URL do ícone níveis produtos funções idiomas
aprender.aplicações-sem-servidor 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"]

MóduloCaminhoDeAprendizagemDaHierarquia

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-plataforma aprender.acessar-dados-com-cosmos-db-e-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 título URL URL do ícone duraçãoEmMinutos pontos níveis produtos funções idiomas
aprender.linguagens.powershell-escrever-primeiro Escreva o seu primeiro código do PowerShell /treinamento/módulos/powershell-write-first/ /treinamento/conquistas/powershell/powershell-write-first-code.svg 17 200 ["iniciante"] ["dotnet"] ["desenvolvedor","aluno"] ["powershell"]

Unidade de Hierarquia

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 título URL duraçãoEmMinutos pontos moduleUid
learn.azure.query-data-sentinel.1-introdução Introdução /formação/módulos/query-data-sentinel/1-introduction/ 5 100 azure.query-data-sentinel
aprender.azure.consulta-dados-sentinel.2-configuração-do-exercício 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:

  • Last updated on