IsyFact-Standard

Tailoring-Dokument für <Anwendungskontext>

Version 0.2

<05.09.2018>

„IsyFact-Tailoring-Vorlage“
des Bundesverwaltungsamts ist lizenziert unter einer
Creative Commons Namensnennung 4.0 International Lizenz.

Die Lizenzbestimmungen können unter folgender URL heruntergeladen werden: http://creativecommons.org/licenses/by/4.0

Ansprechpartner:

Referat Z III 2

Bundesverwaltungsamt

E-Mail:	isyfact@bva.bund.de

Internet:	www.isyfact.de

Dokumentinformationen

Dokumenten-ID:	IsyFact Tailoring

Dokumentenhistorie

Datum	Version	Änderungsgrund	Verantwortlich
07.09.2018	0.1	Erstellung Vorlage	Z III 2, IsyFact

Inhaltsverzeichnis

1	Einleitung	6

1.1	Ziel des Dokumentes	6

1.2	Architektursichten	7

1.3	Tailoring	7

2	Anwendungskontext	10

2.1	Beschreibung	10

2.2	Begriffsdefinitionen	10

2.3	Funktionale Anforderungen	10

2.4	Nicht-funktionale Anforderungen	10

3	Fachliche Architektur des Kontexts	11

3.1	Anwendungslandschaft	11

3.2	Arten von Anwendungssystemen	12

3.2.1	<Erster Anwendungstyp>	12

3.2.2	<Zweiter Anwendungsty >	12

3.2.3	<Dritter Anwendungstyp>	12

4	Anpassung der Software-Architektur	13

4.1	Strukturierung der Systemlandschaft	13

4.1.1	Schnittstellen <Erster Anwendungstyp>	13

4.1.2	Schnittstellen <Zweiter Anwendungstyp>	13

4.2	Interne Struktur der Fachanwendungen	13

4.2.1	Interne Struktur <Erster Anwendungstyp>	13

4.2.2	Interne Struktur <Zweiter Anwendungstyp >	13

4.3	Verwendete IsyFact-Erweiterungen	14

4.4	Spezifische Komponenten des Kontexts	14

4.5	Zusätzlich eingesetzte Produkte	14

5	Anpassung der TI-Architektur	15

6	Besondere betriebliche Randbedingungen	16

6.1	<Erste Rahmenbedingung>	16

6.2	<Zweite Rahmenbedingung>	16

7	Quellenverzeichnis	17

Einleitung

Hinweis: Zur Verwendung dieser Vorlage:

Diese Vorlage ist Grundlage für die Erstellung eines Tailoring-Dokuments zur IsyFact. Die Idee des Tailorings ist in Abschnitt 1.1 dieses Dokuments erläutert.

Die Vorlage enthält Hinweise, wie die einzelnen Abschnitte mit Inhalten zu füllen sind. Hinweistexte sind in kursiver Schrift und innerhalb eines grauen Kastens gesetzt, so wie dieser Text.

Innerhalb von Hinweistexten werden in einigen Abschnitten Beispiele angegeben, wie der Inhalt des Abschnitts aussehen kann. Diese Beispiele sind nicht-kursiv gesetzt: Beispiel-Text

Im fertigen Tailoring-Dokument sollten alle Hinweise und Beispiele gelöscht werden.

Die Vorlage enthält darüber hinaus auch schon vorgefertigte Inhalte in den einzelnen Abschnitten, die unmittelbar übernommen werden können. In den Abschnitten und in Überschriften werden Platzhalter verwendet, für die konkrete Namen von Anwendungstypen oder Anwendungskontexten einzusetzen sind. Platzhalter sind in spitzen Klammern gesetzt: <Anwendungskontext>,<Erstes Anwendungssystem>, …

Ziel des Dokumentes

Hinweis: Der folgende Text erläutert allgemein das Ziel des Tailoring-Dokuments und kann übernommen werden. Lediglich der Name des Anwendungskontexts muss eingefügt werden.

