GlideForm – Client

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 ungefähr 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(String message, String type, Object options)

Zeigt eine schwebende Formularnachricht oben im Formulardetailabschnitt an. Die Nachricht umfasst keine UI-Aktionen.

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 mit Schaltflächen zum Hinzufügen zur Formularnachricht und allen Metadaten, die für die Verarbeitung eines Schaltflächenklicks erforderlich sind. `{ buttons: [Array], meta: {Object} }`
options.buttons	Array	Array von Schaltflächen, die der Formularnachricht hinzugefügt werden sollen. `buttons: [ { label: "String", actionName: "String" } ]`
options.buttons.label	Zeichenfolge	Text, der auf der Schaltfläche angezeigt werden soll.
options.buttons.actionName	Zeichenfolge	Name, der von FORM_MESSAGE_BUTTON_CLICKED-Ereignishandlern verwendet wird, um die angeklickte Schaltfläche zu bestimmen. Wenn Sie beispielsweise eine Schaltfläche mit dem Aktionsnamen `„assign_to_me`“ hinzufügen, müssen Sie einen Event-Handler in UIB für das Event FORM_MESSAGE_BUTTON_CLICKED erstellen, der nur ausgeführt wird, wenn der Aktionsname „ `assign_to_me`“ ist.
options.meta	Objekt	Zuordnung aller Metadaten, die für die Verarbeitung des Schaltflächenklicks erforderlich sind, formatiert als Schlüssel-Wert-Paare. `meta: { 'key': 'value' }` Zum Beispiel benötigt der Event-Handler für eine Schaltfläche „ Mir zuweisen“ 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 Anfang des Formulars hinzu.

Diese Meldung wird ungefähr 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. Zum Beispiel 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	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 – clearAllFormMessages()

Entfernt alle Formularnachrichten beliebigen 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 – clearFormMessages(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(String fieldName, String color, Number count)

Wird verwendet, um auf ein bestimmtes Feld aufmerksam zu machen. Blinkt in der angegebenen Farbe für eine im angegebenen Feld angegebene Dauer.

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 hervorzuhebende Feld im folgenden Format an: `"`<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 Kern-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 Kern-UI als g_form.getDisplayValue() ohne Argument aufrufen, wird der Anzeigewert des Datensatzes zurückgegeben und nicht der Anzeigewert eines einzelnen Felds.

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 der Anzeigewert einer Referenzvariablen in der Kern-UI oder Serviceportalabgerufen wird. 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 Optionselement für ein ausgewähltes Feld mit dem Namen fieldName zurück, wobei choiceValue dem Optionswert entspricht.

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 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(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 Browserverarbeitung (und Skriptverarbeitung) 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 angehalten (wodurch der Browser scheinbar hängt), 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 beim Server, der zusätzliche Zeit erfordert und die Latenz Ihrer Seite erhöhen kann. Verwenden Sie diese Methode mit Vorsicht. Weitere Informationen finden Sie unter Client-Skript-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, 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 mit Namen zugehöriger Listen aus dem aktuellen Formular zurück.

Tabelle : 57. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 58. Ergebnisse
Typ	Beschreibung
Array	Zeichenfolgen-Array der Namen zugehöriger Listen 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 in den Zeilenobjekten zuzugreifen. Weitere Informationen finden Sie im folgenden Codebeispiel.

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 die 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, was im Feld Gehalt eingegeben wurde. Das MRVS heißt „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)

Blendet die letzte Meldung ein, die von showFieldMsg() platziert wurde.

Tabelle : 75. Parameter
Name	Typ	Beschreibung
fieldName	Zeichenfolge	Name des Felds.

Tabelle : 76. Ergebnisse
Typ	Beschreibung
void

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, die Core-UI mit aktivierten Live-Formularen verwenden.

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 benutzerdefinierten Event-Listener, der erkennt, wenn ein Feld im aktuellen Formular von einem Benutzer geändert wird.

Wenn ein Formularfeld geändert wird, ruft der Event-Listener die Funktion auf, die bei der ersten Registrierung des Listeners übergeben wurde. Dieser Listener wird nur ausgelöst, wenn ein Benutzer ein Feld im Formular ändert. Änderungen an Client-Skripts, UI-Richtlinien oder anderen Nicht-Benutzerinteraktionen 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 wird, wenn ein Benutzer 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 onUserChangeValue-Event-Listeners aufzuheben.

Beispiel

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 Sie beim Festlegen des Werts für ein Referenzfeld einen Round Trip verhindern, verwenden Sie diese Methode und nicht setValue(fieldName, value). Wenn Sie mehrere Referenzwerte für ein Listensammlerfeld 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 in allen im Array angegebenen Datensätzen 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 werden soll. In der Benutzertabelle [sys_user] kann 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

Dieses Beispiel zeigt die Übergabe der sys_id des Referenzdatensatzes, der das Feld userName enthält, das zum Aktualisieren des Formularfelds assigned_to verwendet werden soll.

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

Dieses Beispiel zeigt die Übergabe eines Arrays von Referenzdatensatz-sys_ids und eines Arrays entsprechender Anzeigewertnamen, die zum Aktualisieren der Formularfelder in der GlideList glide-list_field_name verwendet werden sollen.

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 readOnly auf false festlegen.

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: true: Feld als schreibgeschützt festlegen false: Feld als bearbeitbar festlegen

Tabelle : 122. Ergebnisse
Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie den Variableneditor als 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 Indizierung zu verwenden, um die Felder in den Zeilenobjekten zu aktualisieren. Sobald alle Werte im MRVS aktualisiert wurden, speichern Sie das aktualisierte MRVS-Array mit der Methode setValue(). Weitere Informationen finden Sie im folgenden Codebeispiel.

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 anstelle der 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 die 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, was im Feld Gehalt eingegeben wurde. Das MRVS heißt „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)

Macht einen Servicekatalog -Variableneditor schreibgeschützt.

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: Variableneditoren für Servicekatalog

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

Tabelle : 126. Ergebnisse
Typ	Beschreibung
Keine

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

g_form.setVariablesReadOnly(true);

GlideForm – setVisible(String fieldName, Boolean display)

Zeigt das Feld an oder blendet es aus.

In der Desktop-UI bleibt der Bereich leer, wenn er ausgeblendet wird. In Mobile oder Service Portal UI wird der Platz in meinen anderen Feldern ausgefüllt, wenn er ausgeblendet wird. 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