Vue des résultats d'une recherche de références serveur

Cette vue affiche les résultats de la recherche des références demandée pour l'instance ou le fichier sélectionné. Cette recherche, lancée depuis le choix Références > Super-références serveur ou Références > Sous-références serveur du menu contextuel de l'instance ou du fichier, a été effectuée directement sur le serveur Rational Team Concert.

Références d'une instance

La recherche suit les liens de composition de l'instance. Le titre de la vue indique quel type de références est affiché, selon votre demande :
  • Les super-références, c'est à dire les instances qui référencent l'instance sélectionnée,
  • Ou les sous-références, c'est à dire les instances qui sont référencées par l'instance sélectionnée.
Exemple : Si vous recherchez les sous-références d'un Programme, vous verrez les instances d'entité qu'il appelle, jusqu'au niveau le plus fin : Structures de Données, Segments, Rubriques. De plus, les sous-références incluent toujours la Bibliothèque qui contient les paramètres de génération de l'instance.
Exemple : Si vous recherchez les super-références d'une Rubrique, vous verrez les instances d'entité qui appellent cette Rubrique, jusqu'au niveau le plus haut : Segments, Structures de Données, Programmes, Ecrans, Blocs Bases de Données.

Références d'un fichier généré

Si vous avez demandé la recherche des sous-références d'un fichier COBOL généré de Programme, Ecran ou Serveur (fichier .cbl), la vue des résultats de la recherche de références affiche les instances ayant contribué à la génération de ce fichier.

Pour les fichiers d'extension .cbl, les informations suivantes sont affichées :
  • L'instance de design ayant servi de point d'entrée pour générer le fichier COBOL,
  • Les instances appelées par des micro-patterns,
  • Les Rubriques appelées dans du code ajouté manuellement dans la PROCEDURE DIVISON. Le nombre d'utilisations de chaque Rubrique dans le fichier COBOL est indiqué avec usage(n), où n est le nombre d'utilisations de la Rubrique.
Vous pouvez développer les sous-références affichées jusqu'au niveau le plus fin.

Actions possibles sur les références

Si vous faites un clic droit sur une instance dans l'arbre des références, vous pouvez :
  • Ouvrir l'instance en consultation dans son éditeur de design. Les informations affichées dans l'éditeur sont identiques à celles affichées quand l'instance existe dans votre espace de travail local. Vous pouvez naviguer entre les instances. Vous pouvez, par exemple, ouvrir l'éditeur d'une Rubrique depuis l'onglet Lignes CE d'un Segment.
  • Ouvrir l'instance dans un éditeur COBOL, en consultation uniquement, si l'entité contient une description COBOL.
  • Charger les artefacts requis. Vous pouvez sélectionner ce choix à partir d'un des types de ligne suivants :
    • Un ou plusieurs fichiers de design. Un assistant spécifique de chargement s'ouvre en affichant les fichiers sélectionnés et leurs artefacts requis en suivant les liens des sous-références. Tous ces fichiers sont chargés dans l'espace de travail local en formant un ensemble cohérent.
    • Un ou plusieurs fichiers source ou mappes (pour les Ecrans). Les liens sont explorés pour trouver les artefacts requis. Tous ces artifacts sont chargés dans l'espace de travail local.

    Pour des explications, voir Chargement de l'espace de travail.

  • Charger les projets requis par l'instance. Vous pouvez ainsi limiter le nombre de composants à charger dans votre espace de travail local pour pouvoir travailler sur cette instance de design.
  • Rechercher ses propres sous-références ou super-références, qui s'afficheront alors à leur tour dans la vue Références serveur.
Si vous faites un clic droit sur une Rubrique, vous pouvez lancer une Recherche d'utilisations. Cette recherche détecte les utilisations de la Rubrique dans le code ajouté manuellement dans la PROCEDURE DIVISION des Programmes, Ecrans ou Serveurs (fichiers d'extension cbl). La sélection du choix Recherche d'utilisations provoque l'ouverture d'une boîte de dialogue qui vous permet de filtrer les fichiers cbl sur lesquels portera la recherche.
Remarque : Si vous lancez la recherche depuis les résultats d'une recherche de designs serveur, tous les fichiers cbl du flux sont proposés par défaut. En revanche, si vous lancez cette recherche depuis les résultats d'une recherche de sous-références serveur, le fichier cbl à l'origine de la recherche de références est proposé par défaut. Le nom du fichier est modifiable.
Quand vous appuyez sur OK dans la boîte de dialogue, vous basculez vers la vue Recherche d'utilisations serveur qui affiche le détail de chaque utilisation.

Barre d'outils

Cette vue contient une barre d'outils qui vous permet d'effectuer les actions suivantes :
  • Annuler la recherche en cours (bouton Annuler la recherche en cours).
  • Afficher les recherches précédentes (bouton Recherches précédentes). Cliquez sur la flèche associée à ce bouton pour afficher un menu qui contient :
    • Les dernières instances à partir desquelles vous avez lancé une recherche de références. Sélectionnez une de ces instances pour afficher ses références dans la vue.
    • Le choix Historique, qui ouvre une fenêtre affichant la liste des dernières instances à partir desquelles vous avez lancé une recherche de références. Depuis cette fenêtre, vous pouvez effectuer les actions suivantes
      • Sélectionner une instance et afficher ses références (bouton Ouvrir ou Ouvrir dans une autre vue) ou la supprimer de l'historique (bouton Supprimer).
      • Modifier le nombre d'instances affichées dans l'historique (valeur par défaut : 10) en cliquant sur le lien Configuration.
    • Le choix Effacer l'historique pour effacer toutes les recherches précédentes de l'historique.
  • Exporter les résultats de la requête (Exporter les résultats de la requête). Cette commande permet d'exporter les résultats au format CSV pour les exploiter dans un tableur.
  • Basculer des super-références vers les sous-références de l'instance sélectionnée (bouton sous-références),
  • Basculer des sous-références vers les super-références de l'instance sélectionnée (bouton super-références).
  • Modifier l'affichage des instances dans cette vue. Cliquez sur le triangle (Afficher le menu) et sélectionnez l'un des choix suivants
    • Trier pour indiquer un nouveau critère de tri.
    • Afficher pour afficher des informations supplémentaires sur la ligne de chaque instance dans l'arbre. Les informations peuvent être combinées. Pour supprimer l'affichage de l'une des informations sélectionnées, sélectionnez-la à nouveau dans le menu.
      Remarque : La relation est le nom du lien entre l'instance source et l'instance cible. Si ce lien existe plusieurs fois (par exemple si un Programme appelle plusieurs fois le même Segment), le nombre d'occurrence du lien s'affiche entre parenthèses juste après le nom de la relation.
    Ce nouveau paramétrage sera automatiquement sauvegardé et associé à cette vue, jusqu'à ce que vous le changiez.

Vous pouvez aussi filtrer l'affichage de l'arbre en sélectionnant un projet dans la zone Contexte et en cliquant sur un des boutons représentant une vision de la hiérarchie des projets dans le chemin de compilation design. Par défaut, le bouton Contexte seul est sélectionné. L'arbre n'affiche donc que les instances trouvées dans le projet sélectionné. Vous pouvez cependant sélectionner un autre bouton de hiérarchie (amont, aval ou complète) pour afficher les instances trouvées non seulement dans le projet sélectionné mais aussi dans les projets hiérarchiquement supérieurs ou inférieurs, ou dans tous les projets de la hiérarchie.


Vos commentaires