通过阅读这篇文章，了解如何将 ONLYOFFICE 文档 v7.2 与 Liferay 集成，在 Liferay 文档和媒体库中编辑办公文档。
ONLYOFFICE文档是什么
ONLYOFFICE 文档是一个在线办公套件，包括文本文档、电子表格和演示文稿的查看器和编辑器，与包括 .docx、.xlsx、.pptx 在内的 Office Open XML 格式完全兼容，并支持实时协作编辑。
主要功能
- 文档编辑器
- 电子表格编辑器
- 演示文稿编辑器
- 移动网页查看器
- 协作编辑
- 支持象形文字
- 支持所有常见格式：DOC、DOCX、TXT、ODT、RTF、ODP、EPUB、ODS、XLS、XLSX、CSV、PPTX、HTML
ONLYOFFICE文档最新版
最近ONLYOFFICE发布了v7.2，最新版本的在线编辑器提供了多种实用性改进：
- 轻松的插件安装流程、
- 实时查看器、
- 支持连字、
- 新可填写表单的字段类型、
- 可插入到任何文档的、可编辑的OLE 电子表格、
- 全新界面主题和语言、
- 特殊粘贴热键等等。
阅读这篇文章，了解更多关于ONLYOFFICE文档v7.2新功能。
本指南将向您展示如何在机器上安装 Ubuntu 版的 ONLYOFFICE 文档社区版。
关于 ONLYOFFICE 与 Liferay 集成
ONLYOFFICE 提供官方连接器，将 ONLYOFFICE 文档与Liferay 集成，支持在 Liferay 文档和媒体库中编辑办公文档。您可以从 Liferay Marketplace或 GitHub 页面下载 ONLYOFFICE 连接器。该连接器按照 Apache 许可分发。
如要详细了解适用于 Liferay 的 ONLYOFFICE 连接器的操作说明，请访问我们的API 文档页面。
主要功能
- 使用通过 ONLYOFFICE 创建菜单选项来创建文件。
- 创建和填写在线表单。
- 在文档与媒体部分，使用 ONLYOFFICE 编辑/查看菜单选项查看和编辑现有的文本文档、电子表格或演示文稿。
- 实时协作编辑文档：两种协作编辑模式（快速和严格）、修订、评论和内置聊天功能。
JWT 支持，旨在保障您流量的安全，仅有拥有相关权限的用户才能访问您的文档。
支持的格式
- 用于创建、编辑和查看：DOCX、PPTX、XLSX、DOCXF
- 用于填写表单：OFORM
- 用于转换为 Office Open XML：ODT、DOC、RTF、TXT、ODP、PPT、ODS、XLS、CSV
- 仅用于查看：PDF
版本 2.2.0 中的新特性
新增
- 文件预览
- 编辑时保留中间版本 (Forcesave)
- 加利西亚空文件模板
变更
- 签入/签出而非锁定/解锁
- 修复了门户-7.4的部署错误
如要查看完整的更改日志，请点击此处。
将 ONLYOFFICE 文档连接到 Liferay
要求
- ONLYOFFICE 文档（文档服务器）6.1.0 或更高版本
您需要一个 ONLYOFFICE 文档实例，该实例需要从 Liferay 及任意终端客户端可解析、可连接，且必须能够直接向 Liferay 发布。
如要详细了解如何安装 ONLYOFFICE文档，请参阅官方文档页面。
- Liferay CE Portal 7.2 GA1+、Liferay DXP 7.2 GA1+、Liferay CE Portal 7.3 GA1+、Liferay DXP 7.3 GA1+、Liferay CE Portal 7.4 GA1+
- 适用于 Liferay 的ONLYOFFICE 连接器 v2.2.0
安装适用于 Liferay 的 ONLYOFFICE 连接器
您可以使用“应用管理器”或从官方 Liferay 应用商店安装 ONLYOFFICE 连接器。
如要使用应用管理器安装，请执行如下操作：
- 转到控制面板-> 应用-> 应用管理器。
- 点击选项按钮。
- 点击上传按钮。
- 在打开的窗口中，选择 ONLYOFFICE 应用文件。
如要从应用商店安装连接器：
- 转到控制面板-> 应用-> 商店。
- 使用您的 Liferay 帐户登录。
- 搜索适用于 Liferay 的 ONLYOFFICE 连接器。
- 购买应用（免费）。
安装完成即可使用该应用。
配置适用于 Liferay 的 ONLYOFFICE 连接器
前往控制面板-> 配置-> 系统设置。在平台部分，选择连接器类别，选择 ONLYOFFICE。
您可以做如下配置：
- ONLYOFFICE 文档地址 - 指定文档编辑服务的安装网址。
- 来自服务器的内部请求的 ONLYOFFICE 文档地址 - 指定用于从 Liferay 访问文档编辑服务的地址。
- 来自 ONLYOFFICE文档的内部请求的服务器地址 - 指定用于从文档编辑服务访问 Liferay 的地址。
- 密钥 - 指定用于对数据进行签名的密钥。如需了解详情，请参阅本文启用ONLYOFFICE与Liferay集成的JWT部分。
- 启用强制保存 - 激活该复选框，即可在编辑时保留中间的文档版本。
- 启用 ONLYOFFICE网页预览 - 激活该复选框，即可启用文件预览。
配置好集成应用程序后，点击保存按钮以应用更改。
启用 ONLYOFFICE 和 Liferay 集成的 JWT
为保护文档免遭未经授权的访问，ONLYOFFICE 编辑器使用 JSON 网络令牌 (JWT)。在初始化文档编辑器以及在内部 ONLYOFFICE 文档服务之间交换命令期间，会在配置中添加此令牌。该密钥用于签署 JSON 网络令牌，以及在请求 ONLYOFFICE Docs 时验证令牌。
为保护您的文档，您需要启用令牌验证，并在 ONLYOFFICE 文档配置文件中指定密钥，然后在连接器设置中指定相同的密钥。
第 1 步：配置 ONLYOFFICE Docs
- 使用任意可用的文本编辑器打开
local.json文件。
- Linux：
/etc/onlyoffice/documentserver/local.json - Windows：
%ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json - Docker：使用
docker exec -it <containerID> bash命令输入 ONLYOFFICE Docs 容器，打开/etc/onlyoffice/documentserver/local.json
- 通过在三个部分中将参数值从
false改为true来启用令牌验证：
services.CoAuthoring.token.enable.browserservices.CoAuthoring.token.enable.request.inboxservices.CoAuthoring.token.enable.request.outbox
- 通过用您在三个部分中自己的文本字符串替换密钥值，来指定你自己的密钥。密钥必须相同。
services.CoAuthoring.secret.inbox.stringservices.CoAuthoring.secret.outbox.stringservices.CoAuthoring.secret.session.string
{
"services": {
"CoAuthoring": {
"token": {
"enable": {
"request": {
"inbox": true,
"outbox": true
},
"browser": true
}
},
"secret": {
"inbox": {
"string": "yoursecret"
},
"outbox": {
"string": "yoursecret"
},
"session": {
"string": "yoursecret"
}
}
}
}
}
- 保存您的更改。
5. 重启服务，以使配置更改生效。
supervisorctl restart all
第 2 步：在连接器设置中指定相同的密钥
在连接器设置中，在密钥字段指定相同的密钥，并保存设置。
开始在 Liferay 中使用 ONLYOFFICE 文档
如要创建文件，请执行以下操作：
1. 前往文件和媒体部分。
2. 点击添加文件按钮。
3. 在打开的菜单中，点击使用 ONLYOFFICE 创建按钮。
4. 在打开的页面上，选择文件类型，指定其标题和描述（可选）。
5. 点击保存按钮。
如要编辑文件，请执行以下操作：
1. 在文档和媒体部分找到所需的文件。
2. 点击该文档。
3. 在打开的菜单中，点击在 ONLYOFFFICE 中编辑按钮。
如要创建表单，请执行以下操作：
1. 前往文档和媒体部分。
2. 点击添加文件按钮。
3. 在打开的菜单中，点击使用 ONLYOFFICE 创建按钮。
4. 选择表单选项，指定文件的标题和描述（可选）。
5. 点击保存按钮。
6. 将表单另存为 .docxf，以便未来可进行编辑、修订或协作。
如要创建可填写表单并限制其他用户编辑文件，请执行以下操作：
1. 点击 .docxf 文件右侧的更多图标。
2. 选择使用 ONLYOFFICE 创建表单选项。
如要要填写表单，请执行以下操作：
1. 点击.docxf 文件右侧的更多图标。
2. 选择在 ONLYOFFICE 中填写表单选项。
