SharePoint プロバイダー

SharePoint Web パーツ内の SharePoint プロバイダーを使用して、Microsoft Graph アクセスでコンポーネントを強化します。

認証プロバイダーの詳細については、「プロバイダー」を参照してください。

開始する

Web パーツの onInit() メソッド内でプロバイダーを初期化します。 この例では、 パッケージを使用します@microsoft/mgt-spfx。

// import the providers at the top of the page
import {Providers, SharePointProvider} from '@microsoft/mgt-spfx';

// add the onInit() method if not already there in your web part class
protected async onInit() {
  Providers.globalProvider = new SharePointProvider(this.context);
}

これで、render() メソッドに任意のコンポーネントを追加でき、SharePoint コンテキストを使用して Microsoft Graph にアクセスします。

public render(): void {
  this.domElement.innerHTML = `
    <mgt-agenda></mgt-agenda>
    `;
}

別のクラウド エンドポイントを使用する

これは、ツールキットを使用して、別の Microsoft 365 エンドポイントからデータをレンダリングする場合に使用します。

// import the providers at the top of the page
import {Providers, SharePointProvider} from '@microsoft/mgt-spfx';
import {GraphEndpoint} from '@microsoft/mgt-element';

const baseUrl: GraphEndpoint = 'https://graph.microsoft.us';

// add the onInit() method if not already there in your web part class
protected async onInit() {
  Providers.globalProvider = new SharePointProvider(this.context, baseUrl=baseUrl);
}

その後、通常どおりツールキットを使用します。

メモ： Microsoft Graph Toolkit には、Typescript 3.7 以降が必要です。 適切なコンパイラ をインストールして、サポートされているバージョンの Typescript を使用していることを確認してください。

サンプル

SharePoint プロバイダーを初期化する方法の詳細については、「SharePoint Web パーツの作成 の概要」ガイドを参照してください。

ワークベンチでテストする

SharePoint Web パーツを使い始めたばかりの場合は、最初の Web パーツの構築のガイダンスに従うことができます。

Web パーツを作成し、コンポーネントを使用する準備ができたら、Web パーツに Microsoft Graph にアクセスするための適切なアクセス許可があることを確認する必要があります。 詳細については、SharePoint Framework で Microsoft Graph を実行する を参照してください。

つまり、package-solution.jsonに適切な権限を追加することが重要です。 Web パーツのパッケージを SharePoint にアップロードし、管理者に要求されたアクセス許可を承認してもらう必要があります。

ヒント

「SharePoint Web パーツの構築入門ガイド」では、アクセス許可を構成および承認するための手順を説明しています。

注: 追加する権限がわからない場合は、各コンポーネントのドキュメントで必要なすべての権限を確認できます。