部署和安装 SharePoint 加载项:方法和选项
本文将详细介绍 SharePoint 加载项的发布选项,以及如何安装和卸载加载项。
发布到 Office 应用商店或组织加载项目录
您可以将 SharePoint 外接程序上传到公共 Office 应用商店或组织的专用外接程序目录。 专用外接程序目录是 SharePoint Web 应用程序中的专用网站集 (或 SharePoint Online 租户) ,用于托管 SharePoint 外接程序和 Office 外接程序的文档库。将目录放入其自己的网站集后,Web 应用程序管理员或租户管理员可以更轻松地限制对目录的权限。
如果将外接程序上载到 Office 商店,Microsoft 会对其运行一些验证检查。 例如,它会检查外接程序清单标记是否有效且完整,并验证包含的任何 SharePoint 解决方案包(.wsp 文件)不包括超过 Web 范围而不允许的元素或功能。 还会检查包的内容是否存在不允许的内容。 如果外接程序通过所有测试,则会将外接程序包打包到一个文件并由 Microsoft 签署。
注意
如果使用 Microsoft Visual Studio 的 Office 开发人员工具开发和部署加载项,加载项会直接安装到目标测试 SharePoint 网站中。 由于没有经历 Office 应用商店这一环节,因此不会进行上述验证检查。
将 SharePoint 加载项上传到组织加载项目录就像将任何文件上传到 SharePoint Foundation 文档库一样简单。 只需填写弹出式表单,在其中提供加载项包的本地 URL 和其他信息(如加载项名称)即可。 上传到组织加载项目录的加载项也会经历一些类似的检查,未通过检查的加载项在目录中标记为无效或已禁用。
租户管理员和 SharePoint Web 应用管理员可以在 Office 应用商店中购买 SharePoint 加载项。 若要打开 Office 应用商店,管理员需要先选择“网站内容”页上的“添加加载项”,再选择“你的加载项”页中的“SharePoint 商店”。 这会打开“SharePoint 商店”页,管理员可以在其中发现并了解供应商提供的 SharePoint 加载项(也可以在 office.com 上这样做)。
如果管理员的 Web 应用或租赁中未安装加载项需要的必备组件,加载项会变暗,并且不可在加载项商店中购买。 例如,如果加载项需要的搜索服务未安装,那么加载项会变暗。 管理员可以对加载项列表进行排序、筛选和浏览,也可以了解加载项并查看加载项评论,同时还能购买加载项许可证。
管理员在决定购买许可证时,必须接受购买的条款和条件,并同意执行该外接程序必须具备的权限,如对列表的读取访问权限或对网站集的完全控制访问权限。
购买一个外接程序的一个或多个许可证时,许可证将下载到 Web 应用程序或租赁。 尽管管理员可以选择一起进行安装和许可证购买,但购买许可证时不会自动下载并安装外接程序。
用户从"您的外接程序"页安装外接程序。 此页面包含以下内容的合并列表:
- Web 应用(或租户)的组织加载项目录中的 SharePoint 加载项。
- Office 应用商店中的 SharePoint 加载项,组织或租户已拥有网站许可证或已分配给用户的许可证。
用户可立即安装的所有加载项都会列出。 用户可以从页面上的加载项中筛选出组织加载项目录中的加载项。 已安装的加载项显示在“网站内容”页上的加载项列表中(位于已安装到的网站上)。
安装 SharePoint 加载项
网站所有者按照本主题的前面所述操作,从“你的加载项”页安装 SharePoint 加载项。 安装后,便会创建加载项实例。 若要详细了解如何安装加载项,请参阅向 SharePoint 网站添加 SharePoint 加载项。
注意
有时网络连接暂时丢失会阻止安装。 不管任何原因导致安装失败,安装基础结构都会重试三次。 如果不成功,用户界面中会指出(显示)安装失败。 用户可以稍后重试安装。
卸载 SharePoint 加载项
网站所有者可以通过 SharePoint UI 卸载 SharePoint 外接程序的实例。 SharePoint 外接程序实例的卸载非常彻底。 这意味着外接程序安装的所有内容都将卸载。
不过,加载项使用但与加载项分开安装的组件不会遭删除。 例如,假设加载项有一个远程网页,其中包含在主机 Web 上创建列表的按钮。 卸载加载项会从“网站内容”页中删除加载项磁贴,这反过来会导致最终用户实际无法访问或使用远程页面,但并不会删除通过加载项创建的列表。 由于 SharePoint 没有记录哪些列表是通过加载项在主机 Web 上创建,哪些列表是由用户在 SharePoint UI 中创建,因此无法删除通过加载项创建的列表。 这通常是理想行为,因为即使在删除创建了列表的加载项后,列表中的数据也可能仍对用户有用。
如果 SharePoint 外接程序包含一个外接程序 Web,则该外接程序 Web 将被删除。 与系统地停用功能并还原到外接程序的内部 .wsp 文件的部署相比,这种卸载方式更为彻底。
注意
用户删除的加载项会移到第一阶段回收站。 如果从第一阶段回收站中删除加载项,它会移到第二阶段回收站。 如果从第二阶段回收站中删除加载项,它会彻底卸载,且无法还原。
加载项的权限也会随加载项删除(回收)一起撤消,具体规则如下:
- Web 范围内的权限将始终被吊销。
- 如果网站集中没有外接程序的任何其他实例,则网站集范围内的权限也将被吊销。
- 如果网站订阅(租赁)中没有其他任何加载项实例,租户范围权限也会随之撤消。
如果已在加载项的加载项清单中注册 UninstallingEventEndpoint Web 服务,它便从卸载过程一开始就执行(一直到从第二阶段回收站中删除加载项为止)。 根据最佳做法,如果有 InstalledEventEndpoint Web 服务,最好也有 UninstallingEventEndpoint Web 服务;最好将 UninstallingEventEndpoint 服务设计为,反向处理 InstalledEventEndpoint 服务完成的所有操作。 有关详细信息,请参阅处理 SharePoint 加载项中的事件。