Holarch

Anforderungen

Anforderungen

Schreiben, prüfen, genehmigen, baselinen und importieren Sie Anforderungen und verfolgen Sie offene TBD/TBR-Punkte und zu prüfende Verknüpfungen.

So gehen Sie vor →

Auf dieser Seite
  1. Überblick
  2. Konzepte
    1. Requirement und Statement
    2. Anforderungsattribute
    3. Anforderungslabels
    4. Der Anforderungs-Workflow
    5. Offene Punkte: TBD, TBR und TBS
    6. Baselines
  3. So setzen Sie es ein
    1. Wann und warum
    2. Eine Anforderung schreiben
    3. Die Formulierung prüfen
    4. Mit EARS-Vorlagen schreiben
    5. Anforderungen genehmigen
    6. Ein Dokument für ein Review einfrieren
    7. Eine Änderung nach der Baseline behandeln
    8. TBD- und TBR-Punkte schließen
    9. Eine vorhandene Spezifikation importieren
    10. Durchgehendes Beispiel: die CubeSat-EO-1-Demo
    11. Tipps und bewährte Vorgehensweisen
    12. Häufige Fehler
    13. Zusammenhang mit anderen Funktionen
  4. Die Seite Anforderungen
  5. Anforderungsqualität
    1. Seitenaufbau
    2. Die Seite Qualität filtern
    3. Kriterien und Prüfungen
    4. Zwei Anforderungen in einer (R19)
    5. Anforderungen in anderen Sprachen
    6. Manuelle Übersteuerungen
    7. Veraltete Ergebnisse
    8. Qualität aus einem Dokument prüfen
    9. KI-Anforderungsprüfung
    10. Qualitätsexporte
  6. Genehmigungen
    1. Das Genehmigungsfeld
  7. TBD/TBR-Register
  8. Zu prüfende Verknüpfungen
    1. Was eine Verknüpfung zur Prüfung markiert
    2. Wo zu prüfende Verknüpfungen angezeigt werden
    3. Die Seite Zu prüfende Verknüpfungen
  9. Baselines und Versionsvergleich
    1. Dokument-Baselines
    2. Versionen vergleichen
    3. Seite Baselines & Versionen
  10. Anforderungen importieren
    1. Schritt 1: Datei
    2. Schritt 2: Zuordnen
    3. Schritt 3: Prüfen
    4. Wie jedes Format gelesen wird
    5. Anforderungen aus einer Tabelle aktualisieren
    6. Importmeldungen
  11. Tastenkürzel für Anforderungen
  12. Einstellungen
  13. Meldungen
  14. Grenzen
  15. 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:

SeiteWas er zeigt
DokumenteSpezifikationen und ihre Gliederungen. Hier werden Anforderungen geschrieben.
AnforderungenAlle Anforderungen in einer Tabelle (die Datenbank, gefiltert auf class:Requirement).
QualitätDie Anforderungsqualität: eine Bewertung nach neun Kriterien je Anforderung.
TBD/TBRDas Register offener Werte, die noch zu bestimmen oder zu prüfen sind.
Zu prüfende VerknüpfungenVerknüpfungen, deren vorgelagerte Anforderung sich nach der letzten Prüfung der Verknüpfung geändert hat.
GenehmigungenAnforderungen mit dem Status In Review.
Import und ExportImport 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

