GlideSystem – Umfang

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
Ungültig

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 – addInfoMessage(Zeichenfolgennachricht)

Fügt eine Infonachricht für die aktuelle Sitzung hinzu. Diese Methode wird für asynchrone Business-Regeln nicht unterstützt.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Hinzuzufügende Infonachricht.

Tabelle : 4. Rückgaben

Typ	Beschreibung
Ungültig

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 – base64Encode (Zeichenfolgenquelle)

Erstellt eine base64-Zeichenfolge aus der angegebenen Zeichenfolge.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
Quelle	Zeichenfolge	Zu codierende Zeichenfolge.

Tabelle : 6. 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");

Bereichsbezogenes GlideSystem – base64Decode (Zeichenfolgenquelle)

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

Tabelle : 7. Parameter

Name	Typ	Beschreibung
Quelle	Zeichenfolge	Eine base64-codierte Zeichenfolge.

Tabelle : 8. Rückgaben

Typ	Beschreibung
Zeichenfolge	Die decodierte Zeichenfolge.

Bereichsbezogenes 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. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT Anfang des letzten Monats im Format JJJJ-mm-tt hh:mm:ss

Bereichsbezogenes 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. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT Anfang der letzten Woche im Format JJJJ-mm-tt hh:mm:ss

Bereichsbezogenes 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. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT Anfang des nächsten Monats im Format JJJJ-mm-tt hh:mm:ss

Bereichsbezogenes 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. Rückgaben

Typ	Beschreibung
Zeichenfolge	Der GMT-Beginn der nächsten Woche im Format JJJJ-mm-tt hh:mm:ss.

Bereichsbezogenes 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. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT Anfang des nächsten Jahres im Format JJJJ-mm-tt hh:mm:ss

Bereichsbezogenes 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. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT Anfang dieses Monats im Format JJJJ-mm-tt hh:mm:ss

Bereichsbezogenes 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. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT Anfang dieses Quartals im Format JJJJ-mm-tt hh:mm:ss

Bereichsbezogenes 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. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT Anfang dieser Woche im Format JJJJ-mm-tt hh:mm:ss

Bereichsbezogenes 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. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT Anfang dieses Jahres im Format JJJJ-mm-tt hh:mm:ss

Bereichsbezogenes GlideSystem – dateGenerate(Zeichenfolgendatum, Zeichenfolgenbereich)

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

Tabelle : 27. Parameter

Name	Typ	Beschreibung
Datum	Zeichenfolge	Datum, für das die GMT generiert werden soll. Format: jjjj-mm-tt
Bereich	Zeichenfolge	Start, Ende oder eine Uhrzeit im 24-Stunden-Format hh:mm:ss.

Tabelle : 28. Rückgaben

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 DateGenerate() Dient 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

Bereichsbezogenes GlideSystem – daysAgo (Anzahl Tage)

Gibt Datum und Uhrzeit für eine angegebene Anzahl von Tagen zurück.

Tabelle : 29. Parameter

Name	Typ	Beschreibung
Tage	Nummer	Ganze Anzahl von Tagen

Tabelle : 30. Rückgaben

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();
}

Bereichsbezogenes GlideSystem – daysAgoEnd (Anzahl Tage)

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

Tabelle : 31. Parameter

Name	Typ	Beschreibung
Tage	Nummer	Ganze Anzahl von Tagen

Tabelle : 32. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT-Tagesende im Format JJJJ-mm-tt hh:mm:ss

Bereichsbezogenes GlideSystem – daysAgoStart (Anzahl Tage)

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
Tage	Zeichenfolge	Ganze Anzahl von Tagen

Tabelle : 34. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT-Beginn 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();

Bereichsbezogenes GlideSystem – Debuggen(Zeichenfolgennachricht, Objektparm1, Objektparmm2, Objektparmm3, Objektparm4, Objektparm5)

Schreibt eine Debug-Nachricht in das Systemprotokoll.

Tabelle : 35. Parameter

Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Die Protokollnachricht mit Platzhaltern für beliebige Variablenargumente.
param1	Objekt	(Optional) erstes Variablenargument.
Parameter 2	Objekt	(Optional) zweites Variablenargument.
param3	Objekt	(Optional) drittes Variablenargument.
param4	Objekt	(Optional) Viertes Variablenargument.
param5	Objekt	(Optional) Fünftes Variablenargument.