Das vorliegende Dokument beschreibt die Anpassung der IsyFact-Referenzarchitektur auf einen bestimmten Anwendungskontext. Die IsyFact wurde entwickelt, um Fachanwendungen, insbesondere in großen Anwendungslandschaften, schneller, preiswerter und sicherer entwickeln zu können [IsyFactReferenzarchitektur]. Die IsyFact definiert dazu eine Rahmenarchitektur für die Anwendungslandschaft und macht technische Vorgaben für die Entwicklung und den Betrieb der Fachanwendungen.

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. Dabei sind die spezifischen Rahmenbedingungen des Kontexts, seine besonderen Anforderungen, die fachliche Architektur und die möglichen Erweiterungen oder Einschränkungen der technischen Architekturebenen zu definieren. Diesen Vorgang bezeichnet man als Tailoring, sein Ergebnis ist ein Tailoring-Dokument zur IsyFact für den Anwendungskontext.

Das vorliegende Dokument ist das Tailoring-Dokument zur IsyFact für den Anwendungskontext:

<Anwendungskontext>

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

Architektursichten

Die IsyFact-Referenzarchitektur unterscheidet zwischen drei Architektursichten. An diesen drei Sichten orientiert sich auch das Tailoring:

Fachliche Referenzarchitektur: Dies umfasst eine fachliche Beschreibung der Anwendungslandschaft. Diese wird in fachliche Komponenten zerlegt, die miteinander über fachliche Schnittstellen interagieren.

Software-Referenzarchitektur: Dies ist eine software-technische Beschreibung der Systemlandschaft. Die gesamte Systemlandschaft wird in technische Komponenten mit technischen Schnittstellen zerlegt.

Referenzarchitektur der technischen Infrastruktur: Hierunter fällt eine Beschreibung der Systemlandschaft aus dem Blickwinkel der technischen Infrastruktur. Es wird beschrieben, welche technischen Systeme existieren und welche technischen Komponenten auf ihnen laufen.

Die IsyFact definiert für die fachliche Referenzarchitektur lediglich Grundlagen und macht keine Aussagen über die Art der zu erstellenden Fachanwendungen. Das Tailoring beschreibt daher im Wesentlichen die fachliche Referenzarchitektur des Anwendungskontexts, insbesondere die Arten von Fachanwendungen, die im spezifischen Kontext existieren.

Ausgehend von der fachlichen Referenzarchitektur des Kontexts wird dann als Ergänzung der allgemeinen Software-Referenzarchitektur beschrieben, wie die Fachanwendungen des Kontexts miteinander interagieren und wie sie intern strukturiert sind.

Zuletzt wird für Referenzarchitektur der technischen Infrastruktur definiert, wie die Vorgaben der IsyFact auf den Kontext der jeweiligen Organisation und der Fachlichkeit anzupassen sind und welche besonderen Randbedingungen im Betrieb zu beachten sind.

Tailoring

Im Folgenden werden die Elemente des Tailorings und ihre Zuordnung zu den drei Architektursichten im Einzelnen beschrieben.

Zunächst wird die fachliche Architektur des Kontexts festgelegt:

Definition des Anwendungskontexts. Der konkrete Anwendungskontext, den das Tailoring abdecken soll, wird benannt und für eine außenstehende Person verständlich beschrieben. Die Beschreibung an sich kann kurz und informell erfolgen und ggf. auf weitere Dokumente verweisen, die die Fachlichkeit des Kontexts im Detail beschreiben. Wichtig ist jedoch, dass die zentralen Begriffe des Kontexts, die im weiteren Verlauf des Tailoring-Dokuments verwendet werden, hier eingeführt werden. Dazu ist ein eigener Abschnitt vorgesehen.

Anforderungen des Anwendungskontexts. Hier sind die allgemeinen funktionalen und nicht-funktionalen Anforderungen des Kontexts zu beschreiben, sofern sie im Weitern einen Einfluss auf die Referenzarchitektur haben.

Arten von Fachanwendungen im Kontext. Das zentrale Element des Tailorings ist die Beschreibung der unterschiedlichen Fachanwendungen des Kontexts. Dabei sind insbesondere die Aufgaben und Verantwortlichkeiten der Anwendungen zu beschreiben und der Bezug zu den funktionalen und nicht-funktionalen Anforderungen herzustellen.

Nach Festlegung der fachlichen Architektur, behandeln die folgenden Elemente des Tailorings die spezifische Erweiterung der Software-Architektur im Anwendungskontext:

Interne Struktur der Fachanwendungen. Für jede der kontextspezifischen Fachanwendungen wird beschrieben, wie sie intern strukturiert sind. Dabei wird ggf. auf kontextspezifische Bausteine und Bibliotheken zurückgegriffen.

Interaktion zwischen den Fachanwendungen. Hier ist zu beschreiben, welche Interaktionen, insbesondere welche Kommunikationsbeziehungen zwischen den Fachanwendungen erlaubt sind. Dies betrifft sowohl die Kommunikation und gegenseitigen Aufrufe zwischen den spezifischen Fachanwendungen des Kontexts als auch deren Kommunikation mit Fachanwendungen die schon auf Ebene der IsyFact selbst definiert wurden. Ein Beispiel für eine derartige Festlegung wäre, dass nur bestimmte Fachanwendungen über ein Service-Gateway von außen erreichbar sein dürfen.

Spezifische Bausteine des Kontexts. Hier wird beschrieben, welche zusätzlichen Software-Komponenten speziell zur Realisierung der Fachanwendungen des Kontexts benötigt werden. Dabei kann es sich sowohl um Komponenten handeln, die innerhalb einer Anwendung zum Einsatz kommen wie auch um solche, die Teil eines neuen Querschnitt-Systems sind.

Zusätzlich eingesetzte Produkte. Sollten zur Realisierung der Fachanwendungen im betrachteten Kontext zusätzliche Produkte (z.B. Java-Bibliotheken) erforderlich sein, ist dies im Tailoring ebenfalls zu dokumentieren.

Abschließend wird noch die Anpassung der TI-Architektur und der Betriebsvorgaben an den Kontext im Rahmen des Tailorings beschrieben.

Anpassungen der TI-Architektur. Hier wird beschrieben, wie die TI-Architektur basierend auf der Referenzarchitektur einer IsyFact-konformen Systemlandschaft an die Anforderungen des Kontexts anzupassen ist. Die Anforderungen können dabei sowohl aus der Art der Fachanwendungen als auch aus den Vorgaben der Organisation, die die Systemlandschaft betreibt, resultieren.

Besondere betriebliche Randbedingungen. In diesem Abschnitt werden die besonderen Randbedingungen des Kontexts für den Betrieb der Systemlandschaft dokumentiert. In der Regel handelt es sich dabei um technische und organisatorische Vorgaben der Betriebsorganisation des jeweiligen Anwenders der IsyFact.

Anwendungskontext

Beschreibung

Hinweis: Dieser Abschnitt beschreibt fachlich den Anwendungskontext und seine spezifischen Randbedingungen: Welche Fachlichkeit wird im Anwendungskontext behandelt, welche Prozesse und Abläufe sind zu unterstützen, welche Daten werden erfasst und verarbeitet und wer sind die Nutzer der zu erstellenden Anwendungen?

Außerdem gibt der Abschnitt einen Überblick über gesetzliche Vorgaben und Regeln, die bei der Entwicklung von Anwendungen zu beachten sind, beispielsweise Nachweispflichten, spezielle Regeln zum Datenschutz und zu Nutzungsberechtigungen.

Begriffsdefinitionen

In diesem Abschnitt werden die relevanten Begriffe des Anwendungskontexts eingeführt. Insbesondere müssen dabei die Arten von Anwendungssystemen definiert werden, die in diesem Kontext vorkommen.

Beispiel:

XY-Anwendung: Eine XY-Anwendung ist ein System, das …

YZ-Anwendung: Eine XZ-Anwendung hat die Aufgabe …

Funktionale Anforderungen

Hier werden spezifische funktionale Anforderungen des Anwendungskontexts beschrieben, sofern diese existieren.

Für den in diesem Dokument beschriebenen Anwendungskontext existieren keine/die folgenden spezifischen funktionalen Anforderungen.

Nicht-funktionale Anforderungen

Hier werden spezifische nicht-funktionale Anforderungen des Anwendungskontexts beschrieben, sofern diese existieren.

Für den in diesem Dokument beschriebenen Anwendungskontext existieren keine/die folgenden spezifischen nicht-funktionalen Anforderungen.

Fachliche Architektur des Kontexts

Hinweis: Der folgende Einleitungstext kann übernommen werden.

