Benutzerdefinierte Inhaltsverarbeitung mit der Content Enrichment-Webdienstlegende

Informationen Sie zu den Content inhaltsanreicherung in SharePoint, die Entwickler zum Erstellen eines externen Webdiensts um verwaltete Eigenschaften für durchforsteten Elemente während der inhaltsverarbeitung ändern können.

Suche in SharePoint ermöglicht Benutzern, die verwalteten Eigenschaften der durchforsteten Elemente zu ändern, bevor sie durch Aufrufen von an einen Webdienst externe inhaltserweiterung indiziert sind. Die Möglichkeit zum Ändern von verwalteter Eigenschaften für Elemente während der inhaltsverarbeitung ist hilfreich, beim Ausführen von Aufgaben wie DatenBereinigung, entitätsextraktion, Klassifizierung und Kategorien.

Abbildung 1: Inhaltserweiterung innerhalb der Inhaltsverarbeitung

Abbildung 1 zeigt einen Teil des Prozesses, der in der inhaltsverarbeitungskomponente stattfindet. Der inhaltserweiterung-Webdienst ist eine SOAP-basierten Dienst, den Sie erstellen können, um eine Legende aus dem Web-Service-Client innerhalb der inhaltsverarbeitungskomponente empfangen. Basierend auf Abbildung 1 verweist der Webdienstclient auf den Inhaltsanreicherungsoperator innerhalb der Inhaltsverarbeitungskomponente. Der Webdienst verweist auf den SOAP-Webdienst, den Sie implementieren. Der Webdienst empfängt eine konfigurierbare Nutzlast von der Inhaltsverarbeitungskomponente. Klicken Sie dann, wird die resultierende Antwort vom Webdienst mit durchforsteten Elements zusammengeführt, bevor es dem Suchindex hinzugefügt wird.Der Dienst WebClient arbeitet mit verwalteten Eigenschaften, die Sie als Eingabeeigenschaften oder als Ausgabeeigenschaften konfigurieren können. Eingabeeigenschaften werden an den Webdienst gesendet. Ausgabeeigenschaften werden durch den Webdienst zurückgegeben. Bestimmte verwalteten Eigenschaften werden ausgeblendet oder sind schreibgeschützt und können nicht an den Webdienst gesendet oder empfangen aus dem Webdienst werden. Informationen zum Überprüfen, welche verwalteten Eigenschaften schreibgeschützt sind, finden Sie unter Auflisten aller schreibgeschützten verwalteten Eigenschaften für den Webdienst für die Inhaltsanreicherung .

Vertrag für den Inhaltserweiterungs-Webdienst

Web-Service-Client ist ein SOAP (Version 1.1) RPC-Client mit einer vordefinierten Verhalten. Servicevertrag Web weist folgende Merkmale auf:

• Die inhaltsverarbeitungskomponente sendet einen SOAP-RPC-Aufruf an einen konfigurierbaren Endpunkt über HTTP.
• Nutzlast enthält ein Array von Property-Objekten.
• Der Webdienst führt eine benutzerdefinierte Logik für das Array von Property-Objekte und gibt ein Array von geänderten oder neuen Property-Objekten.
• Der Webdienst muss eine Antwort an den Dienst WebClient einer angegebenen Timeout senden.
• Keine bestimmten Authentifizierung oder Verschlüsselung Mechanismen werden im Rahmen des Vertrags unterstützt. Sie können jedoch eigene Sicherheit des Transport-Mechanismus anwenden.

Konfigurieren des Inhaltserweiterung Web Service-Clients

Um die Webdienstclients zu konfigurieren, verwenden Sie die folgenden Windows PowerShell-Cmdlets:

• Get-SPEnterpriseSearchContentEnrichmentConfiguration
• Set-SPEnterpriseSearchContentEnrichmentConfiguration
• Remove-SPEnterpriseSearchContentEnrichmentConfiguration
• New-SPEnterpriseSearchContentEnrichmentConfiguration

Tabelle 1 enthält die Eigenschaften, die Sie über die weiter oben erwähnten Windows PowerShell-Cmdlets konfigurieren können.

Tabelle 1. Eigenschaften, die mit Windows PowerShell Cmdlets für den Client konfigurierbar sind

Gewusst wie: Auflisten aller schreibgeschützte verwaltete Eigenschaften für den Webdienst Inhaltserweiterung

Bestimmte verwalteten Eigenschaften sind schreibgeschützt und können nicht aus dem Webdienst ausgegeben werden. Diese Eigenschaften können mithilfe der Cmdlets Get-SPEnterpriseSearchServiceApplication und Get-SPEnterpriseSearchMetadataManagedProperty Windows PowerShell aufgelistet werden, wie im folgenden Beispiel gezeigt:

$ssa = Get-SPEnterpriseSearchServiceApplication
Get-SPEnterpriseSearchMetadataManagedProperty -SearchApplication $ssa  | ?{$_.IsReadOnly -or $_.MappingDisallowed -or $_.DeleteDisallowed}

Informationen zu Trigger Bedingungen für die Konfiguration des Webdienst-callout

Eine Triggerbedingung ist ein Ausdruck, der zum Konfigurieren der Webdienst-Legende verwendet wird. Wenn eine Triggerbedingung als true ausgewertet wird, führt der Webdienstclient eine Legende für diesen Datensatz aus. Wenn eine Triggerbedingung als false ausgewertet wird, führt der Webdienstclient keine Legende aus und übergibt das durchforstete Element an den Suchindex. Alternativ, wenn keine Triggerbedingung konfiguriert ist; alle Elemente werden an den Webdienst gesendet.

Trigger verwendet eine Ausdruckssprache verweisen auf die Werte der verwalteten Eigenschaften. Sie können Operatoren und Funktionen in der Ausdruckssprache verwenden, einfache oder komplexe Trigger Conditions erstellen, damit Sie ermitteln können, wenn ein Webdienst-Callout ausführen.

Tabelle 2 enthält Beispiele für Trigger Bedingungen.

Tabelle 2. Triggerbedingungsbeispiele für die Konfiguration des Webdiensts "Inhaltsanreicherung"

Unter Triggerausdruckssyntax in SharePoint finden Sie die Elemente, die in einem Triggerausdruck verwendet werden können, und eine Liste der unterstützten Funktionen.

Implementieren den externen Webdienst Inhaltserweiterung

Führen Sie für eine einfache Implementierung folgende Schritte aus:

1. Enthalten Sie die Microsoft.Office.Server.Search.ContentProcessingEnrichment.dll befindet sich im C:\\Program Files\\Microsoft Office Servers\\15.0\\Search\\Applications\\External in Ihrem Projekt als Referenz.
2. Implementieren Sie IContentProcessingEnrichmentService als Webdienst.

Siehe auch

• Konfigurieren der Suche in SharePoint
• Benutzerdefinierte Inhaltsverarbeitung mit dem Webdienstpopup zur Inhaltsanreicherung