Création d’une extension de suggestion de requête à l’aide SharePoint Framework
À partir de la SharePoint Framework v1.10, vous pouvez également créer des extensions de suggestion de requête avec SharePoint Framework.
Assurez-vous d’avoir effectué les procédures des articles suivants avant de commencer à comprendre le processus global de l’extension SharePoint Framework, car l’extension de suggestion de requête fonctionne de la même manière que les personnaliseurs d’application :
- Créer votre première extension SharePoint Framework (Hello World 1re partie)
- Utilisation des espaces réservés de page du personnalisateur d’application (Hello World 2e partie)
- Déployer votre extension dans SharePoint (Hello World 3e partie)
Notes
Cette fonctionnalité a été introduite en tant que version préliminaire pour développeurs. Pour utiliser les fonctionnalités de la version préliminaire pour développeurs, assurez-vous d’utiliser la version --plusbeta de la bibliothèque (consultez cet article pour référence)
Important
Cet exercice pratique nécessite que vous utilisiez au moins la version 1,10 de SharePoint Framework, car ces fonctionnalités ne sont pas disponibles dans les versions antérieures.
Créer un projet de solution
Créez un nouveau répertoire de projet à l’emplacement de votre choix :
md query-extensionAccédez au répertoire du projet :
cd query-extensionCréer une solution de composant WebPart côté client en exécutant le générateur SharePoint Yeoman :
yo @microsoft/sharepoint --plusbetaLorsque vous y êtes invité :
- Acceptez la suggestion de requête par défaut comme nom de votre solution, puis sélectionnez Entrée.
- Sélectionnez SharePoint Online uniquement (dernière version), puis sélectionnez Entrée.
- Sélectionnez Utiliser le dossier actuel comme emplacement pour les fichiers.
- Sélectionnez N, car nous voulons que cette extension soit installée explicitement sur un site spécifique en fonction de la configuration automatisée qui sera appliquée.
- Sélectionnez N sur la question si la solution contient des autorisations uniques.
- Sélectionnez Extension comme type de composant côté client à créer.
- Sélectionnez Modificateur de requête de recherche comme extension côté client à créer.
Notes
Si l’extension Modificateur de requête de recherche n’est pas disponible, re-démarrez le processus et assurez-vous que vous avez utilisé le commutateur lors de l’exécution du générateur
--plusbetaYeoman comme suit :yo @microsoft/sharepoint --plusbetaLa prochaine série d’invites vous demande des informations spécifiques sur votre composant WebPart :
- Entrez MyQueryExtension comme nom d’extension, puis sélectionnez Entrée.
- Entrez Ma première extension de requête comme description de l’extension, puis sélectionnez Entrée.
- Acceptez l’option d’infrastructure No JavaScript par défaut pour l’infrastructure, puis sélectionnez Entrée pour continuer.

À ce stade, Yeoman installe les dépendances requises et crée la structure des fichiers de la solution. La création de la solution peut prendre quelques minutes. Yeoman échafaude le projet pour inclure votre extension MyQueryExtension, qui peut être utilisée pour modifier le runtime des requêtes de recherche fournies.
Ensuite, saisissez les informations suivantes pour ouvrir le projet de composant WebPart dans Visual Studio Code :
code .
Notez que la structure ressemble à celle des autres solutions SharePoint Framework solutions. Votre extension a été créée avec les valeurs par défaut sous le dossier extensions\myQueryExtension

Modification du code d’extension de requête
Ouvrir un fichier
Modifier
Enregistrer
Installation de la solution sur SharePoint
Créer
Package
Installer dans le catalogue d’applications
Installer sur le site
Installation d’une solution open source de recherche moderne
PowerShell exécute et teste des éléments
Activation de l’expérience de recherche personnalisée
PowerShell exécute et teste des éléments