重命名文件
下图和以下步骤说明了如何在 ONLYOFFICE 文档中重命名文档。
- 用户在文档编辑器中选择重命名...。
- 文档编辑器通过 onRequestRename 事件将新名称发送给文档管理器。
- 文档管理器将新名称发送到文档存储服务,集成商在此处重命名文件。
- 文档存储服务向文档命令服务发送 meta 命令以更新文档名称。
- 文档编辑服务通过 onMetaChange 事件将新名称发送给每个用户的文档编辑器,使所有用户都能看到新名称。
如何在实践中做到这一点
-
创建一个
.html文件来打开文档。 -
在编辑器初始化配置中,定义 onRequestRename 事件处理程序。当用户在编辑器菜单中选择*重命名...*时,此事件会在
event.data中传递新名称(不含文件扩展名)。在处理程序中,将新名称发送到您的服务器,以便在文档存储服务中重命名文件。
function onRequestRename(event) {const newTitle = event.data;RENAME_FILE(newTitle);}const config = {events: {onRequestRename,},};const docEditor = new DocsAPI.DocEditor("placeholder", config);RENAME_FILE是您的服务器端逻辑的占位符,用于在文档存储服务中重命名文档。 -
重命名文件后,从您的服务器向文档命令服务发送带有 meta 命令的请求,以更新所有正在编辑文档的用户的名称:
{"c": "meta","key": "Khirz6zTPdfd7","meta": {"title": "Example Document Title.docx"}} -
当收到 meta 命令时,每个用户的文档编辑器中会触发 onMetaChange 事件。新名称通过
event.data.title传递。function onMetaChange(event) {const title = event.data.title;}const config = {events: {onMetaChange,},};const docEditor = new DocsAPI.DocEditor("placeholder", config);