GlideSystem – Umfang

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 29 Minuten Lesedauer

    • Der Umfang ist festgelegt GlideSystem Die API bietet eine Reihe praktischer Methoden, um Informationen über das System, den aktuell angemeldeten Anwender und andere Informationen auf Systemebene zu erhalten.

    Viele von GlideSystem Methoden erleichtern die einfache Aufnahme von Daten in Abfragebereiche und werden am häufigsten in Filtern und Berichten verwendet.

    Bereichsbezogenes GlideSystem – addErrorMessage(Zeichenfolgennachricht)

    Fügt eine Fehlermeldung für die aktuelle Sitzung hinzu.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Hinzuzufügende Nachricht.
    Tabelle : 2. Rückgaben
    Typ Beschreibung
    void 
    gs.include("PrototypeServer");
  var ValidatePasswordStronger = Class.create();
  ValidatePasswordStronger.prototype = {
       process : function() {
          var user_password = request.getParameter("user_password");
          var min_len = 8;
          var rules = "Password must be at least " + min_len + 
             " characters long and contain a digit, an uppercase letter, and a lowercase letter.";
          if (user_password.length() < min_len) {
             gs.addErrorMessage("TOO SHORT: " + rules);
             return false;
          }
          var digit_pattern = new RegExp("[0-9]", "g");
          if (!digit_pattern.test(user_password)) {
             gs.addErrorMessage("DIGIT MISSING: " + rules);
             return false;
          }
          var upper_pattern = new RegExp("[A-Z]", "g");
          if (!upper_pattern.test(user_password)) {
             gs.addErrorMessage("UPPERCASE MISSING: " + rules);
             return false;
          }
          var lower_pattern = new RegExp("[a-z]", "g");
          if (!lower_pattern.test(user_password)) {
             gs.addErrorMessage("LOWERCASE MISSING: " + rules);
             return false;
          }
          return true; // password is OK
       }
  }

    Bereichsbezogenes GlideSystem – addHighMessage(Zeichenfolgennachricht)

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

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Anzuzeigende Nachricht mit hoher Priorität.
    Tabelle : 4. Rückgaben
    Typ Beschreibung
    void

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

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

    Bereichsbezogenes GlideSystem – addInfoMessage(Zeichenfolgennachricht)

    Fügt eine Informationsmeldung für die aktuelle Sitzung hinzu. Diese Methode wird für asynchrone Business Rules nicht unterstützt.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Hinzuzufügende Infonachricht.
    Tabelle : 6. Rückgaben
    Typ Beschreibung
    void 
    if ((!current.u_date1.nil()) && (!current.u_date2.nil())) {
  var start = current.u_date1.getGlideObject().getNumericValue();
  var end = current.u_date2.getGlideObject().getNumericValue();
  if (start > end) {
    gs.addInfoMessage('start must be before end');
    current.u_date1.setError('start must be before end');
    current.setAbortAction(true);
  }
}

    Bereichsbezogenes GlideSystem – addLowMessage(Zeichenfolgennachricht)

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

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Anzuzeigende Nachricht mit niedriger Priorität.
    Tabelle : 8. Rückgaben
    Typ Beschreibung
    void

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

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

    Bereichsbezogenes GlideSystem – addModerateMessage(Zeichenfolgennachricht)

    Zeigt oben im Formular eine Meldung mit mittlerer Priorität an.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Meldung „Mittel“, die angezeigt werden soll.
    Tabelle : 10. Rückgaben
    Typ Beschreibung
    Keine

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

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

    Bereichsbezogenes GlideSystem – addSuccessMessage (Zeichenfolgennachricht)

    Zeigt oben im Formular eine Nachricht an, die eine erfolgreiche Aktion bestätigt.

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Anzuzeigende Erfolgsmeldung.
    Tabelle : 12. Rückgaben
    Typ Beschreibung
    void

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

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

    Scoped GlideSystem – base64Encode(String source)

    Erstellt eine base64-Zeichenfolge aus der angegebenen Zeichenfolge.

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    Quelle Zeichenfolge Zu codierende Zeichenfolge.
    Tabelle : 14. Rückgaben
    Typ Beschreibung
    Zeichenfolge Codierte base64-Zeichenfolge.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var mac = new CertificateEncryption;
var key = "sample_key"; 
key = gs.base64Encode(key);
mac.generateMac(key, "HmacSHA256", "sample_data");

    Scoped GlideSystem – base64Decode(String source)

    Gibt eine ASCII-Zeichenfolge aus der angegebenen base64-Zeichenfolge zurück.

    Tabelle : 15. Parameter
    Name Typ Beschreibung
    Quelle Zeichenfolge base64-codierte Zeichenfolge.
    Tabelle : 16. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Decodierte Zeichenfolge.

    Scoped GlideSystem – beginningOfLastMonth()

    Gibt das Datum und die Uhrzeit für den Beginn des letzten Monats in GMT zurück.

    Tabelle : 17. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 18. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT-Beginn des letzten Monats im Format jjjj-mm-tt hh:mm:ss.

    Scoped GlideSystem – beginningOfLastWeek()

    Gibt das Datum und die Uhrzeit für den Beginn der letzten Woche in GMT zurück.

    Tabelle : 19. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 20. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT-Beginn der letzten Woche, im Format jjjj-mm-tt hh:mm:ss

    Scoped GlideSystem – beginningOfNextMonth()

    Gibt das Datum und die Uhrzeit für den Beginn des nächsten Monats in GMT zurück.

    Tabelle : 21. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 22. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT-Beginn des nächsten Monats, im Format jjjj-mm-tt hh:mm:ss

    Scoped GlideSystem – beginningOfNextWeek()

    Gibt das Datum und die Uhrzeit für den Beginn der nächsten Woche in GMT zurück.

    Tabelle : 23. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 24. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT-Beginn der nächsten Woche, im Format jjjj-mm-tt hh:mm:ss.

    Scoped GlideSystem – beginningOfNextYear()

    Gibt das Datum und die Uhrzeit für den Beginn des nächsten Jahres in GMT zurück.

    Tabelle : 25. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 26. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT-Beginn des nächsten Jahres, im Format jjjj-mm-tt hh:mm:ss

    Scoped GlideSystem – beginningOfThisMonth()

    Gibt das Datum und die Uhrzeit für den Beginn dieses Monats in GMT zurück.

    Tabelle : 27. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 28. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT-Beginn dieses Monats, im Format jjjj-mm-tt hh:mm:ss

    Scoped GlideSystem – beginningOfThisQuarter()

    Gibt das Datum und die Uhrzeit für den Beginn dieses Quartals in GMT zurück.

    Tabelle : 29. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 30. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT-Beginn dieses Quartals, im Format jjjj-mm-tt hh:mm:ss

    Scoped GlideSystem – beginningOfThisWeek()

    Gibt das Datum und die Uhrzeit für den Beginn dieser Woche in GMT zurück.

    Tabelle : 31. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 32. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT-Beginn dieser Woche, im Format jjjj-mm-tt hh:mm:ss

    Scoped GlideSystem – beginningOfThisYear()

    Gibt das Datum und die Uhrzeit für den Beginn dieses Jahres in GMT zurück.

    Tabelle : 33. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 34. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT-Beginn dieses Jahres, im Format jjjj-mm-tt hh:mm:ss

    Scoped GlideSystem – dateGenerate(String date, String range)

    Generiert Datum und Uhrzeit für das angegebene Datum in GMT.

    Tabelle : 35. Parameter
    Name Typ Beschreibung
    date Zeichenfolge Datum, für das die GMT generiert werden soll.

    Format: jjjj-mm-tt
    range Zeichenfolge Start, Ende oder Uhrzeit im 24-Stunden-Format hh:mm:ss.
    Tabelle : 36. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Datum und Uhrzeit der Generierung.

    Wenn der Bereich ist Starten , Der zurückgegebene Wert ist jjjj-mm-tt 00:00:00.

    Wenn Bereich ist Ende Der Rückgabewert ist jjjj-mm-tt 23:59:59.

    Format: jjjj-mm-TT hh:mm:ss

    Dieses Beispiel zeigt mit DatumGenerate() Zum Festlegen des Startdatums beim Abfragen von Datensätzen in der Incident-Tabelle.

    var tableData = new GlideRecord('incident');
tableData.addEncodedQuery("sys_created_onBETWEENjavascript:gs.dateGenerate('2015-10-07','00:00:00')@javascript:gs.daysAgoEnd(0)^priority=1^severityIN1,2");
tableData.query();
gs.info("Count: " + tableData.getRowCount());

    Ausgabe

    Count: 7

    Scoped GlideSystem – daysAgo(Number days)

    Gibt das Datum und die Uhrzeit für eine bestimmte Anzahl von zurückliegenden Tagen zurück.

    Tabelle : 37. Parameter
    Name Typ Beschreibung
    days Zahl Ganzzahl von Tagen
    Tabelle : 38. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT im Format jjjj-mm-tt hh:mm:ss 
    function contractNoticeDue() {
    var now_GR = new GlideRecord("contract");
    now_GR.addQuery("u_contract_status", "Active");
    now_GR.query();
    while (now_GR.next()) {
    if ((now_GR.u_termination_date <= gs.daysAgo(-90)) && (now_GR.u_contract_duration == "Long")) {
            now_GR.u_contract_status = "In review";
        } 
        else if ((now_GR.u_termination_date <= gs.daysAgo(-50)) && (now_GR.u_contract_duration == "Medium")) {
        now_GR.u_contract_status = "In review";
        } 
        else if ((now_GR.u_termination_date <= gs.daysAgo(-10)) && (now_GR.u_contract_duration == "Short")) {
            now_GR.u_contract_status = "In review";
        }
    }
    now_GR.update();
}

    Scoped GlideSystem – daysAgoEnd(Number days)

    Gibt das Datum und die Uhrzeit für das Ende des Tages vor einer angegebenen Anzahl von Tagen zurück.

    Tabelle : 39. Parameter
    Name Typ Beschreibung
    days Zahl Ganzzahl von Tagen
    Tabelle : 40. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT-Ende des Tages im Format jjjj-mm-tt hh:mm:ss

    Scoped GlideSystem – daysAgoStart(Number days)

    Gibt das Datum und die Uhrzeit für den Beginn des Tages vor einer angegebenen Anzahl von Tagen zurück.

    Tabelle : 41. Parameter
    Name Typ Beschreibung
    days Zeichenfolge Ganzzahl von Tagen
    Tabelle : 42. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT-Start des Tages im Format jjjj-mm-tt hh:mm:ss 
    var now_GR = new GlideRecord('sysapproval_approver');
now_GR.addQuery('state', 'requested');
now_GR.addQuery('sys_updated_on', '<', gs.daysAgoStart(5));
now_GR.query();

    Scoped GlideSystem – debug(String message, Object parm1, Object parm2, Object parm3, Object parm4, Object parm5)

    Schreibt eine Debug-Meldung in das Systemprotokoll.

    Tabelle : 43. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Protokollmeldung mit Platzhaltern für beliebige variable Argumente.
    param1 Objekt (Optional) Erstes Variablenargument.
    param2 Objekt (Optional) Zweites Variablenargument.
    param3 Objekt (Optional) Drittes Variablenargument.
    param4 Objekt (Optional) Viertes Variablenargument.
    param5 Objekt (Optional) Fünftes Variablenargument.
    Tabelle : 44. Ergebnisse
    Typ Beschreibung
    void 
    gs.debug("This is a debug message");
var myFirstName = "Abel";
var myLastName = "Tuter";
gs.debug("This is a debug message from {0}.{1}", myFirstName, myLastName);
    Ausgabe:
    This is a debug message (sys.scripts extended logging)
This is a debug message from Abel.Tuter (sys.scripts extended logging)

    Scoped GlideSystem – endOfLastMonth()

    Gibt das Datum und die Uhrzeit für das Ende des letzten Monats in GMT zurück.

    Tabelle : 45. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 46. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT-Ende des letzten Monats im Format jjjj-mm-tt hh:mm:ss

    Scoped GlideSystem – endOfLastWeek()

    Gibt das Datum und die Uhrzeit für das Ende der letzten Woche in GMT zurück.

    Tabelle : 47. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 48. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT-Ende der letzten Woche, im Format jjjj-mm-tt hh:mm:ss.

    Scoped GlideSystem – endOfLastYear()

    Gibt das Datum und die Uhrzeit für das Ende des letzten Jahres in GMT zurück.

    Tabelle : 49. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 50. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT im Format jjjj-mm-tt hh:mm:ss

    Scoped GlideSystem – endOfNextMonth()

    Gibt das Datum und die Uhrzeit für das Ende des nächsten Monats in GMT zurück.

    Tabelle : 51. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 52. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT im Format jjjj-mm-tt hh:mm:ss

    Scoped GlideSystem – endOfNextWeek()

    Gibt das Datum und die Uhrzeit für das Ende der nächsten Woche in GMT zurück.

    Tabelle : 53. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 54. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT im Format jjjj-mm-tt hh:mm:ss

    Scoped GlideSystem – endOfNextYear()

    Gibt das Datum und die Uhrzeit für das Ende des nächsten Jahres in GMT zurück.

    Tabelle : 55. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 56. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT im Format jjjj-mm-tt hh:mm:ss

    Scoped GlideSystem – endOfThisMonth()

    Gibt das Datum und die Uhrzeit für das Ende dieses Monats in GMT zurück.

    Tabelle : 57. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 58. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT im Format jjjj-mm-tt hh:mm:ss

    Scoped GlideSystem – endOfThisQuarter()

    Gibt das Datum und die Uhrzeit für das Ende dieses Quartals in GMT zurück.

    Tabelle : 59. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 60. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT im Format jjjj-mm-tt hh:mm:ss

    Scoped GlideSystem – endOfThisWeek()

    Gibt das Datum und die Uhrzeit für das Ende dieser Woche in GMT zurück.

    Tabelle : 61. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 62. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT im Format jjjj-mm-tt hh:mm:ss

    Scoped GlideSystem – endOfThisYear()

    Gibt das Datum und die Uhrzeit für das Ende dieses Jahres in GMT zurück.

    Tabelle : 63. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 64. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT im Format jjjj-mm-tt hh:mm:ss

    Scoped GlideSystem – error(String message, Object parm1, Object parm2, Object parm3, Object parm4, Object parm5)

    Schreibt eine Fehlermeldung in das Systemprotokoll.

    Diese Methode akzeptiert bis zu fünf Variablenargumente (varargs) in der Nachricht unter Verwendung des Platzhalter-Ersetzungsmusters für Java MessageFormat.

    Hinweis:
    Variablen müssen gültige Werte für diese Methode enthalten, um die richtige Ausgabe bereitzustellen.
    Tabelle : 65. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Protokollmeldung mit Platzhaltern für beliebige variable Argumente.
    param1 Objekt (Optional) Erstes Variablenargument.
    param2 Objekt (Optional) Zweites Variablenargument.
    param3 Objekt (Optional) Drittes Variablenargument.
    param4 Objekt (Optional) Viertes Variablenargument.
    param5 Objekt (Optional) Fünftes Variablenargument.
    Tabelle : 66. Ergebnisse
    Typ Beschreibung
    void 
    gs.error("This is an error message");
