Best Bets Connector

Installation und Konfiguration

Installation

Vor der Installation des Best Bets Konnektors muss sichergestellt werden, dass der Mindbreeze Server installiert und der Best Bets Konnektor in der Lizenz inkludiert ist. Zur Installation oder Aktualisierung des Konnektors verwenden Sie bitte das Mindbreeze Management Center.

Installation des Plugins via Mindbreeze Management Center

Zur Installation des Plugins, öffnen Sie das Mindbreeze Management Center. Wählen Sie aus dem linken Menü den Punkt „Configuration“ aus. Anschließend navigieren Sie auf den Reiter „Plugins“. Im Abschnitt „Plugin Management“ wählen Sie die entsprechende Zip-Datei aus laden sie durch Auswahl der Schaltfläche „Upload“ hoch. Damit wird der Konnektor automatisch installiert oder gegebenenfalls aktualisiert. In diesem Zuge werden die Mindbreeze Dienste neugestartet.

Konfiguration von Mindbreeze

Wählen Sie zur Konfiguration die Installationsmethode „Advanced“.

Konfiguration von Index und Crawler

Konfiguration des Index

Navigieren Sie auf den Reiter „Indices“ und klicken Sie auf das Symbol „Add new index“ rechts oben, um einen neuen Index zu erzeugen. Alternativ kann das Plugin „BestBets-Config“ installiert werden, welches die weitere Konfiguration automatisch durchführt.

Geben Sie den Pfad zum Index ein und ändern Sie gegebenenfalls den Display Namen.

Grundkonfiguration des Crawlers

Fügen Sie eine neue Datenquelle durch Klick auf das Symbol „Add new custom source“ rechts oben hinzu. Wählen Sie die Category „BestBets“ und konfigurieren Sie die Datenquelle nach Ihren Bedürfnissen. Unter den CSV Settings kann das gewünschte, auf der Appliance gespeicherte CSV File ausgewählt und das Trennzeichen für die einzelnen Zeileneinträge angegeben werden.  Unter den Metadata Settings kann angegeben werden, welche Spalten des CSV Informationen als Liste beinhalten und welches Trennzeichen für die einzelnen Einträge der Liste verwendet wird.

Zusätzliche Metadaten

Mit „Additional Metadata“ können Sie weitere Metadaten für die Best Bets Dokumente definieren. Das Attribut „Name“ ist der Name des Metadatums, „Value“ stellt den Wert des Metadatums dar. Metadatumswerte können Platzhalter für bestehende CSV Felder enthalten, z.B. {{URL}}. Diese Platzhalter werden ersetzt durch die referenzierte CSV-Felder.

Konfiguration der vorgeschlagenen Seiten

Im Management Center, unter Search Experience -> Suggested Sites, befindet sich ein CSV mit Informationen darüber, welche Ergebnisse mit welchen Suchverhalten unter den Best Bets aufgelistet werden (Falls das BestBets-Config Plugin verwendet wurde).

Wenn die Bearbeitung abgeschlossen ist, werden bei einer passenden Suche der Title verlinkt mit der URL, der OrganizationName und der OrganisationalUnitName angezeigt. In der Searchable Spalte kann zusätzlich (durch Beistrich getrennt) angegeben werden, welche Spalten für die Suche verwendet werden sollen. Dazu müssen lediglich die Namen der Spalten angegeben werden, die durchsuchbar sein sollen. Zusätzlich kann in der Spalte Upload ein Icon hinzugefügt werden.

„KeyMatch“ Suche für BestBets

Wenn der „KeyMatch“ Modus aktiv für die BestBets Datenquelle aktiv ist, müssen in der BestBets CSV Datei für alle Dokumente die folgende zwei Spalten definiert und ausgefüllt werden: „SearchTerm“ und „MatchType“. Die „SearchTerm“ Spalte beinhaltet Suchbegriffe die das BestBets Dokument als Ergebnis liefern. „MatchType“ definiert wie die definierten Suchbegriffe mit der Suche übereinstimmen sollen. Drei Varianten werden unterstützt:

