Erstellen und Bereitstellen von benutzerdefinierten Entitätsextraktionsfunktionen in SharePoint Server

Artikel
03/21/2018

**Gilt für:**SharePoint Server 2013, SharePoint Server 2016

**Letztes Änderungsdatum des Themas:**2018-03-07

Zusammenfassung: Erfahren Sie, wie Sie benutzerdefinierte Entitätsextraktionsfunktionen erstellen und zum Einrichten von benutzerdefinierten Einschränkungen verwenden können. Erstellen Sie benutzerdefinierte Entitätsextraktionswörterbücher, und verbinden Sie diese mit verwalteten Eigenschaften.

Sie erstellen und verwalten die Datei für die benutzerdefinierte Entitätsextraktionsfunktion in einem System außerhalb von SharePoint Server, bevor Sie sie in SharePoint Server importieren, um die benutzerdefinierte Entitätsextraktionsfunktion im Suchsystem verfügbar zu machen.

Um benutzerdefinierte Entitäten als Einschränkungen zu verwenden, erstellen Sie zunächst ein benutzerdefiniertes Entitätsextraktionswörterbuch und stellen es bereit. Dann konfigurieren Sie eine verwaltete Eigenschaft zur Verwendung einer benutzerdefinierten Entitätsextraktionsfunktion und führen eine vollständige Durchforstung durch. Anschließend können Sie das Verfeinerungs-Webpart auf der Suchergebnisseite konfigurieren, um die benutzerdefinierte Entität als Einschränkung zu verwenden.

Inhalt dieses Artikels:

Bevor Sie beginnen
Erstellen eines benutzerdefinierten Entitätsextraktionswörterbuchs
Bereitstellen eines benutzerdefinierten Entitätsextraktionswörterbuchs
Konfigurieren einer verwalteten Eigenschaft für die benutzerdefinierte Extrahierung von Entitäten
Konfigurieren einer Einschränkung im Webpart

Bevor Sie beginnen

Bevor Sie diesen Vorgang beginnen, müssen Sie Folgendes eingerichtet haben:

Eine Suchdienstanwendung
Eine oder mehrere vollständig durchforstete Inhaltsquellen
Eine Suchergebnisseite

Erstellen eines benutzerdefinierten Entitätsextraktionswörterbuchs

So erstellen Sie ein benutzerdefiniertes Entitätsextraktionswörterbuch

Bestimmen Sie, welche Art von benutzerdefiniertem Entitätsextraktionswörterbuch Sie erstellen möchten: Wort, Wortteil, genaues Wort, genauer Wortteil. Weitere Informationen finden Sie unter Übersicht über die Typen der benutzerdefinierten Entitätsextraktionsfunktionen.
Erstellen Sie eine CSV-Datei mit den Spalten Schlüssel und Anzeigeform. Verwenden Sie als Trennzeichen Kommas. Wenn die Datei Nicht-ASCII-Zeichen enthält, z. B. diakritische Zeichen, muss die Datei eine UTF-8-Codierung aufweisen. Speichern Sie die Datei in einem Speicherort, auf den Sie von dem Server zugreifen können, von dem aus Sie das Microsoft PowerShell-Cmdlet ausführen, um das benutzerdefinierte Entitätsextraktionswörterbuch bereitzustellen.
- Geben Sie in die Spalte Schlüssel den Begriff (Wort oder mehrere Wörter) ein, den Sie als benutzerdefinierte Entitäten einfügen möchten. Sie können mehrere Zeilen pro Schlüssel verwenden. Achten Sie darauf, dass sich vor und nach den Begriffen keine Leerzeichen befinden.
- (Optional) Geben Sie in der Spalte Anzeigeform einen Einschränkungsnamen ein. Wenn Sie diese Spalte leer lassen, wird der aus dem Inhalt extrahierte Begriff in der gleichen Weise als Einschränkung angezeigt, wie er im Inhalt angezeigt wird. Verwenden Sie die Spalte Display Form, um die Art, wie die Einschränkung angezeigt wird, zu steuern und zu standardisieren.

Angenommen, eine Organisation mit dem Namen "Contoso" verfügt über ein Zertifizierungssystem in drei Stufen: Contoso Beginner, Contoso Professional und Contoso Expert. Contoso möchte diese Entitäten extrahieren und möchte in der Lage sein, Einschränkungen an diesen einzelnen Stufen vorzunehmen. Unabhängig von der Schreibweise der Wörter "Contoso", "beginner", "professional" oder "expert" in Groß- oder Kleinbuchstaben soll die Einschränkung als Contoso Beginner, Contoso Professional und Contoso Expert angezeigt werden. Im gezeigten Beispiel könnte die Dateieingabe für das benutzerdefinierte Entitätsextraktionswörterbuch wie folgt aussehen:

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

Bereitstellen eines benutzerdefinierten Entitätsextraktionswörterbuchs

Zum Bereitstellen des benutzerdefinierten Entitätsextraktionswörterbuchs müssen Sie es in SharePoint Server importieren.