var myFirstName = "Abel";
var myLastName = "Tuter";
gs.error("This is an error message from {0}.{1}", myFirstName, myLastName);
    Ausgabe:
    This is an error message
This is an error message from Abel.Tuter

    Scoped GlideSystem – eventQueue(String name, Object instance, String parm1, String parm2, String queue)

    Reiht ein Event für den Event-Manager in die Warteschlange ein.

    Tabelle : 67. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name des Events, das in die Warteschlange gestellt wird.
    instance Objekt GlideRecord-Objekt wie „current“.
    parm1 Zeichenfolge Optional. Mit der Instanz gespeichert, falls angegeben.
    parm2 Zeichenfolge Optional. Mit der Instanz gespeichert, falls angegeben.
    Warteschlange Zeichenfolge Optional. Name der Warteschlange.
    Tabelle : 68. Ergebnisse
    Typ Beschreibung
    void 
    if (current.operation() != 'insert' && current.comments.changes()) {
    gs.eventQueue('incident.commented', current, gs.getUserID(), gs.getUserName());
}

    Scoped GlideSystem – eventQueueScheduled(String name, Object instance, String parm1, String parm2, Object expiration)

    Stellt ein Ereignis im Ereignismanager in die Warteschlange.

    Die übergebenen Informationen zum Ereigniszeitplan werden in der Tabelle „Ereignisse“ [sysevent] gespeichert. Weitere Informationen zu Ereignissen finden Sie unter Ereignisse .

    Tabelle : 69. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name des Ereignisses, das in die Warteschlange gestellt werden soll.
    Instanz Objekt/Zeichenfolge GlideRecord-Objekt oder die sys_ID des Datensatzes, für den dieses Ereignis gilt.
    parm1 Zeichenfolge Optional. Zeichenfolge, die an das Ereignisskript übergeben werden soll. Dieser Parameter ist Freiform und hängt von der Implementierung des Ereignisskripts ab.

    Standard: Wenn instanceParameter ist ein GlideRecord-Objekt. Andernfalls ist der Anzeigewert für diesen GlideRecord (now_GR.getDisplayValue) standardmäßig Null .
    parm2 Zeichenfolge Optional. Zeichenfolge, die an das Ereignisskript übergeben werden soll. Dieser Parameter ist Freiform und hängt von der Implementierung des Ereignisskripts ab.

    Standard: Null

    expiration Objekt Optional. GlideDateTime-Objekt oder ein Datums-/Uhrzeitelement, das Datum und Uhrzeit für die Verarbeitung des Ereignisses angibt.

    Standard: Aktuelles Datum/aktuelle Uhrzeit
    Tabelle : 70. Rückgaben
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie die Methode mit einem GlideRecord, zwei Parametern, die an das Ereignisskript übergeben werden, und einer angegebenen Zeit für die Planung des Ereignisses aufgerufen wird.

    var requestXml = requestBody.dataString;
var processTime = new GlideDateTime();
processTime.addDaysLocalTime(7);
gs.eventQueueScheduled('sn_app.user.deactivate', now_GR, requestXML, gs.getUserID(), processTime);

    Dieses Beispiel zeigt, wie die Methode mit einer sys_ID und den Standardwerten für die optionalen Parameter aufgerufen wird.

    gs.eventQueueScheduled('event.test', '0e29421383101000dada83ec37d9292d', '', '', '');

    Scoped GlideSystem – executeNow(GlideRecord job)

    Führt einen Job für eine bereichsbezogene Anwendung aus.

    Sie können diese Methode nur für einen Job in derselben Anwendung verwenden wie das Skript, das diese Methode aufruft.

    Tabelle : 71. Parameter
    Name Typ Beschreibung
    job GlideRecord Auszuführender Auftrag.
    Tabelle : 72. Rückgaben
    Typ Beschreibung
    Zeichenfolge Gibt die sys_ID der geplanten Aufgabe zurück. Gibt null zurück, wenn der Job global ist. 
    scheduleImportJob: function () {
  var jobId = '61847fe04c603300fa9bb64c2b491dac';
  var now_GR = new GlideRecord('sysauto_script');
  if (!now_GR.get(jobId)) {
    throw new Error('Unable to find import job');
  }
  gs.executeNow(now_GR);
}

    Scoped GlideSystem – generateGUID()

    Erzeugt eine GUID, die verwendet werden kann, wenn ein eindeutiger Identifier erforderlich ist.

    Tabelle : 73. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 74. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Eine 32-stellige hexadezimale GUID.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    personalId = gs.generateGUID();
gs.info(personalId);

    Ausgabe:

    af770511ff013100e04bfffffffffff6

    Scoped GlideSystem – getCallerScopeName()

    Ruft den Namen des Anruferbereichs ab. Gibt null zurück, wenn kein Anrufer vorhanden ist.

    Tabelle : 75. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 76. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der Bereichsname des Anrufers oder null, wenn kein Anrufer vorhanden ist.

    Dieses Beispiel zeigt zwei Skripteinbindungen, die von allen Anwendungsbereichen aus auf „zugreifbar“ eingestellt sind. Eine Skripteinbindung wird in app_scope_a erstellt.

    var Scopea = Class.create(); 
 
Scopea.prototype = { 
    initialize: function() { 
    }, 
 
    callerScope: function() { 
        var scopeb = new app_scope_b.Scopeb(); 
        return scopeb.callerscope(); 
    }, 
 
    type: 'Scopea' 
}

    Ausgabe:

    Dieses Beispiel zeigt eine andere Skripteinbindung, die in App_scope_b erstellt wurde.

    var Scopeb = Class.create(); 
 
