跳到主要内容

重命名文件

参考图和以下步骤说明了在 ONLYOFFICE 文档中重命名文档的过程。

重命名文件

  1. 用户在文档编辑器中为文档指定一个新名称。
  2. 文档编辑器将文档的新名称通知给文档管理器
  3. 文档管理器将文档的新名称发送到文档存储服务,在这里软件集成商重命名文档。
  4. 文档存储服务将文档的新名称通知给文档编辑服务
  5. 文档编辑服务将文档的新名称发送给每个用户的文档编辑器
  6. 现在新名称对所有用户可见。

如何在实践中做到这一点

  1. 创建一个 html 文件来打开文档

  2. 指定用于在文档编辑器初始化的配置脚本中打开*重命名...*菜单的事件处理程序。当调用 onRequestRename 事件时,不带扩展名的文档的新名称被发送给软件集成商,软件集成商在文档存储服务中重命名文档。

    onRequestRename
    function onRequestRename(event) {
    const title = event.data
    }

    const docEditor = new DocsAPI.DocEditor("placeholder", {
    events: {
    onRequestRename,
    },
    })
  3. 为了更新所有协作编辑器的文档名称,请将 c 参数的值设置为 meta,然后将请求发送到文档命令服务

    {
    "c": "meta",
    "key": "Khirz6zTPdfd7",
    "meta": {
    "title": "Example Document Title.docx"
    }
    }
  4. 当通过 meta 命令更改文档名称时,必须在每个用户的文档编辑器中调用 onMetaChange 事件。此事件在 data.title 参数中发送文档的名称。

    function onMetaChange(event) {
    const title = event.data.title
    }

    const docEditor = new DocsAPI.DocEditor("placeholder", {
    events: {
    onMetaChange,
    },
    })