Holarch
Chapitres du cours

Formation · Parcours 1. Prise en main · Chapitre 1.2 sur 8

1.2 Votre premier projet 5:43

Créer un projet, comprendre ce que sont les classes, et ajouter les premiers éléments.

Montre Holarch 2.41.

Ce que vous allez apprendre

  • Créer un projet avec un nom et une description depuis Gérer les projets
  • Choisir la bonne classe LML pour un besoin, une contrainte, une exigence, une fonction et une partie
  • Créer des éléments avec + Nouvel élément et leur donner des numéros et des étiquettes
  • Modifier un élément dans le tableau, puis annuler et rétablir la modification

Créez le projet Bike-Share Dock utilisé dans le reste du cours, découvrez ce que signifie la classe d'un élément, et ajoutez dans la Base de données les premiers besoins des parties prenantes, une contrainte avec une étiquette, une exigence, une fonction et le système ; modifiez dans le tableau et annulez.

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 CubeSat EO-1.

  1. Ouvrez votre projet de démonstration EO-1 (ou créez-le : Gérer les projets → Fichiers de projet ▾ → Nouveau projet de démonstration → CubeSat (ingénierie système guidée)).
  2. Cliquez sur Base de données en bas du rail, puis sur + Nouvel élément. Choisissez la classe Statement, nommez-le Field Boundary Overlays, numérotez-le N4, décrivez le besoin (les agronomes veulent que les limites des parcelles soient tracées sur chaque carte de végétation) et cliquez sur Créer.
  3. Créez un second Statement, Rideshare Mass Limit, numéro C1, indiquant que le satellite ne doit pas dépasser la limite de masse du distributeur. Dans l'inspecteur, cliquez sur + Étiquette et choisissez Constraint.
  4. Créez un Requirement Field Boundary Layer, numéro 6.6, rédigé comme un énoncé « shall », et vérifiez que son État est Brouillon. Créez ensuite une Action Overlay Field Boundaries, numéro F12.
  5. Double-cliquez sur la description de N4 dans le tableau, changez un mot et appuyez sur Entrée. Appuyez sur ⌘Z / Ctrl+Z pour annuler et sur ⇧⌘Z / Ctrl+Maj+Z pour rétablir.
  6. Cliquez sur + Filtre et choisissez la classe Statement pour voir ensemble les besoins et les contraintes.

C'est terminé quand le filtre Statement liste N1 à N4 et C1, que C1 porte l'étiquette Constraint, et que 6.6 Field Boundary Layer affiche l'état Brouillon.

Vérifiez vos connaissances

  1. Pourquoi la classe compte-t-elle quand vous créez un élément ?
  2. Une partie prenante dit que les opérateurs doivent pouvoir planifier les passages depuis chez eux. Est-ce un Statement ou un Requirement ?
  3. À quoi sert une étiquette, si la classe dit déjà ce qu'est un élément ?
Afficher les réponses
  1. Pourquoi la classe compte-t-elle quand vous créez un élément ?

    La classe détermine les attributs et les relations que l'élément peut avoir. Holarch ne propose que les liens qui ont un sens pour lui : un asset peut réaliser une action, un risque non.

  2. Une partie prenante dit que les opérateurs doivent pouvoir planifier les passages depuis chez eux. Est-ce un Statement ou un Requirement ?

    Un Statement : c'est un besoin dans les mots de la partie prenante. Les exigences qui le formalisent viennent ensuite et se tracent vers lui.

  3. À quoi sert une étiquette, si la classe dit déjà ce qu'est un élément ?

    Une étiquette classe les éléments d'une même classe en catégories, comme un Statement étiqueté Constraint : vous pouvez filtrer et produire des rapports par catégorie sans nouvelle classe.

Pour aller plus loin

Transcription

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

Introduction

Chapter two: your first project. You will create a project for a new system, learn what an item's class means, and add the model's first items.

This is the project the rest of the course builds on, so it is worth following along in your own account.

Create the project

In Manage Projects, click New Project. Name the project after the system. Our example for this course is a bike-share dock: a station on the street that holds, locks, charges and rents out bicycles.

On screen: + New Project → Bike-Share Dock.

Add a short description, so others know what the project covers. The folder is optional: it only groups projects in this list. Then click Create Project.

On screen: Description → Create Project.

The new project opens on Home. It is empty for now, so Next actions has one suggestion: write or import the first requirements.

On screen: Home of the new project.

Classes

Everything in a model is an item, which Holarch also calls an entity. Its class says what kind of thing it is. The classes come from the Lifecycle Modeling Language, L M L, and a few of them cover most of the work.

On screen: Concept card: the main classes.

The class decides which attributes and relationships an item can have. A requirement can be satisfied by an asset, and an asset can perform an action, but a risk cannot perform anything. Holarch only offers the links that make sense.

On screen: Concept card.

Create items

Open the Database at the bottom of the rail. In a new project, the table is empty.

On screen: Database (empty).

Click New Entity in the top bar. Choose the class first. Start with a Statement: a good model begins with what people need, before any requirement.

On screen: + New Entity → Statement.

Name it Find a Bike Nearby, number it N.1, and describe the need in the rider's own words. Then click Create.

On screen: Name, number, description → Create.

The new item is selected, and the inspector on the right shows it. Every field can be changed there later.

On screen: The inspector shows N.1.

Add the operator's need the same way: Return Bikes Without Staff, number N.2.

On screen: + New Entity → Statement N.2.

Constraints are statements too. Create one: the dock must fit on a standard sidewalk.

On screen: + New Entity → Statement C.1.

Labels and numbers

Then click Label in the inspector, and choose Constraint. Labels sort the items of one class into kinds, and you can filter and report by them.

On screen: Inspector → + Label → Constraint.

Now the first requirement. Choose the class Requirement, name it Unlock a Bike, number it 1.1, and write it as a shall statement.

On screen: + New Entity → Requirement 1.1.

New requirements start with the status Draft. As the team reviews them, the status moves to In Review and then Approved; a later chapter shows how.

On screen: Inspector → Attributes → Status.

Functions are Actions: what the system does. Create Rent a Bike, number F.1.

On screen: + New Entity → Action F.1.

Parts are Assets. Create the system itself, Bike-Share Dock, number S.0, and give it the label System.

On screen: + New Entity → Asset S.0, label System.

The other parts, functions and requirements are added the same way: the docking bays, the kiosk, the charging unit and the operator's back office; returning a bike, charging and payment; and two more requirements.

On screen: The rest entered off camera; the table fills.

Edit and undo

You can also edit right in the table. Double-click a number or a description, type, and press Enter.

On screen: Double-click the description of Charge Bikes → edit.

Every change is one undo step. Click Undo in the top bar, or press Command Z, and the old text is back. Redo brings the change back again.

On screen: Undo, then Redo.

To see one kind of item at a time, click Filter and choose a class. Here are the assets of the dock.

On screen: + Filter → Asset.

Recap

Let's recap. You created the Bike-Share Dock project, learned what classes are, and added needs, a constraint, a requirement, a function and the system, with numbers and labels, in the Database.

Next, you describe these items with attributes and connect them with relationships.