Teams 的生成选项卡
选项卡是嵌入 Microsoft Teams、Outlook 和 Microsoft 365 中的客户端感知网页。 它们是简单的 HTML <iframe/>
标记,指向在应用清单中声明的域,并且可以添加为团队内部频道、群组聊天或个人用户的个人应用的一部分。 可在应用中包含自定义选项卡,以便在 Teams 中嵌入自己的 Web 内容,或将 Teams 特定的功能添加到 Web 内容。 有关详细信息,请参阅 Teams JavaScript 客户端库。
重要
自定义选项卡在政府社区云中可用, (GCC) 、GCC-High 和国防部 (DOD) 。
有两种类型的选项卡:静态选项卡和可配置选项卡。 可以在三个不同的范围内使用这些选项卡: personal
、 groupchat
和 teams
。
个人 (静态) 选项卡以及个人范围的机器人是个人应用的一部分,这些应用的范围限定为单个用户,并固定到左侧导航栏以便于访问。 个人 (个人范围内的静态) 选项卡继续以相同的方式工作。 但是,现在可以将静态选项卡扩展到具有可自定义体验的群组聊天、频道或会议。
聊天、频道或会议中的选项卡的行为更类似于应用,因为每个应用只能固定一个选项卡。 例如,只能在会议中固定一个 YouTube 应用选项卡。 会议中的静态选项卡也可以由 IT 管理员在会议中预先固定。
下图显示了添加到 Teams 中不同上下文的选项卡:
以下是聊天、频道和会议中静态选项卡的一些优势:
可固定且即时:可以通过在聊天、频道和会议中添加选项卡图标固定具有静态选项卡 + 的应用。 这些选项卡可以取消固定,并且没有强制配置对话框,这允许你创建功能更类似于应用的选项卡。
统一:可以创建一个静态选项卡,用于个人和组范围,例如聊天、频道和会议选项卡。
可选配置:可以通过在 Teams 中固定应用后更改应用的属性来更改
contentUrl
选项卡实例中的默认 URL。
频道或组选项卡 也称为可配置选项卡,将内容传送到频道和群组聊天,是围绕基于 Web 的专用内容创建协作空间的一种方法。
下表可帮助你确定最适合你的应用:
个人 | 频道 | 群组聊天 | 会议 | |
---|---|---|---|---|
静态选项卡 | ✔️ | ✔️ | ✔️ | ✔️ |
可配置的选项卡 | ❌ | ✔️ | ✔️ | ✔️ |
可以在 TeamsJS v1.x) 中创建 内容页 作为个人静态选项卡、频道或组选项卡或对话 (称为任务模块的一部分。 可以 创建一个配置页 ,使用户能够配置 Microsoft Teams 应用,并使用它来为 Microsoft 365 组配置个人、频道或群组聊天选项卡、消息扩展或连接器卡片。 你可以允许用户在安装后重新配置选项卡,并为应用程序创建选项卡删除页。 生成包含选项卡的 Teams 应用时,必须在 Android 和 iOS Teams 客户端上测试选项卡函数。 选项卡必须通过基本信息、区域设置、主题信息,以及标识选项卡中的内容的 entityId
或 subEntityId
来获取上下文。
注意
帖子和文件无法从其位置移动。
选项卡功能
选项卡功能如下所示:
- 如果向同样具有机器人的应用添加了选项卡,则机器人也会添加到团队中。
- Microsoft当前用户的 Entra ID 的感知。
- 用户的区域设置感知,以指示
en-us
的语言。 - 单一登录 (SSO) 功能(如果支持)。
- 能够使用机器人或应用通知来深层链接到选项卡或服务中的子实体,例如单个工作项。
- 能够从选项卡中的链接打开模式对话框。
- 在选项卡中重复使用 SharePoint Web 部件。
选项卡用户方案
Scenario:在 Teams 中引入现有的基于 Web 的资源。 例: 在 Teams 应用中创建一个静态选项卡,用于向用户显示一个信息性公司网站。
Scenario:向 Teams 机器人或消息传递扩展添加支持页面。 例:创建静态选项卡,向用户提供有关和帮助网页内容。
Scenario:为协作对话和协作提供对用户定期交互的项目的访问权限。 Example:创建一个频道或组选项卡,其中包含各个项目的深层链接。
了解选项卡的工作原理
可以使用以下方法之一创建选项卡:
在应用清单中声明自定义选项卡
自定义选项卡在应用包的应用清单中声明。 对于要作为选项卡包含在应用中的每个网页,可以定义一个 URL 和一个范围。 此外,可以将 Teams JavaScript 客户端库 添加到页面,并在页面加载后调用 microsoftTeams.initialize()
。 Teams 显示你的页面并提供对 Teams 特定信息的访问权限,例如 Teams 客户端正在运行深色主题。
无论你选择在频道、组还是个人范围内公开选项卡,都必须在选项卡中显示 <iframe> HTML 内容页 。对于静态选项卡,直接在 Teams 应用清单 中通过 contentUrl
数组中的 staticTabs
属性设置内容 URL。 选项卡的内容对于所有用户都是相同的。
注意
Teams 应用无法使用本机插件,因为它们在沙盒 iframe 中运行。
对于频道或组选项卡,还可以创建额外的配置页面。 此页允许配置内容页 URL,通常通过使用 URL 查询字符串参数加载该上下文的相应内容。 这是因为频道或组选项卡可以添加到多个团队或群组聊天。 每次后续安装时,用户都可以配置选项卡,以便根据需要定制体验。 当用户添加或配置选项卡时,URL 与 Teams 用户界面 (UI) 中显示的选项卡相关联。 配置选项卡只是向该 URL 添加更多参数。 例如,添加 Azure Boards 选项卡时,可选择配置页加载选项卡的哪个板。 配置页 URL 由configurationUrl
应用清单中configurableTabs
数组中的 属性指定。
对于静态选项卡,可以将 固定 contentUrl
到聊天、频道或会议选项卡。 这允许跳过强制配置对话框,让用户更快地使用应用。 还可以在运行时更改 contentUrl
。 这允许你生成一个可在 Teams 的所有外围应用区域工作的选项卡对象。 有关详细信息,请参阅 将可配置选项卡迁移到静态选项卡。
可以有多个通道或组选项卡,每个应用最多可以有 16 个静态选项卡。