Verwenden von Packager und Installer für Linux und UNIX › Installationsdialogfelder › Validierungsskripte für Dialogfelder

Validierungsskripte für Dialogfelder

Sie können ein Validierungsskript für Dialogfelder bereitstellen, um die Kombinationen eingegebener Werte in einem Installationsdialogfeld zu validieren. Die Validierungsskriptdatei muss einer Prä-Installationskomponente hinzugefügt werden. Innerhalb eines Dialogfelds können Sie Benutzerdaten des gesamten Dialogfelds oder bestimmter Eingabefelder validieren.

Validierung aller in das Dialogfeld eingegebenen Benutzerdaten

Das Verifikationsskript für Dialogfelder wird ausgeführt, wenn Sie im Installationsdialogfeld auf "Weiter" klicken. Alle in das Installationsdialogfeld eingegebenen Parameterwerte werden über die Shell-Umgebung übergeben. Wenn die Überprüfung erfolgreich ist, gibt das Skript den Wert null (0) zurück. Im Falle eines Fehlers gibt das Skript die Nummer des entsprechenden Fehlertexts im Abschnitt "Resource" der Prototypdatei zurück. Die Nummer für den Fehlertext, auf die verwiesen wird, muss im Bereich zwischen 1 und 255 liegen. Wenn ein entsprechender Fehlertext fehlt, wird die Textnummer in der Fehlermeldung angezeigt.

Im folgenden Beispiel werden zwei eingegebene Werte, $LOCALE und $DATE, überprüft. Wenn ein englisches Gebietsschema eingegeben wurde, enthält das Datumsfeld möglicherweise kein Datum (oder im deutschen Datumsformat).

#!/bin/sh

# Wenn einer der Parameter "$LOCALE" oder "$DATE" nicht festgelegt ist,
# wird die Fehlermeldung 1 angezeigt
[ ! "$LOCALE" -o ! "$DATE" ] && exit 1

# Wenn ein englisches Gebietsschema eingegeben wurde, darf das Datumsfeld
# keine Punkte enthalten
[ "$LOCALE" = "en_US" -a `echo "$DATE" | grep "." 2>/dev/null 1>&2; echo $?` -eq 0 ] && exit 2

# ohne Fehlermeldung beenden
exit 0

Validierung von in bestimmten Eingabefeldern eingegebenen Benutzerdaten

Sie können Validierungsskripte für Textfelder (#textfield), Installationsverzeichnisse (#instdir) und Kennwortfelder (#passwordfield) angeben. Diese Validierungsskripte werden ausgeführt, wenn der Benutzer das Eingabefeld verlässt. Außerdem werden diese Skripte aufgerufen, wenn vor dem Aufrufen des Verifikationsskripts für Dialogfelder auf die Schaltfläche "Weiter" geklickt wird. Der eingegebene Parameterwert wird als Shell-Parameter an das Skript übergeben. Wenn die Überprüfung erfolgreich ist, gibt das Skript den Wert null (0) zurück. Im Falle eines Fehlers gibt das Skript die Nummer des entsprechenden Fehlertexts im Abschnitt "Resource" der Prototypdatei zurück. Die Nummer für den Fehlertext, auf die verwiesen wird, muss im Bereich zwischen 1 und 255 liegen. Wenn ein entsprechender Fehlertext fehlt, wird die Textnummer in der Fehlermeldung angezeigt.

Das folgende Beispiel überprüft, ob ein Verzeichnisname vollständig qualifiziert ist (Parameter "$INSTDIR"):

#!/bin/sh

# Wird der Parameter "$INSTDIR" nicht festgelegt, wird die Fehlermeldung 1 angezeigt
[ ! "$INSTDIR" ] && exit 1

# Wenn der Parameter "$INSTDIR" nicht mit einem Schrägstrich beginnt,
# wird die Fehlermeldung 2 angezeigt
[ `expr "$INSTDIR" : '\(.\)'` != "/" ] && exit 2

# ohne Fehlermeldung beenden
exit 0

Angeben von Protokollinformationen aus dem Validierungsskript

Protokollinformationen können durch die Verwendung des Parameters "PIF_LOG_FILE" in den Validierungsskripten für Dialogfelder wie folgt bereitgestellt werden:

if [ $VERBOSE -eq 1 -a -w "$PIF_LOG_FILE" ]
then
  echo "LOG INFORMATION TEXT" >> "$PIF_LOG_FILE"
fi