Folgen von Inhalten in SharePoint 2013

SharePoint 2013

Erfahren Sie über allgemeine Programmierungsaufgaben für das Folgen von Inhalten (Dokumente, Websites und Tags) in SharePoint Server 2013.

Letzte Änderung:Donnerstag, 17. September 2015

Gilt für:SharePoint Server 2013

Wenn Benutzer Dokumenten, Websites oder Tags folgen, werden Statusupdates von Dokumenten, Unterhaltungen auf Websites und Benachrichtigungen zuTags in ihrem Newsfeed angezeigt. Die Features im Zusammenhang mit dem Folgen von Inhalten werden auf den Inhaltsseiten Newsfeed und Folgen angezeigt.

SharePoint Server 2013 stellt die folgenden APIs bereit, mit denen Sie Inhalten programmgesteuert folgen können:

  • Clientobjektmodelle für verwalteten Code

    • .NET-Clientobjektmodell

    • Silverlight-Clientobjektmodell

    • Mobiles Clientobjektmodell

  • JavaScript-Objektmodell

  • REST-Dienst (Representational State Transfer)

  • Serverobjektmodell

In der SharePoint 2013-Entwicklung wird empfohlen, so oft wie möglich Client-APIs zu verwenden. Client-APIs umfassen Clientobjektmodelle, das JavaScript-Objektmodell und einen REST-Dienst. Weitere Informationen zu APIs in SharePoint 2013 und zu ihrer Verwendung finden Sie unter Auswählen des richtigen API-Satzes in SharePoint 2013.

Jede API umfasst ein Manager-Objekt, das Sie verwenden, um wichtige Aufgaben für das Folgen von Inhalte durchzuführen.

Hinweis Hinweis

Dieselben APIs werden verwendet, um Personen zu folgen. Eine Übersicht über die Aufgaben rund um das Folgen von Personen finden Sie unter Folgen von Personen in SharePoint 2013.

In Tabelle 1 sind der Manager und andere wichtige Objekte (oder REST-Ressourcen) in den APIs und der Klassenbibliothek (oder dem Zugriffspunkt), in denen Sie diese finden können.

Hinweis Hinweis

Die Silverlight- und mobilen Clientobjektmodelle sind in Tabelle 1 oder Tabelle 2 nicht enthalten, da sie dieselben Kernfunktionen wie das .NET-Clientobjektmodell bereitstellen und dieselben Signaturen verwenden. Das Silverlight-Clientobjektmodell ist in Microsoft.SharePoint.Client.UserProfiles.Silverlight.dll definiert und das mobile Clientobjektmodell in Microsoft.SharePoint.Client.UserProfiles.Phone.dll.

Tabelle 1: Für das programmgesteuerte Folgen von Inhalten verwendete SharePoint 2013-APIs

.NET-Clientobjektmodell

Weitere Informationen: Vorgehensweise: Führen Sie Dokumente und Websites mit .NET Client-Objektmodell in SharePoint 2013

Manager-Objekt:
SocialFollowingManager

Primärer Namespace:
Microsoft.SharePoint.Client.Social

Andere wichtige Objekte:
SocialActor, SocialActorInfo, SocialActorType, SocialActorTypes

Klassenbibliothek:
Microsoft.SharePoint.Client.UserProfiles.dll

JavaScript-Objektmodell

Manager-Objekt:
SocialFollowingManager

Primärer Namespace:
SP.Social

Andere wichtige Objekte:
SocialActor, SocialActorInfo, SocialActorType, SocialActorTypes

Klassenbibliothek:
SP.UserProfiles.js

REST-Dienst

Weitere Informationen: Vorgehensweise: führen Sie Dokumente, Websites und Tags mithilfe des REST-Diensts in SharePoint 2013

Manager-Ressource:
social.following

Primärer Namespace (OData):
sp.social.SocialRestFollowingManager

Andere wichtige Ressourcen:
SocialActor, SocialActorInfo, SocialActorType, SocialActorTypes

Zugriffspunkt:
<siteUri>/_api/social.following

Serverobjektmodell

Manager-Objekt:
SPSocialFollowingManager

Primärer Namespace:
Microsoft.Office.Server.Social

Andere wichtige Objekte:
SPSocialActor, SPSocialActorInfo, SPSocialActorType, SPSocialActorTypes

Klassenbibliothek:
Microsoft.Office.Server.UserProfiles.dll

Tabelle 2 zeigt allgemeine Programmierungsaufgaben für das Folgen von Inhalten sowie die Elemente, die Sie zur Ausführung verwenden. Die Elemente stammen aus dem .NET-Clientobjektmodell (CSOM), dem JavaScript-Objektmodell (JSOM), dem REST-Dienst und dem Serverobjektmodell (SSOM).

Hinweis Hinweis

Dieselben APIs werden verwendet, um Personen zu folgen. Eine Übersicht über die Aufgaben rund um das Folgen von Personen finden Sie unter Folgen von Personen in SharePoint 2013.

Tabelle 2: API für allgemeine Aufgaben für das Folgen von Inhalten in SharePoint Server 2013

Aufgabe

Member

Erstellen einer Instanz eines Manager-Objekts im Kontext des aktuellen Benutzers

CSOM: SocialFollowingManager

JSOM: SocialFollowingManager

REST: <siteUri>/_api/social.following

SSOM: SPSocialFollowingManager

Erstellen einer Instanz eines Manager-Objekts im Kontext eines angegebenen Benutzers

CSOM: nicht implementiert

JSOM: nicht implementiert

REST: nicht implementiert

SSOM: SPSocialFollowingManager (überladen)

Zulassen, dass der aktuelle Benutzer beginnt, einem Element zu folgen (das Folgen zu beenden)

CSOM: Follow (StopFollowing)

JSOM: follow (stopFollowing)

REST: POST <siteUri>/_api/social.following/Follow (<siteUri>/_api/social.following/StopFollowing)
und Übergeben des Parameters actor im Anforderungstext

SSOM: Follow (StopFollowing)

Herausfinden, ob der aktuelle Benutzer einem bestimmten Element folgt

CSOM: IsFollowed

JSOM: isFollowed

REST: POST <siteUri>/_api/social.following/IsFollowed und Übergeben des Parameters actor im Anforderungstext

SSOM: IsFollowed

Abrufen von Benutzern, Dokumenten, Websites und Tags denen der aktuelle Benutzer folgt

CSOM: GetFollowed

JSOM: getFollowed

REST: GET <siteUri>/_api/social.following/my/Followed(types=2) (documents = 2, sites = 4, tags = 8)

SSOM: GetFollowed

Abrufen der Anzahl von Benutzern, Dokumenten, Websites und Tags denen der Benutzer folgt

CSOM: GetFollowedCount

JSOM: getFollowedCount

REST: GET <siteUri>/_api/social.following/my/FollowedCount(types=2) (documents = 2, sites = 4, tags = 8)

SSOM: GetFollowedCount

Abrufen des URI der Website, die die Dokumente des aktuellen Benutzers auflistet, denen gefolgt wird

CSOM: FollowedDocumentsUri

JSOM: followedDocumentsUri

REST: GET <siteUri>/_api/social.following/my/FollowedDocumentsUri

SSOM: FollowedDocumentsUri

Abrufen des URI der Website, die die Websites des aktuellen Benutzers auflistet, denen gefolgt wird

CSOM: FollowedSitesUri

JSOM: followedSitesUri

REST: GET <siteUri>/_api/social.following/my/FollowedSitesUri

SSOM: FollowedSitesUri

Hinweis Hinweis

Beispiele für die Verwendung des REST-Diensts zum Folgen von Inhalten finden Sie unter Vorgehensweise: führen Sie Dokumente, Websites und Tags mithilfe des REST-Diensts in SharePoint 2013.

Um das Folgen eines Tags zu starten und zu beenden oder herauszufinden, ob der aktuelle Benutzer ihm folgt, benötigen Sie die GUID des Tags. Der folgende Code zeigt, wie Sie die GUID basierend auf dem Namen des Tags abrufen.

Bevor Sie den Code ausführen, müssen Sie einen Verweis zu sp.taxonomy.js hinzufügen und den Namen des Platzhaltertags in den Namen eines vorhandenen Tags ändern.

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());
        }
    );
}

Anzeigen: