Freigeben über

Folgen von Inhalten in SharePoint

  • Artikel

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

APIs für das Folgen von Inhalten in SharePoint

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 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 (Representational State Transfer)-Dienst

  • Serverobjektmodell

In der SharePoint-Entwicklung wird empfohlen, so oft wie möglich Client-APIs zu verwenden. Client-APIs gehören die Clientobjektmodelle, ein JavaScript-Objektmodell und REST-Dienst. Weitere Informationen zu den APIs in SharePoint und zu deren Verwendung finden Sie unter Auswählen des richtigen API-Satzes in SharePoint.

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

Hinweis

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

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

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. SharePoint-APIs, die zum programmgesteuerten Folgen von Inhalten verwendet werden

API Schlüsselobjekte
.NET-Clientobjektmodell
Siehe: Vorgehensweise: Folgen von Dokumenten und Websites mithilfe des .NET-Clientobjektmodells in SharePoint		 Manager-Objekt: SocialFollowingManager
Primärer Namespace: Microsoft.SharePoint.Client.Social
Andere Schlüsselobjekte: SocialActor , SocialActorInfo , SocialActorType , SocialActorTypes
Klassenbibliothek: Microsoft.SharePoint.Client.UserProfiles.dll
JavaScript-Objektmodell Manager-Objekt: SocialFollowingManager
Primärer Namespace: SP.Social
Andere Schlüsselobjekte: SocialActor, SocialActorInfo, SocialActorType, SocialActorTypes
Klassenbibliothek: SP.UserProfiles.js
REST-Dienst
Weitere Informationen finden Sie unter Vorgehensweise: Folgen von Dokumenten, Websites und Tags mithilfe des REST-Diensts in SharePoint.		 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 Schlüsselobjekte: SPSocialActor , SPSocialActorInfo , SPSocialActorType , SPSocialActorTypes
Klassenbibliothek: Microsoft.Office.Server.UserProfiles.dll

Allgemeine Programmierungsaufgaben für das Folgen von Inhalten in SharePoint

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

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

Tabelle 2. API für allgemeine Aufgaben zum Folgen von Inhalten in SharePoint

Aufgabe Members
Erstellen einer Instanz eines Manager-Objekts im Kontext des aktuellen Benutzers CSOM: SocialFollowingManager
JSOM: SocialFollowingManager
RUHEPAUSE: <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: Folgen ( StopFollowing )
JSOM: folgen ( stopFollowing)
REST: POST<siteUri>/_api/social.following/Follow ( <siteUri>/_api/social.following/StopFollowing) und übergeben den Actor-Parameter im Anforderungstext
SSOM: Folgen ( 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 Text der Anforderung
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.md)
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.md)
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

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

Abrufen der GUID eines Tags basierend auf dem Namen des Tags mithilfe des JavaScript-Objektmodells

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

Siehe auch