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

  • Article

S’APPLIQUE À :oui-img-132013 oui-img-162016 oui-img-192019 oui-img-seÉdition d’abonnement no-img-sopSharePoint dans Microsoft 365

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 en tant qu’affinements dans la recherche classique, vous devez d’abord créer un dictionnaire d’extraction d’entités personnalisé et le déployer. 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.

Avant de commencer

Avant de commencer cette opération, vous devez disposer des paramètres suivants :

  • 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 Vue d'ensemble des types d'extracteurs 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.

    • 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.

    • (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, procédez comme suit :

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

  2. Dans 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é personnalisé que vous avez activé, les entités extraites sont copiées dans une ou plusieurs des propriétés managées suivantes :

  • WordCustomRefiner1
  • WordCustomRefiner2
  • WordCustomRefiner3
  • WordCustomRefiner4
  • WordCustomRefiner5
  • WordExactCustomRefiner
  • WordPartCustomRefiner1
  • WordPartCustomRefiner2
  • WordPartCustomRefiner3
  • WordPartCustomRefiner4
  • WordPartCustomRefiner5
  • WordPartExactCustomRefiner

Ces propriétés managées sont automatiquement configurées pour faire l’objet d’une recherche, d’une requête, d’une récupération, d’un tri et d’un refinable.

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, procédez comme suit :

  1. Vérifiez que le compte utilisateur qui effectue cette procédure est associé à un 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. Modifiez le composant WebPart Affinement. Cliquez sur la flèche Menu du composant WebPart Affinement , puis cliquez sur Modifier le composant WebPart.

    • 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é.

    • Cliquez sur Choisir des affinements

    • 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.

    • 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 le type de dictionnaires d’extraction personnalisé que vous pouvez créer et la façon dont les entrées du dictionnaire sont mises en correspondance avec le contenu de l’index de recherche, le nom du dictionnaire que vous devez utiliser lorsque vous déployez le dictionnaire et la propriété managée qui contiendra les entités extraites.

Extracteur d'entités personnalisées/Dictionnaire d'extraction d'entités personnalisées Description Exemple Nom de dictionnaire à utiliser dans Windows PowerShell Propriété gérée qui contiendra l'entité extraite
Correspondances de mots Entrées de dictionnaires ne tenant pas compte de la casse correspondant à des contenus tokénisés (mots complets), 5 dictionnaires maximum. L’entrée « ancre » correspond à « ancre » et « Ancre », mais pas à « ancrer » Microsoft.UserDictionaries.EntityExtraction.Custom.Word.n [où n = 1,2,3,4 ou 5] WordCustomRefiner1 WordCustomRefiner2 WordCustomRefiner3 WordCustomRefiner4 WordCustomRefiner5
Correspondances exactes ou partielles de mots Entrées de dictionnaires ne tenant pas compte de la casse correspondant à des contenus non tokénisés (mots pas nécessairement complets), 5 dictionnaires maximum. L’entrée « ancre » correspond à « ancre », « Ancre » et « ancrer » Microsoft.UserDictionaries.EntityExtraction.Custom.WordPart.n [où n = 1,2,3,4 ou 5] WordPartCustomRefiner1 WordPartCustomRefiner2 WordPartCustomRefiner3 WordPartCustomRefiner4 WordPartCustomRefiner5
Correspondances exactes Entrées de dictionnaires tenant compte de la casse correspondant à des contenus tokénisés (mots complets), 1 dictionnaire maximum. L’entrée « ancre » correspond à « ancre », mais pas à « Ancre » ou à « ancrer » Microsoft.UserDictionaries.EntityExtraction.Custom.ExactWord.1 WordExactCustomRefiner
Correspondances exactes ou partielles Entrées de dictionnaires tenant compte de la casse correspondant à des contenus non tokénisés (mots pas nécessairement complets), 1 dictionnaire maximum. L’entrée « ancre » correspond à « ancre » et à « ancrer », mais pas à « Ancre » Microsoft.UserDictionaries.EntityExtraction.Custom.ExactWordPart.1 WordPartExactCustomRefiner

Voir aussi

Import-SPEnterpriseSearchCustomExtractionDictionary