Procédure : créer et récupérer une évaluation sociale
Dernière modification : mardi 9 mars 2010
S’applique à : SharePoint Server 2010
Dans cet article
Création d’évaluations sociales
Récupération d’évaluations sociales
Activation des évaluations sociales sur une liste
L’objet SocialRatingManager vous permet de créer une évaluation sociale pour n’importe quelle URL spécifiée. Dans la mesure où les entrées dans les listes et les bibliothèques de documents Microsoft SharePoint Server peuvent être représentées par des URL, vous pouvez créer et récupérer des évaluations sociales pour ces éléments et pour n’importe quelle autre page SharePoint Server. Cette rubrique montre comment utiliser SocialRatingManager pour créer et récupérer des évaluations sociales, et comment activer les évaluations sociales sur SharePoint Server dans une application personnalisée. Les exemples de cette rubrique supposent que vous avez ajouté les références suivantes à votre projet Microsoft Visual Studio 2010 :
Microsoft.SharePoint
Microsoft.Office.Server
Microsoft.Office.Server.UserProfiles
System.Web
Création d’évaluations sociales
La méthode SetRating surchargée crée un seul objet SocialRating pour l’utilisateur actuel sur une seule URL spécifiée. Une évaluation sociale se compose d’une URL et d’un nombre entier compris entre 0 et 5. Elle peut aussi être éventuellement constituée d’un titre de type chaîne pour l’évaluation et d’un objet FeedbackData constitué de paires nom/valeur qui seront enregistrées en tant que données d’analyse. L’exemple ci-dessous montre comment utiliser SocialRatingManager pour créer une évaluation sociale sur une URL spécifiée.
Uri myUri = new Uri("URL");
FeedbackData myFeedbackData = new FeedbackData();
myFeedbackData.UserTitle = "employee";
using (SPSite site = new SPSite("SharePoint site URL"))
{
SPServiceContext context = SPServiceContext.GetContext(site);
SocialRatingManager mySocialRatingManager = new SocialRatingManager(context);
mySocialRatingManager.SetRating(myUri, 5, myFeedbackData);
}
Récupération d’évaluations sociales
La méthode GetRating surchargée récupère un objet SocialRating unique pour une URL spécifiée. Si vous ne spécifiez pas un profil UserProfile, la méthode retourne l’évaluation sociale (s’il en existe une) ajoutée à l’URL spécifiée par l’utilisateur actuel. L’exemple ci-dessous montre comment utiliser SocialRatingManager pour récupérer une évaluation sociale pour un utilisateur spécifié.
using (SPSite site = new SPSite("SharePoint site URL"))
{
SPServiceContext context = SPServiceContext.GetContext(site);
SocialRatingManager mySocialRatingManager = new SocialRatingManager(context);
SocialRating aRating = mySocialRatingManager.GetRating(myUri);
Console.WriteLine(aRating.Url + ": " + aRating.Rating);
}
La méthode GetRatings surchargée récupère tous les objets SocialRating pour une URL ou un utilisateur spécifié. Si vous spécifiez une URL, la méthode retourne toutes les évaluations sociales ajoutées à cette URL dans le contexte SPServerContext actuel. Si vous spécifiez un utilisateur, la méthode retourne toutes les évaluations sociales ajoutées par l’utilisateur spécifié.
using (SPSite site = new SPSite("SharePoint site URL"))
{
SPServiceContext context = SPServiceContext.GetContext(site);
UserProfileManager myUserProfileManager = new UserProfileManager(context);
UserProfile myUserProfile = myUserProfileManager.GetUserProfile(false);
SocialRatingManager mySocialRatingManager = new SocialRatingManager(context);
SocialRating[] ratings = mySocialRatingManager.GetRatings(myUserProfile);
Console.WriteLine("Ratings for user:");
foreach (SocialRating rating in ratings)
{
Console.WriteLine(rating.Url + ": " + rating.Rating);
}
}
Activation des évaluations sociales sur une liste
Vous pouvez activer le champ d’évaluation moyenne et le champ rating count sur les listes et les bibliothèques de documents à l’aide de l’interface utilisateur pour les paramètres des listes ou des bibliothèques de documents. Les deux champs sont disponibles en tant que colonnes de site que vous pouvez ajouter à une liste ou à une bibliothèque de documents en activant item rating dans les paramètres de la liste ou de la bibliothèque. L’exemple ci-dessous montre comment activer ces champs sur une liste à l’aide de code dans une application personnalisée.
public void AddRatingsFields(SPList list)
{
//Add the average rating field.
SPField averageRatingField = list.ParentWeb.AvailableFields[new Guid("5a14d1ab-1513-48c7-97b3-657a5ba6c742")];
list.Fields.AddFieldAsXml(averageRatingField.SchemaXml, true, SPAddFieldOptions.AddToAllContentTypes | SPAddFieldOptions.AddFieldToDefaultView);
//Add the rating count field.
SPField ratingCountField = list.ParentWeb.AvailableFields[new Guid("b1996002-9167-45e5-a4df-b2c41c6723c7")];
list.Fields.AddFieldAsXml(ratingCountField.SchemaXml, true, SPAddFieldOptions.AddToAllContentTypes | SPAddFieldOptions.AddFieldToDefaultView);
}
Voir aussi
Référence
Microsoft.Office.Server.SocialData
Concepts
Procédure : créer et récupérer une liaison de mise en réseau