Une requête définit les données extraites de la source de données et prend la
forme d'un chemin d'accès dans le schéma de source de données. Vous pouvez affecter une
requête à un élément de canevas pour définir le contexte des données de cet élément et de ses enfants.
Procédure
- Affectez des requêtes.
- Dans Document Studio, ouvrez la vue Schéma de source de données.
- Ajoutez des éléments au canevas.
- Faites glisser les requêtes de la vue Schéma de source de données dans
les éléments.
Une requête est affectée à un élément de canevas ; vous pouvez utiliser les
attributs du type de requête, l'élément déplacé à partir de la vue Schéma de
source de données, n'importe où dans l'élément de canevas et ses éléments
enfant.
- Affectez une limite à l'élément de requête.
Remarque : Vous pouvez traiter un sous-ensemble d'éléments de canevas en affectant une limite aux éléments de requête.
- Dans Document Studio, sélectionnez l'élément de canevas qui contient la requête.
- Dans la vue Propriétés, sélectionnez l'onglet Données.
- Pour la propriété Limite, entrez le nombre d'objets de la source de données à utiliser dans la requête correspondante. Si la valeur 0 (zéro) est spécifiée, aucune limite n'est définie pour la
requête.
- Affectez des propriétés récurrentes aux requêtes. La récursivité des données permet d'extraire toutes les exigences enfant d'une
exigence source principale dans un schéma.
- Sélectionnez l'élément qui contient la requête.
- Dans la vue Propriétés, pour la propriété Niveau récursif, indiquez à combien de niveaux se trouve la requête.
- Pour la propriété Segments récursifs,
entrez le nombre de fois que les segments sont répétés dans la requête.
Voir l'exemple ci-dessous sur les niveaux récursifs et les segments récursifs.
- Sauvegardez vos changements.
Résultats
Lorsque vous appliquez une requête à un élément, trois indicateurs visuels s'affichent en bleu par défaut dans l'éditeur de contenu de canevas :
- Le nom du schéma de source de données.
- Le contexte affiché avec un signe dollar ($).
- Le nom de la requête.
Conseil : Lorsque vous effacez les informations des requêtes, Effacer les
requêtes et Effacer tout fonctionnent
différemment. Effacer les requêtes n'est disponible que si vous sélectionnez
un élément qui possède une requête. Effacer tout
supprime tous les attributs, les requêtes, les filtres, les tris et les conditions sur
l'élément que vous avez sélectionné et ses éléments enfant, si des requêtes ou des
attributs leur ont également été affectés. Les pages originales, les styles et les propriétés de formatage ne sont pas supprimées.
Exemple : niveau récursif et segments récursifs
Pour chaque
requête parent, vous pouvez extraire toutes les exigences enfant et, pour chaque exigence enfant, extraire toutes les exigences enfant
sans ajouter chaque requête à votre canevas.
Au lieu d'ajouter chacune des requêtes suivantes :
- [$1] Query1/Query2/Query3 pour extraire
Query3.
- [$2] $1/Query4/Query5/Query6 pour extraire
les enfants requis de chaque Query3.
- [$3] $2/Query4/Query5/Query6 pour extraire
les enfants requis de chaque enfant requis de Query3.
Vous pouvez créer automatiquement une requête pour ces exigences.
- Ajoutez la requête Query1/Query2/Query3/Query4/Query5/Query6 à un élément.
- Ajoutez des valeurs aux propriétés Niveau récursif et Segments récursifs :
- Exécutez le rapport à tester.
Lors de l'exécution du rapport, ces requêtes sont incluses :
Si vous remarquez que le nombre défini pour la propriété
Segments récursifs est supérieur au nombre de segments contenus dans la requête, exécutez l'une des deux options suivantes pour corriger le problème :
- Sélectionnez l'élément auquel est appliquée la propriété Segments récursifs. Dans la vue Propriétés, sélectionnez l'onglet Données et diminuez la valeur de la propriété des segments récursifs.
- Concevez de nouveau la requête de manière à démarrer avec une requête parent différente. Si la valeur Segments récursifs possède un segment de trop, créez un élément de conteneur et ajoutez une requête qui se trouve un niveau au-dessus de la requête parent de l'élément existant.
Déplacez ensuite l'élément existant dans l'élément de conteneur.
Que faire ensuite
Conseil : Vous pouvez rechercher une liste des
requêtes et des attributs en cliquant sur un élément à l'aide du bouton droit de la
souris et en sélectionnant . La vue Recherche s'ouvre et une liste des requêtes et des attributs s'affiche. Vous pouvez
cliquer deux fois sur une requête ou un attribut dans les résultats pour en éditer le contenu.
Vous pouvez rechercher une liste des affectations de variable,
des attributs et des requêtes utilisés dans un élément en cliquant sur ce dernier à
l'aide du bouton droit de la souris et en sélectionnant . La vue Recherche s'ouvre et une liste s'affiche. Vous pouvez
cliquer deux fois sur un élément dans les résultats pour l'éditer.
Vous pouvez rechercher une requête ou un attribut dans la vue Schémas
de source de données à partir de l'élément auquel il est appliqué en cliquant sur cet élément à l'aide du bouton
droit de la souris et en sélectionnant . La vue Schéma de source de données s'ouvre et la requête ou l'attribut est mis en évidence.