Создание вкладок для Microsoft Teams

Вкладки — это веб-страницы с поддержкой Teams, встроенные в Microsoft Teams. Это простые HTML-теги <iframe\>, которые указывают на домены, объявленные в манифесте приложения. Их можно добавить как часть канала команды, группового чата или личного приложения для отдельного пользователя. Вы можете включить настраиваемые вкладки в свое приложение. Это позволит встроить собственный веб-контент в Teams или добавить в такой веб-контент функционал Teams. Дополнительные сведения см. в статье Пакет SDK клиента JavaScript для Teams.

Важно!

В настоящее время настраиваемые вкладки доступны в средах облака сообщества для государственных организаций (GCC), GCC-High и министерства обороны (DOD).

Мы рекомендуем использовать клиентский пакет SDK для Teams через пакет npm и связать его с вашим приложением, так как клиентский пакет SDK для Teams в настоящее время недоступен в CDN для государственных организаций.

Примечание

В этом разделе описывается версия 2.0.0 пакета SDK Microsoft Teams JavaScript. Если вы используете более раннюю версию, ознакомьтесь с общими сведениями о пакете SDK Teams JS, чтобы получить рекомендации по различиям между версиями 1 и 2.

На изображении ниже показаны личные вкладки.

Личная вкладка

На изображении ниже показаны вкладки канала Contoso.

Вкладки канала или группы

Перед началом работы над вкладками ознакомьтесь с требованиями к их использованию.

В Teams доступно два типа вкладок: личные и вкладки канала или группы. Личные вкладки, как и персональные боты, являются частью личных приложений и доступны только одному пользователю. Для удобства их можно закрепить на панели навигации слева. Вкладки каналов или групп позволяют добавлять нужный контент на каналы и в групповые чаты. Это отличный способ создать пространство для совместной работы над определенным веб-контентом.

Вы можете создать страницу контента как часть личной вкладки, вкладки канала или группы либо модуля задачи. Вы можете создать страницу конфигурации, которая позволит пользователям настраивать приложение Microsoft Teams и использовать ее для настройки вкладки канала или группового чата, расширения сообщения или соединителя Office 365. Кроме того, можно разрешить пользователям изменять конфигурацию вкладки после установки и создать страницу удаления вкладки для своего приложения. При создании приложения Teams, которое содержит вкладку, нужно проверить, как эта вкладка работает в клиентах Teams для Android и iOS. Вкладка должна получать контекст с помощью основной информации, сведений о локали и теме, а также параметра app.Context.page.id или app.Context.page.subPageId, которые определяют, что находится на вкладке.

Вы можете создавать вкладки с помощью адаптивных карточек, чтобы централизовано управлять всеми возможностями приложений Teams без необходимости развертывать другую серверную часть для ботов и вкладок. Представление "Экран" — это новый компонент пользовательского интерфейса, который позволяет отображать контент, который открыт в Teams в полноэкранном режиме и закреплен в виде вкладки. Существующая служба развертывания ссылок обновлена и теперь используется для преобразования URL-адресов во вкладки с помощью адаптивных карточек и служб чата. Вы можете создавать вкладки бесед с помощью отдельных элементов этих диалогов. Они позволят пользователям работать над контентом не всей вкладки целиком, а ее подразделов — обсуждать конкретную задачу, карту пациента или сделку по продаже. Чтобы сделать приложения более удобными для разработчиков, можно изменить размер полей вокруг вкладок. В личных приложениях и каналах или групповых чатах можно перетаскивать вкладки и помещать их в нужное положение.

Примечание

Положение вкладок Публикации и Файлы изменить нельзя.

Функции вкладок

Функции вкладок перечислены ниже.

  • Если вкладка добавляется в приложение, в котором уже есть бот, это бот также добавляется в команду.
  • Осведомленность Microsoft Azure Active Directory (Azure AD) об ID текущего пользователя.
  • Доступность сведений о локали для пользователя, чтобы указать язык en-us.
  • Возможность единого входа, если она поддерживается.
  • Возможность использовать уведомления ботов или приложений для прямой ссылки на вкладку или подраздел в службе, например на отдельный рабочий элемент.
  • Возможность открывать модуль задачи по ссылкам на вкладке.
  • Повторное использование веб-частей SharePoint на вкладке.

Пользовательские сценарии для вкладок

Сценарий: добавление существующего веб-ресурса в Teams.
Пример: создайте личную вкладку в приложении Teams, которая предоставит пользователям доступ к информационному корпоративному веб-сайту.

Сценарий: добавление страниц поддержки в бот Teams или расширение сообщения.
Пример: создайте личные вкладки, которые предоставят пользователям доступ к контенту с веб-страниц с общими сведениями и справочными материалами.

Сценарий: предоставление доступа к элементам, с которыми пользователи регулярно взаимодействуют, для обсуждения и совместной работы.
Пример: создайте вкладку канала или группы с прямыми ссылками на отдельные элементы.

Как работают вкладки

Для создания вкладок воспользуйтесь одним из приведенных ниже способов.

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

Настраиваемая вкладка объявляется в манифесте приложения вашего пакета приложений. Для каждой веб-страницы, которая будет добавлена в качестве вкладки в приложение, нужно определить URL-адрес и область. Кроме того, вы можете добавить на свою страницу пакет SDK клиента JavaScript для Teams и вызывать app.initialize() после ее загрузки. Teams отобразит страницу и предоставит доступ к связанной с Teams информации, например о том, что в клиенте Teams используется темная тема.

На вкладке обязательно нужно представить HTML-страницу контента <iframe>. Это необходимо для размещения как личных вкладок, так и вкладок каналов или групп. Для личных вкладок URL-адрес контента задается непосредственно в манифесте приложения Teams с помощью свойства contentUrl в массиве staticTabs. Содержимое вкладки одинаково для всех пользователей.

Примечание

Приложение Teams не распознает вложенные фреймы. Поэтому оно не будет загружаться, если в приложении вкладки есть iframe.

Для вкладок канала или группы также можно создать дополнительную страницу конфигурации. На ней можно настраивать URL-адрес страницы контента с помощью параметров строки запроса URL. Это позволяет загружать нужный контент для соответствующего контекста. Это связано с тем, что вкладку канала или группы можно добавить в несколько команд или групповых чатов. При каждой следующей установке пользователи смогут настроить вкладку и адаптировать ее работу под свои нужды. Когда пользователи добавляют или настраивают вкладку, URL-адрес связывается с вкладкой, представленной в пользовательском интерфейсе Teams. При настройке вкладки к этому URL-адресу просто добавляются дополнительные параметры. Например, при добавлении вкладки Azure Boards на странице конфигурации можно выбрать, какую именно доску загружать на этой вкладке. URL-адрес страницы конфигурации задается в манифесте приложения с помощью свойства configurationUrl в массиве configurableTabs.

У вас может быть несколько вкладок канала или группы, а также до 16 личных вкладок для каждого приложения.

Инструменты для создания вкладок

Следующий этап

См. также