25.06.2002c) peter cramer 20021 projektdokumentation teil 2 fachhochschule dortmund seminar...
TRANSCRIPT
![Page 1: 25.06.2002c) Peter Cramer 20021 Projektdokumentation Teil 2 Fachhochschule Dortmund Seminar IT-Consulting Sommersemester 2002 Peter Cramer](https://reader036.vdokument.com/reader036/viewer/2022062404/55204d6149795902118b46fb/html5/thumbnails/1.jpg)
25.06.2002 c) Peter Cramer 2002 1
Projektdokumentation Teil 2
Fachhochschule Dortmund
Seminar IT-Consulting
Sommersemester 2002
Peter Cramer
![Page 2: 25.06.2002c) Peter Cramer 20021 Projektdokumentation Teil 2 Fachhochschule Dortmund Seminar IT-Consulting Sommersemester 2002 Peter Cramer](https://reader036.vdokument.com/reader036/viewer/2022062404/55204d6149795902118b46fb/html5/thumbnails/2.jpg)
25.06.2002 c) Peter Cramer 2002 2
Projektdokumentation
I Benutzerdokumentation
- formale Gestaltung
- inhaltliche Gestaltung
II Systemdokumentation / Testdokumentation
III Wartungsdokumentation
![Page 3: 25.06.2002c) Peter Cramer 20021 Projektdokumentation Teil 2 Fachhochschule Dortmund Seminar IT-Consulting Sommersemester 2002 Peter Cramer](https://reader036.vdokument.com/reader036/viewer/2022062404/55204d6149795902118b46fb/html5/thumbnails/3.jpg)
25.06.2002 c) Peter Cramer 2002 3
Benutzerdokumentation / Formale Kriterien
• Vollständigkeit
- Installationsbeschreibung
- Beschreibung der Programm-Funktionalitäten
- Fehlerbehandlung/ Ausnahmesituationen
- Datensicherung, -reorganisaton
- Unterstützung durch den Programmhersteller
• Übersichtlichkeit
- Aufbau und Gliederung
- Orientierungshilfen
- Format, Form und Gestaltung
![Page 4: 25.06.2002c) Peter Cramer 20021 Projektdokumentation Teil 2 Fachhochschule Dortmund Seminar IT-Consulting Sommersemester 2002 Peter Cramer](https://reader036.vdokument.com/reader036/viewer/2022062404/55204d6149795902118b46fb/html5/thumbnails/4.jpg)
25.06.2002 c) Peter Cramer 2002 4
Benutzerdokumentation / inhaltliche Kriterien
• Verständlichkeit
- Fachlicher Inhalt des Programms
- Sprache und Sprachstil
- Aufbereitung des fachlichen Inhaltes
• Richtigkeit- Zuordnung zum Programm
- Programmkonforme Darstellung
- fachliche sachliche Richtigkeit
- sprachliche Richtigkeit
![Page 5: 25.06.2002c) Peter Cramer 20021 Projektdokumentation Teil 2 Fachhochschule Dortmund Seminar IT-Consulting Sommersemester 2002 Peter Cramer](https://reader036.vdokument.com/reader036/viewer/2022062404/55204d6149795902118b46fb/html5/thumbnails/5.jpg)
25.06.2002 c) Peter Cramer 2002 5
Benutzerdokumentation / Inhaltliche Kriterien
Bestandteile einer Benutzerdokumentation
• allgemeine Systembeschreibung
• Installations- und Bedienungsanleitung
• Operator-Anleitung
Eine Benutzerdokumentation muss sicher stellen, dass das Softwareprodukt ohne fremde Hilfe benutzt werden kann!
![Page 6: 25.06.2002c) Peter Cramer 20021 Projektdokumentation Teil 2 Fachhochschule Dortmund Seminar IT-Consulting Sommersemester 2002 Peter Cramer](https://reader036.vdokument.com/reader036/viewer/2022062404/55204d6149795902118b46fb/html5/thumbnails/6.jpg)
25.06.2002 c) Peter Cramer 2002 6
Allgemeine Systembeschreibung
• Zweck des Softwaresystems,
• benötigte Hard- und Softwareressourcen
• die Art und Weise der Benutzer-System-Interaktion
• die Form der produzierten Ereignisse,
• organisatorische und informatorische Voraussetzungen
• implementierungsbedingte Restriktionen
• die Flexibilität und Portabilität des Softwaresystems.
![Page 7: 25.06.2002c) Peter Cramer 20021 Projektdokumentation Teil 2 Fachhochschule Dortmund Seminar IT-Consulting Sommersemester 2002 Peter Cramer](https://reader036.vdokument.com/reader036/viewer/2022062404/55204d6149795902118b46fb/html5/thumbnails/7.jpg)
25.06.2002 c) Peter Cramer 2002 7
Allgemeine Systembeschreibung
Die allgemeine Systembeschreibung soll das System charakterisieren und dessen Stärken und Schwächen und vor allem auch dessen Grenzen aufzeigen !
Ihr Ziel besteht darin den Leser über den Zweck des Softwaresystems aufzuklären !
![Page 8: 25.06.2002c) Peter Cramer 20021 Projektdokumentation Teil 2 Fachhochschule Dortmund Seminar IT-Consulting Sommersemester 2002 Peter Cramer](https://reader036.vdokument.com/reader036/viewer/2022062404/55204d6149795902118b46fb/html5/thumbnails/8.jpg)
25.06.2002 c) Peter Cramer 2002 8
Installations- und Bedienungsanleitung
• Das Softwaresystem wird als Black Box aufgefasst !
• Nur Informationen über die Benutzerschnittstelle werden gemacht !
Input:
Daten + Benutzerinteraktionen
Output:
Bildschirm, Drucker etc. ...
Black Box
Softwaresystem
![Page 9: 25.06.2002c) Peter Cramer 20021 Projektdokumentation Teil 2 Fachhochschule Dortmund Seminar IT-Consulting Sommersemester 2002 Peter Cramer](https://reader036.vdokument.com/reader036/viewer/2022062404/55204d6149795902118b46fb/html5/thumbnails/9.jpg)
25.06.2002 c) Peter Cramer 2002 9
Installationsanleitung
• Anleitung zur Installation / Upgrade-Anleitung• Systemkonfiguration / Einbettung in die Umgebung• Datei- und Datenbankformate• Überprüfung der korrekten Installation• Fehlersuche und -behebung
![Page 10: 25.06.2002c) Peter Cramer 20021 Projektdokumentation Teil 2 Fachhochschule Dortmund Seminar IT-Consulting Sommersemester 2002 Peter Cramer](https://reader036.vdokument.com/reader036/viewer/2022062404/55204d6149795902118b46fb/html5/thumbnails/10.jpg)
25.06.2002 c) Peter Cramer 2002 10
Bedienungsanleitung
• 1. Teilsequentiell lesbare Anleitung
- zum Schnell- bzw. Ersteinstieg in die Bedienung des Softwaresystems
• 2. TeilReferenzhandbuch
– selektiv lesbar– beschreibt die
typischen Arbeiten und die dazu notwendigenBenutzeraktionen
![Page 11: 25.06.2002c) Peter Cramer 20021 Projektdokumentation Teil 2 Fachhochschule Dortmund Seminar IT-Consulting Sommersemester 2002 Peter Cramer](https://reader036.vdokument.com/reader036/viewer/2022062404/55204d6149795902118b46fb/html5/thumbnails/11.jpg)
25.06.2002 c) Peter Cramer 2002 11
Bedienungsanleitung
• Darstellung und Erläuterungen von Beispielergebnissen
• Zusammenstellung der Fehlermeldungen und Hinweise auf Fehlerursachen
![Page 12: 25.06.2002c) Peter Cramer 20021 Projektdokumentation Teil 2 Fachhochschule Dortmund Seminar IT-Consulting Sommersemester 2002 Peter Cramer](https://reader036.vdokument.com/reader036/viewer/2022062404/55204d6149795902118b46fb/html5/thumbnails/12.jpg)
25.06.2002 c) Peter Cramer 2002 12
Operator-Anleitung
• Nur für Software, die von einem Host überwacht wird !
• Beschreibt die Nachrichten / Ereignisse
die die Software auslöst und deren Bedeutung
![Page 13: 25.06.2002c) Peter Cramer 20021 Projektdokumentation Teil 2 Fachhochschule Dortmund Seminar IT-Consulting Sommersemester 2002 Peter Cramer](https://reader036.vdokument.com/reader036/viewer/2022062404/55204d6149795902118b46fb/html5/thumbnails/13.jpg)
25.06.2002 c) Peter Cramer 2002 13
Systemdokumentation
• Systemspezifikation• Implementierung im Großen• Implementierung im Kleinen• Beschreibung der verwendeten Dateien• Testprotokollierung• Listung aller Programme
Übersicht
![Page 14: 25.06.2002c) Peter Cramer 20021 Projektdokumentation Teil 2 Fachhochschule Dortmund Seminar IT-Consulting Sommersemester 2002 Peter Cramer](https://reader036.vdokument.com/reader036/viewer/2022062404/55204d6149795902118b46fb/html5/thumbnails/14.jpg)
25.06.2002 c) Peter Cramer 2002 14
Systemdokumentation
• - Systemspezifikation
(meist schon im Vertrag mit dem Kunden vorhanden,
muss nur in eine Aufgabenstellung umgearbeitet werden)
- inkl. aller entwickelten Prototypen
- bei wiederverwendbaren Prototypen
- Dokumentieren der Änderungen
- Sicherung und Dokumentation der Prototypen
![Page 15: 25.06.2002c) Peter Cramer 20021 Projektdokumentation Teil 2 Fachhochschule Dortmund Seminar IT-Consulting Sommersemester 2002 Peter Cramer](https://reader036.vdokument.com/reader036/viewer/2022062404/55204d6149795902118b46fb/html5/thumbnails/15.jpg)
25.06.2002 c) Peter Cramer 2002 15
Systemdokumentation
- Zeigt die Konzeption und Grundstruktur der Software auf
- Schnittstellendefinitionen
- Teilsystemzerlegungen
- gewählte Problemlösungen
- Beschreibung von Grundlagen und Infrastruktur
- Darstellung anhand von Diagrammen
- Begründung für die gewählte Architektur
- soll während des Entwurfsprozesses aufgestellt werden
Beschreibung der Implementierung im Großen
![Page 16: 25.06.2002c) Peter Cramer 20021 Projektdokumentation Teil 2 Fachhochschule Dortmund Seminar IT-Consulting Sommersemester 2002 Peter Cramer](https://reader036.vdokument.com/reader036/viewer/2022062404/55204d6149795902118b46fb/html5/thumbnails/16.jpg)
25.06.2002 c) Peter Cramer 2002 16
Systemdokumentation
- zu unterscheiden nach Art der Programmierung
- Modulschnittstellen (Import, Export, Vererbung)
- Datenstrukturen, Datentypen
- Dateiformate, Satzaufbau, Organisationsform, Zugriffe
- Aufrufe von Prozeduren/ Methoden
- erforderliche Initialisierungen
- eventuell Erläuterungen kritischer Algorithmen
- Programmierrichtlinien
Beschreibung der Implementierung im Kleinen
![Page 17: 25.06.2002c) Peter Cramer 20021 Projektdokumentation Teil 2 Fachhochschule Dortmund Seminar IT-Consulting Sommersemester 2002 Peter Cramer](https://reader036.vdokument.com/reader036/viewer/2022062404/55204d6149795902118b46fb/html5/thumbnails/17.jpg)
25.06.2002 c) Peter Cramer 2002 17
Systemdokumentation
Dokumentation ist nicht gleich einer Kommentierung !
Formale Darstellungsmittel wie
-ER- und UML- Diagramme
-Data Dictionary
-Grammatiken Sind ausdrücklich erlaubt
Präzision, Kürze und Eindeutigkeit haben Vorrang gegenüber der Lesbarkeit !
![Page 18: 25.06.2002c) Peter Cramer 20021 Projektdokumentation Teil 2 Fachhochschule Dortmund Seminar IT-Consulting Sommersemester 2002 Peter Cramer](https://reader036.vdokument.com/reader036/viewer/2022062404/55204d6149795902118b46fb/html5/thumbnails/18.jpg)
25.06.2002 c) Peter Cramer 2002 18
Testdokumentation
Die Testdokumentation dient zur Vereinfachung von Änderungen und Erweiterungen !
Sie ist die Grundlage für die Fehlersuche!
![Page 19: 25.06.2002c) Peter Cramer 20021 Projektdokumentation Teil 2 Fachhochschule Dortmund Seminar IT-Consulting Sommersemester 2002 Peter Cramer](https://reader036.vdokument.com/reader036/viewer/2022062404/55204d6149795902118b46fb/html5/thumbnails/19.jpg)
25.06.2002 c) Peter Cramer 2002 19
Testdokumentation
Inhalt:
- Anforderungsdokumente
- Beschreibung der Dateien bzw. DB-Schnittstelle
- Testplan für jede Komponente
- Testspezifikation
- Testplan, -Daten für Integrationstest
- Testplan, -Daten für Akzeptanztest
- Programmlisting, Testprotokoll, etc.
![Page 20: 25.06.2002c) Peter Cramer 20021 Projektdokumentation Teil 2 Fachhochschule Dortmund Seminar IT-Consulting Sommersemester 2002 Peter Cramer](https://reader036.vdokument.com/reader036/viewer/2022062404/55204d6149795902118b46fb/html5/thumbnails/20.jpg)
25.06.2002 c) Peter Cramer 2002 20
Wartungsdokumentation
• Verständlichkeit• Komponentenunabhängigkeit• Verwendete Programmiersprache• Programmierstil
Kriterien für die Wartbarkeit
![Page 21: 25.06.2002c) Peter Cramer 20021 Projektdokumentation Teil 2 Fachhochschule Dortmund Seminar IT-Consulting Sommersemester 2002 Peter Cramer](https://reader036.vdokument.com/reader036/viewer/2022062404/55204d6149795902118b46fb/html5/thumbnails/21.jpg)
Fragen?Kritik?
Anregungen?Verbesserungen?
ENDE