Procedure consigliate per l'uso del servizio di creazione report di Microsoft Learn
Questo articolo descrive le procedure consigliate per l'uso del servizio Learn Organizational Reporting.
Informazioni sul contratto di condivisione e accesso ai dati di Microsoft Learn
Quando si usa questo servizio di condivisione dei dati, si riconosce e si accetta il Contratto di condivisione e accesso ai dati di Microsoft Learn per consentire a Microsoft di condividere i dati di Learn con l'organizzazione per gli utenti di Learn che accedono con l'ID tenant dell'organizzazione. Leggere e comprendere questo contratto prima di usare Microsoft Learn Organizational Reporting Service e includere l'output in qualsiasi ambiente di produzione.
Pianificare la soluzione di creazione di report che verrà usata per visualizzare i dati offerti in questo servizio
Il servizio di creazione di report aziendali di Microsoft Learn fornisce dati di completamento non elaborati alle organizzazioni e non dispone di dashboard per impostazione predefinita. È possibile portare i dati ed esportarli in CSV per visualizzare rapidamente i dati, ma devono essere uniti per avere un impatto significativo.
È stato fornito un modello di Power BI per la creazione di report aziendali per l'archiviazione del database SQL che include molte visualizzazioni dei dati standard, ma è anche possibile usare qualsiasi soluzione di creazione di report preferita. Pianificare in anticipo ciò che si vuole usare, in modo da poterlo connettere all'archiviazione dei dati come parte del processo di configurazione.
Informazioni sul modello di contenuto Learn
Per usare in modo efficace la risposta di Power BI per la creazione di report aziendali, è importante comprendere i tipi di contenuto disponibili in Microsoft Learn e le relative relazioni tra loro. Per altre informazioni, vedere l'articolo Informazioni sui tipi di contenuto.
Considerevolmente:
- UID è l'acronimo di "Unique ID" ed è univoco per ogni oggetto contenuto. Se un UID cambia, anche se il titolo o altri metadati rimangono invariati, il contenuto viene considerato un nuovo oggetto.
- I moduli sono l'oggetto principale all'interno del catalogo di training di Learn. Sono tutti in grado di stare da soli, nel senso che insegnano uno scenario o un concetto end-to-end all'interno di essi e non richiedono moduli prerequisiti. In alcuni casi si tratta di moduli completi che non fanno parte di alcun percorso di apprendimento. In altri casi i moduli vengono aggregati in uno o più percorsi di apprendimento per consentire a un utente di acquisire concetti più avanzati. Un modulo non deve necessariamente far parte di un percorso di apprendimento oppure può far parte di uno o più percorsi.
- Le unità non vengono scritte come contenuto autonomo. Devono essere eseguite in un ordine specifico per il modulo. Per questo motivo viene incluso il collegamento alla pagina dei dettagli del modulo e alla prima unità in modo che gli utenti possano iniziare da tale punto e procedere esplorando tutti i contenuti.
Informazioni sul funzionamento della localizzazione in Learn e sul modo in cui il contenuto localizzato si riflette nell'output dei report dell'organizzazione
Microsoft Learn supporta più di 65 impostazioni locali nel sito e gran parte del contenuto è stato convertito in queste impostazioni locali. Il nostro obiettivo è rendere disponibile il contenuto in tutte le lingue in cui sono disponibili i prodotti in cui sono insegnati i contenuti, ma non tutte le esperienze locali hanno contenuto tradotto.
Quando un record delle impostazioni locali non ha la traduzione associata disponibile, il contenuto nel sito e la risposta API "esegue il fallback" all'inglese come impostazione predefinita. Nel caso dell'output dell'API, verranno visualizzati i metadati in lingua inglese in altre risposte delle impostazioni locali quando si verifica il fallback. Tuttavia, l'URL del contenuto punterà comunque alle impostazioni locali, anche se il contenuto principale può eseguire il fallback e il motivo è consentire all'utente di spostarsi ancora nel sito in tali impostazioni locali (che mostrerà l'intestazione/piè di pagina tradotta e qualsiasi altro collegamento con traduzione disponibile).
Quando gli aggiornamenti vengono pubblicati nel contenuto in lingua inglese, le pipeline di localizzazione funzionano per aggiornare le versioni localizzate il prima possibile, in genere entro pochi giorni dalla modifica originale. È possibile visualizzare un elenco completo delle impostazioni locali supportate tramite il piè di pagina del sito (selezionare il collegamento alla lingua in cui si sta visualizzando il sito).
I record di completamento del contenuto di training sono indipendenti dalle impostazioni locali, ovvero non si differenziano le versioni localizzate del contenuto come oggetti separati nei record di completamento del training utente. Indipendentemente dalla lingua in cui un utente completa un training, riceverà il credito per l'oggetto complessivo e non archiviamo un riferimento alla lingua in cui è stata completata. Ciò significa che se si implementano i dati del servizio Learn Organizational Reporting Service nell'esperienza di apprendimento, è necessario prenderlo in considerazione e, se si caricano gli oggetti contenuto in come oggetti separati, implementare un'equivalenza tra di essi in modo che, indipendentemente dalla lingua in cui l'utente completa il training, otterrà il credito per esso nelle altre lingue e non dovrà riprenderlo.
Informazioni sul funzionamento del controllo delle versioni del contenuto in Learn e sul modoin cui si riflette nell'output dei report dell'organizzazione
In particolare, il contenuto viene aggiornato sempre. Gli aggiornamenti vengono pubblicati in genere due volte al giorno. Possono essere minori, ad esempio modifiche di testo secondarie o importanti, ad esempio revisioni, aggiunte o eliminazioni principali. In generale, il portfolio di contenuti viene gestito come un progetto open source estremamente regolamentato e altamente regolamentato con migliaia di collaboratori e, di conseguenza, le modifiche stanno accadendo sempre. Se si usa l'API Learn Catalog nel sistema di produzione del servizio di creazione di report aziendali Learn, è necessario essere a conoscenza di questo e avere il sistema in grado di gestirlo.
Quando vengono aggiunti nuovi oggetti contenuto, questi verranno visualizzati come nuovo oggetto (identificato dall'UID) nella risposta. Quando il contenuto viene modificato, è possibile indicare in base al relativo valore last_modified. Quando il contenuto viene eliminato, verrà rimosso dalla risposta. Anche se a volte si verifica un lieve ritardo nell'aggiornamento del contenuto nella risposta dell'API, quando un utente segue l'URL del contenuto, visualizzerà sempre le informazioni più aggiornate. In caso di eliminazioni, l'URL precedente verrà reindirizzato al nuovo contenuto o esperienza.
Non sono presenti riferimenti alle versioni del contenuto in questo momento oltre la last_modified data.
Comprendere le limitazioni del servizio di creazione di report dell'organizzazione
Vedere Limitazioni nell'articolo panoramica delle funzionalità del servizio di creazione report di Microsoft Learn.
Aggiornare regolarmente i dati
Se si usano le informazioni sul catalogo o dei dati del servizio della creazione di report aziendali di Learn per supportare i processi aziendali o visualizzare i clienti come parte dell'esperienza del sito, assicurarsi di aggiornare il contenuto almeno una volta al giorno.
In particolare, il contenuto viene aggiornato sempre. Gli aggiornamenti vengono pubblicati in genere due volte al giorno. Possono essere minori, ad esempio modifiche di testo secondarie o importanti, ad esempio revisioni, aggiunte o eliminazioni principali. In generale, il portfolio di contenuti viene gestito come un progetto open source estremamente regolamentato e altamente regolamentato con migliaia di collaboratori e, di conseguenza, le modifiche stanno accadendo sempre. Se si usano i dati del servizio della creazione di report aziendali di Learn nel sistema di produzione, è necessario essere a conoscenza di questo e avere il sistema in grado di gestirlo.
Assicurarsi che le informazioni di Microsoft Entra aggiunte vengano aggiornate regolarmente
Per sapere a chi si riferisce ogni record di completamento, è necessario aggiungere i dati del set di dati di creazione di report dell'organizzazione alle informazioni di Microsoft Entra insieme ai record di completamento. Se non si aggiornano i dati aggiunti a Microsoft Entra, è possibile che siano presenti record di completamento con dati del personale non aggiornati o che non siano presenti dati personali associati.
Fare riferimento alla documentazione per sviluppatori
La documentazione per sviluppatori del servizio di creazione di report aziendali Learn include un elenco completo dei dati forniti come parte della risposta e raccomandazioni su come usare ogni campo per supportare esperienze di apprendimento eccezionali.
Passaggi successivi
Per altre informazioni per supportare l'utente con il servizio di creazione di report aziendali Learn, vedere gli articoli seguenti: