Die Systemfunktion 'sysLib.setError()' ordnet eine Nachricht einem von mehreren möglichen Containern zu.
Die Nachricht wird angezeigt, wenn die zugehörige Webseite angezeigt wird.
Wenn eine Gültigkeitsprüffunktion die Funktion 'sysLib.setError()' aufruft, wird die Webseite automatisch erneut angezeigt, wenn die Funktion beendet wird.
Die erste der drei für die Funktion unter 'Syntax' gezeigten Signaturen ist in JSF-Handlern und in VGWebTransaction-Programmen verfügbar, während die zweite und dritte Signatur nur für JSF-Handler verfügbar sind:
Sie können einem Feld oder dem JSF-Handler mehrere Nachrichten zuordnen. Die Nachrichten gehen verloren, wenn der JSF-Handler eine forward-Anweisung ausführt oder wenn das VGWebTransaction-Programm eine transfer- oder show-Anweisung ausführt.
Sie können 'sysLib.setError()' in der in der Eigenschaft 'onPostRenderFunction' des JSF-Handlers angegebenen Funktion verwenden, jedoch nicht in den Funktionen, die in den Eigenschaften 'onPostRenderFunction' und 'onConstructionFunction' angegeben sind.
sysLib.setError(
fehlerhaftes_Feld anyPageVariable in,
Nachrichtenschlüssel STRING in
[, Nachrichteneinfügung STRING in])
sysLib.setError(
this enumerationThis in,
Nachrichtenschlüssel STRING in
{, Nachrichteneinfügung STRING in})
sysLib.setError(Nachrichtentext STRING in)
Wenn 'sysLib.setError' über ein VGWebTransaction-Programm ausgegeben wird, dann ist 'fehlerhaftes_Feld ein Feld im VGUI-Datensatz, das in der Anweisung 'show' oder 'converse' oder im Abschnitt 'inputUIRecord' für das Programm angegeben wird.
Ungültiger Dateiname {0}
Das folgende Beispiel zeigt einen Eintrag in der Nachrichtendatei 'errorMessages_en_US.properties':
badname = The name you entered, {0}, is not valid.
userName STRING = getUserName(); // Aufforderung zur Eingabe
rc = validateUserName(userName);
if (rc < 0)
SysLib.setError( SysLib.getMessage( "badname", userName ) );
end
| Plattform | Problem |
|---|---|
| JavaScript-Generierung | Die Funktion 'sysLib.setError()' wird nicht unterstützt. |
| JSF-Handler | Einfügungen für Nachrichten in einer Datentabelle (DataTable) vom Typ 'msgTable' (Nachrichtentabelle) werden unterstützt. Die erste Einfügung ist {0}. |
| Webtransaktionen | Einfügungen für Nachrichten in einer Datentabelle (DataTable) vom Typ 'msgTable' (Nachrichtentabelle) werden unterstützt. Die erste Einfügung ist {1}. |