13. Parameter und Filter

Parameter und Filter

Parameter machen eine Vorlage wiederverwendbar; Filter sorgen dafür, dass nur die für den konkreten Zweck benötigten Daten in den Report gelangen.

Öffnen Sie Report Designer auf dem Desktop Administration.

Ihr Ziel

Sie verstehen vorhandene Reportparameter, können einen Filter aus Feld und Parameter aufbauen und die Auswirkungen auf Datenmenge und Vorschau prüfen.

Warum das im Reportdesigner entscheidend ist

Eine Vorlage kann so denselben Aufbau für unterschiedliche Belege, Partner oder Zeiträume verwenden. Der Parameter liefert den Kontext, der Filter begrenzt die Daten auf diesen Kontext.

Elemente und Einstellungen im Überblick

• Name: Technische, stabile Kennung des Parameters; vorhandene X-ERP-Namen nicht leichtfertig ändern.
• Description: Lesbare Bezeichnung für eine mögliche Parameteranzeige.
• Type: Datentyp wie Text, Zahl, Datum, Wahr/Falsch oder GUID.
• Value / Default Value: Aktueller beziehungsweise vorgeschlagener Wert.
• Visible: Legt fest, ob Anwender den Parameter in einer Vorschau auswählen; X-ERP kann integrierte Parameter ausblenden.
• Multi-Value: Erlaubt mehrere Werte, wenn der Anwendungsfall dies unterstützt.
• Filter String: Bedingung, die Datensätze anhand von Feldern, Werten und Parametern ein- oder ausschließt.

So gehen Sie vor

1. Prüfen Sie in der Feldliste, welche Parameter die Ausgangsvorlage bereits besitzt.
2. Ermitteln Sie, wo jeder Parameter verwendet wird: Filter, Ausdruck, Unterbericht oder Datenquelle.
3. Erstellen Sie einen Filter mit einem verfügbaren Feld und dem passenden Parameter.
4. Testen Sie gültige, leere und nicht vorhandene Werte.
5. Prüfen Sie, ob die Filterung früh genug erfolgt, um große Datenmengen zu vermeiden.

Übung

Erstellen Sie in einer Testliste einen Datums- oder Kategorieparameter und filtern Sie die Ausgabe darauf. Zeigen Sie den gewählten Wert zusätzlich im Berichtstitel an.

Prüfen Sie das Ergebnis

• Parametername und Datentyp passen zur X-ERP-Übergabe.
• Der Filter liefert genau die erwarteten Datensätze.
• Ein leerer Wert besitzt ein bewusst definiertes Verhalten.
• Große Datenmengen werden nicht unnötig vollständig geladen.

Typische Fehler und ihre Lösung

• Vorhandenen Id-Parameter umbenennen: Kann die integrierte Vorschau oder Prozessübergabe unterbrechen.
• Text mit Zahl vergleichen: Datentypen müssen zusammenpassen.
• Nur sichtbare Parameter prüfen: Auch ausgeblendete Parameter können für X-ERP entscheidend sein.

Ihr Ergebnis

Eine einzige Vorlage reagiert kontrolliert auf Datensatz, Zeitraum oder Auswahl – ohne Kopien für jeden Einzelfall.

Weiterführender Link / Quelle

Weiterführende Themen

1. Für Customizer – Masken und Formulare individuell anpassen › Reportdesigner › 04. Datenquelle, Datenmember und Feldliste
2. Für Customizer – Masken und Formulare individuell anpassen › Reportdesigner › 09. Datenfelder und Ausdruckseditor
3. Für Customizer – Masken und Formulare individuell anpassen › Reportdesigner › 16. Master-Detail und Unterberichte

Häufige Fragen