Расширение приложения для собраний Teams в Outlook

В экосистеме Microsoft 365 большинство пользователей ежемесячно планируют собрания Microsoft Teams из Outlook. Чтобы помочь пользователям оставаться в потоке своей работы, приложения для собраний Teams теперь поддерживаются в Outlook. Вы можете настраивать и добавлять приложения для собраний Teams, запланированные из Outlook, а также запускать приложения для собраний в календаре Outlook.

По сути, приложения для собраний — это приложения с вкладками Teams, предназначенные для совместной работы до, во время и после собраний. Вы можете указать, какие контексты поддерживает приложение для собраний из манифеста приложения (ранее называемого манифестом приложения Teams) с помощью свойства configurableTabs.context .

Примечание.

Кроме того configurableTabs, ваше приложение для собраний должно содержать по крайней мере одну возможность в личной области (например, staticTabs), чтобы оно было доступно в Outlook.

В следующей таблице показаны контексты приложений для собраний Teams, поддерживаемые в Outlook:

Контекст собрания Teams	Значение манифеста приложения	Значение TeamsJS	Поддержка Outlook
Представление сведений о собрании	meetingDetailsTab	frameContext.content	✔️
Представление чата собрания	meetingChatTab	frameContext.content	✔️
Представление боковой панели собрания	meetingSidePanel	frameContext.sidePanel	✔️
Представление этапа собрания	meetingStage	frameContext.meetingStage	❌

Если приложение для собраний поддерживает Stageview, другие эффекты собрания или содержит такие возможности, как расширения сообщений и боты, они продолжают работать в Teams, когда собрание запланировано из Outlook, но не отображается и не запускается в Outlook.

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

Чтобы просмотреть приложение для собраний Teams в Outlook, убедитесь в следующем:

• Клиент песочницы разработчика Microsoft 365 с включенной отправкой.
• Тестовая среда с классическим приложением Outlook для Windows, установленным из текущего канала приложений Microsoft 365.
• Установлен УзелJS (с npm).
• Библиотека TeamsFx CLI версии 2, установленная из npm.
• Visual Studio Code , установленный в среде разработки.
• Расширение Набора средств Teams для Visual Studio Code.

Чтобы предварительно просмотреть приложение для собраний Teams в Outlook, можно создать новое приложение для собраний с помощью набора средств Teams или расширить существующее приложение для собраний Teams в Outlook.

Создание приложения для собраний Teams для Outlook

Вы можете создать приложение для собраний Teams для Outlook с помощью расширения Teams Toolkit для Visual Studio Code. Чтобы создать приложение для собраний Teams для предварительного просмотра в Outlook, выполните приведенные далее действия.

1. Перейдите в Teams и войдите с помощью учетной записи клиента песочницы.

2. Выберите Календарь>Новое собрание и запланируйте собрание.

   

3. Откройте расширение Teams Toolkit в Visual Studio Code и выберите Просмотреть примеры.

4. Выберите My First Meeting App Create (Создать приложение> для первого собрания) и укажите папку для создания рабочей области.

   

5. Нажмите клавишу F5 , чтобы выполнить отладку и запустить пример локально в Teams. Teams предложит установить приложение.

6. Выберите Добавить в собрание в раскрывающемся списке и выберите собрание, которое вы запланировали ранее.

   

7. Выберите пример конфигурации вкладки и нажмите кнопку Сохранить. Приложение доступно в представлении чата собрания.

   

Расширение существующего приложения для собраний Teams в Outlook

Чтобы расширить существующее приложение для собраний Teams в Outlook, убедитесь в следующем:

• Обновите манифест приложения.
• Используйте клиентскую библиотеку JavaScript (TeamsJS) версии 2.5.0 или более поздней.
• Настройка заголовков политики безопасности содержимого.
• Обновите регистрацию приложения Microsoft Entra для единого входа.
• Отправьте обновленное приложение в Центре администрирования Teams.

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

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

Обновите версию схемы манифеста приложения (ранее — манифест приложения Teams) до версии 1.13 или более поздней.

Откройте манифест приложения Teams и обновите $schema свойства и manifestVersion следующим образом:

{
    "$schema" : "https://developer.microsoft.com/json-schemas/teams/v1.16/MicrosoftTeams.schema.json",
    "manifestVersion" : "1.16"
}

Использование TeamsJS версии 2.5.0 или более поздней

Используйте клиентская библиотека TeamsJS версии 2.5.0 или более поздней, чтобы расширить приложение для собраний Teams для запуска в Outlook. Если ваше приложение использует TeamsJS версии 2.5.0 или более поздней версии, изменения кода приложения не требуются для запуска в Outlook.

