Vue Structure du code généré

Cette vue affiche un arbre avec les noeuds générés de l'instance. Elle vous permet de naviguer facilement dans l'éditeur COBOL PDP et de repérer les endroits où du code spécifique a été inséré. Si vous avez modifié le design d'une instance contenant du code spécifique, vous devez consulter cette vue après chaque nouvelle génération pour voir si la réconciliation (qui intègre le nouveau design tout en conservant le code spécifique) a détecté d'éventuels problèmes. Cette vue vous permet enfin de gérer les fonctions et sous-fonctions spécifiques déjà insérées.

Pour voir le contenu de cette vue, vous devez avoir généré un Programme, Ecran ou Serveur. Dans la vue Explorateur de designs ou une vue des résultats d'une recherche locale ou serveur d'instances ou de références, faites un clic droit sur le fichier généré et sélectionnez l'éditeur COBOL PDP. Par exemple, pour ouvrir le fichier généré d'un Programme, sélectionnez Ouvrir avec > Editeur COBOL PDP dans le menu contextuel du Programme généré. L'éditeur doit rester ouvert et sélectionné.

Dans la facette Pacbase, les noeuds correspondent aux fonctions, sous-fonctions, sections et divisions. Par défaut, l'arbre affiche les titres des fonctions et sous-fonctions générées et spécifiques. Ces titres sont extraits du commentaire précédant la fonction ou sous-fonction. Seuls les caractères pertinents sont pris en compte. Les caractères tels que *, + ou = par exemple, et la chaîne de caractères NOTE ne sont donc pas affichés. Pour ne pas afficher les titres des fonctions et sous-fonctions, désélectionnez l'option Afficher les libellés longs des noeuds à partir de Fenêtre > Préférences > Programmation pilotée par pattern > Infrastructure PDP.

L'arbre de la vue affiche les symboles suivants :
  • Code généré si le bloc de texte représentant le noeud est généré.
  • Code reformaté si le bloc de texte représentant le noeud contient des changements spécifiques, c'est à dire si le code généré a été modifié, si du code a été ajouté ou supprimé. Un symbole précise le type du changement spécifique :
    • Code modifié est affiché là où le texte du noeud a été modifié et où la réconciliation n'a détecté aucune erreur.
    • Code ajouté est affiché là où vous avez ajouté un bloc de texte dans le noeud ou créé un noeud spécifique.
    • Code supprimé est affiché là où vous avez supprimé le texte entier d'un noeud (si vous n'en avez supprimé qu'une partie, ceci est considéré comme une modification).
    Remarque : A chaque niveau de l'arbre où un avertissement est signalé, vous pouvez effectuer l'une des opérations suivantes :
    • Conserver les choix faits par la réconciliation en faisant un clic droit sur le noeud et en sélectionnant Supprimer les avertissements.
    • Ecraser les modifications de texte avec le code généré initial en faisant un clic droit sur le noeud et en sélectionnant Restaurer le code généré. Le noeud s'affichera alors comme un noeud généré (le texte du bloc sera précédé du symbole code généré).
Vous pouvez modifier l'affichage de la vue de plusieurs façons :
  • Afficher uniquement les noeuds représentant du code spécifique, avec leur hiérarchie ascendante. Pour ce faire, cliquez sur Montrer les noeuds utilisateurs dans la barre d'outils.
  • Filtrer les noeuds. Pour ce faire, saisissez une chaîne de caractères dans la zone de saisie du texte du filtre de la vue. Pour voir à nouveau l'intégralité du généré, effacez le contenu de cette zone.
    Remarque : Vous pouvez utiliser les caractères génériques * et ? dans la chaîne de caractères du filtre (ils sont optionnels en fin de chaîne). Vous devez séparer les chaînes de filtre multiples par des virgules.
  • Développer ou réduire tous les noeuds de l'arbre. Cliquez respectivement sur l'icône Tout développer ou Tout réduire dans la barre d'outils de la vue.
  • Afficher les noeuds créés lors de l'expansion des micro-patterns de reprise des opérateurs paramétrés dans les Macros (facette Pacbase). Ces noeuds sont cachés par défaut pour ne pas encombrer l'arbre des noeuds. Vous pouvez cependant les afficher pour détecter d'éventuels problèmes. Pour ce faire, désélectionnez l'option Cacher les noeuds possédant la propriété "cachée" à partir de Fenêtre > Préférences > Programmation pilotée par pattern > Infrastructure PDP.

Depuis un noeud de Macro (facette Pacbase), vous pouvez ouvrir la Macro dans l'éditeur de Macro, dans le contexte de son appel dans le Programme, l'Ecran ou le Serveur. Pour ce faire, faites un clic droit sur un noeud de Macro et sélectionnez Ouvrir la Macro avec l'éditeur de Macro. Ce choix est identique à un double-clic sur une Macro depuis l'onglet Lignes -CP d'un Programme, Ecran ou Serveur.

A partir de cette vue, vous avez la possibilité de filtrer le texte dans l'éditeur PDP pour afficher ou cacher des parties du code.

Si vous faites un clic droit sur un noeud représentant une fonction ou sous-fonction écrite avec du code spécifique, vous pouvez effectuer les actions suivantes à partir du menu contextuel :
  • Changer le niveau de la sous-fonction : Quand vous sélectionnez cette action, une boîte de dialogue vous demande le nouveau niveau de la sous-fonction. Cette action est aussi disponible depuis l'éditeur COBOL PDP.
  • Supprimer la fonction ou sous-fonction : Quand vous sélectionnez cette action, une boîte de dialogue vous demande de confirmer la suppression. Cette boîte contient aussi une case à cocher permettant de demander la suppression de toutes les sous-fonctions dépendantes, uniquement si elles ne contiennent pas de code généré. Si elles contiennent du code généré, cette case à cocher n'est pas disponible.
  • Déplacer la fonction ou sous-fonction et Copier-coller la fonction ou sous-fonction : Quand vous sélectionnez l'une ou l'autre de ces actions, une boîte de dialogue vous demande le nouveau code de la fonction ou sous-fonction.
    Restriction : Cette action n'est possible que sur une fonction ou sous-fonction terminale ne contenant pas de code généré provenant du design ou de Macros. Pour déplacer ou copier-coller une grappe de fonctions et sous-fonctions, vous devez donc effectuer l'action sur chaque fonction et sous-fonction, une par une.
Il est recommandé d'utiliser le menu contextuel pour effectuer ces actions car les étiquettes de fin (Fffnn-FN) des fonctions ou sous-fonctions existantes concernées par la mise à jour sont automatiquement réorganisées. Toute mise à jour manuelle implique une réorganisation manuelle de ces étiquettes.

Si vous faites un clic droit n'importe où dans la vue, vous pouvez sélectionner Générer le code dans le menu contextuel. Si vous avez mis à jour le design d'un Programme, Ecran ou Serveur, le code nouvellement généré intégrera les modifications du design tout en conservant tous les changements spécifiques entrés dans le code.

La préférence Gestion du contrôle de structure avant génération, accessible depuis Fenêtre > Préférences > Programmation pilotée par pattern > Patterns Pacbase contrôle que l'imbrication des sous-fonctions dans le COBOL est correcte avant la génération. Par défaut, elle bloque la génération si le contrôle détecte des erreurs.


Vos commentaires