So schreiben Sie eine Software-Anforderungsspezifikation (SRS-Dokument)

Klare Anforderungen helfen Entwicklungsteams, das richtige Produkt zu erstellen. Und eine Software-Anforderungsspezifikation (SRS) hilft Ihnen, die Grundlagen für die Produktentwicklung zu schaffen.

Wir definieren, was das ist, wann Sie ein solches Dokument verwenden und wie Sie in fünf Schritten ein SRS-Dokument schreiben.

Auf einen Blick, so schreiben Sie ein Anforderungsdokument:

  • Definieren Sie den Zweck Ihres Produkts.
  • Beschreiben Sie, was Sie bauen.
  • Detaillieren Sie die Anforderungen.
  • Genehmigung einholen.

Was ist eine Software-Anforderungsspezifikation (SRS)?

Eine Software-Anforderungsspezifikation (SRS) ist ein Dokument, das beschreibt, was die Software tun wird und wie sie funktionieren soll. Es beschreibt auch die Funktionalität, die das Produkt benötigt, um die Anforderungen aller Beteiligten (Unternehmen, Benutzer) zu erfüllen.

Eine typische SRS umfasst:

  • Einen Zweck
  • Eine allgemeine Beschreibung
  • Spezifische Anforderungen

Die besten SRS-Dokumente definieren, wie die Software interagieren wird, wenn sie in Hardware eingebettet ist – oder wenn sie mit anderer Software verbunden ist. Gute SRS-Dokumente berücksichtigen auch die realen Anwender.

Warum ein SRS-Dokument?

Ein Software-Pflichtenheft ist die Grundlage für Ihr gesamtes Projekt. Es legt den Rahmen fest, an dem sich jedes an der Entwicklung beteiligte Team orientiert.

Es wird verwendet, um mehreren Teams – Entwicklung, Qualitätssicherung, Betrieb und Wartung – wichtige Informationen zur Verfügung zu stellen. So bleiben alle auf dem gleichen Stand.

Die Verwendung des SRS hilft sicherzustellen, dass die Anforderungen erfüllt werden. Und es kann Ihnen auch helfen, Entscheidungen über den Lebenszyklus Ihres Produkts zu treffen – zum Beispiel, wann ein Feature ausgemustert werden soll.

Das Schreiben einer SRS kann auch die gesamte Entwicklungszeit und die Kosten minimieren. Eingebettete Entwicklungsteams profitieren besonders vom Einsatz einer SRS.

Software Requirements Specification vs. System Requirements Specification

Eine Software Requirements Specification (SRS) enthält detaillierte Beschreibungen der zu entwickelnden Software.

Eine System Requirements Specification (SyRS) sammelt Informationen über die Anforderungen an ein System.

„Software“ und „System“ werden manchmal austauschbar als SRS verwendet. Eine Software-Anforderungsspezifikation enthält jedoch mehr Details als eine System-Anforderungsspezifikation.

>> Müssen Sie die Compliance nachweisen? So erstellen Sie eine Rückverfolgbarkeitsmatrix >>

Wie man ein SRS-Dokument schreibt

Ein SRS-Dokument zu schreiben ist wichtig. Aber es ist nicht immer einfach.

Hier sind fünf Schritte, die Sie befolgen können, um ein effektives SRS-Dokument zu schreiben.

Erstellen Sie eine Gliederung (oder verwenden Sie eine SRS-Vorlage)

Ihr erster Schritt besteht darin, eine Gliederung für Ihr Software-Pflichtenheft zu erstellen. Dies kann etwas sein, das Sie selbst erstellen. Oder Sie verwenden eine vorhandene SRS-Vorlage.

Wenn Sie diese selbst erstellen, könnte Ihre Gliederung wie folgt aussehen:

1. Einleitung

1.1 Zweck

1.2 Zielpublikum

1.3 Verwendungszweck

1.4 Umfang

1.5 Definitionen und Akronyme

2. Gesamtbeschreibung

2.1 Benutzerbedürfnisse

2.2 Annahmen und Abhängigkeiten

3. Systemfunktionen und Anforderungen

3.1 Funktionale Anforderungen

