Расширение личной вкладки Teams в Microsoft 365

Примечание

Расширение личной вкладки Teams во всех Microsoft 365 в настоящее время доступно только в предварительном просмотре общедоступных разработчиков. Функции, включенные в предварительный просмотр, могут быть не завершены и могут претерпеть изменения перед тем, как стать доступными в публичном выпуске. Они предоставляются только для тестирования и разведки. Они не должны использоваться в производственных приложениях.

Личные вкладки предоставляют отличный способ улучшить Microsoft Teams. С помощью личных вкладок вы можете предоставить пользователю доступ к приложению прямо в Teams, без необходимости повторного доступа пользователя к интерфейсу или входу. С помощью этого предварительного просмотра личные вкладки могут заживеть в других Microsoft 365 приложениях. В этом руководстве демонстрируется процесс принятия существующей личной вкладки Teams и ее обновления для запуска как в Outlook, так и в веб-опытом, а также Microsoft Office Home (office.com).

Обновление личного приложения для запуска в Outlook и Office Home включает следующие действия:

  • Обновление манифеста приложения
  • Обновление ссылок teamsJS SDK
  • Изменение заглавных заглавок политики безопасности контента
  • Обновление AAD регистрации приложения для единого знака (SSO)

Тестирование приложения потребует следующих действий:

  • Регистрация клиента M365 в Office 365 целевых выпусках
  • Настройка учетной записи для доступа к предварительным версиям Outlook и Office приложений
  • Перенагрузите обновленное приложение в Teams

После этих действий приложение должно отображаться в предварительных версиях Outlook и Office приложениях.

Предварительные требования

Чтобы завершить этот учебник, вам потребуется:

  • Клиент Microsoft 365 программы разработчиков
  • Клиент песочницы, зарегистрированный в Office 365 целевых выпусках
  • Машина с Office приложениями, установленными с Приложения Microsoft 365 бета-канала
  • (Необязательный) Teams набор средств расширения для Visual Studio Code, чтобы помочь обновить код

Подготовка личной вкладки для обновления

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

Если вы хотите использовать пример кода для завершения этого руководства, выполните действия по настройке в примере списка Todo для создания личного приложения вкладки с помощью расширения Teams набор средств для Visual Studio Code. Или можно начать с того же образца списка Todo, обновленного для TeamsJS SDK v2 Preview, и перейти к просмотру личной вкладки в других Microsoft 365 опытом. Обновленный пример также доступен в расширении Teams набор средств: образцы > > Todo View (Работает в Teams, Outlook и Office).

{alt-text}

Обновление манифеста приложения

Чтобы включить личную вкладку Teams в Office и Outlook, необходимо использовать схему предварительного просмотра Teams m365DevPreview разработчика и версию манифеста.

Вы можете использовать Teams набор средств для обновления манифеста приложения или применять изменения вручную:

  1. Откройте палитру Команд:Ctrl+Shift+P
  2. Запустите Teams: Upgrade Teams manifest to support Outlook and Office apps команду и выберите файл манифеста приложения. Изменения будут внесены на месте.

Если вы Teams набор средств для создания личного приложения, вы также можете использовать его для проверки изменений в файле манифеста и выявления ошибок. Откройте палитру команд и Teams: проверьте файл манифеста или выберите параметр из меню развертывания Teams набор средств (найдите значок Teams слева от Ctrl+Shift+P Visual Studio Code).

Teams набор средств параметр "Проверка файла манифеста" в меню "Развертывание"

Обновление ссылок на SDK

Чтобы запустить Outlook Office, вашему приложению необходимо будет зависеть от пакета npm @microsoft/teams-js@2.0.0-beta.1 или выше. Хотя код с downlevel версиями поддерживается в Outlook и Office, предупреждения об амортизации будут зарегистрированы, и поддержка downlevel версий в Outlook и Office в конечном итоге @microsoft/teams-js @microsoft/teams-js прекратится.

