Powerd911 – Numéro #1 au Canada

Comment générer les commentaires pour les procédures et fonctions pour un schéma de base de données?

Vous avez un modèle de données physique avec des procédures et/ou des fonctions et vous désirez que les commentaires associés à ces objets soient générés dans votre SGBD.

Je vous propose deux façons afin d’être en mesure de générer les commentaires de vos procédures/fonctions :

  1. Personnaliser votre copie d’un fichier de ressource SGBD (.XDB) – Inconvénient spécifique a une version d’un SGBD ;
  2. Développer votre propre définition étendue afin de générer un script SQL avec les commandes appropriées – Avantage peut-être utilisé avec plus d’un SGBD/version.

Compatible avec PowerDesigner/PowerAMC 16.5

Solution#1:

1* Cliquer sur « Menu=>Éditer le SGBD courant »

2* Sélectionner dans l’arborescence « ScriptObjectsProcedure » et cliquer sur le côté droit de votre souris

3* Sélectionner « Ajouter un nouvel élément… »

4* Cocher les deux objets « ProcedureComment » et « FunctionComment »

5* Cliquer sur OK

6* Sélectionner dans le « Menu=>SGBD=>Généré la base de données… », cliquer sur l’onglet « Options » et cliquer sur l’objet « Procédure… »

7* Assurez-vous que l’objet « Commentaire » est coché. Note 1

8* Générer la base de données et prenez connaissance des requêtes SQL qui vont vous permettre de mettre en place les commentaires pour vos procédures, fonctions dans votre SGBD.

Note 1 : Il est probable que vous deviez fermer PowerAMC et l’ouvrir à nouveau afin d’être en mesure de prendre connaissance de l’option « Commentaire »

Solution#2:

// Création d’une extension XEM

1* Sélectionner « Outils=>Ressources=>Extension=>Modèle physique de données… » afin de créer une nouvelle extension

2* Cliquer sur l’icône « Nouveau »

3* Inscrivez le nom de votre nouvelle extension, Ex. « Générer les commentaires pour les procédures & les fonctions »

4* Laisser « Copier de » à <Default template> et cliquer sur OK

5* Sélectionner un répertoire ou vous désirez sauvegarder votre extension

6* Cliquer sur le bouton Enregistrer.

7* La fenêtre des propriétés de l’extension apparaît

8* Sélectionner le dossier « Profile », cliquer sur le côté droit de la souris et sélectionner « Ajouter des métaclasses… »

9* Sélectionner l’onglet « PdPDM », cocher la métaclasse « Model » et cliquer sur OK

10* Sélectionner la métaclasse « Model » et cliquer sur le côté droit de votre souris afin de sélectionner « Nouveau=>Templates »

11* Un nouveau dossier nommé ‘Templates’ ainsi qu’un nouvel étément sont créés

12* Modifier le nom de l’élément « Template 1 » par « Gabarit_GenProcCommentaire » et insérer les lignes suivantes

.foreach_item(Packages)

.foreach_item(Procedures)

COMMENT ON PROCEDURE %Code% IS ‘%Comment%’;

.next(
)

.next(
)

.foreach_item(Procedures)

COMMENT ON PROCEDURE %Code% IS ‘%Comment%’;

.next(
)

13* Sélectionner la classe « Model » et cliquer sur le côté droit de votre souris afin de sélectionner « Nouveau=>Fichier généré ». Un dossier nommé ‘Generated Files’ ainsi qu’un élément ‘File_1″ ont été créés

14* Renommer « File_1 » pour « Fichier DDL », inscire comme nom de fichier « GenProcCommentaire.sql », sélectionner comme type de fichier « .sql », assurez-vous de sélectionner le codage « ANSI (Page de code active) » et de cocher « Utiliser la hiérarchie des packages comme chemin d’accès ». Finalement insérer la ligne suivante.

%Gabarit_GenProcCommentaire%

15* Sélectionner le dossier ‘Generation’ et cliquer sur le côté droit de votre souris afin de sélectionner « Nouveau=>Commands ». Un nouveau dossier nommé « Commands » et un nouvel élément ont été créés.

16* Remplacer le nom de la commande « Commande_1 » par « CmdProcCommentaire » et insérer les lignes suivantes suivantes:

..// On débute ici

.log Start CmdProcCommentaire in Extended model definition

.log File output on %CurrentDate% – démarré par %CurrentUser%

.warning L’exécution de CmdProcCommentaire est maintenant terminé, Cette ligne de code a été rédigée dans Generation=>Commands

17* Sélectionner le dossier « Generation » et cliquer sur le côté droit de la souris afin de sélectionner « Nouveau=>Tâche ». Un nouveau dossier ainsi qu’un élément ont été créés

19* Remplacer le nom de la tâche « Tâche_1 » par « Tache_GenProcCommentaire », y associer la commande « GenProcCommentaire » et cliquer sur OK

20* Sélectionner « Menu=>Modèle>Extension… »

21* Cliquer sur l’icône « Attacher une extension »

22* Sélectionner le fichier de définition que vous avez créé, (Note 2) et cliquer sur OK

Note 2: Si votre fichier d’extension n’est pas présent. Assurez-vous que le répertoire ou vous l’avez déposé a été inclus dans les répertoires de choix pour lesquels PowerAMC va regarder. Pour ce faire cliquer sur l’icône « Dossier » et ajouter votre répertoire.

23* Sélectionner « Menu=>Outils>Génération étendue… »

24* Spécifier le répertoire ou vous désirez conserver le fichier « .sql »

25* Assurez-vous qu’au niveau de l’onglet cible que votre définition est sélectionnée

26* Assurez-vous qu’au niveau de l’onglet Tâche que vôtre tâche est sélectionnée

27* Cliquer sur OK

28* Prenez connaissance du fichier généré, vous devriez prendre connaissance d’un ou de plusieurs commande(s) SQL semblable à la commande ci-dessous.

COMMENT ON PROCEDURE PROCEDURE_1 IS ‘Commentaire à propos de la procédure_1’;

 

Laisser un commentaire