ONLYOFFICE SharePoint 集成解决方案

该解决方案让用户能够从 SharePoint 中用 ONLYOFFICE 文档编辑office文档。

特性

目前，可以编辑以下文档格式：DOCX, XLSX, PPTX。
以下格式仅供查看：PDF、DJVU、TXT、CSV、ODT、ODS、ODP、DOC、XLS、PPT、PPS、EPUB、RTF、HTML、HTM、MHT、XPS。
该插件将在文件的上下文菜单和 Office 文档的功能区中创建一个新的菜单选项 在 ONLYOFFICE 中编辑。这允许多个用户实时协作并将这些更改保存回 SharePoint。

您将需要一个 ONLYOFFICE 文档（文档服务器）实例，该实例可从 SharePoint 和任何客户终端解析和连接。如果不是这种情况，请使用官方 ONLYOFFICE 文档文档页面。 ONLYOFFICE 文档还必须能够直接发布到 SharePoint。

启动 ONLYOFFICE 文档实例的最简单方法是使用 Docker。

要开始将 ONLYOFFICE 文档与 SharePoint 一起使用，必须执行以下步骤：

单击开始，指向 所有程序，然后选择 管理工具 并单击服务。确保 SharePoint 管理 服务已启动。
单击 开始 -> SharePoint 命令行管理程序，转到包含 .wsp 文件的目录。
运行 Install.ps1 脚本： PS> .\Install.ps1
输入您的 SharePoint 网站地址：
https://<yoursharepointsite>
除了步骤 3 和 4，您还可以键入以下命令： Add-SPSolution -LiteralPath<SolutionPath>/onlyoffice.wsp 在 SharePoint 管理中心 主页上，单击 系统设置 -> 场管理 -> 管理场解决方案。在 解决方案管理 页面上，单击 onlyoffice.wsp -> 部署解决方案。
在 SharePoint 管理中心 主页的 应用程序管理下，单击 管理 Web 应用程序。
确保选择您的站点并单击 身份验证提供程序 图标。
在 身份验证提供程序 弹出窗口中，单击 默认区域。
在 编辑身份验证下，选中 启用匿名访问 并单击保存。
返回 Web 应用程序管理 并单击 匿名策略 图标。
在 匿名访问限制下，选择您的区域，将权限设置为 无 – 无策略，然后单击保存。

在 SharePoint 中，打开带有管理设置的 /_layouts/15/Onlyoffice/Settings.aspx 页面。输入以下地址连接ONLYOFFICE 文档：

https://<documentserver>/

其中 documentserver 是安装了 ONLYOFFICE 文档 的服务器的名称。用户浏览器和 SharePoint 服务器必须可以访问该地址。 SharePoint 服务器地址也必须可以从 ONLYOFFICE 文档 访问才能正常工作。

请注意，如果您有使用 SharePoint 设置的子网站，则需要额外配置与每个子网站的 ONLYOFFICE 文档连接，以使其正常工作。转到每个子站点设置并在正确的字段中输入文档服务器地址。

从 7.2 版开始，默认情况下启用 JWT，并自动生成密钥以限制对 ONLYOFFICE 文档的访问，这也是出于安全原因和数据完整性考虑。在 SharePoint 管理设置中指定您自己的密钥。在 ONLYOFFICE 文档配置文件中，指定相同的密钥并启用验证。

如果启用了 JWT 保护，则需要指定一个自定义的 header 名称因为 SharePoint 安全策略阻止了外部 Authorization 标头。此标头也应在 ONLYOFFICE 文档签名设置中指定。有关签名的更多信息，请参见此处。

ONLYOFFICE SharePoint 集成解决方案有两种编译方式：

使用 MS Visual Studio：
1. 进入 SharePoint 服务器并在 Visual Studio 中打开此项目。
2. 在 解决方案资源管理器中，打开项目的快捷菜单，然后选择发布。
3. 在发布对话框中，选择 发布到文件系统 选项按钮。
4. 单击发布按钮。发布过程完成后，将创建解决方案 .wsp 文件。
5. 将生成的文件复制到包含 Install.ps1 文件的文件夹（默认为BuildAndInstall 文件夹）。
在提供的 build.bat 文件的帮助下：
1. 转到 BuildAndInstall 文件夹。
2. 运行 build.bat 文件。
3. 生成的解决方案 .wsp 文件将被创建并放置到 BuildAndInstall 文件夹中。

ONLYOFFICE 集成遵循此处的 API文档。

用户导航到 SharePoint 中的文档并在上下文菜单或功能区上选择 在 ONLYOFFICE 中编辑 操作。
SharePoint 向编辑器页面发出请求（表单的 URL：/_layouts/15/Onlyoffice/editorPage.aspx?SPListItemId={SelectedItemId}&SPListId={ItemId}&SPListURLDir={ListUrlDir}&action=track).
SharePoint 准备一个具有以下属性的 JSON 对象：
- url - ONLYOFFICE 文档用于下载文档的 URL；
- callbackUrl - ONLYOFFICE 文档通知文档编辑状态的 URL；
- DocumentSeverHost - 客户端需要回复ONLYOFFICE 文档服务器的URL（可在设置页面设置）；
- Key - 来自 SharePoint 的文件标识符；
- FileName - 文档标题（名称）；
- CurrentUserId - 用户标识；
- CurrentUserName - 用户名。
SharePoint 构造一个页面，填充所有这些值，以便客户端浏览器可以加载编辑器。
客户端浏览器从 ONLYOFFICE 文档向 JavaScript 库发出请求，并向 ONLYOFFICE 文档发送包含上述属性的 DocEditor 配置。
然后 ONLYOFFICE 文档从 SharePoint 下载文档，用户开始编辑。
当所有用户和客户端浏览器都完成编辑后，他们会关闭编辑窗口。
在 10 秒不活动后，ONLYOFFICE 文档向回调 URL 发送一个 POST，让 SharePoint ONLYOFFICE 解决方案知道客户端已完成对文档的编辑并关闭它。
SharePoint 下载文档的新版本，替换旧版本。

在此处下载 ONLYOFFICE SharePoint 集成解决方案。