GlideForm (g_Form) – Client

Die GlideForm Die API bietet Methoden zum Anpassen von Formularen.

Nur verwenden GlideForm Methoden auf dem Client. Sie können diese Methoden verwenden, um anwenderdefinierte Änderungen an der Formularansicht von Datensätzen vorzunehmen. Alle Validierungen von Beispielen wurden mithilfe von Client-Skripts durchgeführt.

Sie können einige dieser Methoden auch in anderen Client-Skripts verwenden (z. B. Katalog-Client-Skripts oder Assistenten-Client-Skripts). Sie müssen dies jedoch zuerst testen, um festzustellen, ob sie wie erwartet funktionieren.

Hinweis:

Die Methoden getControl(), getHelpTextControl(), getElement() und getFormElement() sind für Mobilgeräte veraltet. Für Informationen zur Verwendung GlideForm Informationen zu Mobilgeräten finden Sie unter Mobile Client GlideForm (g_Form) – Skripting und Migration .

Es ist kein Konstruktor für vorhanden GlideForm Klasse. Zugriff GlideForm Methoden, die verwenden G_Form Globales Objekt.

GlideForm – addDecoration(String fieldName, String icon, String title)

Fügt ein Symbol auf der Bezeichnung eines Felds hinzu.

Das zweimalige Hinzufügen desselben Elements wird verhindert. Sie können jedoch dasselbe Symbol mit einem anderen Titel hinzufügen.

Hinweis:

Diese Methode wird von nicht unterstützt Servicekatalog.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Feldname.
icon	Zeichenfolge	Name des Symbols, das neben dem angegebenen Feld angezeigt werden soll. Gültige Werte: icon-add Symbolwarnung icon-book Symbol-Buch-öffnen icon-calendar Symbolkarten Symbol-Einkaufswagen-voll Symbol-Katalog Symbol-Check-Circle icon-cog Symbolkommentar Symbol-Konsole Symbol-Dashboard icon-database Symbol-Löschen Symbol-Drawer Icon-Bearbeitung icon-filter Symbolordner Symbol-Formular icon-help Symbol-Startseite Symbol-Bild icon-info Symbolbezeichnung icon-lightbulb Symbolliste Symbol-Livefeed icon-locked icon-mail Icon-mobil Icon-New-Ticket Symbol – Büroklammer Symbol-Power Symbol-Skript icon-search Symbol-sortieren-aufsteigend Symbol-Stern Symbol-Stern-leer Symbol-Registerkarte Symbol-Papierkorb icon-tree icon-tree-right Symbol-Anwender icon-user-group Symbolansicht
Titel	Zeichenfolge	Titel für das Symbol.

Tabelle : 2. Ausgabe

Typ	Beschreibung
void

g_form.addDecoration('caller_id', 'icon-star', 'preferred member');

GlideForm – addDecoration(String fieldName, String icon, String title, String color)

Fügt ein Symbol auf der Bezeichnung eines Felds hinzu.

Das zweimalige Hinzufügen desselben Elements wird verhindert. Sie können jedoch dasselbe Symbol mit einem anderen Titel hinzufügen.

Hinweis:

Diese Methode wird nicht vom Servicekatalog unterstützt.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Feldname.
icon	Zeichenfolge	Name des Symbols, das neben dem angegebenen Feld angezeigt werden soll. Gültige Werte: icon-add Symbolwarnung icon-book Symbol-Buch-öffnen icon-calendar Symbolkarten Symbol-Einkaufswagen-voll Symbol-Katalog Symbol-Check-Circle icon-cog Symbolkommentar Symbol-Konsole Symbol-Dashboard icon-database Symbol-Löschen Symbol-Drawer Icon-Bearbeitung icon-filter Symbolordner Symbol-Formular icon-help Symbol-Startseite Symbol-Bild icon-info Symbolbezeichnung icon-lightbulb Symbolliste Symbol-Livefeed icon-locked icon-mail Icon-mobil Icon-New-Ticket Symbol – Büroklammer Symbol-Power Symbol-Skript icon-search Symbol-sortieren-aufsteigend Symbol-Stern Symbol-Stern-leer Symbol-Registerkarte Symbol-Papierkorb icon-tree icon-tree-right Symbol-Anwender icon-user-group Symbolansicht
Titel	Zeichenfolge	Titel für das Symbol.
Farbe	Zeichenfolge	CSS-Farbe.

Tabelle : 4. Ausgabe

Typ	Beschreibung
void

g_form.addDecoration('caller_id', 'icon-star', 'Mark as Favorite', 'color-green');

GlideForm – addErrorMessage(String message)

Zeigt die angegebene Fehlermeldung oben im Formular an.

Diese Meldung wird ungefähr vier Sekunden lang angezeigt und dann ausgeblendet. Diese Zeitüberschreitung kann derzeit nicht konfiguriert werden.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Meldung, die angezeigt werden soll.

Tabelle : 6. Ausgabe

Typ	Beschreibung
void

g_form.addErrorMessage('This is an error');

GlideForm – addFormMessage(Zeichenfolgennachricht, Zeichenfolgentyp, Objektoptionen)

Zeigt eine Floating-Formularnachricht am oberen Rand des Formulardetailabschnitts an. Die Nachricht deckt keine UI-Aktionen ab.

Siehe auch:

• ClearAllFormMessages()
• ClearFormMessages()

Tabelle : 7. Parameter

Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Meldung, die angezeigt werden soll.
type	Zeichenfolge	Typ der Nachricht. Gültige Werte: Fehler Info Warnung
Optionen	Objekt	Optional. Schaltflächen, die der Formularnachricht hinzugefügt werden sollen, und alle Metadaten, die zum behandeln eines Schaltflächenklicks erforderlich sind. { buttons: [Array], meta: {Object} }
Optionen.Schaltflächen	Array	Liste der Schaltflächen, die der Formularnachricht hinzugefügt werden sollen. buttons: [ { actionName: "String", label: "String" } ]
Optionen.Schaltflächen.actionName	Zeichenfolge	Name, der von verwendet wird FORM_MESSAGE_BUTTON_CLICKED Ereignis-Handler zum Bestimmen der Schaltfläche, auf die geklickt wurde. Beispiel: Wenn Sie eine Schaltfläche mit hinzufügen actionName Mir_zuweisen , Sie müssen in einen Ereignis-Handler erstellen UIB Auf der FORM_MESSAGE_BUTTON_CLICKED Ereignis, das nur ausgeführt wird, wenn actionNameIst Zugewiesen_mir .
Optionen.Schaltflächen.Bezeichnung	Zeichenfolge	Text, der auf der Schaltfläche angezeigt werden soll.
Optionen.Meta	Objekt	Ordnen Sie alle Metadaten zu, die für die Verarbeitung des Schaltflächenklicks erforderlich sind, formatiert als Schlüssel-Wert-Paare. meta: { 'key': 'value' } Beispiel: Für Mir zuweisen Schaltfläche, der für den Ereignis-Handler die sys_ID des Anwenders benötigt, dem der Datensatz zugewiesen werden soll.

Tabelle : 8. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Formularnachrichten jedes Typs hinzugefügt werden.

g_form.addFormMessage('info message','info');
g_form.addFormMessage('warning message','warning');
g_form.addFormMessage('error message','error');
g_form.addFormMessage('info2 message','info');
g_form.addFormMessage('warning2 message','warning');
g_form.addFormMessage('error2 message','error');
g_form.addFormMessage('Would you like to reassign this to yourself?', 'info', {buttons: [{label: "Assign to me", actionName: "assign_to_me"}], meta: {'userId': '46d44a23a9fe19810012d100cca80666'}});

GlideForm – addHighMessage(Zeichenfolgennachricht)

Zeigt oben im Formular eine Nachricht mit hoher Priorität an.

Diese Meldung wird ungefähr vier Sekunden lang angezeigt und dann ausgeblendet. Diese Zeitüberschreitung kann derzeit nicht konfiguriert werden.

Tabelle : 9. Parameter

Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Nachricht mit hoher Priorität, die im Formular angezeigt werden soll.

Tabelle : 10. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie oben im Formular eine Nachricht mit hoher Priorität angezeigt wird.

g_form.addHighMessage("This is a high priority message");

GlideForm – addInfoMessage(String message)

Fügt die angegebene Informationsnachricht oben im Formular hinzu.

Diese Meldung wird ungefähr vier Sekunden lang angezeigt und dann ausgeblendet. Diese Zeitüberschreitung kann derzeit nicht konfiguriert werden.

Tabelle : 11. Parameter

Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Meldung, die angezeigt werden soll.

Tabelle : 12. Ausgabe

Typ	Beschreibung
void

g_form.addInfoMessage('The top five fields in this form are mandatory');

GlideForm – addLowMessage(Zeichenfolgennachricht)

Zeigt oben im Formular eine Nachricht mit niedriger Priorität an.

Diese Meldung wird ungefähr vier Sekunden lang angezeigt und dann ausgeblendet. Diese Zeitüberschreitung kann derzeit nicht konfiguriert werden.

Tabelle : 13. Parameter

Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Nachricht mit niedriger Priorität, die im Formular angezeigt werden soll.

Tabelle : 14. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie oben im Formular eine Nachricht mit niedriger Priorität angezeigt wird.