Вы можете Teams набор средств, чтобы автоматизировать некоторые изменения кода, чтобы принять следующую версию, но если вы хотите сделать шаги вручную, см. в Microsoft Teams JavaScript клиента @microsoft/teams-js SDK Preview для подробных сведений.

  1. Откройте палитру Команд:Ctrl+Shift+P
  2. Запуск команды Teams: Upgrade Teams JS SDK references to support Outlook and Office apps

По завершении утилита обновит файл с зависимостью package.json TeamsJS SDK Preview () и ваши файлы будут обновлены с @microsoft/teams-js@2.0.0-beta.1 *.js/.ts *.jsx/.tsx помощью:

  • package.json ссылки на предварительный просмотр TeamsJS SDK
  • Отчеты об импорте для предварительного просмотра командных команд SDK
  • Вызовы функции, enum и интерфейса для предварительного просмотра TeamsJS SDK
  • TODOнапоминания о комментариях для просмотра областей, на которые могут повлиять изменения интерфейса Context
  • TODO напоминания комментариев для обеспечения преобразования функций обещаний из функций стилей вызова прошли хорошо на каждом сайте вызова найденного средства

Важно!

Код внутри .html не поддерживается инструментом обновления и требует ручных изменений.

Примечание

Если вы хотите вручную обновить код, Microsoft Teams javaScript клиент SDK Preview, чтобы узнать о необходимых изменениях.

Настройка заглавных заглавок политики безопасности контента

Как и в Microsoft Teams,приложения вкладок находятся внутри(элементы iframe)в Office и Outlook веб-клиентах.

Если ваше приложение использует заглавные материалы политики безопасности контента (CSP), убедитесь, что вы разрешаете всем следующим предкам кадра в своих загонах CSP:

Microsoft 365 хост разрешение фрейм-предка
Teams teams.microsoft.com
Кабинет *.office.com
Outlook outlook.office.com, outlook.office365.com

Обновление AAD регистрации приложений для SSO

Azure Active Directory для личных вкладок работает так же, как в Office и Outlook, как и в Teamsгоду, однако вам потребуется добавить несколько идентификаторов клиентских приложений к регистрации приложения AAD приложения в приложении на портале регистрации приложений клиента.

  1. Во входе на портал Azure с учетной записью клиента в песочнице.
  2. Откройте лезвие регистрации приложений.
  3. Выберите имя личного приложения вкладки, чтобы открыть регистрацию приложения.
  4. Выберите Expose aPIстатье Управление).

Авторизация ид клиента из лезвия *App registrations* на портале Azure

В разделе Авторизованные клиентские приложения убедитесь, что добавлены все следующие Client Id значения:

Microsoft 365 клиентского приложения Идентификатор клиента
Teams, мобильный 1fec8e78-bce4-4aaf-ab1b-5451cc387264
Teams веб 5e3ce6c0-2b1f-4285-8d4b-75ee78787346
Office.com 4345a7b9-9a63-4910-a426-35363201d503
Office.com 4765445b-32c6-49b0-83e6-1d93765276ca
Office рабочего стола 0ec893e0-5785-4de6-99da-4ed124e5296c
Классическое приложение Outlook d3590ed6-52b3-4102-aeff-aad2292ab01c
Outlook Web Access 00000002-0000-0ff1-ce00-00000000000000
Outlook Web Access bc59ab01-8403-45c6-8796-ac3ef710b3e3

Sideload ваше приложение в Teams