Scopeb.prototype = { 
    initialize: function() { 
        this._constructorCallerScope = gs.getCallerScopeName(); 
    }, 
 
    callerscope: function() { 
        return gs.getCallerScopeName(); 
    }, 
 
    getConstructorCallerScope: function() { 
        return this._constructorCallerScope; 
    }, 
 
    type: 'Scopeb' 
}

    Ausgabe:

    Dieses Skript kann innerhalb des Gültigkeitsbereichs app_scope_a verwendet werden, um den Bereichsnamen des Aufrufers abzurufen, in diesem Fall „app_scope_b“.

    gs.info(new Scopea().getCallerScopeName());

    Scoped GlideSystem – getCssCacheVersionString()

    Ruft eine Zeichenfolge ab, die die Cache-Version für eine CSS-Datei darstellt.

    Tabelle : 77. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 78. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Die CSS-Cache-Version.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var verStr = gs.getCssCacheVersionString();
gs.info(verStr);

    Ausgabe:

    _d82979516f0171005be8883e6b3ee4cf&theme=

    Scoped GlideSystem – getCurrentApplicationId()

    Ruft die ID der aktuellen Anwendung ab, die mit der Anwendungsauswahl festgelegt wurde.

    Tabelle : 79. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 80. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Die aktuelle sys_id der Anwendung oder „global“, wenn keine festgelegt ist. 
    var currentId = gs.getCurrentApplicationId();
gs.info(currentId);

    Ausgabe

    04936cb16f30b1005be8883e6b3ee4e0

    Scoped GlideSystem – getCurrentScopeName()

    Ruft den Namen des aktuellen Bereichs ab.

    Tabelle : 81. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 82. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der aktuelle Bereichsname.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var currentScope = gs.getCurrentScopeName();
gs.info(currentScope);

    Ausgabe:

    s_snc_test_scope

    Bereichsbezogenes GlideSystem – getDateFormat(Zeichenfolge)

    Gibt das Datumsformat zurück, das dem aktuellen Anwender zugeordnet ist.

    Tabelle : 83. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 84. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Das Datumsformat, das dem aktuellen Anwender zugeordnet ist.

    Das folgende Beispiel gibt das Datumsformat zurück, das dem Anwender zugeordnet ist.

    var userDateFormat = gs. getDateFormat();
gs.info(userDateFormat);

    Ausgabe:

    yyyy-MM-dd

    Bereichsbezogenes GlideSystem – getDateTimeFormat()

    Gibt das Datums- und Uhrzeitformat zurück, das dem aktuellen Anwender zugeordnet ist.

    Tabelle : 85. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 86. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Das Datums- und Uhrzeitformat, das dem aktuellen Anwender zugeordnet ist.

    Das folgende Beispiel gibt das Format des Datums und der Uhrzeit zurück, die dem Anwender zugeordnet sind.

    var userDateTimeFormat = gs.getDateTimeFormat();
gs.info(userDateTimeFormat);

    Ausgabe:

    yyyy-MM-dd HH:mm:ss

    Scoped GlideSystem – getErrorMessages()

    Gibt die Fehlermeldungen zurück, die von hinzugefügt wurden AddErrorMessage() Für die Sitzung.

    Tabelle : 87. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 88. Ergebnisse
    Typ Beschreibung
    Array aus Zeichenfolgen Fehlermeldungen, die der Sitzung zugeordnet sind.

    Scoped GlideSystem – getEscapedMessage(String id, Array args)

    Ruft die angegebene Nachricht aus der Tabelle „Nachricht“ [sys_ui_message] ab. Wenn die Nachricht HTML-Sonderzeichen enthält, werden sie durch die entsprechenden HTML-Namenscodes ersetzt. Beispiel: Und Wird Und .

    Wenn der angegebene Nachrichtenbezeichner (Schlüssel) in der Tabelle Nachricht [sys_ui_message] für die aktuelle Sprache vorhanden ist, gibt die Methode die übersetzte Nachricht mit allen Sonderzeichen als Escape-Sequenzen zurück. Wenn der angegebene Nachrichtenbezeichner für die aktuelle Sprache nicht vorhanden ist, gibt die Methode die englische Version der Nachricht zurück, wobei alle Sonderzeichen als Escape-Sequenzen zurückgegeben werden. Wenn der Nachrichtenbezeichner in der Tabelle nicht vorhanden ist, wird die Nachrichten-ID zurückgegeben.

    Weitere Informationen zur Nachrichtentabelle finden Sie unter Nachrichtentabelle .

    Hinweis:
    Wenn die UI-Meldung ein Häkchen (') hat, können Probleme mit der Meldung im Skript auftreten. Um Häkchen (') mit Escape-Zeichen versehen, verwenden Sie getMessageS(String, Object).
    Tabelle : 89. Parameter
    Name Typ Beschreibung
    id Zeichenfolge Nachrichtenbezeichner. Sie können diesen Wert im Feld Schlüssel der Tabelle Nachricht [sys_ui_message] suchen. Beachten Sie, dass das Feld „Schlüssel“ genau wie die tatsächliche Nachrichtenzeichenfolge aussieht.
    args Array Optional. Liste von Zeichenfolgen oder anderen Werten, die durch Java.Text.MessageFormat definiert sind und die Variablen innerhalb der angegebenen Nachricht ersetzen.

    Beispiel: gs.getMessage(„Hinzufügen der Aktion „{0}“ abbrechen, derselbe Subflow kann in diesem Subflow nicht zweimal hinzugefügt werden.“, current.action.name);

    In diesem Beispiel „{0}“ Wird durch den Inhalt von ersetzt current.action.name .

    Hinweis:
    Die übergebenen Werte werden nicht übersetzt. Sie werden wörtlich in die Nachricht eingefügt.
    Tabelle : 90. Rückgaben
    Typ Beschreibung
    Zeichenfolge UI-Nachricht mit HTML-Sonderzeichen durch HTML-Namenscodes ersetzt.

    In diesem Beispiel wird das Amperand-Zeichen durch den entsprechenden Amperand-HTML-Namenscode ersetzt.

    var my_message = gs.getEscapedMessage("Is the summary & details accurate?");
alert(my_message);

    Ausgabe

    Is the summary & details accurate?

    Dieses Beispiel zeigt, wie eine einzelne Variable innerhalb einer Nachricht ersetzt wird und wie die Symbole < und > in der Nachricht in die entsprechenden HTML-Namenscodes von &lt und &gt umgewandelt werden.

    // current.action.name is "update record"