g_form.addLowMessage(“This is a low priority message"); 

GlideForm – addModerateMessage(Zeichenfolgennachricht)

Zeigt oben im Formular eine Meldung mit Priorität „Mittel“ an.

Diese Meldung wird ungefähr vier Sekunden lang angezeigt und dann ausgeblendet. Diese Zeitüberschreitung kann derzeit nicht konfiguriert werden.

Tabelle : 15. Parameter

Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Nachricht mit mittlerer Priorität, die im Formular angezeigt werden soll.

Tabelle : 16. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie oben im Formular eine Meldung mit mittlerer Priorität angezeigt wird.

g_form.addModerateMessage("This is a moderate priority message");

GlideForm – addOption(String fieldName, String choiceValue, String choiceLabel)

Fügt eine Auswahl am Ende eines angegebenen Auswahllistenfelds hinzu.

Tabelle : 17. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des Felds, in dem die Auswahlfeldoption hinzugefügt werden soll.
choiceValue	Zeichenfolge	Wert, der in der Datenbank gespeichert werden soll.
choiceLabel	Zeichenfolge	Anzuzeigender Wert.

Tabelle : 18. Ausgabe

Typ	Beschreibung
void

g_form.addOption('priority', '6', '6 - Really Low');

GlideForm – addOption(String fieldName, String choiceValue, String choiceLabel, Number choiceIndex)

Fügt dem Listenfeld an der angegebenen Position eine Auswahl hinzu.

Hinweis:

Doppelte Listenbezeichnungen werden in nicht unterstützt Serviceportal. Beispielsweise werden Elemente mit Bezeichnungstext, der einer anderen Bezeichnung entspricht, ignoriert und der Liste nicht hinzugefügt.

Tabelle : 19. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des Felds, in dem die Auswahlfeldoption hinzugefügt werden soll.
choiceValue	Zeichenfolge	Wert, der in der Datenbank gespeichert werden soll.
choiceLabel	Zeichenfolge	Anzuzeigender Wert.
choiceIndex	Zahl	Reihenfolge der Auswahl in der Liste. Der Index ist ein Null-basiertes Array.

Tabelle : 20. Ausgabe

Typ	Beschreibung
void

g_form.addOption('priority', '2.5', '2.5 - Moderately High', 3);

GlideForm – addSuccessMessage(Zeichenfolgennachricht)

Zeigt oben im Formular eine Erfolgsmeldung an.

Diese Meldung wird ungefähr vier Sekunden lang angezeigt und dann ausgeblendet. Diese Zeitüberschreitung kann derzeit nicht konfiguriert werden.

Tabelle : 21. Parameter

Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Erfolgsmeldung, die im Formular angezeigt werden soll.

Tabelle : 22. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie oben im Formular eine Nachricht angezeigt wird, die eine Erfolgsmeldung bestätigt.

g_form.addSuccessMessage("This is a success message");

GlideForm – ClearAllFormMessages()

Entfernt alle Formularnachrichten eines beliebigen Typs.

Siehe auch:

• AddFormMessage()
• ClearFormMessages()

Tabelle : 23. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 24. Ergebnisse

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie alle Nachrichten aus dem Formular löschen.

g_form.clearAllFormMessages();

GlideForm – ClearFormMessages (Zeichenfolgentyp)

Entfernt alle Formularnachrichten eines angegebenen Typs.

Siehe auch:

• AddFormMessage()
• ClearAllFormMessages()

Tabelle : 25. Parameter

Name	Typ	Beschreibung
type	Zeichenfolge	Typ der Nachricht. Gültige Werte: Fehler Info Warnung

Tabelle : 26. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie alle Fehlermeldungen aus dem Formular gelöscht werden.

g_form.clearFormMessages('error');

GlideForm – clearMessages()

Entfernt alle Informations- und Fehlermeldungen oben im Formular.

Entfernt Informations- und Fehlermeldungen, die mit g_form.addInfoMessage() und g_form.addErrorMessage() hinzugefügt wurden.

Tabelle : 27. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 28. Ergebnisse

Typ	Beschreibung
void

g_form.clearMessages();

GlideForm – clearOptions(String fieldName)

Entfernt alle Optionen aus der angegebenen Auswahlliste.

Tabelle : 29. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des Felds, für das die Auswahloptionen gelöscht werden sollen.

Tabelle : 30. Ausgabe

Typ	Beschreibung
void

GlideForm – clearValue(String fieldName)

Entfernt alle Werte aus dem angegebenen Feld.

Tabelle : 31. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des zu löschenden Felds.

Tabelle : 32. Ausgabe

Typ	Beschreibung
void

GlideForm – disableAttachments()

Verhindert, dass dem Formular Dateianhänge hinzugefügt werden.

Diese Methode ist nicht auf der mobilen Plattform verfügbar. Wenn diese Methode auf einer mobilen Plattform ausgeführt wird, erfolgt keine Aktion.

Tabelle : 33. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 34. Ergebnisse

Typ	Beschreibung
void

GlideForm – disableChoice(String fieldName, String choiceValue)

Deaktiviert programmgesteuert eine bestimmte Auswahl im Dropdown-Feld, wenn die Auswahl vorhanden ist. Wenn die Auswahl bereits deaktiviert ist, werden keine Änderungen vorgenommen.

Tabelle : 35. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Feldname der zu deaktivierenden Auswahl. Datentyp: Zeichenfolge
choiceValue	Zeichenfolge	Wert der zu deaktivierenden Auswahl. Datentyp: Zeichenfolge

Tabelle : 36. Ausgabe

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob die angegebene Auswahl im Formular deaktiviert oder aktiv ist. Gültige Werte: Wahr: Auswahl ist deaktiviert. Falsch: Option ist bereits deaktiviert oder wurde nicht gefunden. Datentyp: Boolesch

Das folgende Beispiel ruft auf DisableChoice() Deaktiviert die Auswahl „Loading_Dock“ im Formularfeld „Delivery_location“.

if (g_form.getValue('address_type') == 'home') {
	g_form.disableChoice('delivery_location', 'loading_dock');
}

// Only itil_admin users can select the "Closed" option  

function onLoad() {
	if (g_user.hasRole('itil_admin')) return;

	if (g_form.getValue('incident_state') != '7')
		g_form.disableChoice('incident_state', 7);

	if (g_form.getValue('state') != '7') {
		g_form.disableChoice('state', 7);
	}

}

GlideForm – enableAttachments()

Ermöglicht das Hinzufügen von Dateianhängen zum Formular. Zeigt das Büroklammersymbol.

Diese Methode ist nicht auf der mobilen Plattform verfügbar. Wenn diese Methode auf einer mobilen Plattform ausgeführt wird, erfolgt keine Aktion.

Tabelle : 37. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 38. Ergebnisse

Typ	Beschreibung
void

GlideForm – enableChoice(String fieldName, String choiceValue)

Aktiviert programmgesteuert eine bestimmte Auswahl im Dropdown-Feld, wenn die Auswahl vorhanden ist. Wenn die Option bereits aktiviert ist, werden keine Änderungen vorgenommen.

Tabelle : 39. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Feldname der zu aktivierenden Auswahl.
choiceValue	Zeichenfolge	Wert der zu aktivierenden Auswahl.

Tabelle : 40. Ausgabe

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob die angegebene Auswahl erfolgreich aktiviert wurde. Gültige Werte: Wahr: Auswahl ist aktiviert. Falsch: Auswahl ist bereits aktiviert oder wurde nicht gefunden. Datentyp: Boolesch

Das folgende Beispiel ruft auf Aktivieren () So aktivieren Sie eine neue Dropdown-Auswahl: 1 , In Priorität Formularfeld.

var shortDescription = g_form.getValue('shortDescription');

// Allow priority 1 selection if short description mentions security 
if (shortDescription.includes('security')) {
	var p1Choice = g_form.getChoice('priority', '1');
	g_form.enableChoice('priority', '1');
}

GlideForm – Flash (Zeichenfolgenfeldname, Zeichenfolgenfarbe, Zahlenanzahl)

Verwenden Sie , um auf ein Feld aufmerksam zu machen. Blinkt die angegebene Farbe für eine angegebene Dauer im angegebenen Feld.

Diese Methode wird von nicht unterstützt Servicekatalog.

Diese Methode ist nicht auf der mobilen Plattform verfügbar. Wenn diese Methode auf einer mobilen Plattform ausgeführt wird, erfolgt keine Aktion.

Tabelle : 41. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Feld, das hervorgehoben werden soll, im folgenden Format: „<table-name>.<field-name>“ .
Farbe	Zeichenfolge	RGB-Farbe oder akzeptable CSS-Farbe.
count	Anzahl	Wie lange die Bezeichnung blinkt. Gültige Werte: 2: Blinkt 1 Sekunde lang 0: Blinkt 2 Sekunden lang -2: Blinkt 3 Sekunden lang -4: Blinkt 4 Sekunden lang

Tabelle : 42. Ausgabe

Typ	Beschreibung
void

g_form.flash("incident.number", "#FFFACD", 0);

GlideForm – getActionName()

Gibt den neuesten Aktionsnamen oder für ein Client-Skript die sys_id der angeklickten UI Action zurück.

Hinweis:

In Assistenten-Client-Skripts nicht verfügbar.

Tabelle : 43. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 44. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Name der aktuellen Aktion oder sys_ID der angeklickten UI-Aktion.

function onSubmit() {
   var action = g_form.getActionName();
   alert('You pressed ' + action);
}

GlideForm – getAnnotationByName(Zeichenfolgenname)

Gibt eine Formularanmerkung eines bestimmten Namens zurück.

Anmerkungen Sind visuelle Trennzeichen zwischen Formularelementen oder Blöcken von farbigem Text, die zum Hervorheben von Formularelementen verwendet werden. Verwenden GlideForm – getAnnotationByName(Zeichenfolgenname) Um alle Anmerkungen in einem Formular zurückzugeben.

Tabelle : 45. Parameter

Name	Typ	Beschreibung
name	Zeichenfolge	Der Name der zurückzugebenden Anmerkung. Tabelle: Formularanmerkungen [sys_ui_annotation], Feld: Name

Tabelle : 46. Rückgaben

Eigenschaft	Beschreibung
Array von Objekten	Inhalt der Anmerkung. Datentyp: Array von Objekten [{content: "String", name: "String", visible: Boolean}]
Array.Inhalt	Text der zurückgegebenen Anmerkung. Datentyp: Zeichenfolge
array.name	Name der zurückgegebenen Anmerkung. Datentyp: Zeichenfolge Tabellenspeicherort: Formularanmerkungen [sys_ui_annotation], Feld: Name
Array.sichtbar	Kennzeichnung, die angibt, ob die Anmerkung im Formular sichtbar ist. Gültige Werte: Wahr: Die Anmerkung ist sichtbar. Falsch: Die Anmerkung ist nicht sichtbar. Datentyp: Boolesch

Das folgende Beispiel zeigt die Verwendung von GetAnnotationByName() Methode zum Abrufen einer Formularanmerkung gemäß ihrem angegebenen Namen, Test-annotation-msg-1.

   var sampleAnnotation = g_form.getAnnotationByName("test-annotation-msg-1");

   /* returns:  
   { 
       "name": "test-annotation-msg-1", 
       "visible": true, 
       "content": "Test<input id=\"make_spacing_ok\" style=\"visibility:hidden; width:0px;\">" 
   }
   */

GlideForm – getAnnotations()

Gibt eine Liste aller Anmerkungen in einem Formular zurück.

Anmerkungen Sind visuelle Trennzeichen zwischen Formularelementen oder Blöcken von farbigem Text, die zum Hervorheben von Formularelementen verwendet werden. Verwenden GlideForm – getAnnotationByName(Zeichenfolgenname) Um eine bestimmte Anmerkung anhand ihres Namens zurückzugeben.

Tabelle : 47. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 48. Rückgaben

Eigenschaft	Beschreibung
Array von Objekten	Inhalt der Anmerkung. Datentyp: Array von Objekten [{content: "String", name: "String", visible: Boolean}]
Array.Inhalt	Text der zurückgegebenen Anmerkung. Datentyp: Zeichenfolge
array.name	Name der zurückgegebenen Anmerkung. Datentyp: Zeichenfolge Tabellenspeicherort: Formularanmerkungen [sys_ui_annotation], Feld: Name
Array.sichtbar	Kennzeichnung, die angibt, ob die Anmerkung im Formular sichtbar ist. Gültige Werte: Wahr: Die Anmerkung ist sichtbar. Falsch: Die Anmerkung ist nicht sichtbar. Datentyp: Boolesch

Das folgende Beispiel für erste Anrufe GetAnnotations() Um alle Anmerkungen in einem Formular zurückzugeben, und ruft dann auf AusblendenAnnotation() Zum Ausblenden aller Anmerkungen im Formular.

const annotations = getAnnotations();

/* returns:  
[ 
    { 
        "name": "test-annotation-msg-1", 
        "visible": true, 
        "content": "Test<input id=\"make_spacing_ok\" style=\"visibility:hidden; width:0px;\">" 
    }, 
    { 
        "name": "test-annotation-msg-2", 
        "visible": true, 
        "content": "Test 2<input id=\"make_spacing_ok\" style=\"visibility:hidden; width:0px;\">" 
    } 

]*/
annotations.forEach(function(annotation) {
	g_form.hideAnnotation(annotation.name);
});

// this script hides all annotations on the form.

GlideForm – getBooleanValue(String fieldName)

Gibt einen boolean Wert für das angegebene Feld zurück.

Tabelle : 49. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Feld, das hervorgehoben werden soll, im folgenden Format: „<table-name>.<field-name>“ .

Tabelle : 50. Ausgabe

Typ	Beschreibung
Boolean	Gibt „false“zurück, wenn der Feldwert „false“ oder „undefined“ ist. Ansonsten wird „true“ zurückgegeben.

GlideForm – getChoice(String fieldName, String choiceValue)

Gibt ein Objekt mit Eigenschaften zurück, die ein bestimmtes Feld und einen bestimmten Auswahlwert darstellen.

Tabelle : 51. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Feldname der abzurufenden Auswahl.
choiceValue	Zeichenfolge	Wert der abzurufenden Auswahl.

Tabelle : 52. Rückgaben

Eigenschaft	Beschreibung
GlideFormChoice-Objekt oder null	GlideFormChoice-Objekt für das angegebene Feld und den angegebenen Auswahlwert. Gibt null zurück, wenn keine übereinstimmende Auswahl vorhanden ist. Datentyp: Objekt ("label", "value", "disabled", "index")
GlideFormAuswahl.Bezeichnung	Schreibgeschützter Anzeigetext der Auswahl. Datentyp: Zeichenfolge
GlideFormAuswahl.Wert	Schreibgeschützter Wert der Auswahl. Datentyp: Zeichenfolge
GlideFormAuswahl.deaktiviert	Kennzeichnung, die angibt, ob die Auswahl im Formular deaktiviert ist. Gültige Werte: Wahr: Auswahl ist deaktiviert Falsch: Auswahl ist aktiviert. Datentyp: Boolesch
GlideFormChoice.index	Gibt die Position der Auswahl in der Dropdown-Liste an. Datentyp: Zahl

Das folgende Beispiel ruft auf Aktivieren () So aktivieren Sie eine neue Dropdown-Auswahl: 1 , In Priorität Formularfeld.

var shortDescription = g_form.getValue('shortDescription');

// Allow priority 1 selection if short description mentions security 
if (shortDescription.includes('security')) {
	var p1Choice = g_form.getChoice('priority', '1');
	g_form.enableChoice('priority', '1');
}

GlideForm – getControl(String fieldName)

Gibt das HTML-Element für das angegebene Feld zurück.

Zusammengesetzte Felder können mehrere HTML-Elemente enthalten. Diese Methode ist im Allgemeinen nicht erforderlich, da es integrierte Methoden gibt, die die Felder in einem Formular verwenden.

Wenn das Feld ein Referenzfeld und das Steuerelement eine Auswahlliste ist, gibt getControl() evtl. ein Steuerelement nicht wie erwartet zurück. Verwenden Sie in diesem Fall sys_select. <table name>.<field name> .

Diese Methode ist in mobilen Skripts oder nicht verfügbar Serviceportal Skripts.

Tabelle : 53. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des Felds, für das das HTML-Element zurückgegeben werden soll.

Tabelle : 54. Ausgabe

Typ	Beschreibung
HTMLElement	HTML-Element des Felds.

GlideForm – getDecimalValue(String fieldName)

Gibt den Dezimalwert des angegebenen Felds zurück.

Tabelle : 55. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des Felds, für das der Dezimalwert zurückgegeben werden soll.

Tabelle : 56. Ausgabe

Typ	Beschreibung
Zeichenfolge	Dezimalwert des angegebenen Felds.

function onChange(control, oldValue, newValue, isLoading) {
   alert(g_form.getDecimalValue('percent_complete'));
}

GlideForm – getDisplayBox(String fieldName)

Gibt den Anzeigewert aus einem Formular in der Core-UI zurück.

Hinweis:

Um einen Anzeigewert aus einem Formular in abzurufen Serviceportal, Verwenden Sie GetDisplayValue() Methode.

Siehe auch:

• GetValue()
• Ruft den Anzeigewert einer Referenzvariablen ab

Tabelle : 57. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge

Tabelle : 58. Ergebnisse

Typ	Beschreibung
Keine	Name des Felds, aus dem der Wert im Formular abgerufen werden soll.

var caller = g_form.getDisplayBox('caller_id').value;

var assignee = g_form.getDisplayBox('assigned_to').value;

if (caller == assignee)
{
   alert('in');
}

GlideForm – getDisplayValue(String fieldName)

Gibt den Anzeigewert aus einem Formular in zurück Serviceportal.

Siehe auch:

• GetValue()
• Ruft den Anzeigewert einer Referenzvariablen ab

Hinweis:

In der Core-UI wird diese Methode als aufgerufen G_Form.getDisplayValue() Ohne Argument wird der Anzeigewert des Datensatzes und nicht der Anzeigewert eines einzelnen Felds zurückgegeben.

Tabelle : 59. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des Felds, aus dem Sie einen Wert im Formular abrufen möchten.

Tabelle : 60. Ausgabe

Typ	Beschreibung
Zeichenfolge	Anzeigewert des angegebenen Felds.

Das folgende Beispiel zeigt, wie der Anzeigewert einer Referenzvariablen in der Core-UI oder abgerufen wird Serviceportal. Der Anwendungsfall für dieses Beispiel befindet sich auf der community Website.

function onChange(control, oldValue, newValue, isLoading) {
     if (isLoading || newValue == '') {
          return;
     }
     if(window == null){
          var valuePortal = g_form.getDisplayValue('requester');
          alert('Portal->' + valuePortal);
     }
     else{
          var valueNative = g_form.getDisplayBox('requester').value;     
          alert('CoreUI->' + valueCoreUI);
     }
     //Type appropriate comment here, and begin script below
}

GlideForm – getElement(String id)

Gibt das vom Parameter angegebene HTML-Element zurück.

Zusammengesetzte Felder können mehrere HTML-Elemente enthalten. Diese Methode ist im Allgemeinen nicht erforderlich, da es integrierte Methoden gibt, die die Felder in einem Formular verwenden.

Diese Methode ist in mobilen Skripts oder nicht verfügbar Serviceportal Skripts.

Tabelle : 61. Parameter

Name	Typ	Beschreibung
id	Zeichenfolge	Feld-ID.

Tabelle : 62. Ausgabe

Typ	Beschreibung
HTMLElement	HTML-Element des Felds.

GlideForm – getFormElement()

Gibt das HTML-Element für das Formular zurück.

Diese Methode ist in mobilen Skripts oder nicht verfügbar Serviceportal Skripts.

Tabelle : 63. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 64. Ergebnisse

Typ	Beschreibung
HTMLFormElement	HTML-Element für das Formular.

GlideForm – getHelpTextControl(String fieldName)

Gibt das HTML-Element des Hilfetexts für das angegebene Feld zurück.

Diese Methode gilt nur für Servicekatalogvariablen.

Tabelle : 65. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des Felds.

Tabelle : 66. Ergebnisse

Typ	Beschreibung
HTMLElement	HTML-Element des Hilfetextfeldes.

GlideForm – getIntValue(String fieldName)

Gibt den Ganzzahlwert für das angegebene Feld zurück.

Tabelle : 67. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Feldname.

Tabelle : 68. Ausgabe

Typ	Beschreibung
Anzahl	Ganzzahliger Wert des Felds.

GlideForm – getLabelOf(String fieldName)

Gibt den Nur-Text-Wert der Feldbezeichnung zurück.

Tabelle : 69. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Feldname.

Tabelle : 70. Ausgabe

Typ	Beschreibung
Zeichenfolge	Bezeichnungstext.

if (g_user.hasRole('itil')) {
    var oldLabel = g_form.getLabelOf('comments');
    g_form.setLabelOf('comments', oldLabel + ' (Customer visible)');
}

GlideForm – getOption(String fieldName, String choiceValue)

Gibt das Optionselement für ein ausgewähltes Feld mit dem Namen zurück fieldNameWo choiceValueStimmt mit dem Optionswert überein.

Hinweis:

Diese Methode funktioniert nicht für schreibgeschützte Felder.

Tabelle : 71. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des Felds.
choiceValue	Zeichenfolge	Wert der Option.

Tabelle : 72. Ergebnisse

Typ	Beschreibung
HTMLElement	HTMLElement für die Option. Gibt NULL zurück, wenn das Feld oder die Option nicht gefunden wurde.

Das folgende Beispiel zeigt, wie die Bezeichnung für einen Auswahllistenwert abgerufen wird.

// Get the label for a choice list value
// fieldName is 'category'
 
function onChange(control, oldValue, newValue, isLoading) {
var choiceValue = g_form.getValue('category');
var choiceLabel = g_form.getOption('category', choiceValue).text; 
}

GlideForm – getOptions(String fieldName)

Gibt die verfügbaren und ausgewählten Optionen für ein Auswahl- oder Referenzfeld im Formular zurück. Diese Methode ist nützlich für dynamische Formulare, Katalogvariablen und Variablensätze und Integrationen, die Feldoptionen zur Laufzeit überprüfen oder filtern müssen.

Sie können beispielsweise verwenden G_Form.getOptions() An:

• Ruft die Name-Wert-Paare in einem Feldtyp „watch_list“ ab und legt sie fest.
• Suchen oder filtern Sie verfügbare Optionen nach einem Suchbegriff.
• Ermöglichen Sie den Zugriff auf dieselben Ergebnisse der automatischen Vervollständigung über einen Rückruf.
• Ruft Optionen für Auswahlfelder, Referenzfelder und erweiterte Feldtypen wie Watch_list, Glide_list, field_list und Slushbucket ab und legt sie fest.

Tabelle : 73. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Der Feldname des abzurufenden Auswahlfelds oder Referenzfelds.

Tabelle : 74. Rückgaben

Eigenschaft	Beschreibung
Array von Objekten oder null	Schreibgeschütztes Array von Objekten, das den Wert und die Bezeichnung jeder ausgewählten Option enthält. Gibt null zurück, wenn das Feld keine Optionen unterstützt. Datentyp: Array von Objekten [{value: "String", displayValue: "String"}]
Array.Anzeigewert	Der Anzeigewert der Auswahl. Datentyp: Zeichenfolge
Array.Wert	Der Wert der Option. Datentyp: Zeichenfolge
GetAvailable (Laufzeit)	Funktion zum Zurückgeben aller verfügbaren Optionen. Ein Suchbegriff kann als Argument bereitgestellt werden, um die Optionen nach Anzeigewert (Übereinstimmung mit Unterzeichenfolge ohne Berücksichtigung der Groß-/Kleinschreibung) zu filtern. Gibt eine Zusage eines Array von Objekten mit Anzeigewert und Wert der übereinstimmenden Auswahl zurück. Datentyp: Array von Objekten [{value: "String", displayValue: "String"}]

Das folgende Beispiel ruft auf G_Form.getOptions() Um alle verfügbaren Auswahlmöglichkeiten für angegebene Formularfelder zurückzugeben, z. B. Status, Work_Notes_list und andere.

g_form.getOptions("state"); //table: incident, field: state, type: integer, choice: Dropdown without --None--
/*
returns [{"value":"1","displayValue":"New"},{"value":"2","displayValue":"In Progress"},{"value":"3","displayValue":"On Hold"},{"value":"6","displayValue":"Resolved"},{"value":"7","displayValue":"Closed"},{"value":"8","displayValue":"Canceled"}]
*/

g_form.getOptions("category"); //table: incident, field: category, type: string, choice: Dropdown with --None--
/*
returns [{"value":"","displayValue":"-- None --"},{"value":"inquiry","displayValue":"Inquiry / Help"},{"value":"software","displayValue":"Software"},{"value":"hardware","displayValue":"Hardware"},{"value":"network","displayValue":"Network"},{"value":"database","displayValue":"Database"}]
*/

g_form.getOptions("work_notes_list") //table: incident, field: work_notes_list, type: glide_list
/*
returns [{"value":"62826bf03710200044e0bfc8bcbe5df1","displayValue":"Abel Tuter"},{"value":"a8f98bb0eb32010045e1a5115206fe3a","displayValue":"Abraham Lincoln"},{"value":"5137153cc611227c000bbd1bd8cd2005","displayValue":"Fred Luddy"},{"value":"6a826bf03710200044e0bfc8bcbe5dec","displayValue":"Alissa Mountjoy"}]
*/

g_form.getOptions("restricted_fields") //table: std_change_properties, field: restricted_fields, type: field_list
/*
[{"value":"activity_due","displayValue":"Activity due"},{"value":"additional_assignee_list","displayValue":"Additional assignee list"},{"value":"comments","displayValue":"Additional comments"},{"value":"assignment_group","displayValue":"Assignment group"},{"value":"backout_plan","displayValue":"Backout plan"},{"value":"business_duration","displayValue":"Business duration"},{"value":"cab_delegate","displayValue":"CAB delegate"},...]
*/

g_form.getOptions('table') //table: sys_script_client, field: table, type: table_name
/*
[{"value":"","displayValue":"-- None --"},{"value":"cmdb_ci_appl_dot_net","displayValue":".NET Application [cmdb_ci_appl_dot_net]"},{"value":"evaluation","displayValue":"A/B Testing Evaluation [evaluation]"},{"value":"evaluation_execution","displayValue":"A/B Testing Evaluation Execution [evaluation_execution]"},{"value":"evaluation_parameter","displayValue":"A/B Testing Evaluation Parameter [evaluation_parameter]"},{"value":"sn_access_analyzer_request","displayValue":"Access Analyzer Query [sn_access_analyzer_request]"},{"value":"sn_access_analyzer_access_comparison_request","displayValue":"Access Comparison Request [sn_access_analyzer_access_comparison_request]"},{"value":"sys_security_acl","displayValue":"Access Control [sys_security_acl]"},...]
*/

g_form.getOptions('mandatory_fields'); //table: kb_knowledge_base, field: mandatory_fields, type: slushbucket
/*
[{"value":"active","displayValue":"Active"},{"value":"article_id","displayValue":"Article ID"},{"value":"displayValue","displayValue":"Article body"},{"value":"article_type","displayValue":"Article type"},{"value":"direct","displayValue":"Attachment link"},{"value":"author","displayValue":"Author"},{"value":"base_version","displayValue":"Base Version"},...]
*/

Das folgende Beispielskript zeigt, wie Sie anrufen G_Form.getOptions() Mit getAvailable()-Funktion.

const options = g_form.getOptions('priority');
if (options) {
  console.log('Selected:', options.selected);
  options.getAvailable('high').then(available => {
    console.log('Available matching "high":', available);
  });
}

GlideForm – getReference(String fieldName, Function callBack)

Gibt den GlideRecord für ein angegebenes Feld zurück.

Wenn eine Rückruffunktion vorhanden ist, wird diese Routine asynchron ausgeführt. Die Verarbeitung des Browsers (und Skripts) wird normal fortgesetzt, bis der Server den Referenzwert zurückgibt. Zu diesem Zeitpunkt wird die Rückruffunktion aufgerufen. Wenn keine Rückruffunktion vorhanden ist, wird diese Routine synchron ausgeführt, und die Verarbeitung wird angehalten (wodurch der Browser anscheinend blockiert), während auf eine Serverantwort gewartet wird.

Wichtig:

Es wird dringend empfohlen, eine Rückruffunktion zu verwenden.

Unterstützung für Rückruffunktionen für ServiceCatalogForm.getReference ist verfügbar.

Hinweis:

Die Verwendung dieser Methode erfordert einen Aufruf des Servers, was zusätzliche Zeit erfordert und zu Latenz auf Ihrer Seite führen kann. Verwenden Sie diese Methode mit Vorsicht. Weitere Informationen finden Sie unter Client-Skriptdesign und -Verarbeitung .

Tabelle : 75. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des Felds.
callBack	Funktion	Name der Rückruffunktion.

Tabelle : 76. Ausgabe

Typ	Beschreibung
GlideRecord	GlideRecord-Objekt für das angegebene Feld. Wenn die angegebene Referenz nicht gefunden werden kann, wird ein initialisiertes GlideRecord-Objekt zurückgegeben, wobei CurrentRow = -1 Und Zeilen.Länge = 0 .

function onChange(control, oldValue, newValue, isLoading) {
    g_form.getReference('caller_id', doAlert); // doAlert is our callback function
}
 
function doAlert(caller) { // reference is passed into callback as first arguments
   if (caller.getValue('vip') == 'true') {
      alert('Caller is a VIP!');
   }
}

GlideForm – getRelatedListNames()

Gibt ein Array von zugehörigen Listennamen aus dem aktuellen Formular zurück.

Tabelle : 77. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 78. Ergebnisse

Typ	Beschreibung
Array aus Zeichenfolgen	Liste der zugehörigen Listennamen aus dem aktuellen Formular. Die Namen der zugehörigen Liste werden in der Reihenfolge aufgeführt, in der sie im Formular angezeigt werden.

var listNames = g_form.getRelatedListNames();

for (var i = 0; i < listNames.length; i++) {  
  this.showRelatedList(listNames[i]);
 }

GlideForm – getSectionNames()

Gibt alle Abschnittsnamen zurück, unabhängig davon, ob sie sichtbar sind oder nicht.

Tabelle : 79. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 80. Ergebnisse

Typ	Beschreibung
Array aus Zeichenfolgen	Abschnittsnamen.

GlideForm – getSections()

Gibt ein Array der Abschnitte des Formulars zurück.

Diese Methode ist nicht auf der mobilen Plattform verfügbar. Wenn diese Methode auf einer mobilen Plattform ausgeführt wird, erfolgt keine Aktion.

Tabelle : 81. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 82. Ergebnisse

Typ	Beschreibung
Array von HTML-Elementen	Abschnitte des Formulars.

function onChange(control, oldValue, newValue, isLoading) {
   //this example was run on a form divided into sections (Change form)
   // and hid a section when the "state" field was changed
   var sections = g_form.getSections();
   if (newValue == '2') {
      g_form.setSectionDisplay(sections[1], false);
   } else {
      g_form.setSectionDisplay(sections[1], true);
   }
}

GlideForm – getTableName()

Gibt den Namen der Tabelle zurück, zu der dieser Datensatz gehört.

Auf dem Server kann die Tabelle für den aktuellen Datensatz mit current.sys_class_name oder current.getTableName() abgerufen werden.

Tabelle : 83. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 84. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Name der Tabelle.

function onLoad() {
    if (g_form.isNewRecord()) {
        var tableName = g_form.getTableName(); //Get the table name
    }
}

GlideForm – getUniqueValue()

Gibt die sys_id des Datensatzes zurück, der im Formular angezeigt wird.

Tabelle : 85. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 86. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Sys_ID des Datensatzes

function onLoad() {
   var incSysid = g_form.getUniqueValue();
   alert(incSysid);
}

GlideForm – getValue(String fieldName)

Gibt den Wert des angegebenen Formularfelds zurück.

Diese Methode unterstützt auch das Abrufen von Werten aus einem mehrzeiligen Variablensatz (MRVS). Um Daten aus Feldern in einem MRVS abzurufen, müssen Sie zuerst verwenden JSON.Parse(getValue('<mrvs_field_name>') || „[]“) Um das MRVS-Array abzurufen, und verwenden Sie dann die Indizierung, um auf die Felder innerhalb der Zeilenobjekte zuzugreifen. Weitere Details finden Sie im Codebeispiel unten.

Tabelle : 87. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des Felds, dessen Wert zurückgegeben werden soll.

Tabelle : 88. Ausgabe

Typ	Beschreibung
Zeichenfolge	Wert des angegebenen Felds.

Das folgende Beispiel zeigt, wie die Kurzbeschreibung aus dem aktuellen Formular abgerufen wird.

function onChange(control, oldValue, newValue, isLoading) {
   alert(g_form.getValue('short_description'));
}

Das folgende Beispiel zeigt, wie Werte aus einem MRVS abgerufen werden. In diesem Beispiel werden Gehälter über den Servicekatalog verwaltet. Das Clientskript durchsucht alle Zeilen in MRVS nach dem in eingegebenen Wert Stellenbezeichnung Und aktualisiert dann die übereinstimmenden Einträge innerhalb der MRVS mit dem, was in eingegeben wird Gehalt Feld. Das MRVS hat den Namen „variable_Set_1“ und enthält die folgenden Felder in jedem Zeilenobjekt: Mitarbeitername [Employee_Name], Stellenbezeichnung [Employee_Job_title] und Gehalt [Employee_Salary]. Darüber hinaus enthält das Katalogelement: Stellenbezeichnung [Job_title] und Gehalt [Gehalt].

function onChange(control, oldValue, newValue, isLoading) {
if (isLoading || newValue == '') {
return;
}
 
// Get the MRVS
var vs1 = g_form.getValue('variable_set_1') || '[]';
var multiRowVariableSet = JSON.parse(vs1);
 
for (var i = 0; i < multiRowVariableSet.length; i++) {
// Check if the entered job title matches the title in the current MRVS row
  if (multiRowVariableSet[i].employee_job_title == g_form.getValue("job_title")){
    // Update the value of a matching field with the new salary
    multiRowVariableSet[i].employee_salary = newValue;
  }
}
 
// Update the MRVS
g_form.setValue('variable_set_1', JSON.stringify(multiRowVariableSet));
}

GlideForm – hideAllFieldMsgs()

Blendet alle Feldmeldungen aus.

Tabelle : 89. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 90. Ergebnisse

Typ	Beschreibung
void

GlideForm – hideAllFieldMsgs(String type)

Blendet alle Feldmeldungen des angegebenen Typs aus.

Tabelle : 91. Parameter

Name	Typ	Beschreibung
type	Zeichenfolge	>Typ der Nachricht. Gültige Werte: Fehler Info

Tabelle : 92. Ausgabe

Typ	Beschreibung
void

GlideForm – HideAnnotation(Zeichenfolgenname)

Blendet eine Anmerkung mit einem bestimmten Namen auf der Formular-UI aus.

Anmerkungen Sind visuelle Trennzeichen zwischen Formularelementen oder Blöcken von farbigem Text, die zum Hervorheben von Formularelementen verwendet werden. Siehe auch:

• GlideForm – showErrorBox(String name, String message, Boolean scrollForm) Dient zum Anzeigen einer bestimmten Anmerkung im Formular.
• GlideForm – toggleAnnotations() Dient zum Aktivieren und Deaktivieren von Anmerkungen mit größerer Flexibilität.

Tabelle : 93. Parameter

Name	Typ	Beschreibung
name	Zeichenfolge	Name der Anmerkung, die im Formular ausgeblendet werden soll. Tabelle: Formularanmerkungen [sys_ui_annotation], Feld: Name

Tabelle : 94. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie die Anmerkung „Test-annotation-msg-1“ programmgesteuert im Formularfeld mit ausblenden AusblendenAnnotation() Methode.

g_form.hideAnnotation('test-annotation-msg-1');

GlideForm – hideErrorBox(String fieldName)

Blendet die von platzierte Fehlermeldung aus ShowErrorBox() .

Verwenden Sie wann immer möglich hideFieldMsg() anstatt dieser Methode.

Tabelle : 95. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des Felds oder Steuerelements, dessen Fehlermeldung ausgeblendet werden soll.

Tabelle : 96. Ausgabe

Typ	Beschreibung
void

GlideForm – hideFieldMsg(String fieldName, Boolean clearAll)

Blendet die erste Nachricht aus, die im angegebenen Feld im aktuellen Formular angezeigt wird.

Verwenden Sie GlideForm – showFieldMsg(String field, String message, String type) Oder GlideForm – showFieldMsg(String field, String message, String type, Boolean scrollForm) Methoden zum Anzeigen von Nachrichten in einem Formular.

Das folgende Codeausschnitt zeigt beispielsweise, wie zwei Nachrichten auf der angezeigt werden Work_Notes Feld eines Formulars und dann die erste Nachricht ausblenden:

g_form.showFieldMsg('work_notes', 'First message', "error");
g_form.showFieldMsg('work_notes', 'Second message', "error");
g_form.hideFieldMsg('work_notes', false); // This call hides the 'First message'

Tabelle : 97. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des Felds, in dem die Nachricht ausgeblendet werden soll.
clearAll	Boolean	Optional. Kennzeichnung, die angibt, ob alle Nachrichten für das angegebene Feld ausgeblendet werden sollen. Gültige Werte: Wahr: Alle Nachrichten ausblenden. Falsch: Nur die erste angezeigte Nachricht ausblenden. Standardwert: false

Tabelle : 98. Ausgabe

Typ	Beschreibung
void

Das folgende Beispiel zeigt, wie alle Nachrichten für ein angegebenes Formularfeld gelöscht und dann eine Verschlüsselungsfehlermeldung angezeigt werden.

function submitEncryptedInputs() {
  return processEncryptedInputs(function(inputName, fieldName) {
    if (!checkEncryptedFieldValue(fieldName)) {
      g_form.hideFieldMsg(fieldName, true); // Hide all messages for the specified field
      g_form.showFieldMsg(fieldName, "Your activity requires an encrypted input.", "error");
      return false;
    }
    return true;
  });
}

GlideForm – hideRelatedLinks()

Blendet den Abschnitt „zugehörige Links“ eines Formulars aus.

Siehe auch:

• GlideForm – showRelatedLinks()
• GlideForm – setRelatedLinksDisplay (boolesche Anzeige)

Tabelle : 99. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 100. Ergebnisse

Typ	Beschreibung
Keine

Im folgenden Beispielskript werden zugehörige Links im aktuellen Formular ausgeblendet.

// Hide related links
g_form.hideRelatedLinks()

GlideForm – hideRelatedList(String listTableName)

Blendet die angegebene zugehörige Liste im Formular aus.

Diese Methode ist nicht auf der mobilen Plattform verfügbar. Wenn diese Methode auf einer mobilen Plattform ausgeführt wird, erfolgt keine Aktion.

Tabelle : 101. Parameter

Name	Typ	Beschreibung
listTableName	Zeichenfolge	Name der zugehörigen Liste. Verwenden Sie die sys_id, um eine Liste durch eine Beziehung auszublenden.

Tabelle : 102. Ausgabe

Typ	Beschreibung
void

GlideForm – hideRelatedLists()

Blendet alle zugehörigen Listen im Formular aus.

Diese Methode ist nicht auf der mobilen Plattform verfügbar. Wenn diese Methode auf einer mobilen Plattform ausgeführt wird, erfolgt keine Aktion.

Tabelle : 103. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 104. Ergebnisse

Typ	Beschreibung
void

GlideForm – hideTemplateBar()

Blendet die Vorlagenleiste im Formular aus.

Tabelle : 105. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 106. Ergebnisse

Typ	Beschreibung
Keine

Im folgenden Beispielskript wird die Vorlagenleiste im aktuellen Formular ausgeblendet.

g_form.hideTemplateBar()

GlideForm – isLiveUpdating()

Gibt „true“ zurück, während ein Live-Update für den Datensatz ausgeführt wird, den das Formular anzeigt.

Dies kann in einem onChange()-Client-Skript verwendet werden, um festzustellen, ob eine Änderung des Datensatzes auf ein Live-Update einer anderen Sitzung zurückzuführen ist. Das Client-Skript kann dann entscheiden, welche Aktion ausgeführt werden soll. Dies gilt für Systeme, die verwenden Core-UI Mit aktivierten Live-Formularen.

Tabelle : 107. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 108. Ergebnisse

Typ	Beschreibung
Boolean	Gibt „true“ zurück, wenn für den vom Formular angezeigten Datensatz ein Live-Update ausgeführt wird.

GlideForm – isMandatory(String fieldName)

Gibt „true“ zurück, wenn das Feld ein Pflichtfeld ist.

Tabelle : 109. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des Felds.

Tabelle : 110. Ausgabe

Typ	Beschreibung
Boolean	„True“, wenn das Feld erforderlich ist, andernfalls „false“.

GlideForm – isNewRecord()

Gibt „true“ zurück, wenn der Datensatz noch nie gespeichert wurde.

Tabelle : 111. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 112. Ergebnisse

Typ	Beschreibung
Boolean	Gibt „true“ zurück, wenn der Datensatz nicht gespeichert wurde, und andernfalls „falls“

function onLoad() {
   if(g_form.isNewRecord()){
      alert('New Record!');
   }
}

GlideForm – isSectionVisible(String sectionName)

Gibt „true“ zurück, wenn der Abschnitt sichtbar ist.

Wichtig:

Die Funktion isSectionVisible() wird im Arbeitsbereich nicht unterstützt.

Tabelle : 113. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 114. Ergebnisse

Typ	Beschreibung
Boolean	Gibt „true“ zurück, wenn der Abschnitt sichtbar ist. Andernfalls wird „false“ zurückgegeben.

GlideForm – isVisible(String fieldName)

Bestimmt, ob das Feld, das dem übergebenen Feldnamen zugeordnet ist, im aktuellen Formular sichtbar ist.

Tabelle : 115. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des Felds, um zu überprüfen, ob es im aktuellen Formular sichtbar ist.

Tabelle : 116. Ausgabe

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob das angegebene Feld im aktuellen Formular sichtbar ist. Mögliche Werte: Wahr: Feld ist im Formular sichtbar. Falsch: Feld ist im Formular nicht sichtbar.

Das folgende Codebeispiel zeigt, wie überprüft wird, ob User_address Feld ist im aktuellen Formular sichtbar.

if(g_form.isVisible('user_address')) {
    alert('is visible');
}
else {
    alert('is hidden');
}

GlideForm – onUserChangeValue(Funktion FN)

Registriert einen anwenderdefinierten Ereignis-Listener, der erkennt, wenn ein Feld im aktuellen Formular von einem Anwender geändert wird.

Wenn ein Formularfeld geändert wird, ruft der Ereignis-Listener die Funktion auf, die bei der anfänglichen Registrierung des Listeners übergeben wird. Dieser Listener wird nur ausgelöst, wenn ein Anwender eine Änderung an einem Feld im Formular vornimmt. Änderungen an Clientskripts, UI-Richtlinien oder anderen Interaktionen ohne Anwender lösen den Listener nicht aus.

Hinweis:

Diese Methode funktioniert nicht für Journalfelder oder Servicekatalog Elemente in der klassischen Umgebung.

Tabelle : 117. Parameter

Name	Typ	Beschreibung
fn	Funktion	Funktion, die aufgerufen wird, wenn ein Anwender den Wert eines Felds im aktuellen Formular ändert. Dies ist eigentlich der Funktionscode, nicht nur der Funktionsname. Diese Funktion muss die folgenden drei Argumente akzeptieren: Feldname Ursprünglicher Feldwert Feldwert aktualisiert

Tabelle : 118. Ausgabe

Typ	Beschreibung
Funktion	Funktion zum Aufrufen, um die Registrierung des onUserChangeValue-Ereignis-Listeners aufzuheben.

var handler = function(fieldname, originalValue, newValue) {
  console.log('The field ('+ fieldname + ') has a new value of: ' + newValue); // function code
}
 
var unregister = g_form.onUserChangeValue(handler);
 
// To unregister the event listener
unregister();

GlideForm – refreshSlushbucket(String fieldName)

Sie können eine Listensammlervariable aktualisieren.

Tabelle : 119. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des Slushbucket.

Tabelle : 120. Ergebnisse

Typ	Beschreibung
void

g_form.refreshSlushbucket('bucket');

GlideForm – removeDecoration(String fieldname, String icon, String title)

Entfernt das Symbol aus dem angegebenen Feld, das dem angegebenen Symbol und Titel entspricht.

Hinweis:

Diese Methode wird von nicht unterstützt Servicekatalog.

Tabelle : 121. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Feldname, aus dem die Dekoration entfernt werden soll.
icon	Zeichenfolge	Name des zu entfernenden Symbols.
Titel	Zeichenfolge	Texttitel (Name) des Symbols.

Tabelle : 122. Ausgabe

Typ	Beschreibung
void

function onChange(control, oldValue, newValue, isLoading) {
	// if the caller_id field is not present, then we can't add an icon anywhere
	if (!g_form.hasField('caller_id'))
		return;
 
	if (!newValue)
		return;
 
	g_form.getReference('caller_id', function(ref) {
		g_form.removeDecoration('caller_id', 'icon-star', 'VIP');
 
		if (ref.getValue('vip') == 'true')
			g_form.addDecoration('caller_id', 'icon-star', 'VIP');			
	});
}

GlideForm – removeDecoration(String fieldname, String icon, String title, String color)

Entfernt das Symbol aus dem angegebenen Feld, das dem angegebenen Symbol, Titel und Farbe entspricht.

Hinweis:

Diese Methode wird von nicht unterstützt Servicekatalog.

Tabelle : 123. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Feldname, aus dem die Dekoration entfernt werden soll.
icon	Zeichenfolge	Name des zu entfernenden Symbols.
Titel	Zeichenfolge	Texttitel (Name) des Symbols.
Farbe	Zeichenfolge	Übereinstimmende CSS-Farbe.

Tabelle : 124. Ausgabe

Typ	Beschreibung
void

g_form.removeDecoration('caller_id', 'icon-star', 'VIP', 'blue');

GlideForm – removeOption(String fieldName, String choiceValue)

Entfernt die angegebene Option aus der angegebenen Auswahlliste.

Tabelle : 125. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des Felds, aus dem die Option aus der Auswahlliste entfernt werden soll.
choiceValue	Zeichenfolge	In der Datenbank gespeicherter Wert. Dies ist nicht die Bezeichnung.

Tabelle : 126. Ausgabe

Typ	Beschreibung
void

g_form.removeOption('priority', '1');

GlideForm – save()

Speichert den Datensatz ohne Wegzunavigieren (aktualisieren und bleiben).

Tabelle : 127. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 128. Ergebnisse

Typ	Beschreibung
void

GlideForm – setChoiceLabel(String fieldName, String choiceValue, String newLabel)

Aktualisiert die Bezeichnung einer bestimmten Auswahl im Dropdown-Feld.

Beim Aufrufen dieser Methode bleibt die Indexposition der Option „aktualisiert“ in der Dropdown-Liste unverändert. Der aktivierte oder deaktivierte Status der Option wird beibehalten.

Tabelle : 129. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Feldname, der die zu aktualisierende Auswahl enthält. Datentyp: Zeichenfolge
choiceValue	Zeichenfolge	Wert der Auswahlbezeichnung, die mit einer neuen Bezeichnung aktualisiert werden soll. Datentyp: Zeichenfolge
NewLabel	Zeichenfolge	Bezeichnungsname, auf den die vorhandene Auswahlbezeichnung aktualisiert werden soll. Datentyp: Zeichenfolge

Tabelle : 130. Ausgabe

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob die Optionsbezeichnung erfolgreich aktualisiert wurde. Gültige Werte: Wahr: Auswahlbezeichnung wird aktualisiert. Falsch: Die Auswahlbezeichnung wird nicht aktualisiert, da die angegebene Auswahl zum Aktualisieren möglicherweise schreibgeschützt war oder nicht vorhanden ist oder die neue Bezeichnung vorhanden ist und bereits einer anderen Option zugeordnet ist.

Im folgenden Beispiel wird setChoiceLabel() aufgerufen, um die Feldauswahlen für „Bonus“ (10, 20 und 30) auf neue Werte zu aktualisieren.

// Show the calculated bonus next to the percentage label
var salary = parseInt(g_form.getValue('salary'), 10); 
g_form.setChoiceLabel('bonus', '10', '10% ($'+ (salary * .10) +')'); 
g_form.setChoiceLabel('bonus', '20', '20% ($'+ (salary * .20) +')'); 
g_form.setChoiceLabel('bonus', '30', '30% ($'+ (salary * .30) +')');

GlideForm – setDisabled(String fieldName, Boolean disable)

Definiert das angegebene Feld als verfügbar oder nicht verfügbar.

Tabelle : 131. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des Felds, das aktiviert oder deaktiviert werden soll.
Deaktivieren	Boolean	Kennzeichnung, die angibt, ob das angegebene Feld deaktiviert werden soll. Gültige Werte: Wahr: Deaktivieren Sie das Feld. Falsch: Aktiviert das Feld. Standardwert: false

Tabelle : 132. Ausgabe

Typ	Beschreibung
void

GlideForm – setDisplay(String fieldName, Boolean display)

Blendet ein angegebenes Feld im Formular ein oder aus.

Mit dieser Methode kann kein Pflichtfeld ohne Wert ausgeblendet werden. Wenn das Feld ausgeblendet ist, werden andere Elemente angezeigt. Verwenden Sie nach Möglichkeit eine UI-Richtlinie anstelle dieser Methode.

Tabelle : 133. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des Felds.
Anzeigen	Boolean	Kennzeichnung, die angibt, ob das angegebene Feld angezeigt werden soll. Gültige Werte: Wahr: Feld anzeigen. Falsch: Blenden Sie das Feld aus.

Tabelle : 134. Ausgabe

Typ	Beschreibung
void

function onChange(control, oldValue, newValue, isLoading, isTemplate) {
   //If the page isn't loading
   if (!isLoading) {
      //If the new value isn't blank
      if (newValue != '') {
         g_form.setDisplay('priority', false);   
      }
      else 
         g_form.setDisplay('priority', true);
      }
   }

GlideForm – setLabelOf(String fieldName, String label)

Legt den nur-Text-Wert der angegebenen Feldbezeichnung fest.

Hinweis:

Diese Methode wird von nicht unterstützt Servicekatalog.

Tabelle : 135. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des Felds, für das die Bezeichnung festgelegt werden soll.
label	Zeichenfolge	Nur-Text-Wert, der in der Bezeichnung festgelegt werden soll.

Tabelle : 136. Ausgabe

Typ	Beschreibung
void

if (g_user.hasRole('itil')) {
    var oldLabel = g_form.getLabelOf('comments');
    g_form.setLabelOf('comments', oldLabel + ' (Customer visible)');
}

GlideForm – setMandatory(String fieldName, Boolean mandatory)

Definiert das angegebene Feld als Pflichtfeld.

Verwenden Sie nach Möglichkeit eine UI-Richtlinie anstelle dieser Methode.

Tabelle : 137. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des Felds, das obligatorisch sein soll.
Obligatorisch	Boolean	Kennzeichnung, die angibt, ob das Feld obligatorisch ist. Gültige Werte: Wahr: Feld ist ein Pflichtfeld. Falsch: Feld ist optional. Standardwert: false

Tabelle : 138. Ausgabe

Typ	Beschreibung
void

GlideForm – setReadOnly(String fieldName, Boolean readOnly)

Macht das angegebene Feld schreibgeschützt oder bearbeitbar.

Verwenden Sie nach Möglichkeit eine UI-Richtlinie anstelle dieser Methode.

Um ein Pflichtfeld als schreibgeschützt zu definieren, müssen Sie zuerst die Pflichtanforderung für dieses Feld mithilfe der setMandatory()-Methode entfernen.

Sobald Sie ein Feld als schreibgeschützt festgelegt haben, können Sie nicht mehr verwenden SetValue() Methode zum Aktualisieren des Werts dieses Felds. Wenn Sie den Wert auf diese Weise festlegen müssen, müssen Sie festlegen readOnlyWert bis Falsch.

Tabelle : 139. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des Felds, dessen Zugriffswert festgelegt werden soll.
Monatlich	Boolean	Kennzeichnung, die bestimmt, ob das zugeordnete Feld bearbeitbar oder schreibgeschützt ist. Gültige Werte: Wahr: Feld auf schreibgeschützt festlegen. Falsch: Feld als bearbeitbar festlegen.

Tabelle : 140. Ausgabe

Typ	Beschreibung
void

Das folgende Beispiel zeigt, wie der Variableneditor auf schreibgeschützt festgelegt wird. Um dies in zu tun Servicekatalog Tabellen verwenden SetVariablesReadOnly() .

// Create a Client Script on a table (e.g., incident) and paste this script
// Uncheck (set to false) the "isolate script" checkbox (not available by default)
// To add the isolate script checkbox to the form, configure form layout to add the checkbox
function onLoad() { 
  $("variable_map").querySelectorAll("item").forEach(function(item){
    var variable = item.getAttribute("qname"); 
    g_form.setReadOnly("variables."+ variable, true); 
  }); 
}

GlideForm – setRelatedLinksDisplay (boolesche Anzeige)

Blenden Sie den Abschnitt „zugehörige Links“ in der Formular-UI mithilfe boolescher Werte ein oder aus.

GlideForm – hideRelatedLinks() Blendet UI-Aktionen für zugehörige Links im Formular aus, während GlideForm – showRelatedLinks() Zeigt sie an. Die g_form.setRelatedLinksDisplay(boolean:-Anzeige) Die Methode kann jedoch verwendet werden, um zugehörige Links mit mehr Flexibilität in Ihren Skripts anzuzeigen oder auszublenden.

Tabelle : 141. Parameter

Name	Typ	Beschreibung
Anzeigen	Boolean	Kennzeichnung, die angibt, ob der Abschnitt „zugehörige Links“ eines Formulars angezeigt oder ausgeblendet werden soll. Gültige Werte: Wahr: Zeigt zugehörige Links im Formular an. Falsch: Blendet zugehörige Links im Formular aus. Standardwert: wahr

Tabelle : 142. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie der Abschnitt „zugehörige Links“ in einem Formular ein- oder ausgeblendet wird.

// Displays the Related Links section in the UI
g_form.setRelatedLinksDisplay(true);
// Hides the Related Links section in the UI
g_form.setRelatedLinksDisplay(false);

GlideForm – setSectionDisplay(String sectionName, Boolean display)

Blendet einen angegebenen Abschnitt im Formular ein oder aus.

Tabelle : 143. Parameter

Name	Typ	Beschreibung
sectionName	Zeichenfolge	Der Abschnittsname ist in Kleinbuchstaben angegeben, wobei ein Unterstrich das erste Leerzeichen im Namen ersetzt und die verbleibenden Leerzeichen entfernt werden. Beispiel: „Abschnitt vier ist hier“ wird zu „section_fourishere“. Andere nicht alphanumerische Zeichen, z. B. Ampersand (&), werden entfernt. Abschnittsnamen suchen Sie mit der getSectionNames()-Methode.
Anzeigen	Boolean	Kennzeichnung, die angibt, ob der Abschnitt angezeigt werden soll. Gültige Werte: Wahr: Abschnitt anzeigen. Falsch: Blenden Sie den Abschnitt aus.

Tabelle : 144. Ausgabe

Typ	Beschreibung
Boolean	Gibt bei Erfolg „true“ zurück.

GlideForm – setValue(String fieldName, String value)

Legt den Wert eines angegebenen Formularfelds auf den angegebenen Wert fest.

Diese Methode unterstützt auch das Festlegen von Werten in einem mehrzeiligen Variablensatz (MRVS). Sie müssen zuerst verwenden JSON.Parse(getValue('<mrvs_field_name>')) Um das MRVS-Array abzurufen, und verwenden Sie dann die Indizierung, um die Felder in den Zeilenobjekten zu aktualisieren. Sobald alle Werte in MRVS aktualisiert wurden, verwenden Sie SetValue() Methode zum Speichern des aktualisierten MRVS-Arrays. Weitere Details finden Sie im Codebeispiel unten.

Hinweis:

Die Methode setValue() kann zu einem Stapelüberlauf führen, wenn er in einem OnChange-Client-Skript verwendet wird. Dies liegt daran, dass jede Werteinstellung als Änderung registriert wird, wodurch das OnChange-Client-Skript möglicherweise erneut ausgelöst wird. Um dies zu verhindern, prüfen Sie, ob der neue Wert vom alten Wert abweicht. Zum Beispiel überprüfen Sie vor der Durchführung von setValue(shortDesc,newValue.toUpperCase());, ob die Kurzbeschreibung nicht bereits in Großbuchstaben geschrieben ist. Dadurch wird verhindert, dass das Client-Skript toUpperCase() mehr als einmal anwendet.

Tabelle : 145. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des zu aktualisierenden Formularfelds.
Wert	Zeichenfolge	Wert, der im angegebenen Feld festgelegt werden soll. Hinweis: Wenn Sie einen Wert in einer Auswahlliste definieren, verwenden Sie unbedingt den Zahlenwert und nicht die Bezeichnung.

Tabelle : 146. Ausgabe

Typ	Beschreibung
void

Das folgende Beispiel zeigt, wie die Kurzbeschreibung im aktuellen Formular festgelegt wird.

g_form.setValue('short_description', 'replace this with appropriate text');

Das folgende Beispiel zeigt, wie Werte in einem MRVS festgelegt werden. In diesem Beispiel werden Gehälter über den Servicekatalog verwaltet. Das Clientskript durchsucht alle Zeilen in MRVS nach dem in eingegebenen Wert Stellenbezeichnung Und aktualisiert dann die übereinstimmenden Einträge innerhalb der MRVS mit dem, was in eingegeben wird Gehalt Feld. Das MRVS hat den Namen „variable_Set_1“ und enthält die folgenden Felder in jedem Zeilenobjekt: Mitarbeitername [Employee_Name], Stellenbezeichnung [Employee_Job_title] und Gehalt [Employee_Salary]. Darüber hinaus enthält das Katalogelement: Stellenbezeichnung [Job_title] und Gehalt [Gehalt].

function onChange(control, oldValue, newValue, isLoading) {
if (isLoading || newValue == '') {
return;
}

// Get the MRVS
var multiRowVariableSet = JSON.parse(g_form.getValue('variable_set_1'));

for (var i = 0; i < multiRowVariableSet.length; i++) {
// Check if the entered job title matches the title in the current MRVS row
  if (multiRowVariableSet[i].employee_job_title == g_form.getValue("job_title")){
    // Update the value of a matching field with the new salary
    multiRowVariableSet[i].employee_salary = newValue;
  }
}

// Update the MRVS
g_form.setValue('variable_set_1', JSON.stringify(multiRowVariableSet));
}

GlideForm – setValue(String fieldName, String value, String displayValue)

Legt den Wert eines angegebenen Formularfelds auf den Wert eines angegebenen Anzeigewerts in einem Referenzdatensatz fest.

Um die Leistung zu verbessern, indem beim Festlegen des Werts für ein Referenzfeld ein Roundtrip verhindert wird, verwenden Sie diese Methode nicht SetValue(fieldName, Wert) . Wenn Sie mehrere Referenzwerte für ein Listenerfasser-Feld festlegen, übergeben Sie Arrays im valueUnd displayValueParameter.

Hinweis:

Die Methode SetValue() Kann bei Verwendung in einem einen Stapelüberlauf verursachen onchange Client-Skript. Dies liegt daran, dass jede Werteinstellung als Änderung registriert wird, wodurch das OnChange-Client-Skript möglicherweise erneut ausgelöst wird. Um dies zu verhindern, prüfen Sie, ob der neue Wert vom alten Wert abweicht. Zum Beispiel überprüfen Sie vor der Durchführung von setValue(shortDesc,newValue.toUpperCase());, ob die Kurzbeschreibung nicht bereits in Großbuchstaben geschrieben ist. Dadurch wird verhindert, dass das Client-Skript toUpperCase() mehr als einmal anwendet.

Tabelle : 147. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des zu aktualisierenden Formularfelds.
Wert	Zeichenfolge oder Array	SYS_ID des Referenzdatensatzes, der zum Aktualisieren des Felds verwendet werden soll. Wenn das angegebene Feld eine GlideList ist, kann dieser Parameter ein Array von sys_IDs enthalten. In diesem Fall führt die Methode eine Suche nach allen im Array angegebenen Datensätzen durch, und diese Werte werden verwendet, um den Inhalt des angegebenen Felds (zugehörige Liste) zu aktualisieren. Hinweis: Wenn Sie einen Wert in einer Auswahlliste definieren, verwenden Sie einen Zahlenwert anstelle der Bezeichnung.
displayValue	Zeichenfolge oder Array	Feld im angegebenen Referenzdatensatz, das zum Aktualisieren des angegebenen Felds verwendet werden soll. In der Tabelle „Anwender“ [sys_user] kann es sich beispielsweise um „Anwendername“ handeln. Wenn das angegebene Feld eine GlideList ist, kann dieser Parameter ein Array von Anzeigenwertnamen enthalten. Weitere Informationen zu Anzeigewerten finden Sie unter Anzeigewert .

Tabelle : 148. Ausgabe

Typ	Beschreibung
void

Dieses Beispiel zeigt die Übergabe der sys_ID des Referenzdatensatzes, der das Anwendername-Feld enthält, das zum Aktualisieren von verwendet werden soll Assigned_to Formularfeld.

g_form.setValue('assigned_to', userSysID, userName);

Dieses Beispiel zeigt die Übergabe eines Arrays von sys_IDs des Referenzdatensatzes und eines Arrays von entsprechenden Anzeigenwertnamen, die zum Aktualisieren der Formularfelder in der GlideList verwendet werden sollen Glide-list_field_Name .

g_form.setValue('glide-list_field_name', sysIDArray, displayNameArray);

GlideForm – setVariablesReadOnly(Boolescher Wert IsReadOnly)

Erstellt einen Servicekatalog Variableneditor schreibgeschützt.

Hinweis:

Diese Methode gilt nur für Servicekatalog Variableneditoren in der Core-UI. Diese Methode wird in nicht unterstützt Servicekatalog Formular.

Die Methode muss im Clientskript der Tabelle platziert werden, in der der Variableneditor hinzugefügt wird, z. B. angefordertes Element [sc_req_item], Incident [Incident] usw. Um Variablen in anderen Tabellen als schreibgeschützt festzulegen, verwenden Sie SetReadOnly() Methode.

Siehe auch: Servicekatalog-Variableneditoren

Tabelle : 149. Parameter

Name	Typ	Beschreibung
isReadOnly	Boolean	Kennzeichnung, die bestimmt, ob der Variableneditor schreibgeschützt ist. Gültige Werte: Wahr: Legt den Variableneditor als schreibgeschützt fest. Falsch: Legt den Variableneditor als bearbeitbar fest. Standardwert: false

Tabelle : 150. Ausgabe

Typ	Beschreibung
void

Durch das Hinzufügen der folgenden Zeile zu einem Client-Skript wird der Variableneditor schreibgeschützt festgelegt.

g_form.setVariablesReadOnly(true);

GlideForm – setVisible(String fieldName, Boolean display)

Blendet das angegebene Feld ein oder aus.

In der Desktop-UI wird der Bereich leer gelassen, wenn er ausgeblendet ist. Auf Mobile oder Serviceportal UI, der Bereich wird in „meine anderen Felder“ ausgefüllt, wenn er ausgeblendet wird. Mit dieser Methode können Pflichtfelder ohne Wert nicht ausgeblendet werden.

Verwenden Sie nach Möglichkeit eine UI-Richtlinie anstelle dieser Methode.

Tabelle : 151. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des Felds, das angezeigt oder ausgeblendet werden soll.
Anzeigen	Boolean	Kennzeichnung, die angibt, ob das angegebene Feld angezeigt werden soll. Gültige Werte: Wahr: Feld anzeigen. Falsch: Blenden Sie das Feld aus.

Tabelle : 152. Ausgabe

Typ	Beschreibung
void

function onChange(control, oldValue, newValue, isLoading, isTemplate) {
   //If the page isn't loading
   if (!isLoading) {
      //If the new value isn't blank
      if(newValue != '') {
         g_form.setVisible('priority', false); 
      }
      else
         g_form.setVisible('priority', true); 
      }
   }

GlideForm – showAnnotation(Zeichenfolgenname)

Zeigt eine Anmerkung mit einem bestimmten Namen auf der Formular-UI an.

Anmerkungen Sind visuelle Trennzeichen zwischen Formularelementen oder Blöcken von farbigem Text, die zum Hervorheben von Formularelementen verwendet werden. Siehe auch:

• GlideForm – HideAnnotation(Zeichenfolgenname) Zum Ausblenden einer bestimmten Anmerkung im Formular.
• GlideForm – toggleAnnotations() Dient zum Aktivieren und Deaktivieren von Anmerkungen mit größerer Flexibilität.

Tabelle : 153. Parameter

Name	Typ	Beschreibung
name	Zeichenfolge	Name der Anmerkung, die im Formular angezeigt werden soll. Tabelle: Formularanmerkungen [sys_ui_annotation], Feld: Name

Tabelle : 154. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie die Anmerkung „Test-annotation-msg“ im Formularfeld mithilfe von programmgesteuert angezeigt wird ShowAnnotation() Methode.

g_form.showAnnotation('test-annotation-msg');

GlideForm – showErrorBox(String name, String message, Boolean scrollForm)

Zeigt eine Fehlermeldung unter dem angegebenen Formularfeld an (entweder ein Steuerelementobjekt oder der Name des Felds). Wenn sich die Steuerung oder das Feld derzeit nicht auf dem Bildschirm befindet, und der scrollFormParameter ist „wahr“, das Formular scrollt zum Steuerelement oder Feld.

Eine globale Eigenschaft (glide.ui.scroll_to_message_field) steuert den automatischen Bildlauf für Meldungen, wenn sich das Formularfeld außerhalb des Bildschirms befindet (im Formular wird ein Bildlauf zum Steuerelement oder Feld durchgeführt). Die showFieldMsg()-Methode ist eine ähnliche Methode, für die ein Typparameter erforderlich ist.

Tabelle : 155. Parameter

Name	Typ	Beschreibung
name	Zeichenfolge	Name des Felds oder Steuerelements, unter dem die Fehlermeldung angezeigt werden soll.
Nachricht	Zeichenfolge	Fehlermeldung, die angezeigt werden soll.
scrollForm	Boolean	Kennzeichnung, die angibt, ob das Formular automatisch zum Fehlermeldungsfeld gescrollt werden soll. Gültige Werte: Wahr: Scrollen Sie zum Fehlermeldungsfeld. Falsch: Scrollen Sie nicht zum Fehlermeldungsfeld. Standardwert: wahr

Tabelle : 156. Ausgabe

Typ	Beschreibung
void

GlideForm – showErrorBox(String name, String message)

Zeigt eine Fehlermeldung unter dem angegebenen Formularfeld an (entweder ein Steuerelementobjekt oder der Name des Felds). Wenn sich das Steuerelement oder Feld derzeit nicht auf dem Bildschirm befindet, scrollt das Formular automatisch zum Steuerelement oder Feld.

Eine globale Eigenschaft (glide.ui.scroll_to_message_field) steuert den automatischen Bildlauf für Meldungen, wenn sich das Formularfeld außerhalb des Bildschirms befindet (im Formular wird ein Bildlauf zum Steuerelement oder Feld durchgeführt). Die showFieldMsg()-Methode ist eine ähnliche Methode, für die ein Typparameter erforderlich ist.

Tabelle : 157. Parameter

Name	Typ	Beschreibung
name	Zeichenfolge	Name des Felds oder Steuerelements, unter dem die Fehlermeldung angezeigt werden soll.
Nachricht	Zeichenfolge	Fehlermeldung, die angezeigt werden soll.

Tabelle : 158. Ausgabe

Typ	Beschreibung
void

GlideForm – showFieldMsg(String field, String message, String type)

Zeigt eine Nachricht unter dem angegebenen Formularfeld an (entweder ein Steuerungsobjekt oder der Name des Felds). Wenn das Steuerelement oder Feld nicht auf dem Bildschirm angezeigt wird, scrollt die Methode automatisch das Formular zu diesem Feld.

Eine globale Eigenschaft (glide.ui.scroll_to_message_field) steuert den automatischen Bildlauf für Meldungen, wenn sich das Formularfeld außerhalb des Bildschirms befindet (im Formular wird ein Bildlauf zum Steuerelement oder Feld durchgeführt).

Die showErrorBox()-Method ist eine Abkürzungsmethode, für die der Typparameter nicht erforderlich ist.

Hinweis:

Diese Methode funktioniert nicht mit journal_fieldTypfeld in Core-UI.

Tabelle : 159. Parameter

Name	Typ	Beschreibung
Feld	Zeichenfolge	Name des Felds oder Steuerelements, unter dem die Nachricht angezeigt werden soll.
Nachricht	Zeichenfolge	Meldung, die angezeigt werden soll.
type	Zeichenfolge	Typ der Nachricht. Gültige Werte: Fehler Info Warnung

Tabelle : 160. Ausgabe

Typ	Beschreibung
void

g_form.showFieldMsg('impact','Low impact response time can be one week','info');

GlideForm – showFieldMsg(String field, String message, String type, Boolean scrollForm)

Zeigt eine Nachricht unter dem angegebenen Formularfeld an (entweder ein Steuerungsobjekt oder der Name des Felds). Ob die Steuerung oder das Feld derzeit nicht auf dem Bildschirm und angezeigt wird scrollFormIst Wahr , Die Methode scrollt das Formular zu diesem Feld.

Eine globale Eigenschaft (glide.ui.scroll_to_message_field) steuert den automatischen Bildlauf für Meldungen, wenn sich das Formularfeld außerhalb des Bildschirms befindet (im Formular wird ein Bildlauf zum Steuerelement oder Feld durchgeführt).

Die showErrorBox()-Method ist eine Abkürzungsmethode, für die der Typparameter nicht erforderlich ist.

Hinweis:

Diese Methode funktioniert nicht mit journal_fieldTypfeld in Core-UI.

Tabelle : 161. Parameter

Name	Typ	Beschreibung
Feld	Zeichenfolge	Name des Felds oder Steuerelements, unter dem die Nachricht angezeigt werden soll.
Nachricht	Zeichenfolge	Meldung, die angezeigt werden soll.
type	Zeichenfolge	Typ der Nachricht. Gültige Werte: Fehler Info Warnung
scrollForm	Boolean	Kennzeichnung, die angibt, ob das Formular automatisch zum Nachrichtenfeld gescrollt werden soll. Gültige Werte: Wahr: Scrollen Sie zum Nachrichtenfeld. Falsch: Scrollen Sie nicht zum Nachrichtenfeld. Standardwert: wahr

Tabelle : 162. Ausgabe

Typ	Beschreibung
void

g_form.showFieldMsg('impact','Low impact not allowed with High priority','error',false);

GlideForm – showRelatedLinks()

Zeigt den Abschnitt „zugehörige Links“ eines Formulars an.

Siehe auch:

• GlideForm – hideRelatedLinks()
• GlideForm – setRelatedLinksDisplay (boolesche Anzeige)

Tabelle : 163. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 164. Ergebnisse

Typ	Beschreibung
Keine

Im folgenden Beispiel werden zugehörige Links in der Formular-UI angezeigt.

// Show related links
g_form.showRelatedLinks()

GlideForm – showRelatedList(String listTableName)

Zeigt die angegebene zugehörige Liste im Formular an.

Diese Methode ist auf der mobilen Plattform nicht verfügbar. Wenn diese Methode auf einer mobilen Plattform ausgeführt wird, erfolgt keine Aktion.

Tabelle : 165. Parameter

Name	Typ	Beschreibung
listTableName	Zeichenfolge	Name der zugehörigen Liste, die angezeigt werden soll.

Tabelle : 166. Ausgabe

Typ	Beschreibung
void

GlideForm – showRelatedLists()

Zeigt alle verknüpfte Listen des Formulars an.

Diese Methode ist auf der mobilen Plattform nicht verfügbar. Wenn diese Methode auf einer mobilen Plattform ausgeführt wird, erfolgt keine Aktion.

Tabelle : 167. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 168. Ergebnisse

Typ	Beschreibung
void

GlideForm – showTemplateBar()

Wenn ausgeblendet, wird die Vorlagenleiste unten im Formular angezeigt.

Tabelle : 169. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 170. Ergebnisse

Typ	Beschreibung
Keine

Das folgende Beispielskript zeigt die Vorlagenleiste unten im aktuellen Formular an.

g_form.showTemplateBar()

GlideForm – submit()

Speichert den Datensatz.

Der Benutzer gelangt aus dem Formular an die Stelle, wo er vorher war.

Tabelle : 171. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 172. Ergebnisse

Typ	Beschreibung
void

GlideForm – submit(String verb)

Führt die angegebene UI-Aktion aus.

Tabelle : 173. Parameter

Name	Typ	Beschreibung
verb	Zeichenfolge	action_name aus einem sys_ui_action-Datensatz. Der Aktionsname ist für eine sichtbare Formularschaltfläche gedacht.

Tabelle : 174. Ausgabe

Typ	Beschreibung
void

GlideForm – toggleAnnotations()

Blendet alle Anmerkungen im Formular aus oder zeigt sie an.

Anmerkungen Sind visuelle Trennzeichen zwischen Formularelementen oder Blöcken von farbigem Text, die zum Hervorheben von Formularelementen verwendet werden. Wenn Anmerkungen im Formular sichtbar sind, wird aufgerufen ToggleAnnotations() Blendet sie aus. Wenn Anmerkungen im Formular ausgeblendet sind, werden sie beim Aufrufen dieser Methode angezeigt.

Siehe auch:

• GlideForm – HideAnnotation(Zeichenfolgenname)
• GlideForm – showAnnotation(Zeichenfolgenname)

Tabelle : 175. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 176. Ergebnisse

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie anrufen ToggleAnnotations() Zum ein- oder Ausblenden von Formularanmerkungen. Daher werden Anmerkungen je nach vorherigem Status ausgeblendet oder angezeigt.

g_form.toggleAnnotations();