Obeo SmartEA - Guide de personnalisation v4.2.0 Obeo SmartEA - Guide de personnalisation v4.2.0 1. Introduction ........................................................................................................................................................... 6 2. Pré-requis ............................................................................................................................................................. 7 3. Installer SmartEA Developer ................................................................................................................................ 8 4. Créer un connecteur SmartEA ............................................................................................................................. 9 5. Créer un module SmartEA ................................................................................................................................. 11 5.1. Principes généraux ..................................................................................................................................... 11 5.1.1. Structure d’un module ........................................................................................................................ 11 5.1.2. Création d’un plug-in .......................................................................................................................... 11 5.1.3. Exemple de module ........................................................................................................................... 12 5.1.4. Injection de dépendance .................................................................................................................... 12 5.1.5. Gestion des logs ................................................................................................................................ 13 5.2. Personnaliser le méta-modèle .................................................................................................................... 13 5.2.1. Compatibilité CDO .............................................................................................................................. 13 5.2.2. Relations inverses .............................................................................................................................. 14 5.2.3. Gestion des identifiants d’objets ........................................................................................................ 14 5.2.4. Propriétés dynamiques ....................................................................................................................... 15 5.2.5. Ressources externes .......................................................................................................................... 15 5.2.6. Déploiement ....................................................................................................................................... 15 5.2.7. Documentation intégrée ..................................................................................................................... 15 5.3. Ajouter un manuel d’aide spécifique .......................................................................................................... 15 5.3.1. Création du plug-in de documentation ............................................................................................... 16 5.3.2. Rédaction du manuel ......................................................................................................................... 17 5.3.3. Internationalisation .............................................................................................................................. 18 5.3.4. Déploiement ....................................................................................................................................... 20 5.4. Ajouter un générateur ................................................................................................................................ 20 5.4.1. Générateurs Acceleo .......................................................................................................................... 20 5.4.2. Générateurs Java ............................................................................................................................... 27 5.4.3. Générateurs M2Doc ........................................................................................................................... 27 5.4.4. Définition du libellé d’un générateur .................................................................................................. 27 5.4.5. Déploiement d’un générateur dans SmartEA ..................................................................................... 28 5.5. Ajouter une vue Sirius ................................................................................................................................ 28 5.5.1. Création de la vue ............................................................................................................................. 28 5.5.2. Test de la vue (avant déploiement) ................................................................................................... 29 p. 3 / 58 Obeo SmartEA - Guide de personnalisation v4.2.0 5.5.3. Déploiement ....................................................................................................................................... 30 5.6. Autres personnalisations courantes ........................................................................................................... 31 6. Valider le référentiel avec Java .......................................................................................................................... 33 6.1. Créer une librairie de validation ................................................................................................................. 33 6.2. Importer une librairie de validation ............................................................................................................. 36 6.3. Référencer la nouvelle librairie dans l'éditeur de prisme ........................................................................... 36 6.4. Lancer une validation ................................................................................................................................. 37 7. Glossaire des points d’extensions ...................................................................................................................... 39 7.1. API Commune ............................................................................................................................................ 39 7.1.1. Ajouter un générateur ........................................................................................................................ 39 7.1.2. Redéfinir des fournisseurs de labels et d’images .............................................................................. 39 7.1.3. Contribuer des services AQL ............................................................................................................. 40 7.2. API du serveur ........................................................................................................................................... 40 7.2.1. Modifier la gestion des utilisateurs ..................................................................................................... 40 7.2.2. Modifier la gestion des accès ............................................................................................................ 41 7.2.3. Configurer les objets de contexte des artefacts de la page d’accueil ................................................ 41 7.2.4. Ajouter des services HTTP ................................................................................................................ 43 7.2.5. Ecouter les commits ........................................................................................................................... 43 7.2.6. Paramétrer l’import/export Excel en ajoutant un résolveur d’identifiants dérivés ............................... 43 7.2.7. Paramétrer l’export Excel en spécifiant le contenu à exporter ........................................................... 44 7.2.8. Se brancher sur l’initialisation du serveur .......................................................................................... 44 7.2.9. Contribuer des références dérivées ................................................................................................... 45 7.2.10. Implémenter un «fournisseur» d’artefact (Non supporté) ................................................................. 45 7.3. API du modeleur ........................................................................................................................................ 46 7.3.1. Réagir au changements de projet, branche et/ou prisme .................................................................. 46 7.3.2. Ajouter un feedback utilisateur listant les objets avant suppression .................................................. 46 7.3.3. Contribuer des préférences projet ...................................................................................................... 47 7.3.4. Contribuer des préférences utilisateur ............................................................................................... 48 7.3.5. Restreindre le glisser-déposer dans l’explorateur de modèle ............................................................ 48 7.3.6. Ajouter des filtres spécifiques à la barre de recherche de l’explorateur