Comment faire pour ajouter une action personnalisée au panneau sensitif dans SharePoint Server

 

**Sapplique à :**SharePoint Server 2013, SharePoint Server 2016

**Dernière rubrique modifiée :**2017-07-24

Résumé : Apprenez à ajouter une action personnalisée au panneau sensitif dans SharePoint Server.

Dans Comment faire pour afficher les valeurs des propriétés managées personnalisées dans le panneau sensitif dans SharePoint Server, nous vous avons montré comment afficher les valeurs de propriétés gérées personnalisées dans le panneau de pointage. Dans cet article, nous répondrons aux questions suivantes :

• Qu'est-ce qu'une action du panneau de pointage ?

• Comment ajouter une action dans le panneau de pointage ?

Qu’est-ce qu’une action du panneau de pointage ?

Avant de nous pencher sur la façon d’ajouter une action personnalisée à un panneau de pointage, mettons-nous d’accord sur les réalités que désigne une action.

Certains liens appelés actions se trouvent au bas du panneau de pointage. Lorsque vous en choisissez une, un événement se produit. Par exemple, c’est le cas dans notre scénario de Centre de recherche, lorsque nous sélectionnons « ENVOYER »...

...un message électronique avec un lien vers l’élément de liste s’ouvre.

Pour permettre à nos visiteurs d’utiliser les résultats de la recherche sans avoir à quitter la page des résultats de la recherche, nous pouvons ajouter une action personnalisée.

Dans notre scénario de centre de recherche, nous voulions ajouter une action personnalisée qui ouvre l’article publié. Par exemple, le résultat de la recherche « Types de résultat personnaliser recherche dans SharePoint Server », nous voulions ajouter une action qui ouvre ce lien : < besoin fwlink ? https://technet.Microsoft.com/en-us/library/dn135239.aspx\>

Comment ajouter une action au panneau de pointage ?

Dans nos listes, lorsqu’un article est publié, l’URL de l’article publié est ajouté à l’élément de liste. La capture d’écran ci-dessous montre comment l’URL de l’article « Types de résultat personnaliser recherche dans SharePoint Server » est mis à jour dans la colonne de site « Contenu version URL ».

Étant donné que cette URL figure dans la liste, nous pouvons ajouter une action personnalisée au panneau de pointage qui ouvre le lien.

L’article Comment faire pour afficher les valeurs des propriétés managées personnalisées dans le panneau sensitif dans SharePoint Server a expliqué la façon dont les actions du panneau de pointage sont restituées par le modèle d’affichage Item_Common_HoverPanel_Actions. Aussi, pour ajouter une action personnalisée, vous devez modifier ce fichier.

Toutefois, comme nous l’avons fait lorsque nous avons ajouté une propriété personnalisée au panneau de pointage, vous devez ajouter la propriété gérée que vous souhaitez utiliser dans votre action personnalisée au modèle d’affichage d’élément.

Vous êtes perdu ? C’est normal, ce n’est pas une mince affaire. Il faut du temps pour comprendre les associations. Procédons étape par étape.

Voici la procédure à suivre pour ajouter une action personnalisée au panneau de pointage :

1. Recherchez le nom de la propriété gérée de la colonne de site que vous souhaitez utiliser. La section Comment faire pour afficher les valeurs des propriétés managées personnalisées dans les résultats de la recherche - option 1 de SharePoint Server expliquait comment faire.

2. Dans votre lecteur réseau mappé, ouvrez le modèle d’affichage d’un élément. Dans le modèle d’affichage de l’élément, dans la balise ManagedPropertyMapping, utilisez la syntaxe suivante pour ajouter la propriété gérée personnalisée :

   '<Current item property name>':<Managed property name>'
   

   Dans notre scénario de Centre de recherche, nous avions ajouté la propriété personnalisée que nous voulions utiliser pour le modèle d’affichage Contenu TechNet.

   

3. Notes

   Vous n’avez pas à effectuer cette étape si vous utilisez SharePoint Online.

   Accédez à Paramètres du site --> Types de résultats de recherche. Remarquez que l’alerte Synchronisation des propriétés s’affiche.

   

   Cette alerte s’affiche, car nous avons ajouté une nouvelle propriété gérée à un modèle d’affichage d’élément (ce que nous avons fait à l’étape 2). Pour mettre à jour les types de résultats avec les propriétés gérées récemment ajoutées, choisissez Mettre à jour.

   

   Important

   Si vous n’effectuez pas la mise à jour, les propriétés gérées récemment ajoutées ne s’afficheront pas dans votre panneau de pointage.

4. Ouvrez le modèle d’affichage Item_Common_HoverPanel_Actions. Observez comment les actions par défaut sont créées, et utilisez du code JavaScript et HTML pour ajouter votre action personnalisée.

   Dans notre scénario de Centre de recherche, nous avons étudié comment l’action OUVRIR ( _#= editHmtl =#_ ) était créée. Sur cette base, nous avons créé une action : _#= viewHtml =#_. La capture d’écran suivante montre ce que nous avons fait.

   

   En effectuant une nouvelle recherche et en pointant sur un résultat de la recherche, nous avons vu que notre nouvelle action personnalisée s’était affichée. Parfait !

   

Maintenant que vous savez comment modifier l’affichage de vos résultats de la recherche, il reste encore une dernière chose à examiner : la modification du texte qui s’affiche dans le composant WebPart Zone de recherche.

Article suivant de cette série

Comment faire pour modifier le texte qui est affiché dans le composant WebPart zone de recherche dans SharePoint Server