Exigences & architecture

Le diagramme d'exigences SysML : notation, sens des flèches et passage à SysML v2

Exigences & architecture · · Publié le 2026-11-21

Gros plan sur un tiroir de fichier en bois rempli de fiches cartonnées ; la fiche du premier plan porte une cote, KF35, et un titre dactylographié
Le fichier des périodiques de la Bibliothèque du Congrès, à Washington, en janvier 2025 : chaque fiche porte une cote unique et un texte court, comme une exigence SysML porte un identifiant et un énoncé. Photo : Shawn Miller, Library of Congress, via Wikimedia Commons, CC0.

Le diagramme d'exigences est le plus simple des neuf diagrammes de SysML v1 : des boîtes, du texte et des flèches pointillées. C'est aussi celui où l'on se trompe le plus souvent, parce que chaque flèche a un sens précis et que la moitié des modèles les dessinent à l'envers. Voici sa notation complète, un exemple pas à pas, les bonnes pratiques de mise en page et ce que devient l'exigence dans SysML v2.

Pourquoi un diagramme propre aux exigences

UML, dont SysML v1 est dérivé, ne connaît pas la notion d'exigence. SysML l'a ajoutée, avec le diagramme paramétrique, pour que les attentes envers le système vivent dans le même modèle que son architecture et ses comportements. Notre panorama des neuf diagrammes de SysML le range à part : il ne décrit ni la structure ni le comportement, mais ce qu'on attend du système.

La dernière version de la spécification de la famille 1.x, SysML 1.7, publiée par l'OMG en juin 2024, y consacre un chapitre « Requirements ». C'est lui qui fixe tout ce qui suit. Écrire l'énoncé lui-même relève d'un autre savoir-faire, que nous détaillons dans écrire une bonne exigence.

La boîte « requirement »

Une exigence se dessine comme un rectangle portant le mot-clé «requirement» et un nom. La norme ne lui donne que deux propriétés :

Tout le reste (priorité, statut, justification, méthode de vérification prévue, source) n'est pas standard. Les équipes l'ajoutent par des stéréotypes ou des profils maison, et chaque outil propose les siens. C'est un point à décider dès le début d'un projet : une propriété « justification » vide sur trois cents exigences ne sert à rien. Le guide d'ingénierie système de la NASA insiste pourtant sur ce point, en demandant que chaque exigence soit accompagnée de sa justification et qu'elle ait une « bidirectional traceability to the baselined stakeholder expectations », c'est-à-dire une traçabilité dans les deux sens jusqu'aux attentes validées des parties prenantes.

Les relations, et le sens de chaque flèche

Une seule relation n'est pas une flèche pointillée : la contenance, dessinée par un trait plein terminé par un cercle barré d'une croix, du côté de l'exigence qui contient. Elle sert à découper une exigence chapeau en exigences plus fines. Toutes les autres sont des dépendances, dessinées en pointillés avec une pointe ouverte et leur mot-clé. Leur sémantique est détaillée dans notre article sur la traçabilité des exigences ; ici, c'est le sens qui compte, car il suit toujours la même règle : la flèche part de l'élément qui dépend et pointe vers celui dont il dépend.

Mot-cléLa flèche part de…… et pointe vers
«deriveReqt»l'exigence dérivéel'exigence source
«satisfy»le bloc ou l'élément de conceptionl'exigence satisfaite
«verify»le cas de test («testCase»)l'exigence vérifiée
«refine»l'élément qui précise (cas d'utilisation, activité)l'exigence précisée
«trace»l'élément liél'exigence
«copy»la copie, en lecture seulel'exigence d'origine

Le piège classique est la dérivation dessinée de haut en bas, « comme un arbre ». Or la flèche «deriveReqt» remonte : elle part de l'exigence de détail et pointe vers celle dont elle découle. La contenance, elle, se lit dans l'autre sens.

Notes de rappel et tableaux

Dessiner une flèche vers un élément situé dans un autre diagramme encombre vite la vue. SysML prévoit donc une notation compacte : une note de rappel attachée à l'élément, du type « satisfies EX-12 » ou « verifiedBy Essai-04 ». Elle dit la même chose qu'une flèche, sans obliger à faire figurer les deux éléments côte à côte.

