Fichiers d'extension

Les fichiers d'extension (*.xem) permettent de personnaliser et d'étendre les métaclasses, paramètres et génération de PowerAMC. Vous pouvez utiliser des extensions afin de définir des propriétés supplémentaires pour des types de données existants ou de nouveaux types d'objets, pour modifier l'interface de PowerAMC (en réorganisant et ajoutant des onglets de feuilles de propriétés, des outils de Boîte à outils et des commandes de menus), mais aussi afin de définir des cibles et options de génération supplémentaires.

PowerAMC fournit des fichiers d'extension prédéfinis et vous pouvez créer vos propres fichiers d'extension. Chaque fichier d'extension contient deux catégories de premier niveau :

Generation - permet de développer et de compléter la génération d'objets par défaut de PowerAMC (pour les MPM, MOO et MSX) ou de créer une génération séparée. Pour plus d'informations, voir Catégorie Generation.
Profile - un mécanisme d'extension UML, qui est utilisé afin d'étendre un métamodèle pour une cible particulière. Les profils sont utilisés dans PowerAMC afin d'ajouter des métadonnées supplémentaires aux objets et pour créer de nouveaux types de liens entre eux, pour sous-diviser les types d'objet (via les stéréotypes et critères), personnaliser les symboles, menus et formulaires, et pour modifier les résultats de génération. Par exemple :
- Fichier de ressource du langage objet Java 5.0 - étend la métaclasse Component avec plusieurs niveaux de critères afin de modéliser différentes formes d'EJB.
- Fichier de ressource du langage de processus BPEL4WS 1.1 - étend la métaclasse Event via des stéréotypes pour modéliser des événements Compensation, Fault et Timer
- Fichier de ressource SGBD MSSQLSRV2005 - utilise des objets étendus stéréotypés afin de modéliser les agregates, les assemblies et autres objets spécifiques à SQL Server
Vous pouvez étendre le métamodèle des façons suivantes :
- Ajoutez ou sous-classifiez de nouveaux types d'objets :
  - Métaclasses – tirées du métamodèle comme base pour l'extension.
  - Stéréotypes [pour les métaclasses et les stéréotypes uniquement] – pour sous-classifier les objets.
  - Critères – Pour évaluer des conditions afin de sous-classifier des objets.
  - Objets, sous-objets et liens étendus – pour créer de nouveaux types d'objet.
- Fournissez de nouveaux moyens de visualiser les connexions entre objets :
  - Matrices de dépendances – pour montrer les connexions entre deux types d'objets.
  - Collections et compositions étendues – pour permettre de lier manuellement des objets.
  - Collections calculées – pour lier automatiquement des objets.
- Ajoutez de nouvelles propriétés aux objets et affichez-les :
  - Attributs étendus – pour fournir des métadonnées supplémentaires.
  - Formulaires – pour afficher des onglets ou des feuilles de propriétés personnalisés.
  - Symboles personnalisés – pour vous aider à distinguer visuellement des objets.
- Ajoutez des contraintes et des règles de validation sur les objets :
  - Vérifications personnalisées – pour tester les données.
  - Gestionnaires d'événement – pour appeler des méthodes lorsqu'un événement se produit.
- Exécutez des commande sur les objets :
  - Méthodes – pour être appelées par d'autres extensions de profil telles que des menus et boutons de formulaire (écrites en VBScript).
  - Menus [pour les métaclasses et stéréotypes uniquement] – pour personnaliser les menus PowerAMC.
- Générez des objets de nouvelles manières :
  - Templates et fichiers générés – pour personnaliser la génération.
  - Transformations et profils de transformation – pour automatiser les changements sur les objets lors de la génération ou à la demande.

Vous pouvez visualiser et éditer le profil dans un fichier de ressource en ouvrant ce dernier dans l'Editeur de ressources et en développant la catégorie Profile racine. Vous pouvez ajouter des extensions à une métaclasse (un type d'objet, telle que Class dans un MOO ou Table dans un MPD), ou à un stéréotype ou critère, qui a été précédemment défini sur une métaclasse :

