sharepoint页面嵌入_将现代 SharePoint 页面作为个人应用程序嵌入到 Microsoft Teams 中（预览）...

将现代 SharePoint 页面作为个人应用程序嵌入到 Microsoft Teams 中(预览)Embedding modern SharePoint pages in Microsoft Teams as personal apps (preview)

06/14/2020

本文内容

适用于： Office 365Applies to: Microsoft 365

可使用 Microsoft Teams 个人应用模型将任何现代 SharePoint 页面固定到 Microsoft Teams 的左侧导航栏上。You can use the Microsoft Teams personal app model to pin any modern SharePoint page to the left navigation of Microsoft Teams. 这提供了一个很好的机会，其公开 intranet 登录页面以满足公司的沟通需求，可直接由 Microsoft Teams 用户访问。This provides a great opportunity to expose intranet landing pages to serve corporate communication needs, directly accessible by Microsoft Teams users. 示例方案可包括：Example scenarios could include:

将公司 intranet 登录页面添加到 Teams 中，以便发现新闻及内容Adding your corporate intranet landing page to Teams for easy discovery of news and content

将 学习路径 解决方案添加到 Teams 中，以便用户 Microsoft 365 学习路径的嵌入Add the Learning Pathways solution to Teams to embed Microsoft 365 learning paths for your users

为公司添加重要主题的单一页面通信Add single page communications on important topics for your company

使用本文中定义的步骤在 Teams 中嵌入任何现代 SharePoint 页面或网站。Use the steps defined in this article to embed any modern SharePoint page or site in Teams.

可通过创建 Teams 个人应用程序并手动创建此自定义设置所需的配置，在 Microsoft Teams 中嵌入任何现代 SharePoint 页面。You can embed any modern SharePoint page in Microsoft Teams by creating a Teams personal app and manually creating the needed configuration for this custom setup. 请注意以下限制和错误条件：Be aware of the following considerations:

直至本机解决方案可用之前，此功能是作为预览版集成路径提供的。This capability is provided as a PREVIEW INTEGRATION PATH until a native solution becomes available.

目标必须是现代化 SharePoint 站点或页面。The target must be a modern SharePoint site or page. 不支持嵌入经典发布门户或其他经典网站或页面，并且将无法正常使用。Embedding classic publishing portals or other classic sites or pages is not supported and will not work.

用户可通过 Teams 中的应用程序链接中添加个人应用。A user can add a personal app from the APPS link in Teams. 用户可以通过右击应用程序并选择PIN 码，将其固定到应用栏(Teams 中的最左侧的导航)上。A user can pin an app to the app bar (the left-most navigation in Teams) by right-clicking it and choosing PIN.

管理员可从 Microsoft Teams 管理中心向所有用户或目标用户部署并固定一个应用程序。Administrators can deploy and pin an app to all or targeted users from the Microsoft Teams admin center.

我们正在积极寻求在未来的综合解决方案中解决以下这些在用户体验中所存在的问题：There are some gaps in user experience including the following, which we are actively looking to address in a future, integrated solution:

嵌入的页面中没有本机导航、页眉或页脚。There is no native navigation, header, or footer on embedded pages.

从 Teams 发起的搜索将返回到 Teams 的搜索结果中，而并非嵌入式网站的搜索结果中。Search initiated from Teams will return search results from Teams, not search results from the embedded site.

无法在 Teams 中创建内容(新闻、页面、列表或库)。You cannot create content (news, pages, lists, or libraries) in Teams. 必须使用 web 浏览器或 SharePoint 移动应用程序从 SharePoint 网站中创建内容。You must create content from the SharePoint site using a web browser or SharePoint mobile app.

当SharePoint页面在Microsoft Teams中暴露时，页面注释功能不可用。Page comment feature is not available from the SharePoint pages, when they are exposed in Microsoft Teams

所有访问嵌入式SharePoint页面的用户至少需要拥有读取权限才能访问该页面。All users accessing the embedded SharePoint page will need to have at least read permission to access the page.

如果更改了租户、SharePoint 网站、网页名称或 URL，则需要更新 Teams 个人应用程序清单。If a tenant, SharePoint site or page name or URL is changed, the Teams personal app manifest will need to be updated.

如果现代 SP 页面或网站的固定模型进行了更改，则可能需要删除已驻留的现有个人应用并重新部署它们。If changes are made to the pinning model for modern SP pages or sites, it could require you to delete existing pinned personal apps and redeploy them.

重要

