Anbefalte fremgangsmåter for bruk av organisasjonens rapporteringstjeneste for Microsoft Learn
Denne artikkelen beskriver anbefalte fremgangsmåter for bruk av tjenesten Learn Organizational Reporting.
Forstå datatilgangs- og delingsavtalen for Microsoft Learn
Når du bruker denne datadelingstjenesten, anerkjenner og godtar du Datatilgangs- og delingsavtalen for Microsoft Learn for å gjøre det mulig for Microsoft å dele Learn-data med organisasjonen for Learn-brukere som logger på med organisasjonens leier-ID. Les og forstå denne avtalen før du bruker Microsoft Learn Organizational Reporting Service, og inkluder utdataene i ethvert produksjonsmiljø.
Planlegg hvilken rapporteringsløsning du vil bruke til å visualisere dataene som tilbys i denne tjenesten
Microsoft Learn Organizational Reporting-tjenesten gir rå fullføringsdata til organisasjoner og har ingen instrumentbord som standard. Du kan ta dataene og eksportere dem til CSV for raskt å vise dataene, men det må være sammenføyd for å være virkningsfull.
Vi har levert en Learn Organizational Reporting Power BI-mal for SQL DB-lagring som har mange standard datavisualiseringer i seg, men du kan også bruke en hvilken som helst rapporteringsløsning etter eget valg. Planlegg det du ønsker å bruke, slik at du kan koble det til datalagringen som en del av konfigurasjonsprosessen.
Forstå Learn con teltmodus l
Hvis du vil bruke serviceresponsen for Microsoft Learn Organizational Reporting effektivt, er det viktig å forstå innholdstypene som er tilgjengelige i Microsoft Learn og deres relasjoner til hverandre. Se artikkelen om innholdstyper for Learn for mer informasjon.
Spesielt:
- UID står for «Unik ID» og er unik for hvert innholdsobjekt. Hvis en UID endres, selv om tittelen eller andre metadata forblir den samme, regnes innholdet som et nytt objekt.
- Moduler er kjerneobjektet i Learn-opplæringskatalogen. De er alle i stand til å stå alene, i den forstand at de underviser et scenario eller konsept ende-til-ende i dem og ikke krever å ta nødvendige moduler. For noen er dette det, og de er ikke en del av et læringsforløp. For andre er de samlet i ett eller flere læringsforløp som tar en bruker gjennom å bygge mer avanserte konsepter. En modul trenger ikke å være en del av et læringsforløp, eller den kan være en del av én eller flere.
- Enheter skrives ikke som frittstående innhold. De er ment å bli tatt i en bestemt rekkefølge for modulen. Av denne grunn inkluderer vi koblingen til modulens detaljside og den første enheten slik at brukerne kan starte der og fortsette gjennom innholdet.
Forstå hvordan lokalisering fungerer i Learn og hvordan lokalisert innhold gjenspeiles i utdataene for organisasjonsrapportering
Microsoft Learn støtter over 65 nasjonale innstillinger på nettstedet, og mye av innholdet er oversatt til disse nasjonale innstillingene. Vi tar sikte på å gjøre innholdet tilgjengelig på alle språkene som produktet(e) som undervises i innholdet, er tilgjengelig i, men ikke alle lokale opplevelser har oversatt innhold tilgjengelig.
Når en nasjonal innstillingspost ikke har den tilknyttede oversettelsen tilgjengelig, faller innholdet på nettstedet og API-svaret «tilbake» til engelsk som standard. Når det gjelder API-utdata, ser du engelske metadata i andre nasjonale svar når tilbakefall skjer. URL-adressen til innholdet vil imidlertid fortsatt peke til den nasjonale innstillingen, selv om hovedinnholdet kan falle tilbake, og årsaken er å la brukeren fortsatt navigere området i den nasjonale innstillingen (som viser toppteksten/bunnteksten oversatt, og eventuelle andre koblinger som har oversettelse tilgjengelig).
Når oppdateringer publiseres til det engelske innholdet, fungerer lokaliseringssamlebåndene våre for å få de lokaliserte versjonene oppdatert så snart som mulig – vanligvis innen noen få dager etter den opprinnelige endringen. Du kan se en fullstendig liste over støttede nasjonale innstillinger via bunnteksten for området (velg koblingen til språket du viser nettstedet i).
Fullføringspostene for opplæringsinnhold er nasjonale agnostiske, noe som betyr at vi ikke skiller lokaliserte versjoner av innhold som separate objekter i fullføringspostene for brukeropplæring. Uansett hvilket språk en bruker fullfører en opplæring i, mottar de kreditt for det generelle objektet, og vi lagrer ikke en referanse til hvilket språk den ble fullført i. Dette betyr at hvis du implementerer tjenestedataene for Learn Organizational Reporting i læringsopplevelsen, må du ta hensyn til dette, og hvis du laster inn innholdsobjektene i som separate objekter, implementerer du en likhet mellom dem, slik at uansett hvilket språk brukeren fullfører opplæringen i, får de æren for det på de andre språkene og slipper å ta det på nytt.
Forstå hvordan versjonskontroll av innhold fungerer i Learn og hvordan det gjenspeiles i utdataene for organisasjonsrapportering
Innhold oppdateres spesielt hele tiden. Vi publiserer oppdateringer vanligvis to ganger om dagen. De kan enten være underordnede, for eksempel mindre tekstendringer eller hovedendringer, for eksempel store revisjoner, tillegg eller slettinger. Generelt behandles innholdsporteføljen som et massivt, høyt styrt åpen kildekode-prosjekt med tusenvis av bidragsytere, og derfor skjer endringer hele tiden. Hvis du bruker tjenestedataene for Learn Organizational Reporting i produksjonssystemet, bør du være oppmerksom på dette og få systemet til å håndtere det.
Når nye innholdsobjekter legges til, vises de som et nytt objekt (identifisert av UID) i svaret. Når innholdet endres, kan du se basert på den last_modified verdien. Når innholdet slettes, fjernes det fra svaret. Selv om det noen ganger er en liten forsinkelse på innhold som oppdateres i API-svaret, vil de alltid se den nyeste informasjonen når en bruker følger nettadressen til innholdet. Når det gjelder slettinger, omdirigeres den gamle nettadressen til det nye innholdet eller opplevelsen.
Det finnes ingen referanser til innholdsversjoner på dette tidspunktet utover last_modified datoen.
Forstå begrensningene for organisasjonens rapporteringstjeneste
Se oversiktsartikkelen Les om begrensninger i funksjonsoversikten for tjenesten Learn Organizational Reporting.
Oppdater dataene regelmessig
Hvis du bruker kataloginformasjonen fra tjenestedataene for Learn Organizational Reporting til å støtte forretningsprosesser eller vise for kunder som en del av nettstedsopplevelsen, må du kontrollere at du oppdaterer innholdet minst én gang om dagen.
Innhold oppdateres spesielt hele tiden. Vi publiserer oppdateringer vanligvis to ganger om dagen. De kan enten være underordnede, for eksempel mindre tekstendringer eller hovedendringer, for eksempel store revisjoner, tillegg eller slettinger. Generelt behandles innholdsporteføljen som et massivt, høyt styrt åpen kildekode-prosjekt med tusenvis av bidragsytere, og derfor skjer endringer hele tiden. Hvis du bruker tjenestedataene for organisasjonsrapportering i produksjonssystemet, bør du være oppmerksom på dette og få systemet til å håndtere det.
Sørg for at den sammenføyde Microsoft Entra-informasjonen oppdateres regelmessig
Hvis du vil vite hvem hver fullføringspost refererer til, må du koble datasettdataene for organisasjonsrapportering til Microsoft Entra-informasjonen, slik at navnene vises sammen med fullføringspostene. Hvis du ikke oppdaterer microsoft Entra-sammenføyde data, kan det hende du har fullføringsposter med foreldede personaldata, eller som mangler PII-data som er knyttet til dem.
Referanse utviklerdokumentasjonen
Utviklerdokumentasjonen for Learn Organizational Reporting-tjenesten har en fullstendig liste over dataene som er gitt som en del av svaret, og anbefalinger om hvordan hvert felt anbefales å brukes til å støtte gode læringsopplevelser.
Neste trinn
Hvis du vil ha mer informasjon for å støtte deg med Learn Organizational Reporting Service, kan du se følgende artikler: