Newsletter Juillet 2023

Nos événements : retours d’expériences et webinaires à venir


Si vous n’ avez pas pu être présent à la conférence des utilisateurs Polarion France qui s’est tenue dans les locaux de notre partenaire Siemens Digital Industries Software le 1er juin dernier, vous avez la possibilité de voir (ou revoir pour les personnes qui étaient présentes) les présentations faites à cette occasion. Nous avons sélectionné deux retours d’expérience clients : 

SNCF Voyageurs
 


 Replay (54 min) ​

 Support de présentation (1,6Mo)


L’ingénierie du Matériel chez SNCF Voyageurs s’est lancée dans une démarche de déploiement global de l’ingénierie des exigences avec la solution Polarion ALM pour l’ensemble des projets d’acquisition et de modification de matériel roulant. Jean-Luc Delamare, chef de Projet Ingénierie des exigences, nous propose d’aborder les différents ingrédients utilisés pour mener à bien cette transformation : conduite du changement, formation et mise en place de processus.

Thales Revenue Collection Systems



 Replay (41Min)

 Support de présentation (1,6Mo)


Après quatre ans d’utilisation de la solution Polarion, Thomas Baselius, Head of Business Development Engineering Dept chez Thales Revenue Collection Systems, nous propose son retour d’expérience : pourquoi ce choix, sur quels usages et sur quelle population ? Quels en sont les bénéfices perçus et les écueils ?

Nos webinaires Polarion reprendrons à la rentrée, toujours sur des thèmes très demandés comme l’alignement des activités de V&V de vos exigences, ainsi qu’un webinaire inédit sur la digitalisation du processus de validation des SI dans le domaine des sciences de la vie, en s’appuyant sur la méthodologie GAMP5, avec Polarion. 

Nous vous invitions à en découvrir nos prochains webinaires :

​
Pour connaître le programme complet de nos événements à venir avec tous les détails et vous y inscrire,  rendez-vous sur notre page Événements.

Nos avis, conseils et recommandations d’experts


Cette rubrique a pour but de vous apporter quelques trucs et astuces pour faciliter votre quotidien avec Polarion. Ces conseils proviennent des experts Polarsoft mais aussi de l’écosystème Polarion France : clients, partenaires, consultants que nous encourageons vivement à nous faire part de leurs conseils, astuces et autres avis pour une prochaine publication !

L’article de cette newsletter vous présente une fonctionnalité essentielle permettant aux parties prenantes de s’entendre sur la compréhension et l’acceptation d’une exigence ou d’une spécification : la revue par les Approvals.

La perception de la notion de qualité d’une exigence peut différer d’une organisation à l’autre voire d’une personne à l’autre. Nous pouvons par exemple nous appuyer sur les critères donnés par l’IREB (Internal Requirements Engineering Board),  à savoir les exigences doivent satisfaire individuellement des critères de qualité précis, une exigence doit notamment être : 

  • négociée
  • non ambiguë
  • nécessaire
  • cohérente
  • vérifiable
  • réalisable
  • traçable
  • complète
  • compréhensible

L’objectif de cet avis d’expert n’est pas de s’attacher à la qualité attendue des exigences, mais de découvrir un des moyens offerts par Polarion pour s’entendre sur la compréhension et l’acceptation d’une exigence et, si on reprend le premier critère de la liste, négocier entre parties prenantes sur l’approbation d’une exigence ; cette fonctionnalité sous Polarion est couverte par les Approvals.

On confond souvent les Approvals avec le statut Approuvé d’une exigence, statut propre à son cycle de vie (Workflow). En réalité, ces approbations sont relatives à l’activité de revue des exigences, il y a un lien avec le Workflow dans le sens qu’une exigence qui a été revue par plusieurs parties prenantes, pourra ensuite être approuvée par le propriétaire de l’exigence.

Cette fonction de revue des approbations est donc du même type que les commentaires. Elle permet cependant d’apporter et de configurer plus de rigueur dans la revue de l’exigence, notamment :
  • Si les approbations n’ont de workflow configurable, chaque approbation est associée à un ensemble d’états à savoir waiting, approved, disapproved (on peut comparer avec un commentaire qui a un état resolved/unresolved),
  • La désignation des personnes en charge de la revue en fonction de leurs rôles ou assignations,
  • L’alignement du workflow de l’exigence en fonction de la revue par les approbations ; ainsi une exigence ne pourra pas passer en état approuvée, si des approbations restent en état waiting,
  • Pour couvrir le point précédent, des fonctions de workflow permettant de gérer les conditions ou actions liées à ces approbations,
  • Enfin un suivi précis des approbations par des rapports dédiés.
