Manuel de l`utilisateur - Mia

MIA - Generation
- Manuel de l'utilisateur -

MIA - Generation – Manuel Utilisateur - 2
Cette documentation est la propriété de Mia - Software.
Elle ne peut être reproduite, même partielle ment, sous quelque forme que ce soit, sans autorisation écrite préalable.
Table des matières
PRESENTATION ....................................................................................................................................................... 7
PREAMBULE ............................................................................................................................................................... 7
I NTERETS D ’ UN GENERATEUR DE COD E ...................................................................................................................... 8
Temps de développement réduit ............................................................................................................................ 8
Qualité ................................................................................................................................................................... 8
Adaptabilité ........................................................................................................................................................... 8
Continuité entre la modélisation et l'implémentation ............................................................................................ 9
Réactivité ............................................................................................................................................................... 9
A RCHITECTURE DE MIA -G ENERATION ....................................................................................................................10
A VANTAGES LIES A MIA -G ENERATION ...................................................................................................................11
Facilité d’expression du code généré ..................................................................................................................11
Java comme langage de script .............................................................................................................................11
Approche globale de la génération ......................................................................................................................11
Prise en compte des cycles itératifs .....................................................................................................................11
Support des concepts objets ................................................................................................................................ .11
Prise en compte des profils ..................................................................................................................................11
Evolutivité ...........................................................................................................................................................12
DÉMARRAGE ..........................................................................................................................................................13
MIA -GENERATION ARCHITECT .......................................................................................................................14
P RESENTATION .........................................................................................................................................................14
Concepts de base .................................................................................................................................................14
Les types de scripts ..............................................................................................................................................15
L’organisation des scripts ...................................................................................................................................16
Les packages ........................................................................................................................................................................16
Les types ..............................................................................................................................................................................16
Les catégories ......................................................................................................................................................................16
Les scénarios .......................................................................................................................................................................16
Interface utilisateur .............................................................................................................................................17
Documentation des éléments ...............................................................................................................................19
Statuts des éléments .............................................................................................................................................19
Les statuts des scripts ..........................................................................................................................................................19
Contexte global ...................................................................................................................................................20
Affichage du contexte global ...............................................................................................................................................20
Initialisation du contexte avec la ligne de commande .........................................................................................................20
Navigateur de méta - modèle ................................................................................................................................ .21
E DITION ...................................................................................................................................................................22
Interface Utilisateur du panneau Edition ............................................................................................................22
Chargement et sauvegarde d'éléments ................................................................................................................23
Le projet de générat ion .......................................................................................................................................24
Charger un projet ................................................................................................................................................................ . 24
Sauver un projet ...................................................................................................................................................................24
Créer un projet .....................................................................................................................................................................25
Exporter un projet compilé ..................................................................................................................................................25
Exporter un projet au format Standalone .............................................................................................................................25
Regrouper et Exporter les ressources d’un projet dans un dossier ......................................................................................25
Regrouper et Exporter les ressources d’un projet dans une archive zip ..............................................................................26
Les packages .......................................................................................................................................................27
Créer et éditer un package ...................................................................................................................................................28

MIA - Generation – Manuel Utilisateur - 3
Cette documentation est la propriété de Mia - Software.
Elle ne peut être reproduite, même partielle ment, sous quelque forme que ce soit, sans autorisation écrite préalable.
Modifier les propriétés d'un package ...................................................................................................................................28
Resynchroniser un package .................................................................................................................................................29
Comparer des packages .......................................................................................................................................................29
Les types ..............................................................................................................................................................31
Les catégories ......................................................................................................................................................32
Les scripts ............................................................................................................................................................33
Liste des scripts ...................................................................................................................................................................33
Propriétés des scripts ...........................................................................................................................................................34
Créer et éditer un Text Template .........................................................................................................................................39
Créer et éditer un File Template ..........................................................................................................................................41
Créer et éditer des délimiteurs de code utilisateurs .............................................................................................................43
Créer et éditer une précondition ..........................................................................................................................................47
Créer et éditer une Macro ....................................................................................................................................................48
Créer et éditer un Service ....................................................................................................................................................50
Fonctionnalités d’édition .....................................................................................................................................................51
Naviguer vers un script ........................................................................................................................................................53
Réorganiser des scripts ........................................................................................................................................................55
Tester unitairement les scripts .............................................................................................................................................56
Gérer les conflits de chargement .........................................................................................................................................58
Rechercher un script ...........................................................................................................................................60
Recherche à partir de ses propriétés ....................................................................................................................................61
R echerche des scripts en erreur ...........................................................................................................................................63
Recherche des scripts portant le même nom ........................................................................................................................63
Recherche des scripts appelés ..............................................................................................................................................64
Recherche des scripts appelants ...........................................................................................................................................64
Reche rche des références à un script appelé ........................................................................................................................64
Les scénarios .......................................................................................................................................................65
Créer un scénario ................................................................................................................................................................ . 66
Visibilité d'un scénario ........................................................................................................................................................66
Sauver un scénario ...............................................................................................................................................................66
Charger un scénario .............................................................................................................................................................66
Ajouter et supprimer des éléments de scénario ....................................................................................................................67
Définir les scripts d'une description de génération ..............................................................................................................69
Définir les paramètres d’une transformation de modèle ......................................................................................................72
Les profils ............................................................................................................................................................74
Créer et éditer un profil .......................................................................................................................................................75
Ajouter un type ....................................................................................................................................................................76
Déplacer un type ..................................................................................................................................................................76
Supprimer un type ...............................................................................................................................................................77
Chargement de modèles tenant compte du profil ................................................................................................................77
Création de scripts sur des types du profil ...........................................................................................................................77
Les plugins ..........................................................................................................................................................78
Créer un plugin ....................................................................................................................................................................78
Administrer les plugins ........................................................................................................................................................79
Editer ou charger un plugin .................................................................................................................................................79
Recharger un plugin .............................................................................................................................................................80
Décharger un plugin ............................................................................................................................................................80
Not ion de chemin menant à un menu ..................................................................................................................................80
Ajouter un élément de menu dans un menu contextuel existant ..........................................................................................83
Ajouter un séparateur de menu dans un menu contextuel existant ......................................................................................83
Ajouter un menu dans un menu contextuel existant ............................................................................................................84
Positionner un élément ........................................................................................................................................................84
Notion de plugin pré - requis .................................................................................................................................................86
Utiliser les expressions régulières .......................................................................................................................................86
Liste des menus contextuels actuellement personnalisables ................................................................................................87
G ENERATION ............................................................................................................................................................91
Généralités ..........................................................................................................................................................91
Chargement des modèles .....................................................................................................................................92
Généralités ...........................................................................................................................................................................92
Importer un modèle depuis un AGL ....................................................................................................................................93
Synchroniser le modèle .......................................................................................................................................................93
Consulter un modèle ............................................................................................................................................................94
Génération par scénario grâce à un lanceur .......................................................................................................95
Générations unitaires ..........................................................................................................................................97
Créer une génération unitaire ...............................................................................................................................................97

MIA - Generation – Manuel Utilisateur - 4
Cette documentation est la propriété de Mia - Software.
Elle ne peut être reproduite, même partielle ment, sous quelque forme que ce soit, sans autorisation écrite préalable.
Sélection des scripts .............................................................................................................................................................98
Sélection des objets source ..................................................................................................................................................98
Options de génération .......................................................................................................................................100
Options générales de génération ........................................................................................................................................100
Options du contexte ...........................................................................................................................................................101
Options des fichiers ...........................................................................................................................................................103
Options de rapport de génération .......................................................................................................................................103
Paramètres de transformation ...........................................................................................................................................105
Consulter le résultat d'une génération ...............................................................................................................106
Détection des erreurs de génération ..................................................................................................................107
Résolution des erreurs de génération ................................................................................................................................ . 107
Rapport de génération .......................................................................................................................................108
Rapport de génération .......................................................................................................................................108
Contenu d’un rapport de génération ..................................................................................................................................108
Créer un rapport de génération ..........................................................................................................................................109
Consulter le rapport de génération courant ........................................................................................................................110
Charger un rapport de génération ......................................................................................................................................111
Sauver un rapport de génération ........................................................................................................................................111
Trace de génération ...........................................................................................................................................112
Trace de transformation .....................................................................................................................................................113
Sauver une trace de génération ..........................................................................................................................................113
Points d’arrêt ....................................................................................................................................................114
Opérations de base sur un point d’arrêt .............................................................................................................................114
Gérer l’ensemble des points d’arrêt d’un projet ................................................................................................................115
Déboguer en utilisant les points d’arrêt .............................................................................................................................115
Point d’arrêt conditionné ...................................................................................................................................................117
A PIS ET NOTIONS AVANC EES ..................................................................................................................................118
Syntaxe des scripts Java ....................................................................................................................................118
La variable current .............................................................................................................................................................118
La variable context ............................................................................................................................................................118
Les accesseurs ...................................................................................................................................................................121
Les appels de scripts ..........................................................................................................................................................122
La méthode action .............................................................................................................................................................123
La méthode getString .........................................................................................................................................................123
La méthode getList ............................................................................................................................................................124
Les méthodes de conversion de type ................................................................................................................................ . 125
La méthode apply ..............................................................................................................................................................127
La méthode collect .............................................................................................................................................................128
La méthode select ..............................................................................................................................................................129
La méthode detect ..............................................................................................................................................................130
La méthode reject ..............................................................................................................................................................131
La méthode sort ................................................................................................................................................................ . 132
La méthode superAction ....................................................................................................................................................133
La méthode getPropertyValue ...........................................................................................................................................134
Appel des scripts avec paramètres ....................................................................................................................135
Nommage des paramètres ..................................................................................................................................................135
Typage des paramètres ......................................................................................................................................................135
Appel des scripts avec paramètres depuis les templates ....................................................................................................135
Utilisation des paramètres dans les scripts Java : macros et services ................................................................................138
Accès à des composants Java externes depuis MIA - Generation .......................................................................................139
Gestion avancée des modèles ............................................................................................................................140
Profils des modèles UML ..................................................................................................................................................140
Particularités de l'import XMI ...........................................................................................................................................140
Particularités de l'import Rational Rose ............................................................................................................................141
Développer des imports de modèles spécifiques ...............................................................................................................142
Exploitation du rapport de génération dans les scripts .....................................................................................145
Accès au rapport de génération ..........................................................................................................................................145
L’objet Report ...................................................................................................................................................................146
Les objets ReportGeneratedFile ........................................................................................................................................146
Les objets ReportModelFile, ReportPackage, ReportScenario, ReportProfile ..................................................................147
Les objets ReportProject ....................................................................................................................................................147
Le type ReportComparisonStatus ......................................................................................................................................147
Le type ReportGenerationStatus ........................................................................................................................................147
MIA - GENERATION DEVEL OPER .....................................................................................................................148

MIA - Generation – Manuel Utilisateur - 5
Cette documentation est la propriété de Mia - Software.
Elle ne peut être reproduite, même partielle ment, sous quelque forme que ce soit, sans autorisation écrite préalable.
P RESENTATION .......................................................................................................................................................148
Concepts de base ...............................................................................................................................................148
Interface Utilisateur ..........................................................................................................................................149
G ENERATION ..........................................................................................................................................................151
Cré ation d'un lanceur ........................................................................................................................................151
Sélection d'un projet ..........................................................................................................................................................151
Sélection du scénario de génération ..................................................................................................................................151
Sélection du modèle ...........................................................................................................................................................151
Synchroniser le projet ........................................................................................................................................................152
Synchroniser le modèle .....................................................................................................................................................152
Options de génération ........................................................................................................................................................152
Lancement de la génération ..............................................................................................................................152
Consulter le résultat d'une génération ...............................................................................................................152
M ODE SILENCIEUX ................................................................................................................................................. 152
MODULE ANALYSIS ............................................................................................................................................153
P RESENTATION .......................................................................................................................................................153
S TATUT DES FICHIERS G ENERES .............................................................................................................................154
P ORTIONS DE CODE ................................................................................................................................................155
A LERTES ................................................................................................................................................................158
Balises non regénérées ......................................................................................................................................158
Anomalie suspecte .............................................................................................................................................159
Fichiers non regénérés ......................................................................................................................................160
METRIQUES ............................................................................................................................................................161
Statistiques de génération ..................................................................................................................................................162
A CTIVATION DU MODULE .......................................................................................................................................162
LIGNE DE COMMANDE ......................................................................................................................................163
P RESENTATION .......................................................................................................................................................163
S ELECTION D 'UN PROJET .........................................................................................................................................164
Mode graphique ................................................................................................................................................164
Mode silencieux .................................................................................................................................................165
MIA - Generation Developer ...............................................................................................................................................165
MIA - Generation Architect .................................................................................................................................................166
G ESTION DU RAPPORT DE GENERATION ..................................................................................................................167
P ARAMETRES DE TRANSFO RMATION ......................................................................................................................167
S UR CHARGE DES PREFERENC ES UTILISATEUR .........................................................................................................168
V ARIABLES DU CONTEXTE DE GENERATION ...........................................................................................................169
PRÉFÉRENCES ......................................................................................................................................................170
P RÉSENTATION .......................................................................................................................................................170
P RÉFÉRENCES GÉNÉRALES .....................................................................................................................................171
P RÉFÉRENCES D ' IMPORT .........................................................................................................................................172
P REFERENCES DES SCRIP TS ....................................................................................................................................173
Textes par défaut des scripts .............................................................................................................................174
Délimiteurs de Scripts .......................................................................................................................................174
P REFERENCES DE TRANSF ORMATION ......................................................................................................................175
P REFERENCES DE NOTIFI CATION ............................................................................................................................176
P REFERENCES DE RACCOU RCIS ...............................................................................................................................178
P REFERENCES DE CONFIG URATION .........................................................................................................................179
ENVIRONNEMENT ...............................................................................................................................................181
P RESENTATION .......................................................................................................................................................181
MIA -G ENERATION .................................................................................................................................................181
Répertoire bin ....................................................................................................................................................181
Répertoire compiler ...........................................................................................................................................................181
Répertoire lib .....................................................................................................................................................................181
Répertoire resources ..........................................................................................................................................................181
Répertoire flexlm ...............................................................................................................................................181
Répertoire examples ..........................................................................................................................................181
Répertoire generation ........................................................................................................................................182