In diesem Kapitel definieren wir nun die Produkte „HR-Optimal“ und „HR-Kompakt“ in Faktor- IPS. Hierzu wird die speziell für den Fachbereich entwickelte Produktdefinitionsperspektive verwendet.

Als erstes richten Sie ein neues Projekt mit dem Namen „Hausratprodukte“ und dem Sourceverzeichnis „produktdaten“ ein. Dazu wieder ein neues Java-Projekt erzeugen und dann Add IpsNature im Package-Explorer aufrufen. Als Typ wählen Sie diesmal Produktdefinitions-Project, als Packagename „org.faktorips.tutorial.produktdaten“ und als Runtime-ID Prefix „hausrat.“. Achten Sie darauf, dass der Prefix mit einem Punkt (.) endet. Faktor -IPS erzeugt für jeden neuen Produktbaustein eine Id, mit der der Baustein zur Laufzeit identifiziert wird. Standardmäßig setzt sich diese RuntimeId aus dem Prefix gefolgt von dem (unqualifizierten) Namen zusammen [11]. Zur Laufzeit wird nicht der qualifizierte Name eines Bausteines zur Identifikation verwendet, da die Packagestruktur zur Organisation der Produktdaten zur Entwicklungszeit dient. Auf diese Weise können die Produktdaten umstrukturiert (refactored) werden, ohne dass dies Auswirkungen auf die nutzenden operativen Systeme hat.

[11] Für die Implementierung eigener Verfahren zur Vergabe der RuntimeId wird ein entsprechender Extension Point bereitgestellt werden.

Die Verwaltung der Produktdaten in einem eigenen Projekt erfolgt vor dem Hintergrund, dass die Verantwortung für die Produktdaten bei anderen Personen liegt und sie auch einen anderen Releasezyklus haben können. So könnte die Fachabteilung zum Beispiel ein neues Produkt „HR-Flexibel“ erstellen und freigeben, ohne dass das Modell geändert wird. Damit in dem neuen Projekt auf die Klassen des Hausratmodells zugegriffen werden kann, muss in Faktor -IPS im Produktdatenprojekt eine Referenz auf das Hausratmodell-Projekt definiert werden. Das funktioniert in Faktor-IPS analog zur Definition des Build Path in Java. Der Dialog zur Definition des Faktor-IPS Build Path ist auch genauso aufgebaut wie der entsprechende Dialog für den Java Build Path und kann über die Projekteigenschaften aufgerufen werden.

Um eine Referenz auf das Modell anzulegen, gehen Sie wie folgt vor:

Die folgende Abbildung zeigt den Dialog für den Faktor-IPS Build Path des Produktdatenprojektes mit Referenz auf das Modellprojekt.

Damit auch die Javaklassen in dem Projekt verfügbar sind, müssen Sie nun noch den Java-Build Path um das Java-Projekt Hausratmodell erweitern (Analog zu Faktor-IPS Build Path).

Öffnen Sie nun zunächst die Produktdefinitionsperspektive über Window ► Perspective ► Open Perspective ► Other ► Produktdefintion auswählen [12]. Falls Sie noch Editoren geöffnet haben, schließen Sie diese jetzt, um die Sichtweise der Fachabteilung auf das System zu haben. Damit Sie im Problems-View ausschließlich die Marker von Faktor-IPS sehen (und nicht auch Java-Marker u.a.) müssen Sie im Problems-View den Faktor-IPS Filter ein- und alle anderen Filter (standardmäßig mindestens der Defaultfilter) ausschalten.

[12] Für die Verwendung von Faktor-IPS durch die Fachabteilung gibt es auch eine eigene Installation (In Eclipse Terminologie: ein eigenes Produkt), bei der ausschließlich die Produktdefinitionsperspektive verfügbar ist.

Zunächst legen wir zwei IPS Packages an, einen für die Produkte und einen für die Deckungen. Dies geschieht wie in der Java Perspektive entweder über das Kontextmenü oder die Toolbar (als Quellordner „Hausratprodukte“ wählen).

Bemerkung: Sie können in dem Projekt beliebig viele Verzeichnisse anlegen. Zum Beispiel ein doc- Verzeichnis zur Verwaltung von Produktdokumenten.

