评论

评论选项 允许您对特定的单词、短语、句子和其他文档部分发表评论，编辑和删除这些评论。 所有评论将被保存并显示给其他文档用户。

评论访问权限

为了启用评论选项，文档初始化的权限部分中的 comment 参数必须设置为 true。 文档侧栏 将包含 评论 菜单选项。

如果 edit 参数设置为 true 并且 comment 参数也设置为 true，用户将能够编辑文档和评论。

如果 edit 参数设置为 false 并且 comment 参数设置为 true，则文档将仅可用于评论。

var docEditor = new DocsAPI.DocEditor("placeholder", {
    "document": {
        "permissions": {
            "edit": false,
            "comment": true
            ...
        },
        ...
    },
    ...
});

作者评论权的区分

1. 如果您希望仅允许其作者编辑评论，请将编辑器初始化的权限部分中的 editCommentAuthorOnly 参数设置为 true。

   var docEditor = new DocsAPI.DocEditor("placeholder", {
       "document": {
           "permissions": {
               "editCommentAuthorOnly": true
               ...
           },
           ...
       },
       ...
   });
   

2. 如果您希望仅允许其作者删除评论，请将编辑器初始化的权限部分中的 deleteCommentAuthorOnly 参数设置为 true。

   var docEditor = new DocsAPI.DocEditor("placeholder", {
       "document": {
           "permissions": {
               "deleteCommentAuthorOnly": true
               ...
           },
           ...
       },
       ...
   });
   

按组区分评论权

1. 通过在editorConfig部分的 user 参数中添加字段 group 来指定用户所属的组（或用逗号分隔的多个组）。

   var docEditor = new DocsAPI.DocEditor("placeholder", {
       "editorConfig": {
           "user": {
               "id": "78e1e841",
               "name": "John Smith",
               "group": "Group1"
           }
       },
       ...
   });
   
   var docEditor = new DocsAPI.DocEditor("placeholder", {
       "editorConfig": {
           "user": {
               "id": "F89d8069ba2b",
               "name": "Kate Cage",
               "group": "Group2"
           }
       },
       ...
   });
   

2. 使用编辑器初始化的权限部分中的 commentGroups 参数指定访问权限。

   如果在编辑器配置中指定了 commentGroups 参数，则查看、编辑和/或删除所有评论的访问权限将被禁用。 否则，如果当前用户不属于任何组，他或她可以编辑、删除和/或查看所有组的评论。

   var docEditor = new DocsAPI.DocEditor("placeholder", {
       "document": {
           "permissions": {
               "commentGroups": {
                   "edit": ["Group2", ""],
                   "remove": [""],
                   "view": ""
               },
               ...
           }
           ...
       },
       ...
   });
   

   • "edit": ["Group2", ""] 表示用户可以编辑来自 Group2 的用户和不属于任何组的用户发表的评论（例如，在第三方编辑器中评论的文档）。
   • "remove": [""] 表示用户可以删除不属于这些组的人的评论（例如，在第三方编辑器中评论的文档）。
   • "view": "" 表示用户可以查看任何用户发表的评论。

电子表格中的线程评论

为了在其他编辑器中正确显示 ONLYOFFICE 电子表格评论，所有评论都以两种格式保存 - 原始和线程：

1. 原始评论格式 如下：

   ${author1}:
   comment
   ${author2}:
   reply1
   ${author2}:
   reply2
   

   
2. 要将原始评论格式转换为 线程评论，如果评论以它开头，则删除 "${author}:\n" 字符串。

编辑器中的文件打开如下：

• 如果文件中有线程评论，则在打开时使用它们。
• 如果只有原始 ONLYOFFICE 格式的评论，它们将被转换为线程评论。