Ab der Version 2025.2 in Stimulsoft-Produkten für Erstellen von Dashboards wurde die Eigenschaft InclusionMode eingeführt, und in diesem Artikel erzählen wir über die Arbeit dieser Eigenschaft.

Einführung

Die Eigenschaft InclusionMode ermöglicht das Benehmen der Filter bei der Arbeit mit verbundenen Daten zu steuern. Die Verwendung von dieser Eigenschaft hilft unsichtbare Probleme, die bei der Verwendung von Filtern mit den aggregierten entstehen können, zu beheben.

Das mögliche Szenario der Arbeit mit den Daten im Dashboard

Wollen wir ein Szenario, in dem zwei Datenquellen – Kategorien und Produkte verwendet werden, betrachten.

Ohne Filter werden in der Tabelle der Produkte nur die tatsächlichen Daten aus der Quelle angezeigt. Wenn es mehr Kategorien als in den Produkten gibt, erscheint nach der Aggregation (z.B., Zusammenfassung) eine Zeile mit den Daten aus den Kategorien, die keine Übereinstimmungen in den Produkten haben.

Mit dem Filter (z.B., der Kategorie) wird in die Abfrage zur Tabelle eine Bedingung, die mit der Spalte der Kategorie verbunden ist, hinzugefügt.

Das Problem: wenn die Option "Alle" in dem Filter ausgewählt ist, verschwindet die Zeile mit den aggregierten Daten, was kein richtiges Benehmen ist. Wichtig!

Es gibt einige Möglichkeiten des Zusammenführens der Tabellen, und bei der Auswahl von der Option „Alle“ wird der Mechanismus FULL JOIN realisiert. Mehr über die Besonderheiten des Zusammenführens der Tabellen und die Eigenschaft JoinType können Sie in diesem Artikel lesen.
Die Eigenschaft InclusionMode behebt dieses Problem und bietet zwei Modi der Filter-Arbeit.

Filter-Modi

Jetzt untersuchen wir die Arbeit jedes Modus:

Standardmäßig (Selection Only):
Der Filter wird nur bei der Auswahl von bestimmter Kategorie aktiviert.
Wenn “Alle” ausgewählt ist, der Filter wird nicht in die Abfrage hinzugefügt → die Zeile mit aggregierten Daten verschwindet.

Immer:
Der Filter wird immer in die Abfrage hinzugefügt, sogar bei der Auswahl von der Option “Alle”.
In diesem Fall wird die Zeile mit den aggregierten Daten gespeichert, weil die Bedingung des Filters (zum Beispiel, WHERE CategoryID IS NULL) in der Abfrage bleibt.
Der Wert Always wird verwendet, wenn man die aggregierten Daten (z.B., die Summen) sogar bei der Auswahl von “Alle” speichern muss. Der Wert Selection Only wird verwendet, wenn der Filter nur bei der ausdrücklichen Auswahl (z.B., für die Optimierung der Abfragen) angewandt werden soll.

Die Vorteile der Verwendung von der Eigenschaft InclusionMode:

- Kontrolle über aggregierte Daten
Die Eigenschaft schließt die “springenden” Zeilen bei der Verwendung von den Filtern mit der Option “Alle”.

- Vorhersehbarkeit
Der Modus Always stellt sicher, dass der Filter sogar bei der Auswahl von der Option “Alle” die Abfrage beeinflusst.

- Kompatibilität
Der Modus Selection Only bewahrt das Benehmen, das den Benutzern der älteren Versionen bekannt ist.

Abschluss

Die Eigenschaft InclusionMode bietet die Flexibilität bei der Filterverwaltung, besonders bei der Arbeit mit den aggregierten Daten. Die Verwendung dieser Eigenschaft erlaubt unerwartete Veränderungen in den Berichten und Dashboards zu vermeiden.
By using this website, you agree to the use of cookies for analytics and personalized content. Cookies store useful information on your computer to help us improve efficiency and usability. For more information, please read the privacy policy and cookie policy.