GlideSystem – Scoped

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 27 Minuten Lesedauer

    • Die bereichsbezogene GlideSystem-API (in jedem serverseitigen JavaScript durch den Variablennamen 'gs' bezeichnet) bietet eine Reihe praktischer Methoden, um Informationen über das System, den aktuell angemeldeten Benutzer usw. abzurufen.

    Viele der GlideSystem-Methoden erleichtern die einfache Einbeziehung von Datumsangaben in Abfragebereiche und werden meistens in Filtern und Berichten verwendet.

    Scoped GlideSystem – addErrorMessage(String message)

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

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Hinzuzufügende Nachricht.
    Tabelle : 2. Ergebnisse
    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
       }
  }

    Scoped GlideSystem – addInfoMessage(String message)

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

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Infonachricht, die hinzugefügt werden soll.
    Tabelle : 4. Ergebnisse
    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);
  }
}

    Scoped GlideSystem – base64Encode(String source)

    Erstellt eine base64-Zeichenfolge aus der angegebenen Zeichenfolge.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    Quelle Zeichenfolge Zu codierende Zeichenfolge.
    Tabelle : 6. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Codierte base64-Zeichenfolge.

    Beispiel

    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 : 7. Parameter
    Name Typ Beschreibung
    Quelle Zeichenfolge base64-codierte Zeichenfolge.
    Tabelle : 8. 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 : 9. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 10. 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 : 11. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 12. 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 : 13. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 14. 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 : 15. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 16. 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 : 17. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 18. 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 : 19. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 20. 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 : 21. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 22. 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 : 23. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 24. 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 : 25. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 26. 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 : 27. 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 : 28. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Datum und Uhrzeit der Generierung.

    Wenn der Bereich startist, lautet der zurückgegebene Wert jjjj-mm-tt 00:00:00.

    Wenn der Bereich das Ende ist, lautet der Rückgabewert jjjj-mm-tt 23:59:59.

    Format: jjjj-mm-tt hh:mm:ss

    Dieses Beispiel zeigt die Verwendung von dateGenerate() 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 : 29. Parameter
    Name Typ Beschreibung
    days Zahl Ganzzahl von Tagen
    Tabelle : 30. 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 : 31. Parameter
    Name Typ Beschreibung
    days Zahl Ganzzahl von Tagen
    Tabelle : 32. 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 : 33. Parameter
    Name Typ Beschreibung
    days Zeichenfolge Ganzzahl von Tagen
    Tabelle : 34. 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 : 35. 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 : 36. 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 : 37. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 38. 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 : 39. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 40. 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 : 41. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 42. 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 : 43. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 44. 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 : 45. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 46. 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 : 47. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 48. 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 : 49. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 50. 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 : 51. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 52. 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 : 53. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 54. 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 : 55. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 56. 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 enthalten, damit diese Methode eine korrekte Ausgabe liefert.
    Tabelle : 57. 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 : 58. 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 : 59. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name des Events, das in die Warteschlange gestellt wird.
    instance Objekt GlideRecord-Objekt wie „current“.
    parm1 Zeichenfolge Optional. Wird mit der Instanz gespeichert, falls angegeben.
    parm2 Zeichenfolge Optional. Wird mit der Instanz gespeichert, falls angegeben.
    Warteschlange Zeichenfolge Optional. Name der Warteschlange.
    Tabelle : 60. 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)

    Reiht ein Event im Event-Manager in die Warteschlange ein.

    Die übergebenen Event-Zeitplaninformationen werden in der Tabelle „Events“ [sysevent] gespeichert. Weitere Informationen zu Events finden Sie unter Events.

    Tabelle : 61. 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 Event gilt.
    parm1 Zeichenfolge Optional. Zeichenfolge, die an das Event-Skript übergeben werden soll. Dieser Parameter ist eine Freiform und hängt von der Implementierung des Event-Skripts ab.

    Standard: Wenn der Parameter instance ein GlideRecord-Objekt ist, ist der Standard der Anzeigewert für diesen GlideRecord (now_GR.getDisplayValue), andernfalls ist er null.
    parm2 Zeichenfolge Optional. Zeichenfolge, die an das Event-Skript übergeben werden soll. Dieser Parameter ist eine Freiform und hängt von der Implementierung des Event-Skripts ab.

    Standard: null
    expiration Objekt Optional. GlideDateTime-Objekt oder ein Element vom Typ Datum/Uhrzeit, das das Datum und die Uhrzeit für die Verarbeitung des Events angibt.

    Standard: Aktuelles Datum/aktuelle Uhrzeit
    Tabelle : 62. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie die Methode mit einem GlideRecord, zwei Parametern, die an das Event-Skript übergeben werden, und einer angegebenen Zeit zum Planen des Events 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 : 63. Parameter
    Name Typ Beschreibung
    job GlideRecord Auszuführender Auftrag.
    Tabelle : 64. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Gibt die sys_id der geplanten Aufgabe zurück. Gibt null zurück, wenn der Job global ist.

    Beispiel

    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 : 65. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 66. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Eine 32-stellige hexadezimale GUID. 
    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 : 67. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 68. 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 weitere 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 : 69. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 70. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Die CSS-Cache-Version. 
    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 : 71. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 72. 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 : 73. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 74. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der aktuelle Bereichsname. 
    var currentScope = gs.getCurrentScopeName();
