Filtermatrixwerte als Parameter
Normalerweise arbeiten die Filtermatrix und verschiedene Widgets recht nahtlos zusammen. Wenn das Kontrollkästchen “Apply filter matrix query“ aktiviert wird, werden Filter aus der Filtermatrix automatisch auf die Suchanfrage angewendet und somit die Daten aus der Datenabfrage entsprechend gefiltert.
Manchmal ist es jedoch vorteilhaft (z. B. aus Performance-Gründen oder zur Übergabe an eine Stored Procedure), die ausgewählten Werte der Filtermatrix direkt in einer Datenabfrage zu verwenden.
Zunächst wird betrachtet, wie der automatische Filter im Hintergrund funktioniert.
Die Mitarbeiterdaten werden über eine Datenabfrage namens employees abgerufen. Darüber hinaus gibt es eine Filtermatrix, um die Tabelle nach department zu filtern. Die automatische Suchfunktion der Filtermatrix wird mithilfe des Kontrollkästchens “Apply filter matrix query“ verwendet.
Die Datenabfrage selbst ist ein sehr einfaches Select auf die Tabelle mitarbeiter.
SELECT * from mitarbeiter
Sobald Werte aus der Filtertabelle ausgewählt werden, fordert das Dashboard die Daten vom Webservice über eine select-Anfrage an. Dabei werden die ausgewählten Werte aus der Filtermatrix in den department-URL-Parameter department=IN(Development,Management) umgewandelt. Dies bewirkt, dass der Webservice nur Zeilen mit der Abteilung “Development” oder “Management” zurückgibt.
Der Webservice wendet automatisch alle Parameter als Filter an, für die eine Spalte vorhanden ist. Dies gilt auch für Parameter, die direkt zum Feld “Search query“ hinzugefügt werden.
Da nun bekannt ist, wie der automatische Filtermechanismus funktioniert, können die Werte der Filtermatrix als Parameter für die Datenabfrage verwendet werden. Dazu muss die Datenabfrage ein wenig erweitert werden.
SELECT
*
FROM
mitarbeiter
WHERE
${departmentFilter} = '' OR
${departmentFilter}::text IS NULL OR
department = ANY (string_to_array(${departmentFilter}, ','))
Es wird ein Datenabfrage-Parameter namens departmentFilter definiert. Später wird die Auswahl aus der Filtermatrix übergeben, die dann in ein Array umgewandelt wird. Mit dem Operator ANY wird nach Werten gefiltert, die im Array enthalten sind. Falls keine Werte ausgewählt sind, wird eine leere Zeichenkette oder NULL zurückgegeben und departmentFilter wird überhaupt nicht angewendet (über den Vergleich mit einer leeren Zeichenkette / NULL und das OR).
Außerdem muss der Parameter departmentFilter=${filterMatrix.department} zur Suchanfrage der Tabelle hinzugefügt werden. Zudem kann das Häkchen bei dem Kontrollkästchen “Apply fiter matrix query“ entfernt werden, wenn keine weiteren Filter angewendet werden sollen.
Bitte beachten Sie, dass departmentFilter anstelle von einfach department als Parametername verwendet wird. Letzteres würde zu einem Namenskonflikt mit der Spalte department führen. Wie zuvor erläutert, wendet der Webservice automatisch Filter für Parameter an, für die er eine Spalte findet. Daher würde er die Daten beispielsweise nach department = 'Development,Management' filtern, was niemals wahr ist und somit keine Zeilen zurückgibt.


