Sie können für alle unterstützten Datenquellen native Filter verwenden.
Mit Hilfe von nativen Filtern, die von den Data-Services-Adaptern für Berichterstellung
interpretiert werden,
können Sie Filter im Datenquellenformat eingeben. Der
native Filter wird von den Data-Services-Adaptern für Berichterstellung anstatt von Rational Publishing Engine
verarbeitet.
Daher verbessert die Verwendung von nativen Filtern die
Leistung von Rational Publishing Engine.
Vorbereitende Schritte
Wird
Rational Publishing Engine mit einem Produkt integriert,
in dem Reportable-REST-Datenquellen nicht unterstützt werden, wird die gesamte Datenmenge abgerufen, und die Daten können nicht gefiltert werden.
Um zu überprüfen, ob
Reportable-REST-Datenquellen in Ihrem Produkt unterstützt werden, können Sie die Filterbedingung in der nativen Datenquelle testen,
bevor Sie sie in
Rational Publishing Engine verwenden.
Weitere Informationen
zum Definieren der Voraussetzungen für Reportable REST v1 Services finden Sie im Dokument
Reportable Rest v1.
Informationen zu diesem Vorgang
Reportable-REST-Datenquellen unterstützen native Filter, mit denen das Filtern, Sortieren und die selektive Unterstützung von Eigenschaften möglich ist.
Ein nativer Filter fordert eine Datenmenge aus der Datenquelle an. Die Daten werden anschließend zur Ausgabe
in einer RPE-Vorlage (Rational Publishing Engine) gefiltert und eingegrenzt.
In dem Produkt, aus dem die Daten abgerufen wurden, müssen keine Filter erstellt werden, es sei denn, Sie möchten die Filter auf Richtigkeit überprüfen.
Filter können ausschließlich in Rational Publishing Engine
zur Verwendung in RPE-Vorlagen
erstellt werden.
In früheren Releases von
Rational Publishing Engine konnten Sie nur statische Filter definieren.
Die Filter mussten beim Design der Vorlage bekannt sein und konnten zur Ausführungszeit nicht geändert werden.
Native Filter können für alle Datenquellen angewendet werden, ihre Syntax richtet sich jedoch nach der Datenquelle.
Weitere Informationen zur Syntax
finden Sie in der Dokumentation zur betreffenden Datenquelle.
Vorgehensweise
- Wählen Sie in
Document Studio das Vorlagenelement aus, das die zu filternde Abfrage enthält.
- Blenden Sie in der Sicht Eigenschaften die Einträge unter
Daten ein.
- Klicken Sie für das Feld Filter auf die Auslassungspunkte.
- Blenden Sie in der Sicht Native Filter die Einträge unter
Variablen ein.
Anmerkung: In Filtern verwendete Variablen können geändert werden, bevor die
erste Abfrage
für die betreffende Datenquelle ausgeführt wird.
- Wählen Sie eine Variable aus, nach der gefiltert werden soll.
- Geben Sie die Syntax ${} ein, um die zu filternde Abfrage zu definieren. Sie können z. B. nach dem Produktnamen filtern.
Mehrere Produktteams können diese Vorlage verwenden und zur Ausführungszeit einen Produktnamen in der Dokumentspezifikation angeben.
cq:Product{cq:Product"${productName}"
Anmerkung: - Angepasste Attribute können nicht in nativen Filtern verwendet werden.
- Wenn Sie eine Variable umbenennen, wird der Name nicht
in einem Scriptausdruck oder einem nativen Filter aktualisiert, und es tritt ein Referenzfehler auf. Wenn Sie eine Variable umbenennen,
achten Sie darauf, den Namen in den Scriptausdrücken und nativen Filtern entsprechend anzupassen.
- Zum Extrahieren von Rational-DOORS-Daten verwenden Sie das DXL-Script als native Filterbedingung.
Zum Extrahieren von REST-Daten verwenden Sie die
XPath-Filterbedingung.
- Klicken Sie auf OK.