Tabelle : 36. Rückgaben

Typ	Beschreibung
Ungültig

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)

Bereichsbezogenes 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. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT Ende des letzten Monats im Format JJJJ-mm-tt hh:mm:ss

Bereichsbezogenes 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. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT Ende der letzten Woche im Format JJJJ-mm-tt hh:mm:ss

Bereichsbezogenes GlideSystem – endOfLastYear()

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

Tabelle : 41. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 42. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT im Format JJJJ-mm-tt hh:mm:ss

Bereichsbezogenes GlideSystem – endOfNextMonth()

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

Tabelle : 43. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 44. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT im Format JJJJ-mm-tt hh:mm:ss

Bereichsbezogenes GlideSystem – endOfNextWeek()

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

Tabelle : 45. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 46. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT im Format JJJJ-mm-tt hh:mm:ss

Bereichsbezogenes GlideSystem – endOfNextYear()

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

Tabelle : 47. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 48. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT im Format JJJJ-mm-tt hh:mm:ss

Bereichsbezogenes 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. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT im Format JJJJ-mm-tt hh:mm:ss

Bereichsbezogenes GlideSystem – endOfThisQuarter()

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

Tabelle : 51. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 52. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT im Format JJJJ-mm-tt hh:mm:ss

Bereichsbezogenes 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. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT im Format JJJJ-mm-tt hh:mm:ss

Bereichsbezogenes GlideSystem – endOfThisYear()

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

Tabelle : 55. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 56. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT im Format JJJJ-mm-tt hh:mm:ss

Bereichsbezogenes GlideSystem – Fehler(Zeichenfolgennachricht, Objektparm1, Objektparmm2, Objektparmm3, Objektparm4, Objektparm5)

Schreibt eine Fehlermeldung in das Systemprotokoll.

Diese Methode akzeptiert bis zu fünf Variablenargumente (varargs) in der Nachricht mithilfe des Platzhalterersetzungsmusters „Java MessageFormat“.

Hinweis:

Variablen müssen gültige Werte für diese Methode enthalten, um die richtige Ausgabe bereitzustellen.

Tabelle : 57. Parameter

Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Die Protokollnachricht mit Platzhaltern für beliebige Variablenargumente.
param1	Objekt	(Optional) erstes Variablenargument.
Parameter 2	Objekt	(Optional) zweites Variablenargument.
param3	Objekt	(Optional) drittes Variablenargument.
param4	Objekt	(Optional) Viertes Variablenargument.
param5	Objekt	(Optional) Fünftes Variablenargument.

Tabelle : 58. Rückgaben

Typ	Beschreibung
Ungültig

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

Bereichsbezogenes GlideSystem – eventQueue(Zeichenfolgenname, Objektinstanz, Zeichenfolgenparm1, Zeichenfolgenparm2, Zeichenfolgenwarteschlange)

Stellt ein Ereignis für den Ereignismanager in die Warteschlange.

Tabelle : 59. Parameter

Name	Typ	Beschreibung
name	Zeichenfolge	Name des Ereignisses, das in die Warteschlange gestellt wird.
Instanz	Objekt	GlideRecord-Objekt, z. B. „current“.
parm1	Zeichenfolge	Optional. Wurde mit der Instanz gespeichert, falls angegeben.
parm2	Zeichenfolge	Optional. Wurde mit der Instanz gespeichert, falls angegeben.
Warteschlange	Zeichenfolge	Optional. Name der Warteschlange.

Tabelle : 60. Rückgaben

Typ	Beschreibung
Ungültig

if (current.operation() != 'insert' && current.comments.changes()) {
    gs.eventQueue('incident.commented', current, gs.getUserID(), gs.getUserName());
}

Bereichsbezogenes GlideSystem – eventQueueScheduled (Zeichenfolgenname, Objektinstanz, Zeichenfolgenparm1, Zeichenfolgenparm m2, Objektablauf)

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 : 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 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 instanceDer Parameter ist ein GlideRecord-Objekt, dann ist der Standardwert der Anzeigewert für diesen GlideRecord (now_GR.getDisplayValue), andernfalls ist er der Wert 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
Ablauf	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 : 62. Rückgaben