Als erstes legen wir jetzt das Produkt „HR-Optimal“ an. Markieren Sie dazu das gerade angelegte Package „produkte“ und klicken dann in der Toolbar an . Es öffnet sich der Wizard zum Erzeugen eines neuen Produktbausteins. Der Wizard bietet Ihnen nun die im Modell verfügbaren Produktklassen zur Auswahl, zu denen Sie Produktbausteine erstellen können. Wählen Sie HausratProdukt.

Falls Sie keine Produktklasse finden, fehlt noch die Referenz auf das Hausratmodell-Projekt im Faktor-IPS Build Path (s.o.). Gehen Sie mit Next zur nächsten Seite des Wizards.

Hier geben Sie den Namen des Bausteins ein. Wenn Sie nun Finish drücken wird der Produktbaustein im Dateisystem angelegt.

Mit Doppelklick auf den Produktbaustein im Produktdefinitions-Explorer öffnen Sie den Editor für den Baustein.

Die erste Seite des Editors zeigt:

Geben Sie Daten für das Produkt HR-Optimal entsprechend der folgenden Tabelle ein:

Nun legen wir den Grunddeckungstyp für das Produkt an. Markieren Sie hierzu den Ordner Deckungen und legen einen neuen Produktbaustein mit Namen „HRD-Grunddeckung-Optimal“ an basierend auf der Klasse „HausratGrunddeckungstyp“.

Nun müssen wir noch den Deckungstyp dem Produkt „HR-Optimal“ zuordnen. Dies kann man bequem per Drag&Drop aus dem Produktdefinitions-Explorer erledigen. Öffnen Sie das Produkt „HR-Optimal“. Ziehen Sie die „HRD-Grunddeckung-Optimal“ aus dem Explorer auf den Knoten HausratGrundeckungstyp im Bereich Beziehungen.

Zuordnung von Deckungstypen zu einem Produkt image::../images/content/bilder/modellierung-und-produktkonfigurierung/zuordnung-deckungstypen.jpg[align="center"]

Sie bekommen folgende Fehlermeldung:

Hier muss in der „Art der Beziehung“ Obligatorisch gewählt werden, da es sich um eine 1..1(1) Relation handelt. (Grund dafür ist die definierte Beziehung zwischen „HausratProdukt“ und „HausratGrunddeckungstyp“. Siehe Abbildung 25)

Im nächsten Schritt legen wir das Produkt „HR-Kompakt“ inklusive der Grunddeckung „HRD-Kompakt“ an. Dies können Sie analog zum Produkt „HR-Optimal“ machen. Alternativ können Sie einen Kopierassistenten verwenden, mit dem Sie einen Produktbaustein inklusive aller verwendeter Bausteine kopieren können. Wenn Sie dies ausprobieren möchten, markieren Sie das Produkt „HR-Optimal“ im Produktdefinitions-Explorer und wählen im Kontextmenü New ► Copy Product …​

Im geöffneten Dialog geben Sie als Search Pattern (Suchen nach) „Optimal“ und als Replace Pattern (Ersetzen durch) „Kompakt“ ein, klicken Next und dann Finish. Faktor-IPS legt die Bausteine „HR-Kompakt“ und „HRD-Grunddeckung“ neu an. Öffnen Sie „HR-Kompakt“ und geben Sie Daten entsprechend der nachfolgenden Tabelle ein:

Damit ist die Definition der beiden Produkte zunächst abgeschlossen. Im Produktdefinitions-Explorer sollten Sie folgendes sehen.

Neben dem Produktdefinitions-Explorer stehen Ihnen zwei weitere Werkzeuge zur Analyse der Produktdefinition zur Verfügung. Die Struktur eines Produktes können Sie sich mit Show Structure im Kontextmenü anzeigen lassen. Die unterschiedliche Verwendung eines Bausteins mit Search References. Darüber hinaus können Sie die Reihenfolge der Pakete über den Menüpunkt Edit Sort Order frei festlegen.

Rechts neben dem Editor zur Eingabe der Produktdaten befindet sich der Model Description View. Dieser zeigt passend zum in Bearbeitung befindlichen Produktbaustein die Dokumentation der zugehörigen Produktklasse. Wenn Sie die einmal ausprobieren wollen, dokumentieren Sie z.B. das Attribut produktname im Modell, schließen Sie den Bausteineditor und öffnen ihn erneut.