Metodtips för att använda tjänsten Organisationsrapportering i Microsoft Learn
I den här artikeln beskrivs metodtipsen för att använda tjänsten Learn Organizational Reporting.
Förstå Microsoft Learn-avtalet för åtkomst och delning av data
När du använder den här datadelningstjänsten bekräftar och godkänner du Microsoft Learn-avtalet för åtkomst och delning av data så att Microsoft kan dela Learn-data med din organisation för Learn-användare som loggar in med organisationens klientorganisations-ID. Läs och förstå det här avtalet innan du använder Microsoft Learn Organizational Reporting Service och inkluderar utdata i alla produktionsmiljöer.
Planera vilken rapporteringslösning du ska använda för att visualisera de data som erbjuds i den här tjänsten
Tjänsten Organisationsrapportering i Microsoft Learn ger rådata till organisationer och har inga instrumentpaneler som standard. Du kan ta data och exportera dem till CSV för att snabbt visa data, men de måste kopplas samman för att påverkas.
Vi har angett en Power BI-mall för learn-organisationsrapportering för SQL DB-lagring som innehåller många standarddatavisualiseringar, men du kan också använda valfri rapporteringslösning. Planera i förväg vad du vill använda, så att du kan ansluta det till datalagringen som en del av konfigurationsprocessen.
Förstå learn con tältläge l
För att kunna använda microsoft learn-tjänstens svar på ett effektivt sätt är det viktigt att förstå vilka typer av innehåll som är tillgängliga i Microsoft Learn och deras relationer till varandra. Mer information finns i artikeln Learn content types (Läs innehållstyper).
Särskilt:
- UID står för "Unikt ID" och är unikt för varje innehållsobjekt. Om ett UID ändras, även om rubriken eller andra metadata förblir desamma, betraktas innehållet som ett nytt objekt.
- Moduler är kärnobjektet i Utbildningskatalogen för Learn. De kan alla stå ensamma, i den meningen att de undervisar i ett scenario eller koncept från slutpunkt till slutpunkt i dem och inte kräver att du tar nödvändiga moduler. För vissa är detta allt, och de ingår inte som en del av någon utbildningsväg. Andra paketeras tillsammans i en eller flera utbildningsvägar där användaren får lära sig mer avancerade begrepp och färdigheter. En modul behöver inte vara en del av en utbildningsväg, men den kan också ingå i flera utbildningsvägar.
- Enheter skrivs inte som fristående innehåll. De är avsedda att tas i en viss ordning för modulen. Det är av det här skälet vi inkluderar länken till modulinformationssidan och den första enheten, så att användarna kan börja där och fortsätta genom innehållet.
Förstå hur lokalisering fungerar i Learn och hur lokaliserat innehåll återspeglas i organisationens rapportutdata
Microsoft Learn stöder över 65 nationella inställningar på webbplatsen och mycket av innehållet har översatts till dessa nationella inställningar. Vi strävar efter att göra innehållet tillgängligt på alla språk som de produkter som lärs ut i innehållet är tillgängliga i, men inte alla språkupplevelser har översatt innehåll tillgängligt.
När en språkpost inte har den associerade översättningen tillgänglig, faller innehållet på webbplatsen och API-svaret "tillbaka" till engelska som standard. När det gäller API-utdata ser du engelska metadata i andra nationella svar när återställning sker. Url:en till innehållet pekar dock fortfarande på språkvarianten, även om huvudinnehållet kan falla tillbaka och orsaken är att användaren fortfarande kan navigera på webbplatsen i det nationella språket (som visar sidhuvud/sidfot översatt och alla andra länkar som har översättning tillgänglig).
När uppdateringar publiceras till det engelska innehållet fungerar våra lokaliseringspipelines för att få de lokaliserade versionerna uppdaterade så snart som möjligt – vanligtvis inom några dagar efter den ursprungliga ändringen. Du kan se en fullständig lista över språk som stöds via webbplatsfoten (välj länken till det språk som du visar webbplatsen i).
Våra utbildningsinnehållsavslutsposter är språkbaserade, vilket innebär att vi inte särskiljer lokaliserade versioner av innehåll som separata objekt i våra användarutbildningsavslutsposter. Oavsett vilket språk en användare slutför en utbildning i får de kredit för det övergripande objektet och vi lagrar ingen referens till vilket språk det har slutförts i. Det innebär att om du implementerar learn organizational reporting service-data i din inlärningsupplevelse måste du ta hänsyn till detta och, om du läser in innehållsobjekten i som separata objekt, implementerar en likvärdighet mellan dem så att användaren, oavsett vilket språk som användaren slutför utbildningen i, får kredit för det på de andra språken och inte behöver göra om det.
Förstå hur versionshantering av innehåll fungerar i Learn och hur det återspeglas i organisationens rapportutdata
I synnerhet uppdateras innehållet hela tiden. Vi publicerar uppdateringar vanligtvis två gånger om dagen. De kan antingen vara mindre, till exempel mindre textändringar eller större, till exempel större revisioner, tillägg eller borttagningar. I allmänhet hanteras innehållsportföljen som ett massivt, starkt styrt projekt med öppen källkod med tusentals deltagare, och därför sker ändringar hela tiden. Om du använder Learn Organizational Reporting-tjänstdata i produktionssystemet bör du vara medveten om detta och låta systemet hantera dem.
När nya innehållsobjekt läggs till visas de som ett nytt objekt (identifieras av UID) i svaret. När innehållet ändras kan du se baserat på dess last_modified värde. När innehållet tas bort tas det bort från svaret. Även om det ibland uppstår en liten fördröjning på innehåll som uppdateras i API-svaret, visas alltid den senaste informationen när en användare följer URL:en till innehållet. När det gäller borttagningar omdirigeras den gamla URL:en till det nya innehållet eller upplevelsen.
Det finns inga referenser till innehållsversioner just nu efter last_modified datumet.
Förstå begränsningarna i tjänsten organisationsrapportering
Mer information finns i artikeln Om begränsningar i funktionsöversikten för Learn Organizational Reporting Service.
Uppdatera data regelbundet
Om du använder kataloginformationen från Learn Organizational Reporting Service-data för att stödja dina affärsprocesser, eller om du visar för kunder som en del av din webbplatsupplevelse, kontrollerar du att du uppdaterar innehållet minst en gång om dagen.
I synnerhet uppdateras innehållet hela tiden. Vi publicerar uppdateringar vanligtvis två gånger om dagen. De kan antingen vara mindre, till exempel mindre textändringar eller större, till exempel större revisioner, tillägg eller borttagningar. I allmänhet hanteras innehållsportföljen som ett massivt, starkt styrt projekt med öppen källkod med tusentals deltagare, och därför sker ändringar hela tiden. Om du använder organisationsrapporteringstjänstens data i produktionssystemet bör du vara medveten om detta och låta systemet hantera dem.
Se till att din anslutna Microsoft Entra-information uppdateras regelbundet
För att veta vem varje slutförandepost refererar till måste du ansluta datauppsättningen organisationsrapportering till din Microsoft Entra-information, så namn visas tillsammans med slutförandeposterna. Om du inte uppdaterar dina Microsoft Entra-anslutna data kan du ha slutförda poster med inaktuella personaldata eller som saknar PII-data som är associerade med dem.
Referera till utvecklardokumentationen
Utvecklardokumentationen för Learn Organizational Reporting-tjänsten innehåller en fullständig lista över de data som tillhandahålls som en del av svaret och rekommendationer om hur varje fält rekommenderas att användas för att stödja fantastiska inlärningsupplevelser.
Nästa steg
Mer information om hur du stöder dig med Learn Organizational Reporting Service finns i följande artiklar: