Spécification du produit

Dans cette partie du tutoriel, nous allons parcourir l’un des principaux flux utilisateur qui vous permettront de commencer à utiliser Requirements & Systems Portal :

• Collecter et rédiger les exigences

• Décomposer les exigences

• Réviser et améliorer les exigences

• Approuver et publier les spécifications

Création d’un nouveau projet

1. Sur la page Home de Requirements & Systems Portal (accessible lorsque vous ouvrez Requirements Portal depuis le menu à neuf points en haut à droite de l’interface navigateur du Workspace – ), cliquez sur le bouton  au-dessus de la liste des projets d’exigences.

   

2. La fenêtre Create Requirements Project s’ouvre, dans laquelle vous pouvez spécifier les détails du projet :

   • Project Name – saisissez un nom de projet approprié (et unique) (par ex., Valifan).

   • Description – saisissez une description facultative du projet (par ex., Amazing Valifan project).

   • Electronics Project – laissez ce champ vide. 

   Une fois les détails du projet renseignés, cliquez sur le bouton .

   

3. Le projet d’exigences apparaîtra dans la liste de la page Home. Cliquez sur son nom pour l’ouvrir dans un nouvel onglet de votre navigateur.

   

4. Accédez au module Project en cliquant sur l’icône  dans la barre de navigation des modules à gauche et sélectionnez l’entrée About dans la liste Overview. À partir de là, vous pouvez modifier à tout moment le nom et la description de votre projet.

   
   Les informations de base du projet, telles que le nom, la description, l’image ainsi que les dates de début et de fin, sont disponibles sur la page About Project.

   Vous pouvez toujours réduire ou développer le volet principal de navigation en cliquant sur le bouton flèche  à côté ().

Définition des exigences des parties prenantes

La plupart des activités de conception et de développement système suivent le cycle en V. Le premier processus d’un cycle en V consiste à comprendre les besoins métier et à identifier les besoins des parties prenantes. Ces besoins des parties prenantes sont ensuite convertis en exigences des parties prenantes qui peuvent être créées directement, importées via CSV/XLSX, ou même créées via ValiAssistant alimenté par l’IA. Pour cette partie du tutoriel, nous nous concentrerons sur la méthode d’importation.

1. Téléchargez le fichier CSV suivant qui contient les exigences des parties prenantes :

   Valifan_stakeholder_Requirements.csv

2. Accédez au module Requirements en cliquant sur l’icône  dans la barre de navigation des modules à gauche.

3. Cliquez sur le bouton  sur la page qui s’ouvre.

   

4. L’assistant Import Requirements s’ouvre. Dans la zone Create a specification, définissez le Name de la spécification (par ex.,Stakeholder_requirements), puis cliquez sur le bouton .

   

5. L’étape suivante consiste à téléverser le CSV afin que l’assistant d’importation puisse lire et importer le fichier. Glissez-déposez le fichier CSV téléchargé dans la zone Drop file de l’assistant Import Requirements (ou cliquez sur la zone pour téléverser le fichier à l’aide d’une boîte de dialogue).

   

    Cliquez sur  pour continuer.

6. À l’étape suivante, assurez-vous que les colonnes de données du fichier CSV sont correctement mappées aux colonnes de Requirements and Systems Portal. Si nécessaire, utilisez les listes déroulantes Map To en haut du tableau. 

   

   Cliquez sur  pour continuer.

7. La page suivante de l’assistant vous informera de la réussite de l’importation. Cliquez sur le contrôle Check now en haut de la fenêtre pour convertir les valeurs et les unités en paramètres (valis), selon une approche d’ingénierie système pilotée par les données.

   

8. Dans la fenêtre Valify Requirements qui s’ouvre, vous serez informé que les cinq exigences vont être valifiées. Cliquez sur  pour continuer et recevoir une notification indiquant que deux valis ont été trouvés. Cliquez sur  pour continuer, puis cliquez sur .

   

9. Comme vous pouvez le voir, 50 dB et 50 W ont été transformés d’un simple texte en valis que nous pourrons utiliser plus tard.

   

   Fermez la fenêtre Valify Requirements pour continuer. Toutes les exigences ont été ajoutées, et toutes les valeurs détectées ont été transformées en valis. Les valis sont mis en évidence dans les exigences.

   

Ajout d’exigences système

Dans un flux d’ingénierie système typique, les exigences système sont créées à partir des exigences des parties prenantes. La plupart des conceptions techniques doivent respecter des exigences strictes, telles que des exigences de masse, de consommation électrique et de coût. Requirements & Systems Portal offre une vue complète de la manière dont une conception satisfait à toutes ces exigences.

Nous allons maintenant créer manuellement quelques exigences système.

1. Cliquez sur le bouton . Dans la fenêtre Create new specification qui apparaît, saisissez Fan_Specs dans le champ Name puis cliquez sur .

   

2. Cliquez sur l’entrée de la spécification nouvellement créée dans la liste de gauche. Une fois dans cette spécification, le bouton  (ou, alternativement, cliquez sur le bouton  en haut à droite).

   

3. La fenêtre Create new requirement s’ouvre. Dans cette fenêtre :

   1. Dans le champ Specification, assurez-vous que la bonne spécification est sélectionnée (Fan_Specs).

   2. Dans le champ Identifier, saisissez un identifiant unique, par ex., R-Fan-001.

   3. Dans le champ Requirement text, saisissez The Mass of the fan shall not exceed 300g.

   4. Assurez-vous que l’option Check for possible Valis est activée.

      Lorsque cette option est activée, les valeurs numériques présentes dans l’exigence sont vérifiées et converties directement en valis via la fonctionnalité Valify.

   5. Cliquez sur le bouton .

   

4. Dans la fenêtre Valify Requirements qui apparaît, cliquez sur le bouton . Un vali sera trouvé dans l’exigence. Cliquez sur le bouton  pour convertir la valeur en vali, puis cliquez sur le bouton  pour continuer, puis cliquez sur le bouton  pour terminer le processus.

5. De la même manière, ajoutez une autre exigence avec l’identifiant R-Fan-002 et le texte d’exigence The Mass of the propeller shall not exceed 50g, mais cette fois, désactivez l’option Check for possible Valis (un vali sera créé manuellement plus tard à partir d’une valeur présente dans cette exigence).

   

6. Les exigences ajoutées seront listées lorsque la spécification Fan_Specs est sélectionnée. Notez que si R-Fan-001 possède un vali, R-Fan-002 n’a pas encore de vali.

   

Création de valis d’exigence dans une exigence

Nous allons maintenant créer manuellement un nouveau vali dans le champ de texte de l’exigence.

1. Double-cliquez sur la cellule de la colonne Text de l’exigence R-Fan-002 et supprimez le texte 50g.

   

2. Saisissez $ pour afficher une fenêtre contextuelle contenant une liste de valis/objets du projet. En haut à droite de la fenêtre contextuelle, cliquez sur le bouton  pour créer un vali.

   

3. Dans la fenêtre Create new qui s’ouvre. Dans l’onglet Vali de la fenêtre, saisissez les données suivantes pour le nouveau vali :

   1. Name: Req_Mass_Propeller

   2. Formula and unit: 50g

   3. Display unit: g

      Le champ Display unit est facultatif. S’il est laissé vide, il reprendra l’unité du champ Formula and unit.

   

4. Cliquez sur le bouton  pour créer un nouveau vali et l’insérer dans le champ Text de l’exigence.

5. À présent, le texte 50g apparaît différemment du texte normal, ce qui indique qu’il s’agit d’un vali. Ce vali peut désormais être utilisé dans différentes parties du projet (par ex. rapports, module System Design, vérification, etc.).

   

Décomposition des exigences avec des relations parent-enfant

1. Cliquez sur le contrôle Columns à droite du tableau et assurez-vous que les entrées des colonnes Parents et Children sont cochées afin qu’elles soient affichées dans le tableau.

   

   Cliquez de nouveau sur le contrôle Columns pour masquer la liste.

2. Double-cliquez sur la cellule de la colonne Parent de l’exigence R-Fan-002 et sélectionnez l’exigence R-Fan-001 dans la fenêtre contextuelle pour lier les deux exigences. Notez que R-Fan-002 sera automatiquement ajouté à la colonne Children de R-Fan-001.

   ❯ ❮ Javascript ID: RSP_FanTutorial_Requirements_ParentsChildren_Add

3. Cliquez sur le bouton  en haut du tableau des exigences pour ouvrir un graphe de connexion qui montre la relation parent-enfant de la spécification sélectionnée.

   Les cadres bleus autour des exigences indiquent la spécification dans laquelle elles se trouvent.

   

Génération d’exigences à l’aide de ValiAssistant

 Pour accélérer votre processus de gestion des exigences, vous pouvez générer des exigences/décomposer des exigences à l’aide de la fonctionnalité IA ValiAssistant. Nous l’utiliserons pour créer deux exigences de sécurité pour le projet du tutoriel.

1. Cliquez sur le bouton  en haut pour ouvrir la fenêtre ValiAssistant - Generate Requirements.

   

   La fonctionnalité propose différentes façons d’utiliser l’IA sur les exigences, notamment la génération d’exigences, la décomposition des exigences, la création d’un résumé, la validation des exigences, la recherche d’incohérences, etc.

   Assurez-vous que l’option Generate Requirements est sélectionnée, puis cliquez sur le bouton .

2. Sur la page suivante, vous pouvez décrire votre produit, système, sous-système et fournir autant d’informations que possible afin que l’IA puisse générer les exigences les plus adaptées à votre description. Comme nous nous intéressons aux exigences de sécurité, demandez deux exigences de sécurité pour notre ventilateur en saisissant le texte Create 2 safety requirements for designing a fan dans le champ sous l’en-tête Generate Description.

   Dans le champ de texte sous l’en-tête Customize ValiAssistant output, vous pouvez personnaliser davantage l’invite. Nous recherchons des exigences rédigées selon INCOSE ; saisissez le texte Apply the INCOSE guide to writing requirements dans le champ.

   

   Cliquez sur  pour continuer.

3. Sur la page suivante, le résultat de l’IA sera présenté, et vous pourrez examiner, modifier, accepter ou rejeter les suggestions.

   

   Cliquez sur  pour continuer.

4. Fermez la boîte de dialogue vous informant que la génération des exigences a réussi. Les exigences générées seront affichées dans le tableau de la spécification Fan_Spec.

   

Mise à jour, gestion et révision des exigences

Tout au long du processus de développement, il est courant que les exigences évoluent et soient mises à jour en fonction de divers facteurs, tels que les retours des parties prenantes et les contraintes de conception. Dans Requirements & Systems Portal, vous pouvez mettre à jour directement les exigences en double-cliquant sur les champs de colonne ou dans la section de détails de l’exigence, et toutes les modifications sont enregistrées dans l’historique pour une consultation facile.

1. Passez en mode édition pour le texte de l’exigence R-Fan-003 ou R-Fan-004 en double-cliquant sur sa cellule dans la colonne Text. Remplacez le texte par The fan shall include a protective guard with openings no larger than inches to prevent accidental contact with moving parts., puis appuyez sur Enter ou cliquez ailleurs dans le tableau, en dehors de la cellule, pour terminer la modification.

   ❯ ❮ Javascript ID : RSP_FanTutorial_Requirements_UpdateManageReview

2. Cliquez sur l’identifiant de l’exigence pour ouvrir sa vue détaillée, à partir de laquelle vous pouvez ajuster des champs supplémentaires, vous abonner, définir des propriétaires, ajouter une justification, créer des parents/enfants, etc.

   

3. La traçabilité est un concept clé de Requirements & Systems Portal, et toutes les modifications sont suivies dans l’historique des exigences et des autres objets. Cliquez sur History pour ouvrir une vue qui vous fournit des informations sur les versions, l’auteur et la date des modifications, ainsi que sur les champs et actions.

   

Création de discussions sur une exigence

La collaboration et les revues sont essentielles pour garantir que les exigences soient discutées et évaluées de manière approfondie. Requirements & Systems Portal offre de puissantes fonctionnalités telles que les discussions, les tâches et le centre de revue pour faciliter ces étapes cruciales.

Dans cette partie du tutoriel, vous verrez comment utiliser efficacement les discussions pour engager des échanges pertinents avec vos groupes ou collègues, favoriser la collaboration et garantir le meilleur résultat possible pour votre projet.

1. Cliquez sur le bouton  dans le champ Identifier de l’exigence R-Fan-002, puis sélectionnez la commande Add » Discussion dans le menu qui apparaît.

   

2. La fenêtre Discussions relating to s’ouvrira. Dans cette fenêtre, vous pouvez voir toutes les discussions, commenter les discussions existantes et en démarrer de nouvelles. Saisissez @ dans le champ de texte de la fenêtre pour afficher une liste déroulante d’utilisateurs.

   

3. Sélectionnez un utilisateur dans la liste (l’utilisateur identifié recevra une notification) et ajoutez le texte suivant : Is it feasible to have propellers for 50g, or do we need more mass allocation?

   

4. Cliquez sur  puis sur  dans la fenêtre Discussions relating to. La discussion sera ajoutée, et l’icône sera affichée dans le tableau des spécifications.

   

5. Cliquez sur l’icône en haut de la page pour ouvrir le volet Discussions, à partir duquel vous avez accès à toutes les discussions sur la spécification ou sur l’ensemble du module. Des discussions peuvent être lancées sur pratiquement n’importe quel objet dans Requirements & Systems Portal.

   

Validation des exigences

