Alfresco Content App

关于 ONLYOFFICE 与 Alfresco Content App 集成

ONLYOFFICE 提供官方集成，将文档编辑和协作功能直接带入 Alfresco Content App（ACA）——基于 Angular 的 Alfresco Content Services 现代界面。您可以从 npm 注册表或 ONLYOFFICE GitHub 页面下载集成包。

备注

此集成专用于 Alfresco Content App。如果您使用的是 Alfresco Share，请改为参阅 Alfresco Share 的 ONLYOFFICE 连接器一文。

主要功能

创建、编辑和查看文本文档、电子表格和演示文稿。
创建和填写可填写的 PDF 表单。
实时协同编辑文档：两种协同编辑模式（快速和严格）、跟踪更改模式、批注和内置聊天。
直接在编辑器界面中跟踪文档版本历史记录。
将文件转换为 OOXML 格式并导出为多种格式。
在编辑界面中管理文档权限。
高级编辑器操作：插入 Alfresco 中的图像、附加用于邮件合并的文件、选择要比较的文档、使用插件、从外部链接插入数据、导航到当前文件所在的文件夹，以及在编辑器中创建新文档。
JWT 支持，保护您的流量，确保只有具有适当权限的用户才能访问您的文档。

支持的格式

编辑：DOCX、XLSX、PPTX
查看：DOCX、XLSX、PPTX、PDF 及其他办公格式
创建：DOCX、XLSX、PPTX、PDF 表单
转换：办公格式转换为 OOXML
导出：多种格式，取决于后端配置

备注

可用于编辑、查看、转换和导出的格式的确切列表可能因所安装的版本和后端配置而异。

1.0.0 版本的新功能

ONLYOFFICE 的 Alfresco Content App 集成首次发布。

完整的更新日志可在此处查看。

将 ONLYOFFICE Docs 连接到 Alfresco Content App

要求

Alfresco Content Services — Alfresco 存储库后端。
Alfresco Content App (ACA) — 宿主 Angular 应用程序。
ONLYOFFICE Docs（服务器版或云版），ACA 和所有终端客户端均可解析并连接。

请参阅官方文档页面，了解有关安装 ONLYOFFICE Docs 的更多信息。
适用于 Alfresco 8.3.0 或更高版本的 ONLYOFFICE 模块包。
ONLYOFFICE Alfresco Content App 集成 v1.0.0 或更高版本。

安装 ONLYOFFICE Alfresco Content App 集成

安装扩展包：

npm install @onlyoffice/alfresco-extension

在您的 ACA 项目中注册该扩展。
运行应用程序：
```
npm run start
```

有关详细的安装和配置说明，请参阅项目文档。

为 ONLYOFFICE 与 Alfresco Content App 集成启用 JWT

为了保护文档免遭未经授权的访问，ONLYOFFICE 编辑器使用 JSON Web Token (JWT)。令牌在文档编辑器初始化时以及内部 ONLYOFFICE Docs 服务之间交换命令时添加到配置中。密钥用于对 JSON Web 令牌进行签名，并在向 ONLYOFFICE Docs 发出请求时验证令牌。

从 ONLYOFFICE Docs v7.2 开始，JWT 默认启用，密钥自动生成。您需要在 ONLYOFFICE Docs 配置文件中找到您的密钥，然后在集成设置中指定相同的密钥。

步骤 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

local.json 文件应如下所示：

{
  "services": {
    "CoAuthoring": {
      "token": {
        "enable": {
          "request": {
            "inbox": true,
            "outbox": true
          },
          "browser": true
        }
      },
      "secret": {
        "inbox": {
          "string": "yoursecret"
        },
        "outbox": {
          "string": "yoursecret"
        },
        "session": {
          "string": "yoursecret"
        }
      }
    }
  }
}

三个部分中均指定了 true 值，表示已启用令牌验证：
- services.CoAuthoring.token.enable.browser
- services.CoAuthoring.token.enable.request.inbox
- services.CoAuthoring.token.enable.request.outbox
自动生成的密钥在三个部分中指定。您可以将默认密钥值替换为自己的值。三个部分中的密钥必须相同：
- services.CoAuthoring.secret.inbox.string
- services.CoAuthoring.secret.outbox.string
- services.CoAuthoring.secret.session.string
如果您进行了更改，请保存并重新启动服务，使配置更改生效：
```
supervisorctl restart all
```

步骤 2：在集成设置中指定相同的密钥

在集成设置中，于密钥字段中指定相同的密钥并保存设置。

在 Alfresco Content App 中开始使用 ONLYOFFICE Docs

安装后，新的 ONLYOFFICE 操作将直接显示在 Alfresco Content App 界面中。

编辑文档：

在 ACA 界面中右键点击受支持的文件。
选择在 ONLYOFFICE 中编辑，在编辑器中打开文件。

查看文档：

右键点击该文件。
选择在 ONLYOFFICE 中查看，无需下载文件即可打开只读预览。

创建新文件：

使用 ACA 界面中的在 ONLYOFFICE 中创建选项。
选择要创建的文件类型：文档、电子表格、演示文稿或 PDF 表单。
新文件将立即打开以供编辑。

将文件转换为 OOXML 格式：

在 ACA 中选择该文件。
点击在 ONLYOFFICE 中转换。

以其他格式导出文件：

在 ACA 中选择该文件。
使用下载为并选择所需格式，无需离开 Alfresco Content App。

要了解有关表单的更多信息，请阅读有关创建和填写表单的相关文章。

关于 ONLYOFFICE 与 Alfresco Content App 集成​

主要功能​

支持的格式​

1.0.0 版本的新功能​

将 ONLYOFFICE Docs 连接到 Alfresco Content App​

要求​

安装 ONLYOFFICE Alfresco Content App 集成​

为 ONLYOFFICE 与 Alfresco Content App 集成启用 JWT​

在 Alfresco Content App 中开始使用 ONLYOFFICE Docs​