Exporter et importer des paramètres de configuration de recherche personnalisés
En tant qu’administrateur SharePoint et versions ultérieures dans Microsoft 365, vous pouvez exporter et importer des paramètres de configuration de recherche personnalisés entre des locataires, des collections de sites et des sites. Les paramètres que vous exportez et importez incluent toutes les règles de requête personnalisées, les sources de 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 dans des locataires, 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 locataire, de la collection de sites ou du site à partir duquel vous démarrez l’exportation. Un fichier de configuration de recherche pour une collection de sites ne contient pas les paramètres de configuration de recherche des sites individuels au sein 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 locataire, la collection de sites ou le site à partir duquel vous démarrez l’importation.
Ce tableau présente les paramètres que vous pouvez exporter ou importer. Pour chaque paramètre, vous trouverez des dépendances par rapport à 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 | Sources de 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 pouvant entraîner 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. Toutefois, il existe 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.
Remarque
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 Caractères non valides à l’origine de l’échec de votre importation plus loin dans cet article.
Exporter des paramètres de configuration de recherche personnalisés à partir d’un locataire
Accédez à Plus de fonctionnalités dans le nouveau Centre d’administration SharePoint, puis connectez-vous à l’aide d’un compte disposant des autorisations d’administrateur pour votre organisation.
Remarque
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 Paramètres du site. Si les paramètres du site ne s’affichent pas, sélectionnez Informations sur le site, puis Afficher tous les paramètres du site.Dans la page Paramètres du site , dans la section Recherche , sélectionnez Exportation de 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 Paramètres du site. Si les paramètres du site ne s’affichent pas, sélectionnez Informations sur le site, puis Afficher tous les paramètres du site.Dans la page Paramètres du site , dans la section Administration de la collection de sites, sélectionnez Exporter la configuration de la recherche.
Dans la boîte de dialogue, sélectionnez Enregistrer.
Importer des paramètres de configuration de recherche personnalisés dans un locataire
Accédez à Plus de fonctionnalités dans le nouveau Centre d’administration SharePoint, puis connectez-vous à l’aide d’un compte disposant des autorisations d’administrateur pour votre organisation.
Remarque
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 Configuration de la recherche d’importation , 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é avec succès, 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 se trouvent au niveau approprié, c’est-à-dire au niveau auquel vous avez prévu d’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, ces informations s’affichent dans la colonne Étendue . La colonne Étendue indique à quel niveau les paramètres de configuration de recherche ont été activés. Les niveaux sont les suivants : locataire (locataire), 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 Paramètres du site. Si les paramètres du site ne s’affichent pas, sélectionnez Informations sur le site, puis Afficher tous les paramètres du site.Dans la page Paramètres du site , dans la section Recherche , sélectionnez Importation de configuration.
Dans la page Configuration de la recherche d’importation , 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é avec succès, 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 se trouvent au niveau approprié, c’est-à-dire au niveau auquel vous avez prévu d’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, ces informations s’affichent dans la colonne Étendue . La colonne Étendue indique à quel niveau les paramètres de configuration de recherche ont été activés. Les niveaux sont les suivants : locataire (locataire), 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 Paramètres du site. Si les paramètres du site ne s’affichent pas, sélectionnez Informations sur le site, puis Afficher tous les paramètres du site.Dans la page Paramètres du site , dans la section Administration de la collection de sites, sélectionnez Importer la configuration de la recherche.
Dans la page Configuration de la recherche d’importation , 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é avec succès, 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 se trouvent au niveau approprié, c’est-à-dire au niveau auquel vous avez prévu d’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, ces informations s’affichent dans la colonne Étendue . La colonne Étendue indique à quel niveau les paramètres de configuration de recherche ont été activés. Les niveaux sont les suivants : locataire (locataire), collection de sites (SPSite) ou niveau site (SPWeb).
Caractères non valides entraînant 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
Impossible de charger la liste de configuration de la recherche
Lorsque vous importez des fichiers de configuration de recherche dans la page des paramètres de recherche de l’administrateur du locataire, vous pouvez rencontrer un problème que la liste de configuration de la recherche n’a pas pu afficher correctement et que vous pouvez recevoir une erreur « Fichier introuvable ».
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 n’interrompt pas la fonctionnalité d’importation . Votre configuration de recherche sera correctement importée.
É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 un autre moyen d’accéder à la liste, comme l’API CSOM SharePoint ou l’API REST SharePoint Online.
Impossible d’importer le fichier XML de configuration de recherche obsolète
Si le fichier de configuration de recherche a été exporté il y a longtemps, l’importation peut échouer.
Si le fichier de configuration de recherche exporté est obsolète, vous devez d’abord exporter une nouvelle configuration de recherche, puis l’utiliser pour importer la liste des fichiers de configuration de recherche.