Text zur neuen Objektsuche in musdb hinzugefügt

src/SUMMARY.md

@@ -86,6 +86,7 @@
     - [Benutzerdefinierte Bearbeitungsoberfläche]()
   - [Objektdaten durchsuchen]() <!-- (./musdb/Objektsuche/README.md) -->
     - [Objekte mit Filtern durchsuchen](./musdb/Objektsuche/Filtern.md)
+      - [Abfragesprache](./musdb/Objektsuche/Abfragesprache.md)
     - [Merkliste](./musdb/Objektsuche/Merkliste.md)
     - [Stapelbearbeitung](./musdb/Objektsuche/Batch/README.md)
       - [Zuordnung per Auswahl]() <!-- (./musdb/Objektsuche/Batch/Zuordnung-per-Auswahl.md)-->

src/musdb/Objektsuche/Abfragesprache.md

@@ -0,0 +1,31 @@
+# Abfragesprache
+
+Die Objekt-Suchfunktion funktioniert auf Basis einer eigenen Abfragesprache. Suchanfragen, die über die graphische Oberfläche erstellt wurden, werden zuerst in diese Abfragesprache übersetzt und dann an den Server geschickt, wo sie wiederum in tatsächliche Datenbankabfragen übersetzt werden.
+
+Durch diese eigene Abfragesprache wird einerseits die Sicherheit erhöht - nur die vorgesehenen Suchmöglichkeiten werden übersetzt - und gleichzeitig ist es durch die Einfachheit der Abfragesprache möglich, als Benutzer auch selbst schnell kompliziertere Abfragen zu schreiben.
+
+## Grundlegende Logik
+
+Die grundlegende Logik der Such-Abfragesprache lässt sich am besten mit einem Beispiel erklären. Eine Suchabfrage mit drei zusammengesetzten Suchbedingungen mag etwa `Foto tag:132 -place:61 -name:München -length:>1000` sein. Wie im Beispiel zu sehen, werden einzelne Suchbedingungen durch ein Leerzeichen getrennt. Damit besteht eine einzelne Suchbedingung aus bis zu vier Elementen.
+
+Alle vier Elemente sind im Beispiel `-length:>1000` zu sehen:
+
+- **-**: Der Präfix "-" bestimmt, dass es sich um eine negative Suche handelt. _Suche Objekte, die nicht..._
+  Standardmäßig - also, wenn kein Präfix gesetzt ist - wird nach Objekten gesucht, die den Suchbegriff enthalten. Andere mögliche Präfixe sind "~" für "oder" und "=" für exakt.
+- **length**: Die Kategorie vor dem Doppelpunkt bestimmt, in welchem Feld die Suche durchgeführt wird.
+  Um eine Liste der verfügbaren Kategorien zu bekommen, ist es am einfachsten, mit dem Menü "Suche verfeinern" zu arbeiten, und sich dann die erstellte Suchabfrage anzuschauen. Ist die Kategorie nicht gesetzt, wird eine Volltextsuche durchgeführt (Die Suche nach `Foto` ist also eigentlich eine Volltextsuche).
+  Nach der Kategorie folgt ein Doppelpunkt.
+- **>**: Nach dem Doppelpunkt können die Zeichen `[` und `>` eingegeben werden, um nach Objekten mit einem Wert kleiner oder größer als dem eingegebenen zu suchen.
+- **1000**: Als letztes folgt der Suchbegriff selbst. Wie im Falle von `-place:61` ("ohne Bezug zum Ort Berlin") zu sehen, werden Schlagworte, Orte, Akteure und Schlagworte hier mit ihrer ID eingetragen (deshalb lohnt es sich bei diesen, die verfügbaren Auswahllisten zu benutzen und die Suchbedingung nicht händisch einzugeben).
+
+Die Beispielabfrage `Foto tag:132 -place:61 -name:München -length:>1000` bedeutet also:
+
+- Suche im Volltext nach "Foto"
+- Die Objekte müssen einen Bezug zum Tag 132 (_Fotographie_) haben, oder zu einem diesem untergeordneten Schlagwort (Objekte mit Bezug zu _Carte de Visite_ würden also auch gefunden)
+- Die Treffer dürfen keinen Bezug zum Ort 61 (_Berlin_) oder einem untergeordneten Ort haben
+- Im Objektnamen darf "München" nicht enthalten sein
+- Und schließlich dürfen die Objekte nicht länger als 1000 mm (also einen Meter) lang sein.
+
+## Beschränkungen
+
+Um eine negative Suche nach Texten (also z.B. eine Volltextsuche nach Objekten ohne das Wort "Helm") durchzuführen, muss schon eine "positive" Suchbedingung nach einem Text-Teil gesetzt sein.