AttributTyp und WerteBedeutung
BegründungLanger TextDer Grund hinter der Anforderung.
StatusDraft, In Review, Approved, RejectedWo die Anforderung im Genehmigungs-Workflow steht.
PrioritätHigh, Medium, LowWie wichtig die Anforderung für die Stakeholder ist.
CriticalityHigh, Medium, LowFolge für die Mission oder die Sicherheit, wenn die Anforderung nicht erfüllt wird.
VerantwortlichTextPerson oder Team, die für die Anforderung verantwortlich ist.
QuelleTextStakeholder, Dokument oder Norm, aus dem die Anforderung stammt.
Verification MethodMehrfachauswahl: Analysis, Demonstration, Inspection, TestWie die Anforderung verifiziert wird.
VerifikationsstufeComponent, Subsystem, SystemIntegrationsebene, auf der die Anforderung verifiziert wird.
ErfolgskriterienLanger TextMessbares Ergebnis, das zeigt, dass die Anforderung erfüllt ist.
TBD/TBRNone, TBD, TBRTBD = ein Wert ist noch zu bestimmen; TBR = ein Wert ist noch zu prüfen. Nach dem Schließen wieder auf None setzen.
TBD OwnerTextPerson, die für das Schließen des TBD/TBR verantwortlich ist.
TBD Due DateDatum und UhrzeitDatum, 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ätswertProzent, berechnetErgebnis der letzten Qualitätsprüfung.
Appropriate, Complete, Conforming, Correct, Feasible, Necessary, Singular, Unambiguous, VerifiableJa/Nein, berechnet oder von Hand gesetztDie 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:

  1. Entwurf: wird geschrieben.
  2. In Review: wartet auf eine Entscheidung. Auf der Seite Genehmigungen aufgeführt.
  3. 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:

  1. Stakeholder-Bedarfe erfassen.
  2. Systemanforderungen ableiten.
  3. Prüfen, ob jede Aussage gut formuliert ist.
  4. Die Anforderungen genehmigen lassen.
  5. 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:

FrageSeite
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

  1. Öffnen Sie Bedarfe & Anforderungen → Dokumente.
  2. Öffnen Sie das Anforderungsdokument.

    Um ein neues anzulegen, klicken Sie auf + Neues Dokument (siehe Dokumente).

  3. Wählen Sie in der Leiste Schnell hinzufügen unter dem Dokument, wohin das Element kommt, zum Beispiel Unter 3 Electrical Power.
  4. 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.

  5. Öffnen Sie bei ausgewählter Anforderung den Inspektor auf der rechten Seite.
  6. 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.
  7. 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:

  1. Schreiben Sie Ihre beste Schätzung in die Aussage.
  2. Setzen Sie TBD/TBR auf TBD.
  3. 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

  1. Öffnen Sie Bedarfe & Anforderungen → Qualität.

    Wählen Sie in einem Dokument stattdessen Prüfen ▾ → Qualität prüfen.

  2. Wählen Sie in der Bereichsleiste Alle Anforderungen oder Dokument: <Name>.
  3. 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.

  4. Lesen Sie die Kacheln: Anforderungen, Durchschnittswert, Gut (≥ 67 %), Überarbeitung nötig (< 67 %) und, falls vorhanden, Veraltet (Text geändert).
  5. 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.

  6. Klicken Sie auf den Namen der Anforderung, um sie zu öffnen, und korrigieren Sie den Text.
  7. 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.

