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

Подписка на контент в SharePoint

  • Статья

Узнайте о распространенных задачах программирования для следующего содержимого (документы, сайты и теги) в SharePoint.

API для следующего содержимого в SharePoint

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

SharePoint предоставляет следующие API-интерфейсы, которые можно использовать для программного следовать содержимому:

  • Клиентские объектные модели для управляемого кода

    • Клиентская объектная модель .NET

    • Клиентская объектная модель Silverlight

    • Клиентская объектная модель для мобильных устройств.

  • Объектная модель JavaScript

  • Служба передачи репрезентативного состояния (REST).

  • Объектная модель сервера

Согласно передовой практике в разработке SharePoint, используйте клиентские интерфейсы API, когда это возможно. Клиентские API-интерфейсы включают клиентских объектных моделей, модель объекта JavaScript и службы REST. Дополнительные сведения об API в SharePoint и их использовании см. в статье Выбор правильного набора API в SharePoint.

Каждый API включает в себя объект диспетчера, используемая для выполнения основных задач по следующее содержимое.

Примечание.

[!Примечание] Же API используются следить за людьми. Общие сведения о задачах "Отслеживание пользователей " см. в статье Отслеживание пользователей в SharePoint .

В таблице 1 приведены диспетчер и другие ключевые объекты (или ресурсы REST) в API-интерфейсы и библиотека классов (или точка доступа) где их можно найти.

Примечание.

[!Примечание] Модель Silverlight и мобильная клиентская объектная модель не включены в таблицу 1 или таблицу 2, так как они предоставляют такой же основной функционал, как и клиентская объектная модель .NET, и одинаковые подписи. Клиентская объектная модель Silverlight определена в Microsoft.SharePoint.Client.UserProfiles.Silverlight.dll, а мобильная клиентская объектная модель — в Microsoft.SharePoint.Client.UserProfiles.Phone.dll.

Таблица 1. API SharePoint, используемые для программного выполнения содержимого

API Ключевые объекты
Клиентская объектная модель .NET
См. практическое руководство. Отслеживание документов и сайтов с помощью клиентской объектной модели .NET в SharePoint		 Объект Manager: SocialFollowingManager
Основное пространство имен: Microsoft.SharePoint.Client.Social
Другие ключевые объекты: SocialActor , SocialActorInfo , SocialActorType , SocialActorTypes
Библиотека классов: Microsoft.SharePoint.Client.UserProfiles.dll
Объектная модель JavaScript Объект Manager: SocialFollowingManager
Основное пространство имен: SP. Общественный
Другие ключевые объекты: SocialActor, SocialActorInfo, SocialActorType, SocialActorTypes
Библиотека классов: SP.UserProfiles.js
Служба REST
См . статью Практическое руководство. Отслеживание документов, сайтов и тегов с помощью службы REST в SharePoint		 Ресурс диспетчера: social.following
Основное пространство имен (OData): sp.social.SocialRestFollowingManager
Другие ключевые ресурсы: SocialActor, SocialActorInfo, SocialActorType, SocialActorTypes
Точка доступа: <siteUri>/_api/social.following
Объектная модель сервера Объект Manager: SPSocialFollowingManager
Основное пространство имен: Microsoft.Office.Server.Social
Другие ключевые объекты: SPSocialActor , SPSocialActorInfo , SPSocialActorType , SPSocialActorTypes
Библиотека классов: Microsoft.Office.Server.UserProfiles.dll

Распространенные задачи программирования для следующего содержимого в SharePoint

В таблице 2 перечислены типичные задачи программирования для следующее содержимое и элементы, которые можно использовать для их выполнения. Члены: от клиентской объектной модели .NET (CSOM), JavaScript объектной модели (JSOM), служба REST и серверной объектной модели (SSOM).

Примечание.

[!Примечание] Же API используются следить за людьми. Общие сведения о задачах "Отслеживание пользователей " см. в статье Отслеживание пользователей в SharePoint .

Табл. 2. API для распространенных задач для следующего содержимого в SharePoint

Задача Members
Создание экземпляра объекта диспетчера в контексте текущего пользователя CSOM: SocialFollowingManager
SocialFollowingManagerJSOM:
ОТДЫХ: <siteUri>/_api/social.following
SSOM: SPSocialFollowingManager
Создайте экземпляр объекта диспетчера в контексте указанного пользователя CSOM: не реализовано
JSOM: не реализовано
REST: не реализовано
SSOM: SPSocialFollowingManager (перегружен)
У текущего пользователя создайте (остановить следующие) элемента CSOM: Подписаться ( StopFollowing )
JSOM: follow ( stopFollowing)
REST: POST<siteUri>/_api/social.following/Follow ( <siteUri>/_api/social.following/StopFollowing) и передача параметра субъекта в тексте запроса
SSOM: Подписаться ( StopFollowing )
Узнать, является ли текущий пользователь является после определенного элемента CSOM: IsFollowed
JSOM: isFollowed
REST: POST<siteUri>/_api/social.following/IsFollowed и передайте параметр субъекта в тексте запроса
SSOM: IsFollowed
Получение документы, сайты и/или теги, выполнив текущего пользователя CSOM: GetFollowed
JSOM: getFollowed
REST: GET<siteUri>/_api/social.following/my/Followed(types=2) (документы = 2, сайты = 4, теги = 8.md)
SSOM: GetFollowed
Получение числа документы, сайты и/или теги, на которые подписан пользователь CSOM: GetFollowedCount
JSOM: getFollowedCount
REST: GET<siteUri>/_api/social.following/my/FollowedCount(types=2) (документы = 2, сайты = 4, теги = 8.md)
SSOM: GetFollowedCount
Получение URI-адрес сайта, в котором приведены число документов текущего пользователя CSOM: FollowedDocumentsUri
JSOM: followedDocumentsUri
REST: GET<siteUri>/_api/social.following/my/FollowedDocumentsUri
SSOM: FollowedDocumentsUri
Получение URI-адрес сайта, в котором приведены число сайтов текущего пользователя CSOM: FollowedSitesUri
JSOM: followedSitesUri
REST: GET<siteUri>/_api/social.following/my/FollowedSitesUri
SSOM: FollowedSitesUri

Примечание.

Примеры использования службы REST для просмотра содержимого см. в статье Практическое руководство. Отслеживание документов, сайтов и тегов с помощью службы REST в SharePoint.

Как получить идентификатор GUID тега на основании имя тега с помощью объектной модели JavaScript

Start и stop отслеживание тега или чтобы узнать, совместимо ли текущий пользователь после его необходимо использовать идентификатор GUID тега. Приведенный ниже код показано, как получить GUID на основе имени тега.

Прежде чем запустить код необходимо добавить ссылку на sp.taxonomy.js и измените имя тега заполнитель с именем существующего тега.


function getTagGuid() {
    var tagName = '#tally';
    var clientContext = new SP.ClientContext.get_current();
    var label = SP.Taxonomy.LabelMatchInformation.newObject(clientContext);
    label.set_termLabel(tagName);
    label.set_trimUnavailable(false);
    var taxSession = SP.Taxonomy.TaxonomySession.getTaxonomySession(clientContext);
    var termStore = taxSession.getDefaultKeywordsTermStore();
    var termSet = termStore.get_hashTagsTermSet();
    terms = termSet.getTerms(label);
    clientContext.load(terms);
    clientContext.executeQueryAsync(
        function () {
            var tag = terms.get_item(0);
            if (tag !== null) {
                var tagGuid = tag.get_id().toString();
                if (!SP.ScriptUtility.isNullOrEmptyString(tagGuid)) {
                    alert(tagGuid);
                }
            }
        },
        function (sender, args) {
            alert(args.get_message());
        }
    );
}

См. также