Что такое настраиваемые вкладки Microsoft Teams?What are Microsoft Teams custom tabs?

Вкладки — это веб-страницы с поддержкой команд, внедренные в Microsoft Teams.Tabs are Teams-aware webpages embedded in Microsoft Teams. Они представляют собой простые HTML-<> теги iframe, которые указывают на домены, объявленные в манифесте приложения, и могут быть добавлены как часть канала в группу, группу чатов или личное приложение для отдельного пользователя.They are simple HTML <iframe> tags that point to domains declared in the app manifest and can be added as part of a channel inside a team, group chat, or personal app for an individual user. Вы можете включить настраиваемые вкладки в свое приложение, чтобы внедрить собственное веб-содержимое в Teams или добавить специальные функции Teams в веб-контент.You can include custom tabs with your app to embed your own web content in Teams or add Teams-specific functionality to your web content. Ознакомьтесь с разделом клиентский пакет SDK для Teams.See Teams JavaScript client SDK.

Примечание

Хром 80, запланированный на выпуск ранних 2020, содержит новые значения файлов cookie и по умолчанию накладывает политики файлов cookie.Chrome 80, scheduled for release in early 2020, introduces new cookie values and imposes cookie policies by default. Рекомендуется задавать предполагаемый способ использования файлов cookie, а не полагаться на поведение браузера по умолчанию.It's recommended that you set the intended use for your cookies rather than rely on default browser behavior. Просмотрите атрибут самесите cookie (обновление 2020).See SameSite cookie attribute (2020 update).

В Teams доступно два типа вкладок: канал/группа и личная.There are two types of tabs available in Teams — channel/group and personal. С помощью вкладок каналов и групп можно создавать каналы и беседы групп, а так же удобно создавать пространства для общедоступного веб-содержимого.Channel/group tabs deliver content to channels and group chats, and are a great way to create collaborative spaces around dedicated web-based content. Личные вкладки, а также боты с индивидуальной областью действия — это часть персональных приложений и областью действия одного пользователя.Personal tabs, along with personally-scoped bots, are part of personal apps and are scoped to a single user. Для упрощения доступа их можно закрепить на левой панели навигации.They can be pinned to the left navigation bar for easy access.

Менее известные функции вкладокLesser known tab features

  • Если в приложение добавляется вкладка, в которой также имеется Bot, в группу также добавляется Bot.If a tab is added to an app that also has a bot, the bot is added to the team as well.
  • Осведомленность идентификатора Azure Active Directory (Azure AD) для текущего пользователя.Awareness of Azure Active Directory (Azure AD) ID of the current user.
  • Сведения о языковом стандарте для пользователя (например,) en-us .Locale awareness for the user to indicate language, i.e., en-us.
  • Возможность единого входа (SSO), если она поддерживается.Single sign-on (SSO) capability, if supported.
  • Возможность использовать уведомления боты или приложений для глубокой ссылки на вкладку или на вложенный объект в службе (например, отдельный рабочий элемент).Ability to use bots or app notifications to deep link to the tab or to a sub-entity within the service, e.g., an individual work item.
  • Возможность открытия модуля задач из ссылок на вкладке.The ability to open a task module from links within a tab.
  • Повторное использование веб-частей SharePoint на вкладке.Reuse of SharePoint web parts within the tab.

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

Сценарий: Переведите существующий веб-ресурс в Teams.Scenario: Bring an existing web-based resource inside Teams.
Пример: В приложении Teams создается личная вкладка, предоставляющая пользователям информационный корпоративный веб-сайт.Example: You create a personal tab in your Teams app that presents an informational corporate website to users.

Сценарий: Добавление страниц поддержки для почтового модуля или расширения почтового модуля Teams.Scenario: Add support pages to a Teams bot or messaging extension.
Пример: Вы создаете персональные вкладки, которые предоставляют пользователям сведения о веб-страницах и помогать им.Example: You create personal tabs that provide about and help webpage content to users.

