SIDE1:Manual:Quick Start/fr
From SIDE-Labs.org
Ce tutoriel illustre l'utilisation de BlueXML Developer Studio avec le générateur Alfresco. Premièrement, nous présenterons les outils utilisés dans ce tutoriel. Deuxièmement, nous présenterons la création d'un modèle et finalement l'intégration à Alfresco.
| Télécharger le project Eclipse |
Contents |
Outils et installation
BlueXML Developer Studio
Bien évidemment, nous utilisons BlueXML Developer Studio. Notre modeleur et ses fonctionnalités sont des plugins Eclipse. Il est partiellement généré par TopCased qui fournit une approche de génération d'éditeur graphique à partir d'un méta-modèle. BlueXML Developer Studio peut être ajouté à une installation précédente d'Eclipse. Mais actuellement, vous pouvez seulement télécharger la version RCP (Plateforme Client Riche). Notre version RCP contient tous les plugins nécessaires pour utiliser notre modeleur : Ecipse, nos plugins, TopCased, Acceleo, ATL...
Vous pouvez télécharger le RCP correspondant à votre système d'exploitation ici :
Vous obtenez un fichier ZIP, vous devez le décompresser où vous le souhaiter et ensuite éxécuter Eclipse traditionnellement.
Liens :
Alfresco
Avec notre éditeur, vous pouvez rédiger des modèles. Pour utiliser ces modèles, nous fournissons seulement un générateur Alfresco. Alfresco offre une vraie alternative Open Source pour la Gestion de Contenu d'Entreprise (ECM) - Gestion de Documents, Collaboration, Gestion des Archives/Enregistrements légaux, Gestion de Contenu Web et Gestion des Documents Numérisés. Nous décrivons ici quelques conseils pour installer Alfresco.
Premièrement, nous travaillons actuellement sur la version communautaire 2.0. Vous pouvez télécharger cette version sous forme d'un éxécutable ici :
Vous devez installer MySQL. Après l'installation de MySQL, vous devez aller dans le dossier <ALFRESCO_DIR>\extras\database\mysql et lancer le batch/sql fichier : db_setup.bat (qui appelle db_setup.sql)
Vous devez aller dans le dossier <ALFRESCO_DIR>\tomcat\shared\classes\alfresco\extension et déplacer tous les fichiers dans un sous-dossier appelé backup par exemple.
Vous pouvez maintenant lancer votre Alfresco.
Liens :
Alfresco Components
Afin d'améliorer la qualité du client Web Alfresco, nous avons créé quelques composants à installer directement dans le dossier d'Alfresco. Vous devez d'abord lancer Alfresco (le fichier WAR contenu dans le dossier d'Alfresco sera décompressé). Vous pouvez télécharger nos composants ici :
Le fichier ZIP contient un semble de fichiers ZIP. Ces fichiers doivent être déplacé et extrait dans ce dossier : <ALFRESCO_DIR>\tomcat\webapps\alfresco. Vous pouvez relancer Alfresco pour vérifier la bonne installation de nos composants.
Création du modèles
Liens :
Création d projet
Eclipse est connecté à un workspace (il peut être choisi durant le chargement d'Eclipse), c'est un dossier particulier. Ce workspace contient un ou plusieurs projets. Les projets peuvent être de nature différente (Java, TopCased, Général). Pour cet exemple, nous créons un projet TopCased. Vous sélectionnez dans le barre de menu du haut : File > New > Project...
Ensuite, nous choisissons Topcased > Topcased Project et on clique sur Next. Dans l'écran suivant, nous entrons le nom du projet. Nous l'appelons Test et cliquons sur Finish.
 |
 |
Maintenant, nous avons un projet nommé Test qui contient un sous-dossier nommé Models. Maintenant nous pouvons créer le modèle.
Création du modèle
Vous devez cliquer dans la barre de menu du haut : File > New > Other.... Maintenant, vous choisissez Topcased > Topcased Diagrams > BlueXML Diagram et vous cliquez sur Next. Dans l'écran suivant, vous choisissez le répertoire (dans notre cas c'est /Test/Models), le nom du modèle (myModel) et le template. Le template est le type du diagramme principal. Un modèle peut contenir plusieurs diagrammes. Dans notre cas, vous choisissez Class diagram et vous cliquez sur Finish.
 |
 |
Nous avons un fichier OBL qui contient le modèle et un fichier OBLDI qui contient la visualisation graphique de ce modèle. Le résultat est :
Hiérarchie de paquetage
Il est fortement recommandé d'organiser son modèle. Nous pouvons créer une hiérarchie de package. Pour cet exemple, nous créons la hiérarchie suivante org > openbluelab > test. Dans le menu contextuel du pakcage principal dans la vue Outline (le fichier obldi doit être ouvert), nous choisissons Create child > Package. Nous cliquons dessus et changeons son nom dans la vue Properties.
 |
 |
Nous utlisons la même méthode pour céer les packages openbluelab et test. Dans le menu contextuel de test, nous sélectionnons Add diagram > Class diagram. La création de ce diagramme permet de placer les éléments du modèle dans le paquetage test automatiquement.
Création des éléments du modèle
Maintenant, nous pouvons créer une classe. Nous cliquons sur Class dans le panel gauche. Ensuite, nous cliquons dans la partie blanche afin de créer la classe. Nous l'appelons Contact. Si nous double-cliquons dessus, nous pouvons mettre à jour des informations additionnelles comme le titre, la description, la représentation graphique (nous choisissons vertical-tab comme option de visual-component).
 |
 |
Nous voulons maintenant ajouter des porpriétés sur cette classe. Nous cliquons sur Property dans le panel de gauche. Ensuite nous cliquons sur la classe Contact. Le nouvel attribut peut être modifié si nous cliquons dessus. Une nouvelle fenêtre de dialogue apparaît et nous pouvons mettre à jour les informations supplémentaires.
 |
 |
Nous créons 2 classes Contact et Company. Un contact a un prénom et un nom de famille. Une société a seulement un nom.
Lier les éléments
Maintenant, nous voulons lier les 2 classes. Nous cliquons sur Association dans le panel de gauche. Ensuite, nous cliquons sur la première classe (Contact par exemple) et nous cliquons sur l'autre classe.
Nous double cliquons sur l'association et la mettons à jour :
 |
 |
 |
Nous obtenons ce résultat :
Conclusion
Nous avons créé une hiérarchie de paquetage, créé un nouveau diagramme sur le paquetage le plus haut, ajouté 2 classes avec des attributs et liés ces deux classes.
Il est important de noter que BlueXML Developer Studio permet de générer complètement des processus métier. Notre modeleur est similaire à jBoss Process Designer mais inclus plus de fonctionnalités. Plus d'informations ici.
Alfresco generation
Dans le menu contextuel du fichier obl, vous pouvez cliquer sur Generate Alfresco Configuration. Nous avons un nouveau dossier appeler org.openbluelab.test dans le dossier Alfresco Configuration. Ce dossier contient 2 dossiers shared et webapps. Ces deux dossiers doivent être déplacés dans le dossier d'installation d'Alfresco.
 |
 |
Intégration à Alfresco
Les dossiers shared et webapps doivent être fusionnés avec l'installation d'Alfresco. Vous devez déplacer ces deux dossiers dans le répertoire <ALFRESCO_DIRECTORY>/tomcat. Après le rechargement d'Alfresco, nous pouvons créer et lier des contacts et des compagnies. Vous devez vous connecter à Alfreso et aller sur votre espace.
 |
 |
Dans la partie droite, vous pouvez créer un nouveau contenu avec Create > Create content.
Vous remplissez le nom du contenu et son type. Premièrement, nous voulons créer une compagnie. Vous cliquez sur Finish et remplissez le nom de la compagnie (BlueXML). Ensuite, vous pouvez valider.
Nous avons maintenant une compagnie qui s'appelle BlueXML.
Nous utilisons le même méthode pour créer un nouveau contact (Create > Create content) :
Cette démonstration montre un petit exemple de l'utilisation d'Alfresco. Notre générateur permet plusieurs actions. Par exemple, nous pouvons consulter les derniers contenus ajoutés dans le tableau de bord :
