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.