Che cos'è Microsoft Graph Toolkit?
Quando si compila un'app Web e si desidera connetterla a Microsoft 365, è necessario implementare l'autorizzazione e chiamare Microsoft Graph per recuperare i dati archiviati in Microsoft 365.
Per semplificare questo processo, Microsoft Graph Toolkit fornisce un set di componenti Web e provider di autenticazione per la connessione di app Web a Microsoft 365.
In questa unità si apprenderà cos'è Microsoft Graph Toolkit e sul perché decidere di usarlo. Verranno inoltre illustrati diversi tipi di app che possono usare il toolkit.
Panoramica su Microsoft Graph Toolkit
Microsoft Graph Toolkit è un set di componenti Web che è possibile usare con qualsiasi framework JavaScript per connettere l'app a Microsoft 365. Dopo aver caricato il toolkit nell'app, si ottiene l'accesso a un set di tag HTML personalizzati. Questi tag consentono di caricare dati da Microsoft 365.
Ad esempio, per visualizzare l'elenco delle riunioni imminenti per l'utente corrente, è necessario includere nell'app il frammento di codice seguente:
<mgt-agenda></mgt-agenda>
Verrà quindi eseguito il rendering dell'app:
Microsoft Graph Toolkit viene aggiornato regolarmente con nuovi componenti e funzionalità.
Perché usare Microsoft Graph Toolkit?
Nell'esempio precedente si è notato che non è stato necessario inviare alcuna richiesta Web? Questo è esattamente il motivo per cui è consigliabile prendere in considerazione l'uso di Microsoft Graph Toolkit.
- Concentrarsi sulla creazione della propria app Web: Microsoft Graph Toolkit elimina l'autorizzazione e la connessione a Microsoft Graph. Non è necessario preoccuparsi dell'autorizzazione, della creazione di richieste Web, della gestione delle risposte e della gestione delle eccezioni.
- Personalizzare il rendering in modo che corrisponda all'app Web: Tutti i componenti di Microsoft Graph Toolkit sono pronti per l'uso. Per impostazione predefinita, mostrano i dati usando l'interfaccia utente Fluent, il linguaggio di progettazione di Microsoft 365. Ogni componente espone anche un modello, che consente di personalizzare i dati di cui viene eseguito il rendering.
Quando usare Microsoft Graph Toolkit?
È possibile usare Microsoft Graph Toolkit quando si creano app Web ed estensioni per Microsoft 365.
- Usare Microsoft Graph Toolkit nelle app Web: Microsoft Graph Toolkit è ideale per l'uso nelle applicazioni Web. Con una configurazione minima, consente agli utenti di accedere all'app con il proprio account Microsoft 365. Usando i diversi componenti, è possibile caricare i dati direttamente da Microsoft 365, aumentando il valore dell'app.
- Compilare estensioni Microsoft 365 con Microsoft Graph Toolkit: è anche possibile usare Microsoft Graph Toolkit quando si creano estensioni per Microsoft 365, ad esempio schede di Teams o web part di SharePoint Framework. Per la compilazione di queste estensioni, il toolkit include provider per usare le informazioni di autenticazione esistenti esposte da Microsoft 365.
- Usare Microsoft Graph Toolkit in qualsiasi framework JavaScript: i componenti Web di Microsoft Graph Toolkit funzionano con qualsiasi framework JavaScript. Se si compilano app Web usando React, è disponibile un pacchetto di toolkit specifico per React. Questo pacchetto esegue il wrapping dei componenti del toolkit nei componenti React, semplificando il passaggio di dati complessi nei componenti e la configurazione dei gestori eventi.
Caricare Microsoft Graph Toolkit nell'app Web
Se si creano app Web senza usare un bundler, è possibile caricare Microsoft Graph Toolkit direttamente dalla rete per la distribuzione di contenuti. Per caricare il toolkit dalla rete per la distribuzione di contenuti, aggiungere il frammento di codice seguente all'app Web:
<script src="https://unpkg.com/@microsoft/mgt@3/dist/bundle/mgt-loader.js"></script>
Se si lavora a progetti che usano uno strumento di gestione pacchetti come npm, aggiungere Microsoft Graph Toolkit all'app Web installando il pacchetto @microsoft/mgt:
npm install @microsoft/mgt
Se si compilano app React, installare invece il pacchetto@microsoft/mgt-react:
npm install @microsoft/mgt-react