Personnalisation de la génération à l'aide du langage de génération par template

Le langage de génération par template (GTL, Generation Template Language) est utilisé pour extraire des propriétés d'objet de modèle sous forme de texte. Le GTL est écrit sous forme de templates et de fichiers générés définis sous des métataclasses dans des fichiers de définition de langage ou d'extension. Le GTL alimente la génération de code pour les langages de processus métiers, orientés objet et XML, et peut être utilisé afin de définir de nouvelles génération pour tout type de modèle.

Lorsque vous lancez une génération à partir d'un modèle, PowerAMC génère un fichier pour chaque instance de la métaclasse pour laquelle vous avez défini un fichier généré (voir Fichiers générés (Profile)) en évaluant le templates qu'il appelle et en résolvant les éventuelles variables.

Le langage de génération par template est un langage orienté objet, et il prend en charge l'héritage et le polymorphisme afin de permettre que le code soit réutilisable et modifiable, il fournit des macros permettant de tester les variables et de procéder à l'itération des collections, etc.

• Création d'un template et d'un fichier généré
  Les templates de GTL sont souvent utilisés pour générer des fichiers. Si votre template doit être utilisés pour la génération, il doit être référencé dans un fichier généré.
• Extraction des propriétés d'objet
  Les propriétés d'objet sont référencées sous la forme de variables et encadrées de signe pourcent : %variable%. Les noms de variable sont sensibles à la casse, et les noms de propriétés sont, par convention, définis en casse CamelCase (mots collés, avec une majuscule au début de chaque mot).
• Accès aux collections de sous-objets ou d'objets associés
  Un MOO contient une collection de classe et des classes contiennent des collections d'attributs et d'opérations. Pour procéder à l'itération d'une collection, utilisez la macro .foreach_item.
• Mise en forme de votre résultat
  Vous pouvez changer le format des variables en incorporant des options de mise en forme dans la syntaxe des variables. Les nouvelles lignes et les tabulations sont spécifiées respectivement à l'aide des séquence d'échappement \n et \t.
• Blocs conditionnels
  Placez entre crochets du texte contenant une variable afin de faire en sorte qu'il apparaisse uniquement si la variable est résolue en une valeur non-nulle.
• Accès aux variables globales
  Vous pouvez insérer des informations telles que votre nom d'utilisateur et la date courante à l'aide de variables globales.
• Opérateurs du langage de génération par template
  Le langage de génération par template prend en charge des opérateurs arithmétiques et logiques standard ainsi que certains opérateurs de template avancés.
• Portée de la conversion
  La portée initiale d'un template est toujours la métaclasse sur laquelle le template est défini. Tous les attributs standard et étendus, toutes le collections et les templates définis sur la métaclasse d'objet active et ses parents sont visibles, mais un seul objet est actif à la fois.
• Conversion d'un raccourci
  Les raccourcis sont déréférencés lors de la conversion : la portée de l'objet cible remplace la portée du raccourci.. Ce comportement est différent de celui de VB Script, dans lequel la conversion du raccourci récupère le raccourci lui-même. Vous pouvez utiliser la variable %IsShortcut% pour tester si un objet est un raccourci, puis le mot clé Shortcut pour accéder aux propriétés du raccourci lui-même.
• Séquences d'échappement
  Le langage de génération par template prend en charge différentes séquences d'échappement permettant de simplifier la présentation de vos templates et fichiers générés, et de rendre accessibles les caractères réservés.
• Appel de templates
  Vous pouvez appeler un template depuis un fichier généré ou depuis un autre template en saisissant son nom entre signes pourcent. Les propriétés et collections d'objet, et les variables locales et globales sont appelées de la même manière. Au moment de la génération, un appel de template est remplacé pour le contenu du template, qui est ensuite résolu dans sa valeur textuelle finale.
• Extensions du métamodèle spécifiques au langage de génération par template
  Un grand nombre d'attributs et de collections calculés sont fournis sous la forme d'extensions du métamodèle spécifiques au langage de génération par template.
• Guide de référence des macros du langage de génération par template
  Le langage de génération par template (GTL) prend en charge des macros pour exprimer la logique de template, et pour boucler sur les collections d'objets. Chaque mot clé de macro doit être précédé d'un caractère . (point), et doit être le premier caractère, autre qu'un espace, sur une ligne. Prenez soin de respecter la syntaxe des macros en termes de passage à la ligne.
• Syntaxe du langage de génération par templates et erreurs de conversion
  Les messages d'erreur interrompent la génération des fichiers dans lequel les erreurs ont été détectées, et ces erreurs sont affichées dans l'onglet Aperçu de la feuille de propriétés d'objet correspondante.