gs.info(currentScope);

    Ausgabe

    s_snc_test_scope

    Scoped GlideSystem – getDateFormat(String)

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

    Tabelle : 75. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 76. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Das dem aktuellen Benutzer zugeordnete Datumsformat.

    Im folgenden Beispiel wird das dem Benutzer zugeordnete Datumsformat zurückgegeben.

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

    Ausgabe:

    yyyy-MM-dd

    Scoped GlideSystem – getDateTimeFormat()

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

    Tabelle : 77. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 78. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Das Datums- und Uhrzeitformat, das dem aktuellen Benutzer zugeordnet ist.

    Das folgende Beispiel gibt das Format des Datums und der Uhrzeit zurück, die dem Benutzer 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 addErrorMessage() für die Sitzung hinzugefügt wurden.

    Tabelle : 79. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 80. 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 Nachrichtentabelle [sys_ui_message] ab. Wenn die Nachricht HTML-Sonderzeichen enthält, werden diese durch die entsprechenden HTML-Namenscodes ersetzt. Zum Beispiel wird & zu &.

    Wenn der angegebene Nachrichtenbezeichner (Schlüssel) in der Nachrichtentabelle [sys_ui_message] für die aktuelle Sprache vorhanden ist, gibt die Methode die übersetzte Nachricht mit allen zurückgegebenen 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 : 81. Parameter
    Name Typ Beschreibung
    id Zeichenfolge Nachrichtenbezeichner. Sie finden diesen Wert im Feld Schlüssel der Nachrichtentabelle [sys_ui_message]. Beachten Sie, dass das Feld Schlüssel genau wie die tatsächliche Nachrichtenzeichenfolge aussehen kann.
    args Array Optional. Liste der Zeichenfolgen oder anderer Werte, die durch java.text.MessageFormat definiert werden und die Variablen in 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 wird „{0}“ durch den Inhalt von current.action.nameersetzt.

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

    In diesem Beispiel wird das kaufmännische Und-Zeichen durch den entsprechenden kaufmännischen 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 in einer Nachricht ersetzt wird und wie die Symbole < und > in der Nachricht in die entsprechenden HTML-Namenscodes von < und > übertragen 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 Nachrichtentabelle [sys_ui_message] ab, um sie in einer Benutzeroberfläche anzuzeigen.

    Wenn der angegebene Nachrichtenbezeichner (Schlüssel) in der Nachrichtentabelle [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 : 83. Parameter
    Name Typ Beschreibung
    id Zeichenfolge Nachrichtenbezeichner. Sie finden diesen Wert im Feld Schlüssel der Nachrichtentabelle [sys_ui_message]. Beachten Sie, dass das Feld Schlüssel genau wie die tatsächliche Nachricht aussehen kann.
    args Array Optional. Liste der Zeichenfolgen oder anderer Werte, die durch java.text.MessageFormat definiert werden und die Variablen in 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 wird „{0}“ durch den Inhalt von current.action.nameersetzt.

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

    Dieses Beispiel zeigt die Nachricht, die für den aktuellen Benutzer 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 in 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 : 85. 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 : 86. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der Wert der Glide-Eigenschaft oder das oben definierte alternative Objekt. 
    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 : 87. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 88. 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 : 89. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 90. 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 : 91. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 92. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Das Sitzungstoken.

    Scoped GlideSystem – getTimeFormat()

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

    Tabelle : 93. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 94. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Das dem aktuellen Benutzer zugeordnete Zeitformat. 
    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 : 95. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 96. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der Name der Zeitzone. 
    gs.info(gs.getTimeZoneName());

    Scoped GlideSystem – getUrlOnStack()

    Ruft den aktuellen URI für die Sitzung ab.

    Tabelle : 97. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 98. 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.

    Unter GlideUser - Scoped finden Sieeine Liste der verfügbaren Methoden.

    Tabelle : 99. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 100. 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 : 101. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 102. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Das Namensfeld des aktuellen Benutzers.

    Zum Beispiel gibt diese Methode Abel Tuter zurück und nicht abel.tuter.

    In diesem Beispiel wird der Anzeigename des aktuellen Benutzers abgerufen.

    gs.info(gs.getUserDisplayName());

    Ausgabe:

    System Administrator

    Scoped GlideSystem – getUserID()

    Ruft die sys_id des aktuellen Benutzers ab.

    Tabelle : 103. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 104. 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 Benutzer 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 Benutzernamen des aktuellen Benutzers zurück.

    Tabelle : 105. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 106. 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 Benutzername des aktuellen Benutzers 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 : 107. Parameter
    Name Typ Beschreibung
    role Objekt Die zu überprüfende Rolle.
    Tabelle : 108. 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 : 109. Parameter
    Name Typ Beschreibung
    hours Zahl Anzahl der Stunden als Ganzzahl
    Tabelle : 110. 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 : 111. Parameter
    Name Typ Beschreibung
    hours Zahl Anzahl der Stunden als Ganzzahl
    Tabelle : 112. 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 : 113. Parameter
    Name Typ Beschreibung
    hours Zahl Anzahl der Stunden als Ganzzahl
    Tabelle : 114. 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, wobei nur vertrauenswürdige Skripts einbezogen werden.

    Tabelle : 115. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name des einzubeziehenden Skripts.
    Tabelle : 116. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob die Skripteinbindung funktioniert hat.
    Mögliche Werte:
    • true: Skripteinbindung hat funktioniert.
    • false: Skripteinbindung fehlgeschlagen.

    In diesem Beispiel werden die LDAPUtils im aktuellen Skriptkontext abgerufen.

    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 : 117. 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 : 118. 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 : 119. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 120. 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 : 121. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 122. 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 : 123. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 124. 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 : 125. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 126. 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 – monthsAgo(Number months)

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

    Tabelle : 127. Parameter
    Name Typ Beschreibung
    months Nummer Anzahl der zurückliegenden Monate als Ganzzahl.
    Tabelle : 128. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT der angegebenen Anzahl von Monaten, die genau zur gleichen Zeit zurückliegt.

    Format: jjjj-mm-tt hh:mm:ss

    Das folgende Beispiel zeigt das aktuelle Datum und die 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

    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 : 129. Parameter
    Name Typ Beschreibung
    minutes Nummer Ganzzahl in Minuten, z. B. 5 oder 126.
    Tabelle : 130. Ergebnisse
    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 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 : 131. Parameter
    Name Typ Beschreibung
    minutes Nummer Ganzzahl in Minuten, z. B. 15 oder 112.
    Tabelle : 132. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT vor der angegebenen Anzahl von Minuten, am Anfang der Minute.

    Format: jjjj-mm-tt hh:mm:ss

    Das folgende Beispiel zeigt das aktuelle Datum und die 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 – monthsAgoStart(Number months)

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

    Tabelle : 133. Parameter
    Name Typ Beschreibung
    months Nummer Ganzzahl für Anzahl der zurückliegenden Monate, z. B. 3 oder 14.
    Tabelle : 134. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT-Beginn des Monats, der die angegebene Anzahl von Monaten zurückliegt.

    Format: jjjj-mm-tt hh:mm:ss

    Das folgende Beispiel zeigt das aktuelle Datum und die 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 : 135. Parameter
    Name Typ Beschreibung
    o Objekt Das zu überprüfende Objekt.
    Tabelle : 136. Ergebnisse
    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 : 137. Parameter
    Name Typ Beschreibung
    quarters Zahl Quartale als Ganzzahl
    Tabelle : 138. 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 : 139. Parameter
    Name Typ Beschreibung
    quarters Zahl Quartale als Ganzzahl
    Tabelle : 140. 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 : 141. 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 : 142. Ergebnisse
    Typ Beschreibung
    void 
    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 : 143. Parameter
    Name Typ Beschreibung
    o Objekt URI-Objekt oder URI-Zeichenfolge, das bzw. die als Umleitung festgelegt werden soll
    Tabelle : 144. 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 : 145. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name der zu überprüfenden Tabelle.
    Tabelle : 146. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn die Tabelle existiert. False, wenn die Tabelle nicht gefunden wurde.

    Dieses Beispiel zeigt, wie überprüft wird, ob die Tabellen „incident“ und „foo“ in der Instanz ServiceNow vorhanden sind.

    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 : 147. Parameter
    Name Typ Beschreibung
    URL Zeichenfolge Die zu codierende Zeichenfolge.
    Tabelle : 148. Ergebnisse
    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 : 149. Parameter
    Name Typ Beschreibung
    URL Zeichenfolge UTF-8-Prozentsatz (%) codierte Zeichen.
    Tabelle : 150. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Codierte Zeichen 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 : 151. 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 : 152. 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 : 153. Parameter
    Name Typ Beschreibung
    xmlString Zeichenfolge Die zu konvertierende XML-Zeichenfolge.
    Tabelle : 154. Ergebnisse
    Typ Beschreibung
    Objekt Ein JSON-Objekt, das die XML-Zeichenfolge darstellt. Null, wenn die XML-Zeichenfolge nicht verarbeitet werden kann. 
    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 : 155. Parameter
    Name Typ Beschreibung
    years Zahl Anzahl der Jahre als Ganzzahl
    Tabelle : 156. 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 : 157. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 158. Ergebnisse
    Typ Beschreibung
    Zeichenfolge GMT für die Zeit vor 24 Stunden im Format jjjj-mm-tt hh:mm:ss