Faktor-IPS Product Designer Archetype

Motivation

Um sein eigenes Produktprojekt mit dem Faktor-IPS Product Designer zu verwenden, muss die Spring-Boot-Anwendung lokal ausgeführt werden. Dieser Maven-Archetype hilft dabei, alle wichtigen Einstellungen zu treffen.

Voraussetzungen zur Verwendung

  • Java 21

Durchführung

Generierung des Faktor-IPS Projekts

Ausführen in der Kommandozeile:
mvn archetype:generate -DarchetypeGroupId=org.faktorips.productdesigner -DarchetypeArtifactId=productdesigner-maven-archetype -DarchetypeVersion={projectVersion}

Anschließend werden benötigte Parameter abgefragt.

Aus Eclipse heraus:

Da der Faktor-IPS Product Designer mit Java 21 gebaut wurde, muss das Eclipse mindestens in der Version 2024-09 verwendet werden. Um ein Faktor-IPS Product Designer Projekt zu erstellen, klickt man auf Datei → Neu → Projekt…​ → Maven Projekt. Im ersten Dialog des Wizards darauf achten, dass nicht Erstellen Sie ein einfaches Projekt angehakt ist. Auf der nächsten Seite des Wizards kann nach "org.faktorips.productdesigner" gefiltert werden, und die gewünschte Archetype-Version und somit die gewünschte Faktor-IPS Product Designer Version ausgewählt werden:

Dependencies

Auf der nächsten Seite können dann die Basis-Parameter für das neu anzulegende Projekt eingegeben werden:

Dependencies

Wenn die Checkbox run archetype generation interactively nicht angehakt ist, muss man in der Eclipse-Console nicht mit der Tastatur bestätigen, sondern das Projekt wird gleich erstellt.

Verwendete Parameter

… für das Generieren des Projekts

  • groupId: die Group-ID des Maven-Projekts

  • artifactId: die Artifact-ID des Maven-Projekts

  • version: die Version des Maven-Projekts

  • package: die grundlegende Package-Struktur, z.B. org.faktorips.example

  • PD-ApplicationName: der Name der Applikation, und der Spring-Boot-Klasse ohne dem postfix Application z.B. Hausrat wird zu HausratApplication.java

  • IPS-ProductProjectPath: der Pfad zum Produktprojekt, das bearbeitet oder angezeigt werden soll

  • readOnlyMode: ob der Product Designer im Read-Only-Modus gestartet wird

  • ssoEnabled: true um Single-Sign-On (SSO) zu nutzen, false um den Product Designer ohne Anmeldung (lokal) zu verwenden

  • f10Enabled: true um im Single-Sign-On (SSO)-Modus Einstellung für die Verwendung im Faktor-Zehn-Netz zu verwenden (z.B. F10Role-/TenantMapper)

Single-Sign-On (SSO)

Wenn Single-Sign-On ausgewählt wurde, muss das application.yml um client id, secret und uri ergänzt werden.