Разрешения - Центр поддержки Р7

Запись опубликована:14.10.2022
Post category:Документ
Запись изменена:10.11.2022

Описание

Раздел 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	Определяет группы, чьи комментарии пользователь может редактировать, удалять и/или просматривать. Объект имеет следующие параметры: редактор — пользователь может редактировать комментарии, сделанные другими пользователями, тип: список, пример: [«Group2», «»]; удаление — пользователь может удалять комментарии, сделанные другими пользователями, тип: список, пример: []; просмотр -пользователь может просматривать комментарии, сделанные другими пользователями, тип: список, пример: «». Значение [«»] означает, что пользователь может редактировать/удалять/просматривать комментарии, сделанные кем-то, кто не принадлежит ни к одной из этих групп (например, если документ рецензируется в сторонних редакторах). Если значение равно [], пользователь не может редактировать/удалять/просматривать комментарии, сделанные какой-либо группой. Если параметры редактирования, удаления и просмотра имеют значение «» или не указаны, то пользователь может просматривать/редактировать/удалять комментарии, сделанные любым пользователем.	объект
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
В случае, если документ редактируется пользователем с полными правами доступа, фильтры, примененные таким пользователем, будут видны всем остальным пользователям, вне зависимости от их локальных настроек.
print	Определяет, можно ли распечатать документ или нет. Если для разрешения печати установлено значение «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", ""]
        },
        ...
    },
    ...
});