IQL in einem Bericht verwenden
Schreiben Sie die Felder Filter, Eigenschaften und Beziehungen eines Berichts in der iGrafx Query Language (IQL), um genau zu steuern, welche Objekte erscheinen und was der Bericht über sie zeigt.
Voraussetzungen
- Ein Bericht, den Sie bearbeiten können, geöffnet im Bereich „Berichterstellung“ oder in der Repository-Baumstruktur. Siehe Einen Bericht erstellen.
Schritte
Ein IQL-Feld besteht aus drei Arten von Elementen, verbunden durch einen Punkt (.):
- Eine Eigenschaft ist ein Wert, den ein Objekt besitzt, zum Beispiel
createDateoder eine benutzerdefinierte Eigenschaft in der Schreibweisecustom:kpiCategory. - Eine Beziehung ist eine Verknüpfung zu einem anderen Objekt, zum Beispiel
isDocumentedBy. - Ein Typ ist das Präfix eines integrierten Aufzählungswerts, zum Beispiel
ObjectType.PROCESS.
-
Geben Sie im Feld Filter einen Ausdruck ein, der die einzubeziehenden Objekte auswählt. Bleibt das Feld leer, wird jedes Objekt in dieser Dimension des Berichts ausgewählt. Zum Beispiel, um nur Prozessobjekte aufzuführen:
type = ObjectType.PROCESS -
Wählen Sie während der Eingabe Werte aus der Vorschlagsliste. IQL unterscheidet zwischen Groß- und Kleinschreibung, und die Vorschläge fügen die richtige Schreibweise für Sie ein.
-
Kombinieren Sie Bedingungen mit
AND,ORundNOTund gruppieren Sie sie mit Klammern. Um eine Eigenschaft gegen mehrere Werte zu prüfen, verwenden SieINstatt einer Kette vonOR-Klauseln – das ist schneller. Trennen Sie die Werte durch Kommas oder Leerzeichen, und setzen SieNOTvorIN, um sie stattdessen auszuschließen:type in (ObjectType.PROCESS, ObjectType.RESOURCE)type not in (ObjectType.PROCESS, ObjectType.RESOURCE) -
Vergleichen Sie Werte mit den Operatoren, die IQL unterstützt:
- Gleichheit:
=und<> - Vergleich von Zahlen und Datumswerten:
<,<=,>,>= - Teilzeichenfolgen-Abgleich:
~, mit?für ein einzelnes Zeichen,*für beliebige Zeichen und\zum Maskieren eines Platzhalters - Nichtvorhandensein: Setzen Sie
NOTvor eine Eigenschaft oder Beziehung, um Objekte zu finden, bei denen kein Wert vorhanden ist
Schreiben Sie Datumswerte als
yyyy-mm-ddThh:mm:ss(die Uhrzeit ist optional, im 24-Stunden-Format) oder als Abstand von jetzt, etwa+-Ny/m/w/d/h. - Gleichheit:
-
Zählen Sie, wie viele Einträge eine Beziehung oder Listeneigenschaft enthält, indem Sie sie in
count(...)einschließen. Vergleichen Sie das Ergebnis wie jede andere Zahl, oder zeigen Sie es als Spalte an. Um mehrere Beziehungen zusammen zu summieren, führen Sie sie in einemcount(...)auf, getrennt durch Kommas oder Leerzeichen:count(responsible) > 3count(responsible, accountable) >= 5count(...)funktioniert nur mit mehrwertigen Eigenschaften – Beziehungen wieresponsibleund Listeneigenschaften wiediagramElement. Eine einwertige Eigenschaft wienameodercreateDatekann es nicht zählen. -
Geben Sie im Feld Eigenschaften (Listen- und Suchtextberichte) oder im Feld Beziehungen (Matrixberichte) die anzuzeigenden Elemente ein, getrennt durch Kommas oder Leerzeichen.
-
Klicken Sie auf Berichtsvorschau oder öffnen Sie die Registerkarte Bericht, um das Ergebnis zu prüfen.
Einschränkungen
- Eine boolesche benutzerdefinierte Eigenschaft hat drei Zustände:
true,falseund nicht gesetzt. Vergleichen Sie ausdrücklich mit einem Wert –custom:IsImportant = trueist nicht dasselbe wiecustom:IsImportant, das nur prüft, ob die Eigenschaft vorhanden ist. - IQL unterscheidet zwischen Groß- und Kleinschreibung. Verwenden Sie die Vorschlagsliste, damit die Elementnamen korrekt bleiben.
Verwandte Themen
- IQL-Abfragebeispiele – Abfragen für gängige Berichte, bereit zum Kopieren.
- IQL-Abfrageeigenschaften – die Eigenschaften, nach denen Sie filtern und die Sie als Spalten anzeigen können.
- IQL-Abfragetypen – die Typpräfixe und ihre Aufzählungswerte.
- Einen Bericht erstellen