Voyons ensemble les grandes lignes de cette fonctionnalité de relecture des exigences qui permet donc à un auteur de capturer l’aval et aussi les commentaires de ses pairs, simple à mettre en œuvre et illustrée dans les projets de démonstration livrés en standard avec Polarion.

A noter que la fonction Approvals est disponible également pour les utilisateurs déclarés avec une licence de type Polarion REVIEWER.

Comment se présentent  les Approbations en vue tableau ?

Comme montré ci-dessous les approbations ont une section particulière sur le formulaire d’un Work Item, on y trouve les utilisateurs invités pour la revue. La désignation des personnes peut se faire via cette section mais nous verrons des moyens plus automatisés pour réaliser cette assignation.

Dans la vue table des exigences, nous pouvons bien sûr afficher les approbations, en format textuel, ce n’est cependant pas avec Polarion la meilleure interface, il existe en effet une vue dédiée pour afficher, gérer et couvrir les approbations.

L’onglet latéral Approvals offre un cadre permettant de :
  • Suivre les approbations,
  • Donner un état d’approbation unitairement ou en masse sur un ensemble d’exigences, que ce soit en utilisant les boutons de la fenêtre dédiée, ou en agissant directement dans le tableau en cliquant sur les icônes apparaissant dans la première colonne,
  • Associer un commentaire à cette approbation ou désapprobation.

A noter que les commentaires liés aux approbations sont préfixés par Approval Comment, ce qui peut permettre de les différencier des autres commentaires.


Comment se présente les approbations en vue document ?

Comme toujours avec Polarion, ce qui est possible en vue tableau l’est également en vue document ! Ainsi pour rester dans le contexte du document, la vue My Approvals peut être affichée et on retrouve en face de chaque exigence les pictogrammes permettant d’approuver, désapprouver, et commenter notre exigence en revue.

Petite astuce : si vous désirez faire un rapport qui renvoie directement par un lien vers la section Approvals d’un document, Polarion permet de créer l’url avec l’option du volet latéral sous la forme : /DProj/wiki/Requirements/System%20Requirement%20Specification?sidebar=approvals

Comment rendre la déclaration des approbateurs pilotée par le processus ?

Deux approches sont préconisées pour ajouter automatiquement les approbateurs aux Work Items qui passent dans un état donné, par exemple en revue :
 
  • Utiliser l’action AddDefaultApprovals et passer en paramètres la liste des rôles ou utilisateurs à déclarer sur cette transition du Workflow
 
  • ​Utiliser un champ personnalisé et un script simple (invoqué par l’action Script Function) pour piocher dans ce champ la liste des personnes désirées. L’avantage de cette approche est de faire du sur mesure, sans s’appuyer sur la définition des rôles du projet. On peut en effet considérer que des électroniciens vont couvrir la revue des exigences de la spécification des composants électroniques, alors que les experts en mécaniques vont plus revoir les exigences du bloc moteur !
 
  • Le script ne présente pas de difficultés particulières en utilisant l’Open API de Polarion, si vous désirez un exemple de codage de cette fonction, n’hésitez pas à revenir vers nous.
     
Comment conditionner le cycle de vie des exigences en fonction des approbations ?

Quand une exigence est en attente de revue et que l’ensemble des approbations n’a pas été couverte nous pouvons bloquer le changement d’état de l’exigence par une condition du Workflow. Vous trouverez par défaut les conditions ApprovalState et AtLeastOneApprovedAndNooneDisapproved.

La condition ApprovalState prend en paramètre commonApprovalState avec la valeur au choix waiting,approved ou disapproved. Si les approbations ne sont pas dans l’état spécifié, l’action de transition du workflow est grisée et un message indique la raison empêchant ce changement d’état de l’exigence.


Comment suivre l’avancement des approbations ?

Il existe tout d’abord deux requêtes standards qui permettent d’effectuer rapidement des recherches dans un document que ce soit dans la table ou sur une page d’indicateurs.

On trouve ensuite sur la page personnelle de chaque utilisateur (myPolarion) une liste des Work Items en attente d’approbation.

Enfin, les projets de démonstration sont livrés avec une page Item Approvals Statistics qui donne l’état d’avancement des approbations en permettant de filtrer les Work Items ciblés en fonction des paramètres présents sur la page.

La technologie des pages, widgets et APIs de Polarion, permettent bien sûr de créer et personnaliser vos propres rapports.

N’hésitez pas à nous consulter si vous désirez créer des indicateurs sur mesure.

En conclusion :

