AQL benutzen

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 Vorgangsnavigator ersehen. Eine komplette Liste aller Standardattribute finden Sie im Abschnitt Liste der Standardattribute. ACHTUNG: 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 Zeichen „?“. Um einen Mehrzeichen-Platzhalter zu definieren, benutzen Sie das 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 Anmerkung: 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:[20190101 TO 20191231] Dies wird alle Vorgänge finden, deren letztes Änderungsdatum zwischen dem 1.1.2019 und dem 31.12.2019 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 Opertoren 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 das Zeichen || 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 das Symbol && 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"