Semantische Versionierung

Bei der semantischen Versionierung kann die Versionsnummer Eigenschaftendialog von Applikationen, Prozessen und Layouts erstellt und bearbeitet werden. Sie wird nicht automatisch erstellt, sondern manuell und erleichtert damit die Identifizierung der Version, die im Einsatz ist.

Versionenmanager öffnen

Öffnet einen Dialog, in dem Versionsnummern angelegt und verwaltet werden können.

Versionenmanager

Hier wird der Titel der aktuell geöffneten Applikation, des Prozesses oder Layouts angezeigt. Sind bereits Versionen vorhanden, so werden diese hier links aufgelistet. Im rechten Bereich werden die Details der in der linken Spalte markierten Version angezeigt.

Version entfernen

Entfernt die Version, die aktuell in der Spalte "Version" markiert ist.

Version hinzufügen / Version bearbeiten / Version kopieren

Öffnet einen Dialog, in dem eine neue Version hinzugefügt oder die aktuell markierte Version bearbeitet werden kann. Beim Kopieren einer Version wird der Dialog ebenfalls geöffnet, damit vor dem Kopieren eine neue Versionsnummer vergeben werden kann.

Version

Bei der semantischen Versionierung werden Versionsnummern aus drei Stellen zusammengesetzt: Major, Minor und Patch. Sie hat immer das Format <Major Version>.<Minor Version>.<Patch Version>. Die einzelnen Stellen sollten wie folgt erhöht werden:

  • Major Version

    API-inkompatible Änderungen werden veröffentlicht.

  • Minor Version

    neue Funktionen, die kompatibel zur bisherigen API sind, werden veröffentlicht.

  • Patch Version

    Änderungen umfassen ausschließlich API-kompatible Bugfixes.

Vorveröffentlichungs-Version

Mit dieser Einstellung können Zusätze für Vorveröffentlichungsversionen an die Versionsnummer angehängt werden.

Vorschau

Hier sehen Sie eine Vorschau der Versionsnummer.

Details

Datum

Hier kann das Datum der Version eingetragen werden. Wenn Sie eine neue Version anlegen, ist bereits das aktuelle Datum vorbelegt.

Systemvoraussetzungen

Minimale Intrexx Version

Hier kann die entsprechende Intrexx-Version ausgewählt werden. In der Liste finden Sie alle Versionsnummern von Intrexx. Wenn Sie eine neue Version anlegen, ist bereits die aktuell installierte Version vorbelegt.

Weitere Voraussetzungen

Tragen Sie hier Voraussetzungen wie z.B. Datenbank, Applikationen, Connectoren oder empfohlene Apps (z.B. Intrexx Share für Plugins) ein.

Beschreibung

Hier kann ein Changelog erfasst werden. Tragen Sie die neuen oder geänderten Funktionen dieser Version hier ein.

Mehrsprachigkeit

Öffnet jeweils einen Dialog, in dem die Beschreibung in den verschiedenen Portalsprachen eingetragen werden kann.

Vergabe von Versionsnummer einschränken

Die Vergabe von Versionsnummern durch andere Benutzer kann eingeschränkt werden.

Schließen Sie dazu den Portal Manager.

Öffnen Sie die Datei "version.xml" im Portalverzeichnis "internal/application/store/<GUID der Applikation / des Prozesses / des Layouts>" in einem Texteditor. 

<?xml version="1.0" encoding="UTF-8"?>
<v:versions xmlns:v="https://schemas.unitedplanet.de/intrexx/2016/versionmanager/versioninfo/" lock="false">
	<v:version guid="83F4893FA60DD288DD89C3240B5CA70B83E0ED7E" major="1" minor="0" patch="0" creationTime="1501153173848">
		<v:property name="date">2023-10-25T22:00:00Z</v:property>        
		<v:property name="minProductVersion">11000000</v:property>        
		<v:property name="additionalRequirements">            
			<v:text>
				<v:item lang="de"/>
				<v:item lang="en"/>
			</v:text>
		</v:property>
		<v:property name="description">            
			<v:text>
				<v:item lang="de"/>                
				<v:item lang="en"/>            
			</v:text>        
		</v:property>    
	</v:version>
</v:versions>

Ersetzen Sie hier lock="false" mit lock="true" und speichern Sie die Datei. 

<?xml version="1.0" encoding="UTF-8"?>
<v:versions xmlns:v="https://schemas.unitedplanet.de/intrexx/2016/versionmanager/versioninfo/" lock="true">

Hat ein Entwickler die Vergabe von Versionsnummern eingeschränkt, so kann mit Klick auf "Version hinzufügen" im Versionenmanager eine neue Versionsnummer auf Basis der zuletzt vom Entwickler festgelegten Version erstellt werden, indem diese mit einem Zusatz erweitert wird.

Erweiterung

Tragen Sie hier den Zusatz ein.

Callables

Für die semantische Versionierung gibt es die Callables 

$Portal.getApplicationVersionInformation("<appGuid>"))
$Portal.getWorkflowVersionInformation("<wfGuid>"))
$Portal.getLayoutVersionInformation("<layoutDirName>"))

die ein Objekt vom Typ "de.uplanet.lucy.server.auxiliaries.versionmanager.VCVersionInfo" zurückliefern. "VCVersionInfo" hat folgende Methoden:

  • getVersions(): List<VCVersionItem>

  • getCurrentVersion(): VCVersionItem

"VCVersionItem" hat folgende Methoden:

  • getMajorVersion(): int

  • getMinorVersion(): int

  • getPatchVersion(): int

  • getPreReleaseVersion(): String

  • getCustomVersion(): String

  • getDate(): Date

  • getMinProductVersion(): String

  • getAdditionalRequirements(): Map<String, String>

  • getDescriptions(): Map<String, String>

  • getFormattedVersion(): String

So kann z.B. mit Velocity die aktuelle Version einer Applikation im Browser eingeblendet werden: 

$Portal.getApplicationVersionInformation("<GUID der Applikation>").getCurrentVersion().getFormattedVersion()

Informationen zu diesem Thema finden Sie hier.

Weitere Informationen

Versionierung allgemein

Versionierung mit Git