Capítulos do curso
Treinamento · Trilha 1. Primeiros passos · Capítulo 1.2 de 8
1.2 Seu primeiro projeto 5:43
Crie um projeto, aprenda o que são classes e adicione os primeiros itens.
Mostra o Holarch 2.41.
O que você vai aprender
- Criar um projeto com nome e descrição em Gerenciar projetos
- Escolher a classe LML certa para uma necessidade, uma restrição, um requisito, uma função e uma parte
- Criar itens com + Novo item e dar a eles números e rótulos
- Editar um item na tabela e desfazer e refazer a mudança
Crie o projeto Bike-Share Dock usado no restante do curso, aprenda o que significa a classe de um item e adicione no Banco de dados as primeiras necessidades dos stakeholders, uma restrição com rótulo, um requisito, uma função e o sistema; edite na tabela e desfaça.
Arquivos de projeto
- Projeto concluído (.holarch.json; Gerenciar projetos → Arquivos de projeto ▾ → Importar projeto (.json)…)
O vídeo é reproduzido a partir de holarch.app; veja a Política de Privacidade.
Prática
Faça isto você mesmo no Holarch, no projeto de demonstração CubeSat EO-1.
- Abra seu projeto de demonstração EO-1 (ou crie-o: Gerenciar projetos → Arquivos de projeto ▾ → Novo projeto de demonstração → CubeSat (engenharia de sistemas guiada)).
- Clique em Banco de dados na parte inferior da barra lateral e depois em + Novo item. Escolha a classe Statement, dê o nome
Field Boundary Overlays, o númeroN4, descreva a necessidade (os agrônomos querem os limites dos talhões desenhados em cada mapa de vegetação) e clique em Criar. - Crie um segundo Statement,
Rideshare Mass Limit, númeroC1, declarando que a espaçonave não deve exceder o limite de massa do dispensador. No inspetor, clique em + Rótulo e escolha Restrição. - Crie um Requisito
Field Boundary Layer, número6.6, escrito como uma declaração com shall, e confira que seu Status é Rascunho. Depois crie uma AçãoOverlay Field Boundaries, númeroF12. - Clique duas vezes na descrição de N4 na tabela, altere uma palavra e pressione Enter. Pressione ⌘Z / Ctrl+Z para desfazer e ⇧⌘Z / Ctrl+Shift+Z para refazer.
- Clique em + Filtro e escolha a classe Statement para ver as necessidades e as restrições juntas.
Você terminou quando o filtro Statement listar de N1 a N4 e C1, C1 tiver o rótulo Restrição e 6.6 Field Boundary Layer mostrar o status Rascunho.
Teste-se
- Por que a classe importa quando você cria um item?
- Um stakeholder diz que os operadores devem poder planejar passagens de casa. Isso é um Statement ou um Requirement?
- Para que serve um rótulo, se a classe já diz o que um item é?
Mostrar as respostas
Por que a classe importa quando você cria um item?
A classe decide quais atributos e relacionamentos o item pode ter. O Holarch só oferece vínculos que fazem sentido para ele: um ativo pode executar uma ação, um risco não.
Um stakeholder diz que os operadores devem poder planejar passagens de casa. Isso é um Statement ou um Requirement?
Um Statement: é uma necessidade nas palavras do stakeholder. Os requisitos que a formalizam vêm depois e são rastreados até ela.
Para que serve um rótulo, se a classe já diz o que um item é?
Um rótulo separa itens de uma classe em tipos, como um Statement com o rótulo Restrição, para que você possa filtrar e gerar relatórios por tipo sem uma nova classe.
Saiba mais
Transcrição
Mostrar a transcrição (narração e o que aparece na tela)
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.