Последний шаг — загрузка обновленной личной вкладки(пакетаприложений) в Microsoft Teams. После завершения работы приложение будет доступно для Office и Outlook, а также Teams.

  1. Пакет Teams приложения (манифест и значкиприложений) в файл zip. Если вы Teams набор средств для создания приложения, вы можете легко сделать это с помощью параметра пакета метаданных Zip Teams в меню развертывания Teams набор средств или в командной палитре Ctrl+Shift+P Visual Studio Code:

    Параметр "Пакет Teams метаданных" в Teams набор средств для Visual Studio Code

  2. Войдите Teams учетную запись клиента в песочнице и убедитесь, что вы находитесь в Developer Preview. Вы можете убедиться, что вы на предварительном просмотре в клиенте Teams, нажав на ellipsis ( ...) меню по вашему профиле пользователя и открытие о том, чтобы проверить, что параметр предварительного просмотра разработчика перегнул.

    Из Teams эллипсов откройте параметр "About" и убедитесь, что Developer Preview 'проверяется"

  3. Откройте области приложений, и нажмите Upload настраиваемом приложении, а затем Upload для меня или моей команды.

    Кнопка Upload настраиваемом приложении в области Teams "Приложения"

  4. Выберите пакет приложения и нажмите кнопку Открыть.

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

Вы можете прикрепить приложение для быстрого доступа, или вы можете найти свое приложение в эллипсах (...) вылет среди последних приложений в боковой панели слева.

Примечание

Закрепление приложения в Teams не прикрепит его в качестве приложения в Office.com или Outlook.

Просмотр личной вкладки в других Microsoft 365 опытом

При обновлении личной вкладки Teams и ее боковой загрузке в Teams она также будет работать в Outlook настольных и веб-клиентах и Microsoft Office Home (office.com). Вот как просмотреть его из этих Microsoft 365 опытом.

Outlook

Чтобы просмотреть приложение, Outlook на Windows, запустите Outlook и вопишитесь с помощью учетной записи клиента разработчика. Нажмите на эллипсы (...) на боковой панели. В установленных приложениях появится заголовок приложения с боковой загрузкой.

Нажмите на параметр эллипсы ('More apps') на боковой панели, чтобы увидеть установленные личные вкладки

Щелкните значок приложения, чтобы запустить приложение в Outlook.

Outlook в Интернете

Чтобы просмотреть приложение в Outlook в Интернете, посетите и https://outlook.office.com вопишитесь с помощью учетной записи клиента разработчика. Нажмите на эллипсы (...) на боковой панели. В установленных приложениях появится заголовок приложения с боковой загрузкой.

Щелкните значок приложения для запуска и предварительного просмотра приложения, запущенного в Outlook в Интернете.

Microsoft Office Главная

Чтобы просмотреть приложение в Microsoft Office Home, войдите в office.com с помощью тестовых учетных данных клиента. Нажмите на эллипсы (...) на боковой панели. В установленных приложениях появится заголовок приложения с боковой загрузкой.

Щелкните значок приложения, чтобы запустить приложение в Office Home.

Дальнейшие действия

Outlook и Office с включенной поддержкой личных вкладок находятся в предварительном просмотре и не поддерживаются для использования в производстве. Вот как распределить личное приложение вкладки для предварительного просмотра аудиторий для целей тестирования.

Распределение с одним клиентом

Outlook и Office личные вкладки с поддержкой Office могут быть распространены среди аудитории предварительного просмотра в клиенте тестовых (или производственных) одним из трех способов:

Teams клиента

Из меню Apps выберите Управление приложениями > Отправка приложения в вашу организацию. Для этого требуется утверждение от ИТ-администратора.

Microsoft Teams Центр администрирования

Как администратор Teams, вы можете загрузить и предварительно установить пакет приложений для клиента вашей организации из https://admin.teams.microsoft.com/ . Подробные сведения Upload настраиваемые приложения в Microsoft Teams центре администрирования.

Центр администрирования Майкрософт

В качестве глобального администратора вы можете загрузить и предварительно установить пакет приложений из https://admin.microsoft.com/ . Дополнительные сведения см. в Приложения Microsoft 365 и развертывании Приложения Microsoft 365 партнеров на портале интегрированных приложений.

Распределение с несколькими арендаторами

Распространение в Microsoft AppSource не поддерживается во время предварительного предварительного просмотра Outlook и Office с Teams вкладками.