Anforderungen
Anforderungen
Schreiben, prüfen, genehmigen, baselinen und importieren Sie Anforderungen und verfolgen Sie offene TBD/TBR-Punkte und zu prüfende Verknüpfungen.
Auf dieser Seite
- Überblick
- Konzepte
- So setzen Sie es ein
- Wann und warum
- Eine Anforderung schreiben
- Die Formulierung prüfen
- Mit EARS-Vorlagen schreiben
- Anforderungen genehmigen
- Ein Dokument für ein Review einfrieren
- Eine Änderung nach der Baseline behandeln
- TBD- und TBR-Punkte schließen
- Eine vorhandene Spezifikation importieren
- Durchgehendes Beispiel: die CubeSat-EO-1-Demo
- Tipps und bewährte Vorgehensweisen
- Häufige Fehler
- Zusammenhang mit anderen Funktionen
- Die Seite Anforderungen
- Anforderungsqualität
- Genehmigungen
- TBD/TBR-Register
- Zu prüfende Verknüpfungen
- Baselines und Versionsvergleich
- Anforderungen importieren
- Tastenkürzel für Anforderungen
- Einstellungen
- Meldungen
- Grenzen
- Verwandte Themen
Überblick
Mit den Anforderungsseiten schreiben, prüfen, genehmigen und baselinen Sie Anforderungen und verfolgen, was noch offen ist. Eine Anforderung ist eine Entität der LML-Klasse Requirement: eine Fähigkeit, Eigenschaft oder ein Qualitätsfaktor, den das System haben muss.
Anforderungen stehen meist in einem Anforderungsdokument (siehe Dokumente). Jede ist dennoch eine Entität im Modell. Dieselbe Anforderung erscheint daher in der Datenbank, in Diagrammen, in der Nachverfolgbarkeitsmatrix und in der RVTM.
Die Gruppe Bedarfe & Anforderungen in der Navigationsleiste enthält alle Anforderungsseiten:
| Seite | Was er zeigt |
|---|---|
| Dokumente | Spezifikationen und ihre Gliederungen. Hier werden Anforderungen geschrieben. |
| Anforderungen | Alle Anforderungen in einer Tabelle (die Datenbank, gefiltert auf class:Requirement). |
| Qualität | Die Anforderungsqualität: eine Bewertung nach neun Kriterien je Anforderung. |
| TBD/TBR | Das Register offener Werte, die noch zu bestimmen oder zu prüfen sind. |
| Zu prüfende Verknüpfungen | Verknüpfungen, deren vorgelagerte Anforderung sich nach der letzten Prüfung der Verknüpfung geändert hat. |
| Genehmigungen | Anforderungen mit dem Status In Review. |
| Import und Export | Import für Word, Excel, CSV, ReqIF, reinen Text, XMI und Projektdateien über eine einzige Ablagefläche sowie die Modellexporte. |
Baselines sind eingefrorene Momentaufnahmen für Reviews. Erstellen Sie sie aus einem Dokument oder unter Steuerung & Prüfungen → Baselines & Versionen. Verknüpfungen zu Funktionen, Assets und Tests werden unter Nachverfolgbarkeit behandelt.
Konzepte
Requirement und Statement
Statement ist die Elternklasse von Requirement.
- Verwenden Sie ein Statement für nicht verbindlichen Text: Abschnittsüberschriften, Annahmen, Kontext.
- Verwenden Sie ein Requirement für jede verbindliche "shall"-Aussage.
Nur Requirements werden von der Qualitätsprüfung bewertet, im TBD/TBR-Register aufgeführt, bei Änderungen zur Prüfung markiert und in der RVTM gezählt. Statements werden übersprungen.
Eine Anforderung hat die gemeinsamen Entitätsfelder Number, Name und Description. Die Beschreibung ist die Anforderungsaussage selbst, als Rich Text. Die folgenden Attribute ergänzen den Rest.
Anforderungsattribute
| Attribut | Typ und Werte | Bedeutung |
|---|---|---|
| Begründung | Langer Text | Der Grund hinter der Anforderung. |
| Status | Draft, In Review, Approved, Rejected | Wo die Anforderung im Genehmigungs-Workflow steht. |
| Priorität | High, Medium, Low | Wie wichtig die Anforderung für die Stakeholder ist. |
| Criticality | High, Medium, Low | Folge für die Mission oder die Sicherheit, wenn die Anforderung nicht erfüllt wird. |
| Verantwortlich | Text | Person oder Team, die für die Anforderung verantwortlich ist. |
| Quelle | Text | Stakeholder, Dokument oder Norm, aus dem die Anforderung stammt. |
| Verification Method | Mehrfachauswahl: Analysis, Demonstration, Inspection, Test | Wie die Anforderung verifiziert wird. |
| Verifikationsstufe | Component, Subsystem, System | Integrationsebene, auf der die Anforderung verifiziert wird. |
| Erfolgskriterien | Langer Text | Messbares Ergebnis, das zeigt, dass die Anforderung erfüllt ist. |
| TBD/TBR | None, TBD, TBR | TBD = ein Wert ist noch zu bestimmen; TBR = ein Wert ist noch zu prüfen. Nach dem Schließen wieder auf None setzen. |
| TBD Owner | Text | Person, die für das Schließen des TBD/TBR verantwortlich ist. |
| TBD Due Date | Datum und Uhrzeit | Datum, bis zu dem das TBD/TBR geschlossen sein muss. Fälligkeitsdatum in der Gruppe Workflow zeigt und setzt dasselbe Datum (siehe TBD/TBR-Register). |
| Qualitätswert | Prozent, berechnet | Ergebnis der letzten Qualitätsprüfung. |
| Appropriate, Complete, Conforming, Correct, Feasible, Necessary, Singular, Unambiguous, Verifiable | Ja/Nein, berechnet oder von Hand gesetzt | Die neun Qualitätskriterien. |
Der Inspektor gruppiert die Felder einer Anforderung (siehe Der Inspektor): Requirement (Number, Name, Description, Labels, Rationale, Source, Success Criteria), Workflow (die Review-Leiste mit Status, Priority, Criticality, Owner, Assignee, Due date, TBD/TBR, TBD Owner, TBD Due Date), Verifikation (Verification Method und Level, Verified by sowie die Abschlussfelder mit dem formalen Programm), Werte (Budget Quantity, Threshold, Objective und aktueller Value, Units), Konformität (formales Programm) und Qualität.
Der Wert und die neun Kriterien befinden sich in der Gruppe Qualität, die zunächst eingeklappt ist. Ihre Überschrift lautet zum Beispiel "89% · 8 of 9 met" oder "not checked yet". Holarch merkt sich pro Klasse, ob Sie die Gruppe geöffnet gelassen haben.
Projekte können eigene Anforderungsattribute und Auswahlwerte hinzufügen; siehe Schemaerweiterungen.
Anforderungslabels
Labels klassifizieren Anforderungen, ohne ihre Klasse zu ändern. Die integrierten Anforderungslabels sind:
- Functional Requirement, Performance Requirement, Schnittstellenanforderung.
- Environmental Requirement, Reliability Requirement, Safety Requirement.
- Verification Requirement.
- Stakeholder Need: ein von einem Stakeholder geäußerter Bedarf, bevor er in Systemanforderungen umgesetzt wird.
Verification Method ist auch eine Labelgruppe, mit den Labels Analysis, Demonstration, Inspection und Test. Label und Attribut bleiben im selben Rückgängig-Schritt synchron:
- Das Hinzufügen des Labels Test setzt Verification Method auf Test.
- Die Auswahl von Test im Attribut fügt das Label hinzu.
Ältere Projekte und Importe, die nur die Labels tragen, werden beim Öffnen des Projekts in das Attribut übernommen.
Der Anforderungs-Workflow
Jede Anforderung durchläuft vier Status:
- Entwurf: wird geschrieben.
- In Review: wartet auf eine Entscheidung. Auf der Seite Genehmigungen aufgeführt.
- Genehmigt oder Abgelehnt: entschieden. Jede Entscheidung hält fest, wer sie wann getroffen hat, und einen optionalen Grund.
Nach der Genehmigung halten drei Mechanismen den Datensatz ehrlich:
- Erneutes Review bei Bearbeitung. Das Bearbeiten von Name oder Beschreibung einer genehmigten Anforderung setzt sie zurück auf In Review, mit der Notiz "Text nach der Genehmigung geändert".
- Veraltete Qualität. Das Bearbeiten von Name oder Beschreibung markiert die Qualitätsergebnisse als veraltet und löscht manuelle Qualitätsübersteuerungen.
- Zu prüfende Verknüpfungen. Das Bearbeiten von Name, Beschreibung oder einem Schlüsselattribut markiert die Verknüpfungen zu den nachgelagerten Elementen zur Prüfung.
Alle drei gehören zur Bearbeitung, sodass ein einziges Rückgängigmachen (⌘Z / Ctrl+Z) sie gemeinsam zurücknimmt.
Offene Punkte: TBD, TBR und TBS
Ein offener Punkt ist ein Wert, der noch nicht feststeht. Eine Anforderung ist ein offener Punkt, wenn eines davon zutrifft:
- Ihr Attribut TBD/TBR ist TBD oder TBR.
- Ihr Name oder ihre Beschreibung enthält das Wort TBD, TBR oder TBS.
Offene Punkte erscheinen im TBD/TBR-Register, bis sie geschlossen sind.
Baselines
Eine Baseline ist eine schreibgeschützte Momentaufnahme. Es gibt zwei Arten:
- Eine Dokument-Baseline enthält ein Dokument. Sie umfasst das Dokument-Artifact, seine Elemente und deren Attribute, die Beziehungen, die sie berühren, die Entitäten einen Schritt entfernt und die Gliederungseinstellungen des Dokuments.
- Eine Projekt-Baseline enthält alle Entitäten und Beziehungen des Projekts.
Baselines können Genehmigungsdatensätze tragen (Name, Rolle, Erklärung, Datum). Die Datensätze sind nach dem Speichern gesperrt.
So setzen Sie es ein
Wann und warum
Die Anforderungsarbeit umfasst die linke Seite des Systems-Engineering-V:
- Stakeholder-Bedarfe erfassen.
- Systemanforderungen ableiten.
- Prüfen, ob jede Aussage gut formuliert ist.
- Die Anforderungen genehmigen lassen.
- Sie bei einem Review einfrieren (SRR, PDR, CDR).
Nach der Baseline wendet sich die Arbeit der Änderungssteuerung zu. Jede Änderung wird erneut geprüft und ihre nachgelagerte Auswirkung kontrolliert. Die offenen TBD/TBR-Werte werden geschlossen, bevor das Design festgelegt wird.
Die Anforderungsseiten beantworten diese Fragen:
| Frage | Seite |
|---|---|
| Ist jede Anforderung gut geschrieben? | Qualität |
| Welche Werte sind noch unbekannt, wer ist dafür verantwortlich und sind sie überfällig? | TBD/TBR |
| Was muss erneut geprüft werden, weil sich eine Anforderung geändert hat? | Zu prüfende Verknüpfungen |
| Was wartet auf eine Entscheidung? | Genehmigungen |
| Was hat sich seit dem Review geändert? | Dokument Version ▾ → Versionen vergleichen…, Baselines & Versionen |
| Ist jede Anforderung zugeordnet und verifiziert? | Nachverfolgbarkeitsmatrix und RVTM |
Die Seiten Qualität, Zu prüfende Verknüpfungen, TBD/TBR und Genehmigungen liegen in der Navigationsleiste nebeneinander unter Bedarfe & Anforderungen. Gehen Sie von dort alle vier Prüfungen nacheinander durch.
Eine Anforderung schreiben
- Öffnen Sie Bedarfe & Anforderungen → Dokumente.
- Öffnen Sie das Anforderungsdokument.
Um ein neues anzulegen, klicken Sie auf + Neues Dokument (siehe Dokumente).
- Wählen Sie in der Leiste Schnell hinzufügen unter dem Dokument, wohin das Element kommt, zum Beispiel Unter 3 Electrical Power.
- Geben Sie die Anforderungsaussage ein und drücken Sie Enter.
Holarch fügt ein Element der Standardklasse des Dokuments hinzu (Requirement in einem Anforderungsdokument). Es wird nach seinen Geschwistern nummeriert.
- Öffnen Sie bei ausgewählter Anforderung den Inspektor auf der rechten Seite.
- Füllen Sie Begründung, Quelle und Erfolgskriterien in der Gruppe Requirement, Priorität, Criticality und Owner in Workflow sowie Verification Method und Verifikationsstufe in Verifikation aus.
- Fügen Sie mit + Label in der Gruppe Requirement des Inspektors ein Typlabel hinzu, zum Beispiel Performance Requirement. (Die Spalte Labels finden Sie unter Ansicht ▾ → Spalten ▸.)
Die Anforderung hat den Status Entwurf und erscheint unter Bedarfe & Anforderungen → Anforderungen.
Wenn ein Wert noch nicht bekannt ist:
- Schreiben Sie Ihre beste Schätzung in die Aussage.
- Setzen Sie TBD/TBR auf TBD.
- Füllen Sie TBD Owner aus und setzen Sie das Datum unter Fälligkeitsdatum in der Gruppe Workflow.
Die Anforderung erscheint nun auch im TBD/TBR-Register, mit diesem Fälligkeitsdatum.
Die Formulierung prüfen
- Öffnen Sie Bedarfe & Anforderungen → Qualität.
Wählen Sie in einem Dokument stattdessen Prüfen ▾ → Qualität prüfen.
- Wählen Sie in der Bereichsleiste Alle Anforderungen oder Dokument: <Name>.
- Klicken Sie im Seitenkopf auf Qualität prüfen.
Die Meldung lautet "32 Anforderungen geprüft" (oder Ihre Anzahl). Jede Anforderung erhält einen Wert von 0 bis 100 % und je Kriterium ein ✔ oder ✘.
Bei mehr als 2.000 Anforderungen läuft die Prüfung im Hintergrund: Die Fortschrittskarte zeigt "Anforderungen werden geprüft", die Anzahl und die verbleibende Zeit, und Sie können weiterarbeiten. Klicken Sie auf der Karte auf Abbrechen, um anzuhalten; es ändert sich nichts. Danach lautet die Karte "Qualitätsergebnisse werden gespeichert" mit der Anzahl der gespeicherten; während des Speicherns werden andere Bearbeitungen mit "Qualitätsergebnisse werden gespeichert. Nach Abschluss erneut versuchen." abgelehnt. Nur Anforderungen mit geänderten Ergebnissen werden gespeichert, sodass eine erneute Prüfung ohne Änderungen nichts speichert. Die ganze Prüfung ist ein Schritt: Ein ⌘Z / Ctrl+Z entfernt sie.
- Lesen Sie die Kacheln: Anforderungen, Durchschnittswert, Gut (≥ 67 %), Überarbeitung nötig (< 67 %) und, falls vorhanden, Veraltet (Text geändert).
- Lesen Sie für jede Anforderung unter 67 % die Spalte Vorschläge.
Oder zeigen Sie auf ein ✘, um die Meldungen zu diesem Kriterium zu sehen.
- Klicken Sie auf den Namen der Anforderung, um sie zu öffnen, und korrigieren Sie den Text.
- Führen Sie die Prüfung erneut aus.
Correct und Feasible erfordern immer das Urteil einer Person. Die Prüfung markiert sie nie als erfüllt, egal was die anderen Prüfungen ergeben. Die automatische Prüfung erreicht daher höchstens 7 von 9 Kriterien (78 %). Eine Anforderung ohne verifizierenden Test oder verifizierende Anforderung erreicht 6 von 9 (67 %). Entscheiden Sie sie für jede Anforderung selbst:
- Klicken Sie nach dem Review der Anforderung auf das ✘, um das Kriterium als Ja zu markieren.
- Für eine erste Einschätzung verwenden Sie ✦ KI ▾ → Mit KI prüfen (N Anforderungen)… (die KI-Anforderungsprüfung).
Notiz: Von früheren Versionen gespeicherte Werte konnten Correct oder Feasible als erfüllt zählen, wenn eine andere Prüfung fehlschlug. Führen Sie die Prüfung erneut aus, um sie zu aktualisieren.
Mit EARS-Vorlagen schreiben
EARS (Easy Approach to Requirements Syntax) schreibt jede Anforderung als einen Satz: eine optionale Bedingung, dann "the [system] shall [response]". Das erste Wort der Bedingung legt das Muster fest.
| Muster | Vorlage | Beispiel |
|---|---|---|
| Ubiquitous | The [system] shall [response]. | The pump controller shall record every start command with its time. |
| Event-driven | When [trigger], the [system] shall [response]. | When the tank level falls below 20 %, the pump controller shall start the backup pump. |
| State-driven | While [state], the [system] shall [response]. | While the vehicle is charging, the battery manager shall keep each cell below 45 °C. |
| Unwanted behavior | If [unwanted condition], then the [system] shall [response]. | If the supply voltage drops below 10 V, then the flight computer shall switch to the reserve battery. |
| Optional feature | Where [feature is included], the [system] shall [response]. | Where a heated windshield is fitted, the climate controller shall clear frost within 5 minutes. |
| Complex | While [state], when [trigger], the [system] shall [response]. | While the drill is in standby, when the operator presses Start, the drill controller shall reach full speed within 3 s. |
- Öffnen Sie eine Anforderung im Inspektor oder in der Elementansicht.
- Klicken Sie neben Beschreibung auf EARS ▾.
Die erste Zeile zeigt das Muster der Aussage (✓ Event-driven) oder was zu beheben ist (No EARS pattern: 1 to fix).
- Wählen Sie ein Muster.
Seine Vorlage wird zur Beschreibung. Hat die Anforderung bereits eine, bestätigen Sie mit Ersetzen; die alte Aussage bleibt im Verlauf des Elements. Ein ⌘Z / Ctrl+Z macht es rückgängig.
- Ersetzen Sie die Wörter in eckigen Klammern.
Um jede Anforderung zu prüfen, setzen Sie Requirement.11 unter Modellprüfungen → Einstellungen auf Warnung oder Fehler. Standardmäßig ist die Regel ausgeschaltet.
In einem SysML-v2-Projekt befindet sich EARS ▾ im Inspektor unter der Dokumentation einer Anforderung und schreibt ihren Doc-Kommentar.
Anforderungen genehmigen
- Wenn eine Anforderung fertig ist, setzen Sie ihren Status auf In Review.
Tun Sie das im Inspektor (der Status in der Review-Leiste der Gruppe Workflow), in der Datenbank oder in einer Dokumentspalte.
- Der Prüfer öffnet Bedarfe & Anforderungen → Genehmigungen.
Die Seite listet jede Anforderung mit dem Status In Review auf.
- Klicken Sie auf eine Zeile.
Die Gruppe Workflow des Inspektors zeigt die Review-Leiste: den Status, wer ihn wann gesetzt hat ("von J. Rivera · 9. März 2026 um 9:58") und die Schaltflächen.
- Klicken Sie auf Genehmigen.
Oder klicken Sie auf Ablehnen… und geben Sie einen optionalen Grund ein.
Die Meldung lautet "Genehmigt" oder "Abgelehnt". Die Entscheidung wird mit Ihrem Namen und der Uhrzeit festgehalten, und die Anforderung verschwindet aus der Liste Genehmigungen.
Wenn die Anforderung in einer Baseline liegt und Verifikationselemente oder Dokumente auf sie verweisen, öffnet Genehmigen zuerst einen Dialog, der sie unter Erneute Prüfung erforderlich auflistet (Auswirkung). Klicken Sie auf eine Zeile, um sie anzusehen, und dann zur Bestätigung auf Genehmigen.
Um eine entschiedene Anforderung zurück ins Review zu schicken, klicken Sie auf Wieder öffnen. Die Meldung lautet "Zu In Review verschoben".
Hat das Projekt einen Workflow auf dem Status von Anforderungen (Schema → Workflow), zeigt die Review-Leiste statt Genehmigen, Ablehnen… und Wieder öffnen die Übergänge dieses Workflows. Ein Übergang, der eine Genehmigung erfordert, endet auf … und öffnet Genehmigung anfordern: siehe Genehmigung für eine Statusänderung anfordern. Bei einer Anforderung mit Baseline zeigen Genehmigung anfordern und der Dialog Genehmigen… des Änderungsantrags dieselbe Liste Erneute Prüfung erforderlich.
Ein Dokument für ein Review einfrieren
- Klicken Sie im Titelblock des Dokuments auf Version ▾.
- Wählen Sie Baseline speichern….
Oder wählen Sie Liefern ▾ → Version ▸ Baseline speichern….
- Behalten oder ändern Sie den Name. Der Standard ist "<Dokument> Baseline <n>".
- Füllen Sie unter Genehmigungen je Genehmiger eine Zeile aus: Name, Rolle und Erklärung (Standard "Zur Freigabe genehmigt.").
+ Genehmiger hinzufügen fügt eine Zeile hinzu; × entfernt eine.
- Klicken Sie auf Erstellen.
Die Meldung lautet "Baseline gespeichert". Version ▾ zeigt "Aktuell · letzte Baseline <Name>".
Von nun an erhält jede Zeile einen Änderungsbalken, wenn sie von der neuesten Baseline abweicht.
Eine Änderung nach der Baseline behandeln
- Bearbeiten Sie den Anforderungstext im Dokument.
Eine Meldung fasst zusammen, was passiert ist, zum Beispiel "1 genehmigte Anforderung zu In Review verschoben; 6 Verknüpfungen zur Prüfung markiert." Als Teil Ihrer Bearbeitung (ein einziges Rückgängigmachen nimmt alles zurück):
- Eine genehmigte Anforderung wechselt zu In Review.
- Ihre Qualitätsergebnisse werden veraltet ("Qualität: veraltet — erneut ausführen").
- Ihre nachgelagerten Verknüpfungen werden zur Prüfung markiert.
- Öffnen Sie Bedarfe & Anforderungen → Zu prüfende Verknüpfungen.
- Klicken Sie für jede Zeile auf Vergleich, um die Textänderung zu sehen, und prüfen Sie das verknüpfte Element.
- Wenn ein verknüpftes Element weiterhin gilt, klicken Sie in seiner Zeile auf Als geprüft markieren….
Um mehrere auf einmal zu markieren, wählen Sie ihre Zeilen aus und klicken Sie auf Auswahl als geprüft markieren….
- Schreiben Sie, was Sie geprüft haben, und klicken Sie auf Als geprüft markieren.
- Führen Sie die Qualitätsprüfung erneut aus.
- Schicken Sie die Anforderung erneut durch die Genehmigung.
- Klicken Sie auf Version ▾ → Versionen vergleichen…, wählen Sie unter Von die Baseline und unter Bis die Aktuelle Version.
Der Bericht listet jede Änderung seit der Baseline auf.
- Klicken Sie für das Change Board auf Änderungen (Excel).
TBD- und TBR-Punkte schließen
- Öffnen Sie Bedarfe & Anforderungen → TBD/TBR.
- Lesen Sie die Kacheln: Offene TBD/TBR, Überfällig, Kein Eigentümer und die Anzahl pro Dokument.
- Bearbeiten Sie zuerst die überfälligen Zeilen. Sie sind eingefärbt, mit "Überfällig" unter dem Fälligkeitsdatum.
- Wo als Verantwortlicher "—" steht, weisen Sie einen TBD Owner zu.
- Wenn ein Wert feststeht, ändern Sie den Anforderungstext auf den endgültigen Wert.
- Klicken Sie in der Zeile auf Schließen.
Schließen setzt TBD/TBR auf None, und die Zeile verschwindet aus dem Register.
Um das Register an die Verantwortlichen zu senden, klicken Sie auf XLSX exportieren.
Eine vorhandene Spezifikation importieren
- Öffnen Sie Bedarfe & Anforderungen → Import und Export.
- Legen Sie die Datei auf der Ablagefläche ab oder klicken Sie darauf, um die Datei zu wählen: Word (.docx), Excel oder CSV, ReqIF oder reiner Text.
Die Statuszeile lautet zum Beispiel "„SRS.docx“ analysiert: 48 Zeilen, 5 Spalten." Format zeigt das erkannte Format.
- Klicken Sie auf Weiter.
- Prüfen Sie, worauf jede Spalte abgebildet wird, und setzen Sie Klasse für Zeilen ohne Klasse auf Requirement.
- Klicken Sie auf Weiter.
- Lassen Sie Ein Anforderungsdokument aus diesen N Anforderungen erstellen angekreuzt, prüfen Sie Dokumenttyp und Namen sowie die neuen und aktualisierten Elemente und die Warnungen.
- Klicken Sie auf N Elemente importieren.
Ohne Warnungen öffnet Holarch das neue Dokument. Mit Warnungen listet die Karte Import abgeschlossen sie auf.
Die Karte Import abgeschlossen hat Schaltflächen zum Öffnen des Dokuments, der Datenbank, eines Spinnen- oder Baumdiagramms oder der Qualitätsprüfung. Ein ⌘Z / Ctrl+Z entfernt den ganzen Import.
Durchgehendes Beispiel: die CubeSat-EO-1-Demo
Erstellen Sie das Demoprojekt CubeSat EO-1 — Earth Observation Demo unter Projekte verwalten. Es hat eine Spezifikation mit 32 Anforderungen, SRS-001 EO-1 System Requirements Specification, mit einer SRR-Baseline und danach vorgenommenen Änderungen.
Qualität.
- Öffnen Sie Bedarfe & Anforderungen → Qualität und klicken Sie auf Qualität prüfen.
Die Kacheln zeigen 32 Anforderungen, einen Durchschnitt von 92 %, 29 Gut und 3 Überarbeitung nötig.
Die drei schwachen Anforderungen sind absichtlich so geschrieben. Jede erreicht 44 %:
- 2.5 Safe Mode Recovery: "The spacecraft should recover from safe mode quickly and resume imaging as appropriate". Die Vorschläge umfassen:
- "R34 - Nicht messbare Leistungsbegriffe: [quickly]"
- "R8 - Ausweichklausel(n) schwächen die Anforderung: [as appropriate]"
- "R19 - Verbindet zwei Anforderungen; teilen Sie sie auf: [and]"
- "Beenden Sie die Aussage mit einem Punkt."
- "Verknüpfen Sie einen Test Case oder ein Requirement, das sie verifiziert."
- 3.5 Battery Thermal Control: "…keep the battery warm enough (TBD)." Die Vorschläge sind "R21 - Enthält Klammern; den Klammertext in die Begründung verschieben." und "Ersetzen Sie die Platzhalter TBD/TBR."
- 6.4 Operator Interface: "…shall be user friendly and/or easy to use." Die Vorschläge sind "R34 - Nicht messbare Leistungsbegriffe: [user friendly, easy to use]" und "R19 - „und/oder“ ist mehrdeutig; geben Sie an, ob beides oder eines gemeint ist: [and/or]".
So beheben Sie 2.5:
- Formulieren Sie sie um zu "The spacecraft shall resume imaging within 6 hours of a safe mode entry."
- Verknüpfen Sie einen Test Case mit verified by.
- Führen Sie die Prüfung erneut aus.
Die Meldungen zu Verbindungswort, Ausweichklausel und vagem Begriff verschwinden.
TBD/TBR. Öffnen Sie TBD/TBR. Es zeigt drei offene Punkte:
- 3.5 Battery Thermal Control: ein TBD, für das der Thermal Engineer verantwortlich ist. Es ist überfällig.
- 2.4 Target Slew (ADCS Lead) und 5.3 Downlink Link Margin (Comms Lead): später fällige TBRs.
Änderung nach der Baseline. Version ▾ des Dokuments listet SRR Baseline auf. Sie wurde von J. Rivera (Systems Lead), R. Okafor (Mission Principal Investigator) und L. Brandt (Program Manager) genehmigt.
Nach dem SRR änderte sich die Anforderung 3.1 Orbit Average Power von 28 W auf 30 W. Da 3.1 genehmigt war, wechselte sie zurück zu In Review, mit der Notiz "Text nach der Genehmigung geändert".
Zu prüfende Verknüpfungen listet sechs Verknüpfungen von 3.1 auf:
- 1.3.1 Solar Arrays
- F3 Generate and Store Power und F3.1 Convert Sunlight to Power
- EQ-1.1 Solar Power Generation und EQ-1.4 Power Margin Check
- TC-06 Solar Array Power Test
Klicken Sie in einer beliebigen Zeile auf Vergleich: "28 W" ist durchgestrichen und "30 W" eingefügt. Prüfen Sie dann die Elemente:
- TC-06 erwartet eine Spitzenleistung ≥ 72 W und hat 75,1 W gemessen. Über EQ-1.3 Orbit-Average Array Power (Spitze × 0,62 Sonnenanteil × 0,6 Wirkungsgrad des Leistungspfads) ergeben 75,1 W einen Orbitmittelwert von 27,9 W, unter den neuen 30 W. Lassen Sie diese Verknüpfung ungeprüft und fügen Sie den Kommentar "75,1 W Spitze = 27,9 W Orbitmittel; erneut testen gegen etwa 80,6 W Spitze" hinzu. Der Test braucht ein neues erwartetes Ergebnis und einen neuen Lauf.
- Prüfen Sie, ob die Auslegung des Solargenerators noch aufgeht, bevor Sie 1.3.1 als geprüft markieren.
Mit aktueller Version vergleichen. Wählen Sie SRR Baseline in Version ▾ und klicken Sie dann in ihrem Banner auf Mit aktueller Version vergleichen. Der Bericht listet auf:
- Die Änderungen an Description, Rationale, Status und Quality Score von 3.1.
- Die Statusänderung von 2.4 Target Slew (Draft → In Review).
- Die neue Anforderung 4.4 Downlink Encryption mit ihren zwei neuen satisfies-Verknüpfungen.
Genehmigungen. Öffnen Sie Genehmigungen. Neun Anforderungen sind In Review, darunter 3.1, 1.5 Daily Collection Volume und 5.3 Downlink Link Margin.
Tipps und bewährte Vorgehensweisen
- Schreiben Sie ein "shall" pro Anforderung, im Aktiv, mit einer Zahl, einer Einheit und einer Bedingung. Genau das belohnt die Qualitätsprüfung.
- Schreiben Sie den Grund in Begründung, nicht in die Aussage. Zweckformulierungen ("so that", "in order to") und Klammern werden als R20 und R21 markiert.
- Füllen Sie Verification Method schon beim Schreiben aus. Eine Anforderung mit Methode, aber ohne Test Case erscheint dann in der RVTM als Nur geplant statt als Nicht verifiziert.
- Setzen Sie TBD/TBR mit einem Verantwortlichen und einem Fälligkeitsdatum, statt nur "TBD" in den Text zu schreiben. Das Attribut gibt dem Register einen Verantwortlichen und ein Fälligkeitsdatum zum Verfolgen.
- Erstellen Sie vor jedem Review eine Baseline. Die Änderungsbalken und Mit aktueller Version vergleichen funktionieren nur gegen eine Baseline.
- Markieren Sie Verknüpfungen mit einem Kommentar als geprüft. Der Kommentar wird zum verknüpften Element hinzugefügt und an der Verknüpfung festgehalten, sodass das Review einen Prüfpfad hinterlässt.
Häufige Fehler
| Symptom | Ursache | Behebung |
|---|---|---|
| Eine Anforderung wird nicht bewertet, steht nicht im Register oder nicht in der RVTM. | Sie ist ein Statement, kein Requirement. | Ändern Sie ihre Klasse im Inspektor auf Requirement. |
| Correct und Feasible zeigen bei jeder Anforderung ✘. | Sie erfordern das Urteil einer Person ("Erfordert das Urteil eines Prüfers"). | Prüfen Sie jede und klicken Sie auf das ✘, um sie als Ja zu markieren, oder führen Sie die KI-Anforderungsprüfung aus. |
| Der Wert zeigt "Veraltet — erneut ausführen". | Der Text hat sich nach der letzten Prüfung geändert. | Klicken Sie auf Qualität prüfen oder schalten Sie Automatisch erneut prüfen, wenn sich der Text ändert ein. |
| Manuelle Ja/Nein-Übersteuerungen sind verschwunden. | Das Bearbeiten des Textes löscht sie. | Setzen Sie sie nach dem Review erneut; Rückgängig stellt sie wieder her, und sie bleiben im Verlauf. |
| Eine Anforderung ist nach einer Tippfehlerkorrektur nicht mehr genehmigt. | Jede Bearbeitung von Name oder Beschreibung öffnet eine genehmigte Anforderung wieder. | Genehmigen Sie sie erneut. Korrigieren Sie Tippfehler vor der Genehmigung. |
| "Schließen" fehlt in einer TBD/TBR-Zeile. | Der offene Punkt stammt nur aus dem Text. | Bearbeiten Sie den Text, um TBD, TBR oder TBS zu entfernen. |
| Ein Import hat Kopien erstellt, statt zu aktualisieren. | Vorhandene Entitäten abgleichen nach hat keine Übereinstimmung gefunden. | Exportieren Sie mit der Spalte ID, bearbeiten Sie und importieren Sie mit Vorhandene Entitäten abgleichen nach: Global ID (siehe Anforderungen aus einer Tabelle aktualisieren). |
Zusammenhang mit anderen Funktionen
- Gespeist aus: Stakeholder-Eingaben und vorhandenen Spezifikationen über Importieren sowie in Dokumente geschriebenen Dokumenten.
- Speist:
- Funktionsanalyse: aus Anforderungen extrahierte Funktionen.
- Die Nachverfolgbarkeitsmatrix: satisfied by, verified by.
- Die RVTM und das Test Center: Verifikationsstatus.
- Modellprüfungen: Regeln Requirement.1 bis Requirement.10.
- Start: Zahlen zu Genehmigung und Verifikation.
- Dokumentexporte: Qualitätsbefunde (Excel), RVTM, VCRM, Änderungen.
- Reviews.
- KI: Das Menü ✦ KI ▾ im Dokument und in der Elementansicht enthält Rewrite Clearly…, Add Measurable Criteria…, Simplify…, Split Compound Requirement…, Draft Rationale…, Suggest Name… und Check with AI (die KI-Anforderungsprüfung). KI-Änderungen werden vor dem Anwenden in einer Vorschau gezeigt. Siehe KI fragen und KI-Werkzeuge.
Die Seite Anforderungen
Auf der Seite Anforderungen sehen und bearbeiten Sie alle Anforderungen in einer Tabelle. Bedarfe & Anforderungen → Anforderungen ist die Datenbank, gefiltert auf class:Requirement.
Jede Datenbankfunktion steht hier zur Verfügung:
- Spalten sortieren und filtern sowie Zellen direkt bearbeiten.
- Zeilen für die Sammelleiste auswählen, um Attribute oder Labels für viele Anforderungen auf einmal zu setzen.
- Exportieren und die Nachverfolgbarkeitsmatrix für die ausgewählten Zeilen öffnen.
Klicken Sie auf eine Zeile, um die Anforderung im Inspektor anzuzeigen. Doppelklicken Sie, um ihre Elementansicht zu öffnen. Eine Anforderung mit einer zu prüfenden Verknüpfung zeigt in ihrer Zeile ein Abzeichen ⚠ Prüfen. Klicken Sie mit der rechten Maustaste auf eine Zeile für ihr Menü: bis zu drei vorgeschlagene Aktionen mit ihren Gründen (zum Beispiel ✦ Add Measurable Criteria…, wenn die Anforderung Unambiguous nicht erfüllt, ✦ Testfall generieren…, wenn sie nicht verifiziert ist), ✦ Weitere KI ▸, dann Öffnen, Umbenennen…, Duplizieren, Unterelement hinzufügen…, Status ▸, Priorität ▸, In Beziehung setzen zu ▸, Zum Dokument hinzufügen ▸, Im Diagramm anzeigen ▸, Link kopieren, Nummer kopieren und Löschen… (siehe Kontextmenü).
Siehe Das Modell und die Datenbank für Tabelle, Abfragen und Sammelbearbeitung.
Nützliche Abfragen:
| Abfrage | Zeigt |
|---|---|
class:Requirement | Alle Anforderungen. |
Requirement:"Status=In Review" | Die Liste Genehmigungen. |
Requirement:"Status=Draft" | Anforderungen, die noch nicht zum Review geschickt wurden. |
class:Requirement AND is:leaf | Blattanforderungen (ohne untergeordnete Anforderungen). |
class:Requirement AND NOT relationship:"verified by" | Anforderungen ohne verifizierendes Element. |
Anforderungsqualität
Mit der Seite Qualität (Titel "Anforderungsqualität") finden Sie schlecht formulierte Anforderungen. Sie bewertet jede Anforderung nach neun Kriterien.
Die neun Kriterien und die Regelnummern in den Vorschlägen (R2, R19 usw.) folgen den Merkmalen und Regeln des INCOSE Guide to Writing Requirements. Die Wortlisten und Muster von Holarch nähern diese Regeln an; sie sind nicht der Text des Leitfadens, und manche Regeln erfordern das Urteil eines Prüfers.
- Wert = 100 × (erfüllte Kriterien) / 9, gerundet. Ein nicht geprüftes Kriterium (–, siehe Anforderungen in anderen Sprachen) wird ausgelassen: 100 × erfüllt / 8.
- 67 % oder mehr ist Gut. Unter 67 % ist Überarbeitung nötig.
- Der Balken ist unter 34 % rot, von 34 % bis 66 % gelb und ab 67 % grün.
Seitenaufbau
- Seitenkopf:
- Mehr ▾: Manuelle Bewertungen löschen setzt jedes manuelle Ja/Nein der angezeigten Anforderungen zurück und führt die Prüfung erneut aus. In Anforderungen öffnen öffnet die angezeigten Anforderungen in der Tabelle Anforderungen. Dokument öffnen erscheint, wenn der Umfang ein Dokument ist.
- Exportieren ▾: Excel (.xlsx) und CSV der angezeigten Anforderungen.
- Qualität prüfen: prüft jede Anforderung im Umfang, unabhängig davon, was die Filter zeigen (die Duplikatregel vergleicht jede Anforderung mit den anderen im Umfang).
- ✦ KI ▾ (in der oberen Leiste): Mit KI prüfen (N Anforderungen)…, die KI-Anforderungsprüfung der angezeigten Anforderungen.
- Bereichsleiste: Umfang (Alle Anforderungen oder Dokument: <Name>) und das Kontrollkästchen Automatisch erneut prüfen, wenn sich der Text ändert. Zu prüfende Verknüpfungen, TBD/TBR und Genehmigungen liegen in der Navigationsleiste neben Qualität.
- Abfrageleiste: + Filter, die Filterchips und der Suchtext, Leeren, ? (Suchsyntax) und Ansichten ▾: dieselbe Leiste wie auf der Seite Anforderungen (siehe Die Seite Qualität filtern).
- Kacheln: Anforderungen ("12 von 40" unter Angezeigte Anforderungen, wenn Filter einige ausblenden), Durchschnittswert, Gut (≥ 67 %), Überarbeitung nötig (< 67 %) und Veraltet (Text geändert), wenn welche veraltet sind. Veraltete Werte werden beim Durchschnitt ausgelassen.
- Notiz unter den Kacheln: "Automatische Prüfungen erreichen höchstens 7 von 9 Attributen (78 %); Correct und Feasible erfordern eine menschliche Verifikation — klicken Sie auf ein ✘, um es als Ja zu markieren. Jeder Klick wechselt zwischen manuell Ja, manuell Nein und zurück zu automatisch."
- Tabelle: Number, Name (mit der Beschreibung darunter), Qualitätswert, eine Spalte je Kriterium und Vorschläge. Vorschläge listet jede Meldung auf, mit ihrem Kriterium als Präfix. Die Zeilen sind nach Nummer sortiert. Klicken Sie mit der rechten Maustaste auf eine Zeile oder drücken Sie darauf Shift+F10, um das Zeilenmenü der Datenbank zu öffnen: vorgeschlagene Aktionen mit ihren Gründen (die Umformulierung, die ein nicht erfülltes Kriterium behebt, steht zuerst), ✦ Weitere KI ▸, Öffnen, Umbenennen…, Duplizieren, Unterelement hinzufügen…, Status ▸, Priorität ▸, In Beziehung setzen zu ▸, Zum Dokument hinzufügen ▸, Im Diagramm anzeigen ▸, Link kopieren, Nummer kopieren und Löschen…. Die Zeile wird zur Auswahl.
- Mehrere Zeilen: ⌘ / Ctrl-Klick (Ctrl-Klick unter Windows und Linux) schaltet eine Zeile um, ⇧ / Shift-Klick wählt den Bereich ab der zuletzt angeklickten Zeile, ⌘ / Ctrl+⇧ / Shift-Klick fügt diesen Bereich hinzu, und ⌘A / Ctrl+A oder ⇧ / Shift+↑ / ⇧ / Shift+↓ auf einer fokussierten Zeile wählen alle Zeilen aus oder erweitern die Auswahl. Die Symbolleiste zeigt die Anzahl; Esc hebt die Auswahl auf. Klicken Sie mit der rechten Maustaste auf eine ausgewählte Zeile, um auf alle zu wirken: ✦ Check with AI (n requirements)…, ✦ Rewrite (n) ▸, ✦ Generate Test Cases (n)…, ✦ Ask AI About These (n)…, ✦ Suggest Traces (n)… (jeweils mit einer Vorschau; siehe KI für mehrere ausgewählte Elemente), Duplicate n Entities, Set Status ▸, Set Priority ▸, Zum Dokument hinzufügen ▸ und Delete n Items…; ein einziges Rückgängigmachen nimmt jede davon zurück. Das TBD/TBR-Register und Zu prüfende Verknüpfungen funktionieren genauso; in Zu prüfende Verknüpfungen kreuzt die Auswahl außerdem die Zeilen für Auswahl als geprüft markieren… an.
Sonderfälle:
- Eine Zeile ohne Ergebnis zeigt in der Wertspalte "Nicht ausgeführt".
- Eine veraltete Zeile zeigt "Veraltet — erneut ausführen".
- Wenn der Umfang keine Anforderungen enthält, zeigt die Seite "Keine Anforderungen" und "Nur Entitäten der Klasse Requirement werden bewertet; Statements werden übersprungen."
- Wenn Filter oder Suchtext alle Anforderungen ausblenden, zeigt die Seite "Keine passenden Anforderungen" und "Keine Anforderung entspricht der Suche oder den Filtern. Sie aufheben, um alle Anforderungen zu sehen."
Die Seite Qualität filtern
Die Abfrageleiste funktioniert wie auf der Seite Anforderungen (siehe Wie eingegebene Filter zu Chips werden): Eingegebene Filterbegriffe werden zu Chips, wenn Sie Enter drücken, der übrige Text wird mit Name, Nummer und Beschreibung abgeglichen, Backspace in einer leeren Suche entfernt den letzten Chip, und Leeren entfernt alle. Die Kacheln, die Tabelle, Exportieren ▾ und ✦ KI ▾ → Mit KI prüfen folgen den Filtern.
+ Filter listet auf, mit Anzahlen für den Umfang:
| Gruppe | Filter | Begriff |
|---|---|---|
| Qualität | Gut (≥ 67 %), Überarbeitung nötig (< 67 %), Nicht ausgeführt, Veraltet (Text geändert), Manuelle Bewertungen, KI-Befund | quality:good, quality:rework, quality:notrun, quality:stale, quality:manual, quality:ai |
| Erfüllt ein Kriterium nicht | Eins je Kriterium: als Nein bewertet | quality:Verifiable=no (=yes: als Ja bewertet) |
| Regelbefund | Die im Umfang gefundenen Regeln, etwa R7 Imprecise wording oder R30 Closely resembles (mögliche Duplikate) | quality:R7 |
| Struktur, Klasse, Anforderungsattribute, Label, Beziehung, Diagramm | Wie auf der Seite Anforderungen; die Anforderungsattribute werden ohne Klassenchip aufgeführt | is:tbd, Requirement:"Status=Draft", label:"…" |
Filter einer Gruppe werden mit oder verknüpft; verschiedene Gruppen mit und. Wertebereiche verwenden das Attribut: Requirement:"Quality Score>=50". Die Begriffe quality: funktionieren auch auf der Seite Anforderungen und in der Datenbank.
Ansichten ▾ wendet eine integrierte Ansicht an (Überarbeitung nötig, Noch nicht geprüft, Veraltete Ergebnisse, Mehrdeutig, Nicht verifizierbar, Mögliche Duplikate, Manuelle Bewertungen) oder eine Ihrer gespeicherten Ansichten. Ansicht speichern… speichert die aktuellen Filter und den Suchtext in diesem Browser, für jedes Projekt; Delete "<name>" erscheint, während eine gespeicherte Ansicht verwendet wird. Alle Anforderungen leert die Filter. Die Adresse quality?q=<query> öffnet die Seite gefiltert.
Das Filtern liest die gespeicherten Ergebnisse und prüft nicht erneut. Bei 50.000 Anforderungen dauert eine Änderung von Filter oder Suche deutlich unter einer Zehntelsekunde.
Kriterien und Prüfungen
Jedes Kriterium zeigt eine von drei Markierungen:
- ✔ (Ja): keine Meldungen.
- ✘ (Nein): mindestens eine Meldung.
- –: nicht geprüft.
Die Prüfungen gleichen ganze Wörter und Wendungen ab, ohne Beachtung der Groß-/Kleinschreibung. Nur die aufgeführten Formen zählen: "effective" und "effectively" sind beide aufgeführt, "effectiveness" nicht. Wörter in Anführungszeichen zählen ebenfalls. Die folgenden Meldungen sind der genau angezeigte Text. Die Liste in eckigen Klammern am Ende einer Meldung nennt die gefundenen Wörter.
Eindeutig
| Regel | Nachricht | Auslöser |
|---|---|---|
| R6 | R6 - Nicht erkannte Einheit(en); verwenden Sie SI-, US-übliche oder imperiale Einheiten: [...] | Eine Zahl gefolgt von einem Wort, das keine bekannte Einheit ist (zum Beispiel "12 sorties"). Bekannte Einheiten umfassen SI-, US-übliche und imperiale Einheiten und ihre Abkürzungen, %, Grad, °C und °F. |
| R2 | R2 - Aktiv formulieren: [...] | "shall/must/will/should be" gefolgt von einem Partizip Perfekt ("shall be measured"). |
| R5 | R5 - Bestimmte Artikel („the“) statt: [...] | "a" oder "an". |
| R7 | R7 - Ungenaue Formulierung: [...] | some, many, several, few, little, much, various, appropriate(ly), adequate(ly), efficient(ly), effective(ly), sufficient(ly), reasonable, reasonably, suitable, suitably, significant(ly), minimal(ly), maximal(ly), approximately, almost, nearly, generally, usually, typically, normally, robust(ly), flexible, flexibly, easy, easily, etc, similar, relevant, substantial(ly), large, small, good, bad, better, best, worst, proper, properly, acceptable, acceptably, accurate(ly), extreme, high-contrast, high contrast. |
| R8 | R8 - Ausweichklausel(n) schwächen die Anforderung: [...] | if necessary, where possible, as appropriate, as practicable, as far as possible, if practical, as required, as needed, to the extent possible, if possible. |
| R10 | R10 - Unnötige Infinitivwendung(en): [...] | to be designed to, to be able to, to be capable of, to enable, to allow, be able to, be capable of. |
| R16 | R16 - Verneinung vermeiden: [...] | not, n't, never. |
| R17 | R17 - Schrägstrich („/“) vermeiden. | Ein Schrägstrich zwischen zwei Wörtern, außer km/h, m/s, and/or und seinen Entsprechungen im Deutschen, Französischen, Spanischen, Italienischen und Niederländischen. |
| R24 | R24 - Pronomen statt eindeutiger Substantive: [...] | it, its, they, them, their, he, she, him, her, someone, something, anyone, anything, anybody, somebody, this, these, those. |
| R32 | R32 - „each“ statt universeller Mengenangabe(n): [...] | all, any, both, every, everything, everyone. |
| R34 | R34 - Nicht messbare Leistungsbegriffe: [...] | fast, quick, quickly, user friendly, user-friendly, high speed(s), high-speed, best practice(s), state of the art, state-of-the-art, seamless(ly), intuitive(ly), easy to use, timely, rapid, rapidly, real-time, real time. "Real-time clock" zählt nicht: Es benennt eine Komponente. |
| R35 | R35 - Unklare Zeitangabe(n): [...] | as, eventually, before, after, until, meanwhile, simultaneous(ly), soon, later, sometimes, occasionally, often, subsequently, previously. |
| — | Ersetzen Sie die Platzhalter TBD/TBR. | TBD, TBR oder TBS in der Beschreibung (in Großbuchstaben). |
| — | KI: mehrdeutig — <Grund> | Ein angenommener KI-Befund aus der KI-Anforderungsprüfung. |
| — | Nennt ein Maximum („up to“); ist ein Minimum gemeint, „at least“ verwenden. | "up to" gefolgt von einer Zahl, in Ziffern oder Wörtern ("up to 72 hours", "up to five tonnes"). "Up to date" zählt nicht. |
Vollständig
| Regel | Nachricht | Auslöser |
|---|---|---|
| — | Beschreibung fehlt. | Eine leere Beschreibung. |
| — | Name fehlt. | Ein leerer Name. |
| R9 | R9 - Offene Aufzählung: [...] | including but not limited to, etc, and so on, and so forth, such as, among others. |
Singulär
| Regel | Nachricht | Auslöser |
|---|---|---|
| R18 | R18 - Schreiben Sie einen einzigen Satz (gefunden: N). | Mehr als ein Satz (auch japanische und chinesische Sätze, die auf 。, ! oder ? enden). |
| — | Beenden Sie die Aussage mit einem Punkt. | Eine Beschreibung, die nicht auf "." (oder 。) endet. |
| R19 | R19 - Verbindet zwei Anforderungen; teilen Sie sie auf: [...] | and, or, but, however oder whereas, die zwei Handlungen oder zwei Verpflichtungen verbinden ("shall log and report each fault", "… and the operator shall …"), "nor shall", ein zweiter Satzteil nach ";"; "and/or" vor einer zweiten Handlung. Siehe Zwei Anforderungen in einer (R19). |
| R19 | R19 - „und/oder“ ist mehrdeutig; geben Sie an, ob beides oder eines gemeint ist: [and/or] | "and/or" zwischen Werten oder in einer Bedingung. |
| R19 | R19 - Verbindet zwei Werte; teilen Sie sie auf, wenn jeder einzeln verifiziert wird: [...] | and, or, die zwei Objekte oder Werte nach einer Handlung verbinden ("measure the temperature and the humidity"). Eine Notiz: Singular bleibt Ja. |
| R20 | R20 - Enthält Zweckangabe(n); in die Begründung verschieben: [...] | purpose of, in order to, so that, for the purpose of, so as to. |
| R21 | R21 - Enthält Klammern; den Klammertext in die Begründung verschieben. | "(" oder "[" (auch Klammern voller Breite). |
Konform
| Nachricht | Auslöser |
|---|---|
| Verwenden Sie ein Modalverb: [need, shall, will, should, must] | Keines dieser Wörter kommt vor. |
Angemessen
| Regel | Nachricht | Auslöser |
|---|---|---|
| R31 | R31 - Gibt eine Lösung vor: [...] | using, by means of, utilizing, utilising, implemented in, implemented with, via a, via the, built with, written in. |
Notwendig
| Regel | Nachricht | Auslöser |
|---|---|---|
| R30 | R30 - Ähnelt stark: [3.2 Battery Capacity (81,3 % ähnlich), ...] | Eine andere Anforderung im Umfang, deren Beschreibung zu mindestens 75 % ähnlich ist (Ähnlichkeit von Zeichenpaaren). Der Befund nennt bis zu fünf und zählt den Rest ("und 3 weitere"). Das direkte übergeordnete Element und die Unterelemente der Anforderung (decomposed by, decomposes) werden nicht verglichen: Eine Verfeinerung wiederholt oft die Formulierung ihres übergeordneten Elements. Geschwister und nicht verwandte Anforderungen werden verglichen. |
Verifizierbar
| Nachricht | Auslöser |
|---|---|
| Verknüpfen Sie einen Test Case oder ein Requirement, das sie verifiziert. | Die Anforderung hat keine verified by-Verknüpfung zu einem Requirement oder Test Case. |
| KI: so wie formuliert nicht verifizierbar — <Grund> | Ein angenommener KI-Befund aus der KI-Anforderungsprüfung. |
Machbar
| Regel | Nachricht | Auslöser |
|---|---|---|
| R26 | R26 - Absolute Begriffe, die selten erreichbar sind: [...] | always, never, 100%, 100 percent, all the time, totally, completely, absolutely, zero defects, forever, continuous, continuously, uninterrupted. |
| — | Erfordert das Urteil eines Prüfers | Es wurden keine absoluten Begriffe und keine Beinahe-Duplikate gefunden; eine Person muss entscheiden. |
Korrekt
| Nachricht | Auslöser |
|---|---|
| Erfordert das Urteil eines Prüfers | Jede Textprüfung (Appropriate, Complete, Conforming, Necessary, Singular, Unambiguous) wurde bestanden; eine Person muss entscheiden. |
Da Correct und Feasible mit "Erfordert das Urteil eines Prüfers" enden, bis jemand entscheidet, ist der höchste automatische Wert 7 von 9 (78 %).
Zwei Anforderungen in einer (R19)
Eine Anforderung sagt eine Sache aus. R19 betrachtet jedes "and", "or", "nor", "but", "however", "whereas", "as well as" und "and/or" und ordnet es einer dieser Arten zu:
| Art | Beispiel | Ergebnis |
|---|---|---|
| Zwei Anforderungen | "The unit shall log and report each fault." "The pump shall stop, and the operator shall be alerted." "… to acknowledge alarms and to silence the horn." "…; it shall also …" | Ein Befund. Singular ist Nein. |
| Mehrdeutiges "and/or" | "The log shall record the user ID and/or the badge number." | Ein Befund: Geben Sie an, ob beides oder eines gemeint ist. Singular ist Nein. |
| Zwei Werte | "The station shall measure the temperature and the humidity." | Eine Notiz: Teilen Sie sie auf, wenn jeder Wert einzeln verifiziert wird. Singular bleibt Ja; die Notiz wird grau angezeigt und senkt den Wert nicht. |
| Kein Befund | "between 5 °C and 30 °C"; "When A and B, the unit shall …"; "… when the door is open and the fan is off"; "requirements 2.1 and 2.2"; zitierter Text; "The command and control unit shall …"; "ASME Boiler and Pressure Vessel Code"; "5 Nm at 3000 rpm and 24 V"; "including batteries and strap"; "either open or closed" | Nichts. |
Zwei Werte einer Größe ("at -20 °C and 60 °C") erhalten die Notiz. Ein ", and" beendet eine Bedingung: "… when the level falls below 10 %, and restart when …" ist ein Befund. Ein Subjekt, das als Einheit handelt ("The Owner and the Contractor shall agree …", "The power and data connector shall …"), erhält keine Notiz; zwei Subjekte, die jeweils handeln ("The pump and the valve shall close …"), erhalten die Notiz. Vergleiche ("12 or more") werden nicht markiert. Ein Name nach der Handlung lässt sich nicht von zwei Werten unterscheiden; tragen Sie ihn daher unter Zusammengesetzte Namen ein.
Zusammengesetzte Namen. Auf der Seite Qualität öffnet Mehr ▾ → Zusammengesetzte Namen… die Liste des Projekts mit Namen, die "and" oder "or" enthalten, aber eine Sache benennen, einer pro Zeile (zum Beispiel "power and data connector"). R19 markiert sie nicht. Ausschreibungen im Akronymglossar des Projekts (Acronym-Statements, siehe Akronyme finden) zählen ebenfalls, und einige gängige Namen sind integriert ("command and control", "research and development", "operations and maintenance", …). Die Liste wird mit dem Projekt gespeichert und ist rückgängig machbar. Klicken Sie erneut auf Qualität prüfen, um eine Änderung anzuwenden.
Anforderungen in anderen Sprachen
Holarch erkennt die Sprache jeder Anforderung aus ihrem Text. Die Wortregeln (R2–R10, R16, R19, R20, R24, R26, R31–R35, "up to", das Modalverb, Einheiten) bewerten englische Anforderungen.
Deutsch, Französisch und Spanisch (Beta). Diese Anforderungen erhalten dieselben Regeln in ihrer eigenen Sprache, zum Beispiel "angemessen" oder "bei Bedarf" im Deutschen, "approprié" oder "si possible" im Französischen, "adecuado" oder "según corresponda" im Spanischen. Solange die Regeln für eine Sprache in der Beta sind:
- ist jeder Befund ein mit (Beta) markierter Vorschlag. Er wird mit den anderen Notizen grau angezeigt und senkt nie ein Kriterium oder den Wert;
- wird die Notiz "Die Formulierungsregeln für diese Sprache sind in der Beta: nur Vorschläge, nicht bewertet. Strukturprüfungen werden angewendet." angezeigt, und Unambiguous ist – (nicht geprüft), bis die Formulierung mit KI geprüft oder von Hand bewertet wird;
- sind die Wörter für „each“ (jede, chaque, cada) die richtige Wahl und werden nicht markiert, ebenso wenig "alle 5 s" oder "tous les 5 s" (every 5 s).
Eine Regel zählt für eine Sprache erst, nachdem sie an mindestens 300 in dieser Sprache geschriebenen Aussagen gemessen und von einem Requirements Engineer mit dieser Muttersprache geprüft wurde (mindestens 90 % ihrer Befunde korrekt) und der Prüfer sie freigegeben hat. Wenn das geschieht, können sich die Werte für diese Sprache bei der nächsten Prüfung ändern; die Versionshinweise weisen darauf hin.
Andere Sprachen (Japanisch, Italienisch, Chinesisch und die übrigen) erhalten:
- die Notiz "Die Formulierungsregeln gelten für Englisch. Strukturprüfungen werden angewendet." und – (nicht geprüft) für Unambiguous: aus dem Wert ausgelassen, bis die Formulierung geprüft oder von Hand bewertet wird. Ein anderer Unambiguous-Befund, etwa ein TBD, lässt es weiterhin durchfallen;
- die Prüfungen für jede Sprache: R18 (auch 。), der Schlusspunkt (auch 。), R17, R21, TBD/TBR, R30, Name, Beschreibung und Verifikationsverknüpfung.
Jede Sprache, ob Beta oder nicht, erhält auch diese Prüfungen. Vorschläge werden auf Englisch gespeichert, mit den Wörtern so zitiert, wie sie geschrieben sind ("R7 - Imprecise wording: [angemessen] (beta)"), sodass der Filter quality:R7 und Exporte in jeder Sprache gleich funktionieren. Die öffentliche API gibt sie mit Regel, Wörtern und Modus zurück (findings).
Formulierung mit KI prüfen. ✦ KI ▾ → Formulierung mit KI prüfen… auf der Seite Qualität (oder ✦ Weitere KI ▸ bei einer Anforderung) wendet dieselben Regeln über die konfigurierte KI in der Sprache jeder Anforderung an. Die Vorschau listet die Befunde und eine optionale Umformulierung in dieser Sprache (nicht angekreuzt). Auswahl anwenden fügt die Befunde als KI-Befunde hinzu und entfernt die Notiz (die Beta-Vorschläge bleiben als Notizen), als ein Rückgängig-Schritt. Das Bearbeiten des Textes löscht sie. Dafür ist ein Tarif mit KI nötig.
Manuelle Übersteuerungen
Übersteuern Sie ein Kriterium, wenn Sie mit dem automatischen Ergebnis nicht einverstanden sind, oder um die Entscheidung eines Prüfers festzuhalten.
- Auf der Seite Qualität: Klicken Sie auf eine Kriteriumszelle, um sie durchzuschalten: Der erste Klick setzt ein manuelles Ja (✔), der nächste ein manuelles Nein (✘), und der dritte löscht den manuellen Wert, sodass wieder die automatische Prüfung entscheidet. Eine manuelle Zelle zeigt eine Markierung; ihr Tooltip sagt "(manuell gesetzt)" und was der nächste Klick bewirkt.
- Im Inspektor oder in der Elementansicht: Jedes Kriterium ist eine Liste mit Ja und Nein. Ein von Hand gesetztes Kriterium bietet außerdem Automatisch (erneut prüfen), das es auf das automatische Ergebnis zurücksetzt. Von Hand gesetzte Werte zeigen "manuell".
Ein manueller Wert bleibt erhalten, wenn die Prüfung erneut läuft. Ein manuelles Nein ohne andere Meldung zeigt "Manuell als Nein markiert."
Übersteuerungen werden in zwei Fällen gelöscht:
- Name oder Beschreibung der Anforderung ändert sich. Die Übersteuerungen bleiben im Verlauf, und Rückgängig holt sie zurück.
- Sie wählen Mehr ▾ → Manuelle Bewertungen löschen. Das löscht auch angenommene KI-Befunde.
Veraltete Ergebnisse
Wenn sich Name oder Beschreibung einer Anforderung nach einer Prüfung ändern, werden ihre Ergebnisse als veraltet markiert:
- Die Seite Qualität zeigt "Veraltet — erneut ausführen" mit dem Tooltip "Der Text hat sich nach der letzten Prüfung geändert. Führen Sie die Qualitätsprüfung erneut aus."
- Die Spalte Qualitätswert eines Dokuments zeigt ein Tag Veraltet mit einem Uhrsymbol (zeigen Sie darauf, um den Grund zu sehen).
- Der Inspektor zeigt "Qualität: veraltet — erneut ausführen".
Schalten Sie Automatisch erneut prüfen, wenn sich der Text ändert ein, um veraltete Ergebnisse zu vermeiden. Holarch führt die Regelprüfung dann sofort für die bearbeitete Anforderung erneut aus. Die Einstellung wird in diesem Browser gespeichert.
Qualität aus einem Dokument prüfen
Wählen Sie in einem Dokument Prüfen ▾ → Qualität prüfen. Ist eine Anforderung ausgewählt, lautet der Eintrag Qualität dieser Anforderung prüfen und prüft diese eine. Ist keine Anforderung ausgewählt, prüft er jede sichtbare Anforderung im Dokument.
Die Ergebnisse öffnen sich im Dialog Qualität prüfen — <Name>, mit den Kacheln und der Tabelle. Seine Schaltflächen sind CSV exportieren, XLSX exportieren, In Qualität öffnen und Schließen.
Ein Dokument ohne Anforderungen zeigt "Dieses Dokument enthält keine zu prüfenden Requirements. Statements werden nicht bewertet."
KI-Anforderungsprüfung
Verwenden Sie die KI-Anforderungsprüfung für eine erste Einschätzung der Kriterien, die eine Regel nicht entscheiden kann: Correct, Feasible und Necessary. Sie sucht außerdem nach Formulierungen, die die Regeln übersehen, unter Unambiguous (zum Beispiel "up to 72 hours", wo ein Minimum gemeint scheint, oder "accurately" ohne Maß) und Verifiable (kein Test, keine Analyse, Inspektion oder Demonstration könnte zeigen, dass die Anforderung so wie formuliert erfüllt ist). Die KI erhält die Regelbefunde und meldet nur, was diese übersehen.
- Wählen Sie ✦ KI ▾ → Mit KI prüfen (N Anforderungen)….
Für eine einzelne Anforderung wählen Sie Mit KI prüfen (diese Anforderung)… in ihrem Menü ✦ KI ▾ oder ✦ Weitere KI ▸ → ✦ Mit KI prüfen… in ihrem Kontextmenü.
Claude prüft die Anforderungen. Sie werden in Gruppen zu 20 gesendet, mit bis zu 300 weiteren Anforderungen für die Duplikatprüfung. Mit der enthaltenen KI zählt die Prüfung eine Anfrage pro 100 Anforderungen (aufgerundet); bevor eine Prüfung von mehr als 100 Anforderungen läuft, nennt ein Dialog, wie viele sie verbraucht, zum Beispiel "Dieses Review verbraucht 3 Ihrer 52 in diesem Monat verbleibenden enthaltenen KI-Anfragen (1 Anfrage pro 100 Anforderungen)." Eine Prüfung, die mehr Anfragen braucht als verbleiben, startet nicht.
- Prüfen Sie jede Anforderung im Dialog.
Die Zeile oben sagt, was zu Beginn angekreuzt ist: "Angekreuzte Einträge werden angewendet. Umformulierungen sind zu Beginn nicht angekreuzt, damit Sie sie zuerst lesen. Gesperrte, genehmigte Anforderungen und Anforderungen mit Baseline sind zu Beginn nicht angekreuzt."
- Kreuzen Sie die Änderungen und Umformulierungen an, die Sie annehmen.
Die Zeile über den Schaltflächen zählt, was Anwenden bewirkt, zum Beispiel "Wendet 7 Werte und 2 Umformulierungen auf 5 Anforderungen an." Ist nichts angekreuzt, lautet sie "Nichts ausgewählt.", und Auswahl anwenden ist abgeblendet.
- Klicken Sie auf Auswahl anwenden.
Die angekreuzten Einträge werden angewendet, und ein einziges Rückgängigmachen nimmt alles zurück. Die Meldung lautet "N KI-Änderungen angewendet".
Für jede Anforderung zeigt der Dialog:
- Ein Ja/Nein-Urteil und einen Grund für Correct, Feasible, Necessary, Unambiguous und Verifiable.
- Unter jedem Urteil ein Kontrollkästchen, beschriftet mit dem, was das Anwenden ändert, oder "keine Änderung" ohne Kontrollkästchen, wenn der gespeicherte Wert bereits übereinstimmt:
- Correct, Feasible und Necessary: "Nein → Ja" oder "Ja → Nein", wenn das Urteil vom gespeicherten Wert abweicht, "Auf Ja setzen" oder "Auf Nein setzen", wenn keiner vorhanden ist.
- Unambiguous und Verifiable: "Fügt einen Befund hinzu", wo die KI ein Problem gefunden hat, und "Entfernt den früheren Befund", wo ein früherer KI-Befund nicht mehr zutrifft.
- Ein optionaler Kommentar.
- Wo die KI eine vorschlägt, ein Kontrollkästchen Umformulierung anwenden: mit einem Wortvergleich.
Was zu Beginn angekreuzt ist:
- Jede Wertänderung ist zu Beginn angekreuzt.
- Umformulierungen sind zu Beginn nicht angekreuzt, damit Sie sie zuerst lesen.
- Genehmigte, gesperrte Anforderungen und Anforderungen mit Baseline sind zu Beginn nicht angekreuzt und werden gekennzeichnet.
Das Ankreuzen einer Umformulierung blendet die Kästchen Unambiguous und Verifiable dieser Anforderung ab und beschriftet sie mit "Nach der Umformulierung erneut geprüft": Die Regelprüfungen laufen erneut auf dem neuen Text. Das Entfernen des Häkchens stellt die Kästchen wieder her. Correct, Feasible und Necessary werden weiterhin angewendet.
| Schaltfläche | Wirkung |
|---|---|
| Alle Wertänderungen auswählen | Kreuzt jede Wertänderung an, außer bei genehmigten, gesperrten Anforderungen und Anforderungen mit Baseline. |
| Alle Umformulierungen auswählen | Kreuzt jede Umformulierung an, außer gekennzeichneten. |
| Keine auswählen | Entfernt alle Häkchen. |
Was Anwenden bewirkt:
- Correct, Feasible und Necessary werden zu manuellen Ja/Nein-Werten.
- Ein Nein bei Unambiguous oder Verifiable wird zu einem KI-Befund: Die Seite Qualität listet ihn mit den Regelbefunden auf, als "KI: mehrdeutig — <Grund>" oder "KI: so wie formuliert nicht verifizierbar — <Grund>", und das Kriterium zeigt ✘. Ein Ja entfernt einen früheren KI-Befund.
- KI-Befunde werden gelöscht, wenn sich Name oder Beschreibung der Anforderung ändern (auch durch eine angenommene Umformulierung) und durch Mehr ▾ → Manuelle Bewertungen löschen.
Was Auswahl anwenden bewirkt:
- Urteile werden zu manuellen Werten, mit der Meldung "KI: <Grund>". Sie bleiben erhalten, wenn die Prüfung erneut läuft.
- Umformulierungen ersetzen die Beschreibung und führen die Prüfung erneut aus.
Qualitätsexporte
| Export | Inhalt |
|---|---|
Exportieren ▾ → CSV (quality_report.csv) | Eine Zeile je Anforderung und Kriterium: Number, Name, Description, Quality Score, Attribute, Message, Result. |
Exportieren ▾ → Excel (.xlsx) (quality_report.xlsx) | Number, Name, Description, Rationale, Quality Score, Attribute, Message, Result, wobei die Zellen der Anforderung über ihre neun Zeilen verbunden sind, Ja in Grün und Nein in Rot, und am Ende ein Wert melden (Ja-Antworten im Verhältnis zu allen Antworten). |
| Dokument Liefern ▾ → Alle Exporte… → Qualitätsbefunde (Excel) | Dasselbe Layout für ein Dokument, mit den Anzeigespalten des Dokuments. |
Genehmigungen
Unter Bedarfe & Anforderungen → Genehmigungen sehen Sie alles, was auf eine Entscheidung wartet. Es öffnet die Datenbank mit der Abfrage Requirement:"Status=In Review".
Es bietet jede Datenbankfunktion:
- Wählen Sie mehrere Zeilen aus und setzen Sie mit der Sammelleiste Status oder Labels gemeinsam.
- Exportieren Sie die Liste.
- Doppelklicken Sie auf eine Zeile für die Elementansicht und den vollständigen Verlauf.
Das Genehmigungsfeld
Das Genehmigungsfeld erscheint im Inspektor und in der Elementansicht jeder Anforderung. Es zeigt:
- Den aktuellen Status als farbigen Chip (Entwurf, wenn keiner gesetzt ist).
- Die zuletzt festgehaltene Entscheidung: "<Status> von <Name> · <Datum und Uhrzeit>", gefolgt von "— <Notiz>", falls vorhanden (zum Beispiel "— Text nach der Genehmigung geändert"), oder "Keine Genehmigung festgehalten".
- Die Schaltflächen, die für den aktuellen Status gelten:
| Schaltfläche | Angezeigt, wenn | Wirkung |
|---|---|---|
| Genehmigen | Status ist weder Genehmigt noch Abgelehnt | Setzt Genehmigt und hält Sie und die Uhrzeit fest. Meldung: "Genehmigt". |
| Ablehnen… | Status ist weder Genehmigt noch Abgelehnt | Fragt im Dialog Anforderung ablehnen nach einem Grund (optional) und setzt dann Abgelehnt. Meldung: "Abgelehnt". |
| Wieder öffnen | Status ist Genehmigt oder Abgelehnt | Setzt In Review. Meldung: "Zu In Review verschoben". |
Der festgehaltene Name ist Ihr Kontoname. Auch das Setzen des Status von Hand in einer Tabelle oder im Inspektor hält eine Entscheidung mit Ihrem Namen und der Uhrzeit fest. Betrachter sehen das Feld ohne Schaltflächen.
Wenn ein Workflow den Wechsel zu Genehmigt über einen Änderungsantrag leitet, zeigt das Feld stattdessen den offenen Antrag und seinen Stand, zum Beispiel CR-4: 1 von 3 Genehmigungen. Nach dem Anwenden nennt die Entscheidung jeden Genehmiger und den Antrag: "Genehmigt von Ann Lead, Bob Discipline · <Datum und Uhrzeit> · CR-4".
Notiz: Das Bearbeiten von Name oder Beschreibung einer genehmigten Anforderung setzt sie auf In Review, mit der Notiz "Text nach der Genehmigung geändert". Die Meldung lautet "N genehmigte Anforderung(en) zu In Review verschoben." Das Ändern anderer Attribute öffnet sie nicht wieder.
TBD/TBR-Register
Mit dem Register verfolgen Sie jeden offenen Punkt, bis er geschlossen ist. Öffnen Sie Bedarfe & Anforderungen → TBD/TBR. Wählen Sie in einem Dokument Prüfen ▾ → TBD/TBR-Register, um das Register auf dieses Dokument beschränkt zu öffnen.
- Seitenkopf: XLSX exportieren (deaktiviert, wenn das Register leer ist).
- Bereichsleiste: Umfang (Alle Anforderungen oder Dokument: <Name>).
- Kacheln: Offene TBD/TBR, Überfällig, Kein Eigentümer und Chips Pro Dokument ("<Dokument>: <Anzahl>"), die das jeweilige Dokument öffnen.
- Offene Elemente im Zeitverlauf: ein Burn-down der offenen Anzahl. Es wird aus dem Verlauf der Anforderungen neu aufgebaut, mit bis zu 60 Punkten von der ältesten Anforderung bis jetzt. Zeigen Sie auf einen Punkt, um Datum und Anzahl zu sehen. Bei zu wenig Verlauf zeigt es "Noch nicht genug Verlauf für ein Burn-down."
- Spalten der Tabelle:
- Number und Name mit der Beschreibung.
- Dokument.
- Typ: TBD, TBR oder TBS, mit "Attribut", "im Text" oder beidem.
- Owner: der TBD Owner, sonst der Owner der Anforderung, sonst "—".
- Fälligkeitsdatum: das eine Fälligkeitsdatum der Anforderung, dasselbe Datum wie Fälligkeitsdatum in der Gruppe Workflow des Inspektors und in der Elementansicht. Es ist das Attribut TBD Due Date, wenn dieses ein Datum enthält, sonst das Fälligkeitsdatum der Anforderung. Zeigt "Überfällig" unter einem vergangenen Datum. Überfällige Zeilen sind eingefärbt.
- Alter: Tage, seit der Punkt geöffnet wurde.
- Schließen.
Klicken Sie mit der rechten Maustaste auf eine Zeile oder drücken Sie darauf Shift+F10, um dasselbe Zeilenmenü wie in der Datenbank zu öffnen: vorgeschlagene Aktionen mit ihren Gründen, ✦ Weitere KI ▸, Öffnen, Umbenennen…, Duplizieren, Unterelement hinzufügen…, Status ▸, Priorität ▸, In Beziehung setzen zu ▸, Zum Dokument hinzufügen ▸, Im Diagramm anzeigen ▸, Link kopieren, Nummer kopieren und Löschen…. In anderen Kontextmenüs beginnt eine Anforderung mit offenem TBD oder TBR mit TBD auflösen…, das dieses Register mit ausgewählter Anforderung öffnet.
Das Register ist schreibgeschützt. Um ein Fälligkeitsdatum zu ändern, wählen Sie die Zeile aus und setzen Sie Fälligkeitsdatum im Inspektor. Holarch setzt das Fälligkeitsdatum der Anforderung und, wenn das Attribut TBD Due Date ein Datum enthält, auch dieses Attribut (unter Beibehaltung der Uhrzeit), und ein einziges Rückgängigmachen nimmt alles zurück. Das Leeren von Fälligkeitsdatum leert beide.
Schließen erscheint nur, wenn das Attribut TBD/TBR gesetzt ist. Es setzt das Attribut auf None:
- Ist im Text nichts mehr übrig, lautet die Meldung "Geschlossen".
- Steht noch TBD, TBR oder TBS im Text, lautet die Meldung "Attribut geschlossen; der Text enthält noch TBD."
- Ein Punkt, der nur aus dem Text stammt, hat keine Schaltfläche Schließen; bearbeiten Sie den Text, um ihn zu schließen.
Wenn nichts offen ist, zeigt die Seite "Keine offenen TBD/TBR-Elemente. Setzen Sie das Attribut TBD/TBR einer Anforderung oder schreiben Sie TBD, TBR oder TBS in ihren Text, um sie hier aufzulisten."
XLSX exportieren schreibt TBD-TBR Register.xlsx mit Number, Name, Document, Type, Source (Attribut, Text oder beides), Owner, Due Date, Opened, Age (Tage), Overdue (Ja in Rot) und Description.
Zu prüfende Verknüpfungen
Mit Zu prüfende Verknüpfungen (in anderen Werkzeugen auch Suspect Links genannt) finden Sie, was nach der Änderung einer Anforderung erneut geprüft werden muss. Eine Verknüpfung muss geprüft werden, wenn sich das Element an ihrem anderen Ende nach der letzten Prüfung der Verknüpfung geändert hat: Prüfen Sie, ob die Verknüpfung noch gilt, und markieren Sie sie dann als geprüft. Bedarfe & Anforderungen → Zu prüfende Verknüpfungen listet sie auf. Verwenden Sie in einem Dokument Prüfen ▾ → Zu prüfende Verknüpfungen.
Was eine Verknüpfung zur Prüfung markiert
Diese Änderungen an einer Anforderung markieren ihre Verknüpfungen zur Prüfung:
- Name oder Beschreibung.
- Priorität, Criticality, Verification Method oder Verifikationsstufe.
- Jedes Zahlen-, Prozent- oder Dauerattribut.
Holarch markiert dann jede Verknüpfung der Anforderung dieser Typen: decomposed by, derived by, refined by, satisfied by, verified by und traced to.
Eine geänderte Verification Method oder Verifikationsstufe markiert nur die verified by-Verknüpfungen. Das Setzen der ersten Methode oder Stufe einer Anforderung markiert nichts: Es plant die Verifikation und ändert nichts, was geprüft wurde.
Das andere Ende jeder Verknüpfung ist das zu prüfende Element: die untergeordnete Anforderung, die erfüllende Funktion oder das erfüllende Asset, der verifizierende Test Case usw. Weitere Änderungen an derselben Anforderung ergänzen die Liste der geänderten Felder in derselben Markierung.
Wo zu prüfende Verknüpfungen angezeigt werden
- Seite Zu prüfende Verknüpfungen: eine Zeile je zu prüfender Verknüpfung.
- Dokumente und die Datenbank: ein Abzeichen ⚠ Prüfen in der Zeile des Elements ("Das Element am anderen Ende hat sich nach der letzten Prüfung dieser Verknüpfung geändert. Prüfen Sie, ob die Verknüpfung noch gilt, und markieren Sie sie dann als geprüft. Klicken Sie zum Prüfen.").
- Inspektor und Elementansicht: ein Banner "⚠ Prüfen: <Anforderung> hat sich nach der letzten Prüfung dieser Verknüpfung geändert. Prüfen Sie, ob die Verknüpfung noch gilt, und markieren Sie sie dann als geprüft." Seine Schaltfläche Prüfen… öffnet den Dialog Zu prüfende Verknüpfungen — <Element> für dieses Element, mit Offene zu prüfende Verknüpfungen und Schließen.
- Der Abschnitt Nachverfolgung des Inspektors: ein ⚠ neben jeder zu prüfenden Verknüpfung, mit den geänderten Feldern und dem Datum im Tooltip.
- RVTM: ein ⚠ hinter einer Anforderung mit einer zu prüfenden Verknüpfung an einem der beiden Enden (sie hat sich geändert, oder das ihr vorgelagerte Element hat sich geändert); klicken Sie darauf, um diese Verknüpfungen zu prüfen. Ein ⚠ hinter einem Test Case in Verifiziert durch markiert diese Verifikationsverknüpfung.
Die Seite Zu prüfende Verknüpfungen
Die Seite erklärt oben die Regel und zeigt eine Tabelle:
| Spalte | Inhalt |
|---|---|
| (Kontrollkästchen) | Auswahl für Auswahl als geprüft markieren…. Das Kontrollkästchen in der Kopfzeile wählt alle aus. |
| Geändert | Die Anforderung, die sich geändert hat. |
| Änderung | Die geänderten Felder, zum Beispiel "Description" oder "Priority, Verification Level". |
| Wann / Von | Datum und Uhrzeit der Änderung und wer sie vorgenommen hat. |
| Beziehung | Der Verknüpfungstyp, gelesen von der geänderten Anforderung aus (zum Beispiel "satisfied by"). |
| Zu prüfendes Element | Das Element am anderen Ende der Verknüpfung. |
| (Aktionen) | Vergleich und Als geprüft markieren…. |
Klicken Sie mit der rechten Maustaste auf eine Zeile oder drücken Sie darauf Shift+F10, um das Zeilenmenü des Elements wie in der Datenbank zu öffnen: vorgeschlagene Aktionen, ✦ Weitere KI ▸, Öffnen, Umbenennen…, Duplizieren, Unterelement hinzufügen…, Status ▸, Priorität ▸, In Beziehung setzen zu ▸, Zum Dokument hinzufügen ▸, Im Diagramm anzeigen ▸, Link kopieren, Nummer kopieren und Löschen…. In anderen Kontextmenüs (Datenbank, Dokumente) beginnt ein Element mit einer zu prüfenden Verknüpfung mit Verknüpfung prüfen…, das die Prüfung dafür öffnet.
Vergleich öffnet Änderung — <Anforderung> mit einem Wortvergleich von Name und Beschreibung. Wenn sich nur Attribute geändert haben, lautet es "Nur Attribute geändert: <Felder>. Für Details den Elementverlauf öffnen." Verlauf… öffnet den Verlauf der Anforderung.
So markieren Sie Verknüpfungen als geprüft:
- Klicken Sie in einer Zeile auf Als geprüft markieren…, für die angekreuzten Zeilen auf Auswahl als geprüft markieren… oder auf Alle als geprüft markieren (N)….
N Verknüpfung(en) als geprüft markieren öffnet sich: "Bestätigen Sie, dass die verknüpften Elemente nach der Änderung noch gelten. Zu jedem verknüpften Element wird ein Kommentar hinzugefügt."
- Geben Sie einen optionalen Kommentar ein, zum Beispiel "Unterelement weiterhin gültig; keine Änderung nötig."
- Klicken Sie auf Als geprüft markieren.
Die Meldung lautet "N Verknüpfungen als geprüft markiert."
Auswahl als geprüft markieren… ohne Auswahl zeigt "Zuerst die Verknüpfungen auswählen, die als geprüft markiert werden sollen."
Das Markieren einer Verknüpfung als geprüft hält das Review an der Verknüpfung fest: wer, wann, der Kommentar und die Felder. Wenn Sie einen Kommentar geschrieben haben, fügt Holarch außerdem "Verknüpfung geprüft (<Anforderung> geändert: <Felder>): <Kommentar>" zu den Kommentaren jedes Elements hinzu. Rückgängig macht es rückgängig.
Ohne zu prüfende Verknüpfungen zeigt die Seite "Keine zu prüfenden Verknüpfungen. Eine Verknüpfung muss geprüft werden, wenn sich das Element an ihrem anderen Ende nach der letzten Prüfung der Verknüpfung ändert."
Baselines und Versionsvergleich
Dokument-Baselines
Erstellen und verwenden Sie Dokument-Baselines mit Version ▾ im Titelblock des Dokuments. Es listet auf:
- Aktuelle Version: das aktuelle Dokument.
- Jede Baseline dieses Dokuments, die neueste zuerst, mit ihrem Datum.
- Unter Projekt-Baselines jede Projekt-Baseline.
- Baseline speichern… und Versionen vergleichen… (abgeblendet, bis das Dokument eine Baseline hat: "Zuerst eine Baseline speichern").
Baseline speichern… öffnet Baseline speichern:
- Name * (erforderlich).
- Genehmigungen: Zeilen mit Name, Rolle und Erklärung, mit + Genehmiger hinzufügen. Die erste Zeile ist mit Ihrem Namen ausgefüllt. "Keine Freigebenden.", wenn leer.
- Die Notiz "Die Baseline bewahrt diese Version des Dokuments (seine Elemente, deren Attribute und Beziehungen), um sie später anzusehen, zu vergleichen und wiederherzustellen. Genehmigungsdatensätze werden mit dem jetzigen Datum versehen und können danach nicht bearbeitet werden."
Wählen Sie eine Baseline in Version ▾, um sie anzusehen. Das Dokument wird schreibgeschützt, mit dem Banner "Baseline „<Name>“, schreibgeschützt, gespeichert <Datum>" und der Liste der Genehmigungen. Diese Schaltflächen erscheinen:
| Schaltfläche | Wirkung |
|---|---|
| Zurück zum Aktuellen | Kehrt zum aktuellen Dokument zurück. |
| Bearbeiten | Baseline bearbeiten: sie umbenennen und Genehmigungsdatensätze hinzufügen. Genehmigungen (gesperrt) listet die vorhandenen Datensätze auf, die sich nicht ändern können; neue Datensätze "werden mit dem jetzigen Datum versehen und der Liste hinzugefügt". Nur Dokument-Baselines. |
| Mit aktueller Version vergleichen | Öffnet Versionen vergleichen ab dieser Baseline. Nur Dokument-Baselines. |
| Baseline wiederherstellen | Dokument-Baseline: "Entitäten, Reihenfolge und Struktur dieses Dokuments mit der Baseline „<Name>“ überschreiben? Seitdem hinzugefügte Entitäten werden aus dem Dokument entfernt (nicht gelöscht). Rückgängig ist möglich." Projekt-Baseline: Projekt durch Baseline ersetzen, "Das gesamte Projekt durch die Projekt-Baseline „<Name>“ ersetzen? Rückgängig ist möglich." |
| Löschen | "Baseline „<Name>“ löschen?" |
Im aktuellen Dokument trägt jede Zeile einen Änderungsbalken: neu seit der Baseline, geändert seit der Baseline oder unverändert. Verglichen wird mit der neuesten Dokument-Baseline oder, wenn das Dokument keine hat, mit der neuesten Projekt-Baseline.
Versionen vergleichen
Mit dem Änderungsbericht sehen Sie genau, was sich seit einem Review geändert hat.
- Klicken Sie auf Version ▾ → Versionen vergleichen… oder im Banner einer Baseline auf Mit aktueller Version vergleichen.
Versionen vergleichen öffnet sich.
- Wählen Sie Von: eine Baseline.
- Wählen Sie Bis: eine spätere Baseline oder Aktuelle Version.
Die Tabelle listet Number, Name, Typ ändern, Feld und Änderung (ein Wortvergleich bei geändertem Text).
Änderungstypen:
| Änderungstyp | Bedeutung |
|---|---|
| Hinzugefügt / Entfernt | Die Entität kam zum Dokument hinzu oder wurde daraus entfernt. |
| Geändert | Ein Feld hat sich geändert: Name, Number, Description, Class, Image oder ein beliebiges Attribut (das Feld wird genannt). |
| Label hinzugefügt / Label entfernt | Ein Label wurde hinzugefügt oder entfernt. |
| Beziehung hinzugefügt / Beziehung entfernt | Eine Verknüpfung, die das Dokument berührt, wurde hinzugefügt oder entfernt. |
| Beziehungsattribut | Die Attribute einer Beziehung haben sich geändert. |
Änderungen (Excel) schreibt "<Dokument> (Changes).xlsx" mit Number, Name, Class, Change Type, Field, Old Value und New Value. Änderungsansicht (Word) schreibt denselben Vergleich als Word-Änderungsverfolgung.
Liefern ▾ → Änderungen (Excel)… des Dokuments (auch in Alle Exporte…) exportiert denselben Bericht mit Von und Bis. Er schlägt mit "Dieses Dokument hat keine Baseline. Zuerst eine speichern." fehl, wenn keine vorhanden ist.
Document (Word) füllt die Tabellen Revision History und Approvals der Word-Ausgabe aus den Baselines des Dokuments.
Seite Baselines & Versionen
Unter Steuerung & Prüfungen → Baselines & Versionen verwalten Sie jede Baseline im Projekt. Projekt-Baselines enthalten jede Entität; Dokument-Baselines enthalten ein Dokument und werden mit Version ▾ → Baseline speichern… des Dokuments erstellt. Der Seitenkopf hat Eine frühere Version wiederherstellen…, das eine frühere automatische Speicherung des ganzen Projekts zurückholt, und + Baseline speichern….
So erstellen Sie eine Projekt-Baseline:
- Klicken Sie im Seitenkopf auf + Baseline speichern….
Der Dialog Projekt-Baseline speichern zeigt die aktuellen Anzahlen von Entitäten und Beziehungen. Der Name ist standardmäßig "Baseline <n>"; der Platzhalter lautet "Name, zum Beispiel „SRR“".
- Geben Sie einen Namen ein und drücken Sie Enter oder klicken Sie auf Baseline speichern. Ein leerer Name wird abgelehnt ("Geben Sie einen Namen ein.").
Die Meldung lautet "Baseline gespeichert".
Die Karten der Seite:
- Karte Baselines: die aktuellen Anzahlen ("Aktuell: <n> Elemente, <n> Beziehungen") und ein Filter: Alle Baselines, Projektweite Baselines oder Dokument: <Name>. Spalten:
- Name.
- Dokument: ein Link, um das Dokument in dieser Baseline anzusehen, oder "Projekt".
- Erstellt.
- Genehmigungen: "✔" und die Namen der Genehmiger. Zeigen Sie darauf, um Rolle, Datum und Erklärung zu sehen. "von <Name>" nennt den Ersteller.
- Entitäten und Beziehungen.
- Vergleichen: setzt diese Baseline als Von und die aktuelle Arbeitskopie als Bis.
- ⋯ (Weitere Aktionen):
- Umbenennen…: Baseline umbenennen.
- Exportieren (JSON): lädt "<Name>.json" herunter (Format
holarch-baseline, mit der Momentaufnahme und den Genehmigungen). - Baseline wiederherstellen… (Projekt-Baseline): "Alle aktuellen Entitäten und Beziehungen durch die Baseline „<Name>“ ersetzen? Rückgängig ist möglich (⌘Z / Ctrl+Z)." Meldung: "„<Name>“ wiederhergestellt".
- Dokument zurücksetzen… (Dokument-Baseline): "Dokument „<doc>“ auf die Baseline „<Name>“ zurücksetzen? Nur die Entitäten und die Struktur dieses Dokuments ändern sich. Rückgängig ist möglich." Deaktiviert, wenn das Dokument gelöscht wurde.
- Löschen…. Im gehosteten Dienst benennen nur Projekteigentümer eine Baseline um oder löschen sie; für andere sind diese Einträge mit dem Grund ausgegraut.
- Verwaiste Baselines (bei Bedarf angezeigt): "N Baselines gelöschter Dokumente". Jede hat Dokument wiederherstellen, das das Dokument-Artifact und seine Entitäten aus der Baseline neu erstellt, und Löschen.
- Karte Vergleichen: Wählen Sie Von (älter) und Bis (neuer). Bis ist Aktuelle Version oder eine andere Baseline desselben Umfangs.
- Kacheln: Entitäten hinzugefügt, Entitäten entfernt, Entitäten geändert, Beziehungsänderungen.
- Die Tabelle zeigt Entität, Änderung, Feld und Unterschied (Wortvergleich). Datumsattribute erscheinen im Datumsformat der App.
- CSV exportieren und XLSX exportieren schreiben "Changes <from> to <to>".
- Wenn nichts anzuzeigen ist: "Keine Unterschiede zwischen „<from>“ und „<to>“."
Ohne Baselines: "Keine Baselines. Erstellen Sie eine, um den aktuellen Stand des Projekts festzuhalten."
Notiz: Baselines werden im Projekt gespeichert und reisen bei einem Projektexport mit. Eine Projekt-Baseline enthält Entitäten und Beziehungen. Eine Dokument-Baseline enthält außerdem die Gliederungseinstellungen des Dokuments.
Anforderungen importieren
Mit Bedarfe & Anforderungen → Import und Export holen Sie Anforderungen aus Dateien herein. Das geschieht in vier Schritten: Datei → Zuordnen → Prüfen → Importieren.
- Zurück und Weiter wechseln zwischen den Schritten. N Elemente importieren im Schritt Prüfen importiert, und ein einziges Rückgängigmachen nimmt alles zurück.
- Eine einzige Ablagefläche nimmt jedes Format an. Das Format wird aus der Datei erkannt (ihrem Namen und, wo das nicht reicht, ihrem Inhalt) und unter Format angezeigt, wo Sie es ändern können.
Die Formate sind Word (.docx), Holarch-Projektdateien (.holarch, .json), Excel / CSV (.xlsx, .csv), Reiner Text (.txt), UML/SysML (.xmi, .uml, .mdzip) und ReqIF (.reqif).
Dieser Abschnitt behandelt die Anforderungsformate. Für Projektdateien, XMI und alle anderen Importe und Exporte siehe Import und Export.
Schritt 1: Datei
Legen Sie eine Datei auf "Datei hier ablegen oder klicken, um eine zu wählen" ab, oder fügen Sie Text in das Feld ein und klicken Sie auf Text analysieren (CSV mit Kopfzeile, ReqIF-XML, XMI, JSON oder Dokumenttext).
| Option | Werte | Wirkung |
|---|---|---|
| Format | Die sechs Formate oben | Zeigt das erkannte Format. Wählen Sie ein anderes, um denselben Inhalt anders zu lesen. |
| Textcodierung (CSV, Text) | Automatisch, UTF-8, ISO-8859-1 / Windows-1252, Shift_JIS, Big5, UTF-16 | Wie die Bytes der Datei gelesen werden. Eine Änderung liest die Datei neu ein. |
| Tabellenblatt (Arbeitsmappen) | "<Name> (N Zeilen)" | Das zu importierende Tabellenblatt. Das erste Blatt mit Daten ist vorausgewählt. |
- Reiner Text: Das Feld hält den importierten Inhalt bearbeitbar. Bearbeiten Sie ihn und klicken Sie auf Analyse erneut ausführen.
- Die Statuszeile lautet "„<Datei>“ analysiert: N Zeilen, M Spalten." (dazu "(Tabellenblatt „<Name>“)" und bei Word ", N Tabelle(n)").
Schritt 2: Zuordnen
Jede Dateispalte ist eine Zeile: Dateispalte (Titel und Position), Beispielwerte (die ersten drei Zeilen) und Holarch-Feld. Wählen Sie Überspringen, um eine Spalte auszulassen. Felder, die anhand des Spaltentitels zugeordnet wurden, sind mit auto markiert.
| Holarch-Feld | Inhalt |
|---|---|
| Name, Number, Beschreibung | Die eigenen Felder des Elements. |
| Klasse, Labels | Der Klassenname; Labelnamen getrennt durch ; , oder |. |
| Übergeordnete Nummer, Global ID | Die Nummer des übergeordneten Elements; die ID, mit der vorhandene Entitäten abgeglichen werden. |
| Ein Attribut | Ein beliebiges Attribut der Klasse für Zeilen ohne Klasse. |
| Eine Beziehung | Trennen Sie mehrere Ziele mit ;. |
| Zeilen-ID, ID der übergeordneten Zeile, Neues Attribut (wird zum Schema hinzugefügt) | Struktur aus ReqIF- und XMI-Dateien sowie neue Attribute. |
✦ KI ▾ → Zuordnung vorschlagen schlägt für jede Spalte ein Feld vor. Vorgeschlagene Zuordnung listet die Änderungen angekreuzt auf, mit dem Grund der KI; Angekreuzte anwenden ändert die Zuordnung. Es wird noch nichts importiert.
Holarch errät die Zuordnung aus der Kopfzeile:
| Kopfzeile | Wird zugeordnet zu |
|---|---|
| Number, No, Num, #, ID Number, Req Number, Requirement Number | Nummer |
| Name, Title, Short Name, Requirement Name | Name |
| Description, Text, Requirement, Requirement Text, Statement, Desc | Beschreibung |
| Class, Type, Entity Class | Klasse |
| Labels, Label, Tags | Labels (Werte trennen mit ; , oder |) |
| Parent, Parent Number | Übergeordnete Nummer |
| Global ID, ID, GUID, UUID | Global ID |
| Ein Attributname (zum Beispiel Priority, Rationale, Status) | Dieses Attribut. "Method" und "Verification" werden Verification Method zugeordnet. |
| Ein Labelgruppenname (zum Beispiel Verification Method, wenn kein solches Attribut existiert) | Labels |
| Ein Beziehungsname (zum Beispiel satisfied by) | Diese Beziehung; trennen Sie mehrere Ziele mit ; |
| Object Identifier, Origin ID | Global ID |
| Object Number, ReqIF.ChapterName, ReqIF.ForeignID | Nummer |
| Object Heading, ReqIF.Name, Long Name | Name |
| Object Text, ReqIF.Text, ReqIF.Description | Beschreibung |
| ReqIF.Category | Klasse |
| ReqIF ID, XMI ID, Row ID / Parent ID | Zeilen-ID / ID der übergeordneten Zeile |
Neues Attribut erstellt auf jeder importierten Klasse ein Attribut, das nach der Spalte benannt ist. Sein Typ richtet sich nach den Werten:
- Zahl, wenn jeder Wert eine Zahl ist.
- Eine Auswahlliste, wenn es wenige kurze, verschiedene Werte gibt.
- Langer Text bei Werten über 120 Zeichen.
- Sonst Text.
Qualitätskriterien, berechnete und Dateiattribute können nicht zugeordnet werden.
Unter den Spalten:
| Option | Werte | Wirkung |
|---|---|---|
| Klasse für Zeilen ohne Klasse | Eine beliebige Klasse; Standard Requirement | Die Klasse von Zeilen ohne Wert in der Spalte Class und ohne passende Klassenregel. |
| Klassenregeln | Beschreibung enthält ein Wort oder eine Wendung → eine Klasse | + Regel fügt eine hinzu, × entfernt sie. Die erste passende Regel gilt für Zeilen ohne Class-Wert. |
| Vorhandene Entitäten abgleichen nach | Global ID, Name, Number | Zeilen, die zu einer vorhandenen Entität passen, aktualisieren diese, statt eine Kopie zu erstellen. Übereinstimmungen nach Name und Number erfordern außerdem dieselbe Klasse. |
| Verbundene Entitäten abgleichen nach | Global ID, Name, Number | Wie Werte in Beziehungsspalten ihre Ziele finden. |
| Datumsformat der Datumsspalten (CSV) | Automatisch, yyyy-MM-dd HH:mm:ss, dd/MM/yyyy, MM/dd/yyyy, yyyyMMdd, Benutzerdefiniert… | Wie Datumszellen gelesen werden. Benutzerdefiniert… zeigt ein Feld für Ihr eigenes Muster (zum Beispiel dd.MM.yyyy HH:mm) mit yyyy, MM, dd, HH, mm und ss. |
| Nummerierungsmuster (Word, Text) | Leer (automatisch) oder Marker wie 1. a) (i) oder Pfadnummern wie 1.1 oder 1.1.a | Wie nummerierte Absätze zur Gliederung werden. Bei Text wird das Muster aus der Nummerierung erkannt und eingetragen. Word-Überschriftenformate und Listennummerierung brauchen kein Muster. Siehe Nummerierungsmuster. |
| Unterelemente unter ihrem übergeordneten Element nummerieren (1 → 1.1) (Word, Text) | Standardmäßig ein | Erzeugte Nummern von Unterelementen werden zu "3.1", "3.2" statt "1", "2". |
Hierarchie. Gliederungsnummern bauen die Hierarchie wieder auf: "1.2.3" wird ein Unterelement von "1.2". Eine Spalte Übergeordnete Nummer oder ein Paar aus Zeilen-ID und ID der übergeordneten Zeile legt das übergeordnete Element ausdrücklich fest. Elemente ohne übergeordnetes Element werden zu Elementen der obersten Ebene des Dokuments.
Word-Tabellen. Bei einer Word-Datei listet der Abschnitt Word-Tabellen jede Tabelle auf. Tabellen, die sich mit derselben Kopfzeile über Abschnitte wiederholen, teilen sich eine Zuordnung. Der Abschnitt erklärt: "Importieren Sie eine Anforderungstabelle als Entitäten, eine pro Zeile, und ordnen Sie ihre Spalten zu. Andere Tabellen bleiben als Tabellen in der Beschreibung des Elements, dem sie folgen."
- Setzen Sie jede Tabelle auf Entitäten (eine pro Zeile) oder Tabelle in der Beschreibung.
- Ordnen Sie ihre Spalten Number, Name, Description, Class, Labels, Attribut, Neues Attribut oder Überspringen zu.
- Kopfzeilen wie ID, Req ID, Requirement ID, Ref oder Paragraph werden Number zugeordnet.
- Shall, Shall Statement, Requirement Statement, Requirement Text, Statement oder Text werden Description zugeordnet.
Eine Tabelle mit einer Nummern- oder Beschreibungsspalte und "shall"-Zeilen beginnt als Entitäten.
Die bisher gefundenen Warnungen erscheinen unter den Spalten, oder "Keine Warnungen."
Schritt 3: Prüfen
Prüfen Sie das Ergebnis, bevor sich etwas ändert. Prüfen zeigt die Änderungen so, wie Baselines & Versionen Versionen vergleicht (siehe Baselines und Versionsvergleich):
- Die erste Zeile nennt die Datei, das Format und die Anzahl der Elemente je Klasse.
- Ein Anforderungsdokument aus diesen N Anforderungen erstellen erscheint angekreuzt, wenn jedes Element ein Statement oder Requirement (oder eine Unterklasse) ist. Bei anderen Dateien lautet es Ein Dokument aus diesen N Elementen erstellen, nicht angekreuzt. Ist es angekreuzt, wählen Sie den Dokumenttyp (Standard Anforderungsdokument), den Name (Standard: der Dateiname) und ob Das gesamte Dokument nach dem Import neu nummerieren gelten soll.
- Danach folgen die Warnungen.
- Kacheln zählen die Neue Elemente, Aktualisierte Elemente, Elemente Abgeglichen, unverändert und Beziehungen aus der Datei.
- Die Änderungstabelle listet jedes neue Element mit seiner Beschreibung auf sowie jedes geänderte Feld eines aktualisierten Elements mit einem Wortvergleich von altem und neuem Wert (die ersten 500 Änderungen).
Klicken Sie auf N Elemente importieren. Die Meldung lautet "N neu importiert, M aktualisiert".
- Ohne Warnungen öffnet Holarch das neue Anforderungsdokument (oder die Datenbank).
- Andernfalls listet die Karte Import abgeschlossen die Warnungen auf ("Der Import hat keine Warnungen gemeldet.", wenn alles sauber ist). Ihre Schaltflächen sind Dokument öffnen, Datenbank öffnen, Spinnendiagramm, Baumdiagramm, Qualität prüfen und Weiteren Import starten.
Die Beschreibung des neuen Dokuments listet die Importwarnungen auf.
Wie jedes Format gelesen wird
Word (.docx):
- Überschriften und Word-Listennummerierung werden zur Gliederung und behalten ihre Nummern.
- Eine Überschrift wird zu einem Statement. Fließtext darunter wird zu seiner Beschreibung.
- Ein Absatz mit shall, must, will oder should wird zu einem untergeordneten Requirement, benannt nach den Wörtern nach dem Modalverb. Ein nummerierter Listeneintrag ebenso; ohne Modalverb wird er zu einem Statement.
- Aufzählungspunkte, Bilder und Tabellen werden Teil der Beschreibung des Elements, dem sie folgen, unter Beibehaltung von Fett, Kursiv, Listen und Tabellen.
- Die ursprüngliche .docx wird an das neue Dokument angehängt, wenn sie innerhalb der Anhangsgrenze pro Datei liegt.
- PNG-, JPEG-, GIF-, WebP- und SVG-Bilder bleiben erhalten. Andere Bildformate werden mit einer Warnung übersprungen.
Excel (.xlsx, .xlsm) und CSV:
- Eine Zeile pro Entität, beliebige Spalten. Die erste Zeile ist die Kopfzeile.
- Mehrzeilige Zellen behalten ihre Zeilenumbrüche.
- Dateien von Excel 97-2003 (.xls) werden nicht gelesen. Speichern Sie sie zuerst als .xlsx oder .csv.
ReqIF (.reqif, .reqifz):
- Jedes SPEC-OBJECT wird zu einer Zeile mit ReqIF ID, Parent ID (aus der Spezifikationshierarchie), Typ (sein Objekttyp, Class zugeordnet), Long Name und einer Spalte je Attributdefinition.
- Spalten ohne Zuordnung stehen standardmäßig auf Neues Attribut. XHTML-Attribute werden zu Rich-Text-Attributen und Aufzählungsattribute zu Auswahllisten.
- SPEC-RELATIONs werden nach Namen zu Beziehungen. Passt der Name zu keiner Beziehung, die das Schema erlaubt, werden sie zu traced to.
- Ein .reqifz-Archiv wird automatisch entpackt.
Reiner Text (.txt) oder eingefügter Text:
- Eine nummerierte Zeile ("3.1 Battery") oder eine kurze Zeile ohne Punkt wird zu einer Überschrift (Statement).
- Jeder Satz mit shall, must, will oder should wird zu einem Requirement unter der aktuellen Überschrift.
- Anderer Text wird Teil der Beschreibung des vorherigen Elements.
- Mit einem Nummerierungsmuster (aus dem Text erkannt oder eingegeben) bestimmt das Muster die Ebenen.
Anforderungen aus einer Tabelle aktualisieren
Verwenden Sie dies, um viele Anforderungen auf einmal in einer Tabellenkalkulation zu ändern.
- Klicken Sie in der Datenbank (oder auf der Seite Anforderungen) auf Exportieren… und wählen Sie Tabelle (CSV).
- Kreuzen Sie die zu bearbeitenden Attribute an. Kreuzen Sie unter Einschließen ID an und klicken Sie dann auf Exportieren.
- Bearbeiten Sie die Werte in der Tabellenkalkulation. Ändern Sie die Spalte ID nicht.
- Importieren Sie die Datei. Prüfen Sie unter Zuordnen, ob die Spalte ID Global ID zugeordnet ist, und setzen Sie Vorhandene Entitäten abgleichen nach auf Global ID.
- Entfernen Sie unter Prüfen das Häkchen bei Ein Dokument erstellen….
Abgeglichene Zeilen zählen als Aktualisierte Elemente, mit jedem geänderten Feld aufgeführt.
- Klicken Sie auf N Elemente importieren.
Ein I_…-Wert aus einer Datei, die vor diesem Release exportiert wurde, passt nicht; verwenden Sie die Spalte ID. Alle Schritte und Optionen finden Sie unter Import und Export.
Was eine Aktualisierung schreibt:
- Nur die zugeordneten Spalten. Fehlt eine Spalte Description, bleibt jede vorhandene Beschreibung erhalten.
- Labels aus der Datei werden zu den vorhandenen Labels hinzugefügt.
- Ohne Spalte Class behält eine nach Global ID abgeglichene Zeile die Klasse ihrer Entität.
Importmeldungen
| Nachricht | Bedeutung und Lösung |
|---|---|
| Keine Spalte ist Name oder Number zugeordnet. Ordnen Sie eine davon zu. | Ordnen Sie mindestens eine Spalte Name oder Number zu. |
| Zeile N: unbekannte Klasse "X", <Klasse> wird verwendet. | Der Class-Wert passt zu keiner Klasse. Korrigieren Sie den Wert oder ordnen Sie die Spalte Überspringen zu. |
| Zeile N: unbekanntes Label "X" ignoriert. | Erstellen Sie das Label zuerst im Schema oder korrigieren Sie den Wert. |
| Zeile N: "<Attribut>" gilt nicht für die Klasse <Klasse>. | Die Klasse der Zeile hat dieses Attribut nicht. |
| Zeile N: "<Wert>" ist kein gültiger <Typ> für "<Attribut>". | Der Wert kann nicht als Zahl, Datum, Auswahl usw. gelesen werden. Prüfen Sie die Option für das Datumsformat. |
| Zeile N: Name ist länger als 255 Zeichen und wurde gekürzt. / Zeile N: Number ist länger als 255 Zeichen und wurde gekürzt. | Namen und Nummern sind auf 255 Zeichen begrenzt. |
| Doppelte Nummer X (Zeilen A und B). | Zwei Zeilen haben dieselbe Nummer; die Hierarchie hängt Unterelemente möglicherweise an die erste. |
| Zeile N: fehlende übergeordnete Nummer P für X; an Q angehängt. / …; auf oberster Ebene importiert. | Die direkte übergeordnete Nummer ist nicht in der Datei. |
| Zeile N: übergeordnete Nummer P nicht gefunden. / Zeile N: übergeordnetes Element P nicht gefunden. | Parent Number oder Parent Row ID verweist auf eine Zeile, die nicht in der Datei ist. |
| Zeile N: "<Beziehung>"-Ziel "X" nicht gefunden. | Die Beziehungsspalte nennt eine Entität, die nicht existiert. Prüfen Sie Verbundene Entitäten abgleichen nach. |
| Zeile N: "<Beziehung>" von A nach B ist laut Schema nicht zulässig (trotzdem erstellt). | Die Verknüpfung wurde erstellt, obwohl das Schema sie nicht aufführt. |
| Beziehung "X" zwischen A und B ist laut Schema nicht zulässig; übersprungen. | Eine ReqIF- oder XMI-Relation konnte nicht erstellt werden, auch nicht als traced to. |
| Bild X: Bilder im Format .ext werden nicht unterstützt und wurden übersprungen. Speichern Sie das Bild in Word als PNG oder JPEG, um es zu behalten. | Word-Bild in einem nicht unterstützten Format. |
| Bild X (Größe) überschreitet die Anhangsgrenze von <Grenze> und wurde übersprungen. | Das Bild ist größer als die Grenze pro Datei. |
| Es wurden keine Datenzeilen gefunden. | Die Datei oder das Tabellenblatt hat nur eine Kopfzeile oder ist leer. |
| Die Datei konnte nicht gelesen werden: Dateien von Excel 97-2003 (.xls) werden nicht unterstützt. Speichern Sie die Datei in Excel als .xlsx oder .csv und importieren Sie sie dann erneut | Konvertieren Sie die Datei. |
| Die Datei konnte nicht gelesen werden: XML mit einer DOCTYPE- oder ENTITY-Deklaration wird nicht angenommen. Speichern Sie die Datei ohne sie und importieren Sie sie erneut | Entfernen Sie die Deklaration aus der ReqIF- oder XML-Datei. |
| Die Datei konnte nicht gelesen werden: ungültiges XML | Die ReqIF-Datei ist kein wohlgeformtes XML. |
| Import fehlgeschlagen: <Grund> | Der Import wurde abgebrochen; es wurde nichts geändert. |
Tastenkürzel für Anforderungen
| Tasten | Wo | Action |
|---|---|---|
| Enter | Schnelleingabe im Dokument | Die eingegebene Anforderung hinzufügen. |
| ⌘ / Ctrl+Enter / ⌥ / Alt+⌘ / Ctrl+Enter | Dokument, Element ausgewählt | Ein Geschwister / ein Unterelement hinzufügen. |
| Enter oder Space | Zeilen von Qualität, TBD/TBR und Zu prüfende Verknüpfungen | Die Anforderung oder das zu prüfende Element der Zeile im Inspektor anzeigen. |
| ↑ / ↓ | Dieselben Zeilen, Zeile fokussiert | Zur vorherigen oder nächsten Zeile wechseln. |
| ⌘ / Ctrl-Klick, ⇧ / Shift-Klick, ⌘ / Ctrl+⇧ / Shift-Klick | Zeilen von Qualität, TBD/TBR und Zu prüfende Verknüpfungen; Datenbankzeilen; Dokumentelemente | Eine Zeile umschalten, den Bereich ab der zuletzt angeklickten Zeile auswählen, diesen Bereich hinzufügen. |
| ⌘A / Ctrl+A, ⇧ / Shift+↑ / ⇧ / Shift+↓ | Dieselben Zeilen, Zeile fokussiert | Jede angezeigte Zeile auswählen; die Auswahl ab der fokussierten Zeile erweitern. |
| Rechtsklick, Shift+F10 oder die Menütaste | Zeilen von Anforderungen, Qualität, TBD/TBR und Zu prüfende Verknüpfungen; Dokumentelemente und Gliederungseinträge | Das Menü der Zeile öffnen: zuerst vorgeschlagene Aktionen mit ihren Gründen und ✦ Weitere KI ▸, dann die Befehle des Elements. |
| Esc | Qualität, TBD/TBR, Zu prüfende Verknüpfungen, RVTM | Die Auswahl der Zeile aufheben. |
| Enter | Namensfeld unter Baselines & Versionen | Die Projekt-Baseline erstellen. |
| ⌘Z / Ctrl+Z | Überall | Die letzte Änderung rückgängig machen, auch einen ganzen Import, das Markieren von Verknüpfungen als geprüft oder eine Statusänderung. |
Alle Tastenkürzel der App finden Sie unter Tastenkürzel.
Einstellungen
| Einstellung | Wo | Standard | Umfang |
|---|---|---|---|
| Automatisch erneut prüfen, wenn sich der Text ändert | Bereichsleiste der Seite Qualität | Aus | Dieser Browser |
| Inspektorgruppen eingeklappt oder geöffnet (Qualität und die anderen) | Klicken Sie im Inspektor auf die Überschrift einer Gruppe oder auf Alle zuklappen / Alle aufklappen am Ende ihrer Links | Qualität eingeklappt, der Rest geöffnet | Dieser Browser, pro Klasse |
| Ihr Name bei Genehmigungen, Entscheidungen und Kommentaren | Ihr Kontoname | — | Konto |
| Nachverfolgungsstatus (Punkte an Anforderungen) | Dokument Ansicht ▾ | An | Dokument |
Meldungen
| Nachricht | Wo | Bedeutung |
|---|---|---|
| N Anforderungen geprüft | Qualität | Die Prüfung lief über den Umfang. |
| Keine Anforderungen in diesem Umfang. | Qualität | Der Umfang enthält keine Anforderungen. |
| Dieses Dokument enthält keine zu prüfenden Requirements. Statements werden nicht bewertet. | Qualität prüfen im Dokument | Ändern Sie Elemente in Requirement oder prüfen Sie ein anderes Dokument. |
| Veraltet — erneut ausführen / Veraltet / Qualität: veraltet — erneut ausführen | Qualität, Dokumente, Inspektor | Der Text hat sich nach der letzten Prüfung geändert. |
| Erfordert das Urteil eines Prüfers | Qualität (Correct, Feasible) | Eine Person muss entscheiden; klicken Sie auf ✘, um es als Ja zu markieren. |
| Manuell als Nein markiert. | Qualität | Ein Prüfer hat das Kriterium auf Nein gesetzt. |
| N genehmigte Anforderung(en) zu In Review verschoben; N Verknüpfung(en) zur Prüfung markiert. | Nach einer Bearbeitung | Die Bearbeitung hat Genehmigungen wieder geöffnet und Verknüpfungen zur Prüfung markiert. |
| Genehmigt / Abgelehnt / Zu In Review verschoben | Genehmigungsfeld | Die Entscheidung wurde festgehalten. |
| N Verknüpfungen als geprüft markiert. | Zu prüfende Verknüpfungen | Die Reviews wurden festgehalten. |
| Zuerst die Verknüpfungen auswählen, die als geprüft markiert werden sollen. | Zu prüfende Verknüpfungen | Kreuzen Sie Zeilen an, bevor Sie Auswahl als geprüft markieren… wählen. |
| Geschlossen / Attribut geschlossen; der Text enthält noch TBD. | TBD/TBR | Das Attribut wurde auf None gesetzt. |
| Der Text enthält noch TBD. Bearbeiten Sie den Text, um es zu schließen. | TBD/TBR | Wird beim Schließen eines Punkts angezeigt, der nur aus dem Text stammt. |
| Baseline gespeichert | Dokumente, Baselines & Versionen | Die Momentaufnahme wurde gespeichert. |
| Dieses Dokument hat keine Baseline. Zuerst eine speichern. | Mit aktueller Version vergleichen, Änderungsberichte | Das Dokument hat keine Baseline. |
| Auf „<Name>“ zurückgesetzt / „<Name>“ wiederhergestellt | Baselines | Das Dokument oder Projekt wurde zurückgesetzt; Rückgängig ist möglich. |
| Keine Anforderungen zu prüfen. Wählen Sie zuerst Anforderungen aus oder öffnen Sie sie. | KI-Anforderungsprüfung | Keine Anforderungen im Umfang. |
Grenzen
- Qualität prüfen: Jede Anforderung im Umfang wird mit den anderen auf Duplikate verglichen (Ähnlichkeitsschwelle 75 %).
- KI-Anforderungsprüfung: 20 Anforderungen pro KI-Anfrage, mit bis zu 300 weiteren Anforderungen als Kontext.
- Der Vergleich bei der Verknüpfungsprüfung behält die ersten 500 Zeichen des alten Namens und 4.000 der alten Beschreibung.
- TBD/TBR-Burn-down: bis zu 60 Punkte.
- Import:
- Namen und Nummern bis zu 255 Zeichen.
- Die Vorschau zeigt die ersten 500 Zeilen. Die ersten 50 Warnungen werden aufgeführt ("…und N weitere").
- Ein Nummerierungsmuster hat höchstens 6 Ebenen ("Das Nummerierungsmuster hat mehr als 6 Ebenen. Verwenden Sie höchstens 6 Marker.").
- ReqIF-/XML-Dateien bis zu 100 Millionen Zeichen und 3.000.000 Elementen.
- .reqifz- und .docx-Archive bis zu 10.000 Einträgen, 300 MB pro Eintrag und 600 MB insgesamt.
- Bilder und die ursprüngliche Word-Datei werden nur innerhalb der Anhangsgrenze pro Datei behalten (10 MB im Tarif Free, 25 MB bei Individual, 100 MB bei Team).
Verwandte Themen
- Dokumente: Spezifikationen, Berichte und DOCX-Ausgabe schreiben und strukturieren.
- Nachverfolgbarkeit: Beziehungen, die Nachverfolgbarkeitsmatrix, Abdeckung und Auswirkung.
- Das Modell und die Datenbank: Abfragen, Spalten und Sammelbearbeitung.
- Schemaerweiterungen: Anforderungsattribute, Auswahlwerte und Labels hinzufügen.
- Import und Export: jedes Dateiformat.
- Hilfe: Anforderungen, Status und Genehmigung, Anforderungsqualität, TBD/TBR-Register, Zu prüfende Verknüpfungen, Genehmigungen, Import, Baselines & Versionen, RVTM.