Lasten- und Pflichtenhefte für IT-Projekte

Transkript

1 Lasten- und Pflichtenhefte für IT-Projekte Nutzen und inhaltliche Gestaltung doctima GmbH Johannes Dreikorn

2 Agenda Das Wichtigste in sieben Fragen Wovon reden wir eigentlich? Warum lohnt sich das? Was muss geklärt sein? Was muss rein, in welcher Struktur, mit welcher Darstellung? Wie verwalten Sie Ihre Dokumente? und das Fazit. Seite 4

3 Zur Person Johannes Dreikorn Redaktionsleiter bei doctima/fürth (Dienstleistungsunternehmen für Technische Kommunikation) Schwerpunkte: Beratung, Coaching, Standardisierung, Textkonzeption, Prozessoptimierung Fachlicher Hintergrund: Diplomierter Sprachwissenschaftler, Journalismus, 15 Jahre Branchenerfahrung in IT-Projekten & Geräte/Maschinen/Anlagenbau doctima GmbH Angebot: Technische Dokumentation; Kunden- und Servicekommunikation; Seminare & Schulungen Branchen Industrie: IT, Medizintechnik, Maschinenbau; Institutionen: Banken, Krankenkassen, Versicherungen Seite 2

4 Wovon reden wir eigentlich? Kurze Begriffsklärung Seite 5

5 Dokumente Lastenheft Was? Wofür? Auftraggeber Requirement Anforderung arroyo outdoor Feature Lösung Was? Womit? Auftragnehmer digital pioneers Pflichtenheft Seite 6

6 Definitionen nach DIN Lastenheft Vom Auftraggeber festgelegte Gesamtheit der Forderungen an die Lieferungen und Leistungen eines Auftragnehmers innerhalb eines Auftrags. Pflichtenheft Vom Auftragnehmer erarbeitete Realisierungsvorgaben aufgrund der Umsetzung des vom Auftraggeber vorgegebenen Lastenheftes. Seite 7

7 Warum lohnt sich das? Nutzenaspekte Seite 8

8 Nutzenaspekte Lastenheft Pflichtenheft AG Zwang zur Konkretisierung bei Entwicklungsvorhaben (neue Erkenntnisse durch Versprachlichung von Ideen) Matrix zur Auswahl von Entwicklungspartnern (Ausschreibungen) Rechtssicherheit Imageaspekt (Nachweis von Professionalität) fachliche Spiegelung eines Entwicklungsvorhabens (Sicherheit zu realistisch erreichbaren Entwicklungsergebnissen) Know-how-Gewinn durch lösungsbezogene Strukturierung Einblick in Leistungsfähigkeit des AN AN Klarheit über Bedürfnisse des Kunden (Lastenheft = Festlegung) Einblick in Strukturiertheit und Professionalität des Kunden Plattform zum Nachweis von Kompetenz und Leistungsfähigkeit (Marketingfunktion) teilweise einzige Möglichkeit, um Entwicklungsvorhaben zu akquirieren (Ausschreibungen). Vorlage für weitere Entwicklungs-schritte (je besser das Pflichtenheft, desto leichter die Umsetzung) Einnahmequelle Rechtssicherheit Seite 10

9 Was muss geklärt sein? Bedingungen, dass das Dokument überhaupt funktionieren kann Seite 11

10 Das muss geklärt sein Fragen, die das beste Dokument nicht beantworten kann: Wissen Sie, was Sie inhaltlich wollen? Requirements-Engineering findet zu einem großen Teil außerhalb des Dokuments statt. Das Lasten/Pflichtenheft ist streng genommen nur das Ergebnis davon. Wie ist die Rollenverteilung zwischen Auftraggeber und Auftragnehmer? Von wem kommt die eigentliche Engineering-Leistung? Gibt es eine solide kaufmännisch-vertragliche Einbettung? Ein Lastenheft oder Pflichtenheft ist kein Vertrag, sondern (hoffentlich) Vertragsbestandteil. Was wollen Sie strategisch? Manchmal kommt man nur weiter, wenn man einfach loslegt Seite 12

11 Was muss rein? Inhalte von Lasten- und Pflichtenheften Seite 13

12 Hintergrund Spezifikations-Pyramide Level 1 Level 2 Pflicht Last Level 3 Level 4 Level 5 Seite 14

13 Inhalte Der große Rahmen: Was muss für ein Produkt und Projekt alles geregelt werden? Checkliste Stellgrößen Bei wem (AG/AN) liegt die Engineering-Leistung? Was möchte man aus seiner Rolle heraus (AG/AN) festlegen? Was aus einem LH/PH ein echtes Dokument macht Seite 15

