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.

www.lancom-systems.de

LANCOM Systems GmbH | A Rohde & Schwarz Company | Adenauerstr. 20/B2 | 52146 Würselen | Deutschland | E‑Mail info@lancom.de

LANCOM Logo