GlideSystem : Bereichsbezogen

Die bereichsbezogene GlideSystem- API bietet eine Reihe von praktischen Methoden zum Abrufen von Informationen über das System, den aktuell angemeldeten Benutzer und andere Informationen auf Systemebene.

Viele der GlideSystem -Methoden erleichtern das Einbeziehen von Daten in Abfragebereiche und werden häufig für Filter und Berichte verwendet.

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

Typ	Beschreibung
void

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

Bereichsbezogenes GlideSystem – 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	Hinzuzufügende Infonachricht.

Tabelle : 4. Rückgaben

Typ	Beschreibung
void

if ((!current.u_date1.nil()) && (!current.u_date2.nil())) {
  var start = current.u_date1.getGlideObject().getNumericValue();
  var end = current.u_date2.getGlideObject().getNumericValue();
  if (start > end) {
    gs.addInfoMessage('start must be before end');
    current.u_date1.setError('start must be before end');
    current.setAbortAction(true);
  }
}

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

Typ	Beschreibung
Zeichenfolge	Codierte base64-Zeichenfolge.

Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

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

Scoped GlideSystem – base64Decode(String source)

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

Tabelle : 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 das 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 endet, lautet der Rückgabewert JJJJ-MM-TT 23:59:59. Format: jjjj-mm-tt hh:mm:ss

In diesem Beispiel wird dateGenerate() verwendet, um beim Abfragen von Datensätzen in der Incident-Tabelle das Startdatum festzulegen.

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 die richtige 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)

Stellt ein Ereignis im Ereignismanager in die Warteschlange.

Die übergebenen Ereigniszeitplaninformationen 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 in der Warteschlange.
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 eine Freiform und hängt von der Implementierung des Ereignisskripts ab. Standard: Wenn der Parameter instance ein GlideRecord-Objekt ist, ist der Standardwert der Anzeigewert für diesen GlideRecord (now_GR.getDisplayValue), andernfalls ist er null.
parm2	Zeichenfolge	Optional. Zeichenfolge, die an das Ereignisskript übergeben werden soll. Dieser Parameter ist eine Freiform und hängt von der Implementierung des Ereignisskripts ab. Standard: null
expiration	Objekt	Optional. GlideDateTime-Objekt oder ein Datums-/Uhrzeittypelement, das Datum und Uhrzeit für die Verarbeitung des Ereignisses angibt. Standard: Aktuelle(s) Datum/Uhrzeit

Tabelle : 62. Rückgaben

Typ	Beschreibung
void

Dieses Beispiel zeigt, wie die -Methode mit einem GlideRecord, zwei Parametern, die an das Ereignisskript übergeben werden, und einer angegebenen Zeit aufgerufen wird, um das Ereignis zu planen.

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

Typ	Beschreibung
Zeichenfolge	Gibt die sys_id der geplanten Aufgabe zurück. Gibt null zurück, wenn der Job global ist.

scheduleImportJob: function () {
  var jobId = '61847fe04c603300fa9bb64c2b491dac';
  var now_GR = new GlideRecord('sysauto_script');
  if (!now_GR.get(jobId)) {
    throw new Error('Unable to find import job');
  }
  gs.executeNow(now_GR);
}

Scoped GlideSystem – generateGUID()

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

Tabelle : 65. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 66. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Eine 32-stellige hexadezimale GUID.

Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

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

Ausgabe:

af770511ff013100e04bfffffffffff6

Scoped GlideSystem – getCallerScopeName()

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

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

Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

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

Ausgabe:

_d82979516f0171005be8883e6b3ee4cf&theme=

Scoped GlideSystem – getCurrentApplicationId()

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

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

Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

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

Ausgabe:

s_snc_test_scope

Bereichsbezogenes GlideSystem – getDateFormat(String)

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

Tabelle : 75. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 76. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Das Datumsformat, das dem aktuellen Anwender zugeordnet ist.

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

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

Ausgabe:

yyyy-MM-dd

Bereichsbezogenes GlideSystem – getDateTimeFormat()

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

