Editeur PDP de Code Source

Cet éditeur vous permet de voir et de modifier le code généré d'une instance de Code Source. Cet éditeur fournit des fonctions supplémentaires par rapport à celles déjà implémentées par l'éditeur de code standard.

Pour voir le code dans cet éditeur, vous devez avoir généré une instance de Code Source. Dans la vue Explorateur de designs, vous pouvez alors faire un clic droit sur le fichier généré correspondant et sélectionner Ouvrir avec > Editeur PDP de Code Source dans le menu contextuel.

Modification du code généré

Vous pouvez modifier le code généré pour l'adapter à vos besoins.

Des facilités d'insertion de code sont disponibles. Vous pouvez insérer des instances de l'entité Micro-pattern Statique depuis la vue Fragments, catégorie Fragments du SDK RPP Micro-pattern. Vous pouvez aussi appeler des micro-patterns que vous avez créés avec l'interface de programme d'application. Il est fortement recommandé de ne pas modifier le code généré par un micro-pattern. Des avertissements dans la marge de gauche vous signalent les cas où l’insertion du code spécifique peut perturber la réconciliation. Ceci est le cas si vous écrasez une ligne générée par un micro-pattern et ajoutez un appel de micro-pattern dans le code généré par micro-pattern.

L’éditeur PDP inclut de nombreuses fonctions. Vous pouvez, par exemple, couper, copier, coller, filtrer les lignes, déboguer, comparer, afficher l’aide à la saisie en appuyant sur les touches Ctrl et espace.
Limite : Les fonctions Annuler et Répéter de l’éditeur sont désactivées après une génération. La pile de modifications pour annuler et répéter est vide après chaque génération. Les modifications faites avant une génération ne peuvent donc pas être défaites par la fonction Annuler. Pour supprimer les modifications (génération comprise) effectuées avant la génération, il est toujours possible de sortir de l’éditeur sans sauvegarder ou d’utiliser la fonction Rétablir le fichier.
L'éditeur COBOL PDP signale un état modifié en affichant un astéristique (*) dans l'onglet de l'éditeur quand le fichier généré est directement modifié. Pour annuler les modifications, faites un clic droit dans l'éditeur et sélectionnez Rétablir le fichier.
Remarque : Dans les éditeurs de design, vous pouvez modifier des designs ayant participé à la génération. Dans ce cas, l'éditeur COBOL PDP ne signale pas un état modifié. Il signale uniquement la désynchronisation entre le design et le code généré avec l’icône Déphasage entre design et code généré. Si vous fermez les éditeurs de design sans sauvegarder, puis fermez l'éditeur COBOL PDP et l'ouvrez à nouveau, il n'apparaît plus déphasé. Il est à noter que si une instance est ouverte dans plusieurs éditeurs de design simultanément, les modifications sont conservées tant que vous n'avez pas fermé le dernier de ces éditeurs sans enregistrer.

Déphasage entre le design et le code généré

Lorsque le design de l’instance générée est modifié, il peut y avoir un déphasage entre le design et le code généré. Dans ce cas, l’icône Déphasage entre design et code généré apparaît, suivie d’un caractère spécial dans le titre de l’onglet de l’éditeur PDP. Le caractère spécial par défaut est > mais vous pouvez le modifier en sélectionnant Fenêtre > Préférences > Programmation pilotée par pattern > Infrastructure PDP > Caractère à utiliser pour mieux visualiser le besoin de regénération dans l’éditeur PDP. Ces signaux vous préviennent qu'une nouvelle génération est requise. Vous pouvez regénérer globalement tous les fichiers déphasés par rapport au design depuis la vue Gestionnaire de génération.
Remarque : Tout déphasage est également signalé dans la vue Design de l’instance. Le bouton permettant la génération se colorise alors (Générer est recommandé suite à des modifications dans le design) pour signifier que Générer est recommandé suite à des modifications dans le design. Une fois la génération effectuée, le déphasage disparaît et le bouton reprend son aspect initial.

Spécificités de l’affichage dans l’éditeur PDP de Code Source

La coloration PDP, en plus de celle de l'éditeur standard, vous permet de connaître l'origine des lignes. Par défaut, les lignes de code généré sont grises et les lignes provenant de micro-patterns sont bleues.

Vous pouvez changer ces couleurs PDP par défaut en sélectionnant Fenêtre > Préférences > Programmation pilotée par pattern > Editeur de Code Source.

Deux symboles en lien avec Rational Programming Patterns peuvent être affichés dans la marge :
  • information est affiché à l'endroit où des lignes de code ont été effacées ou écrasées. Si vous positionnez votre souris sur ce symbole, vous pouvez voir les lignes effacées ou les lignes écrasées par les lignes courantes.
  • avertissement est affiché dans les cas suivants :
    • Sur les lignes où la réconciliation (synchronisation) détecte un problème éventuel. La réconciliation est le processus qui intègre, après une génération, le nouveau design d'une instance avec les changements spécifiques utilisateur. Un avertissement est affiché, par exemple, si la réconciliation n'est pas sûre de l'endroit où le code spécifique doit être placé car plusieurs endroits sont possibles, ou si le code généré écrasé a été modifié.

      Dans la vue Erreurs, ces avertissements sont de type PDP Reconciliation Marker. Vous pouvez les gérer en faisant un clic droit dessus dans la vue Erreurs et en sélectionnant Correctif rapide.

      Par exemple, dans la facette Pacbase, si vous avez remplacé l'appel d'une Macro par une autre Macro, des avertissements de réconciliation peuvent apparaître si la Macro initiale contenait des lignes de code spécifique. Les correctifs rapides vous permettent alors d'effectuer les actions suivantes :
      • Insérer uniquement les lignes de code spécifique de la Macro initiale là où elles était initialement insérées.
      • Insérer les lignes de code spécifique de la Macro initiale avec leur contexte pour conserver la cohérence du code COBOL.
      • Laisser le code tel quel. Les lignes de code spécifique de la Macro initiale sont supprimées.
    • Sur les lignes où un micro-pattern a positionné un avertissement.

Vous pouvez modifier l'affichage dans l'éditeur PDP avec des filtres depuis la vue Structure du Code Généré.


Vos commentaires