Если вам нужно обновить пакет npm TeamsJS с версии 1.x.x до последней версии TeamsJS версии 2.x.x, можно использовать Набор средств Teams для выявления и автоматизации необходимых изменений кода. Дополнительные сведения см. в статье Библиотека TeamsJS.

Чтобы обновить TeamsJS до последней версии с помощью набора средств Teams, выполните следующие действия:

1. Откройте приложение в Visual Studio Code и выберите Расширение набора средств Teams .
2. В разделе Вид выберите Палитра команд... или CTRL+SHIFT+P.
3. Выполните команду Teams: Upgrade Teams JS SDK and code references.

Ссылки на @microsoft/teams-js@2.x.x файлы package.json и *.js/.ts файлы и *.jsx/.tsx обновляются с помощью:

• Инструкции импорта для teams-js@2.x.x.
• Вызовы функции, перечисления и интерфейса для teams-js@2.x.x.
• Новые "TODO" напоминания о комментариях помечают области, на которые могут повлиять изменения интерфейса контекста .
• Новые "TODO" напоминания о комментариях для преобразования функций обратного вызова в обещания.

Примечание.

При обновлении до последней версии TeamsJS с помощью Teams Toolkit код в HTML-файлах не обновляется. Html-файлы необходимо обновить вручную.

Настройка заголовков CSP для Outlook

Приложения вкладок Teams размещаются в элементах iframe в Outlook, как и в Teams. Если ваше приложение использует заголовки политики безопасности содержимого (CSP), добавьте outlook.office.com в качестве предка фрейма.

Обновление регистрации приложения Microsoft Entra для единого входа

Единый вход (SSO) Microsoft Entra для приложений для собраний работает в Outlook так же, как и в Teams. Однако необходимо вручную добавить идентификатор приложения Outlook в регистрацию приложения Microsoft Entra.

1. Войдите на портал Azure с помощью тестовой учетной записи клиента.

2. Откройте Регистрации приложений.

3. Выберите свое приложение.

4. Выберите Управление>Предоставление API.

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

   Клиентское приложение Microsoft 365	Идентификатор клиента
   Классическое приложение Outlook	d3590ed6-52b3-4102-aeff-aad2292ab01c

   Дополнительные сведения об идентификаторах клиентских приложений, используемых для расширения приложений Teams в Microsoft 365, см. в разделе Вкладки Teams в Microsoft 365 и Outlook.

Вы можете отправить пользовательское приложение в Центр администрирования Teams и просмотреть приложение для собраний в Outlook.

Отправка пользовательского приложения в Центр администрирования Teams

Чтобы протестировать приложение в Microsoft 365 и Outlook, отправьте пакет приложения в Центр администрирования Teams.

1. Упаковайте манифест приложения Teams и значки приложений в ZIP-файл. Сведения о создании пакета приложения с помощью набора средств Teams см. в статье Создание пакета приложения.

2. Перейдите в Центр администрирования Teams и выберите Приложения> TeamsУправление приложениями.

3. Выберите Отправить новое приложение и выберите пакет приложения.

После отправки приложения для собраний в Центр администрирования Teams оно будет доступно как в Teams, так и в Outlook. Чтобы приложение отображалось в меню Приложения , подождите несколько минут и перезапустите Outlook для Windows.

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

Чтобы предварительно просмотреть приложение для собраний в Outlook для Windows, убедитесь, что приложение работает локально и выполните следующие действия:

1. Откройте Outlook для Windows, выполнив вход с помощью тестовой учетной записи клиента. Если Outlook уже запущен, закройте и перезапустите его снова.

2. Откройте календарь>Новое собрание. Чтобы приложение для собраний запускалось в Outlook, убедитесь, что собрание является собранием Teams , так как другие собрания, запланированные из Outlook, не поддерживаются.

3. В окне планирования собраний выберите Все приложения. Загруженное приложение для собраний отображается среди установленных приложений для собраний.

   

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

   

5. Нажмите Добавить. Приложение для собраний отображается в разделе Приложения и на боковой панели окна планирования.

Чтобы удалить или настроить приложение в окне планирования, выберите раскрывающееся меню в приложении и выберите следующее:

• Сведения. Как приложение отображается в Microsoft Teams Store.
• Параметры: обновите конфигурацию приложения для конкретного собрания.
• Удалить: удалите приложение из собрания.

Пример кода

Название примера	Описание	Node.js
Приложение HelloWorld для собраний	Простое приложение для собраний, демонстрирующее представление сведений о собрании, представление чата и боковую панель. Работает в Teams и Outlook.	Просмотр

См. также

Поддержка и обратная связь