Webgate Anywhere 4.1 - TMLScript Referenz

Methode this.label([[container, ] file, ] key [, params]) this.label(database, container, file, key , params [, returnPlaceholder])
An Objekt	TMLContext
Verwendung	Gibt ein Textlabel in der Sprache des WGA-Benutzers zurück.
Beschreibung	Labels sind Textbausteine, die eine eindeutige Adresse besitzen und in mehreren Sprachen hinterlegt werden können. Darüber können mehrsprachige Designs unkompliziert realisiert werden. Weitere Informationen zu Labels sind in der Dokumentation zu WebTML-Tag label zu finden. Die Label-Methode verwendet dieselben Label-Ressourcen, Adressierungs-Methodik und Sprachen-Priorität wie dieser Tag. Es gibt zwei Varianten der label-Methode wie oben skizziert. Eine einfachere Variante 1, welche grundsätzlich auf die aktuelle Design-Datenbank zugreift sowie eine Variante 2, bei welcher die zu verwendenden Design-Datenbank als Parameter angegeben wird.
Parameter	database (WGAPI-Objekt WGDatabase, optional in Variante 2): Design-Datenbank aus welcher die Label-Daten zu beziehen sind, ermittelbar z.B. über Methode this.db(). Wird dies nicht angegeben so wird die aktuelle Design-Datenbank des Scripts verwendet. container (String, optional in Variante 1): File-Container, welcher die Label-Definition enthält, exklusive Sprachkürzel. Wird er nicht angegeben so wird der Default-Container der aktuellen WebTML-Laufzeit verwendet. file (String, optional in Variante 1): Label-Datei welche die Label-Definition enthält, exklusive Dateisuffix. Wird diese nicht angegeben so wird die Default-Labeldatei der aktuellen WebTML-Laufzeit verwendet. key (String): Label-Schlüssel params (Liste von Strings, optional in Variante 1): Werte, welche für Label-Parameter verwendet werden sollen. Der String an Listenposition 0 wird für Parameter 1 verwendet, der String an Listenposition 1 für Parameter 2 usw. Es kann null angegeben werden wenn keine Parameter übergeben werden sollen. returnPlaceholder (Boolean, optional in Variante 2): Bestimmt ob ein Label-Platzhalter zurückgegeben werden soll wenn das Label nicht auffindbar ist, welcher Datei und Schlüssel des gewünschten Labels anzeigt. Standard ist true. Wird dies auf false gesetzt so gibt die Methode null zurück wenn kein Label gefunden werden konnte.
Rückgabewert	Textlabel (String)
Verfügbar in	WebTML-Seiten und normalen WebTML-Aktionen