Bedste fremgangsmåder til brug af Microsoft Learn Organisationsrapporteringstjeneste
I denne artikel beskrives de bedste fremgangsmåder til brug af Learn-organisationsrapporteringstjenesten.
Forstå Microsoft Learn-dataadgangs- og -delingsaftalen
Når du bruger denne datadelingstjeneste, anerkender og accepterer du Microsoft Learn-dataadgangs- og -delingsaftalen for at gøre det muligt for Microsoft at dele Learn-data med din organisation for Learn-brugere, der logger på med din organisations lejer-id. Læs og forstå denne aftale, før du bruger Microsoft Learn Organisationsrapporteringstjeneste og medtager outputtet i et hvilket som helst produktionsmiljø.
Planlæg, hvilken rapporteringsløsning du vil bruge til at visualisere de data, der tilbydes i denne tjeneste
Microsoft Learn Organisationsrapporteringstjenesten giver rådata til organisationer og har ingen dashboards som standard. Du kan tage dataene og eksportere dem til CSV for hurtigt at få vist dataene, men de skal sammenføjes for at være virkningsfulde.
Vi har leveret en Learn Organization Reporting Power BI-skabelon til SQL DB-lager , der indeholder mange standarddatavisualiseringer, men du kan også bruge en hvilken som helst rapporteringsløsning efter eget valg. Planlæg, hvad du vil bruge, så du kan forbinde det med datalageret som en del af konfigurationsprocessen.
Forstå learn con telttilstand l
Hvis du vil bruge svaret fra Microsoft Learn Organisationsrapporteringstjeneste effektivt, er det vigtigt at forstå de typer indhold, der er tilgængelige i Microsoft Learn, og deres relationer til hinanden. Gennemse artiklen Learn-indholdstyper for at få flere oplysninger.
Især:
- UID står for "Entydigt id" og er entydigt for hvert indholdsobjekt. Hvis et UID ændres, selvom titlen eller andre metadata forbliver det samme, betragtes indholdet som et nyt objekt.
- Moduler er kerneobjektet i læringskataloget. De er alle i stand til at stå alene i den forstand, at de underviser i et scenarie eller et koncept fra ende til anden i dem og ikke kræver, at de tager forudsætningsmoduler. For nogle er dette det hele, og de er ikke en del af et læringsforløb. For andre er de samlet i et eller flere læringsforløb, der fører en bruger gennem opbygning af mere avancerede koncepter. Et modul behøver ikke at være en del af et læringsforløb, eller det kan være en del af et eller flere.
- Enheder skrives ikke som separat indhold. De er beregnet til at blive taget i en bestemt rækkefølge for modulet. Derfor inkluderer vi linket til siden med moduloplysninger og den første enhed, så brugerne kan starte der og fortsætte gennem indholdet.
Forstå, hvordan lokalisering fungerer i Learn, og hvordan lokaliseret indhold afspejles i outputtet til organisationsrapportering
Microsoft Learn understøtter mere end 65 landestandarder på webstedet, og meget af indholdet er oversat til disse landestandarder. Vi tilstræber at gøre indholdet tilgængeligt på alle de sprog, som det eller de produkter, der undervises i indholdet, er tilgængeligt på, men ikke alle landestandardoplevelser har oversat indhold tilgængeligt.
Når en landestandardpost ikke har den tilknyttede oversættelse tilgængelig, falder indholdet på webstedet og API-svaret "tilbage" til engelsk som standard. Hvis der er tale om API-outputtet, kan du se engelske metadata i andre landestandardsvar, når der opstår tilbagefald. URL-adressen til indholdet peger dog stadig på landestandarden, selvom hovedindholdet kan falde tilbage, og årsagen er, at brugeren stadig skal kunne navigere på webstedet i den pågældende landestandard (som viser det oversatte sidehoved/sidefod og alle andre links, hvor oversættelse er tilgængelig).
Når der publiceres opdateringer til det engelske indhold, arbejder vores lokaliseringspipelines på at få de oversatte versioner opdateret så hurtigt som muligt – normalt inden for et par dage efter den oprindelige ændring. Du kan se en komplet liste over understøttede landestandarder via webstedsfoden (vælg linket til det sprog, du får vist webstedet på).
Vores poster for fuldførelse af oplæringsindhold er landestandardagnostiske, hvilket betyder, at vi ikke skelner oversatte versioner af indhold som separate objekter i vores poster for fuldførelse af brugertræning. Uanset hvilket sprog en bruger gennemfører en oplæring på, modtager vedkommende kredit for det overordnede objekt, og vi gemmer ikke en reference til, hvilket sprog den blev fuldført på. Det betyder, at hvis du implementerer data fra Learn Organisationsrapportering i din læringsoplevelse, skal du tage højde for dette, og hvis du indlæser indholdsobjekterne i som separate objekter, skal du implementere en ækvivalens mellem dem, så uanset hvilket sprog brugeren fuldfører træningen på, får vedkommende kredit for den på de andre sprog og ikke behøver at tage den igen.
Forstå, hvordan versionering af indhold fungerer i Learn, og hvordan det afspejles i outputtet til organisationsrapportering
Især opdateres indhold hele tiden. Vi publicerer opdateringer typisk to gange om dagen. De kan enten være mindre, f.eks. mindre tekstændringer eller større, f.eks. større ændringer, tilføjelser eller sletninger. Indholdsporteføljen administreres generelt som et massivt, højt styret projekt med åben kildekode med tusindvis af bidragydere, og som sådan sker der ændringer hele tiden. Hvis du bruger data fra Learn Organisationsrapporteringstjeneste i dit produktionssystem, skal du være opmærksom på dette og have dit system i stand til at håndtere det.
Når der tilføjes nye indholdsobjekter, vises de som et nyt objekt (identificeret af UID) i svaret. Når indhold ændres, kan du se det på baggrund af dens last_modified værdi. Når indhold slettes, fjernes det fra svaret. Selvom der nogle gange er en lille forsinkelse i indhold, der opdateres i API-svaret, når en bruger følger URL-adressen til indholdet, får vedkommende altid vist de mest aktuelle oplysninger. I tilfælde af sletninger omdirigerer den gamle URL-adresse til det nye indhold eller den nye oplevelse.
Der er ingen referencer til indholdsversioner på nuværende tidspunkt efter last_modified datoen.
Forstå begrænsningerne i organisationsrapporteringstjenesten
Se artiklen Begrænsninger i artiklen Oversigt over funktioner i Learn Organisationsrapporteringstjeneste.
Opdater dataene regelmæssigt
Hvis du bruger katalogoplysningerne fra dataene i Learn Organisationsrapportering til at understøtte dine forretningsprocesser eller vise for kunder som en del af din webstedsoplevelse, skal du sørge for at opdatere indholdet mindst én gang om dagen.
Især opdateres indhold hele tiden. Vi publicerer opdateringer typisk to gange om dagen. De kan enten være mindre, f.eks. mindre tekstændringer eller større, f.eks. større ændringer, tilføjelser eller sletninger. Indholdsporteføljen administreres generelt som et massivt, højt styret projekt med åben kildekode med tusindvis af bidragydere, og som sådan sker der ændringer hele tiden. Hvis du bruger dataene fra organisationsrapporteringstjenesten i dit produktionssystem, skal du være opmærksom på dette og have dit system i stand til at håndtere det.
Sørg for, at dine tilmeldte Microsoft Entra-oplysninger opdateres regelmæssigt
Hvis du vil vide, hvem hver fuldførelsespost refererer til, skal du føje data fra organisationsrapporteringsdatasættet til dine Microsoft Entra-oplysninger, så navnene vises sammen med fuldførelsesposterne. Hvis du ikke opdaterer dine Microsoft Entra-joinforbundne data, kan du have fuldførelsesposter med forældede personaledata, eller der mangler pii-data, der er knyttet til dem.
Se udviklerdokumentationen
Udviklerdokumentationen til Learn Organisationsrapporteringstjeneste indeholder en komplet liste over de data, der leveres som en del af svaret, og anbefalinger til, hvordan hvert felt anbefales at blive brugt til at understøtte gode læringsoplevelser.
Næste trin
Du kan finde flere oplysninger, der kan hjælpe dig med Learn Organisationsrapporteringstjeneste, i følgende artikler: