Package-Versionen

In der Baumstruktur des Package Managers werden unterhalb eines Packages alle definierten Entwicklungsstände (Versionen) mit dem Symbol icon-package-version.png für Version dargestellt.

Durch Doppelklick auf eine Version wird ein Fenster geöffnet, in dem alle Einstellungen zu der Version vorgenommen werden können.

package-version.png

Package

Name des Package Herstellers (nicht editierbar).

Version Name

Bezeichnung der Version. Es wird empfohlen, ausschließlich gültige Versionsnummern in dem Format "Major.Minor.Build.Revision" (z.B. 3.11 oder 3.11.1.5) zu verwenden. Es funktionieren auch andere Versions-Bezeichnungen, allerdings können diese dann nicht korrekt sortiert werden.

Version ID

Die interne ID der Package-Version (nicht editierbar).

Product Name

Der Name des Produkts. Dieser kann z.B. bei Versions-Informationen innerhalb der End-Anwendung ausgegeben werden.

Assembly Prefix

Kürzel, welches vor die Assemblies und den internen Elementnamen (Komponenten, Forms, Tabellen, …) gehängt werden soll. Der Assembly Prefix kann nur bearbeitet werden, wenn noch kein Compiler ausgeführt wurde bzw. es noch keinen Workspace für diese Package-Version gibt.

Ist das Feld gesperrt, kann diese Sperre mit dem Button Edit aufgehoben werden. Dies hat zur Folge, dass alle Workspaces für diese Package-Version und ALLE davon abhängigen Package-Versionen gelöscht werden. Anschließend müssen alle diese Package-Versionen neu kompiliert werden.

Version State:

  • Open: Die Package-Version ist offen und befindet sich in der Entwicklung. Es gibt keinerlei Einschränkungen bei der Arbeit. Bei jedem Compile mit dem FrameworkCompiler / Compile-Wizard wird ein neuer Compile-Stempel erzeugt – das bedeutet, dass alle anhängigen Package-Version ebenfalls neu kompiliert werden müssen.

  • Sealed: Die Package-Version ist versiegelt. Es können keine Änderungen vorgenommen werden. Es kann sich kein Entwickler mehr an dieser Package-Version anmelden. Damit eine Package-Version in den Status Sealed versetzt werden kann, darf nichts mehr ausgecheckt sein und alle Änderungen müssen mit dem FrameworkCompiler / Compile-Wizard kompiliert sein.

  • Service Release: An der Package-Version können nur Änderungen an Methoden-Inhalten vorgenommen werden – es darf keine Schnittstellen-Änderungen mehr geben. Bei einem FrameworkCompiler / Compile-Wizard bleibt der Compile-Stempel erhalten. Dadurch brauchen abhängige Package-Versionen nicht neu kompiliert werden und es ist ein sehr schneller Update möglich. Siehe auch Service-Release-Modus.

Der Version State kann jederzeit geändert werden. Dabei werden entsprechende Plausibilitäten geprüft, um eine Fehl-Bedienung zu unterbinden.

Button Lock

Damit kann eine Package-Version gesperrt werden, damit sich niemand mehr daran anmelden kann. Mit dem Klick erscheint ein Dialog, in dem eine Begründung eingegeben werden kann. Diese Begründung wird im Login-Dialog angezeigt.

locking-label.png

Falls noch Benutzer angemeldet sind, wird dieser Dialog angezeigt. Hier gibt es die folgenden Möglichkeiten:

  • Cancel: den Vorgang abbrechen.

  • Retry: es erneut versuchen, nachdem z.B. dem Benutzer Bescheid gegeben wurde.

  • Kill User Sessions: die Sitzungen der Benutzer zu beenden. Bei dieser Aktion wird 130 Sekunden gewartet. Das ist die Zeit, die im Extremfall benötigt wird, bis ein Benutzer zum Beenden seiner Sitzung gezwungen wurde. (60 Sekunden bis zur Hinweismeldung + 60 Sekunden bis zum endgültigen Abbruch + 10 Sekunden Reserve)

