Bei einigen Datenquellen (z. B. JSON, REST, XLS, XML, CSV) können Datenquellen-Parameter in der URL verwendet werden.
1. In der URL werden die Datenquellen-Parameter dabei über die Syntax {{ParameterName=StandardWert}} eingefügt.
2. Der Provider wird dann mit einem Datenquellen-Parameter in der URL eingerichtet:
Beispiel für JSON:
JsonDataProvider orderData = new JsonDataProvider("http://example.net/api/ customers/{{KundenNr=123}}/orders");
Beispiel für REST:
https://www.pegelonline.wsv.de/webservices/rest-api/v2/stations/{{City=KONSTANZ|Choices=KONSTANZ,KOBLENZ,BONN|Multiselect=false}}/W/measurements.json?start=P30D
3. Der Designer erkennt die Parameter in den Datenquellen (hier "KundenNr" mit Standardwert 123) und erzeugt automatisch dazu passende Berichtsparameter:
Abbildung 2.26: Berichtsparameter im Designer
4. Wenn ein Datenprovider einen Datenquellenparameter mit dem Namen "XYZ" hat, versorgt ihn List & Label jetzt automatisch mit dem aktuellen Inhalt des Berichtsparameters "XYZ". (Die Namen müssen lediglich übereinstimmen).
In der Designervorschau ist das gewohnte Control mit den Berichtsparametern zu sehen:
Abbildung 2.27: Auswahl in der Vorschau
Wenn hier "456" statt "123" eingetragen wird, verwirft der Provider seine aktuellen Daten und lädt sie mit angepasster URL (http://.../customers/456/orders) erneut herunter.
5. Für die Definition der Datenquellen-Parameter steht auch ein Assistent zur Verfügung. Bei JSON und REST starten Sie den Assistenten über die Schaltfläche "Syntax" im Feld "Server URL".
▪ Beachten Sie dabei die beiden Optionen "Allgemein" und "Quelle".
▪ Bei 'Dargestellter Wert (Formel): Es kann eine Formel angegeben werden, sofern bei 'Quelle' eine Tabelle oder 'Vordefinierte Werte' ausgewählt ist. Der Parametername wird als '@Parametername' übergeben. Die Angabe ist optional.
Abbildung 2.28: Report Parameter Assistent