Dans l'exemple ci-dessus :

Class est une métaclasse. Les métaclasses proviennent du métamodèle PowerAMC, et apparaissent toujours à la racine, immédiatement sous la catégorie Profile.
MonCritère est un critère qui affine la métaclasse Class. Les classes qui remplissent le critère peuvent être présentées et traitées différemment des autres classes.
MonStéréotype est un stéréotype qui affine la métaclasse Class. Les classes ayant le stéréotype MonStéréotype peuvent être présentées et traitées différemment des autres classes.
AutreCritère est un critère qui affine encore plus les classes portant le stéréotype MonStéréotype. Les classes ayant le stéréotype ET qui remplissent le critère peuvent être présentées et traitées différemment des classes qui on seulement le stéréotype.

Les extensions sont héritées, ainsi les extensions d'une métaclasses sont disponibles pour ses enfants stéréotypés, et par celles auxquelles s'applique le critère.

Ainsi, dans l'exemple ci-avant, les classes ayant le stéréotype MonStéréotype ont l'attribut étendu Attribut_5, tandis que ceux qui ont ce stéréotype ET remplissent le critère AutreCritère ont l'attribut Attribut_4 et l'attribut Attribut_5

Remarque : Etant donné que vous pouvez attacher plusieurs fichiers de ressources à un modèle (par exemple, un langage cible et un ou plusieurs fichiers d'extension) vous pouvez créer des conflits, dans lesquels plusieurs extensions portant un nom identique (par exemple, deux définitions de stéréotype différentes) sont définies sur la même métaclasse dans des fichiers de ressources distincts. Si un tel conflit se produit, le fichier d'extension prévaut le plus souvent. Lorsque deux extensions sont en conflit, la priorité va à celui qui apparaît le premier dans la liste.

Création d'un fichier d'extension
Vous pouvez créer un fichier d'extension à partir de la liste des fichiers d'extension ou directement incorporé dans votre modèle.
Attachement d'extensions à un modèle
Les extensions peuvent être des fichiers *.xem indépendants attachés aux modèles ou peuvent être incorporés dans les fichiers de modèles. Les fichiers d'extension indépendants peuvent être référencés par plusieurs modèles, auquel cas toute modification apportée dans un tel fichier sont partagées par tous les modèles auxquels il est attaché. En revanche, les modifications apportées aux fichiers d'extension incorporés dans un fichier de modèle n'affectent que ce modèle.
Exportation d'un fichier d'extension incorporé à partager
Si vous exportez une extension créée dans un modèle, elle devient disponible dans la boîte de dialogue Liste des extensions, et peut être partagée avec d'autres modèles. Lorsque vous exportez une extension, l'original reste incorporé dans le modèle.
Propriétés d'une extension
Tous les fichiers d'extension ont la même structure de catégories de base.
Exemple : Ajout d'un nouvel attribut à partir d'une feuille de propriétés
Dans cet exemple, nous allons rapidement ajouter un attribut directement dans la feuille de propriétés d'un objet. PowerAMC va gérer la création du fichier d'extension ainsi que la création de toutes les extensions nécessaires.
Exemple : Création d'extensions de diagramme de robustesse
Dans cet exemple, nous allons recréer le fichier d'extension Robustness Analysis fourni avec PowerAMC afin d'étendre le diagramme de communication du MOO. Les diagrammes de robustesse se trouvent entre les diagrammes de cas d'utilisation et le diagramme de séquence, et permettent de combler le vide existant entre ce que le système doit faire et comment il va s'y prendre pour accomplir sa tâche.
Extension de la génération et création de nouvelles cibles de génération
Les extensions peuvent être utilisées pour étendre la génération et créer de nouvelles cibles de génération.
Métaclasses (Profile)
Les métaclasses sont des classes tirées du métamodèle PowerAMC, et qui s'affichent à la racine de la catégorie Profile. Vous devez ajouter une métaclasse à un profil lorsque vous souhaitez étendre ce dernier.
Stéréotypes (Profile)
Les stéréotypes sont un mécanisme d'extension par instance. Lorsqu'un stéréotype est appliqué à une instance de métaclasse (en le sélectionnant dans la zone Stéréotype de la feuille de propriétés de l'objet), les extensions que vous ajoutez au stéréotype sont ensuite appliquées à l'instance.
Critères (Profile)
Vous pouvez contrôler le traitement des instances d'une métaclasse en fonction de leur respect d'un ou de plusieurs critères. Alors que vous ne pouvez appliquer qu'un stéréotype à une instance de métaclasse, vous pouvez tester l'instance en fonction de plusieurs formes de critères.
Objets, sous-objets et liens étendus (Profile)
Les objets, sous-objets et liens étendus sont des métaclasses spéciales qui sont conçues pour vous permettre d'ajouter des types entièrement nouveaux d'objets dans vos modèles, plutôt que de les baser sur des objets PowerAMC existants
Matrices de dépendances (Profile)
La matrices de dépendance permet de passer en revue et de créer des liens entre des objets de n'importe quel type. Vous spécifiez une métaclasse pour la ligne de matrice, et la même ou une autre métaclasse pour les colonnes. Le contenu des cellules est ensuite calculé à partir d'une collection ou d'un objet lien.
Attributs étendus (Profile)
Les attributs étendus permettent de définir des métadonnées supplémentaires pour vos objets.
Collections et compositions étendues (Profile)
Une collection étendue permet d'associer plusieurs instances d'une métaclasse avec une instance d'une autre métaclasse.
Collections calculées (Profile)
Vous définissez une collection calculée sur une métaclasse, un stéréotype ou un critère lorsque vous devez afficher une liste d'objets associés avec une sémantique personnalisée.
Formulaires (Profile)
Vous pouvez utiliser des formulaires afin de créer de nouveaux onglets de feuille de propriétés ou de remplacer des onglets existants, ou bien pour créer des boîtes de dialogue qui s'ouvrent grâce à des commandes de menus ou en cliquant sur des boutons sur vos onglets de feuilles de propriétés. La création d'un nouveau formulaire est une opération simple et facile en utilisant les outils de création de formulaire contenus dans l'éditeur de ressources.
Symboles personnalisés (Profile)
Un symbole personnalisé permet de modifier l'apparence des instances de la métaclasse, du stéréotype ou du critère.
Vérifications personnalisées (Profile)
Les vérifications personnalisées sont des vérifications de modèles, écrites en VBScript, qui permettent de vérifier que les objets de vos modèles sont correctement définis. Les vérifications personnalisées sont répertoriées avec les vérifications standard dans la boîte de dialogue Vérification de modèle.
Gestionnaires d'événement (Profile)
Un gestionnaire d'événement peut lancer automatiquement un script VBScript lorsqu'un événement se produit sur un objet. Vous pouvez associer un gestionnaire d'événement à une métaclasse ou à un stéréotype ; les critères ne prennent pas en charge les gestionnaires d'événement.
Méthodes (Profile)
Les méthodes permet d'effectuer des actions sur les objets.
Menus (Profile)
Vous pouvez ajouter des menus dans l'interface de PowerAMC et les remplir avec des commandes qui appellent des fonctions de méthode ou des transformations.
Templates et fichiers générés (Profile)
Vous pouvez définir des templates et des fichiers générés pour les métaclasses, stéréotypes et critères. Si un template s'applique à toutes les métaclasses, vous devez le créer dans la catégorie Shared.
Transformations et profils de transformation (Profile)
Une transformation définit un jeu d'actions à exécuter lors d'une génération ou sur demande. Vous définissez une transformation dans la catégorie Profile d'une extension sur une métaclasse, sur un stéréotype ou sur un critère.