Procédure : créer et récupérer une liaison de mise en réseau
Dernière modification : mardi 30 mars 2010
S’applique à : SharePoint Server 2010
L’objet SocialTagManager vous permet de créer un lien de mise en réseau pour n’importe quelle URL spécifiée avec un Term valide de la taxonomie que vous utilisez. Cette rubrique montre comment utiliser SocialTagManager pour créer et récupérer des liens de mise en réseau dans une application personnalisée. Pour obtenir des exemples de code qui montrent comment effectuer des tâches qui sont incluses dans cette rubrique, voir Exemple de code : Composant WebPart Statistiques de données sociales et Exemple de code : page d’application de liaison de mise en réseau pour l’approbation des collègues. 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
La méthode AddTag surchargée crée un objet SocialTag pour l’utilisateur actuel sur une URL spécifiée. Un lien de mise en réseau se compose d’une URL et d’un Term valide de la taxonomie que vous utilisez. Si le Term de la taxonomie n’existe pas, vous devez l’ajouter à la banque de termes. Un SocialTag peut aussi être éventuellement constitué d’un titre de type chaîne pour l’objet représenté par l’URL qui est marquée et d’une valeur booléenne qui détermine si le lien de mise en réseau est privé et visible seulement par l’utilisateur actuel. La valeur par défaut pour la propriété booléenne IsPrivate est false : les liens de mise en réseau sont donc publics par défaut. L’exemple ci-dessous montre comment ajouter un terme à la banque de termes de mots clés par défaut, puis comment utiliser SocialTagManager pour ajouter ce terme en tant que lien unique à une URL spécifiée.
Uri myUri = new Uri("URL");
using (SPSite site = new SPSite("SharePoint site URL"))
{
SPServiceContext context = SPServiceContext.GetContext(site);
SocialTagManager mySocialTagManager = new SocialTagManager(context);
//Retrieve the taxonomy session from the SocialTagManager.
TaxonomySession taxSession = mySocialTagManager.TaxonomySession;
TermStore termStore = taxSession.DefaultKeywordsTermStore;
myTerm = termStore.KeywordsTermSet.CreateTerm("term", termStore.DefaultLanguage);
termStore.CommitAll();
mySocialTagManager.AddTag(myUri, myTerm);
}
La méthode GetTags surchargée récupère tous les objets SocialTag pour une URL ou un utilisateur spécifié. Si vous spécifiez une URL, la méthode retourne tous les liens de mise en réseau ajoutés à cette URL par l’utilisateur actuel dans le contexte SPServerContext actuel. Si vous spécifiez un utilisateur, la méthode retourne tous les liens de mise en réseau ajoutés 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);
SocialTagManager mySocialTagManager = new SocialTagManager(context);
SocialTag[] tags = mySocialTagManager.GetTags(myUserProfile);
Console.WriteLine("Tags for user:");
foreach (SocialTag tag in tags)
{
Console.WriteLine(tag.Term.Name + ": " + tag.Uri.AbsoluteUri);
}
}
Microsoft.Office.Server.SocialData