Table des matières

La table des matières fournit un résumé / aperçu de la structure du rapport et un ensemble de liens de navigation vers les éléments de rapport dans le rapport rendu et affiche les numéros de page des pages où se trouvent ces éléments de rapport. L'utilisateur peut cliquer sur les entrées de la table des matières pour accéder à la page du rapport qui affiche cet élément. La table des matières fait partie du rapport et peut être affichée avant ou après la section en-tête / pied de page du rapport. En tant que tel, il sera inclus dans la numérotation des pages du rapport. L'image suivante illustre la section de la table des matières lors de la conception et de l'exécution.

La table des matières peut être ajoutée au rapport en l'activant à partir du menu contextuel du rapport:

Structure

La position de la section COT dans le rapport peut être contrôlée via la propriété Position . Cette propriété peut être commutée entre quatre états différents qui placent la table des matières avant ou après l'en-tête du rapport ou la section du pied du rapport.

Au moment de l'exécution, les entrées de la table des matières sont définies par la propriété TocText de toute section / élément / groupe de rapport. Les valeurs valides sont le texte statique, l'expression ou le texte avec des expressions incorporées. Le texte résultant sera affiché dans l'entrée de la table des matières correspondante. Pour former une structure hiérarchique de la table des matières, vous devez définir la propriété TocText des groupes de rapports, des groupes de tableaux croisés / tables, de la section Détail et du rapport (utile pour les sous-rapports). Pour ajouter un élément de rapport à la table des matières , vous pouvez utiliser la propriété TocText de cet élément. Cependant, notez que tous les éléments de rapport (à l'exception de la section Détail et du rapport lui-même) produisent des nœuds d'extrémité dans la table des matières.

La définition de la table des matières contient un titre et une hiérarchie de niveaux. Le texte du titre peut être configuré à l'aide de la propriété Title . Son style est contrôlé via la propriété TitleStyle .

La propriété Levels contient les propriétés et les styles de chaque niveau de table des matières. La hiérarchie des niveaux correspond à la structure hiérarchique des sections, des éléments et des groupes du rapport pour lesquels la propriété TocText est définie. Les propriétés et les styles d'un niveau particulier dans la collection Levels ne seront appliqués qu'aux entrées de la table des matières des sections / éléments / groupes de rapports qui ont exactement le même niveau dans la hiérarchie des rapports.

Lorsque la hiérarchie du rapport est plus profonde (plus de niveaux) que le nombre de niveaux défini dans la collection Levels , le style du dernier niveau de la table des matières de la collection sera appliqué aux entrées de table des matières restantes.

Lorsque vous utilisez un livre de rapports pour combiner différents rapports, chaque table des matières distincte sera affichée dans le rapport auquel il appartient. Pour afficher une seule table des matières pour tous les rapports du livre de rapports, vous devez configurer une table des matières du livre de rapports .

Les liens de navigation de la table des matières sont gérés en interne en tant qu'actions de signet . Lorsque l'élément / la section / le groupe du rapport n'a pas de valeur BookmarkId , une valeur unique lui est automatiquement attribuée au moment de l'exécution. Si vous devez définir la valeur BookmarkId , assurez-vous qu'elle est unique dans l'étendue de l'ensemble du rapport (livre de rapports), sinon les liens de navigation de la table des matières risquent de ne pas fonctionner correctement.

Niveaux

La propriété Levels de la section TocSection contient une collection de niveaux. Chaque niveau a sa propre propriété LeaderSymbol qui définit un seul caractère. Ce caractère est utilisé pour remplir l'espace entre le texte de la table des matières et le numéro de page. Le caractère par défaut est un point (.). Pour empêcher le symbole de repère d'apparaître entre le texte et le numéro de page, vous devez supprimer ce caractère. Chaque niveau possède également une propriété Style . Le style configuré ici sera appliqué à tous les éléments de saisie de la table des matières: texte, symbole de repère, numéro de page.

Lorsque vous ajoutez une section de table des matières au rapport pour la première fois, la collection Levels sera vide. Dans ce cas, les entrées de la table des matières seront stylées avec un style et un symbole de repère par défaut. Vous pouvez ajouter des niveaux et les configurer en cliquant sur le bouton Points de suspension de lapropriété Niveaux pour appeler l'éditeur de collection de niveaux.