Webgate Anywhere 4.1 - TMLScript Referenz
TMLContext this.waitForAuthUpdates()

Methode this.waitForAuthUpdates(database, timeout)
An Objekt TMLContext
Verwendung Wartet bis Änderungen an einer Authentifizierungs-Datenbank wirksam werden
Beschreibung Diese Methode ist speziell für den Einsatz in Authentifizierungs-Datenbanken konzipiert, also Datenbanken die Daten zu Benutzern und Gruppen für die Anmeldung enthalten. Hier stellt sich des öfteren das Problem dass ein Prozess Anmeldedaten - z.B. ein Kennwort - ändert, jedoch erst dann sicher fortfahren kann wenn diese Daten bereits von der Anmelde-Funktionalität aufgegriffen wurden (was in der Regel mit einer gewissen Zeitverzögerung geschieht).

Daher können solche Prozesse nach der Änderung diese Methode aufrufen, welche die Ausführung solange aufhält, bis alle aktuellen Änderungen effektiv geworden sind. Ein Timeout verhindert dabei dass der Prozess aufgrund eines Fehlers endlos angehalten wird.

Vorgesehene Reihenfolge, z.B. bei der Änderung des Kennwortes für den aktuell angemeldeten Benutzer, ist:
  1. Änderung des Kennwortes im Benutzerdokument
  2. Aufruf von waitForAuthUpdates() mit der DB des Benutzerdokumentes als Parameter
  3. Anschliessende Aktionen die erfordern dass das Update aktiv ist, z.B. die Änderung des Kennwortes in der aktuellen Benutzersession über this.changeSessionPassword()
Parameter database (WGAPI-Objekt WGDatabase) - Die Datenbank welche die Anmeldedaten enthält

timeout (Number) - Zeit in Sekunden welche diese Methode maximal wartet. Wird diese Zeit überschritten so wirft die Methode eine TMLScriptException um zu signalisieren dass das Update-Ende nicht ordnungsgemäß abgewartet wurde.
Verfügbar in
  • WebTML-Seiten und normalen WebTML-Aktionen
  • Master-Aktionen
  • TMLScript-Tasks in Jobs
  • Seitentyp-Events


<< parseHTML() TMLForm >>