src/musdb/Objektsuche/Filtern.md

@@ -1,4 +1,4 @@
-Arbeiten mit Filtern
+Objekte mit Filtern durchsuchen
 ====================
 
 Was sind Filter?
@@ -31,65 +31,80 @@ anzeigen, ausdrucken oder exportieren.
 Wie wird ein Filter erstellt?
 -----------------------------
 
+Filter werden in musdb primär über die Suchleiste ganz oben in der Objektübersicht gesteuert. Die Leiste besteht aus fünf Bereichen:
+
+- Ganz links wird die Gesamtanzahl der gefundenen Objekte angezeigt.
+- Ein großes Feld bietet Platz, um vorhandene Filterbedingungen anzuzeigen. Im linken Abschnitt dieses Feldes findet sich aber auch ein Eingabeschlitz, um schnell Suchbedingungen händisch einzugeben.
+- Ein "Auge"-Symbol schaltet die Anzeige der gesetzten Filter um, sodass man die Suchbedingungen in der zugrundeliegenden Abfragesprache sehen und manipulieren kann. So lassen sich etwa mehrere Bedingungen gleichzeitig hinzufügen oder entfernen - und die Eingabe ist wesentlich schneller, wenn man einmal mit der Abfragesprache vertraut ist.
+- Der Button "Suche verfeinern" bietet die Möglichkeit, einen Filter über ein graphisches Menü und mithilfe von Auswahllisten zu setzen.
+- Der Button "Suchen" schickt die Eingabe einer neuen Suchbedingung ab.
+
+### Overlay: Eine Suchbedingung einstellen
+
+Klickt man in der Suchleiste auf "Suche verfeinern" öffnet sich ein Overlay, mit dem man eben das tun kann. Standardmäßig sind vier Auswahl- bzw. Eingabefelder zu sehen:
+
+- Mit dem ersten Auswahlfeld wird die **Beziehung der zu erstellenden Suchbedingung zu den schon vorhandenen bestimmt**. Je nach Vorhandensein von schon gesetzten Suchbedingungen sind hier "_und_", "_oder_" und "_nicht_" auswählbar.
+- Mit dem zweiten Auswahlfeld wird bestimmt, **wonach gesucht wird**. Ist diese Suche eine Suche nach einer Person, nach der Inventarnummer, oder ist es eine Volltextsuche.
+- Mit dem dritten Auswahlfeld lassen sich die **Beziehung des Suchbegriffs zum gesuchten Bestimmen**. Standardmäßig ist dies "_enthält_". Wird also nach "Deutschland" gesucht, werden auch Objekte gefunden, die mit "Berlin" verknüpft sind. Mit der Einstellung "_exakt_" würden nur Objekte gefunden, die direkt mit dem Ortseintrag "Deutschland" verknüpft sind. Die Auswahl "größer als" und "kleiner als" ist besonders bei Suchen nach Maßangaben (etwa, wenn man nach Objekten sucht, die in eine Vitrine passen).
+- Das vierte Feld ist der Eingabeschlitz, in den man den Suchbegriff eingibt. Soll gerade in einem Feld gesucht werden, das auf Basis von kontrollierten Listen von Begriffen arbeitet (z.B. Orte, Schlagworte und Personen, aber auch Lizenzangaben), erscheinen entsprechende Vorschläge in einer Seitenspalte rechts. Der Suchbegriff kann dann durch einen Klick auf den entsprechenden Vorschlag ausgewählt werden.
+
+Sind alle diese Felder ausgefüllt, kann die Suchbedingung mit einem Klick auf den "Abschicken"-Button gesetzt werden.
+
+Um eine weitere Suchbedingung hinzuzufügen, wenn man also z.B. nach Objekten sucht, die etwas mit Hamburg zu tun haben UND in der Fotosammlung des Hauses sind, kann man die zweite Suchbedingung auf die gleiche Art und Weise hinzufügen.
+
+### Suchbedingungen ansehen und entfernen
+
+Ist eine Suchbedingung gesetzt, so erscheint diese als Box im großen mittleren Feld. Jede wird mit den folgenden Komponenten angezeigt:
+
+Zuerst wird, so die Art der Suche nicht eine "enthält"-Suche ist, ein Marker, um auszudrücken wie die Suche arbeitet: Ein Minus (-) zeigt eine Suche nach "nicht X" an. Ein Gleich-Zeichen (=) weist auf eine exakte oder exklusive Suche hin. Die Zeichen für "größer als" (>) und "kleiner als" (<) zeigen an, dass nach eben diesen Logiken gefiltert wird.
+
+Der nächste Unterbereich zeigt das Feld an, in dem gesucht wurde (bzw., dass es sich um eine Volltextsuche handelt). Durch einen Klick auf dieses Feld lässt sich die Kategorie der Suchbedingung eingeschränkt umschalten: Ist die Suche bisher eine nach dem Objektnamen, wird einem eine Volltextsuche nach vorgeschlagen. Ist der bisher gesetzte Suchbegriff als Schlagwort bekannt, wird eine Schlagwortsuche ebenso vorgeschlagen. Wichtig ist, dass bei diesen Vorschlägen nur Volltextsuchen und Suchen nach Schlagworten, Orten, Zeiten, und Akteuren vorgeschlagen werden.
+
+Der letzte standardmäßig sichtbare Unterbereich ist eine Anzeige des Suchbegriffs selbst.
+
+Möchte man die Suchbedingung löschen, so muss man zuerst mit der Maus über die jeweilige Kachel fahren. Mit dem Überfahren der Kachel wird ein "X" am rechten Rand der Suchbedingungs-Anzeige sichtbar. Klick man darauf, ist die durch die Kachel repräsentierte Suchbedingung entfernt (möchte man alle Filter entfernen, kann man auf "Filter entfernen" [s.u.] oder ganz einfach oben in der Navigation auf "Objekt" klicken).
+
+Schneller Suchen: Gesonderte Eingabefelder für die Suche in einer Kategorie
+---------------------------------------------------------------------------
+
+Für verschiedene, besonders oft benötigte Suchkategorien gibt es eigene Eingabeschlitze auf der Objektübersicht, die einen schnelleren Einstieg in die Suche bieten:
+
+- Direkt unterhalb der Navigation findet sich eine Zeile mit zwei Eingabeschlitzen und einem Auswahlfeld. Über die Eingabeschlitze lassen sich die Objektnummer nach ihrer ID in museum-digital und nach ihrer Inventarnummer durchsuchen (_wichtig: bei Suchen nach der Inventarnummer sind auch Wildcards einsetzbar_). Über das Auswahlfeld können Objekte nach fehlenden Informationen gefiltert werden - etwa, alle Objekte, zu denen noch keine Abbildung hochgeladen wurde.
+- Direkt über den gefundenen Objekten findet sich eine Leiste, mit der (von links nach rechts)
+  - die Sortierung der Trefferliste einstellt werden kann,
+  - die Trefferliste zwischen ihren Listen- und Kachelmodi umgeschaltet werden kann,
+  - die Anzahl der Treffer in der Liste eingestellt werden kann,
+  - und die Trefferliste auf "nur veröffentlichte" oder "nicht veröffentlichte" Objekte eingegrenzt werden kann.
+- Die rechte Seitenspalte der Objektübersicht bietet je nach Berechtigungen des Benutzers Auswahllisten für das Filtern der Objekte nach Museen oder Sammlungen. Sind die Menüpunkte für Objektgruppen und Ausstellungen aktiviert (siehe "[Persönliche Einstellungen](../Benutzerkonto/Einstellungen.md#menüpunkte)"), erscheinen auch für diese Auswahllisten. Unterhalb der Auswahllisten gibt es Suchschlitze für das schnelle Filtern der Objekte nach Schlagworten, Zeiten, Orten und Akteuren.
+
+Zu guter Letzt lässt sich der versteckte Schnell-Suchschlitz der Suchleiste selbst benutzen: Wird hier einfach nur ein Wort eingegeben, wird eine Volltextsuche durchgeführt (bzw. als zusätzliche Suchbedingung hinzugefügt, falls schon ein Suchfilter gesetzt ist). Auch spezifischere Suchabfragen lassen sich so schnell machen, indem man die Suchabfrage direkt in der [Abfragesprache der Objektsuche](Abfragesprache.md) eingibt.
+
+Woran ist erkennbar, ob ein Filter aktiv ist? Und was kann man damit noch machen?
+---------------------------------------------------------------------------------
+
 ![Leiste auf Objektseite: Filter aktiv](../../assets/musdb/objects-list/filter_aktiv.png)
 