Au-delà d'une vingtaine de boîtes, le diagramme devient illisible. La spécification autorise des vues tabulaires : liste des exigences avec leurs propriétés, ou matrice qui croise exigences et blocs, exigences et cas de test. En pratique, la plupart des projets tiennent leurs exigences dans ces tableaux et réservent le diagramme à l'explication d'un point précis : la décomposition d'une exigence de sécurité, la couverture d'un essai, un arbitrage.

Un exemple complet

Prenons un vélo à assistance électrique, avec des valeurs choisies pour l'exemple :

  1. EX-1 Autonomie : « Le vélo doit parcourir au moins 60 km en mode d'assistance normal, batterie neuve, sur le parcours de référence. »
  2. Une analyse de consommation fait apparaître EX-1.1 Énergie embarquée : « La batterie doit fournir au moins 500 Wh utilisables. » EX-1.1 porte une flèche «deriveReqt» vers EX-1.
  3. Le bloc Batterie de l'architecture porte une flèche «satisfy» vers EX-1.1.
  4. Le cas de test Essai d'autonomie sur banc porte une flèche «verify» vers EX-1 ; une analyse de capacité, modélisée elle aussi comme cas de test, vérifie EX-1.1.
  5. Le cas d'utilisation Effectuer un trajet porte une flèche «refine» vers EX-1, parce qu'il décrit ce que « parcourir » veut dire pour l'utilisateur.

Sur un seul diagramme, on lit alors toute la chaîne : d'où vient l'exigence de batterie, quel composant y répond, et quelles preuves sont attendues. Le jour où l'exigence d'autonomie passe à 70 km, les éléments touchés se retrouvent en suivant les flèches.

Ce que coûte une hypothèse non tracée

Relier chaque exigence à sa justification et à sa vérification n'est pas une coquetterie de modélisateur. Le rapport final de la commission des transports de la Chambre des représentants américaine sur le Boeing 737 MAX, publié en septembre 2020, met en cause des défauts de conception et des hypothèses erronées autour du système anti-décrochage MCAS ; Clubic résumait alors que ce système « n'avait pas pu être contourné par les pilotes ». Le document complet, de 239 pages, est en ligne sur le site de la commission. Un diagramme ne remplace ni une analyse de sécurité ni une revue indépendante, mais il rend visible une exigence qui n'a ni source ni vérification.

Échanger des exigences avec d'autres outils

Les exigences naissent souvent hors du modeleur : dans un outil de gestion des exigences, un tableur, un cahier des charges client. Le format d'échange standard est ReqIF (Requirements Interchange Format), dont la version 1.2 date de juillet 2016, lui aussi publié par l'OMG. Côté outils libres, le module complémentaire Requirements Viewpoint de Capella, développé par Thales sous licence EPL, importe des exigences depuis un fichier ReqIF pour les relier au modèle. Le SEBoK, corpus de connaissances en ingénierie système publié notamment avec l'INCOSE, consacre une page à la définition des exigences système, utile pour fixer les attributs à échanger.

Et en SysML v2 ?

L'OMG a approuvé l'adoption finale de SysML v2 en juillet 2025, avec le langage noyau KerML et l'API de services. Les exigences y changent de nature : une requirement def est une définition réutilisable, avec un sujet (l'élément sur lequel elle porte), des hypothèses et des contraintes requises, que l'outil peut évaluer. L'énoncé en langage naturel reste disponible sous forme de documentation.

requirement def <'EX-1.1'> EnergieEmbarquee {
    doc /* La batterie doit fournir au moins 500 Wh utilisables. */
    subject batterie : Batterie;
    require constraint { batterie.energieUtile >= 500 [Wh] }
}

requirement energieVelo : EnergieEmbarquee;
satisfy energieVelo by velo.batterie;

Les relations de satisfaction et de vérification deviennent des éléments du langage, et la vérification se décrit dans des définitions de vérification qui disent quelle exigence elles contrôlent. La spécification complète se trouve sur la page SysML 2.0 de l'OMG ; notre article sur ce qui change en SysML v2 complète ce tour d'horizon.

Sources