var my_message = gs.getEscapedMessage("Abort adding action '{0}', same <subflow> can't be added twice in this subflow.", current.action.name);
alert(my_message);

    Ausgabe

    Abort adding action update record, same &ltsubflow&gt can't be added twice in this subflow.

    Scoped GlideSystem – getMessage(String id, Array args)

    Ruft übersetzte Nachrichten aus der Tabelle „Nachricht“ [sys_ui_message] zur Anzeige in einer UI ab.

    Wenn der angegebene Nachrichtenbezeichner (Schlüssel) in der Tabelle Nachricht [sys_ui_message] für die aktuelle Sprache vorhanden ist, gibt die Methode die übersetzte Nachricht zurück. Wenn der angegebene Nachrichtenbezeichner für die aktuelle Sprache nicht vorhanden ist, gibt die Methode die englische Version der Nachricht zurück. Wenn der Nachrichtenbezeichner in der Tabelle nicht vorhanden ist, wird die Nachrichten-ID zurückgegeben.

    Weitere Informationen zur Nachrichtentabelle finden Sie unter Nachrichtentabelle

    Hinweis:
    Wenn die UI-Meldung ein Häkchen (') hat, können Probleme mit der Meldung im Skript auftreten. Um Häkchen (') mit Escape-Zeichen versehen, verwenden Sie getMessageS(String, Object).
    Tabelle : 91. Parameter
    Name Typ Beschreibung
    id Zeichenfolge Nachrichtenbezeichner. Sie können diesen Wert im Feld Schlüssel der Tabelle Nachricht [sys_ui_message] suchen. Beachten Sie, dass das Feld „Schlüssel“ genau wie die tatsächliche Nachricht aussieht.
    args Array Optional. Liste von Zeichenfolgen oder anderen Werten, die durch Java.Text.MessageFormat definiert sind und die Variablen innerhalb der angegebenen Nachricht ersetzen.

    Beispiel: gs.getMessage(„Hinzufügen der Aktion „{0}“ abbrechen, derselbe Subflow kann in diesem Subflow nicht zweimal hinzugefügt werden.“, current.action.name);

    In diesem Beispiel „{0}“ Wird durch den Inhalt von ersetzt current.action.name .

    Hinweis:
    Die übergebenen Werte werden nicht übersetzt. Sie werden wörtlich in die Nachricht eingefügt.
    Tabelle : 92. Rückgaben
    Typ Beschreibung
    Zeichenfolge UI-Nachricht.

    Dieses Beispiel zeigt die Nachricht, die für den aktuellen Anwender zurückgegeben wird, wenn Spanisch die aktuelle Sprache ist.

    var my_message = gs.getMessage("rows will not be updated");
alert(my_message);

    Ausgabe:

    las filas no se actualizarán

    Dieses Beispiel zeigt, wie eine einzelne Variable innerhalb einer Nachricht ersetzt wird.

    // current.action.name is "update record"
var my_message = gs.getMessage("Abort adding action '{0}', same subflow can't be added twice in this subflow.", current.action.name);
alert(my_message);

    Ausgabe:

    Abort adding action update record, same subflow can't be added twice in this subflow.

    Dieses Beispiel zeigt, wie mehrere Variablen in einer Nachricht ersetzt werden.

    // current.sub_flow.name is 'schedule users'
// current.action.name is "update record"
var my_message = gs.getEscapedMessage("Abort adding action '{0}', same subflow can't be added twice in {1} subflow.", [current.action.name, current.sub_flow.name]);
alert(my_message);

    Ausgabe:

    Abort adding action update record, same subflow can't be added twice in schedule users subflow.

    Scoped GlideSystem – getProperty(String key, Object alt)

    Ruft den Wert einer Glide-Eigenschaft ab. Wenn die Eigenschaft nicht gefunden wird, wird ein alternativer Wert zurückgegeben.

    Tabelle : 93. Parameter
    Name Typ Beschreibung
    key Zeichenfolge Der Schlüssel für die Eigenschaft, deren Wert zurückgegeben werden soll.
    alt Objekt (Optional) Alternatives Objekt, das zurückgegeben werden soll, wenn die Eigenschaft nicht gefunden wird.
    Tabelle : 94. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der Wert der Glide-Eigenschaft oder das oben definierte alternative Objekt.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var attachment_link = gs.getProperty('glide.servlet.uri');
gs.info(attachment_link);

    Ausgabe:

    https://instance.service-now.com/

    Scoped GlideSystem – getSession()

    Ruft einen Verweis auf die aktuelle Glide-Sitzung ab.

    Tabelle : 95. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 96. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Eine Referenz für die aktuelle Sitzung. 
    if (!gs.hasRole("admin") && !gs.hasRole("user_admin") && gs.getSession().isInteractive()) {
  current.addQuery("active", "true");
}

    Scoped GlideSystem – getSessionID()

    Ruft die GlideSession-Sitzungs-ID ab.

    Tabelle : 97. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 98. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Die Sitzungs-ID. 
    var myUserObject = gs.getSessionID();
gs.info(myUserObject);
    Ausgabe:
    A0D4E5416F3F21005BE8883E6B3EE4B8

    Scoped GlideSystem – getSessionToken()

    Diese Methode ist nicht mehr verfügbar. Verwenden Sie stattdessen gs.getSession().getSessionToken().

    Tabelle : 99. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 100. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Das Sitzungstoken.

    Bereichsbezogenes GlideSystem – getTimeFormat()

    Gibt das Zeitformat zurück, das dem aktuellen Anwender zugeordnet ist.

    Tabelle : 101. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 102. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Das Zeitformat, das dem aktuellen Anwender zugeordnet ist.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var userTimeFormat = gs. getTimeFormat();
gs.info(userTimeFormat);

    Ausgabe:

    HH:mm:ss

    Scoped GlideSystem – getTimeZoneName()

    Gibt den Namen der Zeitzone zurück, die dem aktuellen Benutzer zugeordnet ist.

    Diese Methode ist veraltet. Verwenden Sie stattdessen die Methode getTimeZoneName() in der GlideSession API.

    Tabelle : 103. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 104. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der Name der Zeitzone.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    gs.info(gs.getTimeZoneName());

    Scoped GlideSystem – getUrlOnStack()

    Ruft den aktuellen URI für die Sitzung ab.

    Tabelle : 105. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 106. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der URI. 
    gs.info(gs.getUrlOnStack());

    Scoped GlideSystem – getUser()

    Gibt einen Verweis auf das bereichsbezogene GlideUser-Objekt für den aktuellen Benutzer zurück.

    Siehe GlideUser: Bereichsbezogen Für eine Liste der verfügbaren Methoden.

    Tabelle : 107. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 108. Ergebnisse
    Typ Beschreibung
    GlideUser Verweis auf ein bereichsbezogenes Benutzerobjekt. 
    var myUserObject = gs.getUser();
gs.info(myUserObject);

    Ausgabe

    com.glide.script.fencing.ScopedUser@6c0645

    Scoped GlideSystem – getUserDisplayName()

    Ruft den Anzeigenamen des aktuellen Benutzers ab.

    Tabelle : 109. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 110. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Das Namensfeld des aktuellen Benutzers.

    Diese Methode gibt beispielsweise Abel Tuter im Gegensatz zu abel.tuter zurück.

    In diesem Beispiel wird der Anzeigename des aktuellen Anwenders abgerufen.

    gs.info(gs.getUserDisplayName());

    Ausgabe:

    System Administrator

    Scoped GlideSystem – getUserID()

    Ruft die sys_id des aktuellen Benutzers ab.

    Tabelle : 111. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 112. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Die sys_id des aktuellen Benutzers.

    Das folgende Beispiel zeigt, wie die Zuweisung aller aktiven Incident-Datensätze aufgehoben wird, die dem aktuellen Anwender zugewiesen sind.

    var incidentGR = new GlideRecord('incident');
incidentGR.addActiveQuery();

// Filter results to incidents assigned to the current user
var currentUserSysId = gs.getUserID();
incidentGR.addQuery('assigned_to', currentUserSysId);
incidentGR.query();

while (incidentGR.next()) {
    incidentGR.setValue('assigned_to', 'NULL');
    incidentGR.update();
    gs.info(
        'Unassigned Incident: {0}: {1}',
        incidentGR.number.toString(),
        incidentGR.short_description.toString()
    );
}

    Ausgabe:

    Unassigned Incident: INC0000057: Performance problems with wifi
Unassigned Incident: INC0009001: Unable to post content on a Wiki page
Unassigned Incident: INC0008111: ATF : Test1

    Scoped GlideSystem – getUserName()

    Gibt den Anwendernamen des aktuellen Anwenders zurück.

    Tabelle : 113. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 114. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der Benutzername des aktuellen Benutzers.

    Diese Methode gibt beispielsweise abel.tuter im Gegensatz zu Abel Tuter zurück.

    In diesem Beispiel wird der Anwendername des aktuellen Anwenders abgerufen.

    gs.info("The current user name is: " + gs.getUserName());
    Ausgabe:
    The current user name is: admin

    Scoped GlideSystem – hasRole(Object role)

    Bestimmt, ob der aktuelle Benutzer die angegebene Rolle hat.

    Tabelle : 115. Parameter
    Name Typ Beschreibung
    role Objekt Die zu überprüfende Rolle.
    Tabelle : 116. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn der Benutzer die Rolle hatte. Gibt für Benutzer mit der Administratorrolle „true“ zurück. 
    if (!gs.hasRole("admin") && !gs.hasRole("groups_admin")  && gs.getSession().isInteractive()) {
  var qc = current.addQuery("u_hidden", "!=", "true"); //cannot see hidden groups... 
  qc.addOrCondition("sys_id", "javascript:getMyGroups()"); //...unless in the hidden group
  gs.info("User has admin and groups admin roles");
}
else {
  gs.info("User does not have both admin and groups admin roles");
}

    Scoped GlideSystem – hoursAgo(Number hours)

    Gibt das Datum und die Uhrzeit für eine bestimmte Anzahl von vergangenen Stunden zurück.

    Tabelle : 117. Parameter
    Name Typ Beschreibung
    hours Zahl Anzahl der Stunden als Ganzzahl
    Tabelle : 118. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT im Format jjjj-mm-tt hh:mm:ss 
    if (current.operation() == 'insert') {
 // If no due date was specified, calculate a default
 if (current.due_date == '') {
 
  if (current.urgency == '1') {
   // Set due date to 4 hours ahead of current time
   current.due_date = gs.hoursAgo(-4);
  }
 
  if (current.urgency == '2') {
   // Set due date to 2 days ahead of current time
   current.due_date = gs.daysAgo(-2);
  }
 
  if (current.urgency == '3') {
   // Set due date to 7 days ahead of current time
   current.due_date = gs.daysAgo(-7);
  }
 }
}

    Scoped GlideSystem – hoursAgoEnd(Number hours)

    Gibt das Datum und die Uhrzeit für das Ende der Stunde vor einer angegebenen Anzahl von Stunden zurück.

    Tabelle : 119. Parameter
    Name Typ Beschreibung
    hours Zahl Anzahl der Stunden als Ganzzahl
    Tabelle : 120. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT im Format jjjj-mm-tt hh:mm:ss

    Scoped GlideSystem – hoursAgoStart(Number hours)

    Gibt das Datum und die Uhrzeit für den Beginn der Stunde vor einer angegebenen Anzahl von Stunden zurück.

    Tabelle : 121. Parameter
    Name Typ Beschreibung
    hours Zahl Anzahl der Stunden als Ganzzahl
    Tabelle : 122. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT im Format jjjj-mm-tt hh:mm:ss

    Scoped GlideSystem – include(String name)

    Bietet eine sichere Möglichkeit, eine Skripteinbindung aus der Sandbox aufzurufen, sodass nur vertrauenswürdige Skripts einbezogen werden können.

    Tabelle : 123. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name des einzubeziehenden Skripts.
    Tabelle : 124. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob die Skripteinbindung funktioniert hat.
    Mögliche Werte:
    • Wahr: Skripteinbindung bearbeitet.
    • Falsch: Skripteinbindung fehlgeschlagen.

    Dieses Beispiel ruft die LDAPUtils im aktuellen Skriptkontext ab.

    var ldapServer = new GlideRecord("ldap_server_config");
ldapServer.addActiveQuery();
ldapServer.query();
gs.include("LDAPUtils");
var ldapUtils = new LDAPUtils();
var errMsg = "";
while (ldapServer.next()) {
  var ldap = new GlideLDAP();
  var dn = ldapServer.dn;
  var env = ldap.setup();
  if (env == null) {
    errMsg = "Failed environment setup, missing URL";
    gs.eventQueue("ldap.connection_failed",   ldapServer, ldapServer.getDisplayValue(), errMsg);
    gs.logError("LDAP server " + ldapServer.getDisplayValue() + " failed scheduled connection test: " + errMsg, "LDAP");
 }
}

    Scoped GlideSystem – info(String message, Object parm1, Object parm2, Object parm3, Object parm4, Object parm5)

    Schreibt eine Infomeldung in das Systemprotokoll.

    Tabelle : 125. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Protokollmeldung mit Platzhaltern für beliebige variable Argumente.
    param1 Objekt (Optional) Erstes Variablenargument.
    param2 Objekt (Optional) Zweites Variablenargument.
    param3 Objekt (Optional) Drittes Variablenargument.
    param4 Objekt (Optional) Viertes Variablenargument.
    param5 Objekt (Optional) Fünftes Variablenargument.
    Tabelle : 126. Ergebnisse
    Typ Beschreibung
    void 
    gs.info("This is an info message");
var myFirstName = "Abel";
var myLastName = "Tuter";
gs.info("This is an info message from {0}.{1}", myFirstName, myLastName);
    Ausgabe:
    This is an info message
This is an info message from Abel.Tuter

    Scoped GlideSystem – isDebugging()

    Bestimmt, ob das Debugging für einen bestimmten Bereich aktiv ist.

    Tabelle : 127. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 128. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn Sitzungsdebugging aktiv ist oder die Protokollebene für den angegebenen Bereich auf Debuggen festgelegt ist. 
    gs.debug("This is a log message");
