Paketeigenschaften

In der ersten Version der Packaging PowerBench mussten Sie die Eigenschaften der Pakete manuell in der Paket-Eigenschaftsdatei "Package.xml", die sich im Paketverzeichnis befindet, einstellen. Ab der Version 2.0 ist dies im grafischen Userinterface möglich, sodass die folgenden Informationen prinzipiell nur zu Ihrer Information dienen. Natürlich können Sie die Eigenschaften auch weiterhin in der Paket-Eigenschaftsdatei bearbeiten, dies wird jedoch nicht empfohlen.

Folgende Eigenschaften sind Stand heute standardmäßig in der Paket-Eigenschaftsdatei vorhanden:

ID
Eindeutige GUID, die das Paket identifiziert. Wird automatisch erzeugt und zur Protokollierung der Ausführung und gegebenenfalls für die Active Setup Registry-Einträge benötigt. Eine Änderung ist nicht empfohlen und führt gegebenenfalls dazu, dass eine bereits erfolgte Installation des Pakets nicht erkannt wird. Im grafischen Userinterface ist diese Eigenschaft Read-Only.
Name
Beim Erstellen des Pakets festgelegter Paketname. Dieser wird auch in den Registern der in der PPB bearbeiteten Paket-Dateien und in der Titelzeile des Fenster angezeigt.
Displayname
Optional: Lokalisierbarer Anzeigename des Pakets.
Description
Optional: Lokalisierbare Beschreibung des Pakets.
Vendor
Optional: Hersteller der Software, die das Paket installiert.
Version
Optional: Version der Software, die das Paket installiert.
DisplayVersion
Optional: Anzeige-Version der Software, die das Paket installiert.
Homepage
Optional: Link zur Homepage der Software, die das Paket installiert.
License
Optional: Angabe zur Lizenz der Software, die das Paket installiert.
LicenseUrl
Optional: Link zur LIzenzinfo der Software, die das Paket installiert.
Revision
Integerwert der Revision des Pakets. Bei Überarbeitung eines Pakets und Neuverteilung an bestehende Clients wird diese Revisionsnummer erhöht.
RevisionComment
Optional: Kommentar zur aktuellen Paket-Revision
Architecture
Optional: Gibt an, ob es sich um ein 32-Bit oder 64-Bit Paket handelt. Wird automatisch eingetragen mit dem Wert der Umgebungsvariablen "Processor_Architecture".
Language
Optional: Sprache der Software, die das Paket installiert. Wird automatisch eingetragen mit der aktuell eingestellten Sprache der Packaging PowerBench.
ScriptDate
Optional: Gibt den Datum und Uhrzeit der Erzeugung des Pakets an. Wird automatisch eingetragen mit der aktuellen Systemzeit.
ScriptAuthor
Optional: Gibt den Autor des Pakets an. Wird automatisch eingetragen mit dem Wert der Umgebungsvariablen "Username".
HasUserPart
Gibt an, ob das Paket einen Benutzerteil enthält. Falls auf 1 oder True gesetzt, werden Active Setup Registry-Einträge erzeugt (vgl. Pakete mit Benutzerteilen). Standardwert für neue Pakete ist 0.
SkipImmediateUserPartExecution
Optional: Legt fest, ob der Benutzerteil für den angemeldeten Benutzer direkt im Anschluss an den Maschinenteil ausgeführt wird oder nicht.
ShowFinalErrorMessage
Optional: Wird diese Einstellung aktiviert, wird im Fehlerfall eine entsprechende Meldung angezeigt. Standardmäßig wird die Meldung unterdrückt.

Benutzerdefinierte Paketeigenschaften

Beginnend mit Version 4.1 der Packaging PowerBench ist es möglich, benutzerdefinierte Paketeigenschaften anzulegen. Dies wird unter anderem dazu verwendet, um die Möglichkeit zu schaffen, den Registry-Pfad für die Protokollierung der Paket-Ausführungen anpassen zu können. Prinzipiell gibt es mehrere Möglichkeiten, wie Sie solche individuellen Eigenschaften definieren können:

Wenn Sie möchten, dass nur Pakete eines bestimmten Typs eine bestimmte Eigenschaft erhalten sollen, so können gehen Sie folgendermaßen vor:

Öffnen Sie die Datei Package.xml im für den jeweiligen Paket-Typ zugeordneten Template-Verzeichnis.
Fügen Sie dort im Knoten <Properties> einen neuen <Property>-Unterknoten hinzu.
Geben Sie den Name, bei Bedarf Typ und den Vorgabewert an.
Speichern Sie die Datei und öffnen Sie die Packaging PowerBench

Wenn Sie in der Folge ein neues Paket basierend auf dieser Vorlage erstellen, erbt das neue Paket die Eigenschaft der Vorlage.

Wenn Sie für alle Pakettypen - unabhängig vom verwendeten Template - eine neue benutzerdefinierte Eigenschaft erzeugen möchten, können Sie dazu die Konfigurationsdatei PackagingPowerBench.exe.config verwenden. Gehen Sie folgendermaßen vor:

Öffnen Sie die Konfigurationsdatei PackagingPowerBench.exe.config im Installationsverzeichnis der PPB mit einem beliebigen Text-Editor.
Suchen Sie die Einstellung NewPackagesDefaultProperties.
Tragen Sie im Wert der Einstellung die neue(n) Eigenschaft(en) ein, die Sie erzeugen möchten. Verwenden Sie dazu das Format <Name der Eigenschaft>=<Wert>. Sofern Sie mehrere Eigenschaften definieren möchten, trennen Sie die Einträge durch Kommata.
Beispiel: Sie könnten einen Wert wie InternalAppID= angeben, um die Eigenschaft InternalAppID zu definieren und keinen Vorgabewert vorzugeben
Speichern Sie die Konfigurationsdatei und öffnen Sie anschließend die Packaging PowerBench, damit die Änderungen wirksam werden.

Hinweis: Unabhängig davon, ob Sie die Eigenschaften in der Package.xml eines Templates oder global in der Konfigurationsdatei definieren, erhalten diese nur Pakete, die nach der vorgenommenen Änderung neu erstellt oder ältere Pakete einer PPB-Vorgängerversion, bei denen die Runtime-Dateien aktualisiert werden.

Den Wert benutzerdefinierter Eigenschaften können Sie standardmäßig nur manuell direkt in der Package.xml des jeweiligen Pakets ändern. Wenn Sie möchten, dass die Eigenschaft auch im User-Interface der PPB über "Verwaltung > Eigenschaften" angezeigt wird und änderbar ist, müssen Sie folgendermaßen vorgehen:

Erstellen Sie im Unterverzeichnis Resources des PPB-Installationsverzeichnisses eine neue Datei namens Custom.PackageData.xml und öffnen Sie diese mit Ihrem favorisierten Editor zur Bearbeitung von XML-Dateien.
Fügen Sie den folgenden (beispielhaften) XML-Code ein:

<?xml version="1.0" encoding="utf-8"?>

<DisplayName>{en} Custom Package Properties {de} Benutzerdefinierte Paketeigenschaften</DisplayName>

<Description>{en} This section contains user-defined package properties {de} Dieser Abschnitt enthält benutzerdefinierte Paketeigenschaften</Description>

</PropertyGroup>

</PropertyGroupData>

<DisplayName>{en} Internal App ID {de} Interne Applikations-ID </DisplayName>

<Description>{en} Internal GUID of the package that references the ticket ID of the packaging request. {de} Interne GUID des Pakets, die auf die Ticket-ID der Paketierungsanforderung referenziert. </Description>

</Property>

</PropertyData>

</PackageData>

Sie können natürlich die Namen und Inhalte der XML-Eigenschaften an Ihre eigenen Anforderungen anpassen. Insbesondere muss aber der Wert der "Name"-Eigenschaft der Property mit dem Name der im Template oder in der Konfigurationsdatei definierten benutzerdefinierten Eigenschaft übereinstimmen.
Speichern sie die XML-Datei und starten Sie die Packaging PowerBench neu. Wenn Sie nun ein Paket öffnen, für das diese Eigenschaft definiert ist (entweder über das Template oder global über die PackagingPowerBench.exe.config), wird diese im Fenster "Verwaltung > Eigenschaften" in dem von Ihnen definierten Abschnitt angezeigt und kann geändert werden.