-Filter lassen sich im Objekt-Modus erstellen, d.h. immer dann, wenn der
-Karteikarten-Reiter "Objekt" in der oberen Menüleiste aktiv ist (und
-Sie nicht gerade ein neues Objekt eingeben). Der Objekt-Modus kennt
-(abgesehen von der Objekt-Eingabe) die Objekt-Auswahl und die
-Objekt-Bearbeitung. In der Objekt-Auswahl (Abb. 1) erscheinen am linken
-Rand eine Reihe von Eingabefeldern. Durch Einträge in diese Felder (und
-anschließendes Abschicken) aktivieren Sie einen Filter. Auch die
-"Sichtbare-Unsichtbare-Alle"-Anzeigen Schalter (oberhalb der
-Objektliste rechts) wirken auf die Filter. Schließlich finden Sie links
-unten den Schalter "Filter erstellen". Ein Klick hierauf öffnet einen
-Bildschirm mit weiteren Eingabefeldern für die Eingabe von
-Filterbedingungen (Abb. 2)
+Neben dem Erscheinen von gesetzten Suchbedingungen in der Suchleiste, lässt sich das Vorhandensein
+eines Filters in den Seitenspalten der Objektübersicht und der Objekt-Bearbeitungs-Seite sehen. Ist ein
+Filter gesetzt, erscheint hier ein fett geschriebener Schriftzug **"Filter aktiv"**. Neben dem Schriftzug
+finden sich Schalter zum Entfernen und Bearbeiten des Schriftzugs. Unterhalb des Schriftzugs werden
+verschiedene Optionen angeboten, um auf Basis des Filters mit der Trefferliste zu arbeiten:
 
