Erstellen und Bereitstellen von benutzerdefinierten Entitätsextraktionsfunktionen in SharePoint Server
GILT FÜR:
2013 2016 2019 Subscription Edition 
SharePoint in Microsoft 365
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 in der klassischen Suche zu verwenden, erstellen Sie zunächst ein wörterbuch für die Extraktion benutzerdefinierter Entitäten 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.
Bevor Sie beginnen
Bevor Sie mit diesem Vorgang beginnen können, benötigen Sie Folgendes:
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 Anzeigeformular. Verwenden Sie als Trennzeichen Kommas. Falls die Datei Nicht-ASCII-Zeichen, wie z. B. diakritische Zeichen, enthält, müssen Sie die Datei in UTF-8 codieren. Speichern Sie die Datei an einem Speicherort, auf den über den Server zugegriffen werden kann, 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-Verwaltungsshell.
Geben Sie an der Windows PowerShell-Eingabeaufforderung den folgenden Befehl ein:
$searchApp = Get-SPEnterpriseSearchServiceApplication Import-SPEnterpriseSearchCustomExtractionDictionary -SearchApplication $searchApp -Filename <Path> -DictionaryName <Dictionary name>Wobei Folgendes gilt:
<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]
Microsoft.UserDictionaries.EntityExtraction.Custom.ExactWord.1
Microsoft.UserDictionaries.EntityExtraction.Custom.WordPart. n [wobei n = 1,2,3,4 oder 5]
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 bearbeiten 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.
Nach Abschluss der nächsten vollständigen Durchforstung wird der benutzerdefinierte Entitätsextraktor aktiviert. Der ursprüngliche Inhalt der verwalteten Eigenschaft wird unverändert im Suchindex gespeichert. Außerdem werden die extrahierten Entitäten abhängig vom Typ des aktivierten benutzerdefinierten Entitätsextraktions in eine oder mehrere der folgenden verwalteten Eigenschaften kopiert:
- WordCustomRefiner1
- WordCustomRefiner2
- WordCustomRefiner3
- WordCustomRefiner4
- WordCustomRefiner5
- WordExactCustomRefiner
- WordPartCustomRefiner1
- WordPartCustomRefiner2
- WordPartCustomRefiner3
- WordPartCustomRefiner4
- WordPartCustomRefiner5
- WordPartExactCustomRefiner
Diese verwalteten Eigenschaften werden automatisch so konfiguriert, dass sie durchsuchbar, abfragbar, abrufbar, sortierbar und verfeinerungsfähig sind.
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 durchgeführt wird, auf 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.
Edit the Refinement Web Part. Click the Refinement Web Part Menu arrow, and then click Edit Web Part.
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, welche Art von benutzerdefinierten Extraktionswörterbüchern Sie erstellen können und wie die Wörterbucheinträge mit inhalten 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] | 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] | 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 |