Vue d'ensemble du modèle objet Audience

Article
02/01/2010

Microsoft Office SharePoint Portal Server 2003 prenait en charge le ciblage reposant sur les audiences basées sur des règles. Outre les audiences basées sur des règles, Microsoft Office SharePoint Server 2007 prend en charge le ciblage reposant sur les appartenances aux groupes SharePoint et aux listes de distribution. Office SharePoint Server 2007 offre également la possibilité de cibler le contenu au niveau des éléments de liste et non seulement au niveau des listes.

Notes

Office SharePoint Server 2007 propose également un service Web qui permet de rechercher tous les sites SharePoint ciblés à l'intention d'un utilisateur spécifique. Pour plus d'informations, voir Procédure : utiliser le service Web Liens publiés.

Utilisation du nouvel espace de noms pour le modèle objet Audience

Dans SharePoint Portal Server 2003, l'espace de noms Microsoft.SharePoint.Portal.Audience est utilisé pour les audiences. Dans Office SharePoint Server 2007, le modèle objet Audience est implémenté dans l'espace de noms Microsoft.Office.Server.Audience contenu dans le fichier Microsoft.Office.Server.dll. Ce nouvel espace de noms permet au modèle objet de prendre en charge les nouvelles fonctionnalités d'Office SharePoint Server 2007.

L'espace de noms Microsoft.SharePoint.Portal.Audience existe toujours pour des raisons de compatibilité descendante. Les applications et outils que vous avez développés dans SharePoint Portal Server 2003 à l'aide de cet espace de noms fonctionnent toujours dans Office SharePoint Server 2007. Ils risquent toutefois de ne pas donner les résultats escomptés, en particulier avec les nouvelles fonctionnalités. Par exemple, si vous avez utilisé les API de Microsoft.SharePoint.Portal.Audience, seules les audiences basées sur des règles peuvent être utilisées. Pour cette raison, il est conseillé vivement d'utiliser le nouvel espace de noms Microsoft.Office.Server.Audience de Microsoft.Office.Server.dll lors de l'écriture de nouvelles applications ou de la mise à niveau d'applications anciennes. Toutes les classes de l'espace de noms Microsoft.SharePoint.Portal.Audience sont aujourd'hui obsolètes. Un avertissement s'affichera dès que vous utiliserez une classe ou une méthode de l'espace de noms Microsoft.SharePoint.Portal.Audience.

Obtention d'un objet AudienceManager dans Office SharePoint Server 2007

Dans le modèle objet Audience, l'objet AudienceMananger est l'objet de niveau supérieur. Vous pouvez obtenir un objet AudienceManager dans Office SharePoint Server 2007 à l'aide de la syntaxe illustrée dans l'exemple de code ci-après. Remplacez nom_serveur par une valeur réelle et ajoutez le code nécessaire avant toute utilisation de cet exemple.

using (SPSite site = new SPSite("https://servername"))
 {
   ServerContext context = ServerContext.GetContext(site);
   AudienceManager audManager = new AudienceManager(context);
   //your code here
 }

Portails personnalisés

Le code ci-après illustre le ciblage d'éléments de liste à l'intention d'une audience spécifique.

    AudienceLoader audienceLoader = AudienceLoader.GetAudienceLoader();
   foreach (SPListItem listItem in list.Items)
   {
    // get roles the list item is targeted to
     string audienceFieldValue = (string)listItem[k_AudienceColumn];

    // quickly check if the user belongs to any of those roles
     if (AudienceManager.IsCurrentUserInAudienceOf(audienceLoader,                           audienceFieldValue,
                          false))
                {
                    // is a member
                }
                else
                {
                    // not a member
                }
            }

Voir aussi

Autres ressources

Vue d'ensemble des audiences
Ciblage du contenu au moyen des audiences

Partager via