+- **"Treffer zeigen"** (erscheint nur im (Einzel-) Objekt-Bearbeitungsfenster)  und führt zur gefilterten Trefferliste)
+- [**"Treffer auflisten"**](./Listendruck.md) ruft die Listendruck-Funktion für die Treffermenge auf (für einen Export der Daten als Excel-Liste und das tabellarische Anzeigen der Treffer)
+- [**"Treffer exportieren"**](./Export.md) ruft die Export-Funktion auf Basis der Treffermenge auf
+- [**"Treffer zuweisen"** und "**Globales Ändern**"](./Batch/) bieten Funktionen zur Massenbearbeitung auf Basis der Treffermenge.
 
-Einschränkungen: Im Augenblick können Sie in jedes Eingabefeld nur einen
-einzelnen Wert eintragen, es ist also nicht möglich alle Objekte zu
-suchen (filtern), für die gilt, dass *entweder* "Gemälde" *oder*
-"Fotografie (Lichtbild)" im Eingabefeld Objektart eingetragen ist oder
-alle Objekte die *sowohl* "Porträt" *als auch* "Schiller" im
-Objekttitel enthalten. Auch sind im Augenblick nur Filterbedingungen vom
-Typ "enthält Buchstabenkombination" oder "enthält ganzes Wort"
-möglich, d.h. unmöglich sind Suchen nach "Alle Objekte mit einem Wert
-*kleiner* 20 für Länge" oder nach "Alle Objekte bei denen *nicht*
-"Müller" im Feld Vorbesitzer steht". Ebenfalls ist es zur Zeit
-unmöglich festzulegen, ob man nur am Anfang oder nur am Ende eines
-Feldes suchen möchte. Unberücksichtigt bleiben auch Suchmöglichkeiten
-nach Groß- und Kleinschreibung.
-
-Woran ist erkennbar, ob ein Filter aktiv ist?
----------------------------------------------
-
-
-Ob ein Filter aktiv ist oder nicht, dass wird sowohl in der
-Objekt-Auswahl als auch in der (Einzel-)Objekt-Bearbeitung jeweils unten
-links angezeigt. Neben dem Hinweis "- Filter aktiv -" enthält dieses
-Hinweisfeld eine Auflistung der im Augenblick aktiven
-Filterbedingung(en). Unterhalb davon befindet sich ein kleines Menü:
-
-- "Treffer zeigen" (erscheint nur im (Einzel-) Objekt-Bearbeitungsfenster und führt zur gefilterten Trefferliste)
-- "Treffer auflisten" (ruft die Listendruck-Funktion für die Treffermenge auf)
-- "Treffer exportieren" (ruft die Export-Funktion auf Basis der Treffermenge auf)
-- "Filter ändern" (hier kann die Filterbedingung geändert werden) 
-- "Filter entfernen" (macht genau das, was es verspricht)
-
-Über dieses Menü können Sie die gefilterten Objektinformation jederzeit
-als Gruppe anzeigen, ausdrucken oder exportieren.
-
-In der (Einzel-)Objekt-Bearbeitungsansicht haben Sie oben links zwei
-blaue Dreiecke als Schaltflächen für "Gehe zu davorliegendem
+In der (Einzel-)Objekt-Bearbeitungsansicht haben Sie oben links zusätzlich
+zwei Schaltflächen für "Gehe zu davorliegendem
 Datensatz" und "Gehe zu folgendem Datensatz" zur Verfügung. Diese
 Navigationsmöglichkeiten stehen auch dann zur Verfügung, wenn kein
 Filter aktiv ist. Bei aktivem Filter wird hier allerdings zum vorigen
-(oder nächsten) Element der Treffermenge gesprungen. Um die Bearbeitung
+(oder nächsten) Element der gefilterten Treffermenge gesprungen. Um die Bearbeitung
 vieler Datensätze (die vorher über einen Filter zu einer Treffermenge
 gruppiert wurden) zu erleichtern, erscheinen ähnliche
 Navigationsschalter auch links und rechts des Abschicken-Buttons der
 Objekt-Basiseingabe. Änderungen dieser Basiseingaben können Sie durch
 Klicken auf diese Schalter bestätigen und werden dann gleich zum davor-
-oder danachliegenden Datensatz geleitet. (Abb. 4, unten rechts)
+oder danach liegenden Datensatz geleitet. (Abb. 4, unten rechts)