Procédure pas à pas : Intégration de Polarion

Prérequis

Afin de configurer l'intégration entre Polarion et Enterprise Architect , vous devez d'abord :

• Utiliser une installation sous licence de Pro Cloud Server (version 4.2.62 ou ultérieure) avec le composant Plug-ins d'intégration
• Sélectionnez l'option « Activer Fonctionnalités Pro (OSLC, WebEA et intégration) » dans la configuration Pro Cloud Server pour chaque système de gestion de base de données hébergeant vos modèles Enterprise Architect
• Avoir un accès réseau entre le serveur PCS et le serveur Polarion
• Avoir des informations d'identification d'utilisateur pour accéder aux données externes
• Utilisez Enterprise Architect Corporate , Unified ou Ultimate Edition v15.2 ou version ultérieure

Nous supposerons que le serveur d'intégration et le plug-in d'intégration Polarion doivent être exécuter sur la même machine que le Pro Cloud Server

Identifier Polarion à Pro Cloud Server et Enterprise Architect

Suivez ces étapes :

1. Double-cliquez sur l'icône du bureau « Pro Cloud Config Client » pour ouvrir la fenêtre Pro Cloud Config Client.
2. Sélectionnez l'onglet « Intégration » et cochez la case « Activer les intégrations ». Dans le champ « Port », saisissez le numéro du port sur lequel le serveur d'intégration écoutera les requêtes du Pro Cloud Server .
   
3. Cliquez sur le bouton Ajouter. La dialogue « Ajouter un fournisseur de données » s'affiche.
   
4. Cochez la case « Activé ».
5. Dans le champ « Nom », saisissez un nom de connexion approprié, tel que « Polarion ».
6. Dans le champ « Fournisseur », cliquez sur la flèche déroulante et sélectionnez « Intégration personnalisée ».
7. Dans le champ « Préfixe », saisissez un préfixe approprié, tel que « Polarion ».
8. Dans le panneau « Plugin d'intégration », dans le champ « Port », saisissez le numéro du port que le serveur d'intégration utilisera pour communiquer avec le plug-in Polarion.
9. Cliquez sur le bouton représentant des points de suspension à côté du champ « Chemin DLL ». Parcourez et sélectionnez le fichier « PolarionSbpi.dll ». Il se trouve dans le dossier d'installation Pro Cloud Server . Par exemple, C:\Program Files (x86)\ Sparx Systems \ Pro Cloud Server \SBPI\PolarionSbpi.dll
10. Les champs des étapes 10 à 13 constituent les composants de votre adresse Web Polarion, à savoir : <protocole>://<serveur>:<port>/baseURL
    Dans le champ « Protocole », cliquez sur la flèche déroulante et sélectionnez le protocole que le plug-in Polarion utilisera pour communiquer avec Polarion.
11. Dans le champ « Nom du serveur/IP », saisissez le nom du serveur ou l'adresse IP que le plug-in Polarion utilisera pour communiquer avec Polarion.
12. Dans le champ « Port », saisissez le numéro du port que le plug-in Polarion utilisera pour communiquer avec Polarion.
13. Dans la « Base » Dans le champ URL, saisissez la dernière partie de votre URL Polarion (tout ce qui se trouve après le nom du serveur et le port)
14. Si vous laissez les champs « Utilisateur » et « Mot de passe » vides, chaque utilisateur Enterprise Architect sera invité à saisir ses informations d'identification personnelles Polarion, ce qui peut offrir une meilleure convivialité.
15. Si vous préférez définir des valeurs dans les champs « Nom d'utilisateur » et « Mot de passe », les valeurs seront utilisées en combinaison pour accéder aux données dans Polarion. Tous les utilisateurs actuels Enterprise Architect de l'installation Polarion utiliseront le même ensemble d'informations d'identification pour lire les données externes.
16. Cochez les cases « Créer Items », « Modifier Items » et/ou « Publier des discussions » si nécessaire pour permettre aux utilisateurs du plug-in Polarion de créer et/ou de mettre à jour des éléments et/ou de créer des publications de discussion dans Polarion à l'aide Enterprise Architect .
17. Si vous souhaitez que le plug-in Polarion ignore les erreurs liées à SSL qui se produisent à la suite d'une communication avec Polarion (par exemple si vous utilisez un certificat SSL auto-signé), cochez la case « Ignorer les erreurs SSL ».
    
18. Vous pouvez laisser les autres champs vides ou les définir sur leurs valeurs par défaut. Cliquez sur le bouton OK pour terminer la configuration. Vous revenez alors à l'onglet « Intégration » de la fenêtre Client de configuration Pro Cloud Server .

Identifier les modèles Enterprise Architect pour Polarion

