SP. Группа object (sp.js)

Статья
02/03/2016

Представляет группу на веб-сайте Microsoft SharePoint Foundation.

Дата последнего изменения: 9 марта 2015 г.

Область применения: apps for SharePoint | SharePoint Foundation 2013 | SharePoint Server 2013

Содержание
Элементы
Примечания.
Конечная точка ресурса REST

var object = new SP.Group()

Элементы

Объект Group содержит следующие элементы.

Конструктор

Объект Group имеет следующий конструктор.

Конструктор	Описание
Группа	Получает или задает время ожидания запроса в миллисекундах

Методы

Объект Group содержит следующие методы.

Метод	Описание
обновление;	Обновляет свойства группы после внесения изменений.

Properties

Объект Group имеет следующие свойства.

Свойство	Описание
allowMembersEditMembership	Получает или задает значение, указывающее, могут ли новые папки добавляться в список.
allowRequestToJoinLeave	Получает или задает идентификатор типа контента, с которым связано представление, чтобы оно было доступно только для папок с контентом этого типа.
autoAcceptRequestToJoinLeave	Получает или задает значение, указывающее, могут ли запросы на присоединение к группе или выход из нее приниматься автоматически.
canCurrentUserEditMembership	Получает значения полей элемента в виде коллекции строковых значений.
canCurrentUserManageGroup	Содержит копию ответа сторонней службы.
canCurrentUserViewMembership	Получает значение, указывающее, может ли текущий пользователь просматривать список членов группы.
Описание	Получает или задает строку, содержащую имя создаваемой группы.
onlyAllowMembersViewMembership	Получает или задает значение, указывающее, только ли члены группы могут просматривать список ее членов.
Владелец	Получает или задает владельца группы, который может быть пользователем или другой группой, получившими разрешения на управление безопасностью.
ownerTitle	Возвращает коллекцию элементов списка по указанному запросу.
requestToJoinLeaveEmailSetting	Получает URL-адрес, связанный с контекстом среды выполнения.
Пользователи	Получает шаблон списка по указанному индексу в коллекции.

Примечания.

Каждая группа содержит коллекцию пользователей и имеет уникальный идентификатор.

Пример

В следующем примере создается кнопка input на страницу приложения, которое добавляет текущего пользователя в группу посетителей на текущем веб-сайте.

<asp:Content ID="Main" ContentPlaceHolderID="PlaceHolderMain" runat="server">
<script type="text/ecmascript" language="ecmascript">

var user;
var visitorsGroup;

function runCode() {

     var clientContext = new SP.ClientContext();
     var groupCollection = clientContext.get_web().get_siteGroups();
     // Get the visitors group, assuming its ID is 4.
     visitorsGroup = groupCollection.getById(4);
     user = clientContext.get_web().get_currentUser();
     var userCollection = visitorsGroup.get_users();
     userCollection.addUser(user);

     clientContext.load(user);
     clientContext.load(visitorsGroup);
     clientContext.executeQueryAsync(Function.createDelegate(this, this.onQuerySucceeded), Function.createDelegate(this, this.onQueryFailed));

}

function onQuerySucceeded() {
    alert(user.get_title() + " added to group " + visitorsGroup.get_title());
}

function onQueryFailed(sender, args) {
    alert('Request failed. ' + args.get_message() + '\n' + args.get_stackTrace());
}

</script>

    <input id="Button1" type="button" value="Run Code" onclick="runCode()" />

</asp:Content>

Конечная точка ресурса REST

Дополнительные сведения см в группе ресурсов .

Структура URI конечной точки

http://<sitecollection>/<site>/_api/web/sitegroups(groupid)

Запросы HTTP

Этот ресурс поддерживает следующие команды HTTP:

MERGE

Синтаксис MERGE

MERGE http://<sitecollection>/<site>/_api/web/sitegroups(groupid)

Синтаксис POST

POST http://<sitecollection>/<site>/_api/web/sitegroups(groupid)

Синтаксис PUT

PUT http://<sitecollection>/<site>/_api/web/sitegroups(groupid)

Поделиться через