var myFirstName = "Abel";
var myLastName = "Tuter";
gs.debug("This is a log message from {0}.{1}", myFirstName, myLastName);
gs.info(gs.isDebugging());

    Scoped GlideSystem – isInteractive()

    Überprüft, ob die aktuelle Sitzung interaktiv ist. Ein Beispiel für eine interaktive Sitzung ist, wenn sich ein Benutzer normal anmeldet. Ein Beispiel für eine nicht interaktive Sitzung ist die Verwendung einer SOAP-Anforderung zum Abrufen von Daten.

    Tabelle : 129. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 130. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn die Sitzung interaktiv ist. 
    if (!gs.hasRole("admin") && gs.getSession().isInteractive()) {
    var qc1 = current.addQuery('u_group',"");
    var gra = new GlideRecord('sys_user_grmember');
    gra.addQuery('user', gs.getUserID());
    gra.query();
    while (gra.next()) {
        qc1.addOrCondition('u_group', gra.group);
    }
}

    Scoped GlideSystem – isLoggedIn()

    Ermittelt, ob der aktuelle Benutzer derzeit angemeldet ist.

    Tabelle : 131. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 132. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn der aktuelle Benutzer angemeldet ist. 
    gs.info(gs.isLoggedIn());

    Scoped GlideSystem – isMobile()

    Sie können feststellen, ob eine Anforderung von einem Mobilgerät stammt.

    Diese Methode kann in UI Actionbedingungen und Business Rules verwendet werden.

    Tabelle : 133. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 134. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn die Anforderung von einem Mobilgerät stammt; andernfalls „false“. 
    if (gs.isMobile())
  gs.info("submitted from mobile UI");
 else 
   gs.info("NOT submitted from mobile UI");

    Ausgabe

    NOT submitted from mobile UI

    Scoped GlideSystem – minutesAgoEnd(Number minutes)

    Gibt das Datum und die Uhrzeit für das Ende der Minute vor einer angegebenen Anzahl von Minuten zurück.

    Tabelle : 135. Parameter
    Name Typ Beschreibung
    minutes Anzahl Ganzzahl vor Minuten, z. B. 5 oder 126.
    Tabelle : 136. Rückgaben
    Typ Beschreibung
    Zeichenfolge GMT vor der angegebenen Anzahl von Minuten am Ende der Minute (59 Sekunden).

    Format: jjjj-mm-TT hh:mm:ss

    Das folgende Beispiel zeigt das aktuelle Datum und die aktuelle Uhrzeit sowie das Datum und die Uhrzeit vor 30 Minuten am Ende der Minute in GMT an.

    var nowDateTime = new GlideDateTime();
gs.info("Now: " + nowDateTime);
var thirtyMinutesAgoDateTime = gs.minutesAgoEnd(30);
gs.info("Thirty minutes ago end time: " + thirtyMinutesAgoDateTime);

    Ausgabe:

    Now: 2021-10-20 15:22:13
Thirty minutes ago end time: 2021-10-20 14:52:59

    Scoped GlideSystem – minutesAgoStart(Number minutes)

    Gibt das Datum und die Uhrzeit für den Beginn der Minute vor einer angegebenen Anzahl von Minuten zurück.

    Tabelle : 137. Parameter
    Name Typ Beschreibung
    minutes Anzahl Ganzzahl vor Minuten, z. B. 15 oder 112.
    Tabelle : 138. Rückgaben
    Typ Beschreibung
    Zeichenfolge GMT vor der angegebenen Anzahl von Minuten zu Beginn der Minute.

    Format: jjjj-mm-TT hh:mm:ss

    Das folgende Beispiel zeigt das aktuelle Datum und die aktuelle Uhrzeit sowie das Datum und die Uhrzeit vor 30 Minuten zu Beginn der Minute in GMT an.

    var nowDateTime = new GlideDateTime();
gs.info("Now: " + nowDateTime);
var thirtyMinutesAgoDateTime = gs.minutesAgoStart(30);
gs.info("Thirty minutes ago: " + thirtyMinutesAgoDateTime);

    Ausgabe:

    Now: 2021-10-20 14:56:18
Thirty minutes ago: 2021-10-20 14:26:00

    Scoped GlideSystem – monthsAgo(Number months)

    Gibt das Datum und die Uhrzeit für eine bestimmte Anzahl von vergangenen Monaten zurück.

    Tabelle : 139. Parameter
    Name Typ Beschreibung
    months Anzahl Ganzzahl von Monaten.
    Tabelle : 140. Rückgaben
    Typ Beschreibung
    Zeichenfolge GMT der angegebenen Anzahl von Monaten genau zur gleichen Zeit.

    Format: jjjj-mm-TT hh:mm:ss

    Das folgende Beispiel zeigt das aktuelle Datum und die aktuelle Uhrzeit sowie das Datum und die Uhrzeit vor einem Monat gleichzeitig in GMT an.

    var nowDateTime = new GlideDateTime();
gs.info("Now: " + nowDateTime);
var oneMonthAgoDateTime = gs.monthsAgo(1);
gs.info("One month ago: " + oneMonthAgoDateTime);

    Ausgabe:

    Now: 2021-10-20 15:29:15
One month ago: 2021-09-20 15:29:15

    Bereichsbezogenes GlideSystem – monthsAgoEnd(Anzahl Monate)

    Gibt das Datum und die Uhrzeit für den letzten Tag des Monats vor einer angegebenen Anzahl von Monaten zurück.

    Tabelle : 141. Parameter
    Name Typ Beschreibung
    Monate Zahl (Ganzzahl) Anzahl der Monate, z. B. 4 oder 16.
    Tabelle : 142. Rückgaben
    Typ Beschreibung
    Zeichenfolge Datums- und Zeitstempel des Monats, die angegebene Anzahl von Monaten vor, in Ortszeit.

    Format: UTC JJJJ-mm-TT hh:mm:ss

    Das folgende Beispiel zeigt das aktuelle Datum und die aktuelle Uhrzeit sowie das Datum und die Uhrzeit vor zwei Monaten am Ende des Geschäftsmonats an.

    var nowDateTime = new GlideDateTime();
gs.info("Now: " + nowDateTime);
var endOfTheMonthDateTime = gs.monthsAgoEnd(2);
gs.info("End of the month: " + endOfTheMonthDateTime);

    Ausgabe:

    Now: 2021-10-20 19:23:35
End of the month: 2021-08-01 06:59:59

    Scoped GlideSystem – monthsAgoStart(Number months)

    Gibt das Datum und die Uhrzeit für den Beginn des Monats vor einer bestimmten Anzahl von Monaten zurück.

    Tabelle : 143. Parameter
    Name Typ Beschreibung
    months Anzahl Ganzzahl von vor Monaten, z. B. 3 oder 14.
    Tabelle : 144. Rückgaben
    Typ Beschreibung
    Zeichenfolge GMT-Beginn des Monats vor der angegebenen Anzahl von Monaten.

    Format: jjjj-mm-TT hh:mm:ss

    Das folgende Beispiel zeigt das aktuelle Datum und die aktuelle Uhrzeit sowie das Datum und die Uhrzeit vor drei Monaten in GMT an.

    var nowDateTime = new GlideDateTime();
gs.info("Now: " + nowDateTime);
var threeMonthsAgoDateTime = gs.monthsAgoStart(3);
gs.info("Three months ago start date and time: " + threeMonthsAgoDateTime);

    Ausgabe

    Now: 2021-10-20 15:05:27
Three months ago start date and time: 2021-07-01 07:00:00

    Scoped GlideSystem – nil(Object o)

    Fragt ein Objekt ab und gibt „true“ zurück, wenn das Objekt null oder undefiniert ist oder eine leere Zeichenfolge enthält.

    Tabelle : 145. Parameter
    Name Typ Beschreibung
    o Objekt Das zu überprüfende Objekt.
    Tabelle : 146. Rückgaben
    Typ Beschreibung
    Boolean „True“, wenn das Objekt null oder undefiniert ist oder eine leere Zeichenfolge enthält. Andernfalls wird „false“ zurückgegeben. 
    var now_GR = new GlideRecord();
