Katalog-Client-Skripts
Clientseitige Skripts können Formularen dynamische Effekte und Validierungen hinzufügen. Dabei lassen sich Skripts auf Servicekatalogelemente oder Variablensätze anwenden. Administratoren können auf diese Weise dieselbe Funktionalität verwenden, die auch in anderen Formularen verfügbar ist.
Sie können clientseitige Skripts verwenden, um:
- Variablenwerte abzurufen oder festzulegen
- Variablen auszublenden oder anzuzeigen
- Variablen obligatorisch zu machen
- Validieren Sie die Formularübermittlung.
- dem Einkaufswagen Elemente hinzuzufügen
- Elemente sofort zu bestellen
Überlegungen zu Katalog-Client-Skripts
Die folgenden Aspekte sollten Sie beachten, wenn Sie Katalog-Client-Skripts erstellen.
- Katalog-Client-Skripts werden ausgeführt, sobald ein Benutzer ein Element aus dem Servicekatalog bestellt. Ebenso können Katalog-Client-Skripts ausgeführt werden, sobald der Benutzer ein Katalogelement anfordert und dessen Variablen oder Variablensätze angezeigt werden.
- Damit eine Variable über ein Katalog-Client-Skript abgerufen werden kann, muss sie einen Variablennamen haben. Variablen ohne Namen werden nicht in der Liste der verfügbaren Variablen angezeigt.
- Wenn Sie standardmäßige Client-Skripts auf Formulare des Typs „Angefordertes Element“ oder des Typs „Katalogaufgabe“ anwenden, sollten Sie auf Felder achten, die den gleichen Namen haben wie Variablen. Enthält ein Formular ein Tabellenfeld und eine Variable mit identischem Namen, wird bei der Skriptausführung das Tabellenfeld als Treffer erkannt. In diesem Fall müssen Sie gezielt die Variable abrufen, nach dem Muster
variables.variablenname. (Beispiel:g_form.setValue('variables.replacement', 'false');) - Wenn Sie Datensatzersteller verwenden, um Variablen aus dem Servicekatalog an andere Datensatztypen zu übergeben, werden diese Variablen in den Datensätzen mit einem Variableneditor sichtbar gemacht. Ein Beispiel ist der UI-Formatierer „Change Variable Editor“ in Change Request-Formularen. Sie können diese Variablen mit standardmäßigen Client-Skript-Methoden wie
setDisplay,setMandatory,setValueundgetValuebearbeiten. - Katalog-Client-Skripts können auf Katalogelemente in Assistenten angewendet werden.
- Sie können die API
g_form.refreshSlushbucket(Feldname)verwenden, um Listensammlervariablen zu aktualisieren.
Spezifische Eigenschaften von Katalog-Client-Skripts
Katalog-Client-Skripts sind standardmäßigen Client-Skripts sehr ähnlich. Dennoch gibt es einige wichtige Unterschiede.
- Statt eine Tabelle wie „Incident“ für Ihr Skript auszuwählen, wählen Sie ein Katalogelement oder einen Variablensatz aus. Da Ihr System möglicherweise über eine große Anzahl von Katalogelementen verfügt, empfiehlt es sich, das Katalogelement bzw. den Variablensatz mit einem Referenzfeld auszuwählen. Verwenden Sie keine Auswahlliste, wie sie im Formular für standardmäßige Client-Skripts verwendet wird.
- Katalog-Client-Skripts des Typs onChange() sind mit einer bestimmten Variablen verknüpft, nicht mit einem Feld. Das System befüllt die Auswahlliste mit den Variablennamen automatisch mit allen benannten Variablen aus dem ausgewählten Katalogelement oder Variablensatz.
Katalog-Client-Skripts erstellen
Gehen Sie wie folgt vor, um ein Katalog-Client-Skript zu erstellen:
Prozedur
Beispiele für Katalog-Client-Skripts
Nachfolgend finden Sie Beispiele für Client-Skripts, die gängige Aktionen ausführen.
Variablenwerte abrufen
Verwenden Sie die nachfolgende Syntax, um den Wert einer Katalogvariablen abzurufen. Beachten Sie, dass die Variable einen Namen haben muss. Ersetzen Sie variable_name durch den Namen der Variablen.
g_form.getValue('variable_name');Vom Benutzer in Variablen verwendbare Zeichenanzahl einschränken
Dieses Beispielskript wird ausgeführt, wenn die Variable angezeigt wird, nicht wenn das Element bestellt wird.
function onLoad(){
var sd = g_form.getControl('short_description');
sd.maxLength=80;
}