MusterVorlageBeispiel
UbiquitousThe [system] shall [response].The pump controller shall record every start command with its time.
Event-drivenWhen [trigger], the [system] shall [response].When the tank level falls below 20 %, the pump controller shall start the backup pump.
State-drivenWhile [state], the [system] shall [response].While the vehicle is charging, the battery manager shall keep each cell below 45 °C.
Unwanted behaviorIf [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 featureWhere [feature is included], the [system] shall [response].Where a heated windshield is fitted, the climate controller shall clear frost within 5 minutes.
ComplexWhile [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.
  1. Öffnen Sie eine Anforderung im Inspektor oder in der Elementansicht.
  2. 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).

  3. 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.

  4. 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

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

  2. Der Prüfer öffnet Bedarfe & Anforderungen → Genehmigungen.

    Die Seite listet jede Anforderung mit dem Status In Review auf.

  3. 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.

  4. 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

  1. Klicken Sie im Titelblock des Dokuments auf Version ▾.
  2. Wählen Sie Baseline speichern….

    Oder wählen Sie Liefern ▾ → Version ▸ Baseline speichern….

  3. Behalten oder ändern Sie den Name. Der Standard ist "<Dokument> Baseline <n>".
  4. 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.

  5. 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

  1. 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.
  2. Öffnen Sie Bedarfe & Anforderungen → Zu prüfende Verknüpfungen.
  3. Klicken Sie für jede Zeile auf Vergleich, um die Textänderung zu sehen, und prüfen Sie das verknüpfte Element.
  4. 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….

  5. Schreiben Sie, was Sie geprüft haben, und klicken Sie auf Als geprüft markieren.
  6. Führen Sie die Qualitätsprüfung erneut aus.
  7. Schicken Sie die Anforderung erneut durch die Genehmigung.
  8. 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.

  9. Klicken Sie für das Change Board auf Änderungen (Excel).

TBD- und TBR-Punkte schließen

  1. Öffnen Sie Bedarfe & Anforderungen → TBD/TBR.
  2. Lesen Sie die Kacheln: Offene TBD/TBR, Überfällig, Kein Eigentümer und die Anzahl pro Dokument.
  3. Bearbeiten Sie zuerst die überfälligen Zeilen. Sie sind eingefärbt, mit "Überfällig" unter dem Fälligkeitsdatum.
  4. Wo als Verantwortlicher "—" steht, weisen Sie einen TBD Owner zu.
  5. Wenn ein Wert feststeht, ändern Sie den Anforderungstext auf den endgültigen Wert.
  6. 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

  1. Öffnen Sie Bedarfe & Anforderungen → Import und Export.
  2. 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.

  3. Klicken Sie auf Weiter.
  4. Prüfen Sie, worauf jede Spalte abgebildet wird, und setzen Sie Klasse für Zeilen ohne Klasse auf Requirement.
  5. Klicken Sie auf Weiter.
  6. 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.
  7. 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.

  1. Ö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:

  1. Formulieren Sie sie um zu "The spacecraft shall resume imaging within 6 hours of a safe mode entry."
  2. Verknüpfen Sie einen Test Case mit verified by.
  3. 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

SymptomUrsacheBehebung
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:
  • 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:

AbfrageZeigt
class:RequirementAlle Anforderungen.
Requirement:"Status=In Review"Die Liste Genehmigungen.
Requirement:"Status=Draft"Anforderungen, die noch nicht zum Review geschickt wurden.
class:Requirement AND is:leafBlattanforderungen (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:

GruppeFilterBegriff
QualitätGut (≥ 67 %), Überarbeitung nötig (< 67 %), Nicht ausgeführt, Veraltet (Text geändert), Manuelle Bewertungen, KI-Befundquality:good, quality:rework, quality:notrun, quality:stale, quality:manual, quality:ai
Erfüllt ein Kriterium nichtEins je Kriterium: als Nein bewertetquality:Verifiable=no (=yes: als Ja bewertet)
RegelbefundDie im Umfang gefundenen Regeln, etwa R7 Imprecise wording oder R30 Closely resembles (mögliche Duplikate)quality:R7
Struktur, Klasse, Anforderungsattribute, Label, Beziehung, DiagrammWie auf der Seite Anforderungen; die Anforderungsattribute werden ohne Klassenchip aufgeführtis: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

RegelNachrichtAuslöser
R6R6 - 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.
R2R2 - Aktiv formulieren: [...]"shall/must/will/should be" gefolgt von einem Partizip Perfekt ("shall be measured").
R5R5 - Bestimmte Artikel („the“) statt: [...]"a" oder "an".
R7R7 - 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.
R8R8 - 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.
R10R10 - 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.
R16R16 - Verneinung vermeiden: [...]not, n't, never.
R17R17 - 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.
R24R24 - Pronomen statt eindeutiger Substantive: [...]it, its, they, them, their, he, she, him, her, someone, something, anyone, anything, anybody, somebody, this, these, those.
R32R32 - „each“ statt universeller Mengenangabe(n): [...]all, any, both, every, everything, everyone.
R34R34 - 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.
R35R35 - 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

RegelNachrichtAuslöser
—Beschreibung fehlt.Eine leere Beschreibung.
—Name fehlt.Ein leerer Name.
R9R9 - Offene Aufzählung: [...]including but not limited to, etc, and so on, and so forth, such as, among others.

Singulär

RegelNachrichtAuslöser
R18R18 - 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.
R19R19 - 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).
R19R19 - „und/oder“ ist mehrdeutig; geben Sie an, ob beides oder eines gemeint ist: [and/or]"and/or" zwischen Werten oder in einer Bedingung.
R19R19 - 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.
R20R20 - Enthält Zweckangabe(n); in die Begründung verschieben: [...]purpose of, in order to, so that, for the purpose of, so as to.
R21R21 - Enthält Klammern; den Klammertext in die Begründung verschieben."(" oder "[" (auch Klammern voller Breite).

Konform

NachrichtAuslöser
Verwenden Sie ein Modalverb: [need, shall, will, should, must]Keines dieser Wörter kommt vor.

Angemessen

RegelNachrichtAuslöser
R31R31 - Gibt eine Lösung vor: [...]using, by means of, utilizing, utilising, implemented in, implemented with, via a, via the, built with, written in.

Notwendig

RegelNachrichtAuslöser
R30R30 - Ä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

NachrichtAuslö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

RegelNachrichtAuslöser
R26R26 - 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üfersEs wurden keine absoluten Begriffe und keine Beinahe-Duplikate gefunden; eine Person muss entscheiden.

Korrekt

NachrichtAuslöser
Erfordert das Urteil eines PrüfersJede 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:

ArtBeispielErgebnis
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.

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

  2. 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."

  3. 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.

  4. 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ächeWirkung
Alle Wertänderungen auswählenKreuzt jede Wertänderung an, außer bei genehmigten, gesperrten Anforderungen und Anforderungen mit Baseline.
Alle Umformulierungen auswählenKreuzt jede Umformulierung an, außer gekennzeichneten.
Keine auswählenEntfernt 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

ExportInhalt
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ächeAngezeigt, wennWirkung
GenehmigenStatus ist weder Genehmigt noch AbgelehntSetzt Genehmigt und hält Sie und die Uhrzeit fest. Meldung: "Genehmigt".
Ablehnen…Status ist weder Genehmigt noch AbgelehntFragt im Dialog Anforderung ablehnen nach einem Grund (optional) und setzt dann Abgelehnt. Meldung: "Abgelehnt".
Wieder öffnenStatus ist Genehmigt oder AbgelehntSetzt 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.

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.

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.

  • 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 erklärt oben die Regel und zeigt eine Tabelle:

SpalteInhalt
(Kontrollkästchen)Auswahl für Auswahl als geprüft markieren…. Das Kontrollkästchen in der Kopfzeile wählt alle aus.
GeändertDie Anforderung, die sich geändert hat.
ÄnderungDie geänderten Felder, zum Beispiel "Description" oder "Priority, Verification Level".
Wann / VonDatum und Uhrzeit der Änderung und wer sie vorgenommen hat.
BeziehungDer Verknüpfungstyp, gelesen von der geänderten Anforderung aus (zum Beispiel "satisfied by").
Zu prüfendes ElementDas 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:

  1. 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."

  2. Geben Sie einen optionalen Kommentar ein, zum Beispiel "Unterelement weiterhin gültig; keine Änderung nötig."
  3. 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ächeWirkung
Zurück zum AktuellenKehrt zum aktuellen Dokument zurück.
BearbeitenBaseline 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 wiederherstellenDokument-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.

  1. Klicken Sie auf Version ▾ → Versionen vergleichen… oder im Banner einer Baseline auf Mit aktueller Version vergleichen.

    Versionen vergleichen öffnet sich.

  2. Wählen Sie Von: eine Baseline.
  3. 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:

ÄnderungstypBedeutung
Hinzugefügt / EntferntDie Entität kam zum Dokument hinzu oder wurde daraus entfernt.
GeändertEin Feld hat sich geändert: Name, Number, Description, Class, Image oder ein beliebiges Attribut (das Feld wird genannt).
Label hinzugefügt / Label entferntEin Label wurde hinzugefügt oder entfernt.
Beziehung hinzugefügt / Beziehung entferntEine Verknüpfung, die das Dokument berührt, wurde hinzugefügt oder entfernt.
BeziehungsattributDie 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:

  1. 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“".

  2. 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).

