Holarch
Kurskapitel

Schulung · Reihe 2. Anforderungen und Verifikation · Kapitel 2.4 von 6

2.4 Baselines und zu prüfende Verknüpfungen 2:40

Die Spezifikation in einer Baseline einfrieren, eine Anforderung ändern und prüfen, was die Änderung berührt.

Zeigt Holarch 2.13.

Das lernen Sie

  • Eine Dokument-Baseline mit einem Genehmigungsdatensatz speichern
  • Erklären, was eine Änderung an einer genehmigten Anforderung mit ihrem Status und ihren Links macht
  • Einen markierten Link mit „Vergleich“ prüfen und ihn mit einer Notiz als geprüft markieren
  • Eine Baseline mit der aktuellen Version vergleichen und die Änderungen exportieren

Frieren Sie die Spezifikation des Bike-Share Dock mit einer Genehmigung in einer Baseline ein, ändern Sie eine genehmigte Anforderung, sehen Sie, wie sie in die Prüfung zurückkehrt und ihre Links zur Prüfung markiert werden, prüfen Sie den Link und markieren Sie ihn mit einer Notiz als geprüft, und listen Sie jede Änderung seit der Baseline auf.

Projektdateien

  • Startprojekt (.holarch.json; Projekte verwalten → Projektdateien ▾ → Projekt importieren (.json)…)
  • Fertiges Projekt (.holarch.json; Projekte verwalten → Projektdateien ▾ → Projekt importieren (.json)…)

Das Video wird von holarch.app abgespielt; siehe Datenschutzerklärung.

Übung

Führen Sie dies selbst in Holarch durch, am Demoprojekt CubeSat EO-1.

  1. Öffnen Sie Ihr EO-1-Demoprojekt (oder erstellen Sie es: Projekte verwalten → Projektdateien ▾ → Neues Demoprojekt → CubeSat (Geführtes Systems Engineering)).
  2. Öffnen Sie EO-1 System Requirements Specification, klicken Sie im Titelblock auf Version ▾ und wählen Sie Baseline speichern…. Nennen Sie sie PDR Baseline, füllen Sie eine Genehmigerzeile mit Ihrem Namen und Ihrer Rolle aus und klicken Sie auf Erstellen.
  3. Ändern Sie in der Beschreibung von 3.3 Depth of Discharge 30 % in 25 % und lesen Sie die Meldung: Die Anforderung ist wieder In Review, und ihre Links müssen geprüft werden.
  4. Öffnen Sie Bedarfe & Anforderungen → Zu prüfende Verknüpfungen. Klicken Sie in einer Zeile für 3.3 auf Vergleich, dann auf Als geprüft markieren…, notieren Sie, was Sie geprüft haben, und klicken Sie auf Als geprüft markieren.
  5. Wählen Sie im Dokument Version ▾ → Versionen vergleichen… mit Von PDR Baseline und Bis Aktuelle Version und klicken Sie auf Änderungen (Excel).
  6. Öffnen Sie Steuerung & Prüfungen → Baselines & Versionen und finden Sie PDR Baseline neben SRR Baseline. Um das ganze Modell statt eines Dokuments einzufrieren, würden Sie + Baseline speichern… im Kopf dieser Seite verwenden.

Sie sind fertig, wenn der Änderungsbericht ab PDR Baseline die Änderung an 3.3 auflistet und der geprüfte Link nicht mehr unter „Zu prüfende Verknüpfungen“ erscheint.

Selbsttest

  1. Warum markiert eine Änderung an einer Anforderung die Links, die von ihr abhängen, und nicht nur die Anforderung selbst?
  2. Was ist der Unterschied zwischen einer Dokument-Baseline und einer Projekt-Baseline?
  3. Warum schreibt man eine Notiz, wenn man einen Link als geprüft markiert?
Antworten anzeigen
  1. Warum markiert eine Änderung an einer Anforderung die Links, die von ihr abhängen, und nicht nur die Anforderung selbst?

    Die Elemente am anderen Ende, etwa die Funktion, die sie erfüllt, oder der Test, der sie verifiziert, wurden gegen den alten Text geprüft. Jeder Link muss erneut geprüft werden, um zu sehen, ob er noch gilt.

  2. Was ist der Unterschied zwischen einer Dokument-Baseline und einer Projekt-Baseline?

    Eine Dokument-Baseline friert ein Dokument und seine Genehmigungen ein (Version ▾ → Baseline speichern…). Eine Projekt-Baseline friert jedes Element und jede Beziehung ein (Baselines & Versionen → + Baseline speichern…).

  3. Warum schreibt man eine Notiz, wenn man einen Link als geprüft markiert?

    Die Notiz hält fest, was geprüft wurde und warum der Link noch gilt. Sie wird den Kommentaren des verknüpften Elements hinzugefügt, sodass ein Reviewer die Entscheidung später nachvollziehen kann.

Weiterlesen

Transkript

Transkript anzeigen (Erzählung und Bildschirminhalt)

Introduction

Chapter four: baselines and links to review. Once a specification is agreed, changes need control: everyone should know what changed, and what the change might break.

We baseline the Bike-Share Dock specification, then change one of its requirements.

Change control

A baseline is a read-only snapshot of a document, with its approvals. After it, every change is visible, and a change to a requirement marks the links that depend on it for review, until someone checks them.

On screen: Card: baselines and links to review.

First, give Show Available Bikes a link to depend on. In the Database, select it, and in its Trace section link it with satisfied by to the rental kiosk, which shows the numbers.

On screen: 4.1.1 → Trace → satisfied by + → Link existing… → Rental Kiosk.

Baseline

Open the specification, and the version menu in its title block. Choose Save Baseline, name it SRR Baseline for the requirements review, add your role, and click Create.

On screen: SRS → Current version ▾ → Save Baseline… → SRR Baseline → Create.

A change

Now a change. The team wants the kiosk to show the charge level of each e-bike too. Select Show Available Bikes, and update its statement in the inspector.

On screen: 4.1.1 → Item → new description.

The message says what happened, in the same undo step as the edit: the approved requirement went back to In Review, and its link to the rental kiosk now needs review.

On screen: The toast and the status.

Links to review

Open Needs and Requirements, then Links to Review. Each row is a link to check. Diff shows exactly how the text changed.

On screen: Links to Review → Diff.

The rental kiosk can show charge levels too, so the link still holds. Click Mark Reviewed, write what you checked, and click Mark Reviewed. The link no longer needs review.

On screen: Mark Reviewed… → note → Mark Reviewed.

Changes since the baseline

To see everything that changed since the review, open the specification's version menu again, and choose Compare Versions: from SRR Baseline to the current version.

On screen: SRS → version ▾ → Compare Versions… → SRR Baseline → Current.

The report lists each addition, removal and edit, ready to export to Excel or as a Word redline for a change board.

On screen: The change report.

Recap

Let's recap. You baselined the specification with an approval, changed an approved requirement, saw it return to review with its link flagged, marked the link reviewed with a note, and listed the changes since the baseline.

Next, you plan and run the tests that verify the requirements.