Dans l'onglet « Intégration » de la fenêtre Client de configuration Pro Cloud Server , vous verrez maintenant :

• En bas à gauche de l'écran, le panneau « Fournisseurs de données » répertoriant l'intégration personnalisée pour Polarion en tant que fournisseur de données
• En bas à droite de l'écran, le panneau « Polarion » est lié à : » affichant une liste de contrôle des modèles Enterprise Architect de vos gestionnaires de bases de données compatibles Pro

Vous pouvez soit cliquer sur la case à cocher en regard de chaque modèle Enterprise Architect que vous souhaitez lier à Polarion, soit cliquer sur l' pour les sélectionner tous en même temps.

Cliquez sur le bouton Quitter.

Redémarrez le service PCS pour appliquer les modifications que vous avez apportées.

Vous pouvez maintenant accéder à l’un de vos modèles Enterprise Architect et vérifier l’intégration avec Polarion.

Test l'intégration

Dans Enterprise Architect ouvrez l’un des modèles que vous avez identifié comme étant lié à Polarion.

1. Sélectionnez l'option du ruban Spécialiser > Outils > Systeme d'intégration .
2. Dans la barre d'outils de la fenêtre Données externes, cliquez sur la flèche déroulante à droite de l'icône « globe ».
3. Sélectionnez « Intégration personnalisée » dans la liste.
   
4. Cliquez sur « Polarion » dans le fil d'Ariane, cela représente la racine du référentiel Polarion.
   
5. Continuez à utiliser les options de fil d'Ariane pour explorer les projets Polarion et accéder Items de travail (tâches, problèmes, etc.).
   

Cartographie des données

Pour que Polarion et Enterprise Architect puissent échanger des éléments de données de manière fluide, vous devez révision et, si nécessaire, éditer :

• Quel type d'élément Polarion correspond à quel type d'élément Enterprise Architect , et
• Quelle propriété d’un élément Polarion correspond à quelle propriété d’un élément Enterprise Architect .

Ces tâches sont entièrement expliquées dans la rubrique Aide Configuration .

Révision des données Polarion

Lorsque vous avez testé la communication entre Enterprise Architect et Polarion, dans la fenêtre Données externes, vous avez utilisé le fil d'Ariane pour afficher les listes d'éléments de travail (par exemple, les tâches).

Si cette liste est trop longue, vous pouvez cliquer sur l'icône « Hamburger » dans la barre d'outils de la fenêtre.

Ce menu propose des options telles que :

• « Items liés » pour afficher uniquement les éléments Polarion liés aux éléments Enterprise Architect
• « Éléments non liés » pour afficher uniquement les éléments Polarion qui n'ont pas encore été liés aux éléments Enterprise Architect , ou
• « Items liés au contexte actuel » pour afficher uniquement les éléments Polarion liés à l'élément Enterprise Architect actuellement sélectionné

Il est également possible d'appliquer des filtres basés sur du texte au contenu tableau de données externes.

1. Faites un clic droit sur l'en-tête de la colonne et sélectionnez « Basculer Barre de Filtre » (si elle n'est pas déjà affichée).
   
2. Type du texte dans le champ de filtre/recherche juste en dessous du nom de la colonne,
   

Lors de la sélection d'un élément de la liste, chacune des fenêtres Propriétés , Notes , Inspecteur et onglet « Discussion » de la fenêtre Discussion et Révision possède des onglets ou versions séparés de la fenêtre pour afficher les propriétés, notes , fonctionnalités et les discussions (respectivement) de l'élément sélectionné. Ceux-ci sont illustrés dans la Rubrique d'aide Détails Item externe .

Travailler avec les éléments Polarion et Enterprise Architect

Après avoir créé une communication fonctionnelle entre Enterprise Architect et Polarion, vous pouvez :

• Créer un nouvel élément dans Enterprise Architect lié à un élément Polarion
• Créer un nouvel élément Polarion lié à un élément dans Enterprise Architect
• Lier un élément existant dans Enterprise Architect à un élément Polarion
• Mettre à jour l'élément Polarion avec les modifications apportées à l'élément Enterprise Architect
• Mettre à jour l'élément Enterprise Architect avec les modifications apportées à l'élément Polarion
• Mettre à jour tous les éléments Enterprise Architect liés avec toutes les modifications apportées aux éléments Polarion

Ces actions sont toutes expliquées dans la rubrique d’aide Lier Items .

Note : lors de la création d'un élément Polarion à partir d' Enterprise Architect , il est placé dans le groupe Items de travail Polarion (en tant que nouveau travail à effectuer).

Apprendre encore plus

• Plugins d'intégration
• Atlassian Access Tokens (ressource en ligne)
• Create an Access Token (ressource en ligne)
• Dépannage