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.