Felder und Attribute

Der Assistent verwendet Felder, um dem Benutzer Informationen anzuzeigen und ihm die Möglichkeit zur Eingabe von Informationen zu geben. Jedes Feld entspricht einer internen Variablen.

Der Assistent definiert ein Feld durch die Angabe des entsprechenden Schlüsselwortes, gefolgt von einer internen Variablen in der gleichen Zeile. In weiteren Zeilen folgen optional die Attribute für das Feld.

Ein Beispiel für eine Felddefinition im Assistenten:

 selection_buttons select_inet
  description   str.inet_Selection
  button_text   str.inet_PPPoE, str.inet_IPoE

Dieses Feld erzeugt eine Gruppe von Optionsschaltflächen, von denen der Benutzer nur eine aktivieren kann. Der Assistent setzt den in der String-Tabelle definierten Text str.inet_Selection als Beschreibung neben das Feld. Für die Optionsschaltflächen selbst zeigt der Assistent die Texte str.inet_PPPoE und str.inet_IPoE an. Nach der Auswahl einer Option durch den Benutzer schreibt der Assistent den gewählten Wert in die interne Variable wizard.select_inet.

Folgende Felder können Sie im Assistenten verwenden:

check_local_ip

Dieses Feld prüft, ob der Assistent zuvor die IP-Adresse des Gerätes verändert hat und leitet den Benutzer auf die entsprechende HTML-Seite weiter. Mögliche Attribute:

destination: Ziel für die Weiterleitung als FQDN oder IPv4-Adresse.
timeout: Wartezeit vor der Weiterleitung.

check_time

Dieses Feld prüft, ob das Gerät über eine gültige Zeitinformation verfügt. Mögliche Attribute:

success_jump: Label der Seite, die der Assistent bei erfolgreicher Prüfung öffnet.
fail_jump: Label der Seite, die der Assistent bei nicht erfolgreicher Prüfung öffnet.
limit: Maximale Anzahl der Prüfungen, bevor der Assistent die Prüfung als erfolglos ansieht. Setzen Sie das Limit auf den Wert '0', um die Prüfungen ohne Limit fortzusetzen.
timeout: Wartezeit zwischen zwei Prüfungen.

entryfield_hex

Dieses Feld dient zur Eingabe von hexadezimalen Werten, z. B. MAC-Adressen. Mögliche Attribute:

description: Beschreibung des Feldes in der HTML-Darstellung
max_len: Maximale Anzahl der Zeichen, die der Benutzer in dieses Feld eintragen kann
never_empty: Der Wert '1' für dieses Attribut kennzeichnet ein Feld, welches der Benutzer nicht freilassen darf.
add_to_charset: Fügt zusätzliche Zeichen zum standardmäßig verwendeten Eingabezeichensatz hinzu.
default_value: Standardwert

entryfield_ipaddress

Dieses Feld dient zur Eingabe von IPv4-Adressen. Mögliche Attribute:

description: Beschreibung des Feldes in der HTML-Darstellung
never_empty: Der Wert '1' für dieses Attribut kennzeichnet ein Feld, welches der Benutzer nicht freilassen darf.
never_zero: Der Wert '1' für dieses Attribut kennzeichnet ein Feld, welches nicht den Wert '0' enthalten darf.
add_to_charset: Fügt zusätzliche Zeichen zum standardmäßig verwendeten Eingabezeichensatz hinzu.
default_value: Standardwert

entryfield_numbers

Dieses Feld dient zur Eingabe von Telefonnummern. Mögliche Attribute:

description: Beschreibung des Feldes in der HTML-Darstellung
max_len: Maximale Anzahl der Zeichen, die der Benutzer in dieses Feld eintragen kann
never_empty: Der Wert '1' für dieses Attribut kennzeichnet ein Feld, welches der Benutzer nicht freilassen darf.
add_to_charset: Fügt zusätzliche Zeichen zum standardmäßig verwendeten Eingabezeichensatz hinzu.
default_value: Standardwert

entryfield_numeric

Dieses Feld dient zur Eingabe von Zahlen. Mögliche Attribute:

description: Beschreibung des Feldes in der HTML-Darstellung
range_min: Minimaler Wert, den der Benutzer in dieses Feld eintragen kann
range_max: Maximaler Wert, den der Benutzer in dieses Feld eintragen kann
signed_value: Ermöglicht die Angabe eines numerischen Wertes mit Vorzeichen
never_empty: Der Wert '1' für dieses Attribut kennzeichnet ein Feld, welches der Benutzer nicht freilassen darf.
add_to_charset: Fügt zusätzliche Zeichen zum standardmäßig verwendeten Eingabezeichensatz hinzu.
default_value: Standardwert
unit: Die Einheit des Wertes, welchen der Assistent in der HTML-Darstellung nach dem Eingabefeld anzeigt.

entryfield_text

Dieses Feld dient zur Eingabe von Texten. Mit dem Attribut hidden dient das Feld zur Eingabe von Passwörtern. Mögliche Attribute:

description: Beschreibung des Feldes in der HTML-Darstellung
hidden: Kennzeichnet ein Feld, in welches der Benutzer Kennwörter einträgt.
add_to_charset: Fügt zusätzliche Zeichen zum standardmäßig verwendeten Eingabezeichensatz hinzu.
convert_to_upper: Wandelt die Eingabe des Benutzers in Großbuchstaben um
max_len: Maximale Anzahl der Zeichen, die der Benutzer in dieses Feld eintragen kann
min_len: Minimale Anzahl der Zeichen, die der Benutzer in dieses Feld eintragen kann
never_empty: Der Wert '1' für dieses Attribut kennzeichnet ein Feld, welches der Benutzer nicht freilassen darf.
unit: Die Einheit des Wertes, welchen der Assistent in der HTML-Darstellung nach dem Eingabefeld anzeigt.

entryfield_textwithlist

Dieses Feld dient zur Eingabe von Texten. Außerdem kann der Benutzer aus einer Reihe von vordefinierten Werten auswählen. Mögliche Attribute:

description: Beschreibung des Feldes in der HTML-Darstellung
default_value: Standardwert
max_len: Maximale Anzahl der Zeichen, die der Benutzer in dieses Feld eintragen kann
item_value: Liste mit vordefinierten Werten, die der Benutzer für dieses Feld auswählen kann

onoff_switch

Dieses Feld erzeugt ein einfaches Kontrollkästchen. Mögliche Attribute:

description: Beschreibung des Feldes in der HTML-Darstellung
value_list: Liste der beiden Werte, welche das Kontrollkästchen annehmen kann
default_selection: Standardwert

page_switch

Dieses Feld erzeugt einen Link, über den der Benutzer zu einer von mehreren anderen HTML-Seiten des Assistenten wechseln kann. Mögliche Attribute:

page_description: Kommaseparierte Liste mit Text-Strings oder Referenzen auf Strings zur Beschreibung der möglichen Link-Ziele.
page_label: Kommaseparierte Liste mit Seiten-Labels der möglichen Link-Ziele.
description: Beschreibung des Feldes in der HTML-Darstellung

ping_barrier

Dieses Feld verzögert die weitere Ausführung des Assistenten, bis ein Ping zu dem verwendeten Ziel erfolgreich beantwortet wurde. Mögliche Attribute:

destination: Zieladresse für den Ping.
loopback: Loopback-Adresse, die der Ping anstelle der standardmäßigen Antwortadresse verwendet
success_jump: Label der Seite, die der Assistent bei erfolgreichem Ping öffnet.
fail_jump: Label der Seite, die der Assistent bei nicht erfolgreichem Ping öffnet.
limit: Maximale Anzahl der Pings, bevor der Assistent die Prüfung als erfolglos ansieht. Setzen Sie das Limit auf den Wert '0', um die Pings ohne Limit fortzusetzen.
timeout: Wartezeit zwischen zwei Pings.

popup

Dieses Feld öffnet die angegebene Zieladresse in einem Popup-Fenster.

Anmerkung: Die Zieladresse kann Variablen enthalten (siehe Variablen).

readonly_text

Dieses Feld erzeugt ein Feld ohne Eingabemöglichkeit. Der Assistent kann diese Felder nutzen, um Text anzuzeigen. Mit dem Attribut hidden kann der Assistent interne Variablen definieren. Mögliche Attribute:

description: Beschreibung des Feldes in der HTML-Darstellung
unit: Die Einheit des Wertes, welchen der Assistent in der HTML-Darstellung nach dem Eingabefeld
hidden: Kennzeichnet ein verstecktes Feld.

selection_buttons

Dieses Feld erzeugt eine Gruppe von Optionsschaltflächen, von denen der Benutzer nur eine aktivieren kann. Mögliche Attribute:

description: Beschreibung des Feldes in der HTML-Darstellung
button_text: Kommaseparierte Liste mit Text-Strings oder Referenzen auf Strings zur Beschreibung der einzelnen Optionsschaltflächen.
button_value: Kommaseparierte Liste mit Text-Strings mit den Werten der einzelnen Optionsschaltflächen.

selection_list

Dieses Feld erzeugt eine Auswahlliste (Drop-Down-Liste), aus welcher der Benutzer einen Wert auswählen kann. Mögliche Attribute:

description: Beschreibung des Feldes in der HTML-Darstellung
item_text: Kommaseparierte Liste mit Text-Strings oder Referenzen auf Strings zur Beschreibung der einzelnen Listeneinträge.
item_value: Kommaseparierte Liste mit Text-Strings mit den Werten der einzelnen Listeneinträge.
default_selection: Standardwert

static_text

Dieses Feld erzeugt einen statischen Text auf der HTML-Seite, der als Referenz auf einen Text-String dem Feldnamen folgt.