Расширение Teams в Microsoft 365

Примечание

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

Расширения обмена сообщениями на основе поиска позволяют пользователям искать внешнюю систему и делиться результатами через область составить сообщение Microsoft Teams клиента. Расширив Teams приложений Microsoft 365 (предварительный просмотр),теперь можно Teams расширения сообщений на основе поиска Outlook для Windows настольных и веб-приложений.

Процесс обновления расширения сообщения на основе Teams для запуска Outlook включает следующие действия:

  • Обновление манифеста приложения
  • Добавление канала Outlook для бота
  • Перезагрузите обновленное приложение в Teams

В остальной части этого руководства вы сможете просмотреть эти действия и показать, как просмотреть расширение сообщения как в Outlook для Windows, так и в Интернете.

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

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

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

Подготовка расширения обмена сообщениями для обновления

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

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

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

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

У вас есть два варианта обновления манифеста приложения:

  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 набор средств параметр "Проверка файла манифеста" в меню "Развертывание"

Добавление канала Outlook для бота

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

Чтобы пользователи могли взаимодействовать с расширением обмена сообщениями из Outlook, необходимо добавить в бот Outlook канал:

  1. С портала Azure (или портала Bot Framework, если вы зарегистрировались там ранее), перейдите на ресурс бота.

  2. Из Параметры выберите Каналы.

  3. Нажмите кнопку Outlook, выберите вкладку Расширения сообщений, а затем нажмите кнопку Сохранить.

    Добавьте канал Outlook 'Расширения сообщений' для бота из области каналов Azure Bot

  4. Подтвердите, Outlook канал указан вместе с Microsoft Teams в области каналов бота:

    Области каналов ботов Azure с перечислением Microsoft Teams и Outlook каналов

Перезагрузите обновленное расширение обмена сообщениями в Teams

Последний шаг — загрузка обновленного расширения обмена сообщениями(пакет приложений)в Microsoft Teams. После завершения расширение обмена сообщениями появится в установленных приложениях из области составить сообщение.

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

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

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

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

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

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

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

После загрузки через Teams расширение обмена сообщениями будет доступно в Outlook в Интернете.

Просмотр расширения сообщения в Outlook

Теперь вы готовы протестировать расширение обмена сообщениями в Outlook на Windows и в Интернете. Несмотря на то, что обновленное расширение обмена сообщениями будет продолжать работать в Teams с полной поддержкой функций для расширений обмена сообщениями,в этом предварительном предварительном просмотре Outlook с включенной поддержкой есть ограничения:

  • Расширения обмена сообщениями в Outlook ограничиваются контекстом композитной почты. Даже если Teams сообщения включается в качестве контекста в манифесте, текущий предварительный просмотр ограничен параметром commandBox "состав почты" compose (). Запрос расширения сообщения из глобального Outlook не поддерживается.
  • Команды расширения обмена сообщениями на основе действий не поддерживаются в Outlook. Если у приложения есть команды на основе поиска и действий, оно будет Outlook, но меню действий будет недоступным.
  • Одновековая бесшумная проверка подлинности не поддерживается для расширений обмена сообщениями в Outlook.
  • Вставка более пяти адаптивных карт в электронной почте не поддерживается; Адаптивные карты v1.4 и более поздние не поддерживаются.
  • Действия карт типа messageBack , и не imBack invoke signin поддерживаются для вставленных карт. Поддержка ограничена: по щелчку мыши пользователь будет перенаправлен на указанный openURL URL-адрес на новой вкладке.

При проверке расширения обмена сообщениями можно определить источник (исходя из Teams и Outlook) запросов бота по channelId объекта Activity. Когда пользователь выполняет запрос, служба получает стандартный объект Bot Activity Framework. Одним из свойств в объекте Activity является , которое будет иметь значение или , в зависимости от того, откуда возникает запрос channelId msteams outlook бота. Дополнительные новости см. в рубрике Расширение SDKна основе обмена сообщениями на основе поиска.

Outlook

Чтобы просмотреть ваше приложение, Outlook на Windows настольном компьютере, откройте Outlook войти с учетными данными для тест-клиента. Нажмите кнопку Новая электронная почта. Откройте меню "Больше приложений" на верхней ленте. Расширение сообщения будет перечислены. Вы можете вызвать его оттуда и использовать его так же, как вы бы при сочинении сообщения в Teams.

Outlook в Интернете

Чтобы просмотреть приложение в Outlook в Интернете, войдите outlook.com с помощью учетных данных для тест-клиента. Нажмите кнопку Новое сообщение. Откройте меню "Больше приложений" в нижней части окна композиции. Расширение сообщения будет перечислены. Вы можете вызвать его оттуда и использовать его так же, как вы бы при сочинении сообщения в Teams.

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

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

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

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 с Teams сообщений.