So importieren Sie ein benutzerdefiniertes Entitätsextraktionswörterbuch

Vergewissern Sie sich, dass das Benutzerkonto, mit dem das benutzerdefinierte Entitätsextraktionswörterbuch importiert wird, über Administratorberechtigungen für die Suchdienstanwendung verfügt.
Starten Sie die SharePoint 15-Verwaltungsshell.
Geben Sie an der Windows PowerShell-Eingabeaufforderung den folgenden Befehl ein:
```
$searchApp = Get-SPEnterpriseSearchServiceApplication
Import-SPEnterpriseSearchCustomExtractionDictionary -SearchApplication $searchApp -Filename <Path> -DictionaryName <Dictionary name> 
```
Dabei gilt Folgendes:
- <Path> gibt den vollständigen UNC-Pfad der zu importierenden CSV-Datei (das benutzerdefinierte Extraktionswörterbuch) an.
- <Dictionary name> ist der Name des Typs des benutzerdefinierten Extraktionswörterbuchs.
  
  Geben Sie einen der folgenden Befehle ein, abhängig vom Typ des zu importierenden Wörterbuchs:
  - Microsoft.UserDictionaries.EntityExtraction.Custom.Word.n [wobei n = 1, 2, 3, 4 oder 5 ist]
  - Microsoft.UserDictionaries.EntityExtraction.Custom.ExactWord.1
  - Microsoft.UserDictionaries.EntityExtraction.Custom.WordPart.n [wobei n = 1,2,3,4 oder 5 ist]
  - Microsoft.UserDictionaries.EntityExtraction.Custom.ExactWordPart.1

Konfigurieren einer verwalteten Eigenschaft für die benutzerdefinierte Entitätenextraktion

Im folgenden Verfahren wird erläutert, wie das Wörterbuch für die benutzerdefinierte Entitätenextraktion einer vorhandenen verwalteten Eigenschaft zugeordnet wird, aus der Sie benutzerdefinierte Entitäten extrahieren möchten. In der Regel handelt es sich dabei um eine verwaltete Eigenschaft, von der Sie erwarten, dass sie diese Entitäten enthält, wie die verwalteten Eigenschaften Titel oder Textkörper. Benutzerdefinierte Entitäten werden aus den vollständigen Inhalten der verwalteten Eigenschaft, mit der sie verknüpft sind, extrahiert, und zwar sogar dann, wenn Abschnitte dieser Inhalte als <no index> gekennzeichnet sind.

Um anzugeben, aus welcher vorhandenen verwalteten Eigenschaft benutzerdefinierte Entitäten extrahiert werden sollen, bearbeiten Sie die vorhandene verwaltete Eigenschaft. Weitere Informationen zur Verwaltung von durchforsteten und verwalteten Eigenschaften finden Sie unter Verwalten des Suchschemas in SharePoint Server.

So konfigurieren Sie eine verwaltete Eigenschaft für die benutzerdefinierte Entitätenextraktion

Stellen Sie sicher, dass das Benutzerkonto über Administratorberechtigungen für die Suchdienstanwendung verfügt.
Klicken Sie in der Zentraladministration im Abschnitt Anwendungsverwaltung auf Dienstanwendungen verwalten.
Klicken Sie auf die Suchdienstanwendung.
Klicken Sie auf der Seite Suchverwaltung auf der Schnellstartleiste unter Abfragen und Ergebnisse auf Suchschema.
Suchen Sie auf der Seite Verwaltete Eigenschaften nach der verwalteten Eigenschaft, der Sie das benutzerdefinierte Entitätsextraktionswörterbuch zuordnen möchten, das einzelne oder mehrere Wörter (oder Wortteile) enthält. Sie können auch den Namen der verwalteten Eigenschaft im Feld Filter eingeben.
Zeigen Sie auf die verwaltete Eigenschaft, klicken Sie auf den Pfeil, und klicken Sie dann auf Eigenschaft bearbeiten/zuordnen.
Bearbeiten Sie auf der Seite Eigenschaft bearbeiten/zuordnen die Einstellungen unter Benutzerdefinierte Entitätsextraktion. Wählen Sie das benutzerdefinierte Entitätsextraktionswörterbuch aus, das Sie importiert haben, und klicken Sie dann auf OK.

Nachdem die vollständige Durchforstung abgeschlossen ist, wird die benutzerdefinierte Entitätsextraktionsfunktion aktiviert. Der ursprüngliche Inhalt der verwalteten Eigenschaft wird unverändert im Suchindex gespeichert. Zudem werden, abhängig vom Typ der aktivierten benutzerdefinierten Entitätsextraktionsfunktion, die extrahierten Entitäten in eine der folgenden verwalteten Eigenschaften kopiert: WordCustomRefiner1, WordCustomRefiner2, WordCustomRefiner3, WordCustomRefiner4, WordCustomRefiner5WordExactCustomRefinerWordPartCustomRefiner1, WordPartCustomRefiner2, WordPartCustomRefiner3. WordPartCustomRefiner4, WordPartCustomRefiner5, WordPartExactCustomRefiner. Diese verwalteten Eigenschaften werden automatisch als durchsuchbar, abfragbar, abrufbar, sortierbar und einschränkbar konfiguriert.

