Die Allegra Query Language (AQL)#
Mit der Allegra Query Language (AQL) definieren Sie Filter, die auch eine Volltextsuche in allen Anhängen einbeziehen (HTML, Text, XML, OpenOffice, PDF, Excel, Word, PowerPoint).
AQL unterstützt direkte Suchen, unscharfe Suchen und Suchen nach benachbarten Begriffen.
Terme#
Ein Filterausdruck besteht aus mindestens einem Term und optional einem oder mehreren Operatoren. Es gibt zwei Arten von Termen: Einzelterme und Phrasen.
Ein Einzelterm besteht aus einem einzelnen Wort wie „test“ oder „Hallo“.
Eine Phrase besteht aus einer Gruppe von Wörtern in Anführungszeichen — etwa „Down under“.
Sie kombinieren Terme mit logischen Operatoren zu komplexeren Filterausdrücken.
Besteht ein Term aus einer positiven Ganzzahl, durchsucht Allegra nur die Vorgangsnummer. So holen Sie einen Vorgang mit bekannter Nummer sehr schnell auf den Bildschirm — Sie geben die Nummer einfach in die Suchbox ein.
Attribute#
AQL durchsucht den Volltext und Vorgangsattribute. Sie geben in der Abfrage entweder ein konkretes Attribut an — oder Allegra durchsucht die voreingestellten Attribute.
Ohne Attributangabe durchsucht Allegra alle Textattribute. Sie begrenzen einen Filterterm auf ein Attribut, indem Sie den Attributnamen mit Doppelpunkt voranstellen.
Beispiel: Sie suchen einen Vorgang mit dem Titel „Der richtige Weg“, der zusätzlich „nicht hier entlang“ im Beschreibungsattribut enthält:
Titel:"Der richtige Weg" AND Beschreibung:"nicht hier entlang"
oder
Titel:"Der richtige Weg" AND "nicht hier entlang"
Das Attribut „Beschreibung“ ist als Suchfeld voreingestellt — Sie müssen es nicht angeben. Allerdings findet Allegra dann auch Vorgänge, die die Phrase in einem anderen Textattribut tragen, etwa im Titel.
Sie geben entweder den internen Attributnamen (z. B. „Description“) oder den lokalisierten Text („Beschreibung“) an. Die verfügbaren Attribute sehen Sie in der Spaltenauswahl der Vorgangsübersicht. Eine komplette Liste aller Standardattribute steht im Abschnitt Standardattribute.
Warnung
Der Attributausdruck gilt nur für genau den Term, dem er
vorangestellt ist. Der Ausdruck
Titel:Mach es richtig
sucht „Mach“ nur im Titel — „es“ und „richtig“ dagegen in allen
Textattributen.
Term-Modifikatoren#
AQL erweitert die Suchmöglichkeiten über Term-Modifikatoren.
Platzhalter-Suche#
AQL unterstützt Wildcards für ein einzelnes Zeichen (?) und für
mehrere Zeichen (*).
Der Einzeichen-Platzhalter steht für genau ein beliebiges Zeichen. Beispiel — findet sowohl „test“ als auch „text“:
te?t
Mehrzeichen-Platzhalter stehen für null oder mehr Zeichen. Beispiel — findet „Test“, „Tests“ oder „Tester“:
test*
Sie verwenden den Mehrzeichen-Platzhalter auch in der Mitte eines Ausdrucks:
te*t
Bemerkung
Platzhalter dürfen nicht das erste Zeichen eines Terms sein.
Unscharfe Suche#
Für eine Fuzzy-Suche hängen Sie ~ an einen Einzelterm. Beispiel —
findet Wörter ähnlich wie „Raum“:
Raum~
Diese Suche findet auch „Schaum“ oder „Pflaume“. Über einen optionalen Parameter zwischen 0 und 1 steuern Sie die gewünschte Ähnlichkeit — Werte nahe 1 bedeuten höhere Ähnlichkeit. Beispiel:
Raum~0.9
findet „Traum“, aber nicht „Schaum“. Voreingestellt ist 0,5.
Nachbarschaftssuche#
Eine Nachbarschaftssuche findet Terme in einem maximalen
Wortabstand. Hängen Sie ~ an eine Phrase. Beispiel — findet
„Allegra“ und „Vorgang“ maximal zehn Wörter voneinander entfernt:
"Allegra Vorgang"~10
Bereichssuche#
Eine Bereichssuche filtert Attributwerte zwischen zwei Grenzen — die Grenzen lassen sich einschließen oder ausschließen. Die Sortierung erfolgt lexikographisch:
Geändert:[20240101 TO 20241231]
findet Vorgänge, deren letztes Änderungsdatum zwischen dem 1.1.2024 und dem 31.12.2024 liegt — die Grenzen eingeschlossen. Bereichssuchen sind nicht auf numerische oder Datumsattribute beschränkt. Auch das geht:
Titel:{Aida TO Carmen}
findet Vorgänge, deren Titel Wörter zwischen „Aida“ und „Carmen“ enthalten — ohne „Aida“ und „Carmen“ selbst.
Eckige Klammern schließen die Bereichsgrenzen ein, geschweifte Klammern schließen sie aus.
Term verstärken#
AQL berechnet intern einen Relevanzwert pro Vorgang. Sie erhöhen die
Relevanz eines Vorgangs in der Abfrage, indem Sie einen Term stärker
gewichten. Hängen Sie dazu ^ und einen Verstärkungsfaktor an den
Term — je höher der Wert, desto stärker das Gewicht.
Beispiel — Sie suchen nach beiden Ausdrücken, möchten „Projekt“ aber stärker werten als „Management“:
Projekt^4 Management
Ganze Phrasen verstärken Sie analog:
"Projekt Management"^4 "AQL"
Voreingestellt ist der Faktor 1. Der Faktor muss positiv sein — kann aber kleiner als 1 sein (z. B. 0,3).
Boolesche Operatoren#
Mit booleschen Operatoren kombinieren Sie Terme. AQL unterstützt
AND, +, OR, NOT und -. Boolesche Operatoren
schreiben Sie immer komplett in Großbuchstaben.
OR-Operator#
OR ist der voreingestellte Operator — ohne Operator zwischen
Termen implizit. Allegra liefert dann Vorgänge, die mindestens einen
der Terme enthalten. Alternativ schreiben Sie ||.
Beispiel — Vorgänge, die „project management“ oder „project“ enthalten, aber nicht nur „management“:
"project management" project
oder
"project management" OR project
AND-Operator#
AND verlangt, dass beide Terme irgendwo im Vorgang vorkommen.
Alternativ schreiben Sie &&.
Beispiel — Vorgänge mit „project management“ und „AQL new“:
"project management" AND "AQL new"
Plus-Operator#
Der +- oder „Erforderlich“-Operator verlangt, dass der Term nach
dem +-Symbol im Vorgang vorkommt.
Beispiel — Vorgänge mit „project“, optional zusätzlich „AQL“:
+project AQL
NOT-Operator#
NOT schließt Vorgänge aus, die den Term enthalten. Alternativ
schreiben Sie !.
Beispiel — Vorgänge mit „project management“, aber ohne „AQL new“:
"project management" NOT "AQL new"
Achtung
NOT funktioniert nicht mit nur einem Term. Diese Abfrage
liefert kein Ergebnis: NOT "project management"
Minus-Operator#
Der -- oder Ausschluss-Operator schließt Vorgänge aus, die den
Term nach dem --Symbol enthalten.
Beispiel — Vorgänge mit „project management“, aber ohne „issue tracking“:
"project management" -"issue tracking"