Document
文档部分允许更改与文档有关的所有参数(标题、url、文件类型等)。
fileType
定义查看或编辑的源文档的文件类型。必须是小写。以下文件类型可用: .csv、.djvu、.doc、.docm、.docx、.docxf、.dot、.dotm、.dotx、.epub、.fb2、.fodp、.fods、.fodt、.htm、.html、.key、.mht、.numbers、.odp、.ods、.odt、.oform、.otp、.ots、.ott、.oxps、.pages、.pdf、.pot、.potm、.potx、.pps、.ppsm、.ppsx、.ppt、.pptm、.pptx、.rtf、.txt、 .xls、.xlsb、.xlsm、.xlsx、.xlt、.xltm、.xltx、.xml、.xps.
此参数是必需的。
类型: string
示例 "docx"
key
定义服务用来识别文档的唯一文档标识符。如果发送了已知key,则将从缓存中获取文档。每次编辑和保存文档时,都必须重新生成key。文档 url 可以用作 key,但不能使用特殊字符,长度限制为 128 个符号。
请注意,对于连接到同一文档服务器的所有独立服务,密钥必须是唯一的。否则,服务可能会从编辑器缓存中打开其他人的文件。如果多个第三方集成商连接到同一文档服务器,他们也必须提供唯一的密钥。
可以使用的关键字符: 0-9, a-z, A-Z, -._=。 最大密钥长度为 128 个字符。
此参数是必需的。
类型: string
示例 "Khirz6zTPdfd7"
referenceData
定义一个由集成商生成的对象,用于唯一标识其系统中的文件:
类型: object
示例:
{
"fileKey": "BCFA2CED",
"instanceId": "https://example.com"
}
referenceData.fileKey
服务用来获取文件链接的唯一文档标识符。在编辑和保存文档时不得更改(即它不等于 document.key 参数)。
类型: string
示例 "BCFA2CED"
referenceData.instanceId
唯一的系统标识符。如果数据从一个系统上的文件复制并插入到另一个系统的文件中,则通过链接粘贴将不可用,并且上下文菜单中没有相应的按钮。
类型: string
示例 https://example.com
标语
为查看或编辑的文档定义所需的文件名,该文件名也将在下载文档时用作文件名。长度限制为 128 个符号。
此参数是必需的。
类型: string
示例 "Example Document Title.docx"
url
定义存储查看或编辑的源文档的绝对 URL。使用本地链接时请务必添加 令牌。否则会出现错误。
此参数是必需的。
类型: string
示例 https://example.com/url-to-example-document.docx
示例
const docEditor = new DocsAPI.DocEditor("placeholder", {
document: {
fileType: "xlsx",
key: "Khirz6zTPdfd7",
referenceData: {
fileKey: "BCFA2CED",
instanceId: "https://example.com",
},
title: "Example Title",
url: "https://example.com/url-to-example-document.xlsx",
},
})
其中 example.com 是安装了文档管理器和文档存储服务的服务器的名称。有关 ONLYOFFICE 文档服务客户端交互的更多信息,请参阅 工作原理 部分。