Vorlagen

1. Allgemeines

Die Vorlagen unterstützen die Erstellung projektspezifischer Dokumentation wesentlich. Sie enthalten Word-, Excel- oder AsciiDoc-Dateien, die im Projektverlauf gefüllt werden müssen.

Nach Bedarf können für die dauerhafte Ablage aus Word- und AsciiDoc-Vorlagen PDF-Dokumente erzeugt werden. Für Word-Vorlagen wird hierzu die integrierte Funktion von Word genutzt. Für AsciiDoc-Vorlagen kann Asciidoctor PDF verwendet werden.

Word- und Excel-Vorlagen können direkt von dieser Seite als Download bezogen werden. AsciiDoc-Vorlagen können sowohl direkt aufgerufen als auch im ZIP- oder PDF-Format heruntergeladen werden.

2. Dokumentation einer Anwendung

Die Vorlagen zur Dokumentation einer Anwendung beschreiben diese aus den drei aus der Referenzarchitektur bekannten Sichten:

  • Systemspezifikation: fachliche Sicht,

  • Systementwurf: software-technische Sicht,

  • Systemhandbuch: Sicht der technischen Infrastruktur.

Alle Vorlagen enthalten Ausfüllhinweise und Beispiele.

Die Vorlage Systemspezifikation enthält die Gliederung für eine V-Modell-konforme Gesamtsystemspezifikation (Pflichtenheft) eines Softwaresystems (Software-Entwicklungsprojekts).

Tabelle 1. Vorlagen zur Dokumentation einer Anwendung
Vorlage Quelldatei
(AsciiDoc)
Downloads (ZIP, PDF, Word)

Systemspezifikation

Ansehen

Download

Systementwurf

Ansehen

Download

Download

Download

Systemhandbuch

Ansehen

Download

Download

Download

3. Fachliche Schnittstellendokumentation

Die Vorlage enthält die Gliederung für eine V-Modell-konforme Schnittstellendokumentation eines Softwaresystems (Software-Entwicklungsprojekts) mitsamt Ausfüllhinweisen und Beispielen.

Tabelle 2. Vorlage zur Schnittstellendokumentation
Vorlage Quelldatei (AsciiDoc) Download (Word)

Schnittstellendokumentation

Ansehen

Download

4. Datenflussdiagramm

Eine Anwendungslandschaft besteht aus mehreren Anwendungen, die Daten untereinander und mit ihren Anwendern austauschen. Die Anleitung zu Datenflussdiagrammen hilft bei der Erstellung von Datenflussdiagrammen und gibt Best Practices zur strukturierten Beschreibung dieses Datenflusses.

Tabelle 3. Vorlage zu Datenflussdiagrammen
Vorlage Quelldatei (AsciiDoc) Download (Word)

Datenflussdiagramm

Ansehen

Download

5. Anforderungsliste

Die Anforderungsliste ist ein Instrument, um die Übersicht und die Nachvollziehbarkeit des Umsetzungsstatus aller Anforderungen an ein System im gesamten Projektlebenszyklus zu erhalten. Die Anforderungsliste beschreibt mit jeder Anforderung eine Eigenschaft, die eine Anwendung haben soll. Dies kann eine bestimmte Funktionalität oder auch eine Anforderung in Hinblick auf die Qualität sein, zum Beispiel die maximale Reaktionszeit bei einer Eingabe. Die Anforderungsliste ist bei ihrer Erstellung und bei jeder Versionierung ein Mittel der Kommunikation zwischen Auftraggeber und Auftragnehmer.

Tabelle 4. Vorlage zur Anforderungsliste
Vorlage Quelldatei (Excel)

Anforderungsliste

Download

6. Produktauswahl

Das Template Produktauswahl liefert eine Vorlage zur Beschreibung der Hintergründe zur Auswahl eines Produkts in Projekten.

Tabelle 5. Vorlage zur Produktauswahl
Vorlage Quelldatei (Word)

Produktauswahl

Download

7. Tailoring-Dokument

Das Tailoring-Dokument beschreibt die Anpassung der IsyFact-Referenzarchitektur auf einen bestimmten Anwendungskontext.

Auf der Ebene der fachlichen Architektur ist die IsyFact kontext-neutral, um ein möglichst breites Spektrum von Anwendungskontexten abzudecken. Damit die IsyFact in einem bestimmten Anwendungskontext als praktischer Leitfaden und Vorlage für die Entwicklung dienen kann, sind weitere Festlegungen und Anpassungen der IsyFact an die Gegebenheiten des jeweiligen Anwendungskontexts notwendig. Dieser Vorgang wird als Tailoring bezeichnet, sein Ergebnis ist ein Tailoring-Dokument zur IsyFact für den Anwendungskontext.

Alle im Tailoring-Dokument beschriebenen Sachverhalte beziehen sich auf die IsyFact Referenzarchitektur. Sofern im Tailoring-Dokument nichts anderes definiert wird, gelten die Festlegungen der IsyFact-Referenzarchitektur unverändert.

Tabelle 6. Vorlage zum Tailoring-Dokument
Vorlage Quelldatei (Word)

Tailoring

Download