Vous avez déjà en place un processus de revue de vos exigences ou autres Work Items par vos pairs sous Polarion en utilisant les commentaires mais vous souhaiteriez être plus formel dans votre gestion, pilotage et suivi de ces revues… Alors explorez les Approvals, une fonctionnalité d’approbation efficiente et disponible avec tout type de licences / produits Polarion.
 

Votre prochaine formation à Polarion


Vous avez peut-être déjà fait appel à Polarsoft pour vous former et vous accompagner dans votre premier déploiement de Polarion. Nombreuses sont aussi les demandes pour former un nouvel utilisateur, un référent sur la solution Polarion ou encore pour une formation avancée afin d’exploiter au mieux le potentiel de l’outil.

Nous vous proposons des formations adaptées au besoin de chacun qui sont dispensées en intra-entreprise (sur site client ou en distanciel) et inter-entreprises organisées dans nos locaux à Saint-Quentin-en-Yvelines, ou en distanciel.

Découvrez ici nos différentes formations avec leur programme ainsi que les dates des prochaines sessions inter-entreprises à Saint-Quentin-en-Yvelines, ou cliquez directement sur celles vous intéressant plus particulièrement programmées dès le mois de septembre :


Si vous ne trouvez pas dans ces programmes la réponse à votre besoin en formation nous pouvons vous proposer une formation ciblée sur vos attentes (ex. Polarion Utilisateur adapté à votre contexte, Ingénierie des exigences, Ingénierie système…), n’hésitez pas à nous en faire la demande !

Quelques conseils de notre support technique


Dans cette rubrique nous vous apportons quelques conseils et recommandations afin répondre à des préoccupations d’utilisateurs ou administrateurs de Polarion. Entrer dans le Repository Subversion peut être risqué selon l’approche utilisée, les écueils à éviter sont présentés.

Entrer dans le Repository Subversion, oui mais…

Avoir Subversion (SVN) comme référentiel (repository) pour Polarion est un gage de stabilité et de conservation des données exploitées, que ce soit pour l’état courant ou pour des révisions historiques de ces données.

On accède à Subversion par un client Subversion (ou SVN), ce qui est le cas de Polarion.  Un autre exemple est le logiciel TortoiseSVN qui nous permet aussi de consulter le référentiel, voire modifier ou déplacer des données. On peut aussi utiliser le RepositoryBrowser sous Polarion.

TortoiseSVN est la plupart du temps utilisé par des administrateurs Polarion accoutumés à la structuration des projets et des données dans le repo, et il est vrai que cela peut s’avérer très pratique de dupliquer un projet par un simple glisser-déplacer, mais le déplacement versus la duplication sous TortoiseSVN est à une touche de fonction près ! Il y a donc certaines règles à respecter pour ne pas « casser » un projet ou des données, notamment lorsque l’on veut déplacer ou supprimer un projet :

  • Ne pas déplacer un projet sous SVN directement : utiliser systématiquement la fonction Project Move sous Polarion
  • Ne pas supprimer un projet sous SVN directement : utiliser systématiquement la fonction Project Delete sous Polarion​
Quand on réalise ces opérations sous Polarion, le logiciel met à jour un fichier projects.xml listant les projets, ce qui ne sera pas fait si vous supprimez ou déplacez directement les projets via TortoiseSVN.

Une suppression non désirée…

Ceci n’est pas fréquent, mais il peut arriver qu’un utilisateur vienne à supprimer des Work Items, un document LiveDoc, voire un projet entier. Pas de panique, rien ne se perd avec Subversion, et un retour en arrière est toujours possible !

Vous trouverez sur le site du support une vidéo explicitant comme restaurer un dossier de Subversion, How to restore a deleted object, nous ne reprenons donc pas ici les étapes à couvrir :

https://support.sw.siemens.com/fr-FR/product/230235217/knowledge-base/PL8965959

En complément, s’il s’avère que le dossier supprimé est un projet, restaurer le dossier correspondant ne suffira pas. Il vous faudra « marquer » le dossier restauré en tant que projet (vous trouverez cette fonction sous Global Administration/Projects).


Une mise à jour de Polarion à venir…

C’est l’été et c’est parfois le moment choisi par les administrateurs pour étudier ou réaliser la montée de version de Polarion, la dernière étant la version 2304.

Aussi, nous nous permettons de vous renvoyer à notre newsletter du mois précédent https://www.polarsoft.fr/Newsletter/fiche/id/22#conseils-technique-04-23, ceci est d’autant plus important si vous démarrez d’une version de Polarion antérieure à une version 22.X



Espérant que vous avez apprécié cette newsletter nous vous donnons rendez-vous en octobre pour de nouvelles informations sur l’ALM avec l’arrivée de la version 2310 de Polarion… Passez un bel été et prenez soin de vous !