Die control-Datei#

Die control-Datei ist aufgebaut, wie eine INI-Datei. Es gibt bis zu 3 unterschiedliche Sektionen: Product, ProductDependency und ProductProperty.

Product-Sektion#

Die Sektion Product ist verpflichtend. In ihr werden alle wichtigen Schlüssel genannt.

Schlüssel

Wert

type

netboot (Betriebssystem) oder localboot (Programme)

id

ID des Paketes; entspricht dem Verzeichnisnamen

name

Name des Paketes, der in der Oberfläche steht

description

Beschreibung des Paketes

advice

Zusätzliche Hinweise zu dem Pakete; Eintrag muss existieren, kann aber leer bleiben

version

Versionsnummer des Programms

packageVersion

Versionsnummer des Paketes

licenseRequired

Programm benötigt eine Lizenz (optional, wird bei false weggelassen)

setupScript

Name des Skripts für die Installation

uninstallScript

Name des Skripts für die Deinstallation

internet

Internetzugang während der Installation freischalten (optional, wird bei false weggelassen)

autoUpdate

Schaltet die automatische Verteilung von Updates für dieses Paket standardmäßig ab. (optional; wird bei true weggelassen)

homepage

Bietet die Möglichkeit die Webseite des Herstellers zu verknüpfen. (optional, nur IServ 3)

Die id und der Verzeichnisname hat drei mögliche Formatierungen:

  • wenn es einen eindeutigen Hersteller gibt: <hersteller>-<programmname> (Beispiel: microsoft-office-2003)

  • wenn es keinen eindeutigen Hersteller gibt: <programmname> (Beispiel: 7zip)

  • wenn es verschiedene Versionen von dem Programm gibt, die installiert werden können sollen: <hersteller>-<programmname>-<version>

ProductDependency-Sektionen#

Die Sektion ProductDependency ist optional und kann bei Bedarf mehrfach aufgelistet werden. Sie werden verwendet, wenn das zu installierende Paket bestimmte Programme voraussetzt, die vor dem Paket installiert sein müssen.

Schlüssel

Beschreibung

Werte

action

Art der Aktion

setup

requiredStatus

benötigte Status des Programms

installed

requirementType

Art der Abhängigkeit

before

requiredProduct

Benötigtes Programm

<id-des-programms>

Wichtig

Wichtig! Es müssen alle vier Schlüssel vorhanden sein, wenn eine ProductDependency-Sektion verwendet werden soll.

ProductProperty-Sektionen#

Die Sektion ProductProperty ist optional und kann bei Bedarf mehrfach aufgelistet werden. Sie dient der Verwendung von Eigenschaften, z.B. Seriennummern oder Einstellungen.

Schlüssel

Beschreibung

name

Name der Variable in der die Eigenschaft gespeichert wird.

description

Beschreibung der Eigenschaft (wird in der Oberfläche als Beschreibung des Feldes angegeben)

default

Standardwert (optional), Angabe muss in diesem Format erfolgen: [Standardwert]. Der Wert muss innerhalb der eckigen Klammern mit Anführungszeichen umschlossen werden.

type

Typ des Eingabefeldes (optional)

editable

Ist die Eigenschaft frei editierbar (optional)? Legt fest, ob ein Textfeld mit dem Typ unicode frei editierbar ist, wird nur angegeben, wenn der Wert false sein soll, wird ansonsten weggelassen.

values

Vorschläge für Werte (optional), die hier angegebenen Werte werden beim Ausfüllen der Eigenschaft als Vorschlag angeboten, muss in folgendem Format angegeben werden: [Wert1, Wert2, Wert3]. Die Werte selber müssen mit Anführungszeichen umschlossen werden.

helptext

Hilfetext (optional), zeigt einen ergänzenden Text neben der Eigenschaft an (nur IServ 3)

pattern

Platzhalter (optional), wird angezeigt wenn die Eigenschaft nicht ausgefüllt ist und kein Standardwert existiert (nur IServ 3)

Für das Feld type sind folgende Werte möglich:

Wert

Beschreibung

unicode

Textfeld

bool

Ja-/Nein-Auswahlfeld

integer

Nummerisches Eingabefeld, welches Werte größer gleich 0 akzeptiert

password

Passwortfeld mit maskierten Text

license

Markiert die Eigenschaft intern als Seriennummer/Produktschlüssel, verhält sich derzeit ansonsten wie ein Textfeld

licensefile

Markiert die Eigenschaft intern als Lizenzdatei, verhält sich derzeit ansonsten wie ein Textfeld

Wenn der Schlüssel type nicht angegeben wurde, wird als Standardwert unicode verwendet.