Boucle et cycle des éléments de rapport HTML avec niveaux

Générer automatiquement des sections filtrées dans votre rapport HTML en utilisant des niveaux. Vous ajoutez des niveaux en tant qu'objets réutilisables dans le panneau des objets. Lorsque vous placez du contenu d'application dans un niveau, une nouvelle section filtrée est générée pour chaque valeur unique d'un champ (ou chaque combinaison de lignes dans un graphique) de l'application.

Les niveaux fournissent une couche supplémentaire de filtrage des données dans les rapports, en plus des mécanismes tels que les filtres et les cycles de rapport. Dans certains cas, vous pouvez utiliser une combinaison de niveaux, de filtres de rapport et de cycles pour générer une sortie de rapport extrêmement personnalisée et individualisée. Pour des informations sur les filtres de rapport, voir Utilisation de filtres de rapport. Pour plus d'informations concernant les cycles, voir Cycles de rapports.

Étape 1 : création d'un objet de niveau

Procédez comme suit :

1. Dans le concepteur HTML, placez votre curseur à l'emplacement du code où vous souhaitez insérer le niveau.

2. Cliquez sur dans le panneau des objets.

   

3. Cliquez sur Ajouter un niveau. Une liste des champs disponibles apparaît, en plus des feuilles disponibles contenant des graphiques qui peuvent être ajoutés en tant que niveaux.

Une fois les étapes ci-dessus terminées, vous pouvez choisir de créer un niveau à partir d'un champ ou d'un graphique. Pour plus d'informations, voir ci-dessous.

Étape 2 : configuration de l'objet niveau

Après avoir suivi les étapes ci-dessus, deux options s'offrent à vous :

• Ajoutez un champ comme niveau. Cela permet d'ajouter un groupe d'objets dans le rapport final pour chaque valeur distincte du champ.

• Ajoutez un graphique comme niveau. Cette opération ajoute un groupe d'objets pour chaque ligne de la table source du graphique.

Option 1 : ajouter un champ en tant que niveau

Procédez comme suit :

1. Dans le panneau des objets, développez les champs.

2. Cliquez sur l'icône à droite d'un champ pour l'ajouter.

   

3. Sous Sélectionner des champs à ajouter (facultatif), vous pouvez choisir d'inclure ou non des balises de champ en haut de chaque itération de niveau. Par exemple, si votre niveau porte sur un champ Pays et que vous incluez des étiquettes de champ, chaque itération de région aura un en-tête de section pour chaque pays de vos données.

4. Les balises de niveau sont insérées à votre emplacement actuel dans le code du modèle.

5. Dans le panneau des objets, donnez un nom unique au niveau afin de pouvoir l'identifier ultérieurement.

6. Vous pouvez réutiliser l'objet niveau à tout moment. Ouvrez dans le panneau des objets et sélectionnez pour ouvrir l'objet. Cliquez sur Ajouter une balise de niveau pour ajouter à nouveau le niveau.

7. Pour créer du contenu qui itère sur ce niveau, vous devez ajouter du contenu d'application dans les balises de niveau. Le code ci-dessous en donne un exemple.

   %%Region_Level%%
   %%Region_1%%
       <table cellspacing="0" style="border-collapse: collapse">
       <tbody><tr>
       <td>%%Customer%%</td><td>%%Sales%%</td>
       </tr>
       </tbody></table>
   %%/Region_Level%%

   Dans ce code, nous avons ce qui suit :

   • Un niveau Region_Level contenant tout le contenu.

   • Une balise de champ Region_1 à afficher comme en-tête en haut de chaque instance itérée du contenu.

   • Une table contenant deux champs individuels Customer et Sales.

Option 2 : ajouter un champ en tant que niveau

L'ajout d'un graphique en tant que niveau est très similaire à l'ajout d'un champ en tant que niveau, mais le résultat peut être différent et nécessiter une manipulation différente.

Lorsque vous ajoutez un graphique comme niveau, les données sont séparées dans une section pour chaque combinaison de valeurs au niveau de la ligne. Par exemple, si votre niveau est un graphique avec une dimension et une mesure calculée, une section sera créée pour chaque valeur de dimension, avec la valeur de mesure traitée comme la seule valeur unique possible pour cette dimension en question. La mise en forme du graphique diffère également selon que vous ajoutez une balise de champ pour un seul champ du graphique ou plusieurs balises de champ. Pour plus d'informations, voir les instructions ci-dessous.

Procédez comme suit :

1. Dans le panneau des objets, développez la feuille contenant le graphique que vous souhaitez utiliser comme niveau. Vous pouvez rechercher le nom du graphique en affinant la liste de feuilles, si nécessaire.

2. Cliquez sur l'icône à droite d'un graphique pour l'ajouter.

   

3. Sous Sélectionner les champs à ajouter (facultatif), vous pouvez choisir d'inclure ou non des balises de champ en haut de chaque niveau d'itération. La sortie est différente selon qu'il y a une ou plusieurs balises de champ ajoutées avec le niveau :

   • Une balise de champ : la balise de champ est ajoutée au niveau en tant qu'élément unique.

   • Balises à champs multiples : une table est ajoutée au modèle. Des balises de champ sont ajoutées à chaque élément td de la table.

4. Les balises de niveau sont insérées à votre emplacement actuel dans le code du modèle.

5. Dans le panneau des objets, donnez un nom unique au niveau afin de pouvoir l'identifier ultérieurement.

6. Vous pouvez réutiliser l'objet niveau à tout moment. Ouvrez dans le panneau des objets et sélectionnez pour ouvrir l'objet. Cliquez sur Ajouter une balise de niveau pour ajouter à nouveau le niveau.

7. Pour créer un contenu pertinent qui itère sur ce niveau, vous devez ajouter du contenu d'application dans les balises de niveau.