Tabelle : 77. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 78. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Datums- und Uhrzeitformat, das dem aktuellen Anwender zugeordnet ist.

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

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, ersetzt sie durch die entsprechenden HTML-Namenscodes. 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 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 mit allen Sonderzeichen als Escape-Sequenzen 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 : 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 durch java.text.MessageFormat definierten Werten, 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 wird „{0}“ durch den Inhalt von current.action.nameersetzt. Hinweis: Die übergebenen Werte werden nicht übersetzt. Sie werden wortgetreu in die Nachricht eingefügt.

Tabelle : 82. Rückgaben

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

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 < und > transponiert 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 Anwenderoberflä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 Tabelle „Nachricht“ [sys_ui_message]. Beachten Sie, dass das Feld Schlüssel genau wie die tatsächliche Nachricht aussehen kann.
args	Array	Optional. Liste von Zeichenfolgen oder anderen durch java.text.MessageFormat definierten Werten, 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 wird „{0}“ durch den Inhalt von current.action.nameersetzt. Hinweis: Die übergebenen Werte werden nicht übersetzt. Sie werden wortgetreu in die Nachricht eingefügt.

Tabelle : 84. Rückgaben

Typ	Beschreibung
Zeichenfolge	UI-Nachricht

Dieses Beispiel zeigt die für den aktuellen Anwender zurückgegebene Nachricht, 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

In diesem Beispiel wird gezeigt, 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.

In diesem Beispiel wird gezeigt, 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.

Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

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

Ausgabe:

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

Scoped GlideSystem – getSession()

Ruft einen Verweis auf die aktuelle Glide-Sitzung ab.

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

Bereichsbezogenes GlideSystem – getTimeFormat()

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

Tabelle : 93. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 94. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Das dem aktuellen Anwender zugeordnete Zeitformat

Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

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

Ausgabe:

HH:mm:ss

Scoped GlideSystem – getTimeZoneName()

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

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

Tabelle : 95. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 96. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Der Name der Zeitzone.

Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

gs.info(gs.getTimeZoneName());

Scoped GlideSystem – getUrlOnStack()

Ruft den aktuellen URI für die Sitzung ab.

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

Eine Liste der verfügbaren Methoden finden Sie unter GlideUser - Bereichsbezogen.

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. Diese Methode gibt beispielsweise Abel Tuter und nicht abel.tuter zurück.

In diesem Beispiel wird der Anzeigename des aktuellen Anwenders abgerufen.

gs.info(gs.getUserDisplayName());

Ausgabe:

System Administrator

Scoped GlideSystem – getUserID()

Ruft die sys_id des aktuellen Benutzers ab.

Tabelle : 103. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 104. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Die sys_id des aktuellen Benutzers.

Das folgende Beispiel zeigt, wie Sie die Zuweisung aller aktiven Incident-Datensätze aufheben, 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 Anwendernamen des aktuellen Anwenders 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 anstelle von Abel Tuter zurück.

In diesem Beispiel wird der Anwendername des aktuellen Anwenders abgerufen.

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

Ausgabe:

The current user name is: admin

Scoped GlideSystem – hasRole(Object role)

Bestimmt, ob der aktuelle Benutzer die angegebene Rolle hat.

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

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 – minutesAgoEnd(Number minutes)

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

Tabelle : 127. Parameter

Name	Typ	Beschreibung
minutes	Nummer	Ganzzahl Anzahl der Minuten, z. B. 5 oder 126.

Tabelle : 128. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT der angegebenen Anzahl von Minuten vor, am Ende der Minute (59 Sekunden). Format: jjjj-mm-tt hh:mm:ss

Im folgenden Beispiel werden das aktuelle Datum und die aktuelle Uhrzeit sowie das Datum und die Uhrzeit vor 30 Minuten am Ende der Minute in GMT angezeigt.

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

Name	Typ	Beschreibung
minutes	Nummer	Ganzzahl Anzahl der Minuten, z. B. 15 oder 112.

Tabelle : 130. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT der angegebenen Anzahl von Minuten, zu Beginn der Minute. Format: jjjj-mm-tt hh:mm:ss

