Die Allegra Query Language (AQL)#
Die Allegra Query Language (AQL) erlaubt Filter zu definieren, die auch eine Volltextsuche in allen Anhängen (HTML, Text, XML, OpenOffice, PDF, Excel, Word, Powerpoint) beinhaltet.
Neben direkten werden auch unscharfe Suchen unterstützt und es kann nach benachbarten Begriffen gesucht werden.
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, die durch Anführungszeichen eingerahmt sind, wie zum Beispiel „Down under“.
Terme können mit logischen Operatoren kombiniert werden, um komplexere Filterausdrücke zu erstellen.
Besteht ein Term nur aus einer ganzzahligen positiven Nummer, wird nur das Vorgangsnummer-Attribut nach dieser Nummer durchsucht. Sie können sich also einen Vorgang, dessen Vorgangsnummer Sie kennen, sehr schnell durch Eingabe dieser Nummer in die Suchbox auf den Bildschirm holen.
Attribute#
AQL unterstützt Suchen im Volltext und in Vorgangsattributen. Wenn Sie einen Abfragefilter definieren, können Sie entweder ein Attribut angeben oder es werden die voreingestellten Attribute bei der Suche berücksichtigt.
Wenn Sie kein Attribut angeben, durchsucht Allegra als Voreinstellung alle Textattribute. Sie können einen Filterterm auf ein Attribut begrenzen, indem Sie dem Term den Attributnamen gefolgt von einem Doppelpunkt voranstellen.
Nehmen wir als Beispiel an, Sie wollen einen Vorgang mit dem Titel „Der richtige Weg” finden, der zusätzlich
noch den Text „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"
Da das Attribut „Beschreibung“ als Suchfeld voreingestellt ist, muss man es nicht unbedingt angeben.
Allerdings würden dann auch Vorgänge gefunden, die diese Phrase in einem anderen Textattribut wie z.B. dem
Titel haben.
Sie können entweder den internen Attributnamen (z.B. “Description”) oder den lokalisierten Text (”Beschreibung”) angeben. Die verfügbaren Attribute lassen sich aus der Einstellbox für die Spaltenauswahl im Vorgangsübersicht ersehen. Eine komplette Liste aller Standardattribute finden Sie im Abschnitt Liste der Standardattribute.
Warnung
Der Attributausdruck gilt nur für genau den Term, dem er vorangestellt ist. Der Ausdruck `` Titel:Mach es richtig`` wird nur das „Mach” im Titel suchen. Es wird „es” und „richtig” in allen Textattributen suchen.
Term-Modifikatoren#
AQL unterstützt die Modifikation von Filtertermen, um die Suchmöglichkeiten zu erweitern.
Platzhalter-Suche#
AQL unterstützt Platzhaltersuchen (Wildcards). Platzhalter sind sowohl für einzelne wie auch mehrere Zeichen
möglich. Um einen Einzeichen-Platzhalter zu definieren, benutzen Sie das Fragezeichen „?“. Um einen
Mehrzeichen-Platzhalter zu definieren, benutzen Sie das Stern-Zeichen „*“. Der Einzeichen-Platzhalter sucht nach
Ausdrücken, die dem angegeben Term entsprechen, aber mit dem Platzhalter durch ein beliebiges anders Zeichen
ersetzt. Zum Beispiel sucht der folgende Ausdruck sowohl nach „test” wie auch nach „text”:
te?t
Mehrzeichen-Platzhalter ersetzen null oder mehr Zeichen. Um zum Beispiel nach Test, Tests oder Tester zu
suchen, können Sie diesen Filterausdruck verwenden:
test
Sie können den Mehrzeichen-Platzhalter auch in der Mitte eines Ausdrucks verwenden:
te*t
Bemerkung
Sie können die Platzhalter-Zeichen nicht als erstes Zeichen eines Terms verwenden!
Unscharfe Suche#
AQL unterstützt Fuzzy-Suchen. Um eine Fuzzy-Suche zu definieren, benutzen Sie das Zeichen „~“ am Ende eines
Einzelterms. Um zum Beispiel nach einem Begriff zu suchen, der ähnlich wie „Raum” buchstabiert wird, benutzen
Sie den Ausdruck:
Raum~
Diese Suche würde auch Wörter wie Schaum oder Pflaume finden. Mit einem optionalen Parameter können Sie die
gewünschte Ähnlichkeit beeinflussen. Er muss zwischen 0 und 1 liegen, mit Werten näher bei 1 als Wörter mit
größerer Ähnlichkeit. Zum Beispiel:
Raum~0.9
findet Traum, aber nicht Schaum. Der voreingestellte Wert für die Ähnlichkeit ist 0.5.
Nachbarschaftssuche#
AQL unterstützt das Suchen von Termen, die von einem anderen Term eine bestimmte Anzahl von Wörtern entfernt
vorkommen (Nachbarschaftssuche). Für eine Nachbarschaftssuche verwenden Sie das Zeichen „~“ am Ende einer
Phrase. Wenn Sie zum Beispiel die Worte „Allegra” und „Vorgang” suchen, und diese nicht weiter als 10 Worte
auseinander stehen sollten, dann benutzen Sie:
„Allegra Vorgang“~10
Term verstärken#
Bereichssuchen erlaubt das Filtern von Attributwerten nach Wertebereichen. Der Filter lässt nur Vorgänge
durch, deren Attributwert im angegeben Suchbereich liegt. Bereichssuchen können die Bereichsgrenzen mit
einschließen oder ausschließen. Die Sortierung erfolgt lexikographisch.
Geändert:[20240101 TO 20241231]
Dies wird alle Vorgänge finden, deren letztes Änderungsdatum zwischen dem 1.1.2024 und dem 31.12.2024 liegt,
einschließlich dieser Werte. Beachten Sie bitte, dass Bereichssuchen nicht auf numerische oder
Datumsattributen beschränkt sind. Sie können auch folgendermaßen suchen:
Titel:{Aida TO Carmen}
Dies wird alle Vorgänge finden, deren Titel Worte zwischen Aida und Carmen enthält, aber ohne Aida und ohne
Carmen.
Rechteckige klammen definieren einen Bereich inklusive der Bereichsgrenzen; geschweifte Klammern einen Bereich ohne die Bereichsgrenzen.
Term verstärken#
AQL gibt intern einen Relevanzlevel zurück, der bestimmt, wie relevant ein Vorgang hinsichtlich der Abfragefilterkriterien ist. Sie können die Relevanz eines Vorgangs bei der Abfrage dadurch erhöhen, dass Sie einzelne Terme der Abfrage stärker berücksichtigen als andere. Dazu geben Sie mit dem Zeichen „^“ gefolgt von einer Zahl einen Verstärkungsterm oder Boost-Term an. Je höher der Verstärkungsterm, desto höher liegt der Vorgang bezüglich seiner Relevanz, wenn dieser Term in ihm enthalten ist.
Wenn Sie zum Beispiel nach folgenden beiden Ausdrücken suchen
Projekt Management
und Sie möchten, dass der Ausdruck „Projekt“ wichtiger ist als der Ausdruck „Management”, dann können Sie
ihn durch das Symbol ^ gefolgt von einem Verstärkungsfaktor stärker gewichten. Sie würden eingeben:
Projekt^4 Management
Dies wird Vorgänge, die den Ausdruck „Projekt” enthalten, stärker gewichten als die, die den Ausdruck
„Management” enthalten. Sie können auch ganze Phrasen verstärken, wie in diesem Beispiel:
"Projekt Management"^4 "AQL"
Es ist ein Verstärkungsfaktor von 1 voreingestellt. Der Verstärkungsfaktor muss positiv sein, aber er kann
kleiner als 1 sein (z.B. 0.3).
Boolsche Operatoren#
Mit boolschen Operatoren können Sie Terme kombinieren. AQL unterstützt die Operatoren AND, „+“, OR, NOT und „-“. Bitte beachten Sie, dass boolsche Operatoren immer vollständig in Großbuchstaben geschrieben werden müssen.
OR-Operator#
Der OR-Operator ist der voreingestellte Operator, d.h. wenn keine Operatoren zwischen Termen angegeben sind, wird automatisch der OR-Operator impliziert. Es werden damit Vorgänge durchgelassen, die mindestens einen der Terme enthalten. Anstelle des Wortes OR kann auch die Zeichenkombination || verwendet werden.
Um Vorgänge zu suchen, die entweder „project management“ oder auch nur „project“, aber nicht nur
„management” enthalten, benutzen Sie diese Abfrage:
"project management" project
oder
"project management" OR project
AND-Operator#
Der AND-Operator lässt Vorgänge durch, bei denen beide Terme irgendwo im Vorgang auftreten. Anstelle des Wortes AND kann auch die Zeichenkombination && verwendet werden.
Um nach Vorgängen zu suchen, die irgendwo im Text „project management“ und zusätzlich „AQL new“ enthalten,
benutzen sie diese Abfrage:
"project management" AND "AQL new"
„+“-Operator#
Der „+“ oder „Erforderlich”-Operator legt fest, dass der Term nach dem +-Symbol im Vorgang auftritt.
Um nach Dokumenten zu suchen, die unbedingt das Wort „project“ enthalten, und wenn möglich auch noch „AQL“,
benutzen Sie diese Abfrage:
+project AQL
NOT-Operator#
Der NOT-Operator schließt Vorgänge aus, die den Term nach dem NOT enthalten. Anstelle des Wortes NOT kann auch das Symbol ! verwendet werden.
Um nach Vorgängen zu suchen, die den Term „project management“ enthalten, aber nicht den Term „AQL new“,
benutzen Sie die Abfrage:
"project management" NOT "AQL new"
Achtung
Der NOT-Operator kann nicht mit nur einem Term verwendet
werden. Die folgende Abfrage würde kein Ergebnis liefern: NOT "project management"
„-“-Operator#
Der „-“ oder Ausschlussoperator schließt Vorgänge aus, die den Term nach dem „-“ Symbol enthalten. Um nach
Vorgängen zu suchen, die „project management” enthalten aber nicht „issue tracking” würden Sie diesen
Ausdruck benutzen:
"project management" -"issue tracking"