Queries

Queries speichert Abfragen über die Arbeitselemente eines Projekts: ein bewusst eingeschränkter Filter, ein Ergebnisraster und eine lesende Vorschau. Gedacht ist das Paket für Projektbeteiligte, die wiederkehrende Fragen einmal formulieren und danach nur noch aufrufen wollen.

Erste Schritte

Schnelleinstieg: Die erste Abfrage speichern und teilen — der kürzeste Weg zum ersten Ergebnis, in vier Schritten.

Filter bilden → Ergebnis ansehen → Abfrage speichern oder teilen

Häufige Aufgaben

Was Sie wollen	Für wen	Wo Sie das tun	Anleitung
eine Abfrage bilden	Projektbeteiligte	`do=wkdoqueries` auf einer Projektseite	Das Abfragemodell
eine Abfrage speichern	Projektbeteiligte	Abfrageansicht	Teilen: Adresse oder gespeicherte Abfrage
eine Abfrage weitergeben	Projektbeteiligte	Adresse oder gespeicherte Abfrage	Teilen: Adresse oder gespeicherte Abfrage
verstehen, warum ein Filter stillschweigend entfällt	Projektbeteiligte	–	Prüfung verwirft, statt zu scheitern
herausfinden, warum jemand andere Treffer sieht	Verwaltung	–	Rechte
ein Arbeitselement selbst bearbeiten	Projektbeteiligte	–	Work Items

Zweck

Gespeicherte Abfragen über Arbeitselemente, mit einem eingeschränkten Filter, einem sortierbaren Ergebnisraster und einer nur lesenden Vorschauleiste.

Für alle, die Arbeitselemente wiederholt suchen und das Gefundene teilen müssen. Die Elemente und den Feldsatz liefert Work Items.

Das Abfragemodell ist absichtlich eingeschränkt

Eine Abfrage ist eine flache Liste aus Feld, Operator und Wert, verknüpft mit UND — keine Ausdruckssprache. Kein ODER, keine Gruppierung, keine Verschachtelung.

Das ist der Grund, warum sich jeder Bestandteil gegen den echten Feldsatz prüfen lässt, und warum eine eingefügte Adresse gefahrlos angenommen werden kann. Eine Ausdruckssprache wäre mächtiger und nicht mehr erschöpfend prüfbar.

Der wichtigste Punkt: Prüfung verwirft, statt zu scheitern

Ein unbekanntes Feld wird verworfen. Eine gespeicherte Abfrage überlebt damit das Entfernen eines Feldes — und wird dabei stillschweigend breiter, denn eine weggefallene Bedingung ist eine, die nicht mehr einschränkt.

Das ist die wichtigste Eigenschaft dieses Plugins. Nach dem Entfernen eines Feldes sind die gespeicherten Abfragen durchzusehen; nichts meldet, dass eine Abfrage breiter geworden ist.

Teilen: Adresse oder gespeicherte Abfrage

Weg	Trägt	Wofür
Adresse kopieren	die Ansicht, Sortierzustand eingeschlossen	einmalig, jetzt
Abfrage speichern und den Namen teilen	die Absicht	wiederkehrend

Der Sortierzustand wandelt in beide Richtungen — hinein in die Adresse und geprüft wieder heraus. Genau das macht eine Ansicht teilbar.

Gespeicherte Abfragen nach ihrer Frage benennen — „nicht zugewiesene Fehler dieser Version„, nicht „Abfrage 3“. Eine nach ihrer Nummer benannte Abfrage ist für niemanden außer ihrem Autor benutzbar, und irgendwann auch für ihn nicht mehr.

Rechte

Alles wird an jedem Eingang geprüft, eine eingefügte Adresse eingeschlossen. Nichts von außen erreicht die Abfrage ungeprüft.
Ergebnisse achten die Rechte. Eine geteilte Ansicht ist keine geteilte Berechtigung: zwei Personen sehen an derselben Adresse berechtigterweise verschiedene Zeilen.
Die Vorschau kann nicht bearbeiten, damit eine geteilte Ansicht nicht versehentlich zu einer Bearbeitungssitzung wird.

Sieht ein Kollege ein anderes Ergebnis, sind Bedingungen und Zeilenzahl zu vergleichen, nicht die Adressen. Weniger Zeilen sind Rechte; mehr Zeilen sind eine weggefallene Bedingung.

Konfiguration

Keine. Die Felder kommen aus dem Arbeitselement-Bereich, die Ergebnisse aus der Ablage, die Rechte aus der Projektrolle. Es bleibt nichts, was eine Einstellung entscheiden könnte.

Voraussetzungen

PHP 8.2 oder neuer.
Core Plugin, DevOps Core, DevOps Storage Plugin.
Work Items — liefert die Elemente und den Feldsatz. Ohne dieses Paket gibt es nichts abzufragen und nichts, wogegen geprüft werden könnte.

Das optionale Darstellungspaket wvdsdwui ist auf dieser Installation nicht vorhanden. Das Raster erscheint deshalb in der schlichteren Form; die Fachlichkeit ist davon unberührt.

Grenzen

Prüfung verwirft, statt zu scheitern — siehe oben, der wichtigste Punkt.
Das Abfragemodell ist flach und nur UND-verknüpft, bauartbedingt.
Eine lange Adresse kann unterwegs abgeschnitten werden, etwa von Chat-Programmen und Mailclients. Für Wiederkehrendes die Abfrage speichern.
Die Vorschau kann nicht bearbeiten. Das Bearbeiten gehört in den Editor der Arbeitselemente, wo Nebenläufigkeitsprüfung, Wächter und Prüfspur sind.

Paketangaben

Plugin: wkdoqueries
Namespace: lib/plugins/wkdoqueries/
Autor: Wolfgang van der Stille Wolfgang.van.der.Stille@gmail.com (The White Knight Labs)
Lizenz: GPL 2