Holarch
Capitoli del corso

Formazione · Percorso 1. Primi passi · Capitolo 1.2 di 8

1.2 Il primo progetto 5:43

Creare un progetto, imparare che cosa sono le classi e aggiungere i primi elementi.

Mostra Holarch 2.41.

← 1.1 L’area di lavoro di Holarch · Tutti i capitoli · 1.3 Attributi e relazioni →

Che cosa si impara

  • Creare un progetto con nome e descrizione da Gestisci progetti
  • Scegliere la classe LML giusta per un bisogno, un vincolo, un requisito, una funzione e una parte
  • Creare elementi con + Nuovo elemento e assegnare loro numeri ed etichette
  • Modificare un elemento nella tabella e annullare e ripetere la modifica

Creare il progetto Bike-Share Dock usato nel resto del corso, imparare che cosa significa la classe di un elemento, e aggiungere nel Database i primi bisogni degli stakeholder, un vincolo con un’etichetta, un requisito, una funzione e il sistema; modificare nella tabella e annullare.

File di progetto

  • Progetto completato (.holarch.json; Gestisci progetti → File di progetto ▾ → Importa progetto (.json)…)

Il video viene riprodotto da holarch.app; vedere l’Informativa sulla privacy.

Esercitazione

Provare in prima persona in Holarch, sul progetto demo CubeSat EO-1.

  1. Aprire il proprio progetto demo EO-1 (oppure crearlo: Gestisci progetti → File di progetto ▾ → Nuovo progetto demo → CubeSat (ingegneria dei sistemi guidata)).
  2. Fare clic su Database in fondo alla barra laterale, poi su + Nuovo elemento. Scegliere la classe Statement, chiamarlo Field Boundary Overlays, numerarlo N4, descrivere il bisogno (gli agronomi vogliono i confini dei campi disegnati su ogni mappa della vegetazione) e fare clic su Crea.
  3. Creare un secondo Statement, Rideshare Mass Limit, numero C1, che stabilisce che il veicolo spaziale non deve superare il limite di massa del dispenser. Nell’ispettore, fare clic su + Etichetta e scegliere Vincolo.
  4. Creare un Requisito Field Boundary Layer, numero 6.6, scritto come enunciato con shall, e verificare che il suo Stato sia Bozza. Poi creare un’Azione Overlay Field Boundaries, numero F12.
  5. Fare doppio clic sulla descrizione di N4 nella tabella, cambiare una parola e premere Enter. Premere ⌘Z / Ctrl+Z per annullare la modifica e ⇧⌘Z / Ctrl+Shift+Z per ripeterla.
  6. Fare clic su + Filtro e scegliere la classe Statement per vedere insieme bisogni e vincoli.

L’esercizio è completato quando il filtro Statement elenca da N1 a N4 e C1, C1 porta l’etichetta Vincolo e 6.6 Field Boundary Layer mostra lo stato Bozza.

Verifica

  1. Perché la classe è importante quando si crea un elemento?
  2. Uno stakeholder dice che gli operatori devono poter pianificare i passaggi da casa. È uno Statement o un Requirement?
  3. A che cosa serve un’etichetta, se la classe dice già che cos’è un elemento?
Mostra le risposte
  1. Perché la classe è importante quando si crea un elemento?

    La classe decide quali attributi e relazioni può avere l’elemento. Holarch propone solo collegamenti sensati per esso: un asset può eseguire un’azione, un rischio no.

  2. Uno stakeholder dice che gli operatori devono poter pianificare i passaggi da casa. È uno Statement o un Requirement?

    Uno Statement: è un bisogno espresso con le parole dello stakeholder. I requisiti che lo formalizzano vengono dopo e si tracciano a ritroso verso di esso.

  3. A che cosa serve un’etichetta, se la classe dice già che cos’è un elemento?

    Un’etichetta suddivide in tipi gli elementi di una classe, come uno Statement con l’etichetta Vincolo, così si può filtrare e produrre report per tipo senza una nuova classe.

Per saperne di più

Trascrizione

Mostra la trascrizione (narrazione e contenuto dello schermo)

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.