ExactMatch: die Suche muss exakt gleich sein mit den Suchbegriffen in „SearchTerm“ definierten Suchbegriffen

PhraseMatch: der Suchbegriff muss in der Suche als direkter Substring vorkommen. Die Reihenfolge muss übereinstimmen und es dürfen keine anderen Wörter dazwischen sein.

z.B: SearchTerm: it security

Suche „mindbreeze it security“ und „it security mindbreeze“ liefert das Dokument aber „it network security“ oder „security it“ nicht.

KeywordMatch: alle Wörter aus SearchTerm müssen in der Suche enthalten sein

KeyMatch Suche Aktivieren

Wichtig: damit die KeyMatch Suche funktioniert, darf im Index nur eine BestBets-Datenquelle vorhanden sein.

Um die KeyMatch Suche für den BestBets Index verwenden zu können stellen Sie sicher, dass der BestBets Query Transformation Service aktiviert ist. Beachten Sie, dass der BestBets Query Transformation Service NICHT unter Global Index Settings konfiguriert werden darf sondern direkt am Index der BestBets-Datenquelle konfiguriert werden muss:

Als „BestBets CSV Path“ sollte das gleiche CSV File konfiguriert werden wie in der BestBets Datenquelle.

Als „Best Bets Column Separator“ sollte das gleiche Trennzeichen konfiguriert werden wie in der BestBets Datenquelle.

Mit den Optionen „Search Term Column Name“ und „Match Type Column Name“ können die CSV Spaltennamen für KeyMatch Suchbegriffe bzw. KeyMatch Match-Typen gesetzt werden. Diese Spalten müssen im BestBets CSV als durchsuchbar markiert sein, entweder im CSV mit der Spalte „Searchable“ oder „Searchable“ gesetzt als Zusätzliches Metadatum (Additional Metadata).

Ein Beispiel für BestBets CSV mit KeyMatch Suche ist:

Icon;Title;URL;Description;OrganizationName;OrganisationalUnitName;Searchable;SearchTerm;MatchType

;2018 Calendar 1;http://mycompany.com/2018calendar/;Calendar of 2018;Organization;Unit;SearchTerm,MatchType;calendar;ExactMatch

;2018 Calendar 2;http://mycompany.com/2018calendar/;Calendar of 2018;Organization;Unit;SearchTerm,MatchType;calendars;ExactMatch

;2018 Calendar 3;http://mycompany.com/2018calendar/;Calendar of 2018;Organization;Unit;SearchTerm,MatchType;2018 calendar;KeywordMatch

;IT Security;http://mycompany.com/itsecurity/;IT Security;Organization;Unit;SearchTerm,MatchType;IT Security;PhraseMatch

Die Spalten „SearchTerm“ und „MatchType“ sind im CSV mit „Searchable“ durchsuchbar markiert: SearchTerm,MatchType.

Wenn in den Spalten „SearchTerm“ und „MatchType“ keine Werte gesetzt ist, wird die Standardsuche für die BestBets Datenquelle verwendet.

Troubleshooting

Problem: BestBets werden nicht angezeigt

• Falls Sie das „KeyMatch“ Feature nicht benutzen wollen, stellen Sie sicher, dass im BestBets CSV die Spalten „SearchTerm“ oder „MatchType“ nicht existieren oder komplett leer sind.
• Falls Sie das „KeyMatch“ Feature benutzen, stellen Sie sicher, dass im BestBets CSV die Spalten „SearchTerm“ und „MatchType“ existieren und jeder Eintrag valide Werte beinhaltet.

• Stellen Sie sicher, dass der BestBets Crawler konfiguriert ist und seit der letzten Änderung des BestBets CSVs einen erfolgreichen Crawl-Run durchgeführt hat.
• Stellen Sie sicher, dass der BestBets Query Expression Transformator konfiguriert ist und keine Fehlermeldungen zeigt.