In diesem Abschnitt wird die fachliche Architektur des Anwendungskontexts im Kontext der Architektur der IsyFact beschrieben. Dabei wird zuerst die Anwendungslandschaft insgesamt beschrieben, d.h. wie die verschiedenen Arten von Anwendungen zusammenspielen. Danach folgt die detaillierte Beschreibung der einzelnen Anwendungstypen.

Anwendungslandschaft

Hinweis: Der folgende Einleitungstext kann übernommen werden.

Zu den Aufgaben einer Organisation oder Behörde gehört die Durchführung verschiedener fachlicher Verfahren. Wenn solche Verfahren vollständig oder teilweise automatisiert werden sollen, so erfolgt dies in der Regel mit Anwendungssystemen, die zunächst aus fachlicher Sicht beschrieben werden, dann mit softwaretechnischen Mitteln umgesetzt werden und schließlich auf einer technischen Infrastruktur betrieben werden.

Die Menge aller Anwendungssysteme und deren Nutzungsbeziehungen untereinander bilden eine Anwendungslandschaft. Die fachliche Architektur einer Anwendungslandschaft gibt hier die Strukturierung aus fachlicher Sicht vor und legt fest, wie Anwendungssysteme in die Anwendungslandschaft integriert werden.

Hinweis: An dieser Stelle sollte in einem Architekturbild veranschaulicht werden, aus welchen Anwendungssystemen die Anwendungslandschaft besteht und welche Beziehungen zwischen den Systemen bestehen.

Beispiel (Anwendungslandschaft für Registeranwendungen): Die fachliche Architektur für eine auf Register fokussierte Anwendungslandschaft ist in Abbildung 1 dargestellt.

Abbildung 1: Fachliche Architektur einer auf Register fokussierten Anwendungslandschaft

Arten von Anwendungssystemen

Hinweis: In diesem Abschnitt werden die verschiedenen Arten von Anwendungssystemen im vorliegenden Anwendungskontext zunächst benannt und dann genauer beschrieben. Für jede Art von Anwendung gibt es einen eigenen Unterabschnitt.

Beispiel: Im Kontext Registeranwendungen, den das vorliegende Dokument beschreibt, gibt es zwei Arten von Fachanwendungen: Register und Geschäftsanwendungen.

Im Kontext <Anwendungskontext>, den das vorliegende Dokumente beschreibt, gibt es folgende Arten von Fachanwendungen: …

<Erster Anwendungstyp>

Hinweis: In diesem Unterabschnitt wird die spezifische Art der Fachanwendung aus fachlicher Sicht genauer beschrieben. Es wird darüber hinaus eine fachliche Referenzarchitektur definiert.

Beispiel: Ein Register ist …

Für den Aufbau eines Registers ist eine fachliche Referenzarchitektur vorgegeben, die in Abbildung 2 dargestellt ist.

Abbildung 2: Referenzarchitektur eines Registers

<Zweiter Anwendungstyp>

…

<Dritter Anwendungstyp>

…

Anpassung der Software-Architektur

Hinweis: Im vorhergehenden Abschnitt wurden im Rahmen der fachlichen Architektur die verschiedenen Arten von Anwendungen und ihr Zusammenspiel auf der fachlichen Ebene beschrieben. Die unterschiedlichen Aufgaben der einzelnen Anwendungstypen spiegeln sich auch in ihrer internen Architektur und in ihren Schnittstellen wieder. Im Rahmen der allgemeinen Software-Architektur sind diese Aspekte nur generisch für alle möglichen Fachanwendungen beschrieben. In diesem Abschnitt wird die Software-Architektur für die zuvor definierten Anwendungstypen nun konkretisiert.

Strukturierung der Systemlandschaft

Schnittstellen <Erster Anwendungstyp>

Hinweis: Hier werden die konkreten Schnittstellen des Anwendungstyps und deren Nutzung innerhalb der Anwendungslandschaft beschrieben.

…

Schnittstellen <Zweiter Anwendungstyp>

…

Interne Struktur der Fachanwendungen

Hinweis: Hier wird die interne Struktur der Anwendungstypen beschrieben, d.h. aus welchen Komponenten und Schichten sie bestehen. Es sollte dabei der Bezug zur Referenzarchitektur eines IT-Systems gemäß der IsyFact gewahrt werden. Auch wenn es theoretisch denkbar wäre, eine komplett eigene Architektur zu definieren, wäre dies nicht im Sinne des Tailoring-Gedankens und würde dazu führen, dass die Bausteine der IsyFact nicht mehr verwendbar wären.