Während dieser Dialog angezeigt wird, können sich keine neuen Benutzer mehr anmelden.

Dieser Mechanismus wird automatisch verwendet, um eine Package-Version während eines Upgrades vor einer Benutzung abzusichern.

Button Status…

Öffnet einen Dialog zum Festlegen einer Statusmeldung, die jedem Nutzer dieser Package Version beim Einloggen und in der Entwicklungsumgebung selbst angezeigt wird.

package-version-state.png

Wird kein Informationstext angegeben, so wird der Status nicht angezeigt. Ansonsten ist er an den unten aufgeführten Positionen in der Entwicklungsumgebung sichtbar. Wird in der Combobox Name ein Status ausgewählt, dann gelten die Einstellungen, die in dem entprechenden Dialog gepflegt sind und es wird, sofern vorhanden, an allen Stellen zusätzlich der als nächstes greifende Status angezeigt.

  • Login Dialog in der Detailbeschreibung zu einer Package Version:

package-version-login-dialog.png

  • Status Bar im FrameworkDesigner:

package-version-status-bar.png

  • Im Check Out Dialog:

package-version-checkout.png

  • Check In Dialog:

package-version-checkin.png

Bei Status Rot muss im Check-In Dialog zusätzlich eine Begründung eingegeben werden, bevor der Check-In möglich ist. Diese Begründung wird mit dem Zusatz #warning State Red in den Check-In-Kommentar eingefügt.

Über den Menüpunkt Tools / Package Versions States im Package Manager wird dieser Dialog geöffnet. Hier können mehrere Package Version Status gepflegt werden. Wenn mehrere Status den selben Namen haben, werden sie dem Datum entsprechend nacheinander aktiv, sofern der Name an einem Package hinterlegt ist.

package-version-states.png

Last Deployment

Dieses Datum markiert die letzte Auslieferung der Package-Version. Das ist entscheidend für Änderungen im Service-Release-Modus. Alle Strukturen, die vor diesem Datum angelegt wurden, werden in der IDE vor Änderungen geschützt, damit abhängige Package-Versionen nicht in breaking Changes laufen. Strukturen, die nach diesem Datum neu angelegt wurden, können noch bis zur nächsten Auslieferung geändert werden.

Wird der Version State auf Service Release gesetzt, dann markiert dieses Datum automatisch den Start des Service-Release. In der Regel geht das mit der finalen Auslieferung des Releases einher.

Findet eine weitere Auslieferung der Package-Version statt (z.B. am Ende eines Service-Release-Zyklus), dann muss das Datum aktualisiert werden. Mit dem Button Start new Service Release cycle wird das Datum auf den letzten erfolgreich abgeschlossenen Compile-Lauf gesetzt. Damit sind dann auch die im aktuellen Zyklus hinzugefügten Strukturen vor zukünftigen Änderungen geschützt.

FS Version

Framework Studio Version, mit der die Package Version bearbeitet werden kann. (nicht editierbar)

Button Upgrade

Note

nur aktiv, wenn die FS Version der Package-Version kleiner ist als die Version, in der der Package Manager gestartet wurde

Für die Package-Version wird ein Upgrade auf die aktuelle Framework Studio Version durchgeführt.

Warning

Der Upgrade-Vorgang lässt sich nicht rückgängig machen. Das heißt, dass dieses Label mit älteren Framework Studio Versionen nicht mehr verwendet werden kann.

Compile Run

In diesem Feld kann ein Name eingegeben werden, mit dem über die FSConsole.exe gesteuert werden kann, welche Package-Versionen kompiliert werden sollen.

Button Source Ctrl. History …

Öffnet die Source Control History für die aktuelle Package Version. Standardmäßig werden hierbei alle Elemente angezeigt. Sowohl eingecheckte als auch ausgecheckte Elemente.

Button Compile Wizard

Ruft für die Package-Version den Compile Wizard auf.

Auf der Registerkarte Using Hierarchy werden die Package Versionen angezeigt, die von dieser Version verwendet werden. Die Versionen werden in der Verwendungsreihenfolge angezeigt.

Die Using Hierarchy kann von den Requirements wie folgt abweichen:

  1. In der Using Hierarchy können zusätzlich Labels von weiteren Packages aufgeführt werden.

  2. Von einem Label in den Requirements kann ein anderes Label des gleichen Packages in der Using Hierarchy aufgeführt werden.

Auf der Registerkarte Requirements werden tabellarisch die Abhängigkeiten der Version von anderen Packages bzw. Package Versionen dargestellt, also auf welchen Packages in welcher Version das aktuelle Package aufbaut. Diese Information wird beim Import im Repository abgelegt und ist nicht veränderbar.

Die Registerkarte Info stellt interne Informationen zum Kompilierstatus dar.

Auf allen Registerkarten befindet sich ein Button Refresh zum Aktualisieren der dargestellten Informationen.

Warnings

Es besteht die Möglichkeit Warnings, welche der Compiler ausgibt, zu ignorieren. Geben Sie hierfür die entsprechende Warning-Nummer oder Nummern in das Textfeld, getrennt mit einem Komma, ein. Zudem kann auch das Level der Warnings (Level 0 - Level 4) definiert werden. Wird kein Level angegeben, ist es standardmäßig Level 3.

Die verschiedenen Warnings können Sie hier einsehen.

Die Einstellung wird an die Customizing-Packages vererbt. Sie kann ausschließlich durch Nissen & Velten am eNVenta Package (bzw. einem anderen Default-Package) geändert werden.

Base Workspaces freezed since

Gibt das Datum an, seit wann die Workspace-Stände der Basis-Packages fixiert sind.

Mit dem Button Freeze wird das Datum gesetzt und der aktuelle Zustand fixiert. Wird jetzt für diese Package-Version ein neuer Compile-Wizard ausgeführt, dann werden bei diesem Compile-Lauf exakt dieselben Workspaces der Basis-Package-Version verwendet wie beim letzten erfolgreich abgeschlossenen Compile-Lauf - auch wenn es neuere Stände geben sollte. Dadurch greifen keine neuen Änderungen aus den Basis-Packages.

Das Datum kann jederzeit mit dem Button Reset entfernt werden. Dann funktioniert der Compile wieder ganz normal.

Dieses Datum greift nur im eigenen Repository. Diese Information wird nicht mit der Package-Version exportiert.

Beim Export einer solchen Package-Version ist es ratsam, diese inkl. ihrer Basis-Packages zu exportieren. So ist gewährleistet, dass nach dem Import im Ziel-Repository alle Versions-Stände zusammenpassen. Beim Export wird die Checkbox Include Base Packages automatisch gesetzt.

Register Languages

Auf dieser Registerkarte können die Sprachen für die Package-Version definiert werden.

Languages

Eine Sprache besteht aus den folgenden Informationen:

  • Iso-Code: Der ISO 639-1 Code der Sprache. Dieser besteht aus 2 kleinen Buchstaben - z.B. de, en.
  • Name: Der Name der Sprache. Dieser wird in der IDE angezeigt.

An einer Package-Version können beliebig viele Sprachen definiert werden. Diese werden automatisch in die abhängigen Package-Versionen vererbt.

Warning

Auf der Application Startseite werden nur Sprachen angeboten, für die im Wörterbuch mindestens ein MLKey übersetzt ist.

Languages from Base

Diese Liste zeigt die Sprachen aus den Basis-Packages an.

Languages from current Package

In dieser Liste können die Sprachen für die Package-Version gepflegt werden. Es können zusätzliche Sprachen definiert werden

Wird eine Sprache mit einem identischen Iso-Code wie im Basis-Package angelegt, dann überschreibt der Eintrag das Basis-Package. In der IDE wird dann die überschriebene Bezeichnung der Sprache angezeigt.

Note

Wird eine Sprache gelöscht, dann bleiben die Übersetzungen an den Records und im Wörterbuch trotzdem erhalten.