GlideForm (g_Form) – Client

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 29 Minuten Lesedauer

    • Die GlideForm Die API stellt Methoden zum Anpassen von Formularen bereit.

    GlideForm.js ist die JavaScript-Klasse, die die Methoden enthält. Nur verwenden GlideForm Methoden auf dem Client. Sie können diese Methoden verwenden, um anwenderdefinierte Änderungen an der Formularansicht von Datensätzen vorzunehmen. Die gesamte Validierung von Beispielen wurde mithilfe von Client-Skripts durchgeführt.

    Sie können einige dieser Methoden auch in anderen Client-Skripts verwenden (z. B. Katalog-Clientskripts oder Assistenten-Clientskripts). Sie müssen dies jedoch zuerst testen, um zu bestimmen, 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 Skripterstellung und Migration für GlideForm für Mobilgeräte (g_Form) .

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

    GlideForm – addDecoration (Zeichenfolgenfeldname, Zeichenfolgensymbol, Zeichenfolgentitel)

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

    Das doppelte Hinzufügen desselben Elements wird verhindert. Sie können jedoch dasselbe Symbol mit einem anderen Titel hinzufügen.
    Hinweis:
    Diese Methode wird vom Servicekatalog nicht unterstützt.
    Tabelle : 1. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Der Feldname.
    icon Zeichenfolge Das Schriftartsymbol, das neben dem Feld angezeigt werden soll. Unterstützte Symbole – icon-user, icon-user-Group, icon-lightbulb, icon-Home, icon-mobile, icon-comment, icon-Mail, icon-locked, icon-database, icon-book, icon-Drawer, icon-folder, icon-catalog, icon-tab, icon-cards, icon-Tree-right, icon-Tree, icon-book-Open, icon-paperclip, icon-Edit, icon-Papierkorb, icon-image, icon-Search, icon-Power, icon-cog, icon-Star, icon-Star-empty, icon-New-Ticket, icon-Dashboard, icon-cart-Full, Symbolansicht, Symbolbezeichnung, Symbolfilter, Symbol-Kalender, Symbol-Skript, icon-hinzufügen, icon-löschen, icon-help, icon-info, icon-Check-Circle, icon-Alert, icon-sortieren-aufsteigend, icon-Console, icon-list, icon-Form, und icon-Livefeed.
    Titel Zeichenfolge Der Texttitel für das Symbol.
    Tabelle : 2. Rückgaben
    Typ Beschreibung
    Ungültig 
    g_form.addDecoration('caller_id', 'icon-star', 'preferred member');

    GlideForm – addDecoration (Zeichenfolgenfeldname, Zeichenfolgensymbol, Zeichenfolgentitel, Zeichenfolgenfarbe)

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

    Das doppelte Hinzufügen desselben Elements wird verhindert. Sie können jedoch dasselbe Symbol mit einem anderen Titel hinzufügen.
    Hinweis:
    Diese Methode wird vom Servicekatalog nicht unterstützt.
    Tabelle : 3. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Der Feldname.
    icon Zeichenfolge Das Schriftartsymbol, das neben dem Feld angezeigt werden soll. Unterstützte Symbole – icon-user, icon-user-Group, icon-lightbulb, icon-Home, icon-mobile, icon-comment, icon-Mail, icon-locked, icon-database, icon-book, icon-Drawer, icon-folder, icon-catalog, icon-tab, icon-cards, icon-Tree-right, icon-Tree, icon-book-Open, icon-paperclip, icon-Edit, icon-Papierkorb, icon-image, icon-Search, icon-Power, icon-cog, icon-Star, icon-Star-empty, icon-New-Ticket, icon-Dashboard, icon-cart-Full, Symbolansicht, Symbolbezeichnung, Symbolfilter, Symbol-Kalender, Symbol-Skript, icon-hinzufügen, icon-löschen, icon-help, icon-info, icon-Check-Circle, icon-Alert, icon-sortieren-aufsteigend, icon-Console, icon-list, icon-Form, und icon-Livefeed.
    Titel Zeichenfolge Der Texttitel für das Symbol.
    Farbe Zeichenfolge Eine CSS-Farbe.
    Tabelle : 4. Rückgaben
    Typ Beschreibung
    Ungültig 
    g_form.addDecoration('caller_id', 'icon-star', 'Mark as Favorite', 'color-green');

    GlideForm – addErrorMessage(Zeichenfolgennachricht)

    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 Anzuzeigende Nachricht.
    Tabelle : 6. Rückgaben
    Typ Beschreibung
    Ungültig 
    g_form.addErrorMessage('This is an error');

    GlideForm – addFormMessage(Zeichenfolgennachricht, Zeichenfolgentyp, Objektoptionen)

    Zeigt eine Floating-Formularnachricht oben im Abschnitt „Formulardetails“ an. Die Nachricht deckt keine UI-Aktionen ab.

    Siehe auch:
    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Anzuzeigende Nachricht.
    Typ Zeichenfolge Der Typ der Nachricht.
    Gültige Werte:
    • Fehler
    • Info
    • Warnung
    Optionen Objekt Optional. Objekt mit Schaltflächen, die der Formularnachricht hinzugefügt werden sollen, und allen Metadaten, die für die Verarbeitung eines Schaltflächenklicks erforderlich sind.
    {
  buttons: [Array],
  meta: {Object}
}
    Optionen.Schaltflächen Array Array von Schaltflächen, die der Formularnachricht hinzugefügt werden sollen.
    buttons: [
  {
    label: "String", 
    actionName: "String"
  }
]
    Optionen.Schaltflächen.Bezeichnung Zeichenfolge Text, der auf der Schaltfläche angezeigt werden soll.
    Optionen.Schaltflächen.actionName Zeichenfolge Name, der von FORM_MESSAGE_BUTTON_CLICKED-Ereignis-Handlern verwendet wird, um die Schaltfläche zu bestimmen, auf die geklickt wurde.

    Beispiel: Wenn Sie eine Schaltfläche mit dem actionName hinzufügen Mir_zuweisen , Sie müssen einen Ereignis-Handler in erstellen UIBFür das FORM_MESSAGE_BUTTON_CLICKED-Ereignis, das nur ausgeführt wird, wenn „actionName“ lautet Zugewiesen_mir .
    Optionen.Meta Objekt Ordnen Sie alle Metadaten zu, die zur 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. Rückgaben
    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 – addInfoMessage(Zeichenfolgennachricht)

    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 : 9. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Anzuzeigende Nachricht.
    Tabelle : 10. Rückgaben
    Typ Beschreibung
    Ungültig 
    g_form.addInfoMessage('The top five fields in this form are mandatory');

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

    Fügt eine Auswahl am Ende eines Auswahllistenfelds hinzu.

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Der Name des Felds.
    choiceValue Zeichenfolge Der Wert, der in der Datenbank gespeichert werden soll.
    Auswahlbezeichnung Zeichenfolge Der angezeigte Wert.
    Tabelle : 12. Rückgaben
    Typ Beschreibung
    Ungültig 
    g_form.addOption('priority', '6', '6 - Really Low');

    GlideForm – addOption(Zeichenfolgenfeldname, Zeichenfolgenauswahl Wert, Zeichenfolgenauswahl Bezeichnung, Zahlenauswahl Index)

    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 : 13. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Der Feldname.
    choiceValue Zeichenfolge Der in der Datenbank gespeicherte Wert.
    Auswahlbezeichnung Zeichenfolge Der angezeigte Wert.
    ChoiceIndex Nummer Reihenfolge der Auswahl in der Liste. Der Index befindet sich in einem Null-basierten Array.
    Tabelle : 14. Rückgaben
    Typ Beschreibung
    Ungültig 
    g_form.addOption('priority', '2.5', '2.5 - Moderately High', 3);

    GlideForm – ClearMessages()

    Entfernt alle Informations- und Fehlermeldungen oben im Formular.

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

    Tabelle : 15. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 16. Rückgaben
    Typ Beschreibung
    Ungültig 
    g_form.clearMessages();

    GlideForm – ClearAllFormMessages()

    Entfernt alle Formularnachrichten eines beliebigen Typs.

    Siehe auch:
    Tabelle : 17. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 18. Rückgaben
    Typ Beschreibung
    Keine

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

    g_form.clearAllFormMessages();

    GlideForm – ClearFormMessages (Zeichenfolgentyp)

    Entfernt alle Formularnachrichten eines bestimmten Typs.

    Siehe auch:
    Tabelle : 19. Parameter
    Name Typ Beschreibung
    Typ Zeichenfolge Der Typ der Nachricht.
    Gültige Werte:
    • Fehler
    • Info
    • Warnung
    Tabelle : 20. Rückgaben
    Typ Beschreibung
    Keine

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

    g_form.clearFormMessages('error');

    GlideForm – klarOptions(Zeichenfolge fieldName)

    Entfernt alle Optionen aus der Auswahlliste.

    Tabelle : 21. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    Tabelle : 22. Rückgaben
    Typ Beschreibung
    Ungültig

    GlideForm – ClearValue(String fieldName)

    Entfernt alle Werte aus dem Feld.

    Tabelle : 23. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    Tabelle : 24. Rückgaben
    Typ Beschreibung
    Ungültig

    GlideForm – disableAttachments()

    Verhindert das Hinzufügen von Dateianhängen.

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

    Tabelle : 25. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 26. Rückgaben
    Typ Beschreibung
    Ungültig

    GlideForm – enableAttachments()

    Ermöglicht das Hinzufügen von Dateianhängen. Zeigt das Büroklammer-Symbol 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 : 27. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 28. Rückgaben
    Typ Beschreibung
    Ungültig

    GlideForm – Flash (Zeichenfolgenfeldname, Zeichenfolgenfarbe, Zahlenanzahl)

    Wird verwendet, um Aufmerksamkeit auf ein bestimmtes Feld zu lenken. Blinkt die angegebene Farbe für eine angegebene Zeitdauer im angegebenen Feld.

    Diese Methode wird vom Servicekatalog nicht unterstützt.

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

    Tabelle : 29. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Gibt das zu hervorgehobene Feld im folgenden Format an: „<table-name>.<field-name>“ .
    Farbe Zeichenfolge RGB-Farbe oder zulässige CSS-Farbe.
    count Nummer Gibt an, wie lange die Bezeichnung blinkt. Optionen umfassen:
    • 2: Blinkt 1 Sekunde lang
    • 0: Blinkt 2 Sekunden lang
    • -2: Blinkt 3 Sekunden lang
    • -4: Blinkt 4 Sekunden lang
    Tabelle : 30. Rückgaben
    Typ Beschreibung
    Ungültig 
    g_form.flash("incident.number", "#FFFACD", 0);

    GlideForm – getActionName()

    Gibt den Namen der neuesten Aktion oder für ein Clientskript die sys_ID der angeklickten UI-Aktion zurück.

    Hinweis:
    Nicht verfügbar in Assistenten-Client-Skripts.
    Tabelle : 31. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 32. Rückgaben
    Typ Beschreibung
    Zeichenfolge Der aktuelle Aktionsname. 
    function onSubmit() {
   var action = g_form.getActionName();
   alert('You pressed ' + action);
}

    GlideForm – getBooleanValue(Zeichenfolge fieldName)

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

    Tabelle : 33. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    Tabelle : 34. Rückgaben
    Typ Beschreibung
    Boolean Gibt „falsch“ zurück, wenn der Feldwert „falsch“ oder „nicht definiert“ ist. Andernfalls wird „wahr“ zurückgegeben.

    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 ist und das Steuerelement eine Auswahlliste ist, GetControl() Gibt möglicherweise keine Steuerung wie erwartet zurück. Verwenden Sie in diesem Fall sys_select. <table name>.<field name> .

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

    Tabelle : 35. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    Tabelle : 36. Rückgaben
    Typ Beschreibung
    HTMLElement Das HTML-Element des Felds.

    GlideForm – getDecimalValue(Zeichenfolge fieldName)

    Gibt den Dezimalwert des angegebenen Felds zurück.

    Tabelle : 37. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Der Name des Felds.
    Tabelle : 38. Rückgaben
    Typ Beschreibung
    Zeichenfolge Der Dezimalwert des angegebenen Felds. 
    function onChange(control, oldValue, newValue, isLoading) {
   alert(g_form.getDecimalValue('percent_complete'));
}

    GlideForm – getDisplayBox(Zeichenfolge fieldName)

    Ruft den Anzeigewert aus einem Formular in der Core-UI ab.

    Hinweis:
    Dient zum Abrufen eines Anzeigewerts aus einem Formular in Serviceportal, Verwenden Sie GetDisplayValue() Methode.
    Siehe auch:
    Tabelle : 39. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds, aus dem Sie einen Wert im Formular abrufen möchten.
    Tabelle : 40. Rückgaben
    Typ Beschreibung
    Keine 
    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)

    Ruft den Anzeigewert aus einem Formular in ab Serviceportal.

    Hinweis:
    Um einen Anzeigewert aus einem Formular in der Core-UI abzurufen, verwenden Sie GetDisplayBox() Methode.
    Siehe auch:
    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 : 41. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds, aus dem Sie einen Wert im Formular abrufen möchten.
    Tabelle : 42. Rückgaben
    Typ Beschreibung
    Keine

    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 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(Zeichenfolgen-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 Serviceportal-Skripts nicht verfügbar.

    Tabelle : 43. Parameter
    Name Typ Beschreibung
    ID Zeichenfolge Die Feld-ID
    Tabelle : 44. Rückgaben
    Typ Beschreibung
    HTMLElement Das HTML-Element des Felds.

    GlideForm – getFormElement()

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

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

    Tabelle : 45. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 46. Rückgaben
    Typ Beschreibung
    HTMLFormelement Das 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 Servicekatalog-Variablen.

    Tabelle : 47. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    Tabelle : 48. Rückgaben
    Typ Beschreibung
    HTMLElement HTML-Element des Hilfetext-Felds.

    GlideForm – getIntValue(String fieldName)

    Gibt den ganzzahligen Wert des Felds zurück.

    Tabelle : 49. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Der Feldname.
    Tabelle : 50. Rückgaben
    Typ Beschreibung
    Nummer Ganzzahlwert des Felds.

    GlideForm – getLabelOf(Zeichenfolge fieldName)

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

    Tabelle : 51. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Der Feldname
    Tabelle : 52. Rückgaben
    Typ Beschreibung
    Zeichenfolge Der Bezeichnungstext. 
    if (g_user.hasRole('itil')) {
    var oldLabel = g_form.getLabelOf('comments');
    g_form.setLabelOf('comments', oldLabel + ' (Customer visible)');
}

    GlideForm – getOption (Zeichenfolge feldName, Zeichenfolge 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 : 53. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    choiceValue Zeichenfolge Wert der Option.
    Tabelle : 54. Rückgaben
    Typ Beschreibung
    HTMLElement Das HTMLElement für die Option. Gibt Null zurück, wenn das Feld oder die Option nicht gefunden wird.

    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 – getReference(Zeichenfolge fieldName, Funktionsrückruf)

    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 hängen bleibt), während auf eine Serverantwort gewartet wird.

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

    Unterstützung der Rückruffunktion 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 : 55. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    Rückruf Funktion Name der Rückruffunktion.
    Tabelle : 56. Rückgaben
    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 rows.length = 0 ist.

    		 
    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 : 57. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 58. Rückgaben
    Typ Beschreibung
    Array Zeichenfolgen-Array von 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, ob sichtbar oder nicht.

    Tabelle : 59. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 60. Rückgaben
    Typ Beschreibung
    Array von Zeichenfolgen Die Abschnittsnamen.

    GlideForm – getSections()

    Gibt ein Array der Abschnitte des Formulars zurück.

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

    Tabelle : 61. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 62. Rückgaben
    Typ Beschreibung
    Array von HTML-Elementen Die 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 der Serverseite kann die Tabelle für den aktuellen Datensatz mit abgerufen werden Current.sys_class_Name Oder Current.getTableName() .

    Tabelle : 63. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 64. Rückgaben
    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 im Formular angezeigten Datensatzes zurück.

    Tabelle : 65. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 66. Rückgaben
    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 : 67. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds, dessen Wert zurückgegeben werden soll.
    Tabelle : 68. Rückgaben
    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 innerhalb der MRVS nach dem in eingegebenen Wert Stellenbezeichnung Und aktualisiert dann die übereinstimmenden Einträge innerhalb der MRVS mit den Eingaben in Gehalt Feld. Die 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 Feldnachrichten aus.

    Tabelle : 69. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 70. Rückgaben
    Typ Beschreibung
    Ungültig

    GlideForm – hideAllFieldMsgs (Zeichenfolgentyp)

    Blendet alle Feldnachrichten des angegebenen Typs aus.

    Tabelle : 71. Parameter
    Name Typ Beschreibung
    Typ Zeichenfolge Der Typ der Nachricht.
    Gültige Werte:
    • Fehler
    • Info
    Tabelle : 72. Rückgaben
    Typ Beschreibung
    Ungültig

    GlideForm – hideErrorBox(Zeichenfolge fieldName)

    Blendet die von platzierte Fehlermeldung aus ShowErrorBox() .

    Verwenden Sie, wann immer möglich HideFieldMsg() Anstatt dieser Methode, wann immer möglich.

    Tabelle : 73. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Der Name des Felds oder Steuerelements.
    Tabelle : 74. Rückgaben
    Typ Beschreibung
    Ungültig

    GlideForm – hideFieldMsg(Zeichenfolge fieldName, boolescher CLEARALL)

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

    Verwenden Sie GlideForm – showFieldMsg (Zeichenfolgenfeld, Zeichenfolgennachricht, Zeichenfolgentyp)Oder GlideForm – showFieldMsg (Zeichenfolgenfeld, Zeichenfolgennachricht, Zeichenfolgentyp, boolesches Bildlaufformular)Methoden zum Anzeigen von Nachrichten in einem Formular.

    Das folgende Codefragment zeigt beispielsweise, wie zwei Nachrichten auf 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 : 75. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds, in dem die Nachricht ausgeblendet werden soll.
    CLEARAL 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.

    Standard: Falsch
    Tabelle : 76. Rückgaben
    Typ Beschreibung
    Ungültig

    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 – hideRelatedList(Zeichenfolge listTableName)

    Blendet die angegebene zugehörige Liste im Formular aus.

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

    Tabelle : 77. Parameter
    Name Typ Beschreibung
    ListTabellenname Zeichenfolge Name der zugehörigen Liste. Verwenden Sie die sys_ID, um eine Liste über eine Beziehung auszublenden.
    Tabelle : 78. Rückgaben
    Typ Beschreibung
    Ungültig

    GlideForm – hideRelatedLists()

    Blendet alle zugehörigen Listen im Formular aus.

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

    Tabelle : 79. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 80. Rückgaben
    Typ Beschreibung
    Ungültig

    GlideForm – isLiveUpdating()

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

    Dies kann in verwendet werden OnChange() Client-Skript, um zu bestimmen, ob eine Änderung am Datensatz auf ein Live-Update aus einer anderen Sitzung zurückzuführen ist. Das Client-Skript kann dann entscheiden, welche Aktion ausgeführt werden soll oder nicht. Dies gilt für Systeme, die verwenden Core-UIMit aktivierten Live-Formularen.

    Tabelle : 81. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 82. Rückgaben
    Typ Beschreibung
    Boolean Gibt „wahr“ zurück, wenn ein Live-Update für den vom Formular angezeigten Datensatz stattfindet.

    GlideForm – isobligatory(String fieldName)

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

    Tabelle : 83. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    Tabelle : 84. Rückgaben
    Typ Beschreibung
    Boolean „Wahr“, wenn das Feld erforderlich ist, andernfalls „falsch“.

    GlideForm – isNewRecord()

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

    Tabelle : 85. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 86. Rückgaben
    Typ Beschreibung
    Boolean Gibt „wahr“ zurück, wenn der Datensatz nicht gespeichert wurde; andernfalls „falsch“. 
    function onLoad() {
   if(g_form.isNewRecord()){
      alert('New Record!');
   }
}

    GlideForm – isSectionVisible(Zeichenfolge sectionName)

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

    Wichtig:
    Die Funktion „isSectionVisible()“ wird im Arbeitsbereich nicht unterstützt.
    Tabelle : 87. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 88. Rückgaben
    Typ Beschreibung
    Boolean Gibt „wahr“ zurück, wenn der Abschnitt sichtbar ist. Andernfalls wird „falsch“ zurückgegeben.

    GlideForm – isVisible(Zeichenfolge fieldName)

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

    Tabelle : 89. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds, um zu überprüfen, ob es im aktuellen Formular sichtbar ist.
    Tabelle : 90. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob das angegebene Feld im aktuellen Formular sichtbar ist.
    Gültige 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 ServicekatalogElemente in der klassischen Umgebung.
    Tabelle : 91. Parameter
    Name Typ Beschreibung
    fn Funktion Funktion, die aufgerufen werden soll, wenn ein Anwender den Wert eines Felds im aktuellen Formular ändert. Dies ist tatsächlich der Funktionscode, nicht nur der Funktionsname.

    Diese Funktion muss die folgenden drei Argumente akzeptieren:

    • Feldname
    • Ursprünglicher Feldwert
    • Feldwert aktualisiert
    Tabelle : 92. Rückgaben
    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(Zeichenfolge fieldName)

    Sie können eine Listensammlervariable aktualisieren.

    Tabelle : 93. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Slush-Buckets.
    Tabelle : 94. Rückgaben
    Typ Beschreibung
    Ungültig 
    g_form.refreshSlushbucket('bucket');

    GlideForm – removeDecoration (Zeichenfolgenfeldname, Zeichenfolgensymbol, Zeichenfolgentitel)

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

    Hinweis:
    Diese Methode wird vom Servicekatalog nicht unterstützt.
    Tabelle : 95. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Feldname.
    icon Zeichenfolge Name des zu entfernenden Symbols.
    Titel Zeichenfolge Der Texttitel (Name) des Symbols.
    Tabelle : 96. Rückgaben
    Typ Beschreibung
    Ungültig 
    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 (Zeichenfolgenfeldname, Zeichenfolgensymbol, Zeichenfolgentitel, Zeichenfolgenfarbe)

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

    Hinweis:
    Diese Methode wird vom Servicekatalog nicht unterstützt.
    Tabelle : 97. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Feldname.
    icon Zeichenfolge Name des zu entfernenden Symbols.
    Titel Zeichenfolge Der Texttitel (Name) des Symbols.
    Farbe Zeichenfolge Eine CSS-Farbe
    Tabelle : 98. Rückgaben
    Typ Beschreibung
    Ungültig 
    g_form.removeDecoration('caller_id', 'icon-star', 'VIP', 'blue');

    GlideForm – removeOption (Zeichenfolge feldName, Zeichenfolge choiceValue)

    Entfernt die angegebene Option aus der Auswahlliste.

    Tabelle : 99. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    choiceValue Zeichenfolge Der in der Datenbank gespeicherte Wert. Dies ist nicht die Bezeichnung.
    Tabelle : 100. Rückgaben
    Typ Beschreibung
    Ungültig 
    g_form.removeOption('priority', '1');

    GlideForm – Save()

    Speichert den Datensatz, ohne fortzunavigieren (aktualisieren und beibehalten).

    Tabelle : 101. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 102. Rückgaben
    Typ Beschreibung
    Ungültig

    GlideForm – setobligatory(Zeichenfolge fieldName, boolescher Wert obligatorisch)

    Macht das angegebene Feld obligatorisch.

    Verwenden Sie wann immer möglich eine UI-Richtlinie anstelle dieser Methode.

    Tabelle : 103. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    Obligatorisch Boolean Bei „wahr“ ist das Feld obligatorisch. Bei „falsch“ wird das Feld optional.
    Tabelle : 104. Rückgaben
    Typ Beschreibung
    Ungültig

    GlideForm – setSectionDisplay(Zeichenfolge sectionName, boolesche Anzeige)

    Blendet einen Abschnitt ein oder aus.

    Tabelle : 105. Parameter
    Name Typ Beschreibung
    sectionName Zeichenfolge Der Abschnittsname ist in Kleinbuchstaben angegeben, wobei ein Unterstrich das erste Leerzeichen im Namen ersetzt. Wenn die verbleibenden Leerzeichen entfernt werden, wird beispielsweise „Abschnitt vier ist hier“ zu „section_fourishere“. Andere nicht alphanumerische Zeichen, z. B. Amperand (&), werden entfernt. Abschnittsnamen können mithilfe von gefunden werden GetSectionNames() Methode.
    Anzeigen Boolean Bei „wahr“ wird der Abschnitt angezeigt. Bei „falsch“ wird der Abschnitt ausgeblendet.
    Tabelle : 106. Rückgaben
    Typ Beschreibung
    Boolean Gibt „wahr“ zurück, wenn erfolgreich.

    GlideForm – setValue (Zeichenfolgenfeldname, Zeichenfolgenwert, ZeichenfolgendisplayValue)

    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 Listenerfassungsfeld festlegen, übergeben Sie Arrays in valueUnd displayValueParameter.

    Hinweis:
    Die Methode SetWert() Kann bei Verwendung in einem OnChange-Client-Skript zu einem Stapelüberlauf führen. Dies liegt daran, dass jedes Mal, wenn der Wert festgelegt wird, als Change registriert wird, was das OnChange-Client-Skript erneut auslösen kann. Um dies zu verhindern, führen Sie eine Überprüfung durch, die bestätigt, dass sich der neue Wert vom alten Wert unterscheidet. Beispiel: Vor der Ausführung SetValue(shortDesc, newValue.toUpperCase()); , Validieren Sie, dass die Kurzbeschreibung nicht bereits Großbuchstaben enthält. Dadurch wird verhindert, dass das Client-Skript angewendet wird Zu UpperCase() Mehrmals.
    Tabelle : 107. 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 den Zahlenwert anstelle der Bezeichnung.
    displayValue Zeichenfolge oder Array Feld im angegebenen Referenzdatensatz, das zum Aktualisieren des angegebenen Felds verwendet werden soll. Beispiel: In der Anwendertabelle [sys_user] kann es sich um einen Anwendernamen 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 : 108. Rückgaben
    Typ Beschreibung
    Ungültig

    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 entsprechender 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 – showErrorBox(Zeichenfolgenname, Zeichenfolgennachricht, boolesches Scrollformular)

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

    Eine globale Eigenschaft (glide.ui.scroll_to_message_field) ist verfügbar, die das automatische Scrollen von Nachrichten steuert, wenn sich das Formularfeld außerhalb des Bildschirms befindet (scrollt das Formular zum Steuerelement oder Feld). Die ShowFieldMsg() Methode ist eine ähnliche Methode, die einen Typparameter erfordert.

    Tabelle : 109. Parameter
    Name Typ Beschreibung
    name Zeichenfolge Name des Felds oder Steuerelements.
    Nachricht Zeichenfolge Anzuzeigende Nachricht.
    Scrollformular Boolean Bei „wahr“ wird das Formular zum Feld gescrollt. Bei „falsch“ scrollen Sie nicht zum Feld.
    Tabelle : 110. Rückgaben
    Typ Beschreibung
    Ungültig

    GlideForm – showFieldMsg (Zeichenfolgenfeld, Zeichenfolgennachricht, Zeichenfolgentyp)

    Zeigt entweder eine Informations- oder Fehlermeldung unter dem angegebenen Formularfeld an (entweder ein Steuerungsobjekt oder der Name des Felds). Wenn sich das Steuerelement oder Feld außerhalb des Bildschirms befindet, wird das Formular zum Feld gescrollt.

    Eine globale Eigenschaft (glide.ui.scroll_to_message_field) ist verfügbar, die das automatische Scrollen von Nachrichten steuert, wenn sich das Formularfeld außerhalb des Bildschirms befindet (scrollt das Formular zum Steuerelement oder Feld).

    Die ShowErrorBox() Methode ist eine Kurzmethode, die den Typparameter nicht erfordert.

    Hinweis:
    Diese Methode funktioniert nicht mit journal_fieldGeben Sie das Feld ein Core-UI.
    Tabelle : 111. Parameter
    Name Typ Beschreibung
    Ausstehend Zeichenfolge Name des Felds oder Steuerelements.
    Nachricht Zeichenfolge Anzuzeigende Nachricht.
    Typ Zeichenfolge „Fehler“,„Info“ oder „Warnung“.
    Tabelle : 112. Rückgaben
    Typ Beschreibung
    Ungültig 
    g_form.showFieldMsg('impact','Low impact response time can be one week','info');

    GlideForm – showFieldMsg (Zeichenfolgenfeld, Zeichenfolgennachricht, Zeichenfolgentyp, boolesches Bildlaufformular)

    Zeigt entweder eine Informations- oder Fehlermeldung unter dem angegebenen Formularfeld an (entweder ein Steuerungsobjekt oder der Name des Felds). Wenn sich das Steuerelement oder Feld derzeit nicht auf dem Bildschirm befindet und das Scrollformular auf „wahr“ festgelegt ist, wird das Formular zum Feld gescrollt.

    Eine globale Eigenschaft (glide.ui.scroll_to_message_field) ist verfügbar, die das automatische Scrollen von Nachrichten steuert, wenn sich das Formularfeld außerhalb des Bildschirms befindet (scrollt das Formular zum Steuerelement oder Feld).

    Die ShowErrorBox() Methode ist eine Kurzmethode, die den Typparameter nicht erfordert.

    Hinweis:
    Diese Methode funktioniert nicht mit journal_fieldGeben Sie das Feld ein Core-UI.
    Tabelle : 113. Parameter
    Name Typ Beschreibung
    Ausstehend Zeichenfolge Name des Felds oder Steuerelements.
    Nachricht Zeichenfolge Anzuzeigende Nachricht.
    Typ Zeichenfolge „Fehler“,„Info“ oder „Warnung“.
    Scrollformular Boolean Bei „wahr“ scrollt das Formular zum Feld, wenn es außerhalb des Bildschirms ist. Bei „falsch“ wird im Formular kein Bildlauf ausgeführt.
    Tabelle : 114. Rückgaben
    Typ Beschreibung
    Ungültig 
    g_form.showFieldMsg('impact','Low impact not allowed with High priority','error',false);

    GlideForm – setDisabled(Zeichenfolge fieldName, boolescher Wert deaktiviert)

    Macht das angegebene Feld verfügbar oder nicht verfügbar.

    Tabelle : 115. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    Deaktivieren Boolean Bei „wahr“ wird das Feld deaktiviert. Bei „falsch“ wird das Feld aktiviert.
    Tabelle : 116. Rückgaben
    Typ Beschreibung
    Ungültig

    GlideForm – setDisplay (Zeichenfolge feldName, boolesche Anzeige)

    Blendet ein Feld ein oder aus.

    Diese Methode kann kein Pflichtfeld ohne Wert ausblenden. Wenn das Feld ausgeblendet ist, wird der Bereich zum Anzeigen anderer Elemente verwendet. Verwenden Sie wann immer möglich eine UI-Richtlinie anstelle dieser Methode.

    Tabelle : 117. Parameter
    Name Typ Beschreibung
    Feldname Zeichenfolge Name des Felds.
    Anzeigen Boolean Bei „wahr“ wird das Feld angezeigt, bei „falsch“ wird das Feld ausgeblendet.
    Tabelle : 118. Rückgaben
    Typ Beschreibung
    Ungültig 
    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(Zeichenfolge Feldname, Zeichenfolgenbezeichnung)

    Legt den nur-Text-Wert der Feldbezeichnung fest.

    Hinweis:
    Diese Methode wird vom Servicekatalog nicht unterstützt.
    Tabelle : 119. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Der Feldname.
    label Zeichenfolge Die Feldtextbezeichnung.
    Tabelle : 120. Rückgaben
    Typ Beschreibung
    Ungültig 
    if (g_user.hasRole('itil')) {
    var oldLabel = g_form.getLabelOf('comments');
    g_form.setLabelOf('comments', oldLabel + ' (Customer visible)');
}

    GlideForm – setReadOnly(Zeichenfolge Feldname, boolescher Wert schreibgeschützt)

    Macht das angegebene Feld schreibgeschützt oder bearbeitbar.

    Verwenden Sie wann immer möglich eine UI-Richtlinie anstelle dieser Methode.

    Um ein Pflichtfeld schreibgeschützt zu machen, müssen Sie zuerst die obligatorische Anforderung für dieses Feld entfernen, indem Sie verwenden Setobligatory() Methode.

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

    Tabelle : 121. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    Monatlich Boolean Kennzeichnung, die bestimmt, ob das zugeordnete Feld bearbeitbar oder schreibgeschützt ist.
    Mögliche Werte:
    • Wahr: Feld auf schreibgeschützt festlegen
    • Falsch: Feld als bearbeitbar festlegen
    Tabelle : 122. Rückgaben
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie der Variableneditor als schreibgeschützt festgelegt wird. Um dies in zu tun ServicekatalogTabellen, 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 – setValue(String fieldName, Zeichenfolgenwert)

    Legt den Wert eines angegebenen Formularfelds auf den übergebenen 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 dann die Indexierung zu verwenden, um die Felder in den Zeilenobjekten zu aktualisieren. Sobald alle Werte in der MRVS aktualisiert wurden, verwenden Sie SetWert() Methode zum Speichern des aktualisierten MRVS-Arrays. Weitere Details finden Sie im Codebeispiel unten.

    Hinweis:
    Die Methode SetWert() Kann bei Verwendung in einem OnChange-Client-Skript zu einem Stapelüberlauf führen. Dies liegt daran, dass jedes Mal, wenn der Wert festgelegt wird, als Change registriert wird, was das OnChange-Client-Skript erneut auslösen kann. Um dies zu verhindern, führen Sie eine Überprüfung durch, die bestätigt, dass sich der neue Wert vom alten Wert unterscheidet. Beispiel: Vor der Ausführung SetValue(shortDesc, newValue.toUpperCase()); , Validieren Sie, dass die Kurzbeschreibung nicht bereits Großbuchstaben enthält. Dadurch wird verhindert, dass das Client-Skript angewendet wird Zu UpperCase() Mehrmals.
    Tabelle : 123. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des zu aktualisierenden Formularfelds.
    Wert Zeichenfolge Zeichenfolgenwert, der im angegebenen Feld festgelegt werden soll.
    Hinweis:
    Wenn Sie einen Wert in einer Auswahlliste definieren, verwenden Sie den Zahlenwert anstelle der Bezeichnung.
    Tabelle : 124. Rückgaben
    Typ Beschreibung
    Ungültig

    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 innerhalb der MRVS nach dem in eingegebenen Wert Stellenbezeichnung Und aktualisiert dann die übereinstimmenden Einträge innerhalb der MRVS mit den Eingaben in Gehalt Feld. Die 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 – setVariablesReadOnly(Boolescher IsReadOnly)

    Erstellt einen ServicekatalogVariableneditor schreibgeschützt.

    Hinweis:
    Diese Methode gilt nur für ServicekatalogVariableneditoren in der Core-UI. Diese Methode wird in nicht unterstützt ServicekatalogFormular.

    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: Variableneditoren des Servicekatalogs

    Tabelle : 125. Parameter
    Name Typ Beschreibung
    isReadOnly Boolean Kennzeichnung, die bestimmt, ob der Variableneditor schreibgeschützt ist.
    Mögliche Werte:
    • Wahr: Legt den Variableneditor als schreibgeschützt fest.
    • Falsch: Legt den Variableneditor als bearbeitbar fest.

    Standard: Falsch
    Tabelle : 126. Rückgaben
    Typ Beschreibung
    Keine

    Durch das Hinzufügen der folgenden Zeile zu einem Clientskript wird der Variableneditor als schreibgeschützt festgelegt.

    g_form.setVariablesReadOnly(true);

    GlideForm – setVisible(Zeichenfolge fieldName, boolesche Anzeige)

    Blendet das Feld ein oder aus.

    Auf der Desktop-UI wird der Bereich leer gelassen, wenn er ausgeblendet ist. Auf der mobilen oder Serviceportal-UI wird der Bereich in „meine anderen Felder“ ausgefüllt, wenn er ausgeblendet ist. Diese Methode kann Pflichtfelder ohne Wert nicht ausblenden.

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

    Tabelle : 127. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Der Feldname.
    Anzeigen Boolean Bei „wahr“ wird das Feld angezeigt. Bei „falsch“ wird das Feld ausgeblendet.
    Tabelle : 128. Rückgaben
    Typ Beschreibung
    Ungültig 
    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 – showErrorBox (Zeichenfolgenname, Zeichenfolgennachricht)

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

    Eine globale Eigenschaft (glide.ui.scroll_to_message_field) ist verfügbar, die das automatische Scrollen von Nachrichten steuert, wenn sich das Formularfeld außerhalb des Bildschirms befindet (scrollt das Formular zum Steuerelement oder Feld). Die ShowFieldMsg() Methode ist eine ähnliche Methode, die einen Typparameter erfordert.

    Tabelle : 129. Parameter
    Name Typ Beschreibung
    name Zeichenfolge Der Name der Steuerung oder des Felds.
    Nachricht Zeichenfolge Die anzuzeigende Nachricht.
    Tabelle : 130. Rückgaben
    Typ Beschreibung
    Ungültig

    GlideForm – showRelatedList(Zeichenfolge 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 : 131. Parameter
    Name Typ Beschreibung
    ListTabellenname Zeichenfolge Name der zugehörigen Liste.
    Tabelle : 132. Rückgaben
    Typ Beschreibung
    Ungültig

    GlideForm – showRelatedLists()

    Zeigt alle zugehörigen 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 : 133. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 134. Rückgaben
    Typ Beschreibung
    Ungültig

    GlideForm – Submit()

    Speichert den Datensatz.

    Der Anwender wird aus dem Formular entfernt und dorthin zurückgegeben, wo er sich befand.

    Tabelle : 135. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 136. Rückgaben
    Typ Beschreibung
    Ungültig

    GlideForm – übermitteln (Zeichenfolgenverb)

    Führt die vom Parameter angegebene UI-Aktion aus.

    Tabelle : 137. Parameter
    Name Typ Beschreibung
    verb Zeichenfolge Ein action_Name aus einem sys_ui_action-Datensatz. Der Aktionsname muss für eine sichtbare Formularschaltfläche sein.
    Tabelle : 138. Rückgaben
    Typ Beschreibung
    Ungültig