Handbuch:Erweiterung/BlueSpiceExtendedSearch

Die Erweiterung ExtendedSearch ersetzt die standardmäßige MediaWiki-Suchmaschine. Die Erweiterung basiert auf OpenSearch (bis BlueSpice 4.3 auf Elasticsearch) und bietet viele Verbesserungen gegenüber der Standard-MediaWiki-Suche, sowohl hinsichtlich der Qualität des indizierten Inhalts als auch der Benutzeroberfläche. Seiten und Dateien werden sofort indiziert und sind daher ohne Verzögerung für die Suche verfügbar.

Funktionen

Mit der erweiterten Suche erlaubt die Suche über zwei verschiedene Möglichkeiten, nämlich über:

1. Titelsuche über die automatische Vervollständigung (auto-complete).
2. Volltextsuche über das Such-Center.

Die erweiterte Suche durchsucht:

• Wiki-Seiten: Alle Inhaltsseiten mit Ausnahme der Seiten im MediaWiki Namensraum.
• Spezialseiten: Alle Seiten im Namensraum Spezial.
• Hochgeladene Dateien: Dateien, die im Wiki gepflegt werden - für Textdateien wie Word-Dokumente und PDFs umfasst dies auch Inhalt und Metadaten.
• Externe Dateien: Dateien von beliebigen Speicherorten aus zugänglichen Speicherpfaden (z. B. auf zugemounteten Laufwerken)
• Soziale Entitäten: Entitäten (Seiten), die von der Erweiterung BlueSpiceSocial erstellt wurden, z. B. Blog-Beiträge und Benutzerprofile.

Automatische Vervollständigung

Sobald Sie beginnen, den Suchbegriff in die Suchleiste des Wikis einzutippen, öffnet sich unter der Suchleiste eine Liste mit Treffern. Die automatische Vervollständigung zeigt die 7 besten Matches von Seitentiteln und Dateinamen. Hier wird noch keine Volltextsuche durchgeführt.

Popup für automatische Vervollständigung

Die Ansicht ist standardmäßig in zwei Spalten unterteilt. Dies kann von einem Administrator auf eine Spalte reduziert werden.

Linke Spalte:

Primärergebnisse, die direkt mit dem Suchbegriff übereinstimmen. Die Übereinstimmung wird fett hervorgehoben.

Rechte Spalte:

• Schaltfläche zum Erstellen der Seite mit dem aktuellen Suchbegriff als Titel (nur wenn der Benutzer die Berechtigung zum Erstellen neuer Seiten hat)
• Schaltfläche zum Ausführen der Volltextsuche für den aktuellen Begriff. Wenn Sie diese Option auswählen, wird die SearchCenter-Seite aufgerufen.

• Übereinstimmungen, die nicht direkt mit dem angegebenen Begriff übereinstimmen, aber für den Benutzer relevant sein könnten. Unter folgenden Voraussetzungen:
  • Wenn für einen ähnlichen Begriff wesentlich mehr Übereinstimmungen vorliegen als der tatsächlich gesuchte Begriff (z.B. bei einem Tippfehler)
  • Wenn ein Namensraum oder eine Unterseite vorhanden ist. In diesem Fall zeigen sekundäre Ergebnisse direkte Übereinstimmungen in anderen Namensräumen/Seiten.

Auto-complete "Pillen"

Die Suchleiste für die automatische Vervollständigung unterstützt sogenannte Pillen für Namensraum und Unterseiten.

"Pillen"-Funktion

Wenn ein Benutzer zum Beispiel "Handbuch:" eingibt, wird eine Pille für den Namensraum "Handbuch" erstellt und ein eingegebener Begriff nur im Namensraum "Handbuch" gesucht.

Unterseitenpillen funktionieren auf die gleiche Weise. Wenn der Benutzer "Seitenname/" eingibt, wird jeder danach angegebene Begriff im Kontext dieser Seite abgeglichen. Wenn Sie z.B. nach "TestSeite/Te" suchen, werden nur Unterseiten von "TestSeite" gefunden, deren Titel "Te" enthält, z.B. "TestSeite/Test" und "TestSeite/TestUnterseite".

Datumssuche

Die (Titel-)Suche erkennt gewisse Datumsformate und im Such-Center werden diese mit Anführungszeichen umgeben.

• 

  Datumsformat 1

• 

  Datumsformat 2

