Holarch
Chapitres du cours

Formation · Parcours 9. Les fondamentaux de SysML v2 · Chapitre 9.5 sur 8

9.5 Exigences 4:15

Écrire des exigences contrôlables, les imbriquer dans une spécification, et en voir une qui n'est pas satisfaite.

Montre Holarch 2.22.

Ce que vous allez apprendre

  • Nommer les limites des exigences sous forme d'attributs avec unités
  • Écrire une définition d'exigence avec un numéro, un énoncé, un sujet et une contrainte require
  • Imbriquer des usages d'exigence dans une spécification et leur donner leurs propres limites avec `:>>`
  • Indiquer ce qui satisfait une exigence, et lire la marque de l'Éditeur quand la conception ne la satisfait pas
  • Contrôler les énoncés d'exigences sur la page Qualité

Écrivez des exigences SysML v2 dans Holarch, en suivant le tutoriel SysML v2 Requirements sur un petit projet Hybrid Car : des limites nommées, des définitions d'exigence avec un numéro, un énoncé, un sujet et une contrainte require, Insérer, une spécification avec des exigences imbriquées, satisfy, une exigence que la berline ne satisfait plus, le tableau des exigences, une Vue des exigences et le contrôle qualité. SysML est une marque déposée d'Object Management Group, Inc.

Fichiers de projet

  • Projet terminé (.holarch.json ; Gérer les projets → Fichiers de projet ▾ → Importer un projet (.json)…)

La vidéo est diffusée depuis holarch.app ; voir la Politique de confidentialité.

Pratique

Faites-le vous-même dans Holarch, sur le projet de démonstration Hybrid Car (SysML v2).

  1. Ouvrez votre projet de démonstration Hybrid Car (créez-le si besoin : Gérer les projets → Fichiers de projet ▾ → Nouveau projet de démonstration → Hybrid Car (SysML v2)), ouvrez Modèle → Éditeur et le package VehicleRequirements.
  2. Après attribute minElectricRange, ajoutez attribute minTopSpeed : SpeedValue = 180 [km/h];.
  3. Sous requirement def <'VR-5'> ChargeTime, choisissez Insérer ▾ → Définition d'exigence et écrivez <'VR-8'> TopSpeed avec l'énoncé The sports car shall reach at least the minimum top speed., le sujet car : SportCar et require constraint { car.topSpeed >= minTopSpeed }.
  4. Après les autres lignes satisfy, ajoutez satisfy requirement roadsterSpeed : TopSpeed by fleet.roadster;.
  5. Changez minTopSpeed en 220 [km/h]. Pointez la marque que l'Éditeur place sur le satisfy pour lire les valeurs comparées, puis appuyez sur ⌘Z / Ctrl+Z.
  6. Ouvrez Besoins et exigences → Exigences et trouvez VR-8, puis ouvrez Besoins et exigences → Qualité et cliquez sur Contrôler la qualité.

C'est terminé quand VR-8 figure dans le tableau Exigences, que le satisfy n'a pas de marque à 180 km/h, et que Contrôler la qualité a noté son énoncé.

Vérifiez vos connaissances

  1. Pourquoi conserver des limites comme maxCurbMass sous forme d'attributs nommés plutôt que d'écrire le nombre dans chaque contrainte ?
  2. Dans requirement <'VR-1.1'> sedanMass : CurbMass { attribute :>> limit = maxCurbMass; }, que fait :>> ?
  3. Que permet de contrôler à Holarch satisfy carSpec by fleet.sedan; ?
  4. Vous définissez l'état et la priorité d'une exigence sur la page Exigences. Le texte SysML change-t-il ?
Afficher les réponses
  1. Pourquoi conserver des limites comme maxCurbMass sous forme d'attributs nommés plutôt que d'écrire le nombre dans chaque contrainte ?

    Toutes les exigences qui utilisent le nom suivent une seule modification, et la limite porte son unité, si bien que le vérificateur compare des valeurs avec leurs unités.

  2. Dans requirement <'VR-1.1'> sedanMass : CurbMass { attribute :>> limit = maxCurbMass; }, que fait :>> ?

    Il redéfinit l'attribut limit dont sedanMass hérite de CurbMass, et donne à cet usage sa propre valeur.

  3. Que permet de contrôler à Holarch satisfy carSpec by fleet.sedan; ?

    Si les valeurs de la berline satisfont les contraintes de carSpec. Si la masse à vide de la berline dépasse la limite, l'Éditeur marque le satisfy et affiche les valeurs comparées.

  4. Vous définissez l'état et la priorité d'une exigence sur la page Exigences. Le texte SysML change-t-il ?

    Non. L'état, la priorité et la méthode de vérification sont des données Holarch conservées à côté du modèle ; elles ne modifient jamais le texte.

Pour aller plus loin

Transcription

Afficher la transcription (narration et contenu de l'écran)

Introduction

Chapter five: requirements. In SysML v2 a requirement can carry a constraint, so the model can check whether a design meets it.

In this chapter you write limits and requirement definitions, nest requirements in a specification, say what satisfies them, and see a requirement that is not met.

Start the tutorial

Start the tutorial Requirements from Project Files, Start a Tutorial. Its starter project holds a small copy of the design: a battery, a car, and a fleet with a sedan of fifteen hundred eighty kilograms.

On screen: Project Files ▾ → Start a Tutorial… → SysML v2: Requirements → Start; Model → Editor.

Requirement definitions

Keep limits as named values, so one edit updates every requirement that uses them. After the requirements comment, add the maximum curb mass and the minimum battery capacity.

On screen: After // ---- Requirements ----: maxCurbMass and minBatteryCapacity.

Below the limits, write the first requirement definition. V R one is its number, doc is its statement, subject is what it is about, and require constraint makes it checkable: Holarch evaluates it with units.

On screen: Below the limits: requirement def <'VR-1'> CurbMass.

Insert

Insert writes the frame of a construct for you. Below the curb mass requirement, open Insert and choose Requirement Definition. Type its number and name, then press Tab to move to the subject, its type and the statement.

On screen: Insert ▾ (open on camera) → Requirement Definition; <'VR-3'> BatteryCapacity, Tab, battery, Tab, Battery, Tab, statement.

Then give it its constraint: the battery's capacity is at least the minimum.

On screen: After the doc line: require constraint { battery.capacity >= minBatteryCapacity }

Specification and satisfy

A specification holds the sedan's requirements. Each one is a usage of a definition, and the symbol after attribute redefines the limit with the sedan's own value.

On screen: After BatteryCapacity: requirement carSpec with sedanMass : CurbMass.

Now say what satisfies them. The sedan of the fleet satisfies the car specification, and a named satisfy says that the sedan's battery satisfies the battery capacity requirement.

On screen: After carSpec: satisfy carSpec by fleet.sedan; satisfy requirement batterySpec …

Break a requirement on purpose. In the fleet, change the sedan's curb mass from fifteen hundred eighty to seventeen hundred kilograms.

On screen: In fleet: curbMass = 1580 → 1700.

The Editor marks the satisfy: the sedan no longer meets V R one point one. Point at the mark to read the values it compared.

On screen: The mark on the satisfy; its information card.

Change it back, or press Command Z, and the mark clears.

On screen: curbMass = 1700 → 1580; No problems.

Pages on the model

The requirements pages work on the model. Open Needs and Requirements, then Requirements. The model's requirements are the rows, numbered by their short names. Status, priority and verification method are Holarch data next to the model; they never change the text.

On screen: Needs & Requirements → Requirements.

Open the Diagrams page, click New Diagram, and choose Requirement View. Choose the car specification under Shows, and click Create: the specification as a tree, with what satisfies it.

On screen: Diagrams → + New Diagram → Requirement View; Shows: VehicleRequirements::carSpec; Create.

Last, open Needs and Requirements, then Quality, and click Check Quality. Each requirement's statement is scored on the quality criteria, as in an LML project.

On screen: Needs & Requirements → Quality → Check Quality.

Recap

Every step is ticked off. Click Mark as Done.

On screen: Step panel → Mark as Done.

Let's recap. You named the limits, wrote requirement definitions with a number, a statement, a subject and a constraint, used Insert, nested requirements in a specification, said what satisfies them, and saw the Editor mark a requirement that was not met.

Next, verification cases check these requirements, and the matrix traces them.