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.

Le langage de génération par template (GTL, Generation Template Language) permet de générer des fichier pour les métaclasses et le scripting (voir Personnalisation de la génération à l'aide du langage de génération par template). Vous créez un template à l'aide du GTL, en utilisant des variables qui permettent d'accéder aux propriétés de l'objet courant ou de n'importe quel autre objet dans le modèle.

Dans l'exemple suivant, la catégorie Generated Files pour les classificateurs contient une entrée Java Source, qui contient elle-même une référence au template %source%. Lorsque le fichier est généré pour un classificateur donné ou pour les instances d'un classificateur avec un stéréotype ou critère sélectionné, il a le nom spécifié dans la zone Nom de fichier, et aura le contenu généré par ce template :

Remarque : Si vous placez votre curseur entre les signes pourcent qui encadrent le nom de ce template ou de tout autre template et appuyez sur F12, vous passez directement au template référencé ou, si plusieurs templates portent le même nom, une boîte de dialogue Résultats s'affiche pour vous permettre de sélectionner le template vers lequel vous souhaitez naviguer.

Le template référencé, source, contient du code de langage de génération par template qui permet de générer le contenu du fichier, y compris les références aux autres templates appelés :

%isSourceGenerated%
%sourceHeader%
%package%
%imports%

Création d'un template
Les templates peuvent être créés dans la catégorie Shared lorsque vous les appliquez à toutes les métaclasses. Ils peuvent également être créés au niveau de la métaclasse ou pour un stéréotype ou critère donné.
Création d'un fichier généré
La catégorie Generated Files contient une entrée pour chaque type de fichier généré pour les métaclasses, stéréotypes ou critères. Seuls les fichiers définis pour les objets appartenant directement à une collection de modèle ou de package seront générés. Les sous-objets, tels que les attributs, les colonnes ou les paramètres, ne prennent pas en charge la génération de fichier, mais il peut être intéressant d'examiner le code généré pour ces sous-objet dans leur volet Aperçu.
Exemples de fichiers générés
Un fichier est généré pour chaque entrée de la catégorie Generated File située sous une métaclasse, un stéréotype ou critère, à condition que la zone Nom de fichier ne soit pas laissée à blanc. Si aucun nom de fichier n'est spécifié, ou si seul un suffixe de nom de fichier est spécifié, le contenu du fichier généré peut tout de même être affiché dans l'onglet Aperçu de la feuille de propriétés de l'objet.

Sujet parent : Fichiers d'extension