GlideSystem : Global

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 52 Minuten Lesedauer
  • Die GlideSystem- API, auf die in serverseitigem JavaScript mit dem Variablennamen gs verwiesen wird, bietet eine Reihe praktischer Methoden zum Abrufen von Informationen über das System, den aktuell angemeldeten Benutzer sowie Datums-/Uhrzeitinformationen.

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

    GlideSystem – addErrorMessage(Object message)

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

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

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

    Bereichsbezogenes Äquivalent

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

    GlideSystem – addInfoMessage(Object message)

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

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

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    message Objekt Hinzuzufügende Meldung.
    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    void
    if ((!current.u_date1.nil()) && (!current.u_date2.nil())) {
      var start = current.u_date1.getGlideObject().getNumericValue();
      var end = current.u_date2.getGlideObject().getNumericValue();
      if (start > end) {
        gs.addInfoMessage('start must be before end');
        current.u_date1.setError('start must be before end');
        current.setAbortAction(true);
      }
    }

    Bereichsbezogenes Äquivalent

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

    GlideSystem – addMessage(String type, Object message)

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

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    Typ Zeichenfolge Typ der Nachricht, z. B. „Fehler“ oder „Info“.
    Nachricht Objekt Nachricht, die der aktuellen Sitzung hinzugefügt werden soll.
    Tabelle : 6. Rückgaben
    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. Rückgaben
    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. Rückgaben
    Typ Beschreibung
    Zeichenfolge Datum und Uhrzeit der Generierung.

    Wenn der Bereich startist, lautet der zurückgegebene Wert jjjj-mm-tt 00:00:00.

    Wenn der Bereich endet, lautet der Rückgabewert JJJJ-MM-TT 23:59:59.

    Format: jjjj-mm-tt hh:mm:ss

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

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

    Ausgabe:

    Count: 7

    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öscht werden.

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

    Hinweis:
    Die übergebenen Werte werden nicht übersetzt. Sie werden wortgetreu in die Nachricht eingefügt.
    Tabelle : 102. Rückgaben
    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.nameersetzt.

    Hinweis:
    Die übergebenen Werte werden nicht übersetzt. Sie werden wortgetreu in die Nachricht eingefügt.
    Tabelle : 104. Rückgaben
    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.nameersetzt.

    Hinweis:
    Die übergebenen Werte werden nicht übersetzt. Sie werden wortgetreu in die Nachricht eingefügt.
    Tabelle : 106. Rückgaben
    Typ Beschreibung
    Zeichenfolge Übersetzte Nachricht.

    Im folgenden Beispiel wird die angegebene -Nachricht in Spanisch umgewandelt.

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

    Ausgabe:

    Nuevo correo electrónico

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

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

    Ausgabe:

    Hay 7 correos nuevos para John Smith

    GlideSystem – getNodeName(Object obj, Number index)

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

    Tabelle : 107. Parameter
    Name Typ Beschreibung
    obj Objekt Zu untersuchendes Objekt.
    index Nummer Index, von dem der Knotenname abgerufen werden soll.
    Tabelle : 108. Rückgaben
    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. Rückgaben
    Typ Beschreibung
    Objekt Knotenwert
    function doInsert(nodeList) {
      gs.print('Doing insert');
      var task = new GlideRecord('task');
      task.initialize();
      for (var x=0; x < nodeList.size(); x++) {
        var name = gs.getNodeName(nodeList, x);
        var value = gs.getNodeValue(nodeList, x);
        task.setValue(name, value);
      }
      task.insert();
    }

    GlideSystem – getPreference(String key, Object default)

    Gibt die angegebene Anwendereinstellung zurück.

    Tabelle : 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. Rückgaben
    Typ Beschreibung
    Zeichenfolge Einstellungswert. Wenn es keine Voreinstellung gibt, wird der angegebene Standardwert zurückgegeben.
    function getSelectedProject() {
      var array= new Array();
      var prj_id = gs.getPreference("prj_id"); //This will fetch value from user preference
      var gr = new GlideRecord('pm_project_task');
      gr.addQuery('parent', prj_id);
      gr.addActiveQuery();
      while(gr.next()) {
        array.push(gr.sys_id.toString());
      }
      return array;
    }

    GlideSystem – getProperty(String key, Object alt)

    Gibt den Wert einer Glide-Eigenschaft zurück. Wenn die Eigenschaft nicht gefunden wird, wird 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. Rückgaben
    Typ Beschreibung
    Zeichenfolge Wert der Glide-Eigenschaft oder des oben definierten alternativen Objekts.
    //Check for attachments and add link if there are any
    var attachment_link = '';
    var rec = new GlideRecord('sc_req_item');
    rec.addQuery('sys_id', current.request_item);
    rec.query();
    if(rec.next()){
      if(rec.hasAttachments()){
        attachment_link = gs.getProperty('glide.servlet.uri') + rec.getLink();
      }   
    }

    GlideSystem – getScriptError(String script)

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

    Hinweis:
    Das Skript wird von dieser Funktion nicht ausgeführt, sondern nur auf Syntaxfehler überprüft.
    Tabelle : 115. Parameter
    Name Typ Beschreibung
    Skript Zeichenfolge Skript zur Überprüfung auf Fehler.
    Tabelle : 116. Rückgaben
    Typ Beschreibung
    Zeichenfolge Fehlermeldung. NULL, wenn kein Fehler vorliegt.
    if (gs.isValidScript(current.script) == false)
      {
        current.setAbortAction(true);
        var error = gs.getScriptError(current.script);
        current.script.setError(error);
      }

    GlideSystem – getSession()

    Gibt ein GlideSession-Objekt zurück.

    Tabelle : 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. Rückgaben
    Typ Beschreibung
    Zeichenfolge Stil des angegebenen Felds.
    var returnString = gs.getStyle('<tableName>', '<fieldName>', '<fieldValue>');
    gs.print(returnString);

    GlideSystem – getTimeFormat()

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

    Tabelle : 123. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 124. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Zeitformat, das dem aktuellen Anwender zugeordnet ist.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

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

    Ausgabe:

    HH:mm:ss

    GlideSystem – getUser()

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

    Tabelle : 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. Rückgaben
    Typ Beschreibung
    Zeichenfolge Anzeigename des angeforderten Anwenders.
    Hinweis:
    Wenn diese Methode keinen Anwender mit der angeforderten ID finden kann, wird der angegebene Eingabewert zurückgegeben.

    Das folgende Beispiel zeigt, wie 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. Rückgaben
    Typ Beschreibung
    Array-Liste Liste der Namen und Werte des äußersten XML-Knotens.

    Das folgende Beispiel zeigt, wie Sie eine Liste von XML-Knoten und 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. Rückgaben
    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. Rückgaben
    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. Rückgaben
    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. Rückgaben
    Typ Beschreibung
    Zeichenfolge UTC-Datum und -Uhrzeit für die angegebene Anzahl von Stunden.

    Format: jjjj-mm-tt hh:mm:ss

    var currentDateTime = gs.hoursAgo(0);
    gs.info("Current date/time: " + currentDateTime);
    
    var agoDateTime = gs.hoursAgo(1);
    gs.info("Ago date/time: " + agoDateTime);
    Ausgabe
    Current date/time: 2021-03-17 20:53:25
    Ago date/time: 2021-03-17 19:53:25

    Bereichsbezogenes Äquivalent

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

    GlideSystem – hoursAgoEnd(Number hours)

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

    Tabelle : 145. Parameter
    Name Typ Beschreibung
    Stunden Zahl (Ganzzahl) Anzahl der Stunden.
    Tabelle : 146. Rückgaben
    Typ Beschreibung
    Zeichenfolge UTC-Datum und Uhrzeit für das Ende der angegebenen Anzahl von Stunden.

    Format: jjjj-mm-tt hh:mm:ss

    var currentDateTime = gs.hoursAgoEnd(0);
    gs.print("Current date/time: " + currentDateTime);
    
    var agoDateTime = gs.hoursAgoEnd(1);
    gs.print("Ago date/time: " + agoDateTime);
    Ausgabe
    Current date/time: 2021-03-17 20:59:59
    Ago date/time: 2021-03-17 19:59:59

    Bereichsbezogenes Äquivalent

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

    GlideSystem – hoursAgoStart(Number hours)

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

    Tabelle : 147. Parameter
    Name Typ Beschreibung
    hours Nummer Anzahl der Stunden.
    Tabelle : 148. Rückgaben
    Typ Beschreibung
    Zeichenfolge UTC-Datum und Uhrzeit für das Ende der angegebenen Anzahl von Stunden.

    Format: jjjj-mm-tt hh:mm:ss

    var currentDateTime = gs.hoursAgoStart(0);
    gs.print("Current date/time: " + currentDateTime);
    
    var agoDateTime = gs.hoursAgoStart(1);
    gs.print("Ago date/time: " + agoDateTime);
    Ausgabe
    Current date/time: 2021-03-17 20:00:00
    Ago date/time: 2021-03-17 19:00:00

    Bereichsbezogenes Äquivalent

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

    GlideSystem – isFirstDayOfMonth(Object date)

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

    Tabelle : 149. Parameter
    Name Typ Beschreibung
    date Objekt Datumsobjekt, für das das Datum überprüft werden soll, z. B. GlideDateTime oder GlideDate.
    Tabelle : 150. Rückgaben
    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. Rückgaben
    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. Rückgaben
    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. Rückgaben
    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. Rückgaben
    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. Rückgaben
    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. Rückgaben
    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. Rückgaben
    Typ Beschreibung
    void

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

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

    GlideSystem – logWarning(String message, String source)

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

    Tabelle : 173. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Zu protokollierende Nachricht.
    Quelle Zeichenfolge Optional. Quelle der Nachricht.
    Tabelle : 174. Rückgaben
    Typ Beschreibung
    void

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

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

    GlideSystem – minutesAgo(Number minutes)

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

    Tabelle : 175. Parameter
    Name Typ Beschreibung
    minutes Nummer Anzahl der Minuten in der Vergangenheit für die Rückgabe.
    Tabelle : 176. Rückgaben
    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. Rückgaben
    Typ Beschreibung
    Zeichenfolge GMT der angegebenen Anzahl von Minuten vor, am Ende der Minute (59 Sekunden).

    Format: jjjj-mm-tt hh:mm:ss

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

    var nowDateTime = new GlideDateTime();
    gs.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. Rückgaben
    Typ Beschreibung
    Zeichenfolge GMT der angegebenen Anzahl von Minuten, zu Beginn der Minute.

    Format: jjjj-mm-tt hh:mm:ss

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

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

    Ausgabe

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

    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. Rückgaben
    Typ Beschreibung
    Zeichenfolge GMT der angegebenen Anzahl von Monaten zu genau diesem Zeitpunkt.

    Format: jjjj-mm-tt hh:mm:ss

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

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

    Ausgabe

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

    Bereichsbezogenes Äquivalent

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

    GlideSystem – monthsAgoEnd(Number months)

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

    Tabelle : 183. Parameter
    Name Typ Beschreibung
    Monate Zahl (Ganzzahl) Anzahl der Monate, z. B. 4 oder 16.
    Tabelle : 184. Rückgaben
    Typ Beschreibung
    Zeichenfolge Datums- und Zeitstempel des Monats, die angegebene Anzahl der Monate zurück, in Ortszeit.

    Format: UTC jjjj-mm-tt hh:mm:ss

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

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

    Ausgabe:

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

    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. Rückgaben
    Typ Beschreibung
    Zeichenfolge GMT-Beginn des Monats vor der angegebenen Anzahl von Monaten.

    Format: jjjj-mm-tt hh:mm:ss

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

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

    Ausgabe

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

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