跳到主要内容

添加DMS提供商

ONLYOFFICE桌面编辑器允许用户从云端访问文档并与团队成员协作编辑。这种情况下，需要互联网连接。目前，用户可以将应用程序连接到ONLYOFFICE DocSpace（SaaS或本地部署）、Nextcloud、ownCloud、Moodle、Liferay、kDrive或Seafile，但您可以通过添加自己的文档管理系统（DMS）来扩展此列表。

按照以下步骤将您自己的文档管理系统（DMS）添加到连接列表中：

步骤1​

在providers目录中使用DMS提供商的名称创建一个文件夹（例如onlyoffice）。文件夹的路径取决于您使用的操作系统：

%ProgramFiles%\ONLYOFFICE\DesktopEditors\providers\

步骤2​

创建一个config.json文件来指定集成参数。

参数​

参数类型示例描述
providerstring"onlyoffice"在JavaScript命令中用于引用桌面应用的提供商ID。
namestring"ONLYOFFICE"在添加云端时提供商选择部分显示的名称。
checkobject{ "url": "status", "headers": { "X-CUSTOM-HEADER": true } }用于检查门户可用性的参数。会发送一个GET请求，之后期望返回HTTP_STATUS_CODE = 200。响应必须以JSON格式返回。
check.urlstring"status"请求中使用的URL。
check.headersobject{ "OCS-APIREQUEST": true }添加到ajax请求的头部。
entryPagestringhttps://url-to-connect-provider.com用于连接提供商的URL。它代替提供商地址使用，并允许桌面应用不发送检查请求。
extraLogoutstring / array[string]https://url-for-logout.com从云端登出的URL。它代替提供商地址使用。
editorPagestring"/apps/onlyoffice/" 或 "regex:\/lib\/(?:[\w-]{32,})\/file\/"指示正在打开的文件类型为文档的相对URL。您可以为此参数使用正则表达式。
startPagestring"/"在创建新连接时添加到输入的IP或域名后的相对URL。
iconsobject{ "themeLight": { "connectionsList": "./assets/listicon.svg", "buttonLogo": "./assets/buttonlogo.svg" } }门户的图标。您可以通过指定带有相应图标的themeLight和themeDark对象，为每种UI主题类型（亮色和暗色）添加图标。
icons.connectionsListstring"./assets/listicon.svg"连接列表图标的路径。

示例​

{
  "provider": "onlyoffice",
  "name": "ONLYOFFICE",
  "check": {
    "url": "status",
    "headers": {
      "X-CUSTOM-HEADER": true
    }
  },
  "entryPage": "https://url-to-connect-provider.com",
  "extraLogout": "https://url-for-logout.com",
  "editorPage": "/apps/onlyoffice/",
  "startPage": "/",
  "icons": {
    "themeLight": {
      "connectionsList": "./assets/listicon.svg",
      "buttonLogo": "./assets/buttonlogo.svg"
    },
    "themeDark": {
      "connectionsList": "./assets/listicon_dark.svg",
      "buttonLogo": "./assets/buttonlogo_dark.svg"
    }
  }
}

步骤3​

创建应用程序页面的图标，并将其放入config.json文件中指定的文件夹：

  1. 连接列表的亮色和暗色图标。所需图标尺寸为36x36：

    连接列表连接列表

  2. 当已连接的云端列表为空时，连接页面上提供商按钮的亮色和暗色图标。所需图标尺寸为148x38。这些图标适用于9.0以下版本：

    提供商按钮提供商按钮

支持的图像格式为 .png、.jpeg、.svg。我们建议使用 .svg文件，以便在系统中200%缩放的HiDPI显示器上正确显示。

您也可以为每种UI主题类型（亮色和暗色）添加图标。在这种情况下，创建四个图标（每种主题两个）并将它们全部添加到config.json文件中。

步骤4​

  1. 启动ONLYOFFICE桌面编辑器，如果需要请重启。
  2. 点击云端旁边的 加号图标加号图标。
  3. 在连接到云端办公窗口中，打开可用云端列表，检查连接是否正常工作。