Suivre du contenu dans SharePoint

Découvrez les tâches de programmation courantes pour le contenu suivant (documents, sites et balises) dans SharePoint.

API pour le suivi du contenu dans SharePoint

Lorsque les utilisateurs suivent des documents, des sites ou des balises, mises à jour d'état à partir de documents conversations sur les sites et les notifications de balise utilisent show dans leur échange de News. Les fonctionnalités liées au contenu suivant peuvent être affichées dans l' échange de News et les pages de contenu suivant.

SharePoint fournit les API suivantes que vous pouvez utiliser pour suivre le contenu par programmation :

  • Modèles objet client pour le code managé

    • Modèle objet client .NET

    • Modèle objet client Silverlight

    • Modèle objet client mobile

  • Modèle objet JavaScript

  • Service REST (Representational State Transfer)

  • Modèle objet serveur

Il est vivement recommandé d'utiliser des API client quand vous le pouvez pour le développement SharePoint. API clientes incluent les modèles objet client, un modèle d'objet JavaScript et un service REST. Pour plus d’informations sur les API dans SharePoint et quand les utiliser, voir Choisir l’ensemble d’API approprié dans SharePoint.

Chaque API comprend un objet gestionnaire que vous utilisez pour effectuer des tâches principales pour le contenu suivant.

Remarque

[!REMARQUE] The same APIs are used to follow people. Voir Suivre des personnes dans SharePoint pour obtenir une vue d’ensemble du suivi des tâches Personnes.

Le tableau 1 répertorie les objets gestionnaire et autres objets clés (ou ressources REST) inclus dans les API, ainsi que la bibliothèque de classes (ou point d'accès) où vous pouvez les trouver.

Remarque

Les modèles objet client Silverlight et mobile ne sont pas inclus dans les tableaux 1 et 2, car ils fournissent les mêmes fonctionnalités de base que le modèle objet client .NET et utilisent les mêmes signatures. Le modèle objet client Silverlight est défini dans Microsoft.SharePoint.Client.UserProfiles.Silverlight.dll et le modèle objet client mobile est défini dans Microsoft.SharePoint.Client.UserProfiles.Phone.dll.

Tableau 1. API SharePoint utilisées pour suivre le contenu par programmation

API Objets clés
Modèle objet client .NET
Voir : Guide pratique pour suivre des documents et des sites à l’aide du modèle objet client .NET dans SharePoint
Objet Manager : SocialFollowingManager
Espace de noms principal : Microsoft.SharePoint.Client.Social
Autres objets clés : SocialActor , SocialActorInfo , SocialActorType , SocialActorTypes
Bibliothèque de classes : Microsoft.SharePoint.Client.UserProfiles.dll
Modèle objet JavaScript Objet Manager : SocialFollowingManager
Espace de noms principal : SP. Sociale
Autres objets clés : SocialActor, SocialActorInfo, SocialActorType, SocialActorTypes
Bibliothèque de classes : SP.UserProfiles.js
Service REST
Voir Guide pratique pour suivre des documents, des sites et des balises à l’aide du service REST dans SharePoint
Ressource du responsable : social.following
Espace de noms principal (OData) : sp.social.SocialRestFollowingManager
Autres ressources clés : SocialActor, SocialActorInfo, SocialActorType, SocialActorTypes
Point d’accès : <siteUri>/_api/social.following
Modèle objet serveur Objet Manager : SPSocialFollowingManager
Espace de noms principal : Microsoft.Office.Server.Social
Autres objets clés : SPSocialActor , SPSocialActorInfo , SPSocialActorType , SPSocialActorTypes
Bibliothèque de classes : Microsoft.Office.Server.UserProfiles.dll

Tâches de programmation courantes pour le suivi du contenu dans SharePoint

Le tableau 2 montre les tâches de programmation courantes pour le contenu suivant ainsi que les membres que vous utilisez pour les exécuter. Les membres sont à partir du modèle d'objet client .NET (CSOM), le modèle d'objet JavaScript (JSOM), service REST et le modèle d'objet serveur (SSOM).

Remarque

[!REMARQUE] The same APIs are used to follow people. Voir Suivre des personnes dans SharePoint pour obtenir une vue d’ensemble du suivi des tâches Personnes.

Tableau 2. API pour les tâches courantes pour le suivi de contenu dans SharePoint

Tâche Members
Créer une instance d’un objet gestionnaire dans le contexte de l’utilisateur actuel CSOM : SocialFollowingManager
JSOM : SocialFollowingManager
RESTE: <siteUri>/_api/social.following
SSOM : SPSocialFollowingManager
Créer une instance d'un objet gestionnaire dans le contexte d'un utilisateur spécifié CSOM : non implémenté
JSOM : non implémenté
REST : non implémenté
SSOM : SPSocialFollowingManager (surchargé)
Ont l'utilisateur actuel commencez à suivre (stop ci-dessous) un élément CSOM : Suivre ( StopFollowing )
JSOM : suivre ( stopFollowing)
REST : POST<siteUri>/_api/social.following/Follow ( <siteUri>/_api/social.following/StopFollowing) et passez le paramètre d’acteur dans le corps de la requête
SSOM : Suivre ( StopFollowing )
Savoir si l'utilisateur actuel est suite à un élément particulier CSOM : IsFollowed
JSOM : isFollowed
REST : POST<siteUri>/_api/social.following/IsFollowed et passez le paramètre d’acteur dans le corps de la demande
SSOM : IsFollowed
Obtenir les documents, les sites et/ou les balises que l'utilisateur actuel est suivi CSOM : GetFollowed
JSOM : getFollowed
REST : GET<siteUri>/_api/social.following/my/Followed(types=2) (documents = 2, sites = 4, balises = 8.md)
SSOM : GetFollowed
Obtenir le nombre de documents, sites et/ou des balises que l'utilisateur suit CSOM : GetFollowedCount
JSOM : getFollowedCount
REST : GET<siteUri>/_api/social.following/my/FollowedCount(types=2) (documents = 2, sites = 4, balises = 8.md)
SSOM : GetFollowedCount
Obtenir l'URI du site qui répertorie les documents suivis de l'utilisateur actuel CSOM : FollowedDocumentsUri
JSOM : followedDocumentsUri
REST : GET<siteUri>/_api/social.following/my/FollowedDocumentsUri
SSOM : FollowedDocumentsUri
Obtenir l'URI du site qui répertorie les sites suivis de l'utilisateur actuel CSOM : FollowedSitesUri
JSOM : followedSitesUri
REST : GET<siteUri>/_api/social.following/my/FollowedSitesUri
SSOM : FollowedSitesUri

Remarque

Pour obtenir des exemples qui montrent comment utiliser le service REST pour suivre du contenu, voir Guide pratique pour suivre des documents, des sites et des balises à l’aide du service REST dans SharePoint.

Comment obtenir le GUID d'une balise basée sur le nom de la balise à l'aide du modèle d'objet JavaScript

Pour démarrer et arrêter suivi d'une balise ou permettant de savoir si l'utilisateur actuel est la suite, vous devez utiliser les GUID de la balise. Le code suivant montre comment obtenir le GUID basé sur le nom de la balise.

Avant d'exécuter le code, vous devez ajouter une référence à sp.taxonomy.js et modifiez le nom de balise d'espace réservé avec le nom d'une balise existante.


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

Voir aussi