Unterschiedliche Arten von Einstellungen

scripting
settings

#1

Der iNOW UI Client verfügt über verschiedene Einstellungen.

Globale Einstellungen die gespeichert werden

Diese Einstellungen werden im UserProfile gespeichert. Die alten Werte sind auch nach Neustart des Client verfügbar. Eine typische Verwendung sind Platzhalter für Pfade, die sich je nach Installation bei Usern evtl. unterscheiden können. Die Werte gelten für den gesamten Client und sind damit auch sitzungsübergreifend.

Im Scripting können die Werte mit folgenden Befehlen verwendet werden.

Erstellen einer Einstellung

ML.InitSetting("name", "value", "description");

Der Wert für description ist optional und kann weggelassen werden.

Gelöscht werden Einstellungen mit (erst ab Version 1.4)

ML.RemoveSetting("name");

Setzen kann man einen Wert mit

ML.SetSetting("name", "value");

Auslesen kann man einen Wert mit

ML.GetSetting("name", "defaultValue");

Der Wert für defaultValue ist optional und kann weggelassen werden.

Der Anwender kann diese Werte in der Oberfläche ändern.

Globale Einstellungen die nicht gespeichert werden

Diese Einstellungen sind nur im Scripting verfügbar, der Anwender kann darauf keinen Einfluss nehmen.
Die Werte sind sitzungsübergreifend.

Hinzugefügt werden Einstellungen mit

ML.InitRuntimeSetting("name", "value", "description");

Der Wert für description ist optional und kann weggelassen werden.

Gelöscht werden Einstellungen mit (erst ab Version 1.4)

ML.RemoveRuntimeSetting("name");

Setzen kann man einen Wert mit

ML.SetRuntimeSetting("name", "value");

Auslesen kann man einen Wert mit

ML.GetRuntimeSetting("name", "defaultValue");

Der Wert für defaultValue ist optional und kann weggelassen werden.

Einstellungen für einzelne Sitzungen

Diese Einstellungen sind nur im Scripting verfügbar, der Anwender kann darauf keinen Einfluss nehmen.
Die Werte sind für jede Sitzung unterschiedlich.

Hinzugefügt werden Einstellungen mit

SessionSettings.AddSetting("name", "value", "description");

Die Parameter value und description sind hierbei optional.

Gelöscht werden Einstellungen mit

SessionSettings.RemoveSetting("name");

Setzen kann man die Werte mit

SessionSettings.SetValue("name", "value");

Lesen kann man die Werte mit

SessionSettings.GetValue("name");
SessionSettings.GetValue("name", "Defaultvalue");

Folgende Werte sind in den SessionSettings vordefiniert:

SessionId         interne Nummer der Sitzung
DeviceName        Sitzungsname

Wenn die SessionSettings aus einer Methode in einem globalen Kontext abgefragt werden sollen, dann muss dieser Methode die SessionId übergeben werden. Mit der SessionId können folgende Methoden der statischen Klasse ML verwendet werden.

ML.SetRuntimeSetting(sessionId, "name", "value");
ML.GetRuntimeSetting(sessionId, "defaultValue");
ML.RemoveRuntimeSetting(sessionId,"name");

Abfrage des aktuellen Sitzungsnamens (Devicename)
Konfiguration des iNow UI WebClient
pinned #2