GlideForm – Client

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 29 Minuten Lesedauer

    • Die GlideForm- API bietet Methoden zum Anpassen von Formularen.

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

    Einige dieser Methoden können Sie auch in anderen Client-Skripts (z. B. Katalog-Client-Skripts oder Assistenten-Client-Skripts) verwenden. 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. Informationen zur Verwendung von GlideForm für Mobilgeräte finden Sie unter Skripting und Migration für Mobile Client GlideForm (g_form).

    Es gibt keinen Konstruktor für die GlideForm -Klasse. Greifen Sie mit dem globalen Objekt „g_form“ auf GlideForm- Methoden zu.

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

    Fügt der Bezeichnung eines Felds ein Symbol 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 : 1. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Der Feldname.
    icon Zeichenfolge Das Schriftartsymbol, das neben dem Feld angezeigt wird. 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-trash, icon-image, icon-search, icon-power, icon-cog, icon-star, icon-star-empty, icon-new-ticket, icon-dashboard, icon-cart-full, icon-view, icon-label, icon-filter, icon-calendar, icon-script, icon-add, icon-delete, icon-help, icon-info, icon-check-circle, icon-alert, icon-sort-ascending, icon-console, icon-list, icon-form und icon-livefeed.
    title Zeichenfolge Texttitel für das Symbol.
    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    void 
    g_form.addDecoration('caller_id', 'icon-star', 'preferred member');

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

    Fügt der Bezeichnung eines Felds ein Symbol 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 Der Feldname.
    icon Zeichenfolge Das Schriftartsymbol, das neben dem Feld angezeigt wird. 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-trash, icon-image, icon-search, icon-power, icon-cog, icon-star, icon-star-empty, icon-new-ticket, icon-dashboard, icon-cart-full, icon-view, icon-label, icon-filter, icon-calendar, icon-script, icon-add, icon-delete, icon-help, icon-info, icon-check-circle, icon-alert, icon-sort-ascending, icon-console, icon-list, icon-form und icon-livefeed.
    title Zeichenfolge Texttitel für das Symbol.
    color Zeichenfolge CSS-Farbe.
    Tabelle : 4. Ergebnisse
    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 etwa vier Sekunden lang angezeigt und dann ausgeblendet. Diese Zeitüberschreitung ist derzeit nicht konfigurierbar.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Meldung, die angezeigt werden soll.
    Tabelle : 6. Ergebnisse
    Typ Beschreibung
    void 
    g_form.addErrorMessage('This is an error');

    GlideForm - addFormMessage (Zeichenfolgennachricht, Zeichenfolgentyp, Objektoptionen)

    Zeigt eine unverankerte Formularnachricht oben im Formulardetailabschnitt an. Die Nachricht deckt keine UI-Aktionen ab.

    Siehe auch:
    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Meldung, die angezeigt werden soll.
    Typ Zeichenfolge Der Typ der Nachricht.
    Gültige Werte:
    • Fehler
    • Info
    • Warnung
    Optionen Objekt Optional. Objekt, das Schaltflächen zum Hinzufügen der Formularnachricht und alle Metadaten enthält, 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.Aktionsname Zeichenfolge Von den Ereignishandlern FORM_MESSAGE_BUTTON_CLICKED verwendeter Name, um zu bestimmen, auf welche Schaltfläche geklickt wurde.

    Wenn Sie beispielsweise eine Schaltfläche mit dem Aktionsnamen assigned_to_me hinzufügen, müssen Sie in UIB einen Ereignishandler für das Ereignis FORM_MESSAGE_BUTTON_CLICKED erstellen, der nur ausgeführt wird, wenn der Aktionsname assigned_to_meist.
    options.meta Objekt Zuordnung aller Metadaten, die zur Verarbeitung des Klicks auf die Schaltfläche erforderlich sind, formatiert als Schlüssel-Wert-Paare. 
    meta: {
  'key': 'value'
}

    Beispiel: Für die Schaltfläche Mir zuweisen benötigt der Ereignishandler die sys_id des Benutzers, dem der Datensatz zugewiesen werden soll.
    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Formularnachrichten der einzelnen Typen 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(String message)

    Fügt die angegebene Informationsnachricht am oberen Rand des Formulars hinzu.

    Diese Meldung wird etwa vier Sekunden lang angezeigt und dann ausgeblendet. Diese Zeitüberschreitung ist derzeit nicht konfigurierbar.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Meldung, die angezeigt werden soll.
    Tabelle : 10. Ergebnisse
    Typ Beschreibung
    void 
    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 Name des Felds.
    choiceValue Zeichenfolge In der Datenbank zu speichernde Wert.
    choiceLabel Zeichenfolge Angezeigter Wert.
    Tabelle : 12. Ergebnisse
    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 Serviceportalnicht unterstützt. Beispielsweise werden Elemente mit einem Bezeichnungstext, der einer anderen Bezeichnung entspricht, ignoriert und nicht zur Liste hinzugefügt.
    Tabelle : 13. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Der Feldname.
    choiceValue Zeichenfolge In der Datenbank gespeicherter Wert.
    choiceLabel Zeichenfolge Angezeigter Wert.
    choiceIndex Zahl Reihenfolge der Auswahl in der Liste. Der Index befindet sich in einem nullbasierten Array.
    Tabelle : 14. Ergebnisse
    Typ Beschreibung
    void 
    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 g_form.addInfoMessage() und g_form.addErrorMessage() hinzugefügt wurden.

    Tabelle : 15. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 16. Ergebnisse
    Typ Beschreibung
    void 
    g_form.clearMessages();

    GlideForm – cleanAllFormMessages()

    Entfernt alle Formularnachrichten jeden Typs.

    Siehe auch:
    Tabelle : 17. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 18. Ergebnisse
    Typ Beschreibung
    Keine

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

    g_form.clearAllFormMessages();

    GlideForm - cleanFormMessages(String type)

    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. Ausgabe
    Typ Beschreibung
    Keine

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

    g_form.clearFormMessages('error');

    GlideForm – clearOptions(String fieldName)

    Entfernt alle Optionen aus der Auswahlliste.

    Tabelle : 21. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    Tabelle : 22. Ergebnisse
    Typ Beschreibung
    void

    GlideForm – clearValue(String fieldName)

    Entfernt alle Werte aus dem Feld.

    Tabelle : 23. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    Tabelle : 24. Ergebnisse
    Typ Beschreibung
    void

    GlideForm – disableAttachments()

    Verhindert das Hinzufügen von Dateianhängen.

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

    Tabelle : 25. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 26. Ergebnisse
    Typ Beschreibung
    void

    GlideForm – enableAttachments()

    Ermöglicht das Hinzufügen von Dateianhängen. 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 : 27. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 28. Ergebnisse
    Typ Beschreibung
    void

    GlideForm - Flash (Zeichenfolge fieldName, Zeichenfolgenfarbe, Nummernanzahl)

    Wird verwendet, um auf ein bestimmtes Feld aufmerksam zu machen. Zeigt die angegebene Farbe für eine angegebene Zeitdauer im angegebenen Feld an.

    Diese Methode wird nicht vom Servicekatalog unterstützt.

    Diese Methode ist nicht auf der mobilen Plattform 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 Feld an, das im folgenden Format hervorgehoben werden soll: "<table-name> .<field-name> “ .
    Farbe Zeichenfolge RGB-Farbe oder akzeptable CSS-Farbe.
    count Zahl Gibt an, wie lange die Bezeichnung blinken soll. Verfügbare Optionen:
    • 2: Blinkt 1 Sekunde lang
    • 0: Blinkt 2 Sekunden lang
    • -2: Blinkt 3 Sekunden lang
    • -4: Blinkt 4 Sekunden lang
    Tabelle : 30. Ergebnisse
    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 : 31. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 32. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Aktueller Aktionsname. 
    function onSubmit() {
   var action = g_form.getActionName();
   alert('You pressed ' + action);
}

    GlideForm – getBooleanValue(String fieldName)

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

    Tabelle : 33. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    Tabelle : 34. Ergebnisse
    Typ Beschreibung
    Boolean Gibt „false“zurück, wenn der Feldwert „false“ oder „undefined“ ist. Ansonsten wird „true“ 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 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 Service Portal-Skripts nicht verfügbar.

    Tabelle : 35. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    Tabelle : 36. Ergebnisse
    Typ Beschreibung
    HTMLElement HTML-Element des Felds.

    GlideForm – getDecimalValue(String fieldName)

    Gibt den Dezimalwert des angegebenen Felds zurück.

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

    GlideForm - getDisplayBox(String fieldName)

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

    Hinweis:
    Um einen Anzeigewert aus einem Formular in Serviceportalabzurufen, verwenden Sie die Methode getDisplayValue().
    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. Ergebnisse
    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 Serviceportalab.

    Hinweis:
    Um einen Anzeigewert aus einem Formular in der Core-UI abzurufen, verwenden Sie die Methode getDisplayBox().
    Siehe auch:
    Hinweis:
    Wenn Sie diese Methode in der Core-UI als g_form.getDisplayValue() ohne Argument aufrufen, 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. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Sie den Anzeigewert einer Referenzvariablen in der Core-UI oder Serviceportalabrufen. 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 Service Portal-Skripts nicht verfügbar.

    Tabelle : 43. Parameter
    Name Typ Beschreibung
    id Zeichenfolge Feld-ID
    Tabelle : 44. Ergebnisse
    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 Service Portal-Skripts nicht verfügbar.

    Tabelle : 45. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 46. 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 : 47. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    Tabelle : 48. Ergebnisse
    Typ Beschreibung
    HTMLElement HTML-Element des Hilfetextfeldes.

    GlideForm – getIntValue(String fieldName)

    Gibt den ganzzahligen Wert des Felds zurück.

    Tabelle : 49. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Der Feldname.
    Tabelle : 50. Ergebnisse
    Typ Beschreibung
    Zahl Ganzzahliger Wert des Felds.

    GlideForm – getLabelOf(String fieldName)

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

    Tabelle : 51. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Feldname
    Tabelle : 52. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Beschriftungstext. 
    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 Optionelement für ein ausgewähltes Feld mit dem Namen fieldName zurück, wobei choiceValue mit dem Optionswert übereinstimmt.

    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. 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 Sie die Bezeichnung für einen Auswahllistenwert abrufen.

    // 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(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 des 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 scheinbar hängen bleibt), 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, der zusätzliche Zeit erfordert und zu Latenz auf Ihrer Seite führen kann. Verwenden Sie diese Methode mit Vorsicht. Weitere Informationen finden Sie unter Clientskript-Design und -Verarbeitung.
    Tabelle : 55. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    callBack Funktion Name der Rückruffunktion.
    Tabelle : 56. Ergebnisse
    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, bei dem 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. Ergebnisse
    Typ Beschreibung
    Array Zeichenfolgenarray von zugehörigen Listennamen aus dem aktuellen Formular. Die Namen der zugehörigen Listen werden in der Reihenfolge aufgelistet, 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 : 59. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 60. 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 : 61. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 62. 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 : 63. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 64. 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 : 65. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 66. 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 zu erhalten, müssen Sie zuerst JSON.parse(getValue(') verwenden.<mrvs_field_name> ') || „[]“) , um das MRVS-Array abzurufen, und verwenden Sie dann die Indizierung, um auf die Felder innerhalb der Zeilenobjekte zuzugreifen. Weitere Informationen finden Sie im Codebeispiel unten.

    Tabelle : 67. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds, dessen Wert zurückgegeben werden soll
    Tabelle : 68. Ergebnisse
    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 von einem MRVS abgerufen werden. In diesem Beispiel werden Löhne über den Servicekatalog verwaltet. Das Client-Skript durchsucht alle Zeilen im MRVS nach dem in der Stellenbezeichnung eingegebenen Wert und aktualisiert dann die übereinstimmenden Einträge im MRVS mit dem Wert im Feld Gehalt. Das MRVS trägt 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 [salary].

    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 : 69. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 70. Ergebnisse
    Typ Beschreibung
    void

    GlideForm – hideAllFieldMsgs(String type)

    Blendet alle Feldmeldungen des angegebenen Typs aus.

    Tabelle : 71. Parameter
    Name Typ Beschreibung
    Typ Zeichenfolge Der Typ der Nachricht.
    Gültige Werte:
    • Fehler
    • Info
    Tabelle : 72. Ergebnisse
    Typ Beschreibung
    void

    GlideForm – hideErrorBox(String fieldName)

    Blendet die Fehlermeldung aus, die durch ShowErrorBox() platziert wird.

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

    Tabelle : 73. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds oder des Steuerelements.
    Tabelle : 74. Ergebnisse
    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 die Methoden GlideForm – showFieldMsg(String field, String message, String type) oder GlideForm – showFieldMsg(String field, String message, String type, Boolean scrollForm), um Nachrichten in einem Formular anzuzeigen.

    Das folgende Code-Fragment zeigt beispielsweise, wie zwei Nachrichten im Feld „work_notes“ eines Formulars angezeigt und dann die erste Nachricht ausgeblendet werden: 
    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.
    clearAll Boolean Optional. Kennzeichnung, die angibt, ob alle Nachrichten für das angegebene Feld ausgeblendet werden sollen.
    Gültige Werte:
    • true: Alle Nachrichten ausblenden.
    • false: Blendet nur die erste angezeigte Nachricht aus.

    Standardwert: false
    Tabelle : 76. Ergebnisse
    Typ Beschreibung
    void

    Das folgende Beispiel zeigt, wie Sie alle Nachrichten für ein angegebenes Formularfeld löschen und dann eine Verschlüsselungsfehlermeldung anzeigen.

    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 – hideFieldMsg(String fieldName, Boolean clearAll)

    Blendet die Meldungen aus, die von showFieldMsg() platziert wurden.

    Tabelle : 77. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    clearAll Boolean Bei „true“ werden alle Meldungen für das Feld gelöscht. Bei „false“ wird nur die letzte Meldung entfernt.
    Tabelle : 78. Ergebnisse
    Typ Beschreibung
    void 
    g_form.hideFieldMsg('impact', true);

    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 : 79. Parameter
    Name Typ Beschreibung
    listTableName Zeichenfolge Name der zugehörigen Liste. Verwenden Sie die sys_id, um eine Liste durch eine Beziehung auszublenden.
    Tabelle : 80. Ergebnisse
    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 : 81. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 82. Ergebnisse
    Typ Beschreibung
    void

    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, auf denen Core-UI mit aktivierten Live-Formularen verwendet wird.

    Tabelle : 83. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 84. 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 : 85. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    Tabelle : 86. Ergebnisse
    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 : 87. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 88. 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 : 89. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 90. Ergebnisse
    Typ Beschreibung
    Boolean Gibt „true“ zurück, wenn der Abschnitt sichtbar ist. Andernfalls wird „false“ zurückgegeben.

    GlideForm – onUserChangeValue(Function 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 ersten Registrierung des Listeners übergeben wird. Dieser Listener wird nur ausgelöst, wenn ein Anwender eine Änderung an einem Feld im Formular vornimmt. Änderungen an Client-Skripts, UI-Richtlinien oder anderen Interaktionen ohne Benutzer lösen den Listener nicht aus.

    Hinweis:
    Diese Methode funktioniert nicht für Journalfelder oder Servicekatalog -Elemente 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
    • aktualisierter Feldwert
    Tabelle : 92. Ergebnisse
    Typ Beschreibung
    Funktion Funktion, die aufgerufen werden soll, um die Registrierung des Ereignis-Listeners „onUserChangeValue“ 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 : 93. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Slushbucket.
    Tabelle : 94. Ergebnisse
    Typ Beschreibung
    void 
    g_form.refreshSlushbucket('bucket');

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

    Entfernt das Symbol aus dem angegebenen Feld, das mit dem Symbol und dem Titel übereinstimmt.

    Hinweis:
    Diese Methode wird nicht vom Servicekatalog unterstützt.
    Tabelle : 95. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Feldname.
    icon Zeichenfolge Name des zu entfernenden Symbols.
    title Zeichenfolge Titel des Symbols (Name).
    Tabelle : 96. Ergebnisse
    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 Symbol, dem Titel und der Farbe entspricht.

    Hinweis:
    Diese Methode wird nicht vom Servicekatalog unterstützt.
    Tabelle : 97. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Feldname.
    icon Zeichenfolge Name des zu entfernenden Symbols.
    title Zeichenfolge Titel des Symbols (Name).
    color Zeichenfolge CSS-Farbe
    Tabelle : 98. Ergebnisse
    Typ Beschreibung
    void 
    g_form.removeDecoration('caller_id', 'icon-star', 'VIP', 'blue');

    GlideForm – removeOption(String fieldName, String choiceValue)

    Entfernt die angegebene Option aus der Auswahlliste.

    Tabelle : 99. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    choiceValue Zeichenfolge In der Datenbank gespeicherter Wert. Dies ist nicht die Bezeichnung.
    Tabelle : 100. Ergebnisse
    Typ Beschreibung
    void 
    g_form.removeOption('priority', '1');

    GlideForm – save()

    Speichert den Datensatz ohne Wegzunavigieren (aktualisieren und bleiben).

    Tabelle : 101. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 102. Ergebnisse
    Typ Beschreibung
    void

    GlideForm – setMandatory(String fieldName, Boolean mandatory)

    Definiert das angegebene Feld als Pflichtfeld.

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

    Tabelle : 103. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    mandatory Boolean Bei „true“ ist das Feld eine Pflichtfeld. Bei „false“ ist das Feld optional.
    Tabelle : 104. Ergebnisse
    Typ Beschreibung
    void

    GlideForm – setSectionDisplay(String sectionName, Boolean display)

    Zeigt einen Abschnitt an oder blendet ihn aus.

    Tabelle : 105. Parameter
    Name Typ Beschreibung
    sectionName Zeichenfolge Der Abschnittsname weist Kleinbuchstaben mit einem Unterstrich auf, was das erste Leerzeichen im Namen ersetzt. Wenn die verbleibenden Leerzeichen entfernt werden, wird „Section Four is Here“ beispielsweise zu „section_fourishere“. Andere nicht alphanumerische Zeichen, wie das kaufmännische Und-Zeichen (&), werden entfernt. Abschnittsnamen suchen Sie mit der getSectionNames()-Methode.
    display Boolean Bei „true“ wird der Abschnitt angezeigt. Bei „false“ wird der Abschnitt ausgeblendet.
    Tabelle : 106. Ergebnisse
    Typ Beschreibung
    Boolean Gibt bei Erfolg „true“ zurück.

    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, value). Wenn Sie mehrere Referenzwerte für ein Listen-Sammlungsfeld festlegen, übergeben Sie Arrays in den Parametern value und displayValue.

    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 : 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 aller im Array angegebenen Datensätze durch, und diese Werte werden verwendet, um den Inhalt des angegebenen Felds (zugehörige Liste) zu aktualisieren.

    Hinweis:
    Achten Sie beim Definieren eines Werts in einer Auswahlliste darauf, anstelle der Bezeichnung einen Zahlenwert zu verwenden.
    displayValue Zeichenfolge oder Array Feld innerhalb des angegebenen Referenzdatensatzes, das zum Aktualisieren des angegebenen Felds verwendet wird. In der Tabelle „Benutzer“ [sys_user] könnte dies beispielsweise „userName“ sein.

    Wenn das angegebene Feld eine GlideList ist, kann dieser Parameter ein Array von Anzeigewertnamen enthalten.

    Weitere Informationen zu Anzeigewerten finden Sie unter Anzeigewert.
    Tabelle : 108. Ergebnisse
    Typ Beschreibung
    void

    In diesem Beispiel wird die sys_id des Referenzdatensatzes übergeben, der das Feld userName enthält, das zum Aktualisieren des Formularfelds assigned_to verwendet werden soll.

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

    In diesem Beispiel wird ein Array von Referenzdatensatz-sys_ids und ein Array von entsprechenden Anzeigewertnamen übergeben, die zum Aktualisieren der Formularfelder in der GlideList glide-list_field_name verwendet werden.

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

    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 das Steuerelement oder Feld zurzeit nicht auf dem Bildschirm befindet und der Parameter scrollForm auf „true“ festgelegt wird, wird das Formular per Scrollen zum Steuerelement oder Feld bewegt.

    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 : 109. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name des Felds oder Steuerelements.
    message Zeichenfolge Meldung, die angezeigt werden soll.
    scrollForm Boolean Bei „true“ bewegt sich das Formular per Scrollen zum Feld. Bei „false“ bewegt sich das Formular nicht per Scrollen zum Feld.
    Tabelle : 110. Ergebnisse
    Typ Beschreibung
    void

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

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

    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 dem journal_field Typfeld in Core-UI.
    Tabelle : 111. Parameter
    Name Typ Beschreibung
    field Zeichenfolge Name des Felds oder Steuerelements.
    message Zeichenfolge Meldung, die angezeigt werden soll.
    Typ Zeichenfolge „error“,„info“ „warning“.
    Tabelle : 112. Ergebnisse
    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 Informations- oder Fehlermeldung unter dem angegebenen Formularfeld an (entweder ein Steuerelementobjekt oder der Name des Felds). Wenn sich das Steuerelement oder Feld zurzeit nicht auf dem Bildschirm befindet und der scrollForm auf „true“ festgelegt wird, wird das Formular per Scrollen zum Feld bewegt.

    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 dem journal_field Typfeld in Core-UI.
    Tabelle : 113. Parameter
    Name Typ Beschreibung
    field Zeichenfolge Name des Felds oder Steuerelements.
    message Zeichenfolge Meldung, die angezeigt werden soll.
    Typ Zeichenfolge „error“,„info“ „warning“.
    scrollForm Boolean Bei „true“ wird das Formular per Scrollen zum Feld bewegt, wenn es sich außerhalb des Bildschirms befindet. Bei „false“ wird das Formular nicht per Scrollen bewegt.
    Tabelle : 114. Ergebnisse
    Typ Beschreibung
    void 
    g_form.showFieldMsg('impact','Low impact not allowed with High priority','error',false);

    GlideForm – setDisabled(String fieldName, Boolean disable)

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

    Tabelle : 115. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    disable Boolean Bei „true“ wird das Feld deaktiviert. Bei „false“ wird das Feld aktiviert.
    Tabelle : 116. Ergebnisse
    Typ Beschreibung
    void

    GlideForm – setDisplay(String fieldName, Boolean display)

    Zeigt ein Feld an oder blendet es aus.

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

    Tabelle : 117. Parameter
    Name Typ Beschreibung
    fieldname Zeichenfolge Name des Felds.
    display Boolean Bei „true“ wird das Feld angezeigt, bei „false“ wird das Feld ausgeblendet.
    Tabelle : 118. Ergebnisse
    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 Feldbezeichnung fest.

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

    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 den Wert dieses Felds nicht mehr mit der Methode „setValue() “ aktualisieren. Wenn Sie den Wert auf diese Weise festlegen müssen, müssen Sie den Wert von „readOnly“ auf „falsch“ setzen.

    Tabelle : 121. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des Felds.
    readOnly Boolean Kennzeichnung, die bestimmt, ob das Zuordnungsfeld bearbeitbar oder schreibgeschützt ist.
    Mögliche Werte:
    • „wahr“: Feld als schreibgeschützt festlegen
    • „falsch“: Feld als bearbeitbar festlegen
    Tabelle : 122. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Sie den Variableneditor auf schreibgeschützt festlegen. Verwenden Sie dazu in Tabellen ServicekatalogsetVariablesReadOnly().

    // 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, String value)

    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 JSON.parse(getValue(') verwenden.<mrvs_field_name> ')) , um das MRVS-Array abzurufen und dann die Felder innerhalb der Zeilenobjekte mithilfe der Indizierung zu aktualisieren. Sobald alle Werte im MRVS aktualisiert wurden, verwenden Sie die Methode setValue(), um das aktualisierte MRVS-Array zu speichern. Weitere Informationen 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.
    Hinweis:
    Achten Sie beim Definieren eines Werts in einer Auswahlliste darauf, den Zahlenwert und nicht die Bezeichnung zu verwenden.
    Tabelle : 123. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Name des zu aktualisierenden Formularfelds.
    Wert Zeichenfolge Zeichenfolgenwert, der im angegebenen Feld festgelegt werden soll.
    Tabelle : 124. Ergebnisse
    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 Löhne über den Servicekatalog verwaltet. Das Client-Skript durchsucht alle Zeilen im MRVS nach dem in der Stellenbezeichnung eingegebenen Wert und aktualisiert dann die übereinstimmenden Einträge im MRVS mit dem Wert im Feld Gehalt. Das MRVS trägt 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 [salary].

    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(Boolean isReadOnly)

    Legt einen Servicekatalog -Variableneditor als schreibgeschützt fest.

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

    Die Methode muss im Client-Skript 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 die Methode setReadOnly().

    Siehe auch: Editoren für Servicekatalog-Variablen

    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.

    Standardwert: false
    Tabelle : 126. Ergebnisse
    Typ Beschreibung
    Keine

    Wenn Sie einem Client-Skript die folgende Zeile hinzufügen, wird der Variableneditor schreibgeschützt.

    g_form.setVariablesReadOnly(true);

    GlideForm – setVisible(String fieldName, Boolean display)

    Zeigt das Feld an oder blendet es aus.

    Auf der Desktop-UI bleibt der Bereich leer, wenn er ausgeblendet wird. Auf der Mobile- oder Serviceportal-UI wird der Bereich in meinen anderen Feldern ausgefüllt, wenn er ausgeblendet ist. Diese Methode kann keine Pflichtfelder ohne Wert ausblenden.

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

    Tabelle : 127. Parameter
    Name Typ Beschreibung
    fieldName Zeichenfolge Der Feldname.
    display Boolean Bei „true“ wird das Feld angezeigt. Bei „false“ wird das Feld ausgeblendet.
    Tabelle : 128. Ergebnisse
    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 – 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 zurzeit nicht auf dem Bildschirm befindet, wird das Formular per Scrollen zum Steuerelement oder Feld bewegt.

    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 : 129. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name des Steuerelements oder Felds.
    message Zeichenfolge Anzuzeigende Meldung.
    Tabelle : 130. Ergebnisse
    Typ Beschreibung
    void

    GlideForm – showRelatedList(String listTableName)

    Zeigt die angegebene zugehörige Liste im Formular an.

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

    Tabelle : 131. Parameter
    Name Typ Beschreibung
    listTableName Zeichenfolge Name der zugehörigen Liste.
    Tabelle : 132. Ergebnisse
    Typ Beschreibung
    void

    GlideForm – showRelatedLists()

    Zeigt alle verknüpfte Listen des Formulars an.

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

    Tabelle : 133. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 134. Ergebnisse
    Typ Beschreibung
    void

    GlideForm – submit()

    Speichert den Datensatz.

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

    Tabelle : 135. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 136. Ergebnisse
    Typ Beschreibung
    void

    GlideForm – submit(String verb)

    Führt die durch den Parameter angegebene UI Action aus.

    Tabelle : 137. 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 : 138. Ergebnisse
    Typ Beschreibung
    void