Requirements Management

Transkript

1 Requirements Management Mit Requirements Management zur Erfüllung von Anforderungen aus Normen und Richtlinien Workshop tekom Jahrestagung 2015, Stuttgart Schmeling + Consultants GmbH Heidelberg Telefon +49 (0) / Tilo Ried t.ried@schmeling-consultants.de

2 Requirements Management Anforderungen aus Normen und Richtlinien verwalten Inhalte im Workshop Anforderungsmanagement Aufgabenstellung Lösungen Checkliste implementieren anwenden Organisatorische Aspekte Aufgaben bearbeiten Aufgaben 2

3 festlegen analysieren bewerten Aufgabenstellung Technische Dokumentation konform zu Normen und Richtlinien erstellen Produkt Normen und Richtlinien Checkliste/ Prüfung Technische Dokumentation 3

4 Aufgabenstellung Anforderungen aus Normen und Richtlinien verstehen Gesetze Normen Europäische Richtlinien + nationale Umsetzung 2006/42/EG Maschinenrichtlinie + 9. Verordnung zum Produktsicherheitsgesetz (9. ProdSV) verpflichtend Harmonisierte Norm (EG beauftragt CEN/CENEL/ETSI) Nationale (DIN/ANSI)/internationale (IEC/ISO) Normungsgremien DIN EN , ANSI Z535.6 freiwillig Unternehmensstandards Interne Konstruktionsvorgaben Vertrags- und Liefervorschriften intern verpflichtend/freiwillig 4

5 analysieren Aufgabenstellung Projektbeispiel aus der Praxis Vier Anforderungsdokumente ~ Anforderungen DIN EN ANSI Z /42/EC VGB-R 171 5

6 Lösungen Requirements Management Requirements Management als Methodensammlung Aufgaben für Requirements Management Entwicklung komplexer (Software)-Produkte und Systeme sehr viele Anforderungen verwalten häufige Änderungen verwalten wesentlichen Testaufwand organisieren Gleiches Verständnis zwischen Auftraggeber und Entwickler sicherstellen Eindeutige und vollständige Anforderungsdokumentation sicherstellen 6

7 Lösungen Requirements Management Requirements Management als Methodensammlung Aspekte des Requirements Managements Grundlegende Methode für Softwareentwicklungsmodelle (CMMI, Spice, etc.) Konsistenter Prozessablauf für Erstellen, Anpassen und Erweitern der Anforderungen notwendig Sprachlich, grafisch, halbformal möglich Für ReqIF (Requirements Interchange Format) XML-Schema verfügbar 7

8 Lösungen Anforderungen sprachlich dokumentieren Eindeutigkeit/Suchbarkeit sicherstellen Metadaten Um welche Anforderung handelt es sich? Anforderung klar benennen (Kurzbezeichnung) Informationen über den Schalldruck, Informationen zum Starten, Stoppen, Sicherheitsfunktionen, etc.) Voraussetzung für schnelles finden vorhandener Anforderungen Anforderung detailliert genug beschreiben Einrichtungen, die ein automatisches Anlaufen von bewegten Teilen verhindern, müssen in der Betriebsanleitung beschrieben werden. Notwendige Spezialwerkzeuge für den Handbetrieb müssen erklärt werden 8

9 Lösungen Anforderungen sprachlich dokumentieren Eindeutigkeit/Suchbarkeit sicherstellen Metadaten Um welche Anforderung handelt es sich? Anforderungen eineindeutig nummerieren Sprechende Nummer vs. fortlaufende Nummer Anforderungen klassifizieren Formale Anforderung (geforderte Nachweise etc.) Anforderungen an Layout (Schriftgröße, Farben etc.) Bezug zu geforderten Gegenständen (Persönliche Schutzausrüstung, Sicherheitseinrichtung etc.) Lebensphase (Montage, Transport, Betrieb etc.) 9

10 Lösungen Anforderungen sprachlich dokumentieren Eindeutigkeit/Suchbarkeit sicherstellen Metadaten Weitere mögliche/sinnvolle Metadaten für Anforderungen Autor Eigentümer Erfassungs-/Änderungsdatum Status (Vereinbarung/Bearbeitungsstand/Überarbeitungsstand) Priorität Gewichtung Erfüllungsgrad (voll, teilweise, nicht) Anwendbarkeit (muss, kann, nicht anwendbar) Im Widerspruch (zu Anforderung XY, Bsp. Warnhinweise, d. h. Inkonsistenz) In Abhängigkeit (mit Anforderung XY) 10

11 Lösungen Anforderungen sprachlich dokumentieren Überprüfbarkeit sicherstellen Wird die Anforderung (wirklich) eingehalten? Überprüfbare Anforderungen spezifizieren Keine weichen Anforderungen definieren Inhaltsverzeichnis Falls die Betriebsanleitung umfangreich ist, sollte ein Inhaltsverzeichnis verwendet werden DIN EN ISO f eigene Ergänzung notwendig: falls über 20 Seiten Detailanforderungen zur Überprüfung können ausgelagert werden Bspw. detaillierte Anforderungen an Layout und Gestaltung in eigener Tabelle zusammenfassen 11

12 Lösungen Anforderungen sprachlich dokumentieren Konsistent granulieren Wird nur eine Forderung pro Anforderung beschrieben? Kombiniert beschriebene Anforderungen erschweren Überprüfung Die Betriebsanleitung muss Angaben zur Montage, zur Wartung und zur Außerbetriebnahme enthalten Zerlegung in Einzelanforderungen ist Grundlage für Überprüfbarkeit muss Angaben zur Montage enthalten muss Angaben zur Wartung enthalten muss Angaben zur Außerbetriebnahme enthalten 12

