Описание
Раздел document permission позволяет либо изменить разрешение на редактирование и загрузку документа либо нет.
Параметры
| Название | Описание | Тип | Пример |
| changeHistory | Позволяет отображать кнопку «Восстановить» при использовании события onRequestRestore. Значение по умолчанию false. Устарело с версии 5.5, вместо этого добавьте поле onRequestRestore | логический | true |
| chat | Определяет, включена ли функция чата в документе или нет. Если для разрешения чата установлено значение true, будет отображаться кнопка меню чата. Значение по умолчанию true | логический | true |
| comment | Определяет, можно ли комментировать документ. Если для разрешения на комментирование установлено значение «true», боковая панель документа будет содержать пункт меню «Комментарий»; комментирование документа будет доступно только для редактора документа, если режим параметра установлен на редактирование. Значение по умолчанию совпадает со значением редактируемого параметра. | логический | true |
Если для редактирования установлено значение «true», а для параметра comment также установлено значение «true», пользователь сможет редактировать документ и комментарий. Если для редактирования установлено значение «true», а для комментария установлено значение «false», пользователь сможет только редактировать, соответствующий функционал комментирования будет доступен только для просмотра, добавление и редактирование комментариев будет недоступно. Если для редактирования установлено значение «false», а для комментария установлено значение «true», документ будет доступен только для комментирования. Если для редактирования установлено значение «false», для обзора установлено значение «false», а для комментариев установлено значение «true», значение fillForms не учитывается и заполнение форм недоступно.
| |||
| commentGroups | Определяет группы, чьи комментарии пользователь может редактировать, удалять и/или просматривать. Объект имеет следующие параметры:
Значение [«»] означает, что пользователь может редактировать/удалять/просматривать комментарии, сделанные кем-то, кто не принадлежит ни к одной из этих групп (например, если документ рецензируется в сторонних редакторах). Если значение равно [], пользователь не может редактировать/удалять/просматривать комментарии, сделанные какой-либо группой. Если параметры редактирования, удаления и просмотра имеют значение «» или не указаны, то пользователь может просматривать/редактировать/удалять комментарии, сделанные любым пользователем. | объект | |
| copy | Определяет, может ли содержимое быть скопировано в буфер обмена или нет. Если для параметра установлено значение false, вставка содержимого будет доступна только в текущем редакторе документа. Значение по умолчанию true. | логический | true |
| deleteCommentAuthorOnly | Определяет, может ли пользователь удалять только свои комментарии. Значение по умолчанию false. | логический | true |
| download | Определяет, может ли документ быть загружен или только просмотрен или отредактирован онлайн. Если для разрешения на загрузку установлено значение «false», пункт меню «Загрузить как…» будет отсутствовать в меню «Файл». Значение по умолчанию true. | логический | true |
| edit | Определяет, можно ли редактировать документ или только просматривать. Если разрешение на редактирование установлено на «true», меню «Файл» будет содержать пункт меню «Редактировать документ»; пожалуйста обратите внимание, что если разрешение на редактирование установлено на «false», документ будет открыт в средстве просмотра, и вы не сможете переключить его в редактор, даже если параметр режима установлен на редактирование. Значение по умолчанию true. | логический | true |
| editCommentAuthorOnly | Определяет, может ли пользователь редактировать только свои комментарии. Значение по умолчанию false. | логический | true |
| fillForms | Определяет, могут ли формы быть заполнены. Заполнение форм будет доступно для редактора документов только в том случае, если параметр режима установлен на редактирование. Значение по умолчанию совпадает со значением параметра редактирования или обзора | логический | true |
Если для редактирования установлено значение «true» или для обзора установлено значение «true», значение fillForms не учитывается и возможно заполнение формы. Если для редактирования установлено значение «false» и для обзора установлено значение «false», а для fillForms также установлено значение «true», пользователь может только заполнять формы в документе. Если для редактирования установлено значение «false», для обзора установлено значение «false», а для fillForms установлено значение «true», значение комментариев не учитывается и комментирование недоступно. Режим только заполнения формы в настоящее время доступен только для Редактора документов.
| |||
| modifyContentControl | Определяет, можно ли заменить настройки управления содержимым. Изменение элемента управления содержимым будет доступно для редактора документов только в том случае, если параметр режима установлен на редактирование. Значение по умолчанию true. | логический | true |
| modifyFilter | Определяет, может ли фильтр применяться глобально (true) ко всем пользователям или локально (false), то есть только к текущему пользователю. Изменение фильтра будет доступно для редактора электронных таблиц только в том случае, если параметр режима установлен на редактирование. Значение по умолчанию true. | логический | true |
В случае, если документ редактируется пользователем с полными правами доступа, фильтры, примененные таким пользователем, будут видны всем остальным пользователям, вне зависимости от их локальных настроек. | |||
| Определяет, можно ли распечатать документ или нет. Если для разрешения печати установлено значение «false», пункт меню «Печать» будет отсутствовать в меню «Файл». Значение по умолчанию верно. | логический | true | |
 | |||
| protect | Определяет, будут ли отображаться вкладка «Защита» на панели инструментов и кнопка «Защитить» в левом меню (true) или скрыта (false). Значение по умолчанию true. | логический | true |
| rename | Позволяет отображать кнопку «Переименовать…» при использовании события onRequestRename. Значение по умолчанию false. Устарело с версии 6.0, вместо этого добавьте поле onRequestRename | логический | true |
| review | Определяет, может ли документ быть просмотрен или нет. Если для разрешения на рецензирование установлено значение true, «status bar» документа будет содержать параметр Reviewmenu; просмотр документа будет доступен только для редактора документов, если параметр режима установлен на редактирование. Значение по умолчанию совпадает со значением редактируемого параметра | логический | true |
В случае, если для редактирования установлено значение «true», а для обзора также установлено значение «true», пользователь сможет редактировать документ, принимать/отклонять внесенные изменения и самостоятельно переключаться в режим просмотра. Если для редактирования установлено значение «true», а для обзора установлено значение «false», пользователь сможет только редактировать. Если для редактирования установлено значение «false», а для обзора установлено значение «true», документ будет доступен только в режиме просмотра.
| |||
| reviewGroups | Определяет группы, чьи изменения пользователь может принять/отклонить. Значение [«»] означает, что пользователь может просматривать изменения, сделанные кем-то, кто не принадлежит ни к одной из этих групп (например, если документ рецензируется в сторонних редакторах). Если значение равно [], пользователь не может просматривать изменения, сделанные какой-либо группой. Если значение равно «» или не указано, то пользователь может просматривать изменения, сделанные любым пользователем. | массив строк | |
| userInfoGroups | Определяет группы пользователей, информация о которых отображается в редакторах:
[«Группа1», «»] означает, что отображается информация о пользователях из Группы1 и пользователях, не принадлежащих ни к одной группе. [] означает, что информация о пользователе вообще не отображается. Значения undefined или «» означают, что отображается информация обо всех пользователях. | массив строк | |
Example
var docEditor = new DocsAPI.DocEditor("placeholder", {
"document": {
"permissions": {
"chat": true,
"comment": true,
"commentGroups": {
"edit": ["Group2", ""],
"remove": [""],
"view": ""
},
"copy": true,
"deleteCommentAuthorOnly": false,
"download": true,
"edit": true,
"editCommentAuthorOnly": false,
"fillForms": true,
"modifyContentControl": true,
"modifyFilter": true,
"print": true,
"protect": true,
"review": true,
"reviewGroups": ["Group1", "Group2", ""],
"userInfoGroups": ["Group1", ""]
},
...
},
...
});