Aux premières étapes du cycle de vie du produit, il est crucial de valider les exigences avant de poursuivre le processus de conception. Requirements & Systems Portal fournit un moyen pratique de gérer les états des exigences à l’aide de la colonne State. Par défaut, des états tels que Draft, In Review et Final sont inclus, mais vous pouvez ajouter des états supplémentaires selon vos besoins spécifiques.

Dans cette partie du tutoriel, vous attribuerez l’état Draft aux exigences nouvellement ajoutées, garantissant ainsi un flux de travail structuré et organisé.

1. Dans la spécification Fan_Spec, cliquez sur le contrôle Columns à droite du tableau et assurez-vous que l’entrée de la colonne State est cochée afin qu’elle soit affichée dans le tableau.

   

2. Cochez la case à gauche de l’en-tête de colonne Identifier pour sélectionner toutes les exigences de la spécification.

   

3. Double-cliquez sur une cellule de la colonne State pour ouvrir une liste déroulante contenant les options d’état disponibles.

   

4. Sélectionnez Draft dans la liste déroulante et confirmez la mise à jour. Toutes les exigences auront l’état Draft.

   

Création d’une analyse/documentation

En tant qu’ingénieur, vous pouvez avoir à créer une analyse pour exploiter vos données d’ingénierie et documenter les propriétés de votre conception. Requirements & Systems Portal vous permet de créer une documentation interne dans laquelle vous pouvez extraire et référencer les données requises.

Dans cette partie du tutoriel, vous ajouterez une analyse descriptive à l’aide du module Analyses.

1. Accédez au module Analyses en cliquant sur l’icône ​ dans la barre de navigation des modules à gauche.

2. Cliquez sur le bouton  dans la page qui s’ouvre pour créer une nouvelle analyse. Dans la fenêtre Create Document qui s’ouvre, saisissez Project_Summary dans le champ Document Name, puis cliquez sur .

   

3. Une nouvelle analyse s’ouvrira.

   À l’aide du bouton dans le volet de navigation de gauche, vous pouvez créer un dossier pour organiser vos rapports.

   Une analyse se compose de blocs, qui peuvent être des textes, des images, des vidéos, des graphiques ou des tableaux. Cliquez dans le bloc 1. Write heading... existant et saisissez Introduction.

   

4. Cliquez dans le bloc Write text... existant et ajoutez-y la phrase suivante : The ValiFan is designed in a way that it works with less power than conventional Fans.

   

5. Cliquez en dehors du bloc pour enregistrer le contenu.

6. Des blocs supplémentaires de différents types (texte, images, références aux exigences et valis, budgets, graphiques ou diagrammes) peuvent être ajoutés. Nous allons créer un tableau des exigences à partir des spécifications des parties prenantes. Cliquez sur le contrôle Click to add new block et, dans la fenêtre Add Block qui s’ouvre, développez l’entrée Table et sélectionnez Requirements.

   

7. Un tableau affichant toutes les exigences de votre projet sera ajouté. Voyons comment n’afficher que les exigences liées à la spécification des parties prenantes. Pour ce faire, placez le curseur sur l’en-tête de colonne Text et cliquez sur l’icône qui apparaît.

   

8. Dans la fenêtre contextuelle qui s’ouvre, cliquez sur l’icône pour afficher une liste des colonnes disponibles. Décochez toutes les entrées de colonne dans la liste et sélectionnez uniquement les entrées Text et Specification.

   

9. Placez le curseur sur l’en-tête de colonne Specification, cliquez sur l’icône , puis cliquez sur l’icône dans la fenêtre contextuelle qui apparaît pour accéder aux options de filtre. Désactivez l’entrée de spécification Fan_Specs et laissez l’entrée Stakeholder_requirements activée.

   

10. Désormais, seules les exigences de la spécification Stakeholder_requirements sont affichées. Des filtres peuvent être appliqués à n’importe quelle colonne, offrant une grande flexibilité dans la représentation des exigences. 

    

11. Vous pouvez partager l’analyse créée avec vos collègues, des parties prenantes ou toute personne extérieure à Requirements & Systems Portal. Pour ce faire, cliquez sur le bouton en haut à droite de la page et sélectionnez Share dans le menu qui apparaît. Dans la fenêtre Share analysis qui s’ouvre, sélectionnez un utilisateur dans la liste déroulante View as, puis cliquez sur le bouton  . Cela crée un nouveau lien que vous pouvez copier et partager.

    

    • L’analyse partagée est une vue web du document créée dans Requirements & Systems Portal et qui reste à jour avec les dernières modifications.

    • La vue web peut être consultée par n’importe qui, sans avoir accès à votre espace de travail.