SharePoint 2007 : PowerShell et la gestion des Event Receivers dans les listes

 Suite au dernier article publié concernant les liens personalisés :

• SharePoint Personalization Site Links

J’avais fourni les scripts PowerShell de listing et de création de ces liens :

• Création d'un lien personnalisé avec PowerShell

Le fait est que la première version du script fourni créait bien un item dans la liste, mais celui-ci n’apparaissait jamais dans les MySite.

La raison de ce non fonctionnement vient de la particularité de cette liste. En effet, cette liste possède une configuration spécifique pour la synchronisation avec les MySites. Cela se fait par un Event Receiver associé aux évènements :

• Ajout
• Modification
• Suppression

On peut d’ailleurs voir cette configuration en utilisant le composant CodePlex :

• Event Receivers Manager v1.1

L’évènement déclenché “RefreshSyncList” est donc interne et inaccessible, dont la classe de base est :

• PersonalizationListEventReceiver Class (Microsoft.Office.Server.UserProfiles)

Il n’est donc pas possible d’exécuter cette fonction en fin de script pour lancer cette synchronisation. L’event Receiver est de plus bien exécuté, mais provoque une erreur, car elle attend en entrée les paramètres de la liste de type “SPItemEventProperties”.

Ces paramètres transmis comprennent toutes les données de l’item courant (référence à la liste, valeurs de chaque colonne, …).

En regardant dans les logs URL, on trouve les lignes suivantes :

01/18/2010 13:33:09.28     w3wp.exe (0x167C)                           0x17F8    SharePoint Portal Server          User Profiles                     62mp    Exception    IsCurrentUserInAudienceOf throws exception. Return false. System.FormatException: Guid should contain 32 digits with 4 dashes (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).     at System.Guid..ctor(String g)     at Microsoft.Office.Server.Audience.AudienceManager.IsCurrentUserInAudienceOf(AudienceLoader audienceLoader, String audienceTextRepresentation, Boolean showUntargetedAudience)    
01/18/2010 13:33:09.28     w3wp.exe (0x167C)                           0x17F8    SharePoint Portal Server          User Profiles                     62mq    Assert      IsCurrentUserInAudienceOf throws exception. Return false. StackTrace:   at Microsoft.Office.Server.Audience.AudienceManager.IsCurrentUserInAudienceOf(AudienceLoader audienceLoader, String audienceTextRepresentation, Boolean showUntargetedAudience)     at Microsoft.Office.Server.Audience.AudienceManager.IsCurrentUserInAudienceOf(String audienceTextRepresentation, Boolean showUntargetedAudience)     at Microsoft.Office.Server.UserProfiles.SyncedListLoader.GetTargetedItems()     at Microsoft.SharePoint.Portal.MySiteMapProvider.GetRootNodeCore()     at System.Web.SiteMapProvider.get_RootNode()     at System.Web.UI.WebControls.SiteMapDataSource.GetNodes()     at System.Web.UI.WebControls.SiteMapDataSource.GetTreeView(String viewPath)     at System.Web.UI.WebControls.HierarchicalDataBoundControl...    
01/18/2010 13:33:09.28*    w3wp.exe (0x167C)                           0x17F8    SharePoint Portal Server          User Profiles                     62mq    Assert      ....GetData(String viewPath)     at System.Web.UI.WebControls.Menu.DataBindItem(MenuItem item)     at System.Web.UI.WebControls.Menu.PerformDataBinding()     at System.Web.UI.WebControls.HierarchicalDataBoundControl.PerformSel

La partie intéressante de ces messages se trouve dans le corps :

Exception    IsCurrentUserInAudienceOf throws exception. Return false. System.FormatException: Guid should contain 32 digits with 4 dashes (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).

Ainsi, la valeur de l’audience doit être fournie en GUID et non en texte, car l’Event Viewer utilise directement la valeur transmise et ne sait pas le trancoder.

Il faut donc ajouter une étape qui va faire un cast de cette audience via son nom pour obtenir son GUID :

$site = new-object Microsoft.SharePoint.SPSite($SiteURL)
$web = $site.openweb()
$srvContext = [Microsoft.Office.Server.ServerContext]::GetContext($site)

[Microsoft.Office.Server.Audience.AudienceManager]$audManager = new-object Microsoft.Office.Server.Audience.AudienceManager($srvContext)
[Microsoft.Office.Server.Audience.Audience]$myAudience = $audManager.GetAudience(“Audience_Name”)

…..

$MyItem["Target Audiences"] = $myAudience.AudienceID.ToString()

Une fois cette modification effectuée, la création fonctionne parfaitement et les liens personnalisés sont alors créés comme souhaité.

Pour information, mon script adapté vient de créer environ 160 liens associés avec les 160 audiences Pays.

Il est donc important de contrôler les tâches post-création pour les items, car les Events ne sont pas forcément visibles.

Si vous souhaitez ce script, il est disponible sur le site CodePlex avec beaucoup d’autres :

• SharePoint Management PowerShell scripts

Fabrice Romelard [MVP]