安装 - 云端
要在云端安装ONLYOFFICE 文档:
-
通过我们的官网上填写注册表单,在云端部署ONLYOFFICE文档开发者版解决方案。
-
在需要嵌入编辑器的目标 HTML 文件中,指定一个占位符 div 标签,用于传递所有关于编辑器参数的配置信息:
<div id="placeholder"></div>
<script type="text/javascript" src="https://documentserver/web-apps/apps/api/documents/api.js"></script>documentserver 是您的云服务提供的公共 IP 地址或公共 DNS。该地址由系统自动分配,可在云控制台的实例部分查看。
https://documentserver/web-apps/apps/api/documents/api.js
是 API JavaScript 文件的默认访问地址。信息从 8.1 版本开始,建议在 URL QueryString 中添加 shardkey 参数,并赋予其 key 值。例如:?shardkey=Khirz6zTPdfd7。此参数可用于请求负载均衡。
-
指定包含可变参数的页面代码:
const config = {
document: {
fileType: "docx",
key: "Khirz6zTPdfd7",
title: "Example Document Title.docx",
url: "https://example.com/url-to-example-document.docx",
},
documentType: "word",
editorConfig: {
callbackUrl: "https://example.com/url-to-callback.ashx",
},
};
const docEditor = new DocsAPI.DocEditor("placeholder", config);此处 example.com 是您的云服务提供的公共 IP 或公共 DNS,需确保已在此地址部署文档管理器和文档存储服务。关于 ONLYOFFICE 文档服务端与客户端的交互细节,请参阅工作原理章节。
此后,docEditor 对象即可用于调用文档编辑器方法.
以上示例包含确保 ONLYOFFICE 文档正常启动所需的全部必要参数。
-
添加非必需的可选参数,以实现文档的多样化配置(如修改文档权限、显示不同文档信息等)。具体参数列表及用法请参阅高级参数章节。
-
为请求添加加密签名令牌,防止关键参数被篡改。