La Content Query WebPart est une fabuleuse WebPart d’agrégation de contenu. A elle seule elle rend obsolètes de nombreux développements que j’avais pu faire sous SPS2003. Lorsque j’en fais la démonstration en formation, le résultat est systématique : les stagiaires font immédiatement le tour de toutes les problématiques auxquels cette WebPart apporte une réponse.  Son paramétrage n’est pas simple pour autant. Bien sûr, son EditorPart permet un paramétrage déjà poussé et ne représente pas de grande difficulté, mais  dans la plupart il faut procéder à un paramétrage avancé. Notamment, en modifiant le fichier .webpart  qui lui est associé, et surtout, en éditant les fichiers XSL sur lesquelles elle s’appui.
 
Plutôt que de détailler ici la façon de faire, voici quelques liens vers de très bons ‘How To’ : 

• Le blog de Phil.
• Heather Solomon. 
• Et bien sûr le site MSDN.
   
  Vous trouverez des informations complémentaires sur cette autre page du MSDN.
   
  Pour aller encore plus loin dans les capacités de cette WebPart, vous trouvez l’Enhanced Content Query WebPart sur codeplex.
  Les présentations étant faites, passons à un point précis de la WebPart. Cette WebPart est capable de gérer les audiences. Efficace pour filtrer les éléments non pertinents pour l’utilisateur connecté !
  Pour cela, il suffit de cocher la case « Appliquer le filtrage de l’audience » dans l’Editor Part. La seconde checkbox permet de déterminer le comportement de la WebPart pour les éléments n’ayant aucune audience associée.

Seulement voilà…ce filtrage est réalisé une fois les données récupérées par la WebPart. Qu’est ce que ça implique ? Et bien si vous limitez le nombre d’éléments retournés par la WebPart, il y aura ce nombre d’éléments affichés moins ceux filtrés par l’audience.
Dans mon cas, j’ai cherché à remonter les trois dernières pages modifiées en configurant la WebPart comme ceci :

Et malheureusement, seules deux de ces pages étaient remontées. Mon objectif était pourtant de remonter trois pages, et bien sûr remplacer les pages manquantes en cas de filtrage en prenant les suivantes selon mon critère de tri.
Au jour d’aujourd’hui je n’ai pas trouvé de solution de contournement idéale. Mais… il y en a une quand même, même si elle n’est pas du tout générique. Pour le principe néanmoins, je vais vous l’exposer ici.
Dans mon cas, les règles fonctionnelles prévues pour la gestion des pages me permettent de savoir que j’aurais au moins trois pages après filtrage si je remonte 10 d’entre elles.

Seulement voilà, cette manipulation assure aussi qu’il y aura quasi systématiquement plus de trois pages remontées. Solution de contournement : compter et limiter le nombre d’éléments affichés depuis le XSL. La difficulté ici, c’est que le seul fichier XSL permettant d’avoir la main sur l’ensemble du rendu de la WebPart est le fichier ContentQueryMain.xsl… et par défaut l’édition de ce fichier modifie le rendu de toutes les ContentQueryWebPart de la collection de sites.  Pour lui ajouter un branchement conditionnel et ne déclencher le comptage que lorsque c’est nécessaire, il faut alors se baser sur une des données du XML source… au hasard, l’attribut Style J.

Voici comment procéder :

1. Il faut commencer par éditer le fichier ItemStyle.xsl pour lui ajouter un nouveau style :

<xsl:template name="Max3Items" match="Row[@Style='Max3Items']" mode="itemstyle">
   <xsl:variable name="SafeLinkUrl">
      <xsl:call-template name="OuterTemplate.GetSafeLink">
         <xsl:with-param name="UrlColumnName" select="'LinkUrl'"/>
      </xsl:call-template>
   </xsl:variable>
   <xsl:variable name="SafeImageUrl">
      <xsl:call-template name="OuterTemplate.GetSafeStaticUrl">
         <xsl:with-param name="UrlColumnName" select="'ImageUrl'"/>
      </xsl:call-template>
   </xsl:variable>
   <xsl:variable name="DisplayTitle">
      <xsl:call-template name="OuterTemplate.GetTitle">
         <xsl:with-param name="Title" select="@Title"/>
         <xsl:with-param name="UrlColumnName" select="'LinkUrl'"/>
      </xsl:call-template>
   </xsl:variable>
   <xsl:variable name="LinkTarget">
      <xsl:if test="@OpenInNewWindow = 'True'" >_blank</xsl:if>
   </xsl:variable>
   <div id="linkitem" class="item">
      <xsl:if test="string-length($SafeImageUrl) != 0">
         <div class="image-area-left">
            <a href="{$SafeLinkUrl}" target="{$LinkTarget}">
               <img class="image" src="{$SafeImageUrl}" alt="{@ImageUrlAltText}" />
            </a>
         </div>
      </xsl:if>
      <div class="link-item">
         <xsl:call-template name="OuterTemplate.CallPresenceStatusIconTemplate"/> 
         <a href="{$SafeLinkUrl}" target="{$LinkTarget}" title="{@LinkToolTip}">
            <xsl:value-of select="$DisplayTitle"/>
         </a>
         <div class="description">
            <xsl:value-of select="@Description" />
         </div>
      </div>
   </div>
</xsl:template>

2. Il faut ensuite éditer le fichier ContenQueryMain.xsl. Repérez le template OuterTemplate.Body :

<xsl:template name="OuterTemplate.Body">

     C’est ce Template qui se charge du rendu du corps de la ContentQueryWebPart. Ne modifiez surtout pas ce Template. Créez en un autre sur le modèle suivant :

<xsl:template name="OuterTemplate.Max3Pages">
   <xsl:param name="Rows" />
   <xsl:param name="FirstRow" />
   <xsl:param name="LastRow" />
   <xsl:variable name="BeginColumn1" select="string('&lt;td id=&quot;column&quot; width=&quot;')" />
   <xsl:variable name="BeginColumn2" select="string('%&quot; valign=&quot;top&quot;&gt;')" />
   <xsl:variable name="BeginColumn" select="concat($BeginColumn1, $cbq_columnwidth, $BeginColumn2)" />
   <xsl:variable name="EndColumn" select="string('&lt;/td &gt;')" />
   <xsl:value-of disable-output-escaping="yes" select="$BeginColumn" />
   <xsl:for-each select="$Rows">
      <xsl:variable name="CurPosition" select="position()" />
      <xsl:if test="($CurPosition &lt;= 3)">
         <xsl:call-template name="OuterTemplate.CallItemTemplate">
            <xsl:with-param name="CurPosition" select="$CurPosition" />
         </xsl:call-template>
      </xsl:if>
   </xsl:for-each>
   <xsl:value-of disable-output-escaping="yes" select="$EndColumn" />
</xsl:template>