Сценарий: Предоставление доступа к элементам, которые пользователи регулярно взаимодействуют для совместного диалога и совместной работы.Scenario: Provide access to items that your users interact with regularly for cooperative dialogue and collaboration.
Пример: Вы создаете вкладку каналов/групп с глубоким связыванием с отдельными элементами.Example: You create a channel/group tab with deep linking to individual items.

Как работают вкладки?How do tabs work?

Настраиваемая вкладка объявлена в манифесте приложения пакета.A custom tab is declared in the app manifest of your app package. Для каждой веб-страницы, которую вы хотите включить в качестве вкладки в приложении, определите URL-адрес и область.For each webpage you want included as a tab in your app, you define a URL and a scope. Кроме того, необходимо добавить клиентский пакет SDK для Teams JavaScript на страницу и вызвать его microsoftTeams.initialize() после загрузки страницы.Additionally, you need to add the Teams JavaScript client SDK to your page, and call microsoftTeams.initialize() after your page loads. Это позволит Teams отобразить вашу страницу, предоставить доступ к сведениям, относящимся к Teams (например, если в клиенте Teams выполняется темная тема), и разрешить выполнение действий на основе результатов.Doing so will tell Teams to display your page, give you access to Teams-specific information (for example if the Teams client is running the dark theme), and allow you to take action based on the results.

Если вы выберете вкладку в пределах канала/группы или личной области, вам потребуется представить страницу <IFRAME > HTML contents на вкладке. Для личных вкладок URL-адрес содержимого задается непосредственно в манифесте приложения Teams по contentUrl свойству в staticTabs массиве.Whether you choose to expose your tab within the channel/group or personal scope, you'll need to present an <iframe> HTML content page in your tab. For personal tabs, the content URL is set directly in your Teams app manifest by the contentUrl property in the staticTabs array. Содержимое вкладки будет одинаковым для всех пользователей.Your tab's content will be the same for all users.

Для вкладок каналов/групп также необходимо создать дополнительную страницу конфигурации, которая позволяет пользователям настраивать URL-адрес страницы контента, обычно с помощью параметров строки запроса URL-адреса для загрузки соответствующего содержимого для этого контекста.For channel/group tabs, you also need to create an additional configuration page that allows users to configure your content page URL, typically by using URL query string parameters to load the appropriate content for that context. Это связано с тем, что вкладка канал/группа может быть добавлена в несколько различных команд или групповых чатов.This is because your channel/group tab can be added to multiple different teams or group chats. При каждой последующих установках пользователи смогут настраивать вкладку, позволяя настраивать интерфейс при необходимости.On each subsequent install, your users will be able to configure the tab, allowing you to tailor the experience as needed. Когда пользователи добавляют или настраивают вкладку, URL-адрес связывается с вкладкой, представленной в пользовательском интерфейсе Teams.When users add or configure a tab, a URL is being associated with the tab that is presented in the Teams UI. Для настройки вкладки достаточно добавить дополнительные параметры к этому URL-адресу.Configuring a tab is simply adding additional parameters to that URL. Например, при добавлении вкладки "доски Azure" на странице "Конфигурация" можно выбрать доску, на которую будет загружена вкладка.For example, when you add the Azure Boards tab, the configuration page allows you to choose which board the tab will load. URL-адрес страницы конфигурации задается configurationUrl свойством в configurableTabs массиве манифеста приложения.The configuration page URL is specified by the configurationUrl property in the configurableTabs array in your app manifest.

Вы можете использовать до 16 (1) вкладок каналов/групп и до 16 (16) личных вкладок для каждого приложения.You can have a maximum of one (1) channel/group tab and up to sixteen (16) personal tabs per app.

Мобильные приложенияMobile clients

Если вкладка канал и группа отображается в клиентах Teams для мобильных устройств, то setSettings() для свойства должно быть задано значение websiteUrl .If you choose to have your channel/group tab appear on Teams mobile clients, the setSettings() configuration must have a value for the websiteUrl property. Чтобы обеспечить оптимальное взаимодействие с пользователем, при создании вкладок следуйте указаниям для вкладок на странице Мобильный телефон .To ensure optimal user experience, you should follow the guidance for tabs on mobile when creating your tabs.