3.2 Anforderungen an externe Schnittstellen

3.3 Systemfunktionen

3.4 Nichtfunktionale Anforderungen

Wenn Sie Ihre Grundskizze haben, können Sie anfangen, sie auszufüllen.

Laden Sie sich ein White Paper zu Best Practices für das Schreiben von Anforderungen herunter >>

Beginnen Sie mit einem Zweck

Die Einleitung Ihrer SRS ist sehr wichtig. Sie legt die Erwartung an das Produkt fest, das Sie erstellen.

Beginnen Sie also damit, den Zweck Ihres Produkts zu definieren.

Zielpublikum und Verwendungszweck

Bestimmen Sie, wer in Ihrer Organisation Zugang zum SRS haben wird – und wie er es verwenden soll. Dazu können Entwickler, Tester und Projektmanager gehören. Es könnte auch Stakeholder in anderen Abteilungen umfassen, einschließlich Führungsteams, Vertrieb und Marketing.

Produktumfang

Beschreiben Sie die zu spezifizierende Software. Dazu gehören der Nutzen, die Zielsetzung und die Ziele. Dies sollte sich auf die allgemeinen Unternehmensziele beziehen, insbesondere wenn Teams außerhalb der Entwicklung Zugriff auf das SRS haben werden.

Definitionen und Akronyme

Es ist sinnvoll, eine Risikodefinition aufzunehmen. Das Vermeiden von Risiken steht für viele Entwickler an erster Stelle – besonders für diejenigen, die in sicherheitskritischen Entwicklungsteams arbeiten.

Hier ein Beispiel. Wenn Sie ein medizinisches Gerät entwickeln, könnte das Risiko sein, dass das Gerät ausfällt und einen Todesfall verursacht.

Indem Sie dieses Risiko im Voraus definieren, ist es einfacher, die spezifischen Anforderungen zu bestimmen, die Sie benötigen, um es zu minimieren.

>> Sie müssen ein PRD erstellen? Hier ist eine Anleitung mit Beispielen >>

Geben Sie einen Überblick darüber, was Sie bauen werden

Ihr nächster Schritt ist eine Beschreibung dessen, was Sie bauen werden. Handelt es sich um ein Update für ein bestehendes Produkt? Ist es ein neues Produkt? Ist es ein Zusatz zu einem Produkt, das Sie bereits erstellt haben?

Dies ist wichtig, damit jeder weiß, was Sie bauen.

Sie sollten auch beschreiben, warum Sie es bauen und für wen es gedacht ist.

Bedürfnisse der Benutzer

Die Bedürfnisse der Benutzer – oder Benutzerklassen und Eigenschaften – sind entscheidend. Sie müssen definieren, wer das Produkt benutzen wird und wie.

Sie werden primäre und sekundäre Benutzer haben, die das Produkt regelmäßig nutzen werden. Möglicherweise müssen Sie auch die Bedürfnisse eines separaten Käufers des Produkts definieren (der vielleicht kein primärer/sekundärer Benutzer ist). Und wenn Sie zum Beispiel ein medizinisches Gerät bauen, müssen Sie die Bedürfnisse des Patienten beschreiben.

Annahmen und Abhängigkeiten

Es kann Faktoren geben, die sich auf Ihre Fähigkeit auswirken, die in Ihrer SRS dargestellten Anforderungen zu erfüllen. Was sind diese Faktoren?

Gibt es irgendwelche Annahmen, die Sie mit der SRS treffen, die sich als falsch herausstellen könnten? Auch diese sollten Sie hier aufführen.

Schließlich sollten Sie vermerken, ob Ihr Projekt von irgendwelchen externen Faktoren abhängig ist. Dazu könnten Software-Komponenten gehören, die Sie von einem anderen Projekt wiederverwenden.

Detaillieren Sie Ihre spezifischen Anforderungen

Der nächste Abschnitt ist wichtig für Ihr Entwicklungsteam. Hier beschreiben Sie die spezifischen Anforderungen für den Aufbau Ihres Produkts.

Funktionale Anforderungen

Funktionale Anforderungen sind essentiell für den Aufbau Ihres Produkts.

