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 – 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 : 3. Parameter
Name	Typ	Beschreibung
message	Objekt	Hinzuzufügende Meldung.

Tabelle : 4. Ergebnisse
Typ	Beschreibung
void

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

Bereichsbezogenes Äquivalent

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

GlideSystem – addMessage(String type, Object message)

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

Tabelle : 5. 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 : 6. Ergebnisse
Typ	Beschreibung
void

GlideSystem – beginningOfLastMonth()

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

Tabelle : 7. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 8. 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 Beginn 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 : 9. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 10. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Beginn der letzten Woche. Format: jjjj-mm-tt hh:mm:ss

In diesem Beispiel wird der Wert des aktuellen Glide-Datensatzes für Datum/Uhrzeit auf den Beginn 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 : 11. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 12. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT Anfang nächster Woche. Format: jjjj-mm-tt hh:mm:ss

In diesem Beispiel wird der Wert des aktuellen Glide-Datensatzes für Datum/Uhrzeit auf den Beginn 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 : 13. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 14. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Beginn des nächsten Monats. Format: jjjj-mm-tt hh:mm:ss

In diesem Beispiel wird der Wert des aktuellen Glide-Datensatzes für Datum/Uhrzeit auf den Beginn 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 : 15. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 16. 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-Datensatzes für Datum/Uhrzeit auf den Beginn 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 das Datum und die Uhrzeit für den Beginn des aktuellen Monats in GMT zurück.

Tabelle : 17. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 18. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Beginn des aktuellen Monats. Format: jjjj-mm-tt hh:mm:ss

In diesem Beispiel wird der Wert des aktuellen Glide-Datensatzes für Datum/Uhrzeit 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 das Datum und die Uhrzeit für den Beginn des aktuellen Quartals in GMT zurück.

Tabelle : 19. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 20. 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-Datensatzes für Datum/Uhrzeit 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 : 21. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 22. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Beginn der aktuellen Woche. Format: jjjj-mm-tt hh:mm:ss

In diesem Beispiel wird der Wert des aktuellen Glide-Datensatzes für Datum/Uhrzeit 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 : 23. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 24. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Beginn des aktuellen Jahres. Format: jjjj-mm-tt hh:mm:ss

In diesem Beispiel wird der Wert des aktuellen Glide-Datensatzes für Datum/Uhrzeit 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 : 25. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 26. 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-Datensatzes für Datum/Uhrzeit 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 : 27. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 28. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT Anfang des morgigen Tages. 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 : 29. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 30. 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, finden Sie weitere Informationen im Abschnitt „Während eines bestimmten Zeitplans berechnen“ des Themas Nützliche Planungsskripts.

Tabelle : 31. Parameter
Name	Typ	Beschreibung
startDate	Zeichenfolge	Startdatum für den Vergleich im Datumsformat des aktuellen Benutzers.
endDate	Zeichenfolge	Enddatum für den Vergleich im Datumsformat des aktuellen Benutzers.
numericValue	Boolean	Kennzeichnung, die das Format des zurückgegebenen Zeitwerts angibt. Gültige Werte: true: Der Rückgabewert wird in Sekunden formatiert false: Der Rückgabewert hat das Format ddd hh:mm:ss.

Tabelle : 32. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Wenn der Parameter numericValue auf „true“ festgelegt ist, wird die Differenz zwischen den beiden Datumsangaben als Ganzzahl in Sekunden zurückgegeben. Bei „false“ wird die Differenz zwischen den beiden Datumsangaben 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 : 33. 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 : 34. 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 : 35. Parameter
Name	Typ	Beschreibung
date	Zeichenfolge	Datum, das in GMT generiert werden soll. Format: jjjj-mm-tt
range	Zeichenfolge	Start, Ende oder eine Uhrzeit. Format: 24 Stunden hh:mm:ss

Tabelle : 36. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Datum und Uhrzeit der Generierung. Wenn der Bereich `start`ist, lautet der zurückgegebene Wert jjjj-mm-tt 00:00:00. Wenn der Bereich das `Ende` ist, lautet der Rückgabewert jjjj-mm-tt 23:59:59. Format: jjjj-mm-tt hh:mm:ss

Dieses Beispiel zeigt die Verwendung von dateGenerate() zum Festlegen des Startdatums beim Abfragen von Datensätzen in der Incident-Tabelle.

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

Ausgabe:

Count: 7

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 : 37. Parameter
Name	Typ	Beschreibung
days	Zahl	Anzahl der Tage

Tabelle : 38. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT der angegebenen Anzahl von zurückliegenden 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 : 39. Parameter
Name	Typ	Beschreibung
days	Zahl	Ganzzahl von Tagen

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

Dieses Beispiel zeigt die Verwendung von 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 : 41. Parameter
Name	Typ	Beschreibung
days	Zahl	Anzahl der zurückliegenden Tage

Tabelle : 42. 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 : 43. Parameter
Name	Typ	Beschreibung
days	Zeichenfolge	Ganzzahl von Tagen

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

Tabelle : 46. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT 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 : 47. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 48. 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 vorherigen Monats 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 : 49. Parameter
Name	Typ	Beschreibung
Keine

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

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

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 : 51. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 52. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Datum und -Uhrzeit. Format jjjj-mm-tt hh:mm:ss

Dieses Beispiel zeigt, wie KB-Wissensdatensätze abgefragt werden, die seit Beginn des heutigen Tages bis zum 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 : 53. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 54. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Datum und -Uhrzeit für das Ende der nächsten Woche. Format jjjj-mm-tt hh:mm:ss

Dieses Beispiel zeigt, wie endOfNextWeek() in einer Abfrage verwendet wird, 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 : 55. Parameter
Name	Typ	Beschreibung
Keine

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

Dieses Beispiel zeigt, wie endOfNextYear() verwendet wird, 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 : 57. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 58. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Datum und -Uhrzeit für das Ende dieses Monats. Format jjjj-mm-tt hh:mm:ss

Dieses Beispiel zeigt, wie endOfThisMonth() verwendet wird, um das GlideDateTime-Objekt auf das Ende des aktuellen Monats zu setzen.

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 : 59. Parameter
Name	Typ	Beschreibung
Keine

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

Dieses Beispiel zeigt, wie endOfThisQuarter() verwendet wird, um das GlideDateTime-Objekt auf das Ende des aktuellen Monats zu setzen.

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 : 61. Parameter
Name	Typ	Beschreibung
Keine

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

Dieses Beispiel zeigt, wie endOfThisWeek() verwendet wird, um das GlideDateTime-Objekt auf das Ende des aktuellen Monats zu setzen.

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 : 63. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 64. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Datum und -Uhrzeit für das Ende dieses Jahres. Format jjjj-mm-tt hh:mm:ss

Dieses Beispiel zeigt, wie endOfThisYear() verwendet wird, um das GlideDateTime-Objekt auf das Ende des aktuellen Monats zu setzen.

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 : 65. Parameter
Name	Typ	Beschreibung
Keine

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

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

Tabelle : 70. 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 : 71. 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 : 72. 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 : 73. 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 : 74. 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 : 75. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 76. Ergebnisse
Typ	Beschreibung
void

Dieses Beispiel zeigt, wie Fehlermeldungen analysiert und zurückgesendet werden und wie die Nachrichten anschließend mit „flushMessages()“ gelöschtwerden.

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 : 77. Parameter
Name	Typ	Beschreibung
Keine

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

Tabelle : 80. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Aktueller Bereichsname.

Dieses Beispiel zeigt, wie getCurrentScopeName() verwendet wird, um den Bereich 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 Benutzer zugeordnet ist.

Tabelle : 81. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 82. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Das dem aktuellen Benutzer zugeordnete Datumsformat.

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

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

Ausgabe:

yyyy-MM-dd

GlideSystem – getDateTimeFormat()

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

Tabelle : 83. Parameter
Name	Typ	Beschreibung
Keine

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

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

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

Ausgabe:

yyyy-MM-dd HH:mm:ss

GlideSystem – getDisplayColumn(String tableName)

Ruft die Anzeigespalte für die Tabelle ab.

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

Tabelle : 86. 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 : 87. 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 : 88. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Anzeigewert für das Feld.

Dieses Beispiel zeigt, wie getDisplayValueFor() verwendet wird, um den Anzeigewert des Zahlenfelds zurückzugeben.

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 : 89. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 90. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Liste der Fehlermeldungen

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

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 : 91. 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 : 92. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Property oder das replaceObject, 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 : 93. Parameter
Name	Typ	Beschreibung
Keine

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

Dieses Beispiel zeigt, wie Sie den Benutzeranzeigenamen des Identitätswechslers erhalten.

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 : 95. Parameter
Name	Typ	Beschreibung
Keine

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

Dieses Beispiel zeigt, wie Sie den Benutzernamen des Identitätswechsels erhalten.

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

Tabelle : 98. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Liste der Infomeldungen.

Dieses Beispiel zeigt, wie Sie die Informationsmeldungen erhalten.

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

GlideSystem – getInitials()

Gibt die Initialen des Benutzers zurück.

Tabelle : 99. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 100. 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 Nachrichtentabelle [sys_ui_message] ab, um sie in einer Benutzeroberfläche anzuzeigen.

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

Weitere Informationen zur Nachrichtentabelle finden Sie unter Nachrichtentabelle.

Hinweis:

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

Tabelle : 101. Parameter
Name	Typ	Beschreibung
messageID	Zeichenfolge	Nachrichtenbezeichner. Sie finden diesen Wert im Feld Schlüssel der Nachrichtentabelle [sys_ui_message]. Beachten Sie, dass das Feld Schlüssel genau wie die tatsächliche Nachrichtenzeichenfolge aussehen kann.
args	Objekt	Optional. Liste der Zeichenfolgen oder anderer Werte, die durch java.text.MessageFormat definiert werden und die Variablen in der angegebenen Nachricht ersetzen. Beispiel: `gs.getMessage("Hinzufügen der Aktion '{0}' abbrechen, derselbe Subflow kann in diesem Subflow nicht zweimal hinzugefügt werden.", current.action.name);` In diesem Beispiel wird `„{0}“` durch den Inhalt von `current.action.name`ersetzt. Hinweis: Die übergebenen Werte werden nicht übersetzt. Sie werden wörtlich in die Nachricht eingefügt.

Tabelle : 102. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Angeforderte UI-Nachricht.

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

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

Ausgabe:

las filas no se actualizarán

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

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

Ausgabe:

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

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

// current.sub_flow.name is 'schedule users'
// current.action.name is "update record"
var my_message = gs.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 Nachrichtentabelle [sys_ui_message] für die aktuelle Sprache vorhanden ist, gibt die Methode die übersetzte Nachricht zurück. Wenn der angegebene Nachrichtenbezeichner für die aktuelle Sprache nicht vorhanden ist, gibt die Methode die englische Version der Nachricht zurück. Wenn der Nachrichtenbezeichner in der Tabelle nicht vorhanden ist, wird die Nachrichten-ID zurückgegeben.

Weitere Informationen zur Nachrichtentabelle finden Sie unter Nachrichtentabelle.

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

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

Tabelle : 104. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Angegebene Nachricht mit Häkchen 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(String message, String language, Array args)

Übersetzt die angegebene Nachricht in die angegebene Sprache.

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

Tabelle : 105. 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 der Zeichenfolgen oder anderer Werte, die durch java.text.MessageFormat definiert werden und die Variablen in 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 wird `„{0}“` durch den Inhalt von `current.action.name`ersetzt. Hinweis: Die übergebenen Werte werden nicht übersetzt. Sie werden wörtlich in die Nachricht eingefügt.

Tabelle : 106. Ergebnisse
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 – getNodeValue(Object obj, Number index)

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

Tabelle : 107. Parameter
Name	Typ	Beschreibung
obj	Objekt	Zu untersuchendes Objekt.
index	Nummer	Index, aus dem der Knotenwert abgerufen werden soll

Tabelle : 108. Ergebnisse
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 – getNodeName(Object obj, Number index)

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

Tabelle : 109. Parameter
Name	Typ	Beschreibung
obj	Objekt	Zu untersuchendes Objekt.
index	Nummer	Index, aus dem der Knotenname abgerufen werden soll.

Tabelle : 110. Ergebnisse
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 – getPreference(String key, Object default)

Gibt die angegebene Benutzereinstellung zurück.

Tabelle : 111. Parameter
Name	Typ	Beschreibung
key	Zeichenfolge	Schlüssel für die Einstellung.
Standard	Objekt	Zu verwendender Standardwert, wenn die angegebene Einstellung nicht gefunden wird.

Tabelle : 112. Ergebnisse
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 der angegebene Wert alt zurückgegeben.

Tabelle : 113. 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 : 114. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Wert der Glide-Eigenschaft oder das oben definierte alternative Objekt.

//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, sondern nur auf Syntaxfehler überprüft.

Tabelle : 115. Parameter
Name	Typ	Beschreibung
Skript	Zeichenfolge	Skript zur Überprüfung auf Fehler.

Tabelle : 116. Ergebnisse
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 : 117. Parameter
Name	Typ	Beschreibung
Keine

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

Tabelle : 120. 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 : 121. Parameter
Name	Typ	Beschreibung
tableName	Zeichenfolge	Tabellenname
fieldName	Zeichenfolge	Feldname
fieldValue	Zeichenfolge	Feldwert

Tabelle : 122. Ergebnisse
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 Benutzer zugeordnet ist.

Tabelle : 123. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 124. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Das dem aktuellen Benutzer zugeordnete Zeitformat.

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 : 125. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 126. Ergebnisse
Typ	Beschreibung
GlideUser	Verweis auf ein Benutzerobjekt für den aktuellen Benutzer.

Das folgende Beispiel zeigt, wie das aktuelle Benutzerobjekt 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 Sie überprüfen können, ob der aktuelle Benutzer die Rolle workflow_admin hat.

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 : 127. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 128. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Das Namensfeld des aktuellen Benutzers. Zum Beispiel gibt diese Methode Abel Tuter zurück und nicht abel.tuter.

In diesem Beispiel wird der Anzeigename des aktuellen Benutzers abgerufen.

gs.info(gs.getUserDisplayName());

Ausgabe:

System Administrator

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 : 129. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 130. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Sys_id des aktuellen Benutzers.

In diesem Beispiel wird die sys_id des aktuellen Benutzers abgerufen.

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 Benutzernamen des aktuellen Benutzers zurück.

Tabelle : 131. Parameter
Name	Typ	Beschreibung
Keine

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

In diesem Beispiel werden der Benutzername des aktuellen Benutzers und ein Benutzer, dessen Identität Sie annehmen, abgerufen.

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(String user_id)

Gibt den Benutzeranzeigenamen basierend auf einem angegebenen Benutzeranmeldungsnamen zurück.

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

Tabelle : 134. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Anzeigename des angeforderten Benutzers. Hinweis: Wenn diese Methode keinen Benutzer mit der angeforderten ID finden kann, gibt sie den angegebenen Eingabewert zurück.

Das folgende Beispiel zeigt, wie der Anzeigename des angegebenen Benutzers 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 : 135. Parameter
Name	Typ	Beschreibung
xml	Zeichenfolge	Zu analysierendes XML-Dokument.

Tabelle : 136. Ergebnisse
Typ	Beschreibung
Array-Liste	Liste der Namen und Werte des äußersten XML-Knotens.

Das folgende Beispiel zeigt, wie eine Liste von XML-Knoten und die zugehörigen Werte in einer Array-Liste abgerufen wird.

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 : 137. Parameter
Name	Typ	Beschreibung
xml	Zeichenfolge	Zu suchende XML-Zeichenfolge.
xpathQuery	Zeichenfolge	Abzugleichende XPath-Abfrage.

Tabelle : 138. Ergebnisse
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 : 139. Parameter
Name	Typ	Beschreibung
roleName	Zeichenfolge	Kommagetrennte Liste von Rollen.

Tabelle : 140. Ergebnisse
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob der aktuelle Benutzer mindestens eine der angegebenen Rollen hat. Mögliche Werte: true: Benutzer hat mindestens eine der übergebenen Rollen. Gibt auch „true“ zurück, wenn der Benutzer die Administratorrolle hat. false: Benutzer hat keine der übergebenen Rollen.

Das folgende Beispiel zeigt, wie überprüft werden kann, ob der aktuelle Benutzer 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 : 141. Parameter
Name	Typ	Beschreibung
roleName	Objekt	Name der Rolle.
Gruppe	Objekt	Sys_id der Gruppe, in der nach der angegebenen Rolle gesucht werden soll.

Tabelle : 142. Ergebnisse
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob der aktuelle Benutzer die angegebene Rolle in der angegebenen Gruppe hat. Mögliche Werte: true: Der angemeldete Benutzer wird der angegebenen Rolle in der angegebenen Gruppe zugewiesen. false: Der angemeldete Benutzer ist nicht der angegebenen Rolle in der angegebenen Gruppe zugewiesen.

Das folgende Beispiel zeigt, wie überprüft wird, ob die Gruppe „sys_user_group“ die Rolle „role_name“ hat.

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 zurückliegenden Stunden zurück. Der zurückgegebene Wert wird an die Zeitzone der Instanz angepasst.

Tabelle : 143. Parameter
Name	Typ	Beschreibung
hours	Nummer	Anzahl der zurückliegenden Stunden.

Tabelle : 144. Ergebnisse
Typ	Beschreibung
Zeichenfolge	UTC-Datum und -Uhrzeit für die angegebene Anzahl von zurückliegenden 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 Stundenende für die angegebene Anzahl von zurückliegenden Stunden zurück. Der zurückgegebene Wert wird an die Zeitzone der Instanz angepasst.

Tabelle : 145. Parameter
Name	Typ	Beschreibung
Stunden	Zahl (Integer)	Anzahl der zurückliegenden Stunden.

Tabelle : 146. Ergebnisse
Typ	Beschreibung
Zeichenfolge	UTC-Datum und -Uhrzeit für das Ende der angegebenen Anzahl von zurückliegenden 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 zurückliegenden Stunden zurück. Der zurückgegebene Wert wird an die Zeitzone der Instanz angepasst.

Tabelle : 147. Parameter
Name	Typ	Beschreibung
hours	Nummer	Anzahl der zurückliegenden Stunden.

Tabelle : 148. Ergebnisse
Typ	Beschreibung
Zeichenfolge	UTC-Datum und -Uhrzeit für das Ende der angegebenen Anzahl von zurückliegenden 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 : 149. Parameter
Name	Typ	Beschreibung
date	Objekt	Datumsobjekt, an dem das Datum überprüft werden soll, z. B. GlideDateTime oder GlideDate.

Tabelle : 150. Ergebnisse
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob das Datum im angegebenen Datumsobjekt der erste Tag des Monats ist. Mögliche Werte: true: Erster Tag des Monats. false: Nicht der erste Tag des Monats.

Dieses Beispiel zeigt, wie Sie feststellen können, 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. Diese Methode verwendet den ISO-Standard von Montag, dem ersten Tag der Woche.

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

Tabelle : 152. Ergebnisse
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob das Datum im aktuellen Datumsobjekt der erste Tag der Woche (Montag) ist. Mögliche Werte: true: Erster Tag der Woche. false: Nicht der erste Tag der Woche.

Dieses Beispiel zeigt, wie Sie feststellen können, 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 : 153. Parameter
Name	Typ	Beschreibung
date	Objekt	Datumsobjekt, an dem das Datum überprüft werden soll, z. B. GlideDateTime oder GlideDate.

Tabelle : 154. Ergebnisse
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob das Datum im angegebenen Datumsobjekt der erste Tag des Jahres ist. Mögliche Werte: true: Erster Tag des Jahres. false: Nicht der erste Tag des Jahres.

Dieses Beispiel zeigt, wie Sie feststellen können, 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 : 155. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 156. Ergebnisse
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob die Sitzung interaktiv ist. Mögliche Werte: true: Sitzung ist interaktiv. false: 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 : 157. Parameter
Name	Typ	Beschreibung
date	Objekt	Datumsobjekt, an dem das Datum überprüft werden soll, z. B. GlideDateTime oder GlideDate.

Tabelle : 158. Ergebnisse
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob das Datum im angegebenen Datumsobjekt der letzte Tag des Monats ist. Mögliche Werte: true: Letzter Tag des Monats. false: Nicht der letzte Tag des Monats.

Dieses Beispiel zeigt, wie Sie feststellen können, 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. Diese Methode verwendet den ISO-Standard für Sonntag als letzten Tag der Woche.

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

Tabelle : 160. Ergebnisse
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob das Datum im aktuellen Datumsobjekt der letzte Tag der Woche (Sonntag) ist. Mögliche Werte: true: Letzter Tag der Woche. false: Nicht der letzte Tag der Woche.

Dieses Beispiel zeigt, wie Sie feststellen können, 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 : 161. Parameter
Name	Typ	Beschreibung
date	Objekt	Datumsobjekt, an dem das Datum überprüft werden soll, z. B. GlideDateTime oder GlideDate.

Tabelle : 162. Ergebnisse
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob das Datum im aktuellen Datumsobjekt der letzte Tag des Jahres ist. Mögliche Werte: true: Letzter Tag des Jahres. false: Nicht der letzte Tag des Jahres.

Dieses Beispiel zeigt, wie Sie feststellen können, 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 : 163. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 164. Ergebnisse
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob der aktuelle Benutzer angemeldet ist. Mögliche Werte: true: Benutzer ist angemeldet. false: Benutzer ist nicht angemeldet.

Dieses Beispiel zeigt, wie Sie feststellen können, ob der aktuelle Benutzer 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 : 165. Parameter
Name	Typ	Beschreibung
Keine

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

Dieses Beispiel zeigt, wie Sie feststellen können, 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 : 167. Parameter
Name	Typ	Beschreibung
Keine

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

Dieses Beispiel zeigt, wie Sie das Datum erhalten, das eine Woche nach 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 : 169. Parameter
Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Zu protokollierende Nachricht.
Quelle	Zeichenfolge	Optional. Quelle der Nachricht.

Tabelle : 170. Ergebnisse
Typ	Beschreibung
void

Das folgende Beispiel zeigt, wie ein Protokolleintrag mit 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 : 171. Parameter
Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Zu protokollierende Fehlermeldung.
Quelle	Zeichenfolge	Optional. Quelle der Nachricht.

Tabelle : 172. Ergebnisse
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 : 173. Parameter
Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Zu protokollierende Nachricht.
Quelle	Zeichenfolge	Optional. Quelle der Nachricht.

Tabelle : 174. Ergebnisse
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 zurückliegenden Minuten zurück.

Tabelle : 175. Parameter
Name	Typ	Beschreibung
minutes	Nummer	Anzahl der zurückzugebenden Minuten in der Vergangenheit.

Tabelle : 176. Ergebnisse
Typ	Beschreibung
Zeichenfolge	UTC-Datum und -Uhrzeit für die angegebene Anzahl von zurückliegenden Minuten. Format: jjjj-mm-tt hh:mm:ss

Dieses Beispiel zeigt, wie die minutesAgo()-Methode 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 : 177. Parameter
Name	Typ	Beschreibung
minutes	Nummer	Ganzzahl in Minuten, z. B. 5 oder 11.

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

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

var nowDateTime = new GlideDateTime();
gs.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 : 179. Parameter
Name	Typ	Beschreibung
minutes	Nummer	Ganzzahl in Minuten, z. B. 15 oder 112.

Tabelle : 180. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT vor der angegebenen Anzahl von Minuten, am Anfang der Minute. Format: jjjj-mm-tt hh:mm:ss

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

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

Ausgabe

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

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 : 181. Parameter
Name	Typ	Beschreibung
months	Nummer	Anzahl der zurückliegenden Monate als Ganzzahl.

Tabelle : 182. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT der angegebenen Anzahl von Monaten, die genau zur gleichen Zeit zurückliegt. Format: jjjj-mm-tt hh:mm:ss

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

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

Ausgabe

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

Bereichsbezogenes Äquivalent

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

GlideSystem – monthsAgoEnd(Number months)

Gibt ein Datum und eine Uhrzeit für den letzten Tag des Monats vor einer bestimmten Anzahl von Monaten zurück.

Tabelle : 183. Parameter
Name	Typ	Beschreibung
months	Nummer	Ganzzahl der Monate, z. B. 4 oder 16.

Tabelle : 184. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Ende 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 zwei Monaten am Ende des Geschäftsmonats.

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-09-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 : 185. Parameter
Name	Typ	Beschreibung
months	Nummer	Ganzzahl für Anzahl der zurückliegenden Monate, z. B. 5 oder 14.

Tabelle : 186. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Beginn des Monats, der die angegebene Anzahl von Monaten zurückliegt. Format: jjjj-mm-tt hh:mm:ss

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

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

Ausgabe

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

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 : 187. Parameter
Name	Typ	Beschreibung
obj	Objekt	Zu überprüfendes Objekt.

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

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

Tabelle : 192. 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 benutzerdefinierten Format zurück.

Tabelle : 193. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 194. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Aktuelles Datum und Uhrzeit im benutzerdefinierten Format. Weitere Informationen zum Festlegen des Systemdatums- und -zeitformats finden Sie unter Datum 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 : 195. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 196. 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 : 197. Parameter
Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Zu protokollierende Meldung

Tabelle : 198. 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 : 199. Parameter
Name	Typ	Beschreibung
quarters	Nummer	Ganzzahl der Quartale zurück.

Tabelle : 200. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT des Quartals, das die angegebene Anzahl von Quartalen zurückliegt. Format: jjjj-mm-tt hh:mm:ss

Im folgenden Beispiel werden das aktuelle Datum und die Uhrzeit sowie das Datum und die Uhrzeit vor vier Quartalen gleichzeitig angezeigt.

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 : 201. Parameter
Name	Typ	Beschreibung
quarters	Zahl	Ganzzahl von Quartalen

Tabelle : 202. 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 : 203. Parameter
Name	Typ	Beschreibung
quarters	Zahl	Ganzzahl von Quartalen

Tabelle : 204. 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 : 205. 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 : 206. 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 : 207. Parameter
Name	Typ	Beschreibung
URI	Objekt	URI, der als Umleitung festgelegt werden soll

Tabelle : 208. 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 : 209. Parameter
Name	Typ	Beschreibung
URI	Objekt	URI, der als Rückkehrort festgelegt werden soll.

Tabelle : 210. 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 der Instanz ServiceNow vorhanden ist.

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

Tabelle : 212. Ergebnisse
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob die angegebene Tabelle in der Instanz ServiceNow vorhanden ist. Mögliche Werte: true: Tabelle ist vorhanden false: Tabelle ist nicht vorhanden

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

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

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

Ausgabe

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

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 : 213. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 214. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Sys_id des aktuellen Benutzers.

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

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

// Filter results to incidents assigned to the current user
var currentUserSysId = gs.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 Datensätze offener geplanter Aufgaben in der Zeitplantabelle (sys_trigger) für den angegebenen GlideRecord.

Tabelle : 215. Parameter
Name	Typ	Beschreibung
glideRecord	Objekt	GlideRecord

Tabelle : 216. Ergebnisse
Typ	Beschreibung
void

GlideSystem – yearsAgo(Number years)

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

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

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

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