Procedure consigliate per l'uso del servizio Microsoft Learn Organizational Reporting

Questo articolo descrive le procedure consigliate per l'uso del servizio Learn Organizational Reporting.

Quando si usa questo servizio di condivisione dati, si conferma e si accetta il contratto di accesso e condivisione dei 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 accettare il 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 Microsoft Learn Organizational Reporting fornisce dati di completamento non elaborati alle organizzazioni e non dispone di dashboard per impostazione predefinita. È possibile acquisire i dati ed esportarli in CSV per visualizzarli rapidamente, ma i dati devono essere uniti per avere un impatto significativo.

Informazioni sul modello di contenuto Learn

Per usare in modo efficace il servizio Microsoft Learn Organizational Reporting, è importante comprendere i tipi di contenuto disponibili in Microsoft Learn e le relative relazioni. Per altre informazioni, vedere l'articolo sui tipi di contenuto Learn.

Si noti:

UID è l'acronimo di "Unique ID" (ID univoco) ed è unico per ogni oggetto di contenuto. Se un UID cambia, il contenuto viene considerato un nuovo oggetto anche se il titolo o altri metadati rimangono invariati.
I moduli sono l'oggetto principale nel catalogo di formazione di Learn. Sono autonomi, nel senso che illustrano uno scenario o un concetto completo e non richiedono di seguire 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 sono 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 tradotto in tali impostazioni locali. Il nostro obiettivo è quello di rendere disponibile il contenuto in tutte le lingue in cui sono disponibili i prodotti per cui sono presenti i percorsi di apprendimento, ma non per tutte le esperienze locali è disponibile il contenuto tradotto.

Quando a un record delle impostazioni locali non è associata alcuna traduzione, il contenuto sul sito e la risposta API tornano all'inglese per impostazione predefinita. Nel caso dell'output dell'API, quando si torna all'inglese nelle risposte in altre impostazioni locali i metadati vengono visualizzati in inglese. Tuttavia, l'URL del contenuto punterà comunque alle impostazioni locali, anche se il contenuto principale può tornare all'inglese. Il motivo è quello di consentire all'utente di spostarsi ancora nel sito in tali impostazioni locali (il sito mostra l'intestazione e il piè di pagina tradotti 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 nel piè di pagina del sito (selezionare il collegamento alla lingua in cui si visualizza il sito).

I record di completamento del contenuto di formazione sono indipendenti dalle impostazioni locali, ovvero le versioni localizzate del contenuto non vengono differenziate come oggetti separati nei record di completamento della formazione degli utenti. Indipendentemente dalla lingua in cui un utente completa un corso di formazione, riceverà il credito per l'oggetto complessivo. Non viene archiviato alcun riferimento alla lingua in cui è il corso è stato completato. Ciò significa che se si implementano i dati del servizio Learn Organizational Reporting nell'esperienza di apprendimento, è necessario tenerlo in considerazione e, se si caricano gli oggetti di contenuto come oggetti separati, si deve implementare un'equivalenza tra loro in modo che, indipendentemente dalla lingua in cui l'utente completa la formazione, otterrà il credito relativo anche nelle altre lingue e non dovrà riacquisirlo.

Informazioni sul funzionamento del controllo delle versioni del contenuto in Learn e sul modo in cui si riflette nell'output dei report dell'organizzazione

In particolare, il contenuto viene aggiornato costantemente. 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 di maggior entità. In generale, il portfolio di contenuti viene gestito come un progetto open source estremamente regolamentato con il contributo di migliaia di collaboratori e, di conseguenza, le modifiche vengono sempre apportate. Se si usano i dati del servizio Learn Organizational Reporting nel sistema di produzione, è necessario esserne a conoscenza e disporre del sistema in grado di gestire la situazione.

Quando si aggiungono nuovi oggetti di contenuto, vengono visualizzati come un nuovo oggetto (identificato dall'UID) nella risposta. Quando il contenuto viene modificato, è possibile scoprirlo in base al relativo valore last_modified. Quando il contenuto viene eliminato, viene 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 visualizza sempre le informazioni più aggiornate. In caso di eliminazioni, l'URL precedente viene reindirizzato al nuovo contenuto o alla nuova esperienza.

In questo monento, oltre ai dati last_modified non sono presenti riferimenti alle versioni del contenuto.

Comprendere le limitazioni del servizio Organizational Reporting

Vedere la sezioni Limitazioni nell'articolo Panoramica delle funzionalità del servizio Learn Organizational Reporting.

Aggiornare regolarmente i dati

Se si usano le informazioni del catalogo dai dati del servizio Learn Organizational Reporting per supportare i processi aziendali o per visualizzarle ai clienti nell'ambito dell'esperienza del sito, è necessario aggiornare il contenuto almeno una volta al giorno.

In particolare, il contenuto viene aggiornato costantemente. 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 di maggior entità. In generale, il portfolio di contenuti viene gestito come un progetto open source estremamente regolamentato con il contributo di migliaia di collaboratori e, di conseguenza, le modifiche vengono sempre apportate. Se si usano i dati del servizio Organizational Reporting nel sistema di produzione, è necessario esserne a conoscenza e disporre del sistema in grado di gestire la situazione.

Assicurarsi che le informazioni di Microsoft Entra aggiunte siano aggiornate regolarmente

Per sapere a chi si riferisce ogni record di completamento, è necessario unire i dati del dataset del servizio Organizational Reporting alle informazioni di Microsoft Entra, in modo che i nomi vengano visualizzati accanto ai record di completamento. Se non si aggiornano i dati aggiunti a Microsoft Entra, è possibile che siano presenti record di completamento con dati personali non aggiornati o che tali dati non siano presenti.

Fare riferimento alla documentazione per sviluppatori

La documentazione per sviluppatori del servizio Learn Organizational Reporting include un elenco completo dei dati forniti nell'ambito della risposta e raccomandazioni su come usare ogni campo per supportare esperienze di apprendimento eccezionali.

Passaggi successivi

Per altre informazioni di supporto in relazione all'utente con il servizio Learn Organizational Reporting, vedere gli articoli seguenti:

Last updated on 2026-02-16

Condividi tramite