Documentazione di riferimento per gli sviluppatori del servizio Di reporting aziendale

  • Articolo

Questo articolo fornisce informazioni per sviluppatori e richiedenti che implementano il servizio per il servizio di creazione di report azienali Microsoft Learn. È anche consigliabile consultare l'articolo Procedure consigliateper il servizio dell’organizzazione Learn, Note sulla versionee domande frequenti per supportare il percorso di sviluppo.

Dizionario dati

Set di dati specifici del tenant

I dati specifici del tenant vengono forniti dai set di dati Obiettivi raggiunti, Certificazioni, Avanzamento e Utenti.

Importante

Il userId nei dati specifici del tenant è l'identificatore utente del profilo Learn, che è diverso da Microsoft Entra ObjectId.

Per ottenere i record di stato con displayName per gli utenti nel tenant:

  • Aggiungere i propri dati Microsoft Entra objectId con il set di dati Users specifico del tenantAADObjectId
  • Aggiungere il set di dati Utenti specifico del tenant userId al Progresso userId
  • Selezionare i propri dati Microsoft Entra displayName e i dati di stato applicabili.

Quando si scaricano i dettagli utente nell'interfaccia di amministrazione di Microsoft Entra, l'esportazione includerà displayName e altre proprietà in formato CSV.

Obiettivi

Il set di dati Obiettivi raggiunti contiene informazioni su tutti i riconoscimenti ottenuti dagli utenti in questo tenant, in genere come risultato del completamento di moduli e percorsi di apprendimento. Al termine del modulo, gli utenti otterranno un badge e al completamento del percorso di apprendimento otterranno un trofeo.

Gli obiettivi raggiunti dagli utenti vengono mostrati nel sito live mediante la visualizzazione del profilo di un utente. (Esempio)

tenantId userId awardReason awardType awardUid SourceType SourceUid AwardedOn
{guid} {guid} badge.module.basic.completed Badge learn.intro-to-compute.badge Modulo learn.intro-to-compute {datetimeoffset}
{guid} {guid} trophy.path.basic.completed Trofeo learn.cloud-foundations.trophy LearningPath learn.cloud-foundations {datetimeoffset}

Competenze applicate

Il set di dati competenze applicate contiene informazioni su tutte le competenze applicate ottenute dagli utenti in questo tenant, in genere a seguito del completamento delle sessioni del lab. Al termine della sessione del lab, gli utenti possono ottenere una competenza.

tenantId userId appliedSkillsUid labProfileName examScoredDate
{guid} {guid} applied-skill.build-azure-ai-vision-solution APL-3004: Creare una soluzione Visione di Azure AI {datetime}
{guid} {guid} applied-skill.build-collaborative-apps-microsoft-teams APL-4001: Creare app collaborative per Microsoft Teams {datetime}

Certificazioni

Il set di dati Certificazioni contiene informazioni su tutte le certificazioni acquisite dagli utenti in questo tenant ancora attive o scadute negli ultimi due anni, in seguito al completamento di uno o più esami (come richiesto per la certificazione).

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

I valori di data {int} sono formattati come YYYYMMDD.

Avanzamento

Il set di dati Avanzamento contiene informazioni sul numero di punti esperienza ottenuti dagli utenti in questo tenant per il completamento di parti del contenuto, ad esempio singole unità, moduli completi e percorsi di apprendimento. Non tutti i contenuti sono uguali, quindi gli utenti possono guadagnare più punti se conteneva interattività o se hanno completato un controllo delle conoscenze al 100% la prima volta.

tenantId userId XPReason SourceType SourceUid XP AwardedOn
{guid} {guid} points.unit.basic.completed Unità learn.intro-to-compute.1-introduction 100 {datetimeoffset}
{guid} {guid} points.module.basic.completed Modulo learn.create-azure-account 200 {datetimeoffset}
{guid} {guid} points.path.basic.completed LearningPath learn.cloud-foundations 2100 {datetimeoffset}

Utenti

Il set di dati Utenti contiene informazioni di tutti gli utenti a cui si fa riferimento negli altri set di dati specifici del tenant. Si noti che questo set di dati non contiene informazioni personali. userId è l'identificatore utente del profilo Learn, che è diverso da Microsoft Entra ObjectId (AADObjectId). Quando si segnalano, è necessario aggiungere questi dati all'elenco di utenti di Microsoft Entra per visualizzare un elenco più olistico delle informazioni utente rispetto agli altri dati.

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