Such-Center (erweiterte Suche)

Sobald Sie die Suche über das Lupen-Symbol oder die Return-Taste auslösen, wechseln Sie in das Such-Center. Dies ist eine spezielle Seite, die die volle Funktionalität der Suche bietet. Die Suche im Such-Center erfolgt über die gleiche Suchleiste, die auch für die automatische Vervollständigung verwendet wird. Hier wird nun jedoch eine Volltextsuche durchgeführt, die auch die Metadaten von Dokumenten miteinbezieht. Die Suchmaschine durchsucht hierbei nicht den Wikitext einer Wikiseite, sondern den vom Browser ausgegebenen Inhalt.

Such-Center

Suchoperatoren

Wichtig!Suchoperatoren funktionieren nur im Such-Center (Volltextsuche). In der Titelsuche können keine Suchoperatoren angegeben werden.

Wenn Sie nach zusammenhängenden Wörtern suchen, sollten diese aus Performanzgründen in Anführungszeichen (") gesetzt werden, um eine eindeutige Suche zu unterstützen.

Die Suchoperatoren müssen in Großbuchstaben und in englischer Bezeichnung geschrieben werden.

AND

• Qualität AND Doku: Gibt Seiten zurück, die sowohl den genauen Begriff Qualität als auch den genauen Begriff Doku enthalten.
• Qualität* AND Doku: Wenn auch Qualitätswerkzeug berücksichtigt werden soll, geben Sie einen "Wildcard"-Stern mit an.

Vergleiche: Die Suche Qualität Doku ist automatisch eine Wildcard-Suche und liefert alle Seiten, die sowohl Qualität* als auch Doku* enthalten. Sie liefert im Normalfall somit mehr Ergebnisse als die Suche Qualität* AND Doku (da hier die genau Bezeichnung Doku gesucht wird).

" (Anführungszeichen)

Anführungszeichen bei einem Suchbegriff lösen entsprechend eine AND Suche für alle Begriffe aus:

• "Qualität" Doku: gleiches Ergebnis wie Qualität AND Doku (d.h. auch Doku wird präzise gesucht).

NOT

• Qualität* NOT Doku*: Gibt Seiten zurück, die mit Qualität beginnende Wörter enthalten, aber nicht mit Doku beginnende Wörter.

OR

• Qualität OR Doku: Gibt Seiten zurück, die entweder den genauen Begriff Qualität oder den genauen Begriff Doku enthalten.

* (wildcard)

• Qualität*: Gibt Seiten zurück, die Wörter enthalten, die mit dem Begriff Qualität beginnen.

Elemente im Such-Center

• Trefferanzahl: Zeigt an, wie viele Treffer eine Suche zurückgegeben hat. Dies kann ungefähr oder genau sein. Die Annäherung beruht auf der dynamischen Überprüfung der Berechtigungen zum Anzeigen der einzelnen Seiten in den Ergebnissen. Einige Ergebnisse werden dem Benutzer möglicherweise nicht angezeigt, wenn das Ereignis mit seinen entsprechenden Berechtigungen nicht übereinstimmt.
• Werkzeuge: Diese befinden sich oben rechts und repräsentieren eine Reihe von Schaltflächen zum Verwalten der Suchergebnisse.
  • Beim Erstellen einer Seite - dargestellt durch ein "Plus"-Symbol - wird eine Seite mit dem aktuellen Suchbegriff als Titel erstellt (nur sichtbar, wenn der Benutzer die Berechtigung zum Erstellen von Seiten hat).
  • Filter hinzufügen - dargestellt durch ein "Trichter"-Symbol - öffnet ein Dialogfeld, in dem der Benutzer den Filtertyp auswählen kann, der auf die Suche angewendet werden soll.
  • Suchoptionen - dargestellt durch ein "Zahnrad"-Symbol - öffnen ein Dialogfeld, in dem der Benutzer die Einstellungen für die aktuelle Suche ändern kann. Es bietet Optionen wie Anzahl der Ergebnisse pro Seite, Sortierfeld und Reihenfolge.
    
    

    Optionsdialog
  • Suche exportieren - dargestellt durch das Symbol "Exportieren" - öffnet einen Dialog zum Exportieren der aktuellen Suchergebnisse auf eine bestimmte Seite.
    
• Filter: Filter werden in Form von Pillen unterhalb der Trefferanzahl angezeigt. Jede Filterpille repräsentiert ein anderes Attribut, nach dem Suchergebnisse gefiltert werden können. Filterwerte können geändert werden, indem Sie auf die Filterpille klicken und die gewünschten Optionen aus dem sich öffnenden Popup auswählen. Der Filter kann durch Klicken auf die Schaltfläche "x" rechts neben jeder Pille entfernt werden.
  
  

  Bearbeitungsfilter
• Ergebnisse: Wenn die aktuellen Suchkriterien Ergebnisse liefern, wird eine Ergebnisliste unter den Filtern angezeigt. Im Ergebnis verfügbare Informationen sind (je nach Ergebnistyp):
  • Haupttitel des Ergebnisses (Seitentitel, Dateiname ...)
  • Ergebnistyp
  • Größe und Erweiterung (für Dateien)
  • Miniaturbild (für Bilder) oder Dateitypsymbol (für andere Dateitypen)
  • Weiterleiten von Informationen (für Wikiseiten, wenn es sich bei der Seite um eine Weiterleitung zu einer anderen Seite handelt)
  • Ursprünglicher Name (für Wikipages, wenn der Seitentitel vom tatsächlichen Seitentitel abweicht)
  • Sekundäre Informationen wie Wikipages, Kategorieseite, Änderungs- und Erstellungsdatum, Autor ...
  • Ausschnitt der Übereinstimmungen im Inhalt der Seite (wenn es Übereinstimmungen im Seiteninhalt gibt),

Wenn für einen bestimmten Suchbegriff eine exakte Übereinstimmung vorliegt, wird das Ergebnis, das genau übereinstimmt, als "hervorgehobenes" Ergebnis angezeigt. Dieses Ergebnis zeigt ein Vorschaubild der Seite an und zeigt immer einen Inhaltsausschnitt an, unabhängig davon, ob der Inhalt Übereinstimmungen enthält oder nicht.

Ergebnisrelevanz

Alle angemeldeten Benutzer können bestimmte Ergebnisse als "Favoriten" markieren, indem sie auf das Stern-Symbol in der oberen rechten Ecke der Ergebnisse klicken. Dateien, die als "Favoriten" markiert sind, werden bei zukünftigen Suchvorgängen höher bewertet. Die Relevanzeinstellungen eines Benutzers wirken sich nicht auf die Suche anderer Benutzer aus. Wenn ein Benutzer das Ergebnis als "Favorit" markiert, wird es nur für diesen Benutzer und nicht für einen der anderen Benutzer höher gewertet. Sie können die Markierung der Ergebnisse als "Favorit" aufheben, indem Sie erneut auf das Sternsymbol klicken.

Suchergebnisse exportieren

Nach dem Ausführen der Suche können Benutzer mit Adminrechten die Ergebnisse mithilfe des Befehls "Exportieren" aus dem Menü "Extras" auf eine bestimmte Seite exportieren (speichern). Im Exportdialog kann der Benutzer den Namen für die Liste eingeben, das Format auswählen und angeben, ob die eventuell vorhandene Liste überschrieben oder an die Liste angehängt werden soll. Die Liste wird nach MediaWiki:PageCollection/LISTENNAME exportiert.

Es werden nur gültige Wikiseiten exportiert. Die in einer Liste enthaltenen Seiten können in der Buchfunktion über Massenimport > Quelle: Seitensammlung in ein Buch mit aufgenommen werden.

Export-Dialog

Konfiguration

In der Konfigurationsverwaltung, unter Einstellungen für die Erweiterung BlueSpiceExtendedSearch, stehen folgende Konfigurationsoptionen zur Verfügung:

• Externe Dateipfade: Externe Speicherorte, von denen aus nach Dateien gesucht und indiziert werden soll. Diese Speicherorte werden in Schlüssel/Wert-Paaren aus physischem Pfad und URL-Präfix eingegeben.
  • Physischer Pfad: Speicherpfad, der mit dem Wiki verlinkt ist. Für gemountete Laufwerke, zum Beispiel: X:\Documents URL-Präfix: Alle Dateien, die vom indizierten physischen Speicherort aus indiziert wurden, werden in den Suchergebnissen mit einem Präfix versehen. Es sollte verwendet werden, wenn Dateien von einem Webserver verfügbar sind.

Wichtig!Verrechtung:

Die Dateirechte werden hierbei dem Apache-User gegeben. Bei der Einbindung von Netzwerk-Dateien in die Suche erfolgt keine Verrechtung über die einzelnen Benutzerrechte des Wikis!

Datenvolumen: Da die Suche den gesamten freigegebenen Bereich indexieren muss, ist es ratsam, einzelne Ordner direkt zu verknüpfen anstelle übergeordnete Verzeichnisse zu verwenden.

Beispiele für externe Dateipfade

Beispieldatei	Physik. Pfad	URL Präfix	Link in Ergebnisliste
S:\Vertrieb\Info\Glossar.pdf	S:\	file:///S:/	file:///S:/Vertrieb/Info/Glossar.pdf
		https://sharepoint/Vertrieb/ Dokumente/	https://sharepoint/Vertrieb/ Dokumente/Vertrieb/Info/Glossar.pdf
		https://intranet/showdocs inline.aspx?path=	https://intranet/showdocsinline.aspx? path=/Vertrieb/Info/Glossar.pdf
/var/www/bluespice/w/mounted_ share/Vertrieb/Info/Glossar.pdf	/var/www/bluespice/w/ mounted_share/		https://wiki.company.local/w/mounted_ share/Vertrieb/Info/Glossar.pdf

Dateipfad hinzufügen: (1) mit Häckchen bestätigen und (2) "Speichern" klicken.

• Einfache Autovervollständigung verwenden: erzwingt eine kompaktere Autovervollständigung (1-Spalten-Layout, keine Miniaturvorschau).
  
  

  kompakte Autovervollständigung
• Automatisch eingestellter Sprachfilter: Gibt nur Seiten zurück, deren Seitensprache (PageLanguage) identisch mit der Benutzersprache (Language) ist. Benutzer können ihre Sprache in ihren Benutzereinstellungen einstellen. Standardmäßig ist die Seitensprache von Inhaltsseiten die Sprache, in der das Wiki installiert wurde (ContentLanguage). Einige Erweiterungen können die Sprache einzelner Seite unabhängig von der Wiki-Installationssprache definieren. (Siehe: https://www.mediawiki.org/wiki/Manual:Language#Page_content_language). In vielen Wikis hat diese Einstellung kaum eine Auswirkung auf die Suchergebnisse.
• Muster ausschließen: Dateien an externen Speicherorten können aufgrund von Mustern mit regulären Ausdrücken von der Suche ausgeschlossen werden.

Sucheinstellungen

Sucheinstellungen (Spezial:Sucheinstellungen) ist eine spezielle Seite für Wiki-Administratoren. Diese Seite enthält Statistiken zu den in der Suche indizierten Dokumenten.

Im Wiki abgetrennter Bereich, dessen Inhalte über spezielle Berechtigungen gelesen und bearbeitet werden können. Einen Namensraum erkennt man an einem Präfix vor dem Artikeltitel.

Automatisch generierter Inhalt, der Übersichten oder verschiedene Möglichkeiten für die Verwaltung und Pflege des Systems bietet. Zudem gibt es auch Spezialseiten mit Funktionen und Informationen für Benutzer.

Formatierungssprache für Wikiseiten. Der Wikitext kann im Quelltextmodus angesehen und bearbeitet werden.

Eine Weiterleitung hilft, Duplikate und inhaltlichen Wildwuchs zu vermeiden. Weiterleitungen werden z.B. für Seiten eingerichtet, deren Inhalte veraltet sind, die nicht mehr gebraucht werden oder mit den Inhalten anderer Seiten übereinstimmen. Sie verweisen in der Regel auf die aktuellste Beschreibung eines Themas und vermeiden unnötige Arbeit im Fall von Ab-kürzungen, Synonymen, Plural/Singular-Duplikaten, Umbenennungen oder Verschiebungen.

Ein Uniform Resource Locator (Abk. URL; englisch für „einheitlicher Ressourcenverorter“) identifiziert und lokalisiert eine Ressource, beispielsweise eine Webseite, über die zu verwendende Zugriffsmethode (zum Beispiel das verwendete Netzwerkprotokoll wie HTTP oder FTP) und den Ort (englisch location) der Ressource in Computernetzwerken.

Protokoll zur Verschlüsselung und Authentifizierung der Kommunikation zwischen Webserver und Browser im World Wide Web.

Technische Referenz: BlueSpiceExtendedSearch

---

Feedback zur Dokumentation ist im Community-Forum möglich.