OptionWerteWirkung
FormatDie sechs Formate obenZeigt 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-16Wie 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-FeldInhalt
Name, Number, BeschreibungDie eigenen Felder des Elements.
Klasse, LabelsDer Klassenname; Labelnamen getrennt durch ; , oder |.
Übergeordnete Nummer, Global IDDie Nummer des übergeordneten Elements; die ID, mit der vorhandene Entitäten abgeglichen werden.
Ein AttributEin beliebiges Attribut der Klasse für Zeilen ohne Klasse.
Eine BeziehungTrennen 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:

KopfzeileWird zugeordnet zu
Number, No, Num, #, ID Number, Req Number, Requirement NumberNummer
Name, Title, Short Name, Requirement NameName
Description, Text, Requirement, Requirement Text, Statement, DescBeschreibung
Class, Type, Entity ClassKlasse
Labels, Label, TagsLabels (Werte trennen mit ; , oder |)
Parent, Parent NumberÜbergeordnete Nummer
Global ID, ID, GUID, UUIDGlobal 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 IDGlobal ID
Object Number, ReqIF.ChapterName, ReqIF.ForeignIDNummer
Object Heading, ReqIF.Name, Long NameName
Object Text, ReqIF.Text, ReqIF.DescriptionBeschreibung
ReqIF.CategoryKlasse
ReqIF ID, XMI ID, Row ID / Parent IDZeilen-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:

