Productvariant Documentation

Release Notes

Version 22.6.1

In diesem Release wurde das Offline Caching der XSD Dateien hinzugefügt. Damit dies funktioniert muss Faktor-IPS mindestens in der Version 22.6.8 verwendet werden.

Version 22.6.0

Die Produktvarianten Version 22.6 bietet neben dem Update auf Faktor-IPS 22.6.0 und dem Unique-ID-Schalter aus Faktor-IPS 21.12.4 und Produktvarianten 21.12.2 eine neue Option, um zu bestimmen, welcher Runtime-ID-Prefix für Varianten-Bausteine verwendet wird. Dabei stehen zur Auswahl:

FromReferenceProject: Wie bisher wird das Projekt, welches den variierten Baustein enthält (oder ihn referenziert, wenn er aus einer nicht im Workspace vorhandenen Maven-Dependency stammt), genutzt um den Runtime-ID-Prefix für den Variantenbaustein zu bestimmen. Wird der Baustein mit der ID "a.Baustein 2022-01" variiert erhält der Variantenbaustein eine ID wie "a.Baustein_2022-01_Variante 2022-06". Haben unterschiedliche Entwickler das Projekt aus dem der Baustein stammt (z.B. "a") mal im Workspace und mal nur das referenzierende Projekt "b" kann es dazu kommen, dass die ID auch als "b.Baustein_2022-01_Variante 2022-06" generiert wird. Oder aber "v.Component_2022-01_Variant 2022-06", wenn sich nur das Variantenprojekt (mit dem Präfix "v.") im Workspace befindet.
FromVariantProject: Der Prefix für den Variantenbaustein wird immer dem Projekt der Variante entnommen. Wird der Baustein mit der ID "a.Baustein 2022-01" variiert erhält der Variantenbaustein eine ID wie "v.Baustein_2022-01_Variante 2022-06".

Die Konfiguration erfolgt analog der Unique-ID-Konfiguration im XML der .ipsproject-Datei:

<FeatureConfigurations>
 <FeatureConfiguration featureId="org.faktorips.productvariant">
  <Property name="VariantCmptRuntimeIdPrefix" value="FromVariantProject" />
  <!-- ggf. auch <Property name="UseUniqueIds" value="OnlyForVariedComponents" /> -->
 </FeatureConfiguration>
</FeatureConfigurations>

Eine Umstellung ist mit Bedacht zu planen, da durch eine Änderung der Runtime-IDs ggf. eine Migration von Bestandsverträgen, die auf alte IDs verweisen, notwendig wird.

Zusätzlich wurde noch eine Produktvarianten Projekteinstellungsseite eingebaut. Nun ist es möglich die Einstellung zum Runtime-ID-Prefix ähnlich wie bei den Faktor-IPS Code Generator Einstellungen vorzunehmen.