Vous pouvez utiliser des filtres natifs avec toutes les sources de données
prises en charge. Les filtres natifs, qui sont interprétés par les adaptateurs Reporting Data Services,
vous permettent d'entrer des filtres au format de la source de données. Le filtre natif
étant traité par les adaptateurs Reporting Data Services
et non par Rational
Publishing Engine,
l'utilisation de filtres natifs améliore les performances de Rational
Publishing Engine.
Avant de commencer
Si vous intégrez
Rational
Publishing Engine
à un produit qui ne prend pas en charge les sources de données REST rapportables,
l'intégralité du fichier est extrait et ne peut pas être filtré. Pour vérifier que votre
produit prend en charge les sources de données REST rapportables, vous pouvez
tester la condition de filtre dans la source de données native avant de l'utiliser dans
Rational
Publishing Engine.
Pour
plus d'informations sur la définition des exigences des services REST v1 rapportables, examinez le document Reportable Rest v1.
Pourquoi et quand exécuter cette tâche
Les filtres natifs sont pris en charge par les sources de données REST
rapportables, qui permettent le filtrage, le tri et la prise en charge sélective des
propriétés.
Le filtre natif demande un ensemble de données à la source de données, puis
filtre et affine ces données pour la sortie d'un canevas Rational
Publishing Engine.
Vous n'êtes pas obligé de créer des filtres dans le produit dont proviennent les données
à moins que vous ne souhaitiez tester la précision des filtres, mais vous
pouvez créer des filtres à utiliser exclusivement dans les canevas Rational
Publishing Engine
à partir de Rational
Publishing Engine.
Dans les versions précédentes de Rational
Publishing Engine,
vous ne pouviez définir que des filtres statiques. Vous deviez savoir à quoi
correspondaient les filtres lorsque vous conceviez le canevas et ces filtres ne
pouvaient pas être modifiés lors de la phase d'exécution.
Les filtres natives s'appliquent à toute source de données,
mais leur syntaxe est spécifique à chaque source de données.
Pour plus d'informations sur la syntaxe, reportez-vous à la documentation de cette source
de données.
Procédure
- Dans Document Studio, sélectionnez l'élément de canevas qui contient la requête à
filtrer.
- Dans la vue Propriétés, développez Données.
- Dans la zone Filtre, cliquez sur les points de suspension.
- Dans l'onglet Filtre natif, développez Variables.
Remarque : Les variables utilisées dans les filtres peuvent être modifiées avant que la
première requête sur cette source de données ne soit utilisée.
- Sélectionnez une variable devant servir de filtre.
- Entrez la syntaxe ${} pour définir votre requête à
filtrer. Par exemple, vous pouvez filtrer par nom de produit. Plusieurs équipes de
produit peuvent utiliser ce canevas et spécifier un nom de produit dans la
spécification de document lors de la phase d'exécution.
cq:Product{cq:Product"${productName}"
Remarque : - Les attributs personnalisés ne peuvent pas être utilisés dans les filtres natifs.
- Si vous renommez une variable,
le nom n'est pas mis à jour dans une expression de script ou un filtre natif et une erreur de référence est
créée. Lorsque vous renommez une variable, vérifiez que vous pouvez également modifier le nom dans
les expressions de script et les filtres natifs.
- Pour extraire des données Rational
DOORS,
utilisez le script DXL comme condition de filtre native. Pour extraire des données REST,
utilisez la condition de filtre XPath.
- Cliquez sur OK.