Creare e distribuire estrattori di entità personalizzati in SharePoint Server

**Si applica a:**SharePoint Server 2013, SharePoint Server 2016

**Ultima modifica dell'argomento:**2018-03-07

Riepilogo: informazioni su come creare estrattori di entità personalizzate e su come utilizzarli per configurare criteri di affinamento ricerca personalizzati. Creare uno o più dizionari per l'estrazione di entità personalizzate e connetterli a proprietà gestite.

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 utilizzare le entità personalizzate come criteri di affinamento ricerca, è innanzitutto necessario creare un dizionario per l'estrazione delle entità personalizzate 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.

Contenuto dell'articolo:

• Prima di iniziare

• Creare un dizionario per l'estrazione delle entità personalizzate

• Distribuire un dizionario per l'estrazione delle entità personalizzate

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

• Configurare un criterio di affinamento ricerca nella web part

Prima di iniziare

Prima di iniziare questa operazione, è necessario avere:

• 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 SharePoint Management Shell.

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 abilitato, le entità estratte possono essere copiate in una o più delle proprietà gestite seguenti:WordCustomRefiner1, WordCustomRefiner2, WordCustomRefiner3, WordCustomRefiner4, WordCustomRefiner5WordExactCustomRefinerWordPartCustomRefiner1, WordPartCustomRefiner2, WordPartCustomRefiner3. WordPartCustomRefiner4, WordPartCustomRefiner5WordPartExactCustomRefinerQueste proprietà gestite vengono automaticamente configurate come ricercabili, interrogabili tramite 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 la procedura sia membro del gruppo di SharePoint Designer 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.

Nella tabella seguente sono indicati i tipi di dizionari per l'estrazione delle entità personalizzate che è possibile creare, le modalità di confronto delle voci del dizionario con il contenuto dell'indice di ricerca, il nome da utilizzare per la distribuzione del dizionario e la proprietà gestita che conterrà le entità estratte.

See also

Import-SPEnterpriseSearchCustomExtractionDictionary