Exporter et importer des paramètres de configuration de recherche personnalisés
En tant qu’administrateur SharePoint dans Microsoft 365, vous pouvez exporter et importer des paramètres de configuration de recherche personnalisés entre les locataires, les collections de sites et les sites. Les paramètres que vous exportez et importez incluent toutes les règles de requête personnalisées, les origines des résultats, les types de résultats, les modèles de classement et les paramètres de recherche de site. Il est également possible d’exporter des paramètres de configuration de recherche personnalisés à partir d’une application de service de recherche et d’importer les paramètres vers des clients, des collections de sites ou des sites. Vous ne pouvez pas exporter les paramètres de configuration par défaut.
Vue d’ensemble
Lorsque vous exportez des paramètres de configuration de recherche personnalisés, SharePoint crée un fichier de configuration de recherche au format XML. Ce fichier de configuration de recherche inclut tous les paramètres de configuration de recherche personnalisés exportables au niveau du client, de la collection de sites ou du site à partir de laquelle vous commencez l’exportation. Un fichier de configuration de recherche pour une collection de sites ne contient pas les paramètres de configuration de recherche des différents sites de la collection de sites.
Lorsque vous importez un fichier de configuration de recherche, SharePoint crée et active chaque paramètre de configuration de recherche personnalisé dans le client, la collection de sites ou le site à partir de laquelle vous démarrez l’importation.
Ce tableau indique les paramètres que vous pouvez exporter ou importer. Pour chaque paramètre, vous trouverez des dépendances sur d’autres paramètres de configuration de recherche personnalisés. Si les paramètres de configuration de recherche personnalisés dépendent d'un paramètre de configuration de recherche personnalisé à un niveau différent, par exemple si une règle de requête de site dépend de l'origine des résultats au niveau de la collection de sites, vous devez exporter et importer les paramètres pour chacun des niveaux concernés.
| Paramètre de configuration de recherche personnalisé | Dépendance à d'autres paramètres de configuration de recherche personnalisés |
|---|---|
| Règles de requête. Comprend les blocs de résultats, les résultats promus et les segments d’utilisateur |
Origines des résultats, types de résultats, schéma de recherche, modèle de classement. |
| Origines des résultats |
Schéma de recherche |
| Types de résultats |
Schéma de recherche, origines des résultats, modèles d’affichage |
| Schéma de recherche |
Aucune |
| Modèle de classement |
Schéma de recherche |
Conditions qui peuvent provoquer l’échec de l’importation
L'importation du fichier de configuration de recherche échoue si le fichier de configuration de recherche et la cible de l'importation possèdent des paramètres portant le même nom. Il existe toutefois des exceptions :
Si vous réimportez un fichier de configuration de recherche, les paramètres qui possèdent le même nom dans le fichier de configuration de recherche et sur la cible ne provoquent pas l’échec de l’importation.
Les propriétés gérées portant le même nom ne provoquent pas l’échec de l’importation si les paramètres de propriété gérée individuels sont les mêmes sur la propriété dans le fichier de configuration de recherche et sur la propriété cible.
Les propriétés gérées portant le même nom ne provoquent pas l’échec de l’importation si les alias et les mappages des propriétés analysées sont différents sur la propriété gérée dans le fichier de configuration de recherche et sur la propriété gérée cible. L’importation ajoute les alias et les mappages sur la propriété gérée dans le fichier de configuration de recherche aux alias et mappages sur la propriété gérée cible.
L’importation échoue si le fichier de configuration de recherche contient des alias ou des noms de propriétés gérées comprenant des caractères non valides.
Les alias et les noms de propriétés gérées d’un schéma de recherche doivent être uniques pour un site et sa collection de sites parent. Par conséquent :
L’importation échoue si votre fichier de configuration de recherche possède une propriété gérée portant le même nom qu’un alias pour une propriété gérée sur votre site cible ou sur la collection de sites parent de votre site cible.
L’importation échoue si votre fichier de configuration de recherche possède une propriété gérée avec un alias portant le même nom qu’une propriété gérée sur votre site cible ou sur la collection de sites parent de votre site cible.
Notes
Tous les paramètres de recherche personnalisés créés et activés par SharePoint avant l’échec de l’importation restent activés.
Si l'importation échoue, supprimez la condition à l'origine de l'échec et réimportez le fichier de configuration de recherche. Par exemple, si la colonne Remarques indique qu'il existe déjà une règle de requête portant le même nom que celle que vous essayez d'importer, supprimez cette règle de requête de la cible ou du fichier à importer, puis réimportez le fichier. Consultez les caractères non valides qui provoquent l’échec de votre importation plus loin dans cet article.
Exporter des paramètres de configuration de recherche personnalisés à partir d’un client
- Go to More features in the SharePoint admin center, and sign in with an account that has admin permissions for your organization.
Notes
Si vous avez Office 365 géré par 21Vianet (en Chine), connectez-vous au Centre d’administration Microsoft 365, puis recherchez dans le Centre d’administration SharePoint et ouvrez la page Autres fonctionnalités.
Sous Rechercher, sélectionnez Ouvrir.
Sélectionnez Exporter la configuration de la recherche.
Dans la boîte de dialogue, sélectionnez Enregistrer.
Exporter des paramètres de configuration de recherche personnalisés à partir d’un site
Sur le site, sélectionnez Paramètres
puis sélectionnez Paramètres du site. Si vous ne voyez pas les paramètres du site, sélectionnez Informations sur le site, puis afficher tous les paramètres du site.Dans la page Paramètres site, dans la section Recherche, sélectionnez Exportation de la configuration.
Dans la boîte de dialogue, sélectionnez Enregistrer.
Exporter des paramètres de configuration de recherche personnalisés à partir d’une collection de sites
Sur le site, sélectionnez Paramètres
puis sélectionnez Paramètres du site. Si vous ne voyez pas les paramètres du site, sélectionnez Informations sur le site, puis afficher tous les paramètres du site.Dans la page Paramètres site, dans la section Administration de la collection de sites, sélectionnez Exportation de la configuration de la recherche.
Dans la boîte de dialogue, sélectionnez Enregistrer.
Importer des paramètres de configuration de recherche personnalisés vers un client
- Go to More features in the SharePoint admin center, and sign in with an account that has admin permissions for your organization.
Notes
Si vous avez Office 365 géré par 21Vianet (en Chine), connectez-vous au Centre d’administration Microsoft 365, puis recherchez dans le Centre d’administration SharePoint et ouvrez la page Autres fonctionnalités.
Sous Rechercher, sélectionnez Ouvrir.
Dans la page Importer la configuration de la recherche, accédez au fichier que vous souhaitez importer.
Sélectionnez Importer.
Sur la page Liste de configuration de la recherche, vérifiez les éléments suivants :
Le fichier de configuration de recherche importé est dans la liste et son statut est L'importation a été effectuée correctement.
Si le fichier n’a pas été importé correctement, la colonne Notes fournit plus de détails sur ce qui s’est passé.
La colonne Étendue indique que les paramètres que vous avez importés sont au niveau droit, c’est-à-dire au niveau où vous souhaitez importer le fichier. Par exemple, si vous avez importé vos paramètres au niveau de la collection de sites plutôt qu’au niveau du site, vous verrez ces informations dans la colonne Étendue . La colonne Étendue indique à quel niveau les paramètres de configuration de recherche ont été activés. Les niveaux sont : client (client), collection de sites (SPSite) ou niveau site (SPWeb).
Importer des paramètres de configuration de recherche personnalisés vers un site
Sur le site, sélectionnez Paramètres
puis sélectionnez Paramètres du site. Si vous ne voyez pas les paramètres du site, sélectionnez Informations sur le site, puis afficher tous les paramètres du site.Dans la page Paramètres site, dans la section Recherche, sélectionnez Importation de la configuration.
Dans la page Importer la configuration de la recherche, accédez au fichier que vous souhaitez importer.
Sélectionnez Importer.
Sur la page Liste de configuration de la recherche, vérifiez les éléments suivants :
Le fichier de configuration de recherche importé est dans la liste et son statut est L'importation a été effectuée correctement.
Si le fichier n’a pas été importé correctement, la colonne Notes fournit plus de détails sur ce qui s’est passé.
La colonne Étendue indique que les paramètres que vous avez importés sont au niveau droit, c’est-à-dire au niveau où vous souhaitez importer le fichier. Par exemple, si vous avez importé vos paramètres au niveau de la collection de sites plutôt qu’au niveau du site, vous verrez ces informations dans la colonne Étendue . La colonne Étendue indique à quel niveau les paramètres de configuration de recherche ont été activés. Les niveaux sont : client (client), collection de sites (SPSite) ou niveau site (SPWeb).
Importer des paramètres de configuration de recherche personnalisés vers une collection de sites
Sur le site, sélectionnez Paramètres
puis sélectionnez Paramètres du site. Si vous ne voyez pas les paramètres du site, sélectionnez Informations sur le site, puis afficher tous les paramètres du site.Dans la page Site Paramètres, dans la section Administration de la collection de sites, sélectionnez Importation de la configuration de la recherche.
Dans la page Importer la configuration de la recherche, accédez au fichier que vous souhaitez importer.
Sélectionnez Importer.
Sur la page Liste de configuration de la recherche, vérifiez les éléments suivants :
Le fichier de configuration de recherche que vous avez importé figure dans la liste et son état est Importé avec succès.
Si le fichier n’a pas été importé correctement, la colonne Notes fournit plus de détails sur ce qui s’est passé.
La colonne Étendue indique que les paramètres que vous avez importés sont au niveau droit, c’est-à-dire au niveau où vous souhaitez importer le fichier. Par exemple, si vous avez importé vos paramètres au niveau de la collection de sites plutôt qu’au niveau du site, vous verrez ces informations dans la colonne Étendue . La colonne Étendue indique à quel niveau les paramètres de configuration de recherche ont été activés. Les niveaux sont : client (client), collection de sites (SPSite) ou niveau site (SPWeb).
Caractères non valides à l’origine de l’échec de votre importation
Si les propriétés gérées ou les alias contiennent l’un des caractères répertoriés, l’importation du schéma de recherche personnalisé qui contient ces propriétés échoue.
| Caractère | Nom |
|---|---|
| espace |
|
| : |
deux points |
| ; |
point-virgule |
| , |
virgule |
| ( |
parenthèse ouvrante |
| ) |
parenthèse fermante |
| [ |
crochet ouvrant |
| ] |
crochet fermant |
| { |
accolade ouvrante |
| } |
accolade fermante |
| % |
pourcentage |
| $ |
symbole dollar |
| _ |
trait de soulignement |
| + |
signe plus |
| ! |
point d’exclamation |
| * |
astérisque |
| = |
signe égal |
| & |
esperluette |
| ? |
point d’interrogation |
| @ |
arobase |
| # |
signe dièse |
| \ |
barre oblique inverse |
| ~ |
tilde |
| < |
crochet pointu ouvrant |
| > |
crochet pointu fermant |
| | |
canal |
| ` |
accent grave |
| ^ |
accent circonflexe |
| ' |
séquence d’échappement |
| " |
séquence d’échappement |
Problème connu
Lorsque vous importez des fichiers de configuration de recherche dans la page des paramètres de recherche de l’administrateur client, vous pouvez rencontrer un problème que la liste de configuration de recherche n’a pas pu afficher correctement et vous pouvez recevoir une erreur « Fichier in trouvé ».
Ce problème empêche uniquement l’interface utilisateur d’afficher la liste des fichiers de configuration de recherche que vous avez importés et ne bloque pas la fonctionnalité d’importation . Votre configuration de recherche sera importée correctement.
Étant donné que vous ne parvenez pas à vérifier l’état du fichier de configuration de recherche que vous avez importé à partir de l’interface utilisateur, vous pouvez choisir une autre façon d’accéder à la liste, comme l’API CSOM SharePoint ou l’API REST SharePoint Online.