Wenn Sie ein medizinisches Gerät entwickeln, können diese Anforderungen Infusionen und Batterien beinhalten. Und innerhalb dieser funktionalen Anforderungen können Sie eine Untergruppe von Risiken und Anforderungen haben.

Anforderungen an externe Schnittstellen

Anforderungen an externe Schnittstellen sind eine Art von funktionalen Anforderungen. Sie sind wichtig für eingebettete Systeme. Sie umreißen, wie Ihr Produkt mit anderen Komponenten zusammenarbeitet.

Es gibt verschiedene Arten von Schnittstellen, für die Sie Anforderungen haben können, einschließlich:

  • Benutzer
  • Hardware
  • Software
  • Kommunikation

Systemfunktionen

Systemfunktionen sind Arten von funktionalen Anforderungen. Es handelt sich um Merkmale, die erforderlich sind, damit ein System funktionieren kann.

Andere nicht-funktionale Anforderungen

Nicht-funktionale Anforderungen können genauso wichtig sein wie funktionale Anforderungen.

Dazu gehören:

  • Leistung
  • Sicherheit
  • Sicherheit
  • Qualität

Die Bedeutung dieser Art von Anforderungen kann je nach Branche variieren. Sicherheitsanforderungen sind beispielsweise in der Medizingeräteindustrie von entscheidender Bedeutung.

DieIEEE bietet auch einen Leitfaden für das Schreiben von Software-Anforderungsspezifikationen, wenn Sie Mitglied sind.

Genehmigung für die SRS einholen

Nachdem Sie die SRS fertiggestellt haben, müssen Sie sie von den wichtigsten Beteiligten genehmigen lassen. Und jeder sollte die neueste Version des Dokuments überprüfen.

Schreiben einer SRS in Microsoft Word vs. Anforderungssoftware

Sie können Ihre Software-Anforderungsspezifikation in Microsoft Word schreiben. Eine clevere Methode ist es, eine SRS-Vorlage zu erstellen, die Sie als Ausgangspunkt für jedes Projekt verwenden können.

Aber selbst mit einer Vorlage kann das Schreiben einer SRS auf diese Weise ein mühsamer Prozess sein. Und wenn sich eine Anforderung ändert, kann Ihre SRS leicht veraltet sein. Außerdem kann es bei Anforderungsdokumenten in Word Probleme mit der Versionierung geben.

Sie können Zeit sparen – und Genauigkeit gewährleisten -, wenn Sie stattdessen eine SRS in Helix ALM schreiben.

Warum Helix ALM besser ist…

Helix ALM (das mit einem dedizierten Anforderungsmanagement-Tool geliefert wird) steigert die Effizienz Ihres gesamten Anforderungsmanagementprozesses.

Durch die Erstellung einer SRS in Helix ALM stellen Sie sicher, dass Ihre SRS aus einer Hand stammt. Es wird einfacher sein, Anforderungsüberprüfungen Ihrer SRS durchzuführen. Und das wird Ihnen helfen, schnellere Genehmigungen zu erhalten – damit Ihre Entwickler loslegen können.

Sobald Sie Anforderungen in einer SRS haben, können Sie diese während des gesamten Entwicklungsprozesses einfach verwalten.

Wenn Sie auch ein PRD schreiben, können Sie diese Feature-Anforderungen mit den High-Level-Anforderungen im SRS verknüpfen. Dies schafft Nachvollziehbarkeit über Ihren Anforderungsprozess hinweg.

Sie können die Anforderungen in Ihrer SRS auch mit Tests verknüpfen. So stellen Sie sicher, dass das Produkt, das Sie ausliefern, den Zweck und die Anforderungen Ihrer SRS erfüllt.

Sehen Sie selbst, wie einfach es sein kann, eine SRS zu schreiben. Testen Sie Helix ALM kostenlos – und sehen Sie, wie eine effektive SRS Ihren Entwicklungsprozess verbessern wird. Sie können sich auch unsere Demo ansehen, um mehr Funktionalität zu sehen.

Sparen Sie Zeit beim Schreiben einer SRS in Helix ALM ▶️ sehen Sie sich zuerst die Demo an

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert.