Condividi tramite

Creare e distribuire estrattori di entità personalizzati in SharePoint Server

  • Articolo

SI APPLICA A:yes-img-132013 yes-img-162016 yes-img-192019 yes-img-seSubscription Edition no-img-sopSharePoint in Microsoft 365

Il file dell'estrattore di entità personalizzate viene creato e mantenuto in un sistema esterno a SharePoint Server prima di essere importato in SharePoint Server per essere reso disponibile al sistema di ricerca.

Per usare entità personalizzate come criteri di affinamento affinamento nella ricerca classica, è prima di tutto necessario creare un dizionario di estrazione di entità personalizzato e distribuirlo. A questo punto, è possibile configurare una proprietà gestita per usare un estrattore di entità personalizzate ed eseguire una ricerca per indicizzazione completa. Al termine, è possibile configurare la web part Perfezionamento nella pagina dei risultati di ricerca affinché usi l'entità personalizzata come criterio di affinamento ricerca.

Prima di iniziare

Prima di iniziare questa operazione, è necessario disporre di:

  • Un'applicazione del servizio di ricerca

  • Una o più origini di contenuto interamente sottoposte a ricerca per indicizzazione

  • Una pagina con i risultati della ricerca

Creare un dizionario per l'estrazione delle entità personalizzate

Per creare un dizionario per l'estrazione delle entità personalizzate

  1. Stabilire il tipo di dizionario per l'estrazione delle entità personalizzate da creare: parole, parti di parole o parole esatte. Vedere Panoramica dei tipi di estrattori delle entità personalizzate.

  2. Creare un file con estensione csv con le colonne Key e Display Form. Accertarsi di utilizzare la virgola come separatore di colonne. Se il file contiene caratteri non ASCII, ad esempio segni diacritici, è necessario codificarlo in UTF-8. Salvare il file in un percorso accessibile dal server da cui verrà eseguito il cmdlet di Microsoft PowerShell per distribuire il dizionario per l'estrazione delle entità personalizzate.

    • Nella colonna Key, immettere il termine (una o più parole) da includere come entità personalizzata. È possibile usare più righe per chiave. Accertarsi che i termini non siano preceduti o seguiti da spazi iniziali o finali.

    • (Facoltativo) Nella colonna Display form immettere un nome per il criterio di affinamento ricerca. Se si lascia vuota la colonna, come criterio di affinamento ricerca verrà visualizzato il termine estratto dal contenuto con la stessa distinzione tra maiuscole e minuscole presente nel contenuto. Utilizzare la colonna Display Form per controllare e standardizzare la visualizzazione del criterio di affinamento ricerca.

Si prenda ad esempio un'organizzazione denominata Contoso con un sistema di certificazione a tre livelli: Contoso Beginner, Contoso Professional e Contoso Expert. Si supponga di voler estrarre tali entità e avere la possibilità di affinare la ricerca in base a tutte le entità estratte. Indipendentemente dalla distinzione tra maiuscole e minuscole in ogni parola ("Contoso", "beginner", "professional" o "expert"), si desidera visualizzare il criterio di affinamento ricerca come Contoso Beginner, Contoso Professional e Contoso Expert. In questo caso, l'input del file di dizionario per l'estrazione delle entità personalizzate potrebbe avere il seguente aspetto:

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

Distribuire un dizionario per l'estrazione delle entità personalizzate

Per distribuire il dizionario per l'estrazione delle entità personalizzate, è necessario importarlo in SharePoint Server.

Per importare un dizionario per l'estrazione delle entità personalizzate

  1. Verificare che l'account utente con cui si importa il dizionario sia un amministrazione dell'applicazione del servizio di ricerca.

  2. Avviare Management Shell di SharePoint.

  3. Al prompt dei comandi di Windows PowerShell digitare il comando seguente:

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

    Dove:

    • <Path> specifica il percorso UNC completo del file con estensione csv (il dizionario di estrazione personalizzato) da importare.

    • <Dictionary name> è il nome del tipo di dizionario di estrazione personalizzato.

    A seconda del tipo di dizionario da importare, immettere uno dei comandi seguenti:

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

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

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

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

Configurare una proprietà gestita per l'estrazione delle entità personalizzate

Nella procedura seguente viene illustrato come associare il dizionario per l'estrazione delle entità personalizzate a una proprietà gestita esistente da cui si desidera estrarre le entità personalizzate. Si tratta in genere di una proprietà gestita che dovrà includere tali entità, ad esempio la proprietà gestita Title o Body. Le entità personalizzate vengono estratte dal contenuto completo della proprietà gestita a cui sono associate, anche se le sezioni di tale contenuto sono contrassegnate dal tag <no index>.

Per specificare la proprietà gestita esistente da cui devono essere estratte le entità personalizzate, modificare la proprietà gestita esistente. Per ulteriori informazioni sulla gestione di entità sottoposte a ricerca per indicizzazione e gestite, vedere Gestire lo schema di ricerca in SharePoint Server.