Set di dati di Microsoft Learn

I dati di Microsoft Learn (non specifici di un singolo tenant) vengono forniti dai set di dati HierarchyAppliedSkills, HierarchyCertification, HierarchyLearningPath, HierarchyLearningPathModule, HierarchyModulee HierarchyUnit.

HierarchyAppliedSkills

Il set di dati HierarchyAppliedSkills contiene informazioni sul catalogo su tutte le competenze applicate in Microsoft Learn.

Per altre informazioni sulle competenze applicate e sul modo in cui sono correlati ad altri tipi di contenuto, vedere la sezione Competenze applicate nell'articoloSui tipi di contenuto Learn.

appliedSkillsUid title URL. livelli products ruoli. argomenti attività
applied-skill.build-azure-ai-vision-solution Creare una soluzione Visione di Azure AI /credentials/applied-skills/build-azure-ai-vision-solution/ ["intermediate"] ["azure-computer-vision"] ["developer","ai-engineer","maker"] ["artificial-intelligence"] ["Create a computer vision resource","Analyze images","Create a custom image analysis model","Train and evaluate the model","Consume a custom model"]
applied-skill.build-collaborative-apps-microsoft-teams Creare app collaborative per 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"] ["Build a bot","Create a messaging extension","Build webhooks","Create a Teams tab","Integrate Microsoft Graph into a Teams app","Distribute a Teams app"]

HierarchyCertification

Il set di dati HierarchyCertification contiene informazioni del catalogo su tutte le certificazioni di Microsoft Learn.

Per altre informazioni sulle certificazioni e sul modo in cui sono correlati ad altri tipi di contenuto, vedere la sezione Certificazione nell'articoloSui tipi di contenuto Learn.

certificationUid Tipo title riepilogo URL iconUrl livelli products ruoli. exams
certification.azure-administrator 0 Microsoft Certified: Azure Administrator Associate Gli amministratori di Azure implementano, gestiscono e monitorano l'ambiente Microsoft Azure di un'organizzazione. /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

Il set di dati HierarchyLearningPath contiene informazioni del catalogo su tutti i percorsi di apprendimento di Microsoft Learn.

Per altre informazioni sui percorsi di apprendimento e sul modo in cui sono correlati ad altri tipi di contenuto, vedere la sezione Percorsi di apprendimento nell'articoloSui tipi di contenuto Learn.

LearningPathUid title URL durationInMinutes punti iconUrl livelli products ruoli. lingue
learn.create-serverless-applications Creare applicazioni senza server /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

Il set di dati HierarchyLearningPathModule contiene il mapping dei moduli ai percorsi di apprendimento. Nota: i moduli possono essere inclusi in più percorsi di apprendimento.

Per altre informazioni sui moduli e i percorsi di apprendimento e sul modo in cui sono correlati ad altri tipi di contenuto, vedere la sezione Modulo e percorsi di apprendimento nell'articolo Tipi di contenuto 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

Il set di dati HierarchyModule contiene informazioni del catalogo su tutti i moduli (corsi).

Per altre informazioni sui moduli e sul modo in cui sono correlati ad altri tipi di contenuto, vedere la sezione Modulo nell'articoloSui tipi di contenuto Learn.

moduleUid title URL iconUrl durationInMinutes punti livelli products ruoli. lingue
learn.languages.powershell-write-first Scrivere il primo codice PowerShell /training/modules/powershell-write-first/ /training/achievements/powershell/powershell-write-first-code.svg 17 200 ["beginner"] ["dotnet"] ["developer","student"] ["powershell"]

HierarchyUnit

Il set di dati HierarchyUnit contiene informazioni del catalogo su tutte le unità (parti di moduli).

Per altre informazioni sulle unità e sul modo in cui sono correlati ad altri tipi di contenuto, vedere la sezione Unità nell'articoloSui tipi di contenuto Learn.

unitUid title URL durationInMinutes punti moduleUid
learn.azure.query-data-sentinel.1-introduction Introduzione /training/modules/query-data-sentinel/1-introduction/ 5 100 azure.query-data-sentinel
learn.azure.query-data-sentinel.2-exercise-setup Esercizio - Eseguire query e visualizzare i dati con le cartelle di lavoro di Azure Sentinel /training/modules/query-data-sentinel/2-exercise-setup/ 10 100 azure.query-data-sentinel

Passaggi successivi

Esaminare le risorse seguenti per facilitare il percorso di sviluppo: