Bienvenue


Bienvenue sur ce guide ayant pour but de vous apprendre à utiliser notre plugin pour Confluence. En fonction des droits de votre espace Confluence, ce plugin vous permettra d'ajouter et consulter directement sur les pages Confluence, les diagrammes conçus et partagés dans GenMyModel.


Dans ce guide, vous allez voir comment :

  • Configurer les plugins Atlassian (Confluence, Jira)
  • Ajouter le plugin
  • Modifier / Supprimer le plugin
  • Ouvrir l'éditeur GenMyModel depuis la page Confluence
  • Partager les diagrammes avec l'équipe Confluence


Configuration


La seule chose à configurer pour utiliser le plugin Confluence est le nom du serveur hôte Atlassian.


Afin de pouvoir utiliser le plugin par la suite, vous devez sélectionner l'espace dans lequel vous souhaitez l'installer. Les espaces disponibles, 'Personnel' ou une organisation donnée, sont accessibles en haut à droite de votre tableau de bord.


Espaces du tableau de bord : Personnel ou Organisation


Attention : Vous ne pouvez pas renseigner le même nom de serveur Atlassian pour des espaces différents (Personnel et Organisation)


Espace personnel


Connectez-vous à votre tableau de bord GenMyModel et passez à la dernière page Profil utilisateur. Renseignez le nom du serveur hôte Atlassian dans l’espace prévu et validez avec le bouton  Mettre à jour .


Exemple de nom de serveur : myhost.atlassian.net  


Configuration du plugin pour l'espace personnel 


Espace d'organisation


Connectez vous à votre tableau de bord GenMyModel et passez à la page Organisations. Sélectionnez l'organisation en question et passez à l'onglet Paramètres. Renseignez le nom du serveur hôte Atlassian dans l’espace prévu et valider avec la touche  Mettre à jour . 


Exemple de nom de serveur : myhost.atlassian.net 


Configuration du plugin pour l'organisation


Ajouter le diagramme


Pour utiliser le plugin sur votre page Confluence, appuyez sur l'icone + à droite de la barre à outils et sélectionnez GenMymodel Diagram dans la liste déroulante.



Vous avez le choix d'insérer un diagramme à partir d'un projet existant ou à partir d'un nouveau projet.


Insertion de diagramme depuis un projet existant



1 - Sélectionnez le modèle dans la liste déroulante



Attention : Le menu Select a Model contient uniquement les projets qui sont partagés avec l'équipe Confluence (instructions plus bas)


2 - Sélectionnez la version :


- work - la version de travail en temps réel, appuyez sur F5 pour rafraîchir le diagramme

- latest - la dernière version, 1.0.1 dans notre exemple

- d'autres versions - celle-ci sont accessibles uniquement en lecture seule



3 - Sélectionnez le diagramme


Sélectionnez bien le diagramme, dans le cas contraire, vous aurez le message d'erreur suivant "Choose a diagram before saving" ("Sélectionnez le diagramme avant la sauvegarde").


4 - Enfin, cliquez sur le bouton  Insert  pour valider.


Insertion de diagramme à partir d'un nouveau projet



1 - Saisissez le nom du projet


Saisissez le nom sans espaces et caractères spéciaux.


2 - Sélectionnez l'un des types de diagrammes suivants :


BPMN2, UML, RDS, FLOWCHART, JPA, EMF, DMN10, ARCHIMATE


3 - Appuyez sur le bouton  Insert .


Publication de la page Confluence


Avec la version actuelle du plugin, le contenu de diagramme n’apparaît pas en mode d'édition. Appuyez sur le bouton  Publish  pour sauvegarder votre travail et voir le contenu de diagramme ajouté. 


Modifier / Supprimer le diagramme


1 - Cliquez sur l'icone du crayon, afin de pouvoir éditer la page.


2 - Sélectionnez le diagramme pour faire apparaître le menu contextuel.Une fois vos modifications effectuées, appuyez sur le bouton Save afin de les enregistrer.


3 - Appuyez sur le bouton Edit (édition) pour choisir un autre diagramme ou Remove (suppression)


4 - Sélectionnez un autre diagramme et appuyez sur le bouton  Save 




Ouvrir le modèle dans l'éditeur GenMyModel


Pour ouvrir le diagramme dans l'éditeur GenMyModel, il suffit d'appuyer sur le diagramme (en-dehors du mode mode édition) et de vous identifier dans la fenêtre s'affichant alors.


Fenêtre d'identification GenMyModel


Partage des projets avec l'équipe Confluence


L'accès aux diagrammes depuis Confluence est géré sur la page Organisations de votre tableau de bord.


Résumé de l'organisation


L'équipe avec le nom 'Confluence' sera crée automatiquement à l'installation du plugin et sera visible dans l'onglet Equipes.


L'équipe Confluence


Ajouter l'équipe Confluence en tant que Collaborateur


Sélectionnez le projet que vous souhaitez partager et rendre visible depuis les pages Confluence.


Pour cela, passez à la page des Projets et sélectionnez le projet, afin d'afficher ses détails.

Cliquez sur l'onglet Collaboration et appuyez sur le bouton  Ajouter des collaborateurs .


Ajout de l'équipe Confluence en tant que Collaborateur


Enfin, cliquez sur le champ Collaborateurs, sélectionnez l'équipe Confluence, ses permissions et validez avec le bouton  Ajouter des colalborateurs .


Confluence team in the Collaborators list 


Refaites la même opération pour tout projet que vous souhaitez partager avec l'équipe Confluence.