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“`.
message	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 Anfang der letzten Woche. Format: jjjj-mm-tt hh:mm:ss

In diesem Beispiel wird der Wert des aktuellen Glide-Datums-/Uhrzeit-Datensatzes 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 der nächsten Woche. Format: jjjj-mm-tt hh:mm:ss

In diesem Beispiel wird der Wert des aktuellen Glide-Datums-/Uhrzeit-Datensatzes 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 Anfang des nächsten Monats. Format: jjjj-mm-tt hh:mm:ss

In diesem Beispiel wird der Wert des aktuellen Glide-Datums-/Uhrzeit-Datensatzes 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-Datums-/Uhrzeit-Datensatzes 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 Datum und 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-Anfang des aktuellen Monats. Format: jjjj-mm-tt hh:mm:ss

In diesem Beispiel wird der Wert des aktuellen Glide-Datums-/Uhrzeit-Datensatzes auf den Beginn dieses Monats festgelegt.

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

Bereichsbezogenes Äquivalent

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

GlideSystem – beginningOfThisQuarter()

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

Tabelle : 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-Datums-/Uhrzeit-Datensatzes 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-Datums-/Uhrzeit-Datensatzes 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-Anfang des aktuellen Jahres. Format: jjjj-mm-tt hh:mm:ss

In diesem Beispiel wird der Wert des aktuellen Glide-Datums-/Uhrzeit-Datensatzes 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-Datums-/Uhrzeit-Datensatzes auf den Beginn des aktuellen Tages festgelegt.

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

GlideSystem – beginnendOfTomorrow ()

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 morgen. Format: jjjj-mm-tt hh:mm:ss

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

GlideSystem – beginningOfYesterday()

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

Tabelle : 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, lesen Sie den Abschnitt „Während eines bestimmten Zeitplans berechnen“ im Thema Nützliche Planungsskripts.

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

Tabelle : 32. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Wenn der Parameter numericValue auf „wahr“ festgelegt ist, wird die Differenz zwischen den beiden Datumsangaben als Ganzzahl in Sekunden zurückgegeben. Bei „falsch“ wird die Differenz zwischen den beiden Datumsangaben im Format „tt 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	In GMT zu generierendes Datum. Format: jjjj-mm-tt
range	Zeichenfolge	Start, Ende oder eine Zeit. 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 `endet`, lautet der Rückgabewert JJJJ-MM-TT 23:59:59. Format: jjjj-mm-tt hh:mm:ss

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

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

Ausgabe:

Count: 7

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

In diesem Beispiel wird daysAgoEnd() zum Festlegen des Enddatums beim Abfragen von Datensätzen in der Incident-Tabelle verwendet.

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 vom Ende des letzten Monats. Format: jjjj-mm-tt hh:mm:ss

In diesem Beispiel wird gezeigt, 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 Formatieren Sie JJJJ-MM-TT hh:mm:ss

Dieses Beispiel zeigt, wie KB-Wissensdatensätze abgefragt werden, die seit dem 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. Formatieren Sie 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 zu setzen.

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. Formatieren Sie JJJJ-MM-TT hh:mm:ss

In diesem Beispiel wird gezeigt, wie endOfdiesMonth() verwendet wird, um das GlideDateTime-Objekt auf das Ende des aktuellen Monats festzulegen.

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

Bereichsbezogenes Äquivalent

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

GlideSystem – endOfThisQuarter()

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

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

In diesem Beispiel wird gezeigt, wie endOfDieseQuarter() 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

In diesem Beispiel wird gezeigt, wie endOfDieseWeek() 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. Formatieren Sie JJJJ-MM-TT hh:mm:ss

In diesem Beispiel wird gezeigt, wie endOfdiesYear() 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

In diesem Beispiel wird gezeigt, wie Fehlermeldungen analysiert und zurückgegeben werden und wie die Nachrichten dann 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	Name des aktuellen Bereichs.

Dieses Beispiel zeigt, wie getCurrentScopeName() verwendet wird, um den Umfang des Prozessors abzurufen.

var incident_GR = new GlideRecord('Incident');

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

Bereichsbezogenes Äquivalent

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

GlideSystem – getDateFormat()

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

Tabelle : 81. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 82. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Das Datumsformat, das dem aktuellen Anwender zugeordnet ist.

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

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

Ausgabe:

yyyy-MM-dd

GlideSystem – getDateTimeFormat()

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

Tabelle : 83. Parameter
Name	Typ	Beschreibung
Keine

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

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

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

Ausgabe:

yyyy-MM-dd HH:mm:ss

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 wird

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	Eigenschaft oder das Ersatzobjekt, 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 Anwenders, der die Identität des Anwenders annimmt.

In diesem Beispiel wird gezeigt, wie Sie den Benutzeranzeigenamen des Identitätswechsels abrufen.

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

In diesem Beispiel wird gezeigt, wie Sie den Anwendernamen 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 Infonachrichten.

In diesem Beispiel wird gezeigt, wie Sie die Informationsnachrichten abrufen.

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 Anwenderoberfläche anzuzeigen.

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

Weitere Informationen zur Nachrichtentabelle finden Sie unter Nachrichtentabelle.

Hinweis:

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

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

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

Dieses Beispiel zeigt die für den aktuellen Anwender zurückgegebene Nachricht, wenn Spanisch die aktuelle Sprache ist.

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

Ausgabe:

las filas no se actualizarán

In diesem Beispiel wird gezeigt, wie eine einzelne Variable in einer Nachricht ersetzt wird.

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

Ausgabe:

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

In diesem Beispiel wird gezeigt, wie mehrere Variablen in einer Nachricht ersetzt werden.

// current.sub_flow.name is 'schedule users'
// current.action.name is "update record"
var my_message = gs.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 Tabelle „Nachricht“ [sys_ui_message]. Beachten Sie, dass das Feld Schlüssel genau wie die tatsächliche Nachrichtenzeichenfolge aussehen kann.
args	Objekt	Optional. Liste von Zeichenfolgen oder anderen durch java.text.MessageFormat definierten Werten, die die Variablen innerhalb der angegebenen Nachricht ersetzen. Beispiel: `gs.getMessage("Hinzufügen der Aktion '{0}' abbrechen, derselbe Subflow kann in diesem Subflow nicht zweimal hinzugefügt werden.", current.action.name);` In diesem Beispiel wird `„{0}“` durch den Inhalt von `current.action.name`ersetzt. Hinweis: Die übergebenen Werte werden nicht übersetzt. Sie werden wortgetreu in die Nachricht eingefügt.

Tabelle : 104. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Angegebene Nachricht mit Escape-Zeichen für Häkchen.

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

Ausgabe:

J'aime la France

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

Übersetzt die angegebene Nachricht in die angegebene Sprache.

Sie können 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 von Zeichenfolgen oder anderen durch java.text.MessageFormat definierten Werten, die die Variablen innerhalb der angegebenen Nachricht ersetzen. Beispiel: `gs.getMessageLang("Hinzufügen der Aktion '{0}' abbrechen, derselbe Subflow kann in diesem Subflow nicht zweimal hinzugefügt werden.", current.action.name);` In diesem Beispiel wird `„{0}“` durch den Inhalt von `current.action.name`ersetzt. Hinweis: Die übergebenen Werte werden nicht übersetzt. Sie werden wortgetreu 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 – getNodeName(Object obj, Number index)

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

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

Tabelle : 108. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Name des Knotens

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

GlideSystem – getNodeValue(Object obj, Number index)

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

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

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

Gibt die angegebene Anwendereinstellung 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 wird, wenn die Eigenschaft nicht gefunden wird.

Tabelle : 114. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Wert der Glide-Eigenschaft oder des oben definierten alternativen Objekts.

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

GlideSystem – getScriptError(String script)

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

Hinweis:

Das Skript wird von dieser Funktion nicht ausgeführt, 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 Anwender zugeordnet ist.

Tabelle : 123. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 124. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Das dem aktuellen Anwender 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 Anwenderobjekt für den aktuellen Anwender.

Das folgende Beispiel zeigt, wie Sie das aktuelle Anwenderobjekt abrufen.

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

Ausgabe:

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

Im folgenden Beispiel wird gezeigt, wie überprüft wird, ob der aktuelle Benutzer über die Rolle workflow_admin verfügt.

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

Ausgabe:

Does the current user have the workflow_admin role: true

Bereichsbezogenes Äquivalent

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

GlideSystem – getUserDisplayName()

Ruft den Anzeigenamen des aktuellen Benutzers ab.

Tabelle : 127. Parameter
Name	Typ	Beschreibung
Keine

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

In diesem Beispiel wird der Anzeigename des aktuellen Anwenders abgerufen.

gs.info(gs.getUserDisplayName());

Ausgabe:

System Administrator

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 Anwenders.

In diesem Beispiel wird die sys_id des aktuellen Anwenders 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 Anwendernamen des aktuellen Anwenders 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 anstelle von Abel Tuter zurück.

In diesem Beispiel wird der Anwendername des aktuellen -Anwenders sowie des Anwenders abgerufen, dessen Identität angenommen wurde.

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

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

Ausgabe:

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

Bereichsbezogenes Äquivalent

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

GlideSystem – getUserNameByUserID(Zeichenfolge user_id)

Gibt den Anzeigenamen des Anwenders basierend auf einem angegebenen Anwenderanmeldungsnamen zurück.

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

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

Das folgende Beispiel zeigt, wie Sie den Anzeigenamen des angegebenen Anwenders abrufen.

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 von allen Knoten und Werten 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 Sie eine Liste von XML-Knoten und die zugehörigen Werte in einer Array-Liste abrufen.

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

Ausgabe:

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

GlideSystem – getXMLText(String xml, String xpathQuery)

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

Tabelle : 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 Sie den Wert eines angegebenen XML-Elements innerhalb eines übergebenen Knotens abrufen.

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 der Rollen.

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

Das folgende Beispiel zeigt, wie überprüft wird, ob der aktuelle Benutzer die Rolle admin oder organizations_admin besitzt.

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, für die nach der angegebenen Rolle gesucht werden soll.

Tabelle : 142. Ergebnisse
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob der aktuelle Anwender über die angegebene Rolle in der angegebenen Gruppe verfügt. Mögliche Werte: wahr: Der angemeldete Benutzer wird der angegebenen Rolle in der angegebenen Gruppe zugewiesen. „falsch“: Der angemeldete Anwender ist nicht der angegebenen Rolle in der angegebenen Gruppe zugewiesen.

Im folgenden Beispiel wird gezeigt, wie überprüft wird, ob die Gruppe sys_user_group über die Rolle role_name verfügt.

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

GlideSystem – hoursAgo(Number hours)

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

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

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

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

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

Ausgabe

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

Bereichsbezogenes Äquivalent

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

GlideSystem – hoursAgoEnd(Number hours)

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

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

Tabelle : 146. Ergebnisse
Typ	Beschreibung
Zeichenfolge	UTC-Datum und Uhrzeit für das Ende der angegebenen Anzahl von Stunden. Format: jjjj-mm-tt hh:mm:ss

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

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

Ausgabe

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

Bereichsbezogenes Äquivalent

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

GlideSystem – hoursAgoStart(Number hours)

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

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

Tabelle : 148. Ergebnisse
Typ	Beschreibung
Zeichenfolge	UTC-Datum und Uhrzeit für das Ende der angegebenen Anzahl von Stunden. Format: jjjj-mm-tt hh:mm:ss

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

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

Ausgabe

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

Bereichsbezogenes Äquivalent

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

GlideSystem – isFirstDayOfMonth(Object date)

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

Tabelle : 149. Parameter
Name	Typ	Beschreibung
date	Objekt	Datumsobjekt, für das 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.

In diesem Beispiel wird gezeigt, wie ermittelt wird, ob das Datum im angegebenen Datumsobjekt der erste Tag des Monats ist.

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

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

Ausgabe

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

GlideSystem – isFirstDayOfWeek(Object date)

Überprüft, ob das Datum im angegebenen Datumsobjekt der erste Tag der Woche ist. Diese Methode verwendet den ISO-Standard, bei dem Montag der erste Tag der Woche ist.

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

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

In diesem Beispiel wird gezeigt, wie ermittelt wird, ob das Datum im angegebenen Datumsobjekt der erste Tag der Woche ist.

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

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

Ausgabe

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

GlideSystem – isFirstDayOfYear(Object date)

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

Tabelle : 153. Parameter
Name	Typ	Beschreibung
date	Objekt	Datumsobjekt, für das 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.

In diesem Beispiel wird gezeigt, wie ermittelt wird, ob das Datum im angegebenen Datumsobjekt der erste Tag des Jahres ist.

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

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

Ausgabe

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

GlideSystem – isInteractive()

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

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

Tabelle : 155. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 156. Ergebnisse
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob die Sitzung interaktiv ist. Mögliche Werte: wahr: Sitzung ist interaktiv. „falsch“: Sitzung ist nicht interaktiv.

if (!gs.hasRole('admin') && gs.isInteractive()) {
  var qc1 = current.addQuery('u_group', '');
  var gra = new GlideRecord('sys_user_grmember');
  gra.addQuery('user', gs.getUserID());
  gra.query();
  while (gra.next()) {
    qc1.addOrCondition('u_group', gra.group);
  }
}

Bereichsbezogenes Äquivalent

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

GlideSystem – isLastDayofMonth(Object date)

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

Tabelle : 157. Parameter
Name	Typ	Beschreibung
date	Objekt	Datumsobjekt, für das 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.

In diesem Beispiel wird gezeigt, wie ermittelt wird, ob das Datum im angegebenen Datumsobjekt der letzte Tag des Monats ist.

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

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

Ausgabe

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

GlideSystem – isLastDayOfWeek(Object date)

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

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

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

In diesem Beispiel wird gezeigt, wie ermittelt wird, ob das Datum im angegebenen Datumsobjekt der letzte Tag der Woche ist.

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

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

Ausgabe

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

GlideSystem – isLastDayOfYear(Object date)

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

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

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

In diesem Beispiel wird gezeigt, wie ermittelt wird, ob das Datum im angegebenen Datumsobjekt der letzte Tag des Jahres ist.

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

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

Ausgabe

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

GlideSystem – isLoggedIn()

Ermittelt, ob der aktuelle Benutzer derzeit angemeldet ist.

Tabelle : 163. Parameter
Name	Typ	Beschreibung
Keine

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

In diesem Beispiel wird gezeigt, wie Sie bestimmen können, ob der aktuelle Anwender angemeldet ist.

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

Ausgabe

Current user is logged in

Bereichsbezogenes Äquivalent

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

GlideSystem – isMobile()

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

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

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

In diesem Beispiel wird gezeigt, wie ermittelt wird, ob das aktuelle Gerät ein Mobilgerät ist.

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

Ausgabe

Submitted from mobile UI

Bereichsbezogenes Äquivalent

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

GlideSystem – lastWeek()

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

Tabelle : 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 das Datum abgerufen wird, 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 Sie einen Protokolleintrag mithilfe von Konstanten und Variablen veröffentlichen.

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 Minuten zurück.

Tabelle : 175. Parameter
Name	Typ	Beschreibung
minutes	Nummer	Anzahl der Minuten in der Vergangenheit für die Rückgabe.

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

Dieses Beispiel zeigt, wie die Methode MinutenAgo () in einem Aufruf von addQuery () 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 Anzahl der Minuten, z. B. 5 oder 11.

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

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

var nowDateTime = new GlideDateTime();
gs.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 Anzahl der Minuten, z. B. 15 oder 112.

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

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

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

Ausgabe

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

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	Ganzzahlige Anzahl von Monaten vor.

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

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

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

Ausgabe

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

Bereichsbezogenes Ä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	Ganzzahlige Anzahl der Monate, z. B. 4 oder 16.

Tabelle : 184. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Monatsende vor der angegebenen Anzahl von Monaten. Format: jjjj-mm-tt hh:mm:ss

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

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

Ausgabe

Now: 2021-10-20 19:23:35
End of the month: 2021-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	Ganzzahlige Anzahl der Monate vor, z. B. 5 oder 14.

Tabelle : 186. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT-Beginn des Monats vor der angegebenen Anzahl von Monaten. Format: jjjj-mm-tt hh:mm:ss

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

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

Ausgabe

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

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 anwenderdefinierten Format zurück.

Tabelle : 193. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 194. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Aktuelles Datum und Uhrzeit im anwenderdefinierten Format. Weitere Informationen zum Festlegen des Systemformats für Datum und Uhrzeit finden Sie unter Felder für Datum und Datum/Uhrzeit.

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	Ganzzahlige Anzahl der Quartale vor.

Tabelle : 200. Ergebnisse
Typ	Beschreibung
Zeichenfolge	GMT des Quartals, das die angegebene Anzahl von Quartalen her war. 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: wahr: Tabelle ist vorhanden false: Tabelle ist nicht vorhanden

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

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

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

Ausgabe

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

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 Anwenders.

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

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

// Filter results to incidents assigned to the current user
var currentUserSysId = gs.userID();
incidentGR.addQuery('assigned_to', currentUserSysId);
incidentGR.query();

while (incidentGR.next()) {
    incidentGR.setValue('assigned_to', 'NULL');
    incidentGR.update();
    gs.info(
        'Unassigned Incident: {0}: {1}',
        incidentGR.number.toString(),
        incidentGR.short_description.toString()
    );
}

Ausgabe:

Unassigned Incident: INC0000057: Performance problems with wifi
Unassigned Incident: INC0009001: Unable to post content on a Wiki page
Unassigned Incident: INC0008111: ATF : Test1

GlideSystem – workflowFlush(Object glideRecord)

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

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