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