Поставщик SharePoint

Предостережение

Набор средств Microsoft Graph не рекомендуется использовать. Период выхода на пенсию начинается 1 сентября 2025 года, а полный выход на пенсию запланирован на 28 августа 2026 года. Разработчикам следует перейти на использование пакетов SDK для Microsoft Graph или других поддерживаемых средств Microsoft Graph для создания веб-интерфейсов. Дополнительные сведения см. в объявлении об устаревании.

Используйте поставщика SharePoint в веб-частях SharePoint, чтобы предоставить компонентам доступ к Microsoft Graph.

Дополнительные сведения о поставщиках проверки подлинности см. в статье Поставщики.

Начало работы

Инициализируйте поставщика в методе 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 требуется Typescript 3.7 или более поздней версии. Убедитесь, что вы используете поддерживаемую версию TypeScript, установив соответствующий компилятор.

Пример

Дополнительные сведения о том, как инициализировать поставщик SharePoint, см. в руководстве по началу работы с веб-частью SharePoint .

Тестирование на рабочем месте

Если вы только начинаете работать с веб-частями SharePoint, следуйте руководству в статье Создайте свою первую веб-часть.

Когда вы создадите веб-часть и будете готовы использовать компоненты, убедитесь, что веб-часть имеет соответствующие разрешения для доступа к Microsoft Graph. Подробнее см. в статье Использование Microsoft Graph в SharePoint Framework

Другими словами, к package-solution.json важно добавить соответствующее разрешение. Вам нужно будет отправить пакет веб-части в SharePoint, чтобы администратор утвердил запрошенные разрешения.

Совет

Руководство по началу работы Создание веб-части SharePoint содержит пошаговые инструкции по настройке и утверждению разрешений.

Примечание. Если вы не знаете точно, какие разрешения следует добавить, все разрешения, необходимые для каждого компонента, указаны в документации по нему.