文档权限

文档权限部分允许更改要编辑和下载的文档的权限。

changeHistory

类型: boolean

允许在使用onRequestRestore事件时显示恢复按钮。默认值为false

Deprecated

自 5.5 版起已弃用,请改为添加onRequestRestore字段。

示例:true

聊天

类型: boolean

定义是否在文档中启用聊天功能。如果聊天权限设置为true,将显示聊天菜单按钮。

示例:true

评论

类型: boolean

定义是否可以评论文档。如果评论权限设置为"true",文档侧栏将包含评论菜单选项;如果mode参数设置为edit,文档注释将仅对文档编辑器可用。默认值与edit参数的值一致。

备注

如果edit设置为"true"并且comment也设置为"true",用户将能够编辑文档和评论。如果edit设置为"true"comment设置为"false",用​户将只能编辑,相应的评论功能将只能查看,评论的添加和编辑将不可用。如果edit设置为"false"并且comment设置为"true",该文档将仅用于评论。如果edit设置为"false"review设置为"false"comments设置为"true",则不考虑fillForms值并且无法填写表单。

示例:true

commentGroups

类型: object

定义用户可以编辑、删除和/或查看其评论[组](../editor/editor.md#user。

[""]值意味着用户可以编辑/删除/查看不属于这些组的人所做的评论(例如,如果文档在第三方编辑器中进行了审阅)。如果值为[],则用户无法编辑/删除/查看任何组的评论。如果edit,removeview参数为""或未指定,则用户可以查看/编辑/删除任何用户的评论。

示例:



commentGroups.edit

类型: list

用户可以编辑其他用户发表的评论。

示例:["Group2", ""]

commentGroups.remove

类型: list

用户可以删除其他用户的评论。

示例:[]

commentGroups.view

类型: list

用户可以查看其他用户发表的评论。

示例:""

复制

类型: boolean

定义是否可以将内容复制到剪贴板。如果参数设置为false,则粘贴内容将仅在当前文档编辑器中可用。默认值为true

示例:true

deleteCommentAuthorOnly

类型: boolean

定义用户是否只能删除他/她的评论。默认值为false

示例:true

下载

类型: boolean

定义文档是可以下载还是只能在线查看或编辑。如果下载权限设置为"false",则文件菜单中将不存在下载为...菜单选项。默认值为true

示例:true

修改

类型: boolean

定义文档是可以编辑还是只能查看。如果编辑权限设置为"true",文件菜单将包含编辑文档菜单选项;请注意,如果编辑权限设置为"false",文档将在查看器中打开,即使mode参数设置为edit,您也无法将其切换到编辑器。默认值为true

示例:true

editCommentAuthorOnly

类型: boolean

定义用户是否只能编辑他/她的评论。默认值为false

示例:true

fillForms

类型: boolean

定义是否可以填写表单。仅当mode参数设置为edit时,文档编辑器和 pdf编辑器才可以填写表单。默认值与edit或review参数的值一致。

备注

如果edit设置为"true"review设置为"true",则不考虑fillForms值并且可以填写表单。如果edit设置为"false"并且review设置为"false"并且fillForms也设置为"true",用户只能填写文档中的表单。如果edit设置为"false"并且review设置为"false"而且fillForms设置为"true",不考虑comments值并且评论不可用。仅填写表单模式目前仅适用于文档编辑器

示例:true

modifyContentControl

类型: boolean

定义是否可以更改内容控制设置。 如果mode参数设置为edit,内容控制修改将仅可用于文档编辑器。默认值为true

示例:true

modifyFilter

类型: boolean

定义过滤器是否可以全局应用(true)影响所有其他用户,或本地应用(false),即仅适用于当前用户。如果mode参数设置为edit,则过滤器修改仅可用于电子表格编辑器。默认值为true

备注

如果文档由具有完全访问权限的用户编辑,则该用户应用的过滤器将对所有其他用户可见,而不管他们的本地设置如何。

示例:true

print

类型: boolean

定义是否可以打印文档。如果打印权限设置为"false",则文件菜单中将不存在打印菜单选项。默认值为true

示例:true

保护

类型: boolean

定义工具栏上的保护选项卡和左侧菜单中的保护按钮是显示 (true) 还是隐藏 (false)。默认值为true

示例:true

重命名

类型: boolean

允许在使用onRequestRename事件时显示重命名...按钮。默认值为false

Deprecated

自 6.0 版起已弃用,请改为添加onRequestRename字段。

示例:true

审阅

类型: boolean

定义是否可以查看文档。如果审阅权限设置为true,文档状态栏将包含审阅菜单选项;如果mode参数设置为edit,文档审阅将仅对文档编辑器可用。默认值与edit参数的值一致。

备注

如果edit设置为"true"并且review也设置为"true",用户将能够编辑文档,接受/拒绝所做的更改并切换到他/她自己的审阅模式。如果edit设置为"true"并且review设置为"false",用户将只能进行编辑。如果edit设置为"false"并且review设置为"true",文档将仅在审阅模式下可用。

示例:true

reviewGroups

类型: string数组

定义用户可以接受/拒绝其更改的组。[""]值意味着用户可以查看不属于任何这些组的人所做的更改(例如,如果文档是在第三方编辑器中查看的)。如果值为[],则用户无法查看任何组所做的更改。如果值为""或未指定,则用户可以查看任何用户所做的更改。

示例:["Group1", "Group2", ""]

userInfoGroups

类型: string数组

定义其信息显示在编辑器中的用户组:

  • 用户名显示在编辑器标题的编辑用户列表中,
  • 输入文本时,会显示用户光标和工具提示及其名称,
  • 在严格的共同编辑模式下锁定对象时,会显示用户名。

["Group1", ""]表示显示Group1中的用户和不属于任何组的用户的信息。[]表示根本不显示任何用户信息。undefined""值表示显示所有用户的信息。

示例:["Group1", ""]

示例

const config = {
  document: {
    permissions: {
      chat: true,
      comment: true,
      copy: true,
      commentGroups: {
        edit: ["Group2", ""],
        remove: [""],
        view: "",
      },
      deleteCommentAuthorOnly: false,
      download: true,
      edit: true,
      editCommentAuthorOnly: false,
      fillForms: true,
      modifyContentControl: true,
      modifyFilter: true,
      print: true,
      protect: true,
      review: false,
      reviewGroups: ["Group1", "Group2", ""],
      userInfoGroups: ["Group1", ""],
    }
    ,
  },
};

const docEditor = new DocsAPI.DocEditor("placeholder", config);

results matching ""

    No results matching ""