Typ	Beschreibung
Ungültig

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', '', '', '');

Bereichsbezogenes GlideSystem – executeNow (GlideRecord-Auftrag)

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

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

Tabelle : 63. Parameter

Name	Typ	Beschreibung
job	GlideRecord	Auszuführender Auftrag.

Tabelle : 64. Rückgaben

Typ	Beschreibung
Zeichenfolge	Gibt die sys_ID der geplanten Aufgabe zurück. Gibt Null zurück, wenn der Auftrag 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);
}

Bereichsbezogenes GlideSystem – generateGUID()

Generiert eine GUID, die verwendet werden kann, wenn ein eindeutiger Bezeichner erforderlich ist.

Tabelle : 65. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 66. Rückgaben

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

Bereichsbezogenes 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. Rückgaben

Typ	Beschreibung
Zeichenfolge	Bereichsname des Anrufers oder null, wenn kein Anrufer vorhanden ist.

Dieses Beispiel zeigt zwei Skripteinbindungen, die für alle Anwendungsbereiche auf „zugänglich“ festgelegt 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 Bereichs „App_scope_a“ verwendet werden, um den Bereichsnamen des Anrufers abzurufen – in diesem Fall „App_scope_B.“.

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

Bereichsbezogenes 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. Rückgaben

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=

Bereichsbezogenes GlideSystem – getCurrentApplicationId()

Ruft die ID der aktuellen Anwendung wie mit der Anwendungsauswahl festgelegt ab.

Tabelle : 71. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 72. Rückgaben

Typ	Beschreibung
Zeichenfolge	Die sys_ID der aktuellen Anwendung oder global in keiner ist festgelegt.

var currentId = gs.getCurrentApplicationId();
gs.info(currentId);

Ausgabe

04936cb16f30b1005be8883e6b3ee4e0

Bereichsbezogenes GlideSystem – getCurrentScopeName()

Ruft den Namen des aktuellen Bereichs ab.

Tabelle : 73. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 74. Rückgaben

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 : 75. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 76. Rückgaben

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 : 77. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 78. Rückgaben

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

Bereichsbezogenes GlideSystem – getErrorMessages()

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

Tabelle : 79. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 80. Rückgaben

Typ	Beschreibung
Array aus Zeichenfolgen	Fehlermeldungen, die der Sitzung zugeordnet sind.

Bereichsbezogenes GlideSystem – getEscapedMessage (Zeichenfolgen-ID, Array-Argumente)

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 Nachrichtentabelle [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-Nachricht ein Häkchen (') aufweist, kann es Probleme mit der Nachricht im Skript geben. Um die Ticks (') zu vermeiden, verwenden Sie GetMessageS (Zeichenfolge, Objekt) .

Tabelle : 81. Parameter

Name	Typ	Beschreibung
ID	Zeichenfolge	Nachrichtenbezeichner. Sie finden diesen Wert im Feld „Schlüssel“ der Tabelle „Nachricht“ [sys_ui_message]. Beachten Sie, dass das Feld „Schlüssel“ genau wie die tatsächliche Nachrichtenzeichenfolge aussehen kann.
args	Array	Optional. Liste von Zeichenfolgen oder anderen Werten, die von Java.Text.MessageFormat definiert sind und die 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 : 82. Rückgaben

Typ	Beschreibung
Zeichenfolge	UI-Nachricht mit HTML-Sonderzeichen durch HTML-Namenscodes ersetzt.

In diesem Beispiel wird das Zeichen „Amperand“ durch den entsprechenden HTML-Namenscode „Amperand“ 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 umgesetzt 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.

Bereichsbezogenes GlideSystem – getMessage (Zeichenfolgen-ID, Array-Argumente)

Ruft übersetzte Nachrichten aus der Nachrichtentabelle [sys_ui_message] ab, die in einer Anwenderoberfläche angezeigt werden sollen.

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-Nachricht ein Häkchen (') aufweist, kann es Probleme mit der Nachricht im Skript geben. Um die Ticks (') zu vermeiden, verwenden Sie GetMessageS (Zeichenfolge, Objekt) .

Tabelle : 83. Parameter

Name	Typ	Beschreibung
ID	Zeichenfolge	Nachrichtenbezeichner. Sie finden diesen Wert im Feld „Schlüssel“ der Tabelle „Nachricht“ [sys_ui_message]. Beachten Sie, dass das Feld „Schlüssel“ genau wie die tatsächliche Nachricht aussieht.
args	Array	Optional. Liste von Zeichenfolgen oder anderen Werten, die von Java.Text.MessageFormat definiert sind und die 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 : 84. 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.

Bereichsbezogenes GlideSystem – getProperty (Zeichenfolgenschlüssel, alt. Objekt)

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. Rückgaben

Typ	Beschreibung
Zeichenfolge	Der Wert der Glide-Eigenschaft oder des oben definierten alternativen Objekts.

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/

Bereichsbezogenes GlideSystem – getSession()

Ruft einen Verweis auf die aktuelle Glide-Sitzung ab.

Tabelle : 87. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 88. Rückgaben

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");
}

Bereichsbezogenes GlideSystem – getSessionID()

Ruft die GlideSession-Sitzungs-ID ab.

Tabelle : 89. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 90. Rückgaben

Typ	Beschreibung
Zeichenfolge	Die Sitzungs-ID.

var myUserObject = gs.getSessionID();
gs.info(myUserObject);

Ausgabe:

A0D4E5416F3F21005BE8883E6B3EE4B8

Bereichsbezogenes GlideSystem – getSessionToken()

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

Tabelle : 91. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 92. Rückgaben

Typ	Beschreibung
Zeichenfolge	Das Sitzungstoken.

Bereichsbezogenes GlideSystem – getTimeFormat()

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

Tabelle : 93. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 94. Rückgaben

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

Bereichsbezogenes GlideSystem – getTimeZoneName()

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

Diese Methode ist veraltet. Verwenden Sie stattdessen GetTimeZoneName() Methode in GlideSession API.

Tabelle : 95. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 96. Rückgaben

Typ	Beschreibung
Zeichenfolge	Der Name der Zeitzone.

Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

gs.info(gs.getTimeZoneName());

Bereichsbezogenes GlideSystem – getUrlOnStack()

Ruft den aktuellen URI für die Sitzung ab.

Tabelle : 97. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 98. Rückgaben

Typ	Beschreibung
Zeichenfolge	Der URI.

gs.info(gs.getUrlOnStack());

Bereichsbezogenes GlideSystem – getUser()

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

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

Tabelle : 99. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 100. Rückgaben

Typ	Beschreibung
GlideUser	Verweis auf ein bereichsbezogenes Anwenderobjekt.

var myUserObject = gs.getUser();
gs.info(myUserObject);

Ausgabe

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

Bereichsbezogenes GlideSystem – getUserDisplayName()

Ruft den Anzeigenamen des aktuellen Anwenders ab.

Tabelle : 101. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 102. Rückgaben

Typ	Beschreibung
Zeichenfolge	Das Namensfeld des aktuellen Anwenders. Diese Methode gibt beispielsweise „Abel Tuter“ im Gegensatz zu „abel.tuter“ zurück.

Dieses Beispiel ruft den Anzeigenamen des aktuellen Anwenders ab.

gs.info(gs.getUserDisplayName());

Ausgabe:

System Administrator

Bereichsbezogenes GlideSystem – getUserID()

Ruft die sys_ID des aktuellen Anwenders ab.

Tabelle : 103. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 104. Rückgaben

Typ	Beschreibung
Zeichenfolge	Die sys_ID des aktuellen Anwenders.

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

Bereichsbezogenes GlideSystem – GetUserName()

Gibt den Anwendernamen des aktuellen Anwenders zurück.

Tabelle : 105. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 106. Rückgaben

Typ	Beschreibung
Zeichenfolge	Der Anwendername des aktuellen Anwenders. Diese Methode gibt beispielsweise „abel.tuter“ im Gegensatz zu „Abel Tuter“ zurück.

Dieses Beispiel ruft den Anwendernamen des aktuellen Anwenders ab.

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

Ausgabe:

The current user name is: admin

Bereichsbezogenes GlideSystem – hasRole (Objektrolle)

Bestimmt, ob der aktuelle Anwender über die angegebene Rolle verfügt.

Tabelle : 107. Parameter

Name	Typ	Beschreibung
Rolle	Objekt	Die zu überprüfende Rolle.

Tabelle : 108. Rückgaben

Typ	Beschreibung
Boolean	„Wahr“, wenn der Anwender über die Rolle verfügte. Gibt „wahr“ für Anwender mit der Administratorrolle 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");
}

Bereichsbezogenes GlideSystem – hoursAgo (Anzahl Stunden)

Gibt Datum und Uhrzeit für eine angegebene Anzahl von Stunden zurück.

Tabelle : 109. Parameter

Name	Typ	Beschreibung
Stunden	Nummer	Ganzzahlige Anzahl von Stunden

Tabelle : 110. Rückgaben

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);
  }
 }
}

Bereichsbezogenes GlideSystem – hoursAgoEnd (Anzahl Stunden)

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

Tabelle : 111. Parameter

Name	Typ	Beschreibung
Stunden	Nummer	Ganzzahlige Anzahl von Stunden

Tabelle : 112. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT im Format JJJJ-mm-tt hh:mm:ss

Bereichsbezogenes GlideSystem – hoursAgoStart (Anzahl Stunden)

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
Stunden	Nummer	Ganzzahlige Anzahl von Stunden

Tabelle : 114. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT im Format JJJJ-mm-tt hh:mm:ss

Bereichsbezogenes GlideSystem – include(Zeichenfolgenname)

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

Tabelle : 115. Parameter

Name	Typ	Beschreibung
name	Zeichenfolge	Name des einzubeziehenden Skripts.

Tabelle : 116. Rückgaben

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob die Skripteinbindung funktioniert hat. Mögliche Werte: Wahr: Skripteinbindung funktioniert. 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");
 }
}

Bereichsbezogenes GlideSystem – Info(Zeichenfolgennachricht, Objektparm1, Objektparmm2, Objektparmm3, Objektparm4, Objektparm5)

Schreibt eine Infonachricht in das Systemprotokoll.

Tabelle : 117. Parameter

Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Die Protokollnachricht mit Platzhaltern für beliebige Variablenargumente.
param1	Objekt	(Optional) erstes Variablenargument.
Parameter 2	Objekt	(Optional) zweites Variablenargument.
param3	Objekt	(Optional) drittes Variablenargument.
param4	Objekt	(Optional) Viertes Variablenargument.
param5	Objekt	(Optional) Fünftes Variablenargument.

Tabelle : 118. Rückgaben

Typ	Beschreibung
Ungültig

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

Bereichsbezogenes GlideSystem – isDebugging()

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

Tabelle : 119. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 120. Rückgaben

Typ	Beschreibung
Boolean	„Wahr“, wenn entweder das Sitzungs-Debugging 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());

Bereichsbezogenes GlideSystem – isInteractive()

Überprüft, ob die aktuelle Sitzung interaktiv ist. Ein Beispiel für eine interaktive Sitzung ist, wenn sich ein Anwender 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. Rückgaben

Typ	Beschreibung
Boolean	„Wahr“, 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);
    }
}

Bereichsbezogenes GlideSystem – isLoggedIn()

Bestimmt, ob der aktuelle Anwender derzeit angemeldet ist.

Tabelle : 123. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 124. Rückgaben

Typ	Beschreibung
Boolean	„Wahr“, wenn der aktuelle Anwender angemeldet ist.

gs.info(gs.isLoggedIn());

Bereichsbezogenes GlideSystem – isMobile()

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

Diese Methode kann in UI-Aktionsbedingungen und Business-Regeln verwendet werden.

Tabelle : 125. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 126. Rückgaben

Typ	Beschreibung
Boolean	„Wahr“, wenn die Anforderung von einem Mobilgerät stammt; andernfalls „falsch“.

if (gs.isMobile())
  gs.info("submitted from mobile UI");
 else 
   gs.info("NOT submitted from mobile UI");

Ausgabe

NOT submitted from mobile UI

Bereichsbezogenes GlideSystem – minutesAgoEnd(Anzahl Minuten)

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

Tabelle : 127. Parameter