Typischerweise sollte die interne Struktur nur geringfügig angepasst werden, indem z.B. Komponenten für nicht verwendete Schnittstellen aus der Architektur entfernt werden.

Der folgende Einleitungstext kann übernommen werden.

Die technische Architektur einer Fachanwendung wird allgemein im Dokument [IsyFactReferenzarchitekturITSystem] beschrieben. Die Anwendungen des Kontexts <Anwendungskontext> folgen dieser Architektur. Darüber hinaus ergeben sich die im Folgenden beschriebenen Besonderheiten.

Interne Struktur <Erster Anwendungstyp>

…

Interne Struktur <Zweiter Anwendungstyp >

…

Verwendete IsyFact-Erweiterungen

Hinweis: In diesem Abschnitt wird aufgelistet, welche Erweiterungen der IsyFact in diesem Anwendungskontext grundsätzlich zum Einsatz kommen. Es ist nicht erforderlich, die verwendeten Versionen hier aufzulisten, diese werden in den Systementwürfen der einzelnen Anwendungen referenziert.

In dem in diesem Dokument beschriebenen Anwendungskontext werden keine/die folgenden IsyFact-Erweiterungen verwendet.

Spezifische Komponenten des Kontexts

Hinweis: Falls für den vorliegenden Anwendungskontext spezielle wiederverwendbare Komponenten entwickelt wurden, können sie in diesem Abschnitt beschrieben werden.

Es wird zwischen folgenden Arten von Komponenten unterschieden:

- Anpassungen sind Komponenten, die existierende Komponenten der IsyFact erweitern, um sie auf den vorliegenden Kontext anzupassen. Die Komponenten sind nur in Zusammenspiel mit der erweiterten Komponente funktionsfähig. Bspw. eine Erweiterung der Komponente plis-sicherheit, um diese an einen bestimmten Access-Manager zu anzubinden. Der Name der Komponente muss dabei dem Namen der erweiterten Komponente plus eines Suffixes entsprechen. Bspw.: plis-sicherheit-xyzaccess

- Eigenständige Komponenten sind Komponenten, die auf Basis der IsyFact entwickelt wurden und eigenständig wiederverwendet werden können.

Für den in diesem Dokument beschriebenen Anwendungskontext wurden keine/die folgenden spezifischen Komponenten entwickelt.

Zusätzlich eingesetzte Produkte

Hinweis: Falls im vorliegenden Anwendungskontext Produkte eingesetzt werden, die und über den Umfang des Produktkatalogs der IsyFact hinausgehen, können sie in diesem Abschnitt beschrieben werden.

Gegenüber dem Produktkatalog [ProduktKatalog] der IsyFact wurden keine/die folgenden zusätzlichen Produkte eingesetzt.

Anpassung der TI-Architektur

Hinweis: Falls erforderlich, können in diesem Abschnitt Anpassungen an der TI-Infrastruktur beschrieben werden, die speziell für den vorliegenden Anwendungskontext vorgenommen wurden.

An der TI-Architektur werden keine/die folgenden Anpassungen vorgenommen.

Besondere betriebliche Randbedingungen

Hinweis: In diesem Abschnitt werden besondere Rahmenbedingungen für den Betrieb von Anwendungen im vorliegenden Anwendungskontext beschrieben. Hierzu zählen z.B. besondere Sicherheits- oder Verfügbarkeitsanforderungen.

<Erste Rahmenbedingung>

…

<Zweite Rahmenbedingung>

…

Quellenverzeichnis

Hinweis: Weitere Quellen sind bei Bedarf zu ergänzen, wenn auf sie im Rahmen des Tailorings Bezug genommen wird.

[IsyFactReferenzarchitektur]
IsyFact – Referenzarchitektur 00_Allgemein\IsyFact-Referenzarchitektur.pdf.
[IsyFactReferenzarchitekturITSystem]
IsyFact – Referenzarchitektur für IT-Systeme 00_Allgemein\IsyFact-Referenzarchitektur-IT-System.pdf.
[ProduktKatalog]
IsyFact Produktkatalog 00_Allgemein\Produktkatalog.pdf.