此选项是作为预览集成路径提供的。This option is provided as a preview integration path. Microsoft 保留对该模型进行更改的权利，这可能要求你删除现有已固定的应用程序并使用最新的解决方案重新部署它们。Microsoft reserves the right to make changes to the model, which could require you to delete existing pinned apps and re-deploy them with an updated solution. 对集成路径的更改不会要求删除或重新创建目标 SharePoint 站点或页面。Changes to the integration path will not require you to delete or recreate the targeted SharePoint site or page.

使用应用工作室将 SharePoint 的现代网站及页面嵌入至 Microsoft Teams 中Embed SharePoint modern sites & pages into Microsoft Teams with App Studio

我们将在下面的步骤中使用以下标签，应根据你需要嵌入至Teams中的现代 SharePoint 页面或站点进行更新：We will be using following tags in the steps below, which you should update based on the modern SharePoint page or site that you want to embed in Teams:

[domainUrl] – 域的根 URL[domainUrl] – Root URL of the domain

示例：https://contoso.sharepoint.com。

[pageUrl] – 页面，它应显示在与租户根相对的选项卡中[pageUrl] – Page, which should be shown in the tab relative to the root of the tenant

示例 - /sites/theperspective/SitePages/Home.aspxExample - /sites/theperspective/SitePages/Home.aspx

提示

如果想要创建一个样本来演示这种集成，可使用 https://lookbook.microsoft.com 服务在租户中创建样本应用和页面。If you want to create a sample to demonstrate this integration, you can use the https://lookbook.microsoft.com service to create sample apps and pages in your tenant.

需要使用 应用程序工作室 或其他编辑器，来创建拥有 SharePoint 页面所需 URI 的 Teams 清单文件。You will need to use App Studio or another editor to create the Teams manifest file with the necessary URLs to your SharePoint pages. 在应用程序工作室中完成以下步骤。Complete the following steps in App Studio.

打开 Microsoft Teams。Open Microsoft Teams.

通过点击 Teams 应用栏上的应用程序(左侧导航)导航到 Teams 商店。Navigate to Teams store by clicking Apps on the Teams app bar (left navigation).

使用搜索以查找应用程序工作室。Use search to find App Studio.

安装或打开应用程序工作室。Install or open App Studio.

打开应用程序工作室。Open App Studio.

导航到指令清单编辑器选项卡。Navigate to the Manifest editor tab.

创建新的应用程序项目Click Create a new app.

在表单中提供所需的应用信息：Provide required app information on the form:

短名称 – 公司 Intranet [使用支持方案的描述性内容]Short name – Company Intranet [use something descriptive that supports your scenario]

完整名称 – Contoso IntranetFull name – Contoso Intranet

点击 生成 以创建一个唯一的随机应用 IDClick Generate to create a unique, random App ID

程序包名称 – com.contoso.portal.app – 使用所处环境所特有的值Package Name – com.contoso.portal.app – Use a value that is unique to your environment

版本 – 1.0.0Version – 1.0.0

说明 – 我的第一个 Intranet 应用程序Description – My first intranet application

完整说明 – 我超棒的 intranet 应用程序，可在 Teams 中嵌入现代 SharePointFull description – My awesome intranet application to embed modern SharePoint in Teams

开发人员信息 - 名称 – 你的姓名Developer Information - Name – Your name

开发人员信息 - 网站 – 公司网站或任何你所偏好的网站Developer Information - Website – Your web site – company web site or whatever is your preference

合作伙伴信息 – 保留为空Partner information – Leave empty

应用程序 URI – 它们可以是你门户中的页面，但你可以随机设置此教程的值App URLs – These could be pages in your portal, but you can randomize the value for this tutorial

使用条款 – 也可以是门户中的一个页面，但请让我们在本教程中使用随机值Terms of use – Could be also a page in your portal, but let us use random value in this tutorial

署名 – 这些将显示在应用栏(左侧导航)和应用程序安装用户界面中。Branding – These would be visible on the app bar (left navigation) and in the app installation user interface. 可在教程中保持它们的原样，但我们绝对建议为你的生产配置更新它们You can leave them as they are for the tutorial, but we absolutely recommend updating them for your production configuration

请参阅 Microsoft Teams 官方文档中关于图像和大纲设置的品牌指导See branding guidance for the image and outline settings in the Microsoft Teams official documentation

导航到能力下的选项卡Navigate to Tabs under Capabilities

点击 添加个人标签页 下的 添加Click Add under the Add a personal tab

根据个人设置填充 个人标签页 的详细信息Fill in the Personal tab details based on your own setup

名称 – IntranetName – Intranet

实体 ID – 19991(使用随机编号)Entity ID – 19991 (Use random number)

内容 URL – https://[domainUrl]/_layouts/15/teamslogon.aspx?SPFX=true&dest=[pageUrl]Content URL – https://[domainUrl]/_layouts/15/teamslogon.aspx?SPFX=true&dest=[pageUrl]

网站 URI – 可将此可选值保留为空Website URL – You can leave this optional value empty

导航至 完成 下的 域和权限Navigate to Domains and Permissions under Finish

请确保 你选项卡中的域 中有你的域Make sure that Domains from your tabs have your domain on it

域值示例 contoso.sharepoint.comExample domain value contoso.sharepoint.com

更新 AAD 应用程序 ID 为00000003-0000-0ff1-ce00-000000000000Update AAD App ID as 00000003-0000-0ff1-ce00-000000000000

在 单一登录 值中包含你的域名 URLInclude your domain URL to the Single-Sign-On value

示例值https://contoso.sharepoint.comExample value https://contoso.sharepoint.com

导航至 完成 下的 测试并分配Navigate to Test and distribute under Finish

点击 安装，将解决方案安装到你的使用中Install the solution to your usage by clicking Install

这将使你能够测试配置并验证解决方案设置This will enable you to test the configuration and validate the solution setup

点击 添加 从应用程序工作室中安装应用程序至个人使用Click Add to install the application to your personal usage from the App Studio

根据在web和桌面的目标，验证应用程序是否在工作。Verify that the application is working based on your objectives in both web and desktop.

请注意，你可通过返回到 应用程序工作室 并使用 指令清单编辑器 来修改设置Notice that you can modify the settings by going back to App Studio and editing the manifest using the Manifest editor.

可通过从 应用程序工作室 下载清单并将其发布到 Teams 管理中的应用程序目录中，将应用程序部署到所有用户或目标用户中。You can deploy the app to all users or to targeted users by downloading the manifest from the App Studio and publishing it to the app catalog in Teams administration.

重要

若要将此解决方案部署到租户中的用户，必须拥有在 Microsoft Teams 应用程序目录中部署应用的足够权限。To deploy this solution to users in your tenant, you must have sufficient permissions to deploy apps in the Microsoft Teams app catalog.

解决方案的样本指令清单Sample manifest of the solution

如果从应用程序工作室下载解决方案文件并查看指令清单文件的详细配置，则它具有以下配置，可使其在 web 和桌面模式下正常工作。If you download the solution file from the App Studio and see the detailed configuration of the manifest file, it has the following configuration to enable it to work properly in web and in desktop modes.

{

"$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.6/MicrosoftTeams.schema.json",

"manifestVersion": "1.6",

"version": "1.0.0",

"showLoadingIndicator": false,

"id": "7ad6f150-cba8-4c39-81ce-c4da8e4100d9",

"packageName": "com.contoso.portal.app",

"developer": {

"name": "Portal App",

"websiteUrl": "https://www.contoso.com",

"privacyUrl": "https://www.contoso.com/privacy",

"termsOfUseUrl": "https://www.contoso.com/temsofuse"

},

"icons": {

"color": "color.png",

"outline": "outline.png"

},

"name": {

"short": "Portal App",

"full": "Our modern portal"

},

"description": {

"short": "My first portal application",

"full": "My awesome portal application to embed modern SharePoint to our Teams setup"

},

"accentColor": "#FFFFFF",

"staticTabs": [

{

"entityId": "19991",

"name": "Portal",

"contentUrl": "https://contoso.sharepoint.com/_layouts/15/teamslogon.aspx?SPFX=true&dest=/sites/theperspective/SitePages/Home.aspx",

"scopes": [

"personal"

]

}

],

"permissions": [

"identity",

"messageTeamMembers"

],

"validDomains": [

"m365pnp.sharepoint.com"

],

"webApplicationInfo": {

"id": "00000003-0000-0ff1-ce00-000000000000",

"resource": "https://contoso.sharepoint.com"

}

}

在 Microsoft Teams中控制应用程序的可见性Controlling app visibility in Microsoft Teams

还可通过使用 Microsoft Teams 管理中心中的 Teams应用程序设置策略，将应用程序发布为租户中所有员工默认可见。You can also publish the app to be visible by default for all employees in your tenant by using the Teams app setup policies in the Microsoft Teams admin center. 这为你提供了控制哪些应用程序对哪些用户可见的选项。This provides you options to control which apps are visible to which users. 注意：应用程序策略不适用于租户的访客。NOTE: App policies do not apply to Guests of the tenant.

请参阅以下 Microsoft Teams 文档中关于这些选项的详细信息。See more information on these options from the following Microsoft Teams documentation.

另请参阅See also