Zum Hauptinhalt springen

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 createDate oder eine benutzerdefinierte Eigenschaft in der Schreibweise custom: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.
  1. 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
  2. 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.

  3. Kombinieren Sie Bedingungen mit AND, OR und NOT und gruppieren Sie sie mit Klammern. Um eine Eigenschaft gegen mehrere Werte zu prüfen, verwenden Sie IN statt einer Kette von OR-Klauseln – das ist schneller. Trennen Sie die Werte durch Kommas oder Leerzeichen, und setzen Sie NOT vor IN, um sie stattdessen auszuschließen:

    type in (ObjectType.PROCESS, ObjectType.RESOURCE)
    type not in (ObjectType.PROCESS, ObjectType.RESOURCE)
  4. 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 NOT vor 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.

  5. 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 einem count(...) auf, getrennt durch Kommas oder Leerzeichen:

    count(responsible) > 3
    count(responsible, accountable) >= 5

    count(...) funktioniert nur mit mehrwertigen Eigenschaften – Beziehungen wie responsible und Listeneigenschaften wie diagramElement. Eine einwertige Eigenschaft wie name oder createDate kann es nicht zählen.

  6. Geben Sie im Feld Eigenschaften (Listen- und Suchtextberichte) oder im Feld Beziehungen (Matrixberichte) die anzuzeigenden Elemente ein, getrennt durch Kommas oder Leerzeichen.

  7. 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, false und nicht gesetzt. Vergleichen Sie ausdrücklich mit einem Wert – custom:IsImportant = true ist nicht dasselbe wie custom: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.