Per modificare una proprietà gestita per l'estrazione di entità personalizzate

  1. Verificare che l'account utente sia un amministratore dell'applicazione del servizio di ricerca.

  2. Nella sezione Gestione applicazioni in Amministrazione centrale fare clic su Gestisci applicazioni di servizio.

  3. Fare clic sull'applicazione del servizio di ricerca.

  4. Sulla barra di avvio veloce della pagina Amministrazione ricerca fare clic su Schema di ricerca in Query e risultati.

  5. Nella pagina Proprietà gestite individuare la proprietà gestita che si desidera associare al dizionario per l'estrazione delle entità personalizzate contenente parole singole o multiple (o parti di parole). È anche possibile immettere il nome della proprietà gestita nella casella Filtro.

  6. Selezionare la proprietà gestita, fare clic sulla freccia e quindi scegliere Modifica/mapping proprietà.

  7. Nella pagina Modifica proprietà gestita, modificare le impostazioni in Estrazione entità personalizzate. Selezionare il dizionario per l'estrazione delle entità personalizzate importato, quindi fare clic su OK.

Al termine della successiva ricerca per indicizzazione completata, l'estrattore di entità personalizzate verrà abilitato. Il contenuto della proprietà gestita originale viene salvato inalterato nell'indice di ricerca. Inoltre, a seconda del tipo di estrattore di entità personalizzato abilitato, le entità estratte vengono copiate in una o più delle proprietà gestite seguenti:

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

Queste proprietà gestite vengono configurate automaticamente per essere ricercabili, eseguibili su query, recuperabili, ordinabili e perfezionabili.

Configurare un criterio di affinamento ricerca nella web part

È possibile utilizzare le entità personalizzate estratte come criteri di affinamento ricerca nella pagina dei risultati. I criteri di affinamento ricerca basati sulle entità personalizzate sono disponibili nella web part Perfezionamento.

Per aggiungere un criterio di affinamento ricerca basato su un estrattore di entità personalizzate

  1. Verificare che l'account utente che esegue questa procedura sia un membro del gruppo Designer di SharePoint nel sito Centro ricerche organizzazione.

  2. Passare alla pagina in cui si trova la web part Perfezionamento che si desidera configurare e quindi scegliere Modifica pagina dal menu Impostazioni.

  3. Modificare la web part Perfezionamento. Fare clic sulla freccia del relativo menue quindi fare clic su Modifica web part.

    • Nel riquadro degli strumenti della web part, nella sezione Proprietà per l'affinamento della ricerca, verificare che sia selezionata l'opzione Scegli criteri di affinamento ricerca in questa web part.

    • Fare clic su Scegli criteri affinamento ricerca.

    • Nella sezione Criteri di affinamento ricerca disponibili della pagina di configurazione Perfezionamento utilizzare i pulsanti per selezionare dall'elenco una o più proprietà gestite contenenti le entità estratte che si desidera mostrare come criteri di affinamento ricerca e fare clic su Aggiungi. Se ad esempio è stato distribuito un dizionario per l'estrazione di parole, scegliere WordCustomRefiner1.

    • Nella sezione Configura per definire la modalità di visualizzazione desiderata per ogni criterio di affinamento ricerca.

  4. Fare clic su OK.

Panoramica dei tipi di estrattori delle entità personalizzate.

La tabella seguente illustra il tipo di dizionari di estrazione personalizzati che è possibile creare e il modo in cui le voci del dizionario vengono confrontate con il contenuto nell'indice di ricerca, il nome del dizionario da usare quando si distribuisce il dizionario e la proprietà gestita che conterrà le entità estratte.

Estrattore di entità personalizzate/dizionario per l'estrazione delle entità personalizzate Descrizione Esempio Nome di dizionario da utilizzare in Windows PowerShell Proprietà gestita che conterrà l'entità estratta
Estrazione parola Voci di dizionario senza distinzione tra maiuscole e minuscole corrispondenti al contenuto in formato token, massimo 5 dizionari. La voce "ancora" corrisponde ad "ancora" e ad "Ancora" ma non ad "ancoraggio" Microsoft.UserDictionaries.EntityExtraction.Custom.Word.n [dove n = 1,2,3,4 o 5] WordCustomRefiner1 WordCustomRefiner2 WordCustomRefiner3 WordCustomRefiner4 WordCustomRefiner5
Estrazione parte di parola Voci di dizionario senza distinzione tra maiuscole e minuscole corrispondenti al contenuto non in formato token, massimo 5 dizionari. La voce "ancora" corrisponde ad "ancora", "Ancora" e "ancoraggio" Microsoft.UserDictionaries.EntityExtraction.Custom.WordPart.n [dove n = 1,2,3,4 o 5] WordPartCustomRefiner1 WordPartCustomRefiner2 WordPartCustomRefiner3 WordPartCustomRefiner4 WordPartCustomRefiner5
Estrazione parola esatta Voci di dizionario con distinzione tra maiuscole e minuscole corrispondenti al contenuto in formato token, massimo 1 dizionario. La voce "ancora" corrisponde ad "ancora", ma non ad "Ancora" o "Ancoraggio" Microsoft.UserDictionaries.EntityExtraction.Custom.ExactWord.1 WordExactCustomRefiner
Estrazione parte di parola esatta Voci di dizionario con distinzione tra maiuscole e minuscole corrispondenti al contenuto non in formato token, massimo 1 dizionario. La voce "ancora" corrisponde ad "ancora" e "ancoraggio" ma non ad "Ancora" Microsoft.UserDictionaries.EntityExtraction.Custom.ExactWordPart.1 WordPartExactCustomRefiner

Vedere anche

Import-SPEnterpriseSearchCustomExtractionDictionary