Aanbevolen procedures voor het gebruik van de Microsoft Learn-service voor organisatierapportage
In dit artikel worden de aanbevolen procedures beschreven voor het gebruik van de Learn Organizational Reporting-service.
Informatie over de Microsoft Learn-overeenkomst voor gegevenstoegang en -delen
Wanneer u deze service voor het delen van gegevens gebruikt, erkent en accepteert u de Microsoft Learn-overeenkomst voor gegevenstoegang en -delen, zodat Microsoft Learn-gegevens kan delen met uw organisatie voor Learn-gebruikers die zich aanmelden met de tenant-id van uw organisatie. Lees en begrijp deze overeenkomst voordat u de Microsoft Learn Organizational Reporting Service gebruikt en inclusief de uitvoer in een productieomgeving.
Plan welke rapportageoplossing u gebruikt om de gegevens te visualiseren die in deze service worden aangeboden
De Microsoft Learn-service voor organisatierapportage geeft onbewerkte voltooiingsgegevens aan organisaties en heeft standaard geen dashboards. U kunt de gegevens nemen en exporteren naar CSV om de gegevens snel weer te geven, maar deze moeten worden samengevoegd om van invloed te zijn.
We hebben een Power BI-sjabloon voor Organisatierapportage in Learn voor SQL DB-opslag geleverd die veel standaardgegevensvisualisaties bevat, maar u kunt ook elke rapportageoplossing van uw keuze gebruiken. Plan vooruit wat u wilt gebruiken, zodat u deze kunt verbinden met de gegevensopslag als onderdeel van het installatieproces.
Meer informatie over learn tentmodus l
Als u de reactie van de Microsoft Learn Organizational Reporting-service effectief wilt gebruiken, is het belangrijk om inzicht te krijgen in de typen inhoud die beschikbaar is in Microsoft Learn en hun relaties met elkaar. Raadpleeg het artikel Learn-inhoudstypen voor meer informatie.
Opmerkelijk:
- UID staat voor 'Unieke id' en is uniek voor elk inhoudsobject. Als een UID wordt gewijzigd, zelfs als de titel of andere metagegevens hetzelfde blijven, wordt de inhoud beschouwd als een nieuw object.
- Modules zijn het kernobject in de Learn-trainingscatalogus. Ze zijn allemaal in staat om alleen te staan, in de zin dat ze een scenario of concept end-to-end binnen hen leren en geen vereiste modules hoeven te nemen. Voor sommigen is dit het en ze maken geen deel uit van een leertraject. Voor anderen zijn ze gebundeld in een of meer leertrajecten die een gebruiker begeleiden bij het bouwen van geavanceerdere concepten. Een module hoeft geen deel uit te maken van een leertraject of kan deel uitmaken van een of meer.
- Eenheden worden niet geschreven als zelfstandige inhoud. Ze zijn bedoeld om in een specifieke volgorde voor de module te worden genomen. Daarom voegen we de koppeling naar de detailpagina van de module en de eerste eenheid, zodat gebruikers daar kunnen beginnen en verder kunnen gaan met de inhoud.
Begrijpen hoe lokalisatie werkt in Learn en hoe gelokaliseerde inhoud wordt weerspiegeld in de uitvoer van de organisatierapportage
Microsoft Learn ondersteunt meer dan 65 landinstellingen op de site en veel van de inhoud is vertaald in deze landinstellingen. We streven ernaar om de inhoud beschikbaar te maken in alle talen waarin de producten die in de inhoud worden geleerd, beschikbaar zijn in, maar niet alle landinstellingen hebben vertaalde inhoud beschikbaar.
Wanneer de bijbehorende vertaling niet beschikbaar is voor een landinstellingsrecord, valt de inhoud op de site en het API-antwoord terug naar het Engels als de standaardinstelling. In het geval van de API-uitvoer ziet u Engelse metagegevens in andere landinstellingen wanneer er een terugval plaatsvindt. De URL naar de inhoud verwijst echter nog steeds naar de landinstelling, ook al kan de hoofdinhoud terugvallen en de reden hiervoor is dat de gebruiker nog steeds naar de site in die landinstelling navigeert (waarmee de koptekst/voettekst wordt weergegeven die is vertaald en elke andere koppeling die beschikbaar is voor vertaling).
Wanneer updates worden gepubliceerd naar de Engelse inhoud, werken onze lokalisatiepijplijnen om de gelokaliseerde versies zo snel mogelijk bijgewerkt te krijgen, meestal binnen een paar dagen na de oorspronkelijke wijziging. U ziet een volledige lijst met ondersteunde landinstellingen via de sitevoettekst (selecteer de koppeling naar de taal waarin u de site bekijkt).
Onze records voor het voltooien van trainingsinhoud zijn landinstellingen, wat betekent dat we geen gelokaliseerde versies van inhoud onderscheiden als afzonderlijke objecten in de voltooiingsrecords voor gebruikerstraining. Ongeacht in welke taal een gebruiker een training heeft voltooid, ontvangt hij of zij tegoed voor het algemene object en er wordt geen verwijzing opgeslagen naar de taal waarin deze is voltooid. Dit betekent dat als u de Gegevens van de Learn-organisatierapportageservice in uw leerervaring implementeert, rekening moet worden gehouden met dit, en als u de inhoudsobjecten laadt als afzonderlijke objecten, moet u er een equivalentie tussen implementeren, zodat de gebruiker, ongeacht de taal waarin de gebruiker de training voltooit, het tegoed krijgt in de andere talen en deze niet opnieuw hoeft te volgen.
Begrijpen hoe versiebeheer van inhoud werkt in Learn en hoe dit wordt weerspiegeld in de uitvoer van de organisatierapportage
Inhoud wordt met name steeds bijgewerkt. Updates worden doorgaans twee keer per dag gepubliceerd. Ze kunnen secundair zijn, zoals kleine tekstwijzigingen of primaire wijzigingen, zoals primaire revisies, toevoegingen of verwijderingen. Over het algemeen wordt het inhoudsportfolio beheerd als een enorm, uiterst beheerd opensource-project met duizenden inzenders, en als zodanig gebeuren er voortdurend wijzigingen. Als u de gegevens van de Learn Organizational Reporting-service in uw productiesysteem gebruikt, moet u hiervan op de hoogte zijn en moet u ervoor zorgen dat uw systeem dit kan verwerken.
Wanneer er nieuwe inhoudsobjecten worden toegevoegd, worden ze weergegeven als een nieuw object (geïdentificeerd door UID) in het antwoord. Wanneer inhoud wordt gewijzigd, kunt u dit zien op basis van de last_modified waarde. Wanneer inhoud wordt verwijderd, wordt deze verwijderd uit het antwoord. Hoewel er soms een kleine vertraging optreedt bij het bijwerken van inhoud in het API-antwoord, ziet een gebruiker altijd de meest recente informatie wanneer een gebruiker de URL naar de inhoud volgt. In het geval van verwijderingen wordt de oude URL omgeleid naar de nieuwe inhoud of ervaring.
Er zijn op dit moment geen verwijzingen naar inhoudsversies meer dan de last_modified datum.
Inzicht in de beperkingen van de organisatierapportageservice
Zie beperkingen in het overzichtsartikel van de Learn-service voor organisatierapportage.
De gegevens regelmatig vernieuwen
Als u de catalogusgegevens van de Learn Organizational Reporting-service gebruikt ter ondersteuning van uw bedrijfsprocessen of als onderdeel van uw site-ervaring weergeeft voor klanten, moet u ervoor zorgen dat u de inhoud ten minste één keer per dag vernieuwt.
Inhoud wordt met name steeds bijgewerkt. Updates worden doorgaans twee keer per dag gepubliceerd. Ze kunnen secundair zijn, zoals kleine tekstwijzigingen of primaire wijzigingen, zoals primaire revisies, toevoegingen of verwijderingen. Over het algemeen wordt het inhoudsportfolio beheerd als een enorm, uiterst beheerd opensource-project met duizenden inzenders, en als zodanig gebeuren er voortdurend wijzigingen. Als u de gegevens van de organisatierapportageservice in uw productiesysteem gebruikt, moet u hiervan op de hoogte zijn en moet u ervoor zorgen dat uw systeem dit kan verwerken.
Zorg ervoor dat uw gekoppelde Microsoft Entra-gegevens regelmatig worden vernieuwd
Als u wilt weten naar wie elke voltooiingsrecord verwijst, moet u de gegevensset voor organisatierapportage toevoegen aan uw Microsoft Entra-gegevens, zodat namen naast de voltooiingsrecords worden weergegeven. Als u uw aan Microsoft Entra gekoppelde gegevens niet vernieuwt, hebt u mogelijk voltooiingsrecords met verouderde personeelsgegevens of ontbrekende PII-gegevens die eraan zijn gekoppeld.
Raadpleeg de documentatie voor ontwikkelaars
De documentatie voor de ontwikkelaars van de Learn-organisatierapportageservice bevat een volledige lijst met de gegevens die worden geleverd als onderdeel van het antwoord en aanbevelingen over hoe elk veld wordt aanbevolen om te worden gebruikt om geweldige leerervaringen te ondersteunen.
Volgende stappen
Raadpleeg de volgende artikelen voor meer informatie die u kunt ondersteunen met de Learn Organizational Reporting Service: