Zur Laufzeit wird der VGUIRecord-Abschnitt durch eine UI-Datensatz-Bean
dargestellt. Die unten aufgeführten Befehle können über eine JSP-Datei auf diese Bean zugreifen.
Die Zeichenfolgeklasse wird von allen Get- und Set-Methoden verwendet, die für Variablen mit einer
uiType-Eigenschaft von input, output oder
inputOutput in der für den UI-Datensatz generierten
Java™-Bean implementiert sind.
Implementierte Set- und Get-Methoden für Variablen, die mit einem uiType von
none definiert sind, geben die entsprechende
Java-Klasse für die Variable zurück.
UI-Datensatz-Bean-Schnittstelle
In diesem Abschnitt werden die für die UI-Datensatz-Bean
implementierten Get- und Set-Methoden beschrieben.
Von diesen Methoden werden Informationen zum gesamten VGUIRecord
abgerufen und geändert.
- String getTitle();
- Gibt den Standardtitel der Seite aus der Eigenschaft title des VGUIRecord zurück.
- String getHelpText();
- Gibt den Text aus der Eigenschaft help des VGUIRecord zurück.
- String getGatewayURL();
- Gibt die Gateway-URL zurück und wird als Aktion eines HTML-Formulars verwendet.
- String getSecureGatewayURL();
- Gibt die Gateway-URL mit dem HTTPS-Protokoll zurück und wird als Aktion eines HTML-Formulars verwendet.
- String getPageID();
- Zeichenfolgeform der Nummer, mit der die für den Client bereitgestellte Seite eindeutig gekennzeichnet wird.
- String getAppID();
- Gibt die ID für die Webtransaktion zurück, die dem VGUIRecord zugeordnet wird.
- String getSessionID();
- Gibt die ID für die aktuelle Gateway-Sitzung zurück, die die Übergabeanforderung verarbeitet.
- boolean hasInputError();
- Gibt an, ob ein Feld im VGUIRecord fehlerhaft ist.
- VGDataElement elementNamed(String name);
- Gibt das Element in der UI-Datensatz-Bean namens name zurück.
- VGDataElement getfieldName();
- Gibt den Wert des angegebenen Felds aus dem VGUIRecord zurück.
- void setfieldName(String value);
- Legt für das angegebene Feld aus dem VGUIRecord den angegebenen Wert fest.
VGDataElement-Schnittstelle
Mit diesen Methoden werden Informationen zu einem bestimmten
Feld (VGDataElement) im VGUIRecord abgerufen oder geändert.
- Enumeration getEditTableValues();
- Gibt die Elemente in einer Bearbeitungstabelle zurück, die einem Eingabefeld zugeordnet ist.
- String getErrorMessage();
- Gibt die Fehlernachricht bezüglich des Elements zurück.
- String getGatewayURL();
Gibt für Variablen, bei denen keine Eigenschaft uiType auf
form oder programLink gesetzt ist,
denselben Wert wie die UI-Datensatz-Bean-Version dieser Methode zurück.
Gibt für Variablen, bei
denen eine Eigenschaft uiType auf form oder
programLink gesetzt ist, eine URL-Zeichenfolge mit allen Parametern gemäß der
Definition durch die Linkeigenschaften zurück. Diese Zeichenfolge kann in einem HTML-Element <A> als
HREF verwendet werden.
- String getSecureGatewayURL();
- Entspricht getGatewayURL(), verwendet aber das HTTPS-Protokoll.
- String getHelpText();
- Gibt den Text in der Eigenschaft help für das Feld zurück.
- int getIndex();
- Gibt den Index des Elements zurück.
- String getLabel();
- Gibt die Kennsatz-UI-Eigenschaft einer Variablen zurück. Wenn die Variable ein Feldgruppenelement ist,
wird der für den Index der VGDataElement-Instanz definierte Kennsatz zurückgegeben.
- String getTextValue();
- Gibt den Zeichenfolgewert des Elements mit der gesamten Ausgabeformatierung für die Daten zurück.
- TableModel getTextValuesTable();
- Gibt ein TableModel aller formatierten Textwerte für die Vorkommen und Unterelemente der
VGDataElement-Instanz zurück.
- boolean hasInputError();
- Gibt TRUE zurück, wenn das Element einen Eingabefehler aufweist.
- boolean isDisplayable();
- Gibt TRUE zurück, wenn die einer Übergabeschaltfläche zugeordnete Variable über einen
nicht leeren Wert verfügt.
- boolean isEmpty();
Gibt nur dann TRUE zurück, wenn das Feld eine Feldgruppe ist und der Wert
des über die Eigenschaft numElementsItem angegebenen Felds
null ist.
In allen anderen Fällen gibt die Methode FALSE zurück. In den folgenden Fällen wird
FALSE zurückgegeben:
- Das Feld ist keine Feldgruppe.
- Das Feld ist eine Feldgruppe, aber die Eigenschaft numElementsItem weist einen Nullwert auf.
- Das Feld ist eine Feldgruppe, aber der Wert des über die Eigenschaft
numElementsItem angegebenen Felds ist nicht null.
- boolean isSelected();
- Gibt TRUE zurück, wenn der Index des Elements ein Wert in dem über die Eigenschaft
SelectedIndexItem angegebenen Felds ist.
- Enumeration occurrences();
- Wenn das gewünschte VGDataElement eine Feldgruppe ist, gibt die Methode eine Aufzählung mit den
Elementen in dieser Feldgruppe zurück. Die Anzahl der zurückgegebenen Elemente wird durch den
Wert des Felds in der Eigenschaft numElementsItem beschränkt.
Wenn das Ziel keine Feldgruppe ist, gibt die Methode eine Aufzählung mit nur einem Element zurück.
- Enumeration subElements();
- Gibt eine Aufzählung von VGDataElements zurück, die gültige Unterelemente
(die Eigenschaft uiType ist nicht auf none gesetzt)
der VGDataElement-Instanz sind. Es werden nur die Unterelemente der untersten Ebene
zurückgegeben. Der Index der einzelnen Unterelemente entspricht dem Index der VGDataElement-Instanz.
- void setDatetimeFormat(DateFormat_object);
- Definiert ein Java-Datumsformatobjekt (DateFormat),
um das gültige Format für die Datums-/Uhrzeitwerte anzugeben, die zwischen dem Browser und Schicht 2
ausgetauscht werden. Diese Methode kann nur für Variablen verwendet werden, denen eine Datums- oder
Uhrzeitbearbeitung zugewiesen wurde.