Что представляет собой Microsoft Graph Toolkit?
Когда вы создаете веб-приложение и хотите подключить его к 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. Вам не нужно беспокоиться об авторизации, создании веб-запросов, обработке откликов и исключений.
- Настройте отрисовку в соответствии со своим веб-приложением. Все компоненты 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