OptionWerteWirkung
Klasse für Zeilen ohne KlasseEine beliebige Klasse; Standard RequirementDie Klasse von Zeilen ohne Wert in der Spalte Class und ohne passende Klassenregel.
KlassenregelnBeschreibung 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 nachGlobal ID, Name, NumberZeilen, 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 nachGlobal ID, Name, NumberWie 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.aWie 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 einErzeugte 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.

  1. Klicken Sie in der Datenbank (oder auf der Seite Anforderungen) auf Exportieren… und wählen Sie Tabelle (CSV).
  2. Kreuzen Sie die zu bearbeitenden Attribute an. Kreuzen Sie unter Einschließen ID an und klicken Sie dann auf Exportieren.
  3. Bearbeiten Sie die Werte in der Tabellenkalkulation. Ändern Sie die Spalte ID nicht.
  4. 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.
  5. 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.

  6. 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

NachrichtBedeutung 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 erneutKonvertieren 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 erneutEntfernen Sie die Deklaration aus der ReqIF- oder XML-Datei.
Die Datei konnte nicht gelesen werden: ungültiges XMLDie ReqIF-Datei ist kein wohlgeformtes XML.
Import fehlgeschlagen: <Grund>Der Import wurde abgebrochen; es wurde nichts geändert.

Tastenkürzel für Anforderungen