gs.info(gs.nil(now_GR));

    Ausgabe

    true

    Scoped GlideSystem – quartersAgoEnd(Number quarters)

    Gibt das Datum und die Uhrzeit für den letzten Tag des Quartals für eine bestimmte Anzahl von Quartalen zurück.

    Tabelle : 147. Parameter
    Name Typ Beschreibung
    quarters Zahl Quartale als Ganzzahl
    Tabelle : 148. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT am Ende des Quartals, das die angegebene Anzahl von Quartalen zurückliegt, im Format jjjj-mm-tt hh:mm:ss

    Scoped GlideSystem – quartersAgoStart(Number quarters)

    Gibt das Datum und die Uhrzeit für den ersten Tag des Quartals für eine bestimmte Anzahl von Quartalen zurück.

    Tabelle : 149. Parameter
    Name Typ Beschreibung
    quarters Zahl Quartale als Ganzzahl
    Tabelle : 150. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT am Ende des Monats, der die angegebene Anzahl von Quartalen zurückliegt, im Format jjjj-mm-tt hh:mm:ss

    Scoped GlideSystem – setProperty(String key, String value, String description)

    Legt den angegebenen Schlüssel auf den angegebenen Wert fest, wenn die Eigenschaft im Gültigkeitsbereich des Skripts liegt.

    Hinweis:
    Beim Festlegen von Systemeigenschaften (sys_properties) sollten Sie diese Methode mit Vorsicht verwenden, da sie eine systemweite Cache-Leerung verursachen kann. Jede Leerung kann zu einer Systemverschlechterung führen, während die Caches neu erstellt werden. Wenn ein Wert häufig aktualisiert werden muss, sollte er nicht als Systemeigenschaft gespeichert werden. In der Regel sollten Sie nur solche Werte in der Tabelle sys_properties speichern, die sich nicht häufig ändern.
    Tabelle : 151. Parameter
    Name Typ Beschreibung
    key Zeichenfolge Der Schlüssel für die festzulegende Eigenschaft.
    Wert Zeichenfolge Der Wert der festzulegenden Eigenschaft.
    description Zeichenfolge Eine Beschreibung der Eigenschaft.
    Tabelle : 152. Ergebnisse
    Typ Beschreibung
    void

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    gs.setProperty("glide.foo","bar","foo");
gs.info(gs.getProperty("glide.foo"));

    Ausgabe:

    bar

    Scoped GlideSystem – setRedirect(Object o)

    Legt den Umleitungs-URI für diese Transaktion fest, der dann die nächste Seite bestimmt, die der Benutzer sehen kann.

    Tabelle : 153. Parameter
    Name Typ Beschreibung
    o Objekt URI-Objekt oder URI-Zeichenfolge, das bzw. die als Umleitung festgelegt werden soll
    Tabelle : 154. Ergebnisse
    Typ Beschreibung
    void 
    gs.setRedirect("com.glideapp.servicecatalog_cat_item_view.do?sysparm_id=d41ce5bac611227a0167f4bf8109bf70&sysparm_user=" 
+ current.sys_id + "&sysparm_email=" + current.email)

    Scoped GlideSystem – tableExists(String name)

    Ermittelt, ob eine Datenbanktabelle vorhanden ist.

    Tabelle : 155. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name der zu überprüfenden Tabelle.
    Tabelle : 156. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn die Tabelle existiert. False, wenn die Tabelle nicht gefunden wurde.

    In diesem Beispiel wird überprüft, ob die Tabellen „Incident“ und „foo“ in vorhanden sind ServiceNow Instanz.

    gs.info("Does the incident table exist? " + gs.tableExists("incident"));

gs.info("Does the foo table exist? " + gs.tableExists("foo"));

    Ausgabe:

    Does the incident table exist? true
Does the foo table exist? false

    Scoped GlideSystem – urlEncode(String url)

    Kodiert Nicht-ASCII-Zeichen, unsichere ASCII-Zeichen und Leerzeichen, sodass die zurückgegebene Zeichenfolge im Internet verwendet werden kann. Verwendet die UTF-8-Codierung. Verwendet eine prozentuale Codierung (%).

    Tabelle : 157. Parameter
    Name Typ Beschreibung
    URL Zeichenfolge Die zu codierende Zeichenfolge.
    Tabelle : 158. Rückgaben
    Typ Beschreibung
    Zeichenfolge Eine Zeichenfolge mit codierten Nicht-ASCII-Zeichen, unsicheren ASCII-Zeichen und Leerzeichen.

    Scoped GlideSystem – urlDecode(String url)

    Ersetzt UTF-8-codierte Zeichen durch ASCII-Zeichen.

    Tabelle : 159. Parameter
    Name Typ Beschreibung
    URL Zeichenfolge UTF-8 Prozent (%) codierte Zeichen.
    Tabelle : 160. Rückgaben
    Typ Beschreibung
    Zeichenfolge Codierte Zeichen wurden durch ASCII-Zeichen ersetzt.

    Scoped GlideSystem – warn(String message, Object parm1, Object parm2, Object parm3, Object parm4, Object parm5)

    Schreibt eine Warnmeldung in das Systemprotokoll.

    Tabelle : 161. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Protokollmeldung mit Platzhaltern für beliebige variable Argumente.
    param1 Objekt (Optional) Erstes Variablenargument.
    param2 Objekt (Optional) Zweites Variablenargument.
    param3 Objekt (Optional) Drittes Variablenargument.
    param4 Objekt (Optional) Viertes Variablenargument.
    param5 Objekt (Optional) Fünftes Variablenargument.
    Tabelle : 162. Ergebnisse
    Typ Beschreibung
    void 
    gs.warn("This is a warning");
var myFirstName = "Abel";
var myLastName = "Tuter";
gs.warn("This is a warning from {0}.{1}", myFirstName, myLastName);
    Ausgabe:
    This is a warning
This is a warning from Abel.Tuter

    Scoped GlideSystem – xmlToJSON(String xmlString)

    Übernimmt eine XML-Zeichenfolge und gibt ein JSON-Objekt zurück.

    Tabelle : 163. Parameter
    Name Typ Beschreibung
    xmlString Zeichenfolge Die zu konvertierende XML-Zeichenfolge.
    Tabelle : 164. Ergebnisse
    Typ Beschreibung
    Objekt Ein JSON-Objekt, das die XML-Zeichenfolge darstellt. Null, wenn die XML-Zeichenfolge nicht verarbeitet werden kann.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    var jsonObject = gs.xmlToJSON(xmlString);

    Scoped GlideSystem – yearsAgo(Number years)

    Gibt ein Datum und eine Uhrzeit für eine bestimmte Anzahl von vergangenen Jahren zurück.

    Tabelle : 165. Parameter
    Name Typ Beschreibung
    years Zahl Anzahl der Jahre als Ganzzahl
    Tabelle : 166. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT am Anfang des Jahres, das die angegebene Anzahl von Jahren zurückliegt, im Format jjjj-mm-tt hh:mm:ss

    Scoped GlideSystem – yesterday()

    Gibt die Uhrzeit von gestern zurück (vor 24 Stunden).

    Tabelle : 167. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 168. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT für die Zeit vor 24 Stunden im Format jjjj-mm-tt hh:mm:ss