13 Lösungen Anforderungen sprachlich dokumentieren Konsistent formulieren Anforderungen sind Forderungen an die Eigenschaften Technischer Dokumentation geforderte Inhalte notwendige Form (Layout) Erstellungsprozess notwendige Sprachen bezüglich Einschränkungen (selten) Instructions for use shall be given not only on the packaging (IEC , 4.7.2) Schlüsselwörter muss, soll, kann Weiche Adjektive konsequent vermeiden schön, gut, einfach, problemlos, schnell Ausgleich schlechter Formulierungen in Normen/Standards kann notwendig sein (Eigeninitiative gefragt) 13

14 Lösungen Anforderungen sprachlich dokumentieren Konsistent formulieren Formulierungsmuster verwenden Die Betriebsanleitung berücksichtigt <...>. Beispiel: Die Betriebsanleitung berücksichtigt die Zielgruppe hinsichtlich Wortwahl und Gestaltung. Die Betriebsanleitung enthält Angaben zu <...>. Beispiel: Die Betriebsanleitung enthält Angaben zu Firmenname und zur vollständigen Anschrift des Herstellers oder Bevollmächtigten. Die Betriebsanleitung enthält Angaben zu <...>, wenn <...>. Beispiel: Die Betriebsanleitung enthält Angaben zur Strahlung, wenn die Maschine nicht ionisierende Strahlung abgibt und dadurch insbesondere Träger aktiver oder nicht aktiver implantierbarer medizinischer Geräte schädigen kann. Alternativ: Kurzformen verwenden, aber Verständlichkeit erschwert 14

15 Lösungen Checkliste implementieren Datenmodell in Excel Beschreibung Anwendbarkeit Kurzbezeichnung Quelle Kapitel operating 1 :: 4 Legend x = To be considered in accordance to the specific standard/regulation o = Consideration reasonable - = Must not 15

16 Lösungen Checkliste implementieren Datenmodell Excel Filter nutzen Filter für Quelle Punkt stellt vollständige Anzeige sicher 16

17 Mähwerke - angebaut Mähwerke - angehängt Erntevorsätze Großpackenpressen Kreiselzettwender/Schwader Rundballenpressen Feldhäcksler - selbstfahrend Mähwerk - selbstfahrende Transportwagen Lösungen Checkliste implementieren Klassifikation von Anforderungen nach Produktspektrum Referenz Nachweis ist relevant für 2006/42/EG x x x x x x x x x DIN EN ISO d x x x x x x x x x DIN EN ISO x x x x x x x x x DIN EN ISO x DIN EN ISO x x x x x x x x 17

18 Lösungen Checkliste implementieren Datenbank sinnvoll aber aufwändiger 18

19 Lösungen Checkliste anwenden Bewertung des Erfüllungsgrades (je Dokument/je Dokumenttyp) * = Fragebogen im ersten Schritt konfigurieren 2 = voll erfüllt 1 = zum Teil erfüllt 0 = nicht erfüllt n. a. = nicht anwendbar*? = Prüfung unklar 19

20 Lösungen Organisatorische Aspekte Erstellen einer Checkliste 1. Nach (sicherheitsrelevanten) Normen und Richtlinien suchen Ansprechpartner im Unternehmen identifizieren Normenstelle, Rechtsabteilung, Entwicklung/Konstruktion, etc. Normenrecherche selbst durchführen Fachnormen für TD: erfolgsversprechend (2006/42/EG, DIN EN , ANSI Z535.6, VGB-R 171 etc.) Konstruktionsnormen: nicht erfolgsversprechend Liste der Normen und Richtlinien erstellen TD nicht verantwortlich 20

21 Lösungen Organisatorische Aspekte Erstellen einer Checkliste 2. Relevanz für TD bewerten Inhaltsverzeichnis der Norm prüfen DIN EN 474-2: Kapitel 6, Benutzerinformationen (PDF-)Dokument mit Liste von Begriffen durchsuchen Betriebsanleitung, Informationen zur Bedienung, Warn- /Sicherheitshinweis, etc. Relevanz festlegen Liste ergänzen relevant für TD? 21

22 Lösungen Organisatorische Aspekte Erstellen einer Checkliste 3. Anforderungen extrahieren 1. Inhaltsverzeichnis nach relevanten Kapitel durchsuchen 2. Gegenprobe mit Liste von Suchbegriffen durchführen (Strg-f) Anforderungen können in inhaltsfremden Kapiteln versteckt sein 3. Relevante Bereiche Absatz für Absatz durcharbeiten 4. Anforderungen qualifizieren (was wird gefordert?) 5. Vorhandene Checkliste nach ähnlichen Anforderungen durchsuchen 6. Neue Anforderung entsprechend Datenmodell dokumentieren ODER Quelle für vorhandene/passende Anforderung ergänzen 7. go_to 3 22

23 Lösungen Organisatorische Aspekte Prozesse und Verantwortung regeln Checkliste erstellen Wer ist für die Erstellung der Checkliste verantwortlich? Wer ist für die Vollständigkeit der Normen-/Richtlinienliste verantwortlich? Checkliste verwalten Wer ist für Aktualisierung/Erweiterung der Checkliste verantwortlich? Wann wird Aktualität und Vollständigkeit der Checkliste geprüft? Checkliste anwenden Wann wird die TD gegen die Checkliste geprüft? In welcher Stichprobengröße wird die TD geprüft? Wer ist für die regelmäßige Anwendung verantwortlich? Wie werden die Ergebnisse der Prüfung genutzt? Wer ist für die Umsetzung der Maßnahmen verantwortlich? 23

24 Requirements Management Anforderungen aus Normen und Richtlinien verwalten Praktische Aufgaben... 24

25 Requirements Management Anforderungen aus Normen und Richtlinien verwalten Vielen Dank für Ihr Engagement! 25