TastenWoAction
EnterSchnelleingabe im DokumentDie eingegebene Anforderung hinzufügen.
⌘ / Ctrl+Enter / ⌥ / Alt+⌘ / Ctrl+EnterDokument, Element ausgewähltEin Geschwister / ein Unterelement hinzufügen.
Enter oder SpaceZeilen von Qualität, TBD/TBR und Zu prüfende VerknüpfungenDie Anforderung oder das zu prüfende Element der Zeile im Inspektor anzeigen.
↑ / ↓Dieselben Zeilen, Zeile fokussiertZur vorherigen oder nächsten Zeile wechseln.
⌘ / Ctrl-Klick, ⇧ / Shift-Klick, ⌘ / Ctrl+⇧ / Shift-KlickZeilen von Qualität, TBD/TBR und Zu prüfende Verknüpfungen; Datenbankzeilen; DokumentelementeEine Zeile umschalten, den Bereich ab der zuletzt angeklickten Zeile auswählen, diesen Bereich hinzufügen.
⌘A / Ctrl+A, ⇧ / Shift+↑ / ⇧ / Shift+↓Dieselben Zeilen, Zeile fokussiertJede angezeigte Zeile auswählen; die Auswahl ab der fokussierten Zeile erweitern.
Rechtsklick, Shift+F10 oder die MenütasteZeilen von Anforderungen, Qualität, TBD/TBR und Zu prüfende Verknüpfungen; Dokumentelemente und GliederungseinträgeDas Menü der Zeile öffnen: zuerst vorgeschlagene Aktionen mit ihren Gründen und ✦ Weitere KI ▸, dann die Befehle des Elements.
EscQualität, TBD/TBR, Zu prüfende Verknüpfungen, RVTMDie Auswahl der Zeile aufheben.
EnterNamensfeld unter Baselines & VersionenDie Projekt-Baseline erstellen.
⌘Z / Ctrl+ZÜberallDie 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

EinstellungWoStandardUmfang
Automatisch erneut prüfen, wenn sich der Text ändertBereichsleiste der Seite QualitätAusDieser 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 LinksQualität eingeklappt, der Rest geöffnetDieser Browser, pro Klasse
Ihr Name bei Genehmigungen, Entscheidungen und KommentarenIhr Kontoname—Konto
Nachverfolgungsstatus (Punkte an Anforderungen)Dokument Ansicht ▾AnDokument

Meldungen

NachrichtWoBedeutung
N Anforderungen geprüftQualitätDie Prüfung lief über den Umfang.
Keine Anforderungen in diesem Umfang.QualitätDer 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ührenQualität, Dokumente, InspektorDer Text hat sich nach der letzten Prüfung geändert.
Erfordert das Urteil eines PrüfersQualität (Correct, Feasible)Eine Person muss entscheiden; klicken Sie auf ✘, um es als Ja zu markieren.
Manuell als Nein markiert.QualitätEin 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 BearbeitungDie Bearbeitung hat Genehmigungen wieder geöffnet und Verknüpfungen zur Prüfung markiert.
Genehmigt / Abgelehnt / Zu In Review verschobenGenehmigungsfeldDie Entscheidung wurde festgehalten.
N Verknüpfungen als geprüft markiert.Zu prüfende VerknüpfungenDie Reviews wurden festgehalten.
Zuerst die Verknüpfungen auswählen, die als geprüft markiert werden sollen.Zu prüfende VerknüpfungenKreuzen Sie Zeilen an, bevor Sie Auswahl als geprüft markieren… wählen.
Geschlossen / Attribut geschlossen; der Text enthält noch TBD.TBD/TBRDas Attribut wurde auf None gesetzt.
Der Text enthält noch TBD. Bearbeiten Sie den Text, um es zu schließen.TBD/TBRWird beim Schließen eines Punkts angezeigt, der nur aus dem Text stammt.
Baseline gespeichertDokumente, Baselines & VersionenDie Momentaufnahme wurde gespeichert.
Dieses Dokument hat keine Baseline. Zuerst eine speichern.Mit aktueller Version vergleichen, ÄnderungsberichteDas Dokument hat keine Baseline.
Auf „<Name>“ zurückgesetzt / „<Name>“ wiederhergestelltBaselinesDas 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üfungKeine 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).