Name	Typ	Beschreibung
Minuten	Nummer	Ganzzahl vor Minuten, z. B. 5 oder 126.

Tabelle : 128. 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

Bereichsbezogenes GlideSystem – minutesAgoStart(Anzahl Minuten)

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

Tabelle : 129. Parameter

Name	Typ	Beschreibung
Minuten	Nummer	Ganzzahl vor Minuten, z. B. 15 oder 112.

Tabelle : 130. 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

Bereichsbezogenes GlideSystem – monthsAgo (Anzahl Monate)

Gibt Datum und Uhrzeit für eine angegebene Anzahl von Monaten zurück.

Tabelle : 131. Parameter

Name	Typ	Beschreibung
Monate	Nummer	Ganzzahlige Anzahl von Monaten.

Tabelle : 132. 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 : 133. Parameter

Name	Typ	Beschreibung
Monate	Zahl (Ganzzahl)	Anzahl der Monate, z. B. 4 oder 16.

Tabelle : 134. Rückgaben

Typ	Beschreibung
Zeichenfolge	Datums- und Zeitstempel des Monats, die angegebene Anzahl von Monaten vor, in lokaler Zeit. 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

Bereichsbezogenes GlideSystem – monthsAgoStart (Anzahl Monate)

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

Tabelle : 135. Parameter

Name	Typ	Beschreibung
Monate	Nummer	Ganzzahlanzahl von vor Monaten, z. B. 3 oder 14.

Tabelle : 136. 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

Bereichsbezogenes GlideSystem – Nil(Object o)

Fragt ein Objekt ab und gibt „wahr“ zurück, wenn das Objekt null, nicht definiert oder eine leere Zeichenfolge enthält.

Tabelle : 137. Parameter

Name	Typ	Beschreibung
o	Objekt	Das zu überprüfende Objekt.

Tabelle : 138. Rückgaben

Typ	Beschreibung
Boolean	„Wahr“, wenn das Objekt null oder nicht definiert ist oder eine leere Zeichenfolge enthält. Andernfalls wird „falsch“ zurückgegeben.

var now_GR = new GlideRecord();
gs.info(gs.nil(now_GR));

Ausgabe

true

Bereichsbezogenes GlideSystem – QuartersAgoEnd(Anzahl Quartale)

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

Tabelle : 139. Parameter

Name	Typ	Beschreibung
Quartale	Nummer	Ganzzahl-Anzahl der Quartale

Tabelle : 140. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT-Ende des Quartals, das vor der angegebenen Anzahl von Quartalen lag, im Format JJJJ-mm-tt hh:mm:ss

Bereichsbezogenes GlideSystem – QuartersAgoStart(Anzahl Quartale)

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

Tabelle : 141. Parameter

Name	Typ	Beschreibung
Quartale	Nummer	Ganzzahl-Anzahl der Quartale

Tabelle : 142. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT-Ende des Monats, der vor der angegebenen Anzahl von Quartalen lag, im Format JJJJ-mm-tt hh:mm:ss

Bereichsbezogenes GlideSystem – setProperty(Zeichenfolgenschlüssel, Zeichenfolgenwert, Zeichenfolgenbeschreibung)

Legt den angegebenen Schlüssel auf den angegebenen Wert fest, wenn die Eigenschaft innerhalb des Bereichs des Skripts liegt.

Hinweis:

Beim Festlegen von Systemeigenschaften (sys_properties) mit dieser Methode ist Vorsicht geboten, da dies zu einer systemweiten Cache-Leerung führt. Jede Leerung kann zu einer Verschlechterung des Systems führen, während die Caches neu erstellt werden. Wenn ein Wert häufig aktualisiert werden muss, darf er nicht als Systemeigenschaft gespeichert werden. Im Allgemeinen sollten Sie in der Tabelle „sys_properties“ nur Werte platzieren, die sich nicht häufig ändern.

Tabelle : 143. Parameter

Name	Typ	Beschreibung
key	Zeichenfolge	Der Schlüssel für die festzulegende Eigenschaft.
Wert	Zeichenfolge	Der Wert der festzulegenden Eigenschaft.
Beschreibung	Zeichenfolge	Eine Beschreibung der Eigenschaft.

