Créer et déployer des extracteurs d’entités personnalisées dans SharePoint Server

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

**Dernière rubrique modifiée :**2017-09-11

**Résumé :**Découvrez comment créer des extracteurs d’entités personnalisées et les utiliser pour configurer des affinements personnalisés. Créez un ou plusieurs dictionnaires d’extraction d’entités personnalisées et connectez-les aux propriétés gérées.

Vous créez et traitez le fichier d’extracteur d’entités personnalisées dans un système extérieur à SharePoint Server avant de l’importer dans SharePoint Server pour qu’il soit accessible au système de recherche.

Pour utiliser des entités personnalisées comme des affinements, vous commencez par créer un dictionnaire d’extraction d’entités personnalisées et le déployez. Ensuite, vous configurez une propriété gérée pour utiliser un extracteur d’entités personnalisées et exécuter une analyse complète. Après cela, vous pouvez configurer le composant WebPart Affinement sur la page des résultats de recherche pour utiliser l’entité personnalisée en tant qu’affinement.

Dans cet article :

• Avant de commencer

• Créer un dictionnaire d’extraction d’entités personnalisées

• Déployer un dictionnaire d’extraction d’entités personnalisées

• Configurer une propriété gérée pour l’extraction d’entités personnalisées

• Configurer un affinement dans le composant WebPart

Avant de commencer

Avant de commencer cette opération, vous devez avoir :

• Une application de service de recherche

• Une ou plusieurs sources de contenu entièrement analysées

• Une page des résultats de recherche

Créer un dictionnaire d’extraction d’entités personnalisées

Pour créer un dictionnaire d’extraction d’entités personnalisées

1. Déterminez le type de dictionnaire d’extraction d’entités personnalisées que vous voulez créer : Correspondances, Correspondances partielles, Correspondances exactes ou Correspondances exactes ou partielles. Voir Présentation des types d’extracteur d’entités personnalisées.

2. Créez un fichier .csv avec les colonnes Clé et Afficher le formulaire. Utilisez une virgule comme séparateur de colonne. Si le fichier contient des caractères non-ASCII tels que des signes diacritiques, vous devez l’encoder en UTF-8. Enregistrez le fichier à un emplacement accessible depuis le serveur à partir duquel vous allez exécuter l’applet de commande Microsoft PowerShell pour déployer le dictionnaire d’extraction d’entités personnalisées.

   1. Dans la colonne Clé, entrez le terme (en un ou plusieurs mots) que vous voulez inclure en tant qu’entité personnalisée. Vous pouvez utiliser plusieurs lignes par clé. Veillez à éliminer les espaces avant ou après les termes.

   2. (Facultatif) Dans la colonne Afficher le formulaire, entrez un nom d’affinement. Si vous laissez cette colonne vide, le terme extrait du contenu est affiché en tant qu’affinement en reprenant la casse utilisée dans le contenu. Utilisez la colonne Display Form pour contrôler et normaliser l’affichage de l’affinement.

Par exemple, une organisation nommée Contoso dispose d’un système de certification à trois niveaux : Contoso Beginner, Contoso Professional et Contoso Expert. Contoso veut extraire ces entités et pouvoir les affiner. Quelle que soit la façon dont le mot « Contoso », « beginner », « professional » ou « expert » est écrit, l’affinement doit être affiché de la façon suivante : Contoso Beginner, Contoso Professional et Contoso Expert. Pour cet exemple, le fichier de dictionnaire d’extraction d’entités personnalisées peut se présenter comme suit :

Key,Display form
Contoso Beginner,Contoso Beginner
Contoso B1,Contoso Beginner
Contoso Professional,Contoso Professional
Contoso prof,Contoso Professional
Contoso Expert,Contoso Expert

Déployer un dictionnaire d’extraction d’entités personnalisées

Pour déployer un dictionnaire d’extraction d’entités personnalisées, vous devez l’importer dans SharePoint Server.

Pour importer un dictionnaire d’extraction d’entités personnalisées

1. Vérifiez que le compte d’utilisateur qui importe le dictionnaire d’extraction d’entités personnalisées est un administrateur de l’application de service de recherche.

2. Démarrez SharePoint Management Shell.

3. À partir de l’invite de commandes Windows PowerShell, tapez la commande suivante :

   $searchApp = Get-SPEnterpriseSearchServiceApplication
   Import-SPEnterpriseSearchCustomExtractionDictionary -SearchApplication $searchApp -Filename <Path> -DictionaryName <Dictionary name> 
   

   Où :

   • <Path> spécifie le chemin d’accès UNC complet du fichier .csv (dictionnaire d’extraction personnalisé) à importer.

   • <Dictionary name> est le nom du type de dictionnaire d’extraction personnalisé.

     Suivant le type de dictionnaire que vous importez, saisissez l’une des entrées suivantes :

     • Microsoft.UserDictionaries.EntityExtraction.Custom.Word.n [où n = 1, 2, 3, 4 ou 5]

     • Microsoft.UserDictionaries.EntityExtraction.Custom.ExactWord.1

     • Microsoft.UserDictionaries.EntityExtraction.Custom.WordPart.n [où n = 1, 2, 3, 4 ou 5]

     • Microsoft.UserDictionaries.EntityExtraction.Custom.ExactWordPart.1