Konfigurieren einer Einschränkung im Webpart

Sie können die extrahierten benutzerdefinierten Entitäten als Einschränkungen auf der Suchergebnisseite verwenden. Die auf benutzerdefinierten Entitäten basierenden Einschränkungen sind im Verfeinerungs-Webpart verfügbar.

So fügen Sie eine Einschränkung basierend auf einer benutzerdefinierten Entitätsextraktionsfunktion hinzu

Stellen Sie sicher, dass das Benutzerkonto, mit dem dieses Verfahren ausgeführt wird, in der Unternehmenssuchcenter-Website ein Mitglied der SharePoint-Gruppe "Designer" ist.
Navigieren Sie zu der Seite, die das Einschränkungswebpart enthält, das Sie konfigurieren möchten, klicken Sie auf das Menü Einstellungen und dann auf Seite bearbeiten.
Bearbeiten Sie das Einschränkungswebpart. Klicken Sie auf den Pfeil für das Einschränkungswebpart-Menü und dann auf Webpart bearbeiten.
- Stellen Sie sicher, dass im Toolbereich des Webparts im Abschnitt Eigenschaften für Sucheinschränkung die Option Einschränkungen in diesem Webpart aussuchen ausgewählt ist.
- Klicken Sie auf Einschränkungen auswählen.
- Verwenden Sie auf der Seite Einschränkungskonfiguration im Abschnitt Verfügbare Einschränkungen die Schaltflächen, um eine oder mehrere verwaltete Eigenschaften auszuwählen, die extrahierte Entitäten enthalten, die Sie als Einschränkungen aus der Liste anzeigen möchten, und klicken Sie auf Hinzufügen. Wenn Sie beispielsweise ein Extraktionswörterbuch für Wörter bereitgestellt haben, wählen Sie WordCustomRefiner1 aus.
- Legen Sie im Abschnitt Konfigurieren für fest, wie jede Einschränkung angezeigt wird.
Klicken Sie auf OK.

Übersicht über die Typen der benutzerdefinierten Entitätsextraktionsfunktionen

Die folgende Tabelle zeigt, welchen Typ von benutzerdefinierten Extraktionswörterbüchern Sie erstellen können, wie die Wörterbucheinträge mit dem Inhalt im Suchindex abgeglichen werden, welchen Wörterbuchnamen Sie verwenden sollten, wenn Sie das Wörterbuch bereitstellen, und welche verwaltete Eigenschaft die extrahierten Entitäten enthält.

Benutzerdefinierte Entitätsextraktionsfunktion/benutzerdefiniertes Extraktionswörterbuch	Beschreibung	Beispiel	In Windows PowerShell zu verwendender Wörterbuchname	Verwaltete Eigenschaft, die die extrahierte Entität enthält
Wortextraktion	Keine Beachtung der Groß-/Kleinschreibung, Wörterbucheinträge entsprechen Inhalt mit Token, maximal 5 Wörterbücher.	Der Eintrag "dienst" stimmt mit "dienst" und "Dienst" überein, aber nicht mit "dienstlich".	Microsoft.UserDictionaries.EntityExtraction.Custom.Word.n [wobei n = 1,2,3,4 oder 5 ist]	WordCustomRefiner1 WordCustomRefiner2 WordCustomRefiner3 WordCustomRefiner4 WordCustomRefiner5
Wortteilextraktion	Keine Beachtung der Groß-/Kleinschreibung, Wörterbucheinträge entsprechen Inhalt ohne Token, maximal 5 Wörterbücher.	Der Eintrag "dienst" stimmt mit "dienst" und "Dienst" und "dienstlich" überein.	Microsoft.UserDictionaries.EntityExtraction.Custom.WordPart.n [wobei n = 1,2,3,4 oder 5 ist]	WordPartCustomRefiner1 WordPartCustomRefiner2 WordPartCustomRefiner3 WordPartCustomRefiner4 WordPartCustomRefiner5
Exakte Wortextraktion	Beachtung der Groß-/Kleinschreibung, Wörterbucheinträge entsprechen Inhalt mit Token, maximal 1 Wörterbuch.	Der Eintrag "dienst" stimmt mit "dienst", aber nicht mit "Dienst" und "dienstlich" überein.	Microsoft.UserDictionaries.EntityExtraction.Custom.ExactWord.1	WordExactCustomRefiner
Exakte Wortteilextraktion	Beachtung der Groß-/Kleinschreibung, Wörterbucheinträge entsprechen Inhalt ohne Token, maximal 1 Wörterbuch.	Der Eintrag "dienst" stimmt mit "dienst" und "dienstlich" überein, aber nicht mit "Dienst".	Microsoft.UserDictionaries.EntityExtraction.Custom.ExactWordPart.1	WordPartExactCustomRefiner

Freigeben über