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

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

Важно!

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

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

Снимок экрана: пример личной вкладки в классическом клиенте Teams.

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

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

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

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

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

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

Примечание.

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание.

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

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

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

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

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

См. также