14 in welcher Struktur? Gliederung Seite 16

15 Mustergliederung (IEEE) Quelle: Seite 17

16 Gliederung: Beispiele Seite 18

17 Wichtige Frage: Mit oder ohne IDs Seite 19

18 mit welcher Darstellung? Die ganzen Details in Prosa, als Grafik oder als Modell Seite 20

19 Die Qual der Wahl Die Detail-Informationen in natürlicher Sprache (Prosa) in Form von Abbildungen in modellbasierter Form Ablaufdiagramm Seite 21

20 So bitte nicht: Entwickler-Prosa Ausdrücklich nicht empfohlen! Quelle: Musterlastenheft zum V-Modell XT ( Seite 22

21 Wie verwalten Sie Ihre Dokumente? Word, Excel oder ein Expertensystem Seite 25

22 Texteditoren Programm Eigenschaften Microsoft Word Auch bei Lasten- und Pflichtenheften das am meisten verwendete Tool. Vorteile: hohe Verbreitung, wenig Anwendungsprobleme bei Basisfunktionen, viele sinnvolle Automatisierungsfunktionen Achtung: Manche Funktionen bereiten hartnäckig Probleme (nummerierte Listen); die Kompatibilität zwischen Programmversionen ist teilweise sehr eingeschränkt. Open Office Freeware-Konkurrent zu Microsoft Word Writer weitestgehend funktionsgleich FrameMaker Nischenprodukt aus der Technischen Dokumentation Wer das Tool besitzt, kann es für Lasten- und Pflichtenhefte problemlos mitverwenden. Wer es nicht hat: hohe Lizenzkosten bei geringer Verbreitung Praxis-Tipp Wenn Sie Ihre Dokumente als Dateien weitergeben (müssen): Wandeln Sie die editierbare Quelldatei (z. B. Word-Datei) in ein PDF-Dokument um. Geben Sie diese Datei weiter, nicht die Quelldatei. Seite 26

23 Experten-Software für RE Programm DOORS Polarion REQUIREMENTS RequisitePro RTM Hersteller Telelogic Polarion IBM Serena Seite 27

24 Fazit Zusammengefasst & zugespitzt Seite 28

25 Fazit (1) Trotz (teilweise) anerkannter Standards: Lasten- und Pflichtenhefte sind hochgradig (unternehmens-)individuelle Dokumente. Es lohnt sich diese Dokumente gezielt (als Team) zu konzipieren, Als Entwickler-Team gemeinsam ein Dokument entwickeln. mit Augenmaß zu standardisieren, Die eigentliche Schreibarbeit ist dann nicht mehr das Problem. Und man kann sich auf das konzentrieren, was außerhalb des Dokuments passieren muss. Seite 29

26 Fazit (2) Ein Dokument funktioniert dann gut, wenn es leicht zu erstellen ist, Auch in Etappen und von Mehreren gleichzeitig gut zu überarbeiten ist, Interessant: Auch Dokumente haben eine "Wartbarkeit" inhaltlich vollständig und korrekt und prüfbar ist, leicht zu lesen und zu verstehen ist, Das hat auch mit den Zielgruppen zu tun! den Arbeitsprozess optimal unterstützt. Mit inhaltlicher Korrektheit alleine ist nichts gewonnen! Ein Lasten- und Pflichtenheft, das so gestaltet ist, leistet automatisch den höchst Möglichen Beitrag zum Aspekt Rechtssicherheit. Seite 30

27 Literatur Seite 31

28 Literatur Fachbücher (Vorsicht! Sehr akademisch ) Pohl, Klaus (2008): Requirements Engineering Rupp, Chris und Sophisten, die (2007): Requirements-Engineering und Management Praxisliteratur VDA (2007): Automotive VDA Component Requirement- Specification Standard Structure. Fachartikel Dreikorn, Johannes (2008): Pflichtenhefte professionell getextet ein Gewinn für alle. Erschienen in: ProductGlobal 05/2008, S Kösler, Bertram (2009): Lasten- und Pflichtenhefte. Erschienen in: Arbeits- und Gestaltungsempfehlungen für Technische Dokumentation. Eine kritische Bestandsaufnahme. Schmidt/Römhild, S Seite 32

29 Literatur (2) stefan-baur.de: Rubrik "Informatik Software-Engineering" (zitiert als BAUR, Stand: 05/2013) Wikipedia: Beitrag "Lastenheft" Wikipedia: Beitrag "Pflichtenheft" Seite 33

30 Johannes Dreikorn doctima GmbH Melli-Beese-Str. 19 D Fürth Tel.: Fax: johannes.dreikorn@doctima.de Seite 34