Рекомендации по созданию microsoft Teams с помощью SharePoint Framework

При использовании SharePoint Framework для сборки для Microsoft Teams вы можете воспользоваться преимуществами, следует учитывать некоторые рекомендации, которые следует учитывать перед созданием следующего приложения.

Совет

Чтобы узнать, как использовать различные понятия, описанные в этой статье, см. пример приложения потенциальных клиентов на сайте GitHub.

Глобальное развертывание пакета решения SharePoint Framework

При использовании SharePoint Framework для создания веб-частей, которые будут предоставляться в Microsoft Teams, необходимо разрешить глобальное развертывание решения. Этот параметр управляется при создании проекта, но его также можно изменить позже в файле package-solution.json , задав свойству skipFeatureDeployment значение true.

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

Предоставление существующего приложения в Microsoft Teams

Если у вас есть веб-приложение, скорее всего, вы не будете переносить его в SharePoint Framework. Так как приложение уже работает, самый простой способ предоставить его в Microsoft Teams — создать для него манифест.

В зависимости от того, как создается приложение, может потребоваться убедиться, что пользователи могут правильно войти в приложение и что приложение может безопасно получить доступ к его API. Когда пользователи работают с приложением в Microsoft Teams, приложение загружается внутри iframe, и реализация проверки подлинности должна правильно поддерживать это.

Поддержка вкладок Microsoft Teams и личных приложений

SharePoint Framework предназначено для расширения пользовательского интерфейса служб, с которыми он используется. Таким образом, он поддерживает создание вкладок Microsoft Teams и личных приложений. Если вам нужны какие-либо настройки, отличные от пользовательского интерфейса, например боты или расширения для обмена сообщениями, вам потребуется создавать их отдельно за пределами решения SharePoint Framework.

Только код на стороне клиента

SharePoint Framework решения состоят только из клиентского кода. Если вашему решению требуется серверный код, например для выполнения длительных операций, запланированных процессов или подключения к другим системам, которые не поддерживают неявный поток OAuth, вам потребуется отдельно создать эту функцию и предоставить ее через API, защищенный с помощью Azure Active Directory. Затем решение SharePoint Framework будет безопасно подключаться к этому API от имени текущего пользователя.

Teams JS SDK

SharePoint Framework предоставляет доступ к пакету SDK для Teams JS через sdks.microsoftTeams свойство в API контекста.

Важно!

Установка и инициализация пользовательских версий пакета SDK для Teams JS не поддерживается. Это применимо к любому компоненту SPFx, включая веб-части, расширения, адаптивные карточки и библиотеки.

Развертывание

SharePoint Online может автоматически создать манифест приложения Microsoft Teams и пакет приложения для SharePoint Framework решений, развернутых в каталоге приложений клиента, или использовать предоставленный разработчиком пакет приложения Microsoft Teams. Дополнительные сведения об этих параметрах см. в статье Варианты развертывания SharePoint Framework решений для Microsoft Teams.