Tabelle : 144. Rückgaben

Typ	Beschreibung
Ungültig

Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

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

Ausgabe:

bar

Bereichsbezogenes GlideSystem – setRedirect(Object o)

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

Tabelle : 145. Parameter

Name	Typ	Beschreibung
o	Objekt	URI-Objekt oder URI-Zeichenfolge, die als Umleitung festgelegt werden soll

Tabelle : 146. Rückgaben

Typ	Beschreibung
Ungültig

gs.setRedirect("com.glideapp.servicecatalog_cat_item_view.do?sysparm_id=d41ce5bac611227a0167f4bf8109bf70&sysparm_user=" 
+ current.sys_id + "&sysparm_email=" + current.email)

Bereichsbezogenes GlideSystem – tableExists(Zeichenfolgenname)

Bestimmt, ob eine Datenbanktabelle vorhanden ist.

Tabelle : 147. Parameter

Name	Typ	Beschreibung
name	Zeichenfolge	Name der Tabelle, die auf Vorhandensein überprüft werden soll.

Tabelle : 148. Rückgaben

Typ	Beschreibung
Boolean	„Wahr“, wenn die Tabelle vorhanden ist. Falsch, wenn die Tabelle nicht gefunden wurde.

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

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

Bereichsbezogenes GlideSystem – urlEncode(Zeichenfolgen-url)

Codiert nicht-ASCII-Zeichen, unsichere ASCII-Zeichen und Leerzeichen, damit die zurückgegebene Zeichenfolge im Internet verwendet werden kann. Verwendet UTF-8-Codierung. Verwendet Prozentcodierung (%).

Tabelle : 149. Parameter

Name	Typ	Beschreibung
URL	Zeichenfolge	Die zu codierende Zeichenfolge.

Tabelle : 150. Rückgaben

Typ	Beschreibung
Zeichenfolge	Eine Zeichenfolge mit nicht-ASCII-Zeichen, unsicheren ASCII-Zeichen und codierten Leerzeichen.

Bereichsbezogenes GlideSystem – urlDecode(Zeichenfolgen-url)

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

Tabelle : 151. Parameter

Name	Typ	Beschreibung
URL	Zeichenfolge	UTF-8 Prozent (%) codierte Zeichen.

Tabelle : 152. Rückgaben

Typ	Beschreibung
Zeichenfolge	Codierte Zeichen durch ASCII-Zeichen ersetzt.

Bereichsbezogenes GlideSystem – Warnung(Zeichenfolgennachricht, Objektparm1, Objektparmm2, Objektparmm3, Objektparm4, Objektparm5)

Schreibt eine Warnmeldung in das Systemprotokoll.

Tabelle : 153. Parameter

Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Die Protokollnachricht mit Platzhaltern für beliebige Variablenargumente.
param1	Objekt	(Optional) erstes Variablenargument.
Parameter 2	Objekt	(Optional) zweites Variablenargument.
param3	Objekt	(Optional) drittes Variablenargument.
param4	Objekt	(Optional) Viertes Variablenargument.
param5	Objekt	(Optional) Fünftes Variablenargument.

Tabelle : 154. Rückgaben

Typ	Beschreibung
Ungültig

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

Bereichsbezogenes GlideSystem – xmlToJSON(Zeichenfolge xmlString)

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

Tabelle : 155. Parameter

Name	Typ	Beschreibung
XmlZeichenfolge	Zeichenfolge	Die zu konvertierende XML-Zeichenfolge.

Tabelle : 156. Rückgaben

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);

Bereichsbezogenes GlideSystem – yearsAgo (Anzahl Jahre)

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

Tabelle : 157. Parameter

Name	Typ	Beschreibung
years	Nummer	Eine ganze Anzahl von Jahren

Tabelle : 158. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT Anfang des Jahres, das der angegebenen Anzahl von Jahren entspricht, im Format JJJ-mm-tt hh:mm:ss.

Bereichsbezogenes GlideSystem – gestern()

Gibt die gestrige Zeit zurück (vor 24 Stunden).

Tabelle : 159. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 160. Rückgaben

Typ	Beschreibung
Zeichenfolge	Vor 24 Stunden GMT im Format JJJJ-mm-tt hh:mm:ss