GlideSystem – Global

GlideSystem – addErrorMessage(Object message)

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

Verwenden Sie getErrorMessages(), um eine Liste der aktuell angezeigten Fehlermeldungen abzurufen.

Tabelle : 1. Parameter
Name	Typ	Beschreibung
message	Objekt	Hinzuzufügende Meldung.

Tabelle : 2. Ergebnisse
Typ	Beschreibung
void

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

Bereichsbezogenes Äquivalent

Um die addErrorMessage()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: addErrorMessage().

GlideSystem – addHighMessage(Zeichenfolgennachricht)

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

Tabelle : 3. Parameter
Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Anzuzeigende Nachricht mit hoher Priorität.

Tabelle : 4. Rückgaben
Typ	Beschreibung
void

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

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

GlideSystem – addInfoMessage(Object message)

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

Verwenden Sie getInfoMessages(), um die Liste der angezeigten Informationsmeldungen abzurufen. Diese Methode wird für asynchrone Business Rules nicht unterstützt und kann nicht in Transformationsskripts verwendet werden.

Tabelle : 5. Parameter
Name	Typ	Beschreibung
message	Objekt	Hinzuzufügende Meldung.

Tabelle : 6. Ergebnisse
Typ	Beschreibung
void

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

Bereichsbezogenes Äquivalent

Um die addInfoMessage()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: addInfoMessage().

GlideSystem – addLowMessage(Zeichenfolgennachricht)

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

Tabelle : 7. Parameter
Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Anzuzeigende Nachricht mit niedriger Priorität.

Tabelle : 8. Rückgaben
Typ	Beschreibung
void

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

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

GlideSystem – addMessage(String type, Object message)

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

Tabelle : 9. Parameter
Name	Typ	Beschreibung
Typ	Zeichenfolge	Typ der Nachricht, z. B. `Fehler` Oder `Info` .
Nachricht	Objekt	Nachricht, die der aktuellen Sitzung hinzugefügt werden soll.

Tabelle : 10. Rückgaben
Typ	Beschreibung
void

GlideSystem – addModerateMessage(Zeichenfolgennachricht)

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

Tabelle : 11. Parameter
Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Meldung „Mittel“, die angezeigt werden soll.

Tabelle : 12. Rückgaben
Typ	Beschreibung
Keine

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

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

GlideSystem – addSuccessMessage(Zeichenfolgennachricht)

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

Tabelle : 13. Parameter
Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Anzuzeigende Erfolgsmeldung.

Tabelle : 14. Rückgaben
Typ	Beschreibung
void

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

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

GlideSystem – beginningOfLastMonth()

Ruft das Datum und die Uhrzeit für den Beginn des letzten Monats in GMT ab.

Tabelle : 15. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 16. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Beginn des letzten Monats im Format jjjj-mm-tt hh:mm:ss.

In diesem Beispiel werden Datum und Uhrzeit des GlideDateTime-Objekts auf den Anfang des letzten Monats festgelegt.

var date = new GlideDate();
date.setValue(gs.beginningOfLastMonth());
var dateasint = date.toString().replace('-','');
gs.print(dateasint);

Bereichsbezogenes Äquivalent

Um die beginningOfLastMonth()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: beginningOfLastMonth().

GlideSystem – beginningOfLastWeek()

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

Tabelle : 17. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 18. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT Anfang der letzten Woche. Format: jjjj-mm-TT hh:mm:ss

In diesem Beispiel wird der Wert des aktuellen Glide-Datums-/-Uhrzeitdatensatzes auf den Anfang der letzten Woche festgelegt.

var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfLastWeek());

Bereichsbezogenes Äquivalent

Um die beginningOfLastWeek()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: beginningOfLastWeek().

GlideSystem – beginningOfNextWeek()

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

Tabelle : 19. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 20. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT Anfang der nächsten Woche. Format: jjjj-mm-TT hh:mm:ss

In diesem Beispiel wird der Wert des aktuellen Glide-Datums-/-Uhrzeitdatensatzes auf den Anfang der nächsten Woche festgelegt.

var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfNextWeek());

Bereichsbezogenes Äquivalent

Um die beginningOfNextWeek()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: beginningOfNextWeek().

GlideSystem – beginningOfNextMonth()

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

Tabelle : 21. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 22. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT Anfang des nächsten Monats. Format: jjjj-mm-TT hh:mm:ss

In diesem Beispiel wird der Wert des aktuellen Glide-Datums-/-Uhrzeitdatensatzes auf den Anfang des nächsten Monats festgelegt.

var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfNextMonth());

Bereichsbezogenes Äquivalent

Um die beginningOfNextMonth()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: beginningOfNextMonth().

GlideSystem – beginningOfNextYear()

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

Tabelle : 23. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 24. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Die GMT Anfang nächsten Jahres im Format jjjj-mm-tt hh:mm:ss.

In diesem Beispiel wird der Wert des aktuellen Glide-Datums-/-Uhrzeitdatensatzes auf den Anfang des nächsten Jahres festgelegt.

var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfNextYear());

Bereichsbezogenes Äquivalent

Um die beginningOfNextYear()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: beginningOfNextYear().

GlideSystem – beginningOfThisMonth()

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

Tabelle : 25. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 26. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT Anfang des aktuellen Monats. Format: jjjj-mm-TT hh:mm:ss

In diesem Beispiel wird der Wert des aktuellen Glide-Datums-/-Uhrzeitdatensatzes auf den Anfang dieses Monats festgelegt.

var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfThisMonth());

Bereichsbezogenes Äquivalent

Um die beginningOfThisMonth()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: beginningOfThisMonth().

GlideSystem – beginningOfThisQuarter()

Gibt Datum und Uhrzeit für den Beginn des aktuellen Quartals in GMT zurück.

Tabelle : 27. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 28. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Beginn des aktuellen Quartals. Format: jjjj-mm-TT hh:mm:ss

In diesem Beispiel wird der Wert des aktuellen Glide-Datums-/-Uhrzeitdatensatzes auf den Beginn des aktuellen Quartals festgelegt.

var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfThisQuarter());

Bereichsbezogenes Äquivalent

Um die beginningOfThisQuarter()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: beginningOfThisQuarter().

GlideSystem – beginningOfThisWeek()

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

Tabelle : 29. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 30. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT Anfang der aktuellen Woche. Format: jjjj-mm-TT hh:mm:ss

In diesem Beispiel wird der Wert des aktuellen Glide-Datums-/-Uhrzeitdatensatzes auf den Beginn der aktuellen Woche festgelegt.

var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfThisWeek());

Bereichsbezogenes Äquivalent

Um die beginningOfThisWeek()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: beginningOfThisWeek().

GlideSystem – beginningOfThisYear()

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

Tabelle : 31. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 32. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT Anfang des aktuellen Jahres. Format: jjjj-mm-TT hh:mm:ss

In diesem Beispiel wird der Wert des aktuellen Glide-Datums-/-Uhrzeitdatensatzes auf den Beginn des aktuellen Jahres festgelegt.

var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfThisYear());

Bereichsbezogenes Äquivalent

Um die beginningOfThisYear()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: beginningOfThisYear().

GlideSystem – beginningOfToday()

Ruft das Datum und die Uhrzeit für den Beginn des heutigen Tages in GMT ab.

Tabelle : 33. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 34. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT – Beginn des aktuellen Tages. Format: jjjj-mm-TT hh:mm:ss

In diesem Beispiel wird der Wert des aktuellen Glide-Datums-/-Uhrzeitdatensatzes auf den Beginn des aktuellen Tages festgelegt.

var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfToday());

GlideSystem – beginningOfTomorrow()

Ruft den (UTC) Beginn des morgigen Tages ab, angepasst an die Zeitzone der aktuellen Sitzung.

Tabelle : 35. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 36. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT Anfang morgen. Format: jjjj-mm-TT hh:mm:ss

var today = new GlideDateTime(gs.beginningOfTomorrow()).getNumericValue();

GlideSystem – beginningOfYesterday()

Ruft das Datum und die Uhrzeit für den Beginn von gestern in GMT ab.

Tabelle : 37. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 38. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Beginn des gestrigen Tages, im Format jjjj-mm-tt hh:mm:ss.

var start = new GlideDateTime();
start.setValue(gs.beginningOfYesterday());

GlideSystem – calDateDiff(String startDate, String endDate, Boolean numericValue)

Berechnen Sie die Differenz zwischen zwei Datumsangaben mit dem Standardkalender.

Die Kalender sind jetzt veraltet. Wenn Zeitpläne verwendet werden, lesen Sie den Abschnitt „während eines bestimmten Zeitplans berechnen“ des Themas Anwendungsfälle des Zeitplanungsskripts.

Tabelle : 39. Parameter
Name	Typ	Beschreibung
startDate	Zeichenfolge	Startdatum, das im Datumsformat des aktuellen Anwenders verglichen werden soll.
endDate	Zeichenfolge	Enddatum, das im Datumsformat des aktuellen Anwenders verglichen werden soll.
numericValue	Boolean	Kennzeichnung, die das Format des zurückgegebenen Zeitwerts angibt. Gültige Werte: Wahr: Der Rückgabewert wird in Sekunden formatiert Falsch: Der Rückgabewert ist „ddd hh:mm:ss“ formatiert.

Tabelle : 40. Rückgaben
Typ	Beschreibung
Zeichenfolge	Wenn numericValueDer Parameter ist „wahr“ und gibt die Differenz zwischen den beiden Daten als Ganzzahl von Sekunden zurück. Bei „falsch“ wird die Differenz zwischen den beiden Daten im Format „ddd hh:mm:ss“ zurückgegeben.

var endDateTime = gs.nowDateTime();
gs.print('--- Total records: ' + countRecordsTotal);
gs.print('--- End time: ' + endDateTime);
gs.print('Time diff: ' + gs.calDateDiff(startDateTime, endDateTime));

GlideSystem – dateDiff(String startDate, String endDate, Boolean numericValue)

Berechnet die Differenz zwischen zwei Datumsangaben.

Diese Methode erwartet das frühere Datum als ersten Parameter und das spätere Datum als zweiten Parameter. Andernfalls gibt die Methode die Differenz als negativen Wert zurück. Verwenden Sie getDisplayValue(), um die Zeichenketten in das erwartete Format zu konvertieren.

Diese Methode erwartet Parameter im Datum-/Uhrzeit-Format des Benutzers/Systems, die möglicherweise nicht mit dem internen Format übereinstimmen. Die Verwendung von Parametern in anderen Formaten als dem Datum-/Uhrzeit-Format des Benutzers/Systems kann zu ungültigen Ergebnissen führen.

Wenn Sie mit GlideDateTime-Objekten arbeiten, verwenden Sie die GlideDateTime-Methode subtract() statt dateDiff().

Tabelle : 41. Parameter
Name	Typ	Beschreibung
startDate	Zeichenfolge	Zu vergleichendes Startdatum im Datumsformat des aktuellen Benutzers.
endDate	Zeichenfolge	Zu vergleichendes Enddatum im Datumsformat des aktuellen Benutzers.
numericValue	Boolean	Bei „true“ wird der Rückgabewert in Sekunden formatiert. Bei „false“ wird der Rückgabewert wie folgt formatiert: ddd hh:mm:ss.

Tabelle : 42. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Wenn der numericValue-Parameter den Wert „true“ hat, wird die Differenz zwischen den beiden Datumsangaben als Ganzzahl an Sekunden zurückgegeben. Bei „false“ wird die Differenz zwischen den beiden Datumsangaben im Format ddd hh:mm:ss zurückgegeben.

// Given two date/times as DateTime objects
// Set the values this way to ensure a consistent input time
var date1 = new GlideDateTime();
var date2 = new GlideDateTime();
date1.setDisplayValueInternal('2014-01-01 12:00:00');
date2.setDisplayValueInternal('2014-01-01 13:00:00');
 
// Determine the difference as number of seconds (returns a string)
// Use getDisplayValue() to convert the string to the format expected by dateDiff()
var diffSeconds = gs.dateDiff(date1.getDisplayValue(), date2.getDisplayValue(), true);
 
// JavaScript will coerce diffSeconds from a string to a number
// since diffSeconds is being compared to a number
var msg = (diffSeconds <= 0) ? ' is on or after ' : ' is before ';
gs.print(date1.getDisplayValue() + msg + date2.getDisplayValue())

GlideSystem – dateGenerate(String date, String range)

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

Tabelle : 43. Parameter
Name	Typ	Beschreibung
date	Zeichenfolge	Datum, das in GMT generiert werden soll. Format: jjjj-mm-tt
range	Zeichenfolge	Start, Ende oder eine Zeit. Format: 24-Stunden hh:mm:ss

Tabelle : 44. 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 DatumGenerate() Zum Festlegen des Startdatums beim Abfragen von Datensätzen in der Incident-Tabelle.

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

Ausgabe:

Count: 7

Bereichsbezogenes Äquivalent

Um die dateGenerate()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: dateGenerate().

GlideSystem – daysAgo(Number days)

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

Tabelle : 45. Parameter
Name	Typ	Beschreibung
days	Zahl	Anzahl der Tage

Tabelle : 46. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT der angegebenen Anzahl von Tagen. 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 Äquivalent

Um die daysAgo()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: daysAgo().

GlideSystem – daysAgoEnd(Number days)

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

Tabelle : 47. Parameter
Name	Typ	Beschreibung
days	Zahl	Ganzzahl von Tagen

Tabelle : 48. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Ende des Tages im Format jjjj-mm-tt hh:mm:ss.

Dieses Beispiel zeigt mit DaysAgoEnd() Zum Festlegen des Enddatums 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.addInfoMessage("Count: " +tableData.getRowCount());

Bereichsbezogenes Äquivalent

Um die daysAgoEnd()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: daysAgoEnd().

GlideSystem – daysAgoLocal(Number days)

Gibt das Datum und die Uhrzeit des Beginns des Tages für die angegebene Anzahl von zurückliegenden Tagen zurück. Das zurückgegebene Datum und die zurückgegebene Uhrzeit beziehen sich auf die Zeitzone der aktuellen Sitzung (Ortszeit).

Tabelle : 49. Parameter
Name	Typ	Beschreibung
days	Zahl	Anzahl der zurückliegenden Tage

Tabelle : 50. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Lokales Datum und lokale Uhrzeit für den Beginn des Tages im benutzerdefinierten Datum-/Uhrzeit-Format. Wenn das Datum-/Uhrzeit-Format nicht vom ursprünglichen Wert abweicht, lautet das Format jjjj-mm-tt hh:mm:ss.

if (due_in == "1 Day") {
  dd = gs.daysAgoLocal(-1);
}
if (due_in == "1 Week") {
  dd = gs.daysAgoLocal(-7);
}

GlideSystem – daysAgoStart(Number days)

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

Tabelle : 51. Parameter
Name	Typ	Beschreibung
days	Zeichenfolge	Ganzzahl von Tagen

Tabelle : 52. 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();

Bereichsbezogenes Äquivalent

Um die daysAgoStart()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: daysAgoStart().

GlideSystem – endOfLastMonth()

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

Tabelle : 53. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 54. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT vom Ende des letzten Monats. Format: jjjj-mm-TT hh:mm:ss

Dieses Beispiel zeigt, wie ein Berichtsdatensatz vom letzten Tag des letzten Monats abgefragt wird.

var month = gs.endOfLastMonth();
var monthd = new GlideDateTime(month);
monthd.addDays(-1);

var queueLast = new GlideRecord('u_amazon_connect_phone_metrics');
queueMtd.addQuery('u_queue_name',queueNames[i]);
queueMtd.addEncodedQuery('u_time_range=MTD');
queueMtd.addEncodedQuery('u_report_date'+ monthd);
queueMtd.orderByDesc('u_report_date');
        
queueMtd.query();

if(queueMtd.next()){
  gs.info(queueMtd.u_report_date);
}

Bereichsbezogenes Äquivalent

Um die endOfLastMonth()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: endOfLastMonth().

GlideSystem – endOfLastWeek()

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

Tabelle : 55. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 56. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT Ende der letzten Woche. Format: jjjj-mm-TT hh:mm:ss

Dieses Beispiel zeigt, wie Datensätze abgefragt werden, die in der letzten Woche des Vormonats geöffnet wurden.

var inc = new GlideRecord('incident');
inc.addQuery('active=true^priority=1^opened_atONLast month@javascript:gs.beginningOfLastMonth()@javascript:gs.endOfLastMonth()^opened_atONLast week@javascript:gs.beginningOfLastWeek()@javascript:gs.endOfLastWeek()');
inc.query();
while(inc.next())
 {
   gs.addInfoMessage(inc.getRowCount());
 }

Bereichsbezogenes Äquivalent

Um die endOfLastWeek()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: endOfLastWeek().

GlideSystem – endOfLastYear()

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

Tabelle : 57. Parameter
Name	Typ	Beschreibung
Keine

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

Dieses Beispiel zeigt, wie Datensätze abgefragt werden, die für alle im letzten Jahr erstellten Datensätze erstellt wurden.

var inc = new GlideRecord('incident');
inc.addEncodedQuery('sys_created_onONLast year@javascript:gs.beginningOfLastYear()@javascript:gs.endOfLastYear()');
inc.query();
while(inc.next()){
  inc.assignment_group = "d625dccec0a8016700a222a0f7900d06";
  inc.update();
}

Bereichsbezogenes Äquivalent

Um die endOfLastYear()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: endOfLastYear().

GlideSystem – endOfNextMonth()

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

Tabelle : 59. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 60. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Daten und -Zeit. Formatieren Sie JJJJ-mm-TT hh:mm:ss

Dieses Beispiel zeigt, wie KB-Wissensdatensätze abgefragt werden, die seit Anfang heute bis Ende des nächsten Monats erstellt wurden.

var query = "kb_knowledge_base=e81c9a0ddbc15810c38f0763b99619c1^ORkb_knowledge_base=21302e89db055810c38f0763b99619cc^valid_toBETWEENjavascript:gs.beginningOfToday()@javascript:gs.endOfNextMonth()^ORworkflow_state=pending_retirement^latest=true";
var rec = new GlideRecord('kb_knowledge');
rec.addEncodedQuery(query);
rec.addQuery('author', current.author);
rec.query();
while (rec.next()) {
  var Kbtitle = rec.getValue('short_description');
  articles.push(rec.number.toString()+ '' + Kbtitle);
  template.print('Click here to view record<a href="https://give urs instance url here/nav_to.do?uri=kb_knowledge.do?sys_id=' + rec.sys_id + '">' + rec.number + '</a>');
}
var articlesList = "<ul>";
for (i = 0; i <= articles.length-1; i++) {
  articlesList = articlesList + "<li>" + articles[i] + "</li>";
}
articlesList = articlesList + "</ul>";

Bereichsbezogenes Äquivalent

Um die endOfNextMonth()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: endOfNextMonth().

GlideSystem – endOfNextWeek()

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

Tabelle : 61. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 62. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Datum und -Uhrzeit für Ende der nächsten Woche. Formatieren Sie JJJJ-mm-TT hh:mm:ss

Dieses Beispiel zeigt die Verwendung EndOfNextWeek() In einer Abfrage, um alle Besucher in der letzten Woche abzurufen.

var title = 'Visitors arriving this Week';
var visitorQuery = 'active=true^category=visitor_request^u_my_start_dateONThis week@javascript:gs.beginningOfThisWeek()@javascript:gs.endOfNextWeek()';

Bereichsbezogenes Äquivalent

Um die endOfNextWeek()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: endOfNextWeek().

GlideSystem – endOfNextYear()

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

Tabelle : 63. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 64. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Datum und -Uhrzeit für Ende des nächsten Jahres. Format: jjjj-mm-TT hh:mm:ss

Dieses Beispiel zeigt die Verwendung EndOfNextYear() Um das GlideDateTime-Objekt auf das Ende des nächsten Jahres festzulegen.

setEndDate : function(dt) {
  var gdt2 = new GlideDateTime(dt);
  gdt2.setValue(gs.endOfNextYear());
}

Bereichsbezogenes Äquivalent

Um die endOfNextYear()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: endOfNextYear().

GlideSystem – endOfThisMonth()

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

Tabelle : 65. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 66. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Datum und -Uhrzeit für Ende dieses Monats. Formatieren Sie JJJJ-mm-TT hh:mm:ss

Dieses Beispiel zeigt die Verwendung EndOfThisMonth() Um das GlideDateTime-Objekt auf das Ende des aktuellen Monats festzulegen.

setEndDate : function(dt) {
  var gdt2 = new GlideDateTime(dt);
  gdt2.setValue(gs.endOfThisMonth());
}

Bereichsbezogenes Äquivalent

Um die endOfThisMonth()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: endOfThisMonth().

GlideSystem – endOfThisQuarter()

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

Tabelle : 67. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 68. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Datum und -Uhrzeit für das Ende dieses Quartals. Format: jjjj-mm-TT hh:mm:ss

Dieses Beispiel zeigt die Verwendung EndOfThisQuarter() Um das GlideDateTime-Objekt auf das Ende des aktuellen Monats festzulegen.

setEndDate : function(dt) {
  var gdt2 = new GlideDateTime(dt);
  gdt2.setValue(gs.endOfThisQuarter());
}

Bereichsbezogenes Äquivalent

Um die endOfThisQuarter()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: endOfThisQuarter().

GlideSystem – endOfThisWeek()

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

Tabelle : 69. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 70. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Datum und -Uhrzeit für Ende dieser Woche. Format: jjjj-mm-TT hh:mm:ss

Dieses Beispiel zeigt die Verwendung EndOfThisWeek() Um das GlideDateTime-Objekt auf das Ende des aktuellen Monats festzulegen.

setEndDate : function(dt) {
  var gdt2 = new GlideDateTime(dt);
  gdt2.setValue(gs.endOfThisWeek());
}

Bereichsbezogenes Äquivalent

Um die endOfThisWeek()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: endOfThisWeek().

GlideSystem – endOfThisYear()

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

Tabelle : 71. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 72. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Datum und -Uhrzeit für Ende dieses Jahres. Formatieren Sie JJJJ-mm-TT hh:mm:ss

Dieses Beispiel zeigt die Verwendung EndOfThisYear() Um das GlideDateTime-Objekt auf das Ende des aktuellen Monats festzulegen.

setEndDate : function(dt) {
  var gdt2 = new GlideDateTime(dt);
  gdt2.setValue(gs.endOfThisYear());
}

Bereichsbezogenes Äquivalent

Um die endOfThisYear()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: endOfThisYear().

GlideSystem – endOfToday()

Ruft das Datum und die Uhrzeit für das Ende des heutigen Tages in GMT ab.

Tabelle : 73. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 74. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT im Format jjjj-mm-tt hh:mm:ss.

var beginToday = gs.beginningOfToday(); 
        var endToday = gs.endOfToday(); 
        var beginTomorrow = gs.beginningOfTomorrow(); 
        var endTomorrow = gs.endOfTomorrow(); 
        var beginYesterday = gs.beginningOfYesterday(); 
        var endYesterday = gs.endOfYesterday(); 
        
        gs.info('beginningOfToday: ' + beginToday); 
        gs.info('endOfToday: ' + endToday); 
        gs.info('-----------'); 
        gs.info('beginningOfTomorrow: ' + beginTomorrow); 
        gs.info('endOfTomorrow: ' + endTomorrow); 
        gs.info('beginningOfYesterday: ' + beginYesterday); 
        gs.info('endOfYesterday: ' + endYesterday); 
        gs.info('-----------'); 
        var gdt1 = new GlideDateTime(beginToday); 
        var gdt2 = new GlideDateTime(beginTomorrow); 
        var dur = GlideDateTime.subtract(gdt1, gdt2); //the difference between gdt1 and gdt2 
        gs.info('BeginTomorrow: ' + dur.getDisplayValue()); 
        
        var gdt1 = new GlideDateTime(endToday); 
        var gdt2 = new GlideDateTime(endTomorrow); 
        var dur = GlideDateTime.subtract(gdt1, gdt2); //the difference between gdt1 and gdt2 
        gs.info('EndTomorrow: ' + dur.getDisplayValue()); 
        
        var gdt1 = new GlideDateTime(beginToday); 
        var gdt2 = new GlideDateTime(beginYesterday); 
        var dur = GlideDateTime.subtract(gdt2, gdt1); //the difference between gdt1 and gdt2 
        gs.info('BeginningYesterday: ' + dur.getDisplayValue()); 
        
        var gdt1 = new GlideDateTime(endToday); 
        var gdt2 = new GlideDateTime(endYesterday); 
        var dur = GlideDateTime.subtract(gdt2, gdt1); //the difference between gdt1 and gdt2 
        gs.info('EndYesterday: ' + dur.getDisplayValue());

GlideSystem – endOfTomorrow()

Ruft das Datum und die Uhrzeit für das Ende des morgigen Tages in GMT ab.

Tabelle : 75. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 76. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT im Format jjjj-mm-tt hh:mm:ss.

var tomorrowEnd = new GlideDateTime();
tomorrowEnd.setValue(gs.endOfTomorrow());

GlideSystem – endOfYesterday()

Ruft das Datum und die Uhrzeit für das Ende von gestern in GMT ab.

Tabelle : 77. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 78. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT im Format (jjjj-mm-tt hh:mm:ss).

var yesterdayEnd = new GlideDateTime();
yesterdayEnd.setValue(gs.endOfYesterday());

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

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

Tabelle : 79. Parameter
Name	Typ	Beschreibung
Name	Zeichenfolge	Name des Events, das in die Warteschlange gestellt wird.
glideRecord	Objekt	GlideRecord-Objekt wie „current“.
parm1	Zeichenfolge	(Optional) Mit der Instanz gespeichert, falls angegeben.
parm2	Zeichenfolge	(Optional) Mit der Instanz gespeichert, falls angegeben.
queue	Zeichenfolge	Name der Warteschlange.

Tabelle : 80. Ergebnisse
Typ	Beschreibung
void

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

Bereichsbezogenes Äquivalent

Um die eventQueue()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: eventQueue().

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

Reiht ein Event für den Event-Manager zu einem bestimmten Datum und einer Uhrzeit in die Warteschlange ein.

Tabelle : 81. Parameter
Name	Typ	Beschreibung
Name	Zeichenfolge	Name des Events, das in die Warteschlange gestellt wird.
glideRecord	Objekt	GlideRecord-Objekt wie „current“.
parm1	Zeichenfolge	(Optional) Mit der Instanz gespeichert, falls angegeben.
parm2	Zeichenfolge	(Optional) Mit der Instanz gespeichert, falls angegeben.
expiration	Objekt	Datum und Uhrzeit für die Verarbeitung dieses Ereignisses.

Tabelle : 82. Ergebnisse
Typ	Beschreibung
void

if (current.operation() != 'insert' && current.comments.changes()) {
    gs.eventQueueScheduled("incident.commented", current, gs.getUserID(), gs.getUserName(), new GlideDateTime('2018-06-02 20:00:00'));
}

Bereichsbezogenes Äquivalent

Um die eventQueueScheduled()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: eventQueueScheduled().

GlideSystem – flushMessages()

Löscht Sitzungsmeldungen, die mit addErrorMessage() oder addInfoMessage() gespeichert wurden.

Sitzungsmeldungen werden oben im Formular angezeigt. Verwenden Sie in clientseitigen Skripts g_form.clearMessages(), um Sitzungsmeldungen zu entfernen.

Tabelle : 83. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 84. Ergebnisse
Typ	Beschreibung
void

Dieses Beispiel zeigt, wie Fehlermeldungen analysiert und zurückgegeben werden und die Nachrichten dann mit gelöscht werden FlushMessages() .

MySessionUtil.getSessionError = function() {
  var msg = null;
  var msgs = gs.getErrorMessages().toArray();
  if (msgs.length > 0) {
    msg = msgs[0] + '';
    gs.flushMessages();
  }
  return msg;
};

GlideSystem – getAvatar()

Gibt den Dateipfad zum Avatar des Benutzers zurück.

Tabelle : 85. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 86. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Dateipfad zum Avatar des Benutzers.

var avatarFile = gs.getUser().getAvatar();        
gs.addInfoMessage('User avatar ID: ' + avatarFile);

Ausgabe:

User avatar ID: c148e1d13741310042106710ce41f149.iix?t=small

GlideSystem – getCurrentScopeName()

Gibt den Namen des aktuellen Anwendungsbereichs zurück.

Tabelle : 87. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 88. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Name des aktuellen Umfangs.

Dieses Beispiel zeigt die Verwendung GetCurrentScopeName() Um den Umfang des Prozessors abzurufen.

var incident_GR = new GlideRecord('Incident');

if (incident_GR.get("2e3f6baddb9ad600added8fdbf9618cb")) {
  gs.debug("processor scope = "+ gs.getCurrentScopeName());
  var w = new global.Workflow();
  var context = w.startFlow('1f4a4baddb9ad600affed8fdbf9619bc', incident_GR, "update");   //id = id workflow
}

Bereichsbezogenes Äquivalent

Um die getCurrentScopeName()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getCurrentScopeName().

GlideSystem – getDateFormat()

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

Tabelle : 89. Parameter
Name	Typ	Beschreibung
Keine

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

GlideSystem – getDateTimeFormat()

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

Tabelle : 91. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 92. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Das Datums- und Uhrzeitformat, das dem aktuellen Anwender zugeordnet ist.

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

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

Ausgabe:

yyyy-MM-dd HH:mm:ss

GlideSystem – getDisplayColumn(String tableName)

Ruft die Anzeigespalte für die Tabelle ab.

Tabelle : 93. Parameter
Name	Typ	Beschreibung
tableName	Zeichenfolge	Name der Tabelle, aus der der Name der Anzeigespalte abgerufen werden soll.

Tabelle : 94. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Anzeigename der Spalte

// Return the sys_id value for a given table and its display value
function GetIDValue(table, displayValue) { 
    var rec = new GlideRecord(table);
    var dn = gs.getDisplayColumn(table);
    if (rec.get(dn, displayValue))
        return rec.sys_id;
    else
        return null;
}

GlideSystem – getDisplayValueFor(String tableName, String recordID, String fieldName)

Gibt den Anzeigewert für ein angegebenes Feld in einem angegebenen Datensatz zurück.

Tabelle : 95. Parameter
Name	Typ	Beschreibung
tableName	Zeichenfolge	Name der Tabelle.
recordID	Zeichenfolge	SYS_ID für den Datensatz.
fieldName	Zeichenfolge	Name des Felds, dessen Anzeigewert zurückgegeben werden soll.

Tabelle : 96. Rückgaben
Typ	Beschreibung
Zeichenfolge	Anzeigewert für das Feld.

Dieses Beispiel zeigt die Verwendung GetDisplayValueFor() Um den Anzeigewert von zurückzugeben Nummer Feld.

var value = gs.getDisplayValueFor(current.getTableName(),current.getValue('sys_id'),'number');

GlideSystem – getErrorMessages()

Gibt die Liste der Fehlermeldungen für die Sitzung zurück, die von addErrorMessage() hinzugefügt wurden.

Tabelle : 97. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 98. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Liste der Fehlermeldungen

Dieses Beispiel zeigt, wie Fehlermeldungen mit analysiert und zurückgegeben werden GetErrorMessages() .

MySessionUtil.getSessionError = function() {
  var msg = null;
  var msgs = gs.getErrorMessages().toArray();
  if (msgs.length > 0) {
    msg = msgs[0] + '';
    gs.flushMessages();
  }
  return msg;
};

Bereichsbezogenes Äquivalent

Um die getErrorMessages()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getErrorMessages().

GlideSystem – getEscapedProperty(String key, Object substituteObject)

Ruft die Eigenschaft ab und versieht sie für die XML-Analyse mit Escape-Zeichen.

Tabelle : 99. Parameter
Name	Typ	Beschreibung
key	Zeichenfolge	Schlüssel für die Eigenschaft, deren Wert zurückgegeben werden soll.
substituteObject	Objekt	Optional. Objekt, das zurückgegeben werden soll, wenn die Eigenschaft nicht gefunden wird.

Tabelle : 100. Rückgaben
Typ	Beschreibung
Zeichenfolge	Eigenschaft oder substituteObject, wenn die Eigenschaft nicht gefunden wird.

var propValue = gs.getEscapedProperty("com.example.my_test_property");
gs.addInfoMessage("This is my property value " + propValue);

GlideSystem – getImpersonatingUserDisplayName()

Gibt den Anzeigenamen des Benutzers zurück, der eine andere Identität annimmt.

Tabelle : 101. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 102. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Anzeigename des Anwenders, dessen Identität angenommen wird.

Dieses Beispiel zeigt, wie der Anzeigename des Anwenders des Identitätswechsels abgerufen wird.

var user = gs.getUserDisplayName();
gs.print ("The current user display name is: " + user);

var name = gs.getImpersonatingUserDisplayName(); 
gs.print("Impersonating user display name: " + name);

Ausgabe:

The current user display name is: abel.tuter
Impersonating user display name: admin

GlideSystem – getImpersonatingUserName()

Gibt den Namen des Benutzers, der eine andere Identität annimmt, oder NULL zurück, wenn dies nicht erfolgt.

Tabelle : 103. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 104. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Name des Benutzers, der eine andere Identität annimmt

Dieses Beispiel zeigt, wie der Anwendername des Identitätswechsels abgerufen wird.

var name = gs.getImpersonatingUserName();
var actual_user = null;
if (name == null || name == '')
  actual_user = user;
else
  actual_user = Packages.com.glide.sys.User.getUser(name);

var recent_impersonations = actual_user.getPreference('recent.impersonations');
var admin_role=actual_user.hasRole("admin");

GlideSystem – getInfoMessages()

Ruft die Liste der Informationsmeldungen für die Sitzung ab, die von addInfoMessage() hinzugefügt wurden.

Tabelle : 105. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 106. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Liste der Infonachrichten.

Dieses Beispiel zeigt, wie die Informationsnachrichten abgerufen werden.

var messages = gs.getInfoMessages();
if (messages.toString().indexOf('Conflicts Detected') == -1)
  gs.addInfoMessage(msg);

GlideSystem – getInitials()

Gibt die Initialen des Benutzers zurück.

Tabelle : 107. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 108. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Initialen des Benutzers.

var userInitials = gs.getUser().getInitials();        
gs.addInfoMessage('User initials: ' + userInitials);

Ausgabe:

User initials: SA

GlideSystem – getMessage(String messageID, Object args)

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

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

Weitere Informationen zur Nachrichtentabelle finden Sie unter Nachrichtentabelle .

Hinweis:

Wenn die UI-Meldung ein Häkchen (') hat, können Probleme mit der Meldung im Skript auftreten. Um Häkchen (') mit Escape-Zeichen versehen, verwenden Sie getMessageS(String, Object).

Tabelle : 109. Parameter
Name	Typ	Beschreibung
Nachrichten-ID	Zeichenfolge	Nachrichtenbezeichner. Sie können diesen Wert im Feld Schlüssel der Tabelle Nachricht [sys_ui_message] suchen. Beachten Sie, dass das Feld „Schlüssel“ genau wie die tatsächliche Nachrichtenzeichenfolge aussieht.
args	Objekt	Optional. Liste von Zeichenfolgen oder anderen Werten, die durch Java.Text.MessageFormat definiert sind und die Variablen innerhalb der angegebenen Nachricht ersetzen. Beispiel: `gs.getMessage(„Hinzufügen der Aktion „{0}“ abbrechen, derselbe Subflow kann in diesem Subflow nicht zweimal hinzugefügt werden.“, current.action.name);` In diesem Beispiel `„{0}“` Wird durch den Inhalt von ersetzt `current.action.name` . Hinweis: Die übergebenen Werte werden nicht übersetzt. Sie werden wörtlich in die Nachricht eingefügt.

Tabelle : 110. Rückgaben
Typ	Beschreibung
Zeichenfolge	Angeforderte 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.getMessage("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 Äquivalent

Um die getMessage()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getMessage().

GlideSystem – getMessageS(String messageID, Object args)

Ruft übersetzte Meldungen zur Anzeige in der UI ab und versieht alle Häkchen (') mit Escape-Zeichen.

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

Weitere Informationen zur Nachrichtentabelle finden Sie unter Nachrichtentabelle .

Nützlich, wenn Sie aus Jelly einen JavaScript-Ausdruck einfügen.

Tabelle : 111. Parameter
Name	Typ	Beschreibung
MessageID	Zeichenfolge	Nachrichtenbezeichner. Sie können diesen Wert im Feld Schlüssel der Tabelle Nachricht [sys_ui_message] suchen. Beachten Sie, dass das Feld „Schlüssel“ genau wie die tatsächliche Nachrichtenzeichenfolge aussieht.
args	Objekt	Optional. Liste von Zeichenfolgen oder anderen Werten, die durch Java.Text.MessageFormat definiert sind und die Variablen innerhalb der angegebenen Nachricht ersetzen. Beispiel: `gs.getMessage(„Hinzufügen der Aktion „{0}“ abbrechen, derselbe Subflow kann in diesem Subflow nicht zweimal hinzugefügt werden.“, current.action.name);` In diesem Beispiel `„{0}“` Wird durch den Inhalt von ersetzt `current.action.name` . Hinweis: Die übergebenen Werte werden nicht übersetzt. Sie werden wörtlich in die Nachricht eingefügt.

Tabelle : 112. Rückgaben
Typ	Beschreibung
Zeichenfolge	Angegebene Nachricht mit Escape-Zeichen.

/*
"I love France" translates to "J'aime la France" in French.
Rendering this without escaping the tick in "J'aime" would break Jelly, because 
the tick would prematurely end the variable assignment, and everything that 
follows (aime la France') would be a jelly syntax error.
*/
var my_message = '${gs.getMessageS("I love France")}'; 
alert(my_message);

Ausgabe:

J'aime la France

GlideSystem – getMessageLang(Zeichenfolgennachricht, Zeichenfolgensprache, Array-Argumente)

Übersetzt die angegebene Nachricht in die angegebene Sprache.

Sie können Variablen auch in die übergebene Nachricht einbetten. Die Methode löst diese Variablen mit den in übergebenen Werten auf argsArray.

Tabelle : 113. Parameter
Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Zu übersetzende Nachricht.
language	Zeichenfolge	Sprache, in die die Nachricht übersetzt werden soll. Format: BCP 47-Standard
args	Array	Optional. Liste von Zeichenfolgen oder anderen Werten, die durch Java.Text.MessageFormat definiert sind und die Variablen innerhalb der angegebenen Nachricht ersetzen. Beispiel: `gs.getMessageLang(„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 : 114. Rückgaben
Typ	Beschreibung
Zeichenfolge	Übersetzte Nachricht.

Im folgenden Beispiel wird die angegebene Nachricht in Spanisch umgewandelt.

var my_message = gs.getMessageLang("New email", "es");
gs.info(my_message);

Ausgabe:

Nuevo correo electrónico

Das folgende Beispiel zeigt, wie Variablen in einer Nachricht ersetzt werden.

var my_message = gs.getMessageLang("There are {0} new emails for {1}", "es", [current.numEmails, current.userName]);
gs.info(my_message);

Ausgabe:

Hay 7 correos nuevos para John Smith

GlideSystem – getNodeName(Object obj, Number index)

Gibt den Knotennamen für den angegebenen Index zurück.

Tabelle : 115. Parameter
Name	Typ	Beschreibung
obj	Objekt	Zu untersuchendes Objekt.
index	Anzahl	Index, von dem der Knotenname abgerufen werden soll.

Tabelle : 116. Rückgaben
Typ	Beschreibung
Zeichenfolge	Knotenname

function doInsert(nodeList) {
  gs.print('Doing insert');
  var task = new GlideRecord('task');
  task.initialize();
  for (var x=0; x < nodeList.size(); x++) {
    var name = gs.getNodeName(nodeList, x);
    var value = gs.getNodeValue(nodeList, x);
    task.setValue(name, value);
  }
  task.insert();
}

GlideSystem – getNodeValue(Object obj, Number index)

Gibt den Knotenwert für den angegebenen Index zurück.

Tabelle : 117. Parameter
Name	Typ	Beschreibung
obj	Objekt	Zu untersuchendes Objekt.
index	Anzahl	Index, aus dem der Knoten „Valu.e“ abgerufen werden soll

Tabelle : 118. Rückgaben
Typ	Beschreibung
Objekt	Knotenwert

function doInsert(nodeList) {
  gs.print('Doing insert');
  var task = new GlideRecord('task');
  task.initialize();
  for (var x=0; x < nodeList.size(); x++) {
    var name = gs.getNodeName(nodeList, x);
    var value = gs.getNodeValue(nodeList, x);
    task.setValue(name, value);
  }
  task.insert();
}

GlideSystem – getPreference(String key, Object default)

Gibt die angegebene Anwendereinstellung zurück.

Tabelle : 119. Parameter
Name	Typ	Beschreibung
key	Zeichenfolge	Schlüssel für die Einstellung.
Standard	Objekt	Standardwert, der verwendet werden soll, wenn die angegebene Einstellung nicht gefunden wird.

Tabelle : 120. Rückgaben
Typ	Beschreibung
Zeichenfolge	Einstellungswert. Wenn es keine Voreinstellung gibt, wird der angegebene Standardwert zurückgegeben.

function getSelectedProject() {
  var array= new Array();
  var prj_id = gs.getPreference("prj_id"); //This will fetch value from user preference
  var gr = new GlideRecord('pm_project_task');
  gr.addQuery('parent', prj_id);
  gr.addActiveQuery();
  while(gr.next()) {
    array.push(gr.sys_id.toString());
  }
  return array;
}

GlideSystem – getProperty(String key, Object alt)

Gibt den Wert einer Glide-Eigenschaft zurück. Wenn die Eigenschaft nicht gefunden wird, wird die angegebene zurückgegeben altWert.

Tabelle : 121. Parameter
Name	Typ	Beschreibung
key	Zeichenfolge	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 : 122. Rückgaben
Typ	Beschreibung
Zeichenfolge	Wert der Glide-Eigenschaft oder des oben definierten alternativen Objekts.

//Check for attachments and add link if there are any
var attachment_link = '';
var rec = new GlideRecord('sc_req_item');
rec.addQuery('sys_id', current.request_item);
rec.query();
if(rec.next()){
  if(rec.hasAttachments()){
    attachment_link = gs.getProperty('glide.servlet.uri') + rec.getLink();
  }   
}

GlideSystem – getScriptError(String script)

Gibt den im angegebenen Skript gefundenen Skriptfehler zurück, falls vorhanden.

Hinweis:

Das Skript wird von dieser Funktion nicht ausgeführt, es wird nur auf Syntaxfehler überprüft.

Tabelle : 123. Parameter
Name	Typ	Beschreibung
Skript	Zeichenfolge	Skript zum Überprüfen auf Fehler.

Tabelle : 124. Rückgaben
Typ	Beschreibung
Zeichenfolge	Fehlermeldung. Null, wenn kein Fehler vorliegt.

if (gs.isValidScript(current.script) == false)
  {
    current.setAbortAction(true);
    var error = gs.getScriptError(current.script);
    current.script.setError(error);
  }

GlideSystem – getSession()

Gibt ein GlideSession-Objekt zurück.

Tabelle : 125. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 126. Ergebnisse
Typ	Beschreibung
GlideSession-Objekt	GlideSession-Objekt für die aktuelle Sitzung

if(!gs.hasRole("admin") && gs.getSession().isInteractive() && gs.getUserName() != "guest"){
  var qc = current.addQuery('u_visibility', "both");
  qc.addOrCondition('u_visibility', '');
  if (gs.getImpersonatingUserName() != null) {
    gs.getSession().clearClientData('navQuery');
  }
  var navQuery = gs.getSession().getClientData('navQuery');
  if (navQuery == null) {
    var isManager = gs.getUser().getRecord().getValue('u_is_manager');
      if (!isManager) {
        qc.addOrCondition('u_visibility', 'nonmanager');
        gs.getSession().putClientData('navQuery', 'nonmanager');
      } else {
        qc.addOrCondition('u_visibility', 'manager');
        gs.getSession().putClientData('navQuery', 'manager');
        }
  } else {
  qc.addOrCondition('u_visibility', navQuery);
  }   
}

Bereichsbezogenes Äquivalent

Um die getSession()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getSession().

GlideSystem – getSessionID()

Gibt die GlideSession-Sitzungs-ID zurück.

Tabelle : 127. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 128. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Sitzungs-ID

var gr_NOW = new GlideRecord('v_user_session');
var sessionId = gs.getSessionID();
gs.log("Session ID is: " + sessionId);

Ausgabe

Session ID is: FEE589B3DB7EE4103DD9C39D139619D7

Bereichsbezogenes Äquivalent

Um die getSessionID()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getSessionID().

GlideSystem – getStyle(String tableName, String fieldName, String fieldValue)

Gibt den für die Tabelle, das Feld und den Feldwert definierten Stil zurück.

Tabelle : 129. Parameter
Name	Typ	Beschreibung
tableName	Zeichenfolge	Tabellenname
fieldName	Zeichenfolge	Feldname
fieldValue	Zeichenfolge	Feldwert

Tabelle : 130. Rückgaben
Typ	Beschreibung
Zeichenfolge	Stil des angegebenen Felds.

var returnString = gs.getStyle('<tableName>', '<fieldName>', '<fieldValue>');
gs.print(returnString);

GlideSystem – getTimeFormat()

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

Tabelle : 131. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 132. Ergebnisse
Typ	Beschreibung
Zeichenfolge	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

GlideSystem – getUser()

Gibt eine Referenz auf das Benutzerobjekt für den aktuellen Benutzer zurück.

Tabelle : 133. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 134. Ergebnisse
Typ	Beschreibung
GlideUser	Verweis auf ein Anwenderobjekt für den aktuellen Anwender.

Das folgende Beispiel zeigt, wie das aktuelle Anwenderobjekt abgerufen wird.

var user = gs.getUser();
gs.print ("The current user is: " + user);

Ausgabe:

The current user is: com.glide.sys.User@db5dd9

Das folgende Beispiel zeigt, wie überprüft wird, ob der aktuelle Anwender über die Rolle „Workflow_admin“ verfügt.

var role = gs.getUser().hasRole('workflow_admin');
gs.print ("Does the current user have the workflow_admin role: " + role);

Ausgabe:

Does the current user have the workflow_admin role: true

Bereichsbezogenes Äquivalent

Um die getUser()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getUser().

GlideSystem – getUserDisplayName()

Ruft den Anzeigenamen des aktuellen Benutzers ab.

Tabelle : 135. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 136. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Das Namensfeld des aktuellen Benutzers. Diese Methode gibt beispielsweise Abel Tuter im Gegensatz zu abel.tuter zurück.

In diesem Beispiel wird der Anzeigename des aktuellen Anwenders abgerufen.

gs.info(gs.getUserDisplayName());

Ausgabe:

System Administrator

Bereichsbezogenes Äquivalent

Um die getUserDisplayName()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getUserDisplayName().

GlideSystem – getUserID()

Gibt die sys_id des aktuellen Benutzers zurück.

Tabelle : 137. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 138. Ergebnisse
Typ	Beschreibung
Zeichenfolge	SYS_ID des aktuellen Anwenders.

Dieses Beispiel ruft die sys_ID des aktuellen Anwenders ab

var currentUserId = gs.getUserID();
gs.print("Current user ID: " + currentUserId);

Ausgabe:

Current user ID: 6816f79cc0a8016401c5a33be04be441

Bereichsbezogenes Äquivalent

Um die getUserID()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getUserID().

GlideSystem – getUserName()

Gibt den Anwendernamen des aktuellen Anwenders zurück.

Tabelle : 139. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 140. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Der Benutzername des aktuellen Benutzers. Diese Methode gibt beispielsweise abel.tuter im Gegensatz zu Abel Tuter zurück.

Dieses Beispiel ruft den Anwendernamen des aktuellen Anwenders und eines Anwenders ab, dessen Identität angenommen wurde.

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

var impUser = new GlideImpersonate();
impUser.impersonate("62826bf03710200044e0bfc8bcbe5df1");
var user2 = gs.getUserName();
gs.info("The impersonated user name is: " + user2);

Ausgabe:

The current user name is: admin
The impersonated user name is: abel.tuter

Bereichsbezogenes Äquivalent

Um die getUserName()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getUserName().

GlideSystem – getUserNameByUserID(Zeichenfolge user_ID)

Gibt den Anwenderanzeigenamen basierend auf einem angegebenen Anwenderanmeldenamen zurück.

Tabelle : 141. Parameter
Name	Typ	Beschreibung
user_id	Zeichenfolge	Anmeldename des Anwenders, von dem der zugehörige Anzeigename abgerufen werden soll.

Tabelle : 142. Rückgaben
Typ	Beschreibung
Zeichenfolge	Anzeigename des angeforderten Anwenders. Hinweis: Wenn diese Methode keinen Anwender mit der angeforderten ID finden kann, wird der angegebene Eingabewert zurückgegeben.

Das folgende Beispiel zeigt, wie der Anzeigename des angegebenen Anwenders abgerufen wird.

var displayName = gs.getUserNameByUserID('abel.tuter');
gs.info('User display name is: ' + displayName);

Ausgabe:

User display name is: Abel Tuter

GlideSystem – getXMLNodeList(String xml)

Erstellt ein Array aller Knoten und Werte in einem XML-Dokument.

Tabelle : 143. Parameter
Name	Typ	Beschreibung
xml	Zeichenfolge	XML-Dokument, das analysiert werden soll.

Tabelle : 144. Rückgaben
Typ	Beschreibung
Array-Liste	Liste der Namen und Werte des äußersten XML-Knotens.

Das folgende Beispiel zeigt, wie Sie eine Liste von XML-Knoten und ihren zugehörigen Werten in einer Array-Liste abrufen.

var nodeList = gs.getXMLNodeList("<note><to>Tove</to><from>Jani</from><heading>Reminder</heading><body>Don't forget me this weekend!</body></note>");
gs.print ("The node contains: " + nodeList);

Ausgabe:

The node contains: [to : Tove, from : Jani, heading : Reminder, body : Don't forget me this weekend!]

GlideSystem – getXMLText(String xml, String xpathQuery)

Gibt den XML-Text für das erste Element in der XML-Zeichenfolge zurück, das der XPath-Abfrage entspricht.

Tabelle : 145. Parameter
Name	Typ	Beschreibung
xml	Zeichenfolge	Zu suchende XML-Zeichenfolge.
xpathQuery	Zeichenfolge	Abzugleichende XPath-Abfrage.

Tabelle : 146. Rückgaben
Typ	Beschreibung
Zeichenfolge	XML-Knoten, der den Suchparametern entspricht.

Das folgende Beispiel zeigt, wie der Wert eines angegebenen XML-Elements innerhalb eines übergebenen Knotens abgerufen wird.

var nodeList = gs.getXMLText("<outer><note><to>Tove</to><from>Jani</from><heading>Reminder</heading><body>Don't forget me this weekend!</body></note></outer>", "//from");
gs.print ("The from element contains: " + nodeList);

Ausgabe:

The from element contains: Jani

GlideSystem – hasRole(String roleName)

Bestimmt, ob der aktuelle Benutzer mindestens eine der übergebenen Rollen hat.

Tabelle : 147. Parameter
Name	Typ	Beschreibung
roleName	Zeichenfolge	Kommagetrennte Liste von Rollen.

Tabelle : 148. Rückgaben
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob der aktuelle Anwender mindestens eine der angegebenen Rollen hat. Mögliche Werte: Wahr: Anwender hat mindestens eine der übergebenen Rollen. Gibt auch „true“ zurück, wenn der Benutzer die Administratorrolle hat. Falsch: Anwender hat keine der übergebenen Rollen.

Das folgende Beispiel zeigt, wie überprüft wird, ob der aktuelle Anwender die Rolle admin oder groups_admin hat.

if (!gs.hasRole("admin, 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
}

Bereichsbezogenes Äquivalent

Um die hasRole()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: hasRole().

GlideSystem – hasRoleInGroup(Object roleName, Object group)

Bestimmt, ob der aktuelle Benutzer die angegebene Rolle innerhalb einer angegebenen Gruppe hat.

Tabelle : 149. Parameter
Name	Typ	Beschreibung
roleName	Objekt	Name der Rolle.
Gruppe	Objekt	SYS_ID der Gruppe, die auf die angegebene Rolle überprüft werden soll.

Tabelle : 150. Rückgaben
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob der aktuelle Anwender die angegebene Rolle in der angegebenen Gruppe hat. Mögliche Werte: Wahr: Der angemeldete Anwender ist der angegebenen Rolle in der angegebenen Gruppe zugewiesen. Falsch: Der angemeldete Anwender ist der angegebenen Rolle in der angegebenen Gruppe nicht zugewiesen.

Das folgende Beispiel zeigt, wie überprüft wird, ob die Gruppe „sys_user_Group“ über die Rolle „role_Name“ verfügt.

var group = new GlideRecord('sys_user_group');
group.addQuery('name', 'GROUP_NAME');
group.setLimit(1);
group.query();
if (group.next()) {
   if (gs.hasRoleInGroup('role_name', group)) {
      gs.print('User has role in group');  
   } else {
      gs.print('User does NOT have role in group');
   }  
}

GlideSystem – hoursAgo(Number hours)

Gibt ein Datum und eine Uhrzeit für die angegebene Anzahl von Stunden zurück. Der zurückgegebene Wert wird an die Zeitzone der Instanz angepasst.

Tabelle : 151. Parameter
Name	Typ	Beschreibung
hours	Anzahl	Anzahl der Stunden.

Tabelle : 152. Rückgaben
Typ	Beschreibung
Zeichenfolge	UTC-Datum und -Uhrzeit für die angegebene Anzahl von Stunden. Format: jjjj-mm-TT hh:mm:ss

var currentDateTime = gs.hoursAgo(0);
gs.info("Current date/time: " + currentDateTime);

var agoDateTime = gs.hoursAgo(1);
gs.info("Ago date/time: " + agoDateTime);

Ausgabe

Current date/time: 2021-03-17 20:53:25
Ago date/time: 2021-03-17 19:53:25

Bereichsbezogenes Äquivalent

Um die hoursAgo()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: hoursAgo().

GlideSystem – hoursAgoEnd(Number hours)

Gibt ein Datum und eine Uhrzeit für das Ende der Stunde für die angegebene Anzahl von Stunden zurück. Der zurückgegebene Wert wird an die Zeitzone der Instanz angepasst.

Tabelle : 153. Parameter
Name	Typ	Beschreibung
Stunden	Zahl (Ganzzahl)	Anzahl der Stunden.

Tabelle : 154. Rückgaben
Typ	Beschreibung
Zeichenfolge	UTC-Datum und -Uhrzeit für das Ende der angegebenen Anzahl von Stunden. Format: jjjj-mm-TT hh:mm:ss

var currentDateTime = gs.hoursAgoEnd(0);
gs.print("Current date/time: " + currentDateTime);

var agoDateTime = gs.hoursAgoEnd(1);
gs.print("Ago date/time: " + agoDateTime);

Ausgabe

Current date/time: 2021-03-17 20:59:59
Ago date/time: 2021-03-17 19:59:59

Bereichsbezogenes Äquivalent

Um die hoursAgoEnd()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: hoursAgoEnd().

GlideSystem – hoursAgoStart(Number hours)

Gibt ein Datum und eine Uhrzeit für den Beginn der Stunde für die angegebene Anzahl von Stunden zurück. Der zurückgegebene Wert wird an die Zeitzone der Instanz angepasst.

Tabelle : 155. Parameter
Name	Typ	Beschreibung
hours	Anzahl	Anzahl der Stunden.

Tabelle : 156. Rückgaben
Typ	Beschreibung
Zeichenfolge	UTC-Datum und -Uhrzeit für das Ende der angegebenen Anzahl von Stunden. Format: jjjj-mm-TT hh:mm:ss

var currentDateTime = gs.hoursAgoStart(0);
gs.print("Current date/time: " + currentDateTime);

var agoDateTime = gs.hoursAgoStart(1);
gs.print("Ago date/time: " + agoDateTime);

Ausgabe

Current date/time: 2021-03-17 20:00:00
Ago date/time: 2021-03-17 19:00:00

Bereichsbezogenes Äquivalent

Um die hoursAgoStart()-Methode in einer bereichsbezogene Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: hoursAgoStart().

GlideSystem – isFirstDayOfMonth(Object date)

Überprüft, ob das Datum im angegebenen Datumsobjekt der erste Tag des Monats ist.

Tabelle : 157. Parameter
Name	Typ	Beschreibung
date	Objekt	Datumsobjekt, an dem das Datum überprüft werden soll, z. B. GlideDateTime oder GlideDate.

Tabelle : 158. Rückgaben
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob das Datum im angegebenen Datumsobjekt der erste Tag des Monats ist. Mögliche Werte: Wahr: Erster Tag des Monats. Falsch: Nicht der erste Tag des Monats.

Dieses Beispiel zeigt, wie bestimmt wird, ob das Datum im angegebenen Datumsobjekt der erste Tag des Monats ist.

var gdt = new GlideDateTime();
gdt.setValue('2021-04-01 12:00:00');
var currentDay = gs.isFirstDayOfMonth(gdt);
gs.print("First day of month: " + currentDay);

gdt.setValue('2021-04-21 12:00:00');
var currentDay = gs.isFirstDayOfMonth(gdt);
gs.print("First day of month: " + currentDay);

Ausgabe

First day of month: true
First day of month: false

GlideSystem – isFirstDayOfWeek(Object date)

Überprüft, ob das Datum im angegebenen Datumsobjekt der erste Tag der Woche ist. Bei dieser Methode wird der ISO-Standard verwendet, dass Montag der erste Tag der Woche ist.

Tabelle : 159. Parameter
Name	Typ	Beschreibung
date	Objekt	Datumsobjekt, an dem das Datum überprüft werden soll, z. B. GlideDateTime oder GlideDate.

Tabelle : 160. Rückgaben
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob das Datum im aktuellen Datumsobjekt der erste Tag der Woche (Montag) ist. Mögliche Werte: Wahr: Erster Tag der Woche. Falsch: Nicht der erste Tag der Woche.

Dieses Beispiel zeigt, wie bestimmt wird, ob das Datum im angegebenen Datumsobjekt der erste Tag der Woche ist.

var gdt = new GlideDateTime();
gdt.setValue('2021-03-02 12:00:00');
var currentDay = gs.isFirstDayOfWeek(gdt);
gs.info("First day of week: " + currentDay);

gdt.setValue('2021-03-22 12:00:00');
var currentDay = gs.isFirstDayOfWeek(gdt);
gs.info("First day of week: " + currentDay);

Ausgabe

First day of week: false
First day of week: true

GlideSystem – isFirstDayOfYear(Object date)

Überprüft, ob das Datum im angegebenen Datumsobjekt der erste Tag des Jahres ist.

Tabelle : 161. Parameter
Name	Typ	Beschreibung
date	Objekt	Datumsobjekt, an dem das Datum überprüft werden soll, z. B. GlideDateTime oder GlideDate.

Tabelle : 162. Rückgaben
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob das Datum im angegebenen Datumsobjekt der erste Tag des Jahres ist. Mögliche Werte: Wahr: Erster Tag des Jahres. Falsch: Nicht der erste Tag des Jahres.

Dieses Beispiel zeigt, wie bestimmt wird, ob das Datum im angegebenen Datumsobjekt der erste Tag des Jahres ist.

var gdt = new GlideDateTime();
gdt.setValue('2020-12-31 12:00:00');
var currentDay = gs.isFirstDayOfYear(gdt);
gs.info("First day of year: " + currentDay);

gdt.setValue('2021-01-01 12:00:00');
var currentDay = gs.isFirstDayOfYear(gdt);
gs.info("First day of year: " + currentDay);

Ausgabe

First day of year: false
First day of year: true

GlideSystem – isInteractive()

Überprüft, ob die aktuelle Sitzung interaktiv ist.

Ein Beispiel für eine interaktive Sitzung ist, wenn sich ein Benutzer über den Anmeldebildschirm anmeldet. Ein Beispiel für eine nicht interaktive Sitzung ist die Verwendung einer SOAP-Anforderung zum Abrufen von Daten.

Tabelle : 163. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 164. Ergebnisse
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob die Sitzung interaktiv ist. Mögliche Werte: Wahr: Sitzung ist interaktiv. Falsch: Sitzung ist nicht interaktiv.

if (!gs.hasRole('admin') && gs.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 Äquivalent

Um die isInteractive()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: isInteractive().

GlideSystem – isLastDayofMonth(Object date)

Überprüft, ob das Datum im angegebenen Datumsobjekt der letzte Tag des Monats ist.

Tabelle : 165. Parameter
Name	Typ	Beschreibung
date	Objekt	Datumsobjekt, an dem das Datum überprüft werden soll, z. B. GlideDateTime oder GlideDate.

Tabelle : 166. Rückgaben
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob das Datum im angegebenen Datumsobjekt der letzte Tag des Monats ist. Mögliche Werte: Wahr: Letzter Tag des Monats. Falsch: Nicht der letzte Tag des Monats.

Dieses Beispiel zeigt, wie bestimmt wird, ob das Datum im angegebenen Datumsobjekt der letzte Tag des Monats ist.

var gdt = new GlideDate();
gdt.setValue('2020-12-31 12:00:00');
var currentDay = gs.isLastDayOfMonth(gdt);
gs.print("First day of year: " + currentDay);

gdt.setValue('2021-01-01 12:00:00');
var currentDay = gs.isLastDayOfMonth(gdt);
gs.print("First day of year: " + currentDay);

Ausgabe

Last day of month: true
Last day of month: false

GlideSystem – isLastDayOfWeek(Object date)

Überprüft, ob das Datum im angegebenen Datumsobjekt der letzte Tag der Woche ist. Bei dieser Methode wird der ISO-Standard verwendet, dass Sonntag der letzte Tag der Woche ist.

Tabelle : 167. Parameter
Name	Typ	Beschreibung
date	Objekt	Datumsobjekt, an dem das Datum überprüft werden soll, z. B. GlideDateTime oder GlideDate.

Tabelle : 168. Rückgaben
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob das Datum im aktuellen Datumsobjekt der letzte Tag der Woche (Sonntag) ist. Mögliche Werte: Wahr: Letzter Tag der Woche. Falsch: Nicht der letzte Tag der Woche.

Dieses Beispiel zeigt, wie bestimmt wird, ob das Datum im angegebenen Datumsobjekt der letzte Tag der Woche ist.

var gdt = new GlideDate();
gdt.setValue('2021-03-01 12:00:00');
var currentDay = gs.isLastDayOfWeek(gdt);
gs.info("Last day of week: " + currentDay);

gdt.setValue('2021-03-21 12:00:00');
var currentDay = gs.isLastDayOfWeek(gdt);
gs.info("Last day of week: " + currentDay);

Ausgabe

First day of week: false
First day of week: true

GlideSystem – isLastDayOfYear(Object date)

Überprüft, ob das Datum im angegebenen Datumsobjekt der letzte Tag des Jahres ist.

Tabelle : 169. Parameter
Name	Typ	Beschreibung
date	Objekt	Datumsobjekt, an dem das Datum überprüft werden soll, z. B. GlideDateTime oder GlideDate.

Tabelle : 170. Rückgaben
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob das Datum im aktuellen Datumsobjekt der letzte Tag des Jahres ist. Mögliche Werte: Wahr: Letzter Tag des Jahres. Falsch: Nicht der letzte Tag des Jahres.

Dieses Beispiel zeigt, wie bestimmt wird, ob das Datum im angegebenen Datumsobjekt der letzte Tag des Jahres ist.

var gdt = new GlideDateTime();
gdt.setValue('2020-12-31 12:00:00');
var currentDay = gs.isLastDayOfYear(gdt);
gs.info("Last day of year: " + currentDay);

gdt.setValue('2021-01-01 12:00:00');
var currentDay = gs.isLastDayOfYear(gdt);
gs.info("Last day of year: " + currentDay);

Ausgabe

Last day of year: true
Last day of year: false

GlideSystem – isLoggedIn()

Ermittelt, ob der aktuelle Benutzer derzeit angemeldet ist.

Tabelle : 171. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 172. Ergebnisse
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob der aktuelle Anwender angemeldet ist. Mögliche Werte: Wahr: Anwender ist angemeldet. Falsch: Anwender ist nicht angemeldet.

Dieses Beispiel zeigt, wie bestimmt wird, ob der aktuelle Anwender angemeldet ist.

if(gs.isLoggedIn())
  gs.info("Current user is logged in");
else
  gs.info("Current user is NOT logged in");

Ausgabe

Current user is logged in

Bereichsbezogenes Äquivalent

Um die isLoggedIn()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: isLoggedIn().

GlideSystem – isMobile()

Bestimmt, ob die Anforderung von einem Mobilgerät stammt.

Sie können diese Methode in UI-Aktionsbedingungen und Geschäftsregeln verwenden.

Tabelle : 173. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 174. Ergebnisse
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob die Anforderung von einem Mobilgerät stammt. Mögliche Werte: Wahr: Mobilgerät. Falsch: Nicht mobiles Gerät.

Dieses Beispiel zeigt, wie bestimmt wird, ob das aktuelle Gerät ein Mobilgerät ist.

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

Ausgabe

Submitted from mobile UI

Bereichsbezogenes Äquivalent

Um die isMobile()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: isMobile().

GlideSystem – lastWeek()

Gibt das Datum und die Uhrzeit vor einer Woche in GMT zurück.

Tabelle : 175. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 176. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Datum und Uhrzeit vor einer Woche. Format: jjjj-MM-TT hh:mm:ss

Dieses Beispiel zeigt, wie das Datum abgerufen wird, das eine Woche ab dem Datum im aktuellen Datumsobjekt liegt.

var gdt = new GlideDateTime();
gdt.setValue('2021-03-22 01:00:00');

gs.info("Current date: " + gs.nowDateTime());

gs.info("One week earlier: " + gs.lastWeek());

Ausgabe

Current date: 2021-03-22 15:27:07
One week earlier: 2021-03-15 15:27:07

GlideSystem – log(String message, String source)

Protokolliert eine Meldung im Systemprotokoll und speichert sie in der syslog-Tabelle.

Tabelle : 177. Parameter
Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Zu protokollierende Nachricht.
Quelle	Zeichenfolge	Optional. Quelle der Nachricht.

Tabelle : 178. Rückgaben
Typ	Beschreibung
void

Das folgende Beispiel zeigt, wie ein Protokolleintrag mithilfe von Konstanten und Variablen veröffentlicht wird.

var count = new GlideAggregate('incident');
count.addQuery('active', 'true');
count.addAggregate('COUNT', 'category');
count.query();   
while (count.next()) {
   var category = count.category;
   var categoryCount = count.getAggregate('COUNT', 'category');
   gs.log("The are currently " + categoryCount + " incidents with a category of " + category, "Incident Counter");
}

GlideSystem – logError(String message, String source)

Protokolliert einen Fehler im Systemprotokoll und speichert ihn in der syslog-Tabelle.

Tabelle : 179. Parameter
Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Zu protokollierende Fehlermeldung.
Quelle	Zeichenfolge	Optional. Quelle der Nachricht.

Tabelle : 180. Rückgaben
Typ	Beschreibung
void

Im folgenden Beispiel wird ein Fehler protokolliert, wenn die Incident-Tabelle nicht gefunden werden kann.

var gr_NOW = new GlideRecord("incident");
if (!gr_NOW.isValid()) {
  gs.logError('Incident table could not be found');
  return;
}

GlideSystem – logWarning(String message, String source)

Protokolliert eine Warnung im Systemprotokoll und speichert sie in der syslog-Tabelle.

Tabelle : 181. Parameter
Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Zu protokollierende Nachricht.
Quelle	Zeichenfolge	Optional. Quelle der Nachricht.

Tabelle : 182. Rückgaben
Typ	Beschreibung
void

Im folgenden Beispiel wird eine Warnung protokolliert, wenn die Incident-Tabelle nicht gefunden werden kann.

var gr_NOW = new GlideRecord("incident");
if (!gr_NOW.isValid()) {
  gs.logWarning('Incident table could not be found');
  return;
}

GlideSystem – minutesAgo(Number minutes)

Gibt ein Datum und eine Uhrzeit für die angegebene Anzahl von Minuten zurück.

Tabelle : 183. Parameter
Name	Typ	Beschreibung
minutes	Anzahl	Anzahl der Minuten in der Vergangenheit, die zurückgegeben werden sollen.

Tabelle : 184. Rückgaben
Typ	Beschreibung
Zeichenfolge	UTC-Datum und -Uhrzeit für die angegebene Anzahl von Minuten. Format: jjjj-mm-TT hh:mm:ss

Dieses Beispiel zeigt, wie die Methode minutesAgo() in einem addQuery()-Aufruf verwendet wird.

// Check to see if the user has failed to login too many times
// when the limit is reached, lock the user out of the system
//
//Check failed logins in the last 15 minutes
var now_GR = new GlideRecord('sysevent');
now_GR.addQuery('name', 'login.failed');
now_GR.addQuery('parm1', event.parm1.toString());
now_GR.addQuery('sys_created_on','>=', gs.minutesAgo(15));
now_GR.query();
var rowCount = now_GR.getRowCount();
if(rowCount >= 5){
  var now_GR = new GlideRecord("sys_user");
  now_GR.addQuery("user_name", event.parm1.toString());
  now_GR.query();
  if (now_GR.next()) {
    now_GR.locked_out = true;
    now_GR.update();
    gs.log("User " + event.parm1 + " locked out due to too many invalid login attempts");
  }
}

GlideSystem – minutesAgoEnd(Number minutes)

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

Tabelle : 185. Parameter
Name	Typ	Beschreibung
minutes	Anzahl	Ganzzahl vor Minuten, z. B. 5 oder 11.

Tabelle : 186. 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.print("Now: " + nowDateTime);
var thirtyMinutesAgoDateTime = gs.minutesAgoEnd(30);
gs.print("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 Äquivalent

Um die minutesAgoEnd()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: minutesAgoEnd().

GlideSystem – minutesAgoStart(Number minutes)

Gibt ein Datum und eine Uhrzeit für den Beginn der Minute vor einer bestimmten Anzahl von Minuten zurück.

Tabelle : 187. Parameter
Name	Typ	Beschreibung
minutes	Anzahl	Ganzzahl vor Minuten, z. B. 15 oder 112.

Tabelle : 188. 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 Äquivalent

Um die minutesAgoStart()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: minutesAgoStart().

GlideSystem – monthsAgo(Number months)

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

Tabelle : 189. Parameter
Name	Typ	Beschreibung
months	Anzahl	Ganzzahl von Monaten.

Tabelle : 190. 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 Äquivalent

Um die monthsAgo()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: monthsAgo().

GlideSystem – monthsAgoEnd(Number months)

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

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

Tabelle : 192. Rückgaben
Typ	Beschreibung
Zeichenfolge	Datums- und Zeitstempel des Monats, die angegebene Anzahl von Monaten vor, in Ortszeit. Format: UTC JJJJ-mm-TT hh:mm:ss

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

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

Ausgabe:

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

GlideSystem – monthsAgoStart(Number months)

Gibt ein Datum und eine Uhrzeit für den Monatsanfang vor einer bestimmten Anzahl von Monaten zurück.

Tabelle : 193. Parameter
Name	Typ	Beschreibung
months	Anzahl	Ganzzahl von vor Monaten, z. B. 5 oder 14.

Tabelle : 194. 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 Äquivalent

Um die monthsAgoStart()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: monthsAgoStart().

GlideSystem – nil(Object obj)

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

Tabelle : 195. Parameter
Name	Typ	Beschreibung
obj	Objekt	Zu überprüfendes Objekt.

Tabelle : 196. Ergebnisse
Typ	Beschreibung
Boolean	„True“, wenn NULL oder leere Zeichenfolge; andernfalls „false“.

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 Äquivalent

Um die nil()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: nil().

GlideSystem – now()

Gibt das aktuelle Datum in UTC zurück.

Tabelle : 197. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 198. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Aktuelles Datum im benutzerdefinierten Format, in UTC.

// When the user password changes then set the u_password_last_reset field
// to now so we know when to force another update
 
var now_GR = new GlideRecord("sys_user");
if (now_GR.get(event.parm1.toString())) {
    // Do something based on the Password Changing
    gs.log("The user password changed so do something else...");
    now_GR.u_password_last_reset = gs.now();
    now_GR.update();
}

GlideSystem – nowNoTZ()

Gibt das aktuelle Datum und die aktuelle Uhrzeit im UTC-Format zurück.

Tabelle : 199. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 200. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Aktuelles UTC-Datum/aktuelle UTC-Uhrzeit

// When the user password changes then set the u_password_last_reset field
// to now so we know when to force another update
 
var now_GR = new GlideRecord("sys_user");
if (now_GR.get(event.parm1.toString())) {
    // Do something based on the Password Changing
    gs.log("The user password changed so do something else...");
    now_GR.u_password_last_reset = gs.nowNoTZ();
    now_GR.update();
}

GlideSystem – nowDateTime()

Gibt das aktuelle Datum und die aktuelle Uhrzeit im anwenderdefinierten Format zurück.

Tabelle : 201. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 202. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Aktuelles Datum und aktuelle Uhrzeit im anwenderdefinierten Format. Weitere Informationen zum Festlegen des Datums- und Uhrzeitformats des Systems finden Sie unter Datums- und Datums-/Uhrzeitfelder .

var currentDateTime = gs.nowDateTime();
gs.print("Current date/time: " + currentDateTime);

Ausgabe

Current date/time: 2021-03-17 14:04:02

Wenn Sie eine Variable in einem Workflow-Skript auf das aktuelle Datum und die aktuelle Uhrzeit festlegen, verwenden Sie die setDisplayValue()-Methode. Das folgende Skript legt die Workflow-Variable end_date auf das aktuelle Datum und die aktuelle Uhrzeit fest.

current.variables.end_date.setDisplayValue(gs.nowDateTime());

GlideSystem – nowGlideDateTime()

Ruft ein GlideDateTime-Objekt mit dem aktuellen Datum und der aktuellen Uhrzeit ab.

Nachdem Sie ein GlideDateTime-Objekt mit dem aktuellen Datum und der aktuellen Uhrzeit abgerufen haben, können Sie die GlideDateTime-Methoden verwenden, um Datum-/Uhrzeit-Vorgänge auszuführen, z. B. Berechnen von Datum/Uhrzeit, Formatieren von Datum/Uhrzeit oder Konvertieren zwischen Datum-/Uhrzeit-Formaten.

Tabelle : 203. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 204. Ergebnisse
Typ	Beschreibung
Objekt	GlideDateTime-Objekt mit dem aktuellen Datum und der aktuellen Uhrzeit im GMT-Format.

Legt das Feld „u_target_date“ auf das aktuelle Datum und die aktuelle Uhrzeit im GMT-Format fest.

current.u_target_date = gs.nowGlideDateTime();

GlideSystem – print(String message)

Schreibt eine Meldung in das Systemprotokoll.

Diese Methode schreibt die Meldung nicht in die syslog-Tabelle, es sein denn, Debug wurde aktiviert.

Tabelle : 205. Parameter
Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Zu protokollierende Meldung

Tabelle : 206. Ergebnisse
Typ	Beschreibung
void

var rec = new GlideRecord('incident');
rec.addQuery('active',false);
rec.query();
while (rec.next()) { 
 gs.print('Inactive incident ' + rec.number + ' deleted');
 rec.deleteRecord();
}

GlideSystem – quartersAgo(Number quarters)

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

Tabelle : 207. Parameter
Name	Typ	Beschreibung
quarters	Anzahl	Ganzzahlnummer der vor Quartalen.

Tabelle : 208. Rückgaben
Typ	Beschreibung
Zeichenfolge	GMT des Quartals, das die angegebene Anzahl von Quartalen war. 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 vier Quartalen gleichzeitig an.

var nowDateTime = new GlideDateTime();
gs.print("Now: " + nowDateTime);
var fourQuartersAgoDateTime = gs.quartersAgo(4);
gs.print("Four quarters ago: " + fourQuartersAgoDateTime);

Ausgabe

Now: 2021-10-20 16:27:32
Four quarters ago: 2020-10-20 16:27:32

GlideSystem – quartersAgoEnd(Number quarters)

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

Tabelle : 209. Parameter
Name	Typ	Beschreibung
quarters	Zahl	Ganzzahl von Quartalen

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

Bereichsbezogenes Äquivalent

Um die quartersAgoEnd()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: quartersAgoEnd().

GlideSystem – quartersAgoStart(Number quarters)

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

Tabelle : 211. Parameter
Name	Typ	Beschreibung
quarters	Zahl	Ganzzahl von Quartalen

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

Bereichsbezogenes Äquivalent

Um die quartersAgoStart()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: quartersAgoStart().

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

Legt den angegebenen Schlüssel auf den angegebenen Wert fest.

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 : 213. 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 : 214. Ergebnisse
Typ	Beschreibung
void

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

Ausgabe: bar

Bereichsbezogenes Äquivalent

Um die setProperty()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: setProperty().

GlideSystem – setRedirect(Object URI)

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

Tabelle : 215. Parameter
Name	Typ	Beschreibung
URI	Objekt	URI, der als Umleitung festgelegt werden soll

Tabelle : 216. Ergebnisse
Typ	Beschreibung
void

In diesem Beispiel wird der Benutzer zu einem bestimmten Katalogelement umgeleitet und übergibt die aktuelle E-Mail als Parameter.

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

Bereichsbezogenes Äquivalent

Um die setRedirect()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: setRedirect().

GlideSystem – setReturn(Object URI)

Legt den Rückgabe-URI für diese Transaktion fest. Dadurch wird festgelegt, an welche Seite der Benutzer weitergeleitet wird, wenn er aus dem nächsten Formular zurückkehrt.

Tabelle : 217. Parameter
Name	Typ	Beschreibung
URI	Objekt	URI, der als Rückkehrort festgelegt werden soll.

Tabelle : 218. Ergebnisse
Typ	Beschreibung
void

In diesem Beispiel wird sichergestellt, dass der Benutzer zur aktuellen Seite zurückkehrt, wenn er mit der nächsten fertig ist.

gs.setReturn (current.getLink(true));

GlideSystem – tableExists(String tableName)

Bestimmt, ob eine Datenbanktabelle in vorhanden ist ServiceNow Instanz.

Tabelle : 219. Parameter
Name	Typ	Beschreibung
tableName	Zeichenfolge	Name der zu überprüfenden Tabelle.

Tabelle : 220. Rückgaben
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob die angegebene Tabelle in vorhanden ist ServiceNow Instanz. Mögliche Werte: Wahr: Tabelle ist vorhanden Falsch: Tabelle ist nicht vorhanden

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

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

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

Ausgabe

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

Bereichsbezogenes Äquivalent

Um die tableExists()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: tableExists().

GlideSystem – userID()

Gibt die sys_id des Benutzers zurück, der dieser Sitzung zugeordnet ist. Verwenden Sie stattdessen getUserID().

Tabelle : 221. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 222. Ergebnisse
Typ	Beschreibung
Zeichenfolge	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.userID();
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

GlideSystem – workflowFlush(Object glideRecord)

Löscht alle offenen Datensätze für geplante Aufgaben in der Tabelle „Zeitplan“ (sys_Trigger) für den angegebenen GlideRecord.

Tabelle : 223. Parameter
Name	Typ	Beschreibung
glideRecord	Objekt	GlideRecord

Tabelle : 224. Ergebnisse
Typ	Beschreibung
void

GlideSystem – yearsAgo(Number years)

Ruft das Datum und die Uhrzeit für eine bestimmte Anzahl von Jahren ab.

Tabelle : 225. Parameter
Name	Typ	Beschreibung
years	Zahl	Anzahl der Jahre als Ganzzahl

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

Bereichsbezogenes Äquivalent

Um die yearsAgo(Number years)-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: yearsAgo(Number years).

GlideSystem – yesterday()

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

Tabelle : 227. Parameter
Name	Typ	Beschreibung
Keine

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

Bereichsbezogenes Äquivalent

Um die yesterday()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: yesterday().