Configurer une propriété gérée pour l’extraction d’entités personnalisées

La procédure suivante décrit comment associer le dictionnaire d’extraction d’entités personnalisées à une propriété gérée existante dont vous souhaitez extraire des entités personnalisées. En règle générale, il s’agit d’une propriété gérée susceptible de contenir ces entités, comme les propriétés gérées Titre ou Corps. Les entités personnalisées sont extraites de l’ensemble du contenu de la propriété gérée associée, même si des sections de ce contenu sont balisées avec <no index>.

Pour spécifier de quelle propriété gérée existante les entités personnalisées doivent être extraites, vous modifiez la propriété gérée existante. Pour plus d’informations sur la gestion des propriétés analysées et gérées, voir Gérer le schéma de recherche dans SharePoint Server.

Pour modifier une propriété gérée pour l’extraction d’entités personnalisées

1. Vérifiez que le compte d’utilisateur est l’administrateur de l’application de service de recherche.

2. Dans l’Administration centrale, dans la section Gestion des applications, cliquez sur Gérer les applications de service.

3. Cliquez sur l’application de service de recherche.

4. Sur la page Administration de la recherche, dans la barre de lancement rapide, sous Requêtes et résultats, cliquez sur Schéma de recherche.

5. Sur la page Propriétés gérées, trouvez la propriété gérée à laquelle vous voulez associer le dictionnaire d’extraction d’entités personnalisées qui contient les correspondances exactes ou partielles. Vous pouvez aussi entrer le nom de la propriété gérée dans la zone Filtre.

6. Pointez vers la propriété gérée, cliquez sur la flèche, puis sur Modifier/mapper la propriété.

7. Dans la page Modifier la propriété gérée, modifiez les paramètres sous Extraction de l’entité personnalisée. Sélectionnez le dictionnaire d’extraction d’entités personnalisées que vous avez importé, puis cliquez sur OK.

À la fin de l’analyse complète suivante, l’extracteur d’entités personnalisé est activé. Le contenu de la propriété gérée d’origine est enregistré dans l’index de recherche sans être modifié. En outre, selon le type d’extracteur d’entités personnalisées que vous avez activé, les entités extraites sont copiées dans une ou plusieurs des propriétés gérées suivantes : WordCustomRefiner1, WordCustomRefiner2, WordCustomRefiner3, WordCustomRefiner4, WordCustomRefiner5WordExactCustomRefinerWordPartCustomRefiner1, WordPartCustomRefiner2, WordPartCustomRefiner3. WordPartCustomRefiner4, WordPartCustomRefiner5WordPartExactCustomRefinerCes propriétés gérées sont configurées automatiquement de façon à pouvoir faire l’objet de recherche, requête, récupération, tri et recherche approfondie.

Configurer un affinement dans le composant WebPart

Vous pouvez utiliser les entités personnalisées extraites en tant qu’affinements dans la page de résultats de la recherche. Les affinements basés sur les entités personnalisées sont disponibles dans le composant WebPart Affinement.

Pour ajouter un affinement basé sur un extracteur d’entités personnalisées

1. Vérifiez que le compte d’utilisateur qui effectue cette procédure est membre du groupe SharePoint Concepteurs sur le site Centre de recherche d’entreprise.

2. Accédez à la page contenant le composant WebPart d’affinement à configurer, cliquez sur le menu Paramètres, puis sur Modifier la page.

3. Dans le composant WebPart d’affinement, cliquez sur la flèche Menu du composant WebPart Affinement, puis cliquez sur Modifier le composant WebPart.

   1. Dans le volet d’outils du composant WebPart, dans la section Propriétés du perfectionnement de recherche, vérifiez que Sélectionner des affinements dans ce composant WebPart est sélectionné.

   2. Cliquez sur Choisir des affinements

   3. Sur la page de configuration Affinement, dans la section Affinements disponibles, utilisez les boutons pour sélectionner une ou plusieurs propriétés gérées contenant les entités extraites à afficher en tant qu’affinements dans la liste, puis cliquez sur Ajouter. Par exemple, si vous avez déployé un dictionnaire de correspondances exactes, choisissez WordCustomRefiner1.

   4. Dans la section Configurer pour, configurez la manière dont vous voulez que chaque affinement apparaisse.

4. Cliquez sur OK.

Vue d’ensemble des types d’extracteurs d’entités personnalisées

Le tableau suivant indique les types de dictionnaires d’extraction personnalisée que vous pouvez créer, comment les entrées de dictionnaire sont mises en correspondance avec le contenu de l’index de recherche, le nom du dictionnaire à utiliser pour déployer le dictionnaire et la propriété gérée qui contiendra les entités extraites.

See also

Import-SPEnterpriseSearchCustomExtractionDictionary