Что представляет собой Microsoft Graph Toolkit?

  • 3 мин

Когда вы создаете веб-приложение и хотите подключить его к Microsoft 365, необходимо реализовать авторизацию и вызвать Microsoft Graph, чтобы извлечь данные, хранящиеся в Microsoft 365.

Чтобы упростить этот процесс, Microsoft Graph Toolkit предоставляет набор веб-компонентов и поставщиков проверки подлинности для подключения веб-приложений к Microsoft 365.

В этом уроке вы узнаете, что такое Microsoft Graph Toolkit и зачем его использовать. Вы также узнаете о различных типах приложений, которые могут использовать этот набор средств.

Обзор Microsoft Graph Toolkit

Microsoft Graph Toolkit — это набор веб-компонентов, которые можно использовать с любой платформой JavaScript для подключения приложения к Microsoft 365. После загрузки набора средств в приложение вы получаете доступ к набору пользовательских HTML-тегов. Эти теги позволяют загружать данные из Microsoft 365.

Например, чтобы отобразить список предстоящих собраний для текущего пользователя, необходимо включить в приложение следующий фрагмент кода.

<mgt-agenda></mgt-agenda>

После этого приложение выполнить отрисовку следующим образом.

Снимок экрана со списком предстоящих собраний, отрисованных компонентом повестки дня Microsoft Graph Toolkit.

Microsoft Graph Toolkit регулярно обновляется с добавлением новых компонентов и функций.

Зачем использовать Microsoft Graph Toolkit?

Вы заметили в предыдущем примере, что вам не нужно было создавать ни одного веб-запроса? Именно поэтому следует рассмотреть возможность использования Microsoft Graph Toolkit.

  • Сосредоточьтесь на создании собственного веб-приложения. Microsoft Graph Toolkit абстрагирует авторизацию и подключение к Microsoft Graph. Вам не нужно беспокоиться об авторизации, создании веб-запросов, обработке откликов и исключений.
  • Настройте отрисовку в соответствии со своим веб-приложением. Все компоненты Microsoft Graph Toolkit готовы к использованию. По умолчанию они отображают данные с помощью Fluent UI — языка дизайна Microsoft 365. Каждый компонент также предоставляет шаблон, позволяющий настроить отрисовку данных.

Когда следует использовать Microsoft Graph Toolkit?

Microsoft Graph Toolkit можно использовать при создании веб-приложений и расширений для Microsoft 365.

  • Используйте Microsoft Graph Toolkit в веб-приложениях. Microsoft Graph Toolkit лучше всего подходит для использования в веб-приложениях. С минимальной настройкой он позволяет пользователям входить в ваше приложение с помощью их учетных записей Microsoft 365. Используя различные компоненты, вы можете загружать данные непосредственно из Microsoft 365, что увеличивает ценность вашего приложения.
  • Создавайте расширения Microsoft 365 с помощью Microsoft Graph Toolkit. Вы также можете использовать Microsoft Graph Toolkit при создании расширений для Microsoft 365, таких как вкладки Teams или веб-части SharePoint Framework. Для создания этих расширений набор средств содержит поставщиков для использования существующих сведений проверки подлинности, предоставляемых посредством Microsoft 365.
  • Используйте Microsoft Graph Toolkit в любой платформе JavaScript. Веб-компоненты Microsoft Graph Toolkit поддерживают все платформы JavaScript. Если вы создаете веб-приложения с помощью React, для React создан специальный пакет набора средств. Этот пакет оформляет компоненты набора средств в виде компонентов React, упрощая передачу сложных данных в компоненты и настройку обработчиков событий.

Загрузка Microsoft Graph Toolkit в веб-части

Если вы создаете веб-приложения без использования средства увязки в пакет, вы можете загрузить Microsoft Graph Toolkit непосредственно из сети доставки содержимого. Чтобы загрузить набор средств из сети доставки содержимого, добавьте в свое веб-приложение следующий фрагмент кода.

<script src="https://unpkg.com/@microsoft/mgt@3/dist/bundle/mgt-loader.js"></script>

Если вы работаете над проектами, в которых используется диспетчер пакетов, например npm, добавьте Microsoft Graph Toolkit в свое веб-приложение, установив пакет @microsoft/mgt:

npm install @microsoft/mgt

Если вы создаете приложения React, установите вместо этого пакет @microsoft/mgt-react:

npm install @microsoft/mgt-react