Im folgenden Beispiel werden das aktuelle Datum und die aktuelle Uhrzeit sowie das Datum und die Uhrzeit vor 30 Minuten zu Beginn der Minute in GMT angezeigt.

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

Ausgabe:

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

Scoped GlideSystem – monthsAgo(Number months)

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

Tabelle : 131. Parameter

Name	Typ	Beschreibung
months	Nummer	Ganzzahlige Anzahl von Monaten vor.

Tabelle : 132. Rückgaben

Typ	Beschreibung
Zeichenfolge	GMT der angegebenen Anzahl von Monaten zu genau diesem Zeitpunkt. Format: jjjj-mm-tt hh:mm:ss

Im folgenden Beispiel werden das aktuelle Datum und die aktuelle Uhrzeit sowie das Datum und die Uhrzeit vor einem Monat gleichzeitig in GMT angezeigt.

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 der Monate zurück, in Ortszeit. Format: UTC jjjj-mm-tt hh:mm:ss

Im folgenden Beispiel werden das aktuelle Datum und die aktuelle Uhrzeit sowie das Datum und die Uhrzeit vor zwei Monaten am Ende des Geschäftsmonats angezeigt.

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

Ausgabe:

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

Scoped GlideSystem – monthsAgoStart(Number months)

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

Tabelle : 135. Parameter

Name	Typ	Beschreibung
months	Nummer	Ganzzahlige Anzahl von 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

Im folgenden Beispiel werden das aktuelle Datum und die Uhrzeit sowie das Datum und die Uhrzeit vor drei Monaten in GMT angezeigt.

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

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

Tabelle : 138. Rückgaben

Typ	Beschreibung
Boolean	„True“, wenn das Objekt null oder undefiniert ist oder eine leere Zeichenfolge enthält. Andernfalls wird „false“ zurückgegeben.

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

Ausgabe

true

Scoped GlideSystem – quartersAgoEnd(Number quarters)

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

Tabelle : 139. Parameter

Name	Typ	Beschreibung
quarters	Zahl	Quartale als Ganzzahl

Tabelle : 140. 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 : 141. Parameter

Name	Typ	Beschreibung
quarters	Zahl	Quartale als Ganzzahl

Tabelle : 142. 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 : 143. 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 : 144. Ergebnisse

Typ	Beschreibung
void

Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

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

Ausgabe:

bar

Scoped GlideSystem – setRedirect(Object o)

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

Tabelle : 145. Parameter

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

Tabelle : 146. 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 : 147. Parameter

Name	Typ	Beschreibung
Name	Zeichenfolge	Name der zu überprüfenden Tabelle.

Tabelle : 148. Ergebnisse

Typ	Beschreibung
Boolean	„True“, wenn die Tabelle existiert. False, wenn die Tabelle nicht gefunden wurde.

In diesem Beispiel wird überprüft, ob die Tabellen „incident“ und „folo“ 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 : 149. Parameter

Name	Typ	Beschreibung
URL	Zeichenfolge	Die zu codierende Zeichenfolge.

Tabelle : 150. Rückgaben

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

Scoped GlideSystem – urlDecode(String url)

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

Tabelle : 151. Parameter

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

Tabelle : 152. Rückgaben

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 : 153. 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 : 154. 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 : 155. Parameter

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

Tabelle : 156. Ergebnisse

Typ	Beschreibung
Objekt	Ein JSON-Objekt, das die XML-Zeichenfolge darstellt. Null, wenn die XML-Zeichenfolge nicht verarbeitet werden kann.

Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

var jsonObject = gs.xmlToJSON(xmlString);

Scoped GlideSystem – yearsAgo(Number years)

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

Tabelle : 157. Parameter

Name	Typ	Beschreibung
years	Zahl	Anzahl der Jahre als Ganzzahl

Tabelle : 158. 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 : 159. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 160. Ergebnisse

Typ	Beschreibung
Zeichenfolge	GMT für die Zeit vor 24 Stunden im Format jjjj-mm-tt hh:mm:ss