GlideElement – Global

Die GlideElement Die API bietet eine Reihe praktischer Skriptmethoden für den Umgang mit Feldern und ihren Werten. GlideElement Methoden sind für die Felder des aktuellen Glide-Datensatzes verfügbar.

GlideElement – canCreate()

Bestimmt, ob die Rolle des Anwenders die Erstellung neuer Einträge im zugehörigen Feld zulässt.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 2. Rückgaben

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob der aktuelle Anwender berechtigt ist, neue Einträge im zugehörigen Feld zu erstellen. Mögliche Werte: Wahr: Anwender kann neue Einträge erstellen. Falsch: Anwender kann keine neuen Einträge erstellen.

Das folgende Beispiel zeigt, wie bestimmt werden kann, ob der Anwender über Berechtigungen zum Erstellen von Einträgen für die drei neuesten Datensätze in der Tabelle „Problem“ [Problem] verfügt.

var gr = new GlideRecord('problem');

// Get records in new state in Problem Table
gr.addQuery('state','101');

// Sort records in order of recent to earlier Created Date
gr.orderByDesc('sys_created_on');

// Limit the query to three records
gr.setLimit(3); 
gr.query();

while(gr.next()){
  if(gr.short_description.canCreate()){ ///check to see if the current user is allowed to create the record
  gs.info("I can create new records for the field Problem statement for - " + gr.number);
  }
}

Ausgabe:

I can create new records for the field Problem statement for - PRB0000004
I can create new records for the field Problem statement for - PRB0001000
I can create new records for the field Problem statement for - PRB0001001

Bereichsbezogenes Äquivalent

Zur Verwendung von CanCreate() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: CanCreate() .

GlideElement – canRead()

Bestimmt, ob die Rolle des Anwenders es ihm ermöglicht, den zugehörigen GlideRecord zu lesen.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 4. Rückgaben

Typ	Beschreibung
Boolean	„Wahr“, wenn das Feld gelesen werden kann, andernfalls „falsch“.

Das folgende Beispiel zeigt, wie eine Liste aktiver Incident-Datensätze mit einem lesbaren Feld „Kurzbeschreibung“ abgerufen wird.

var grIncident = new GlideRecord('incident');
grIncident.addEncodedQuery("active=true"); //Query the Incident table for active incidents
grIncident.orderByDesc('number');
grIncident.setLimit(3); // limit to three results for example
grIncident.query();

while (grIncident.next()) {
    if (grIncident.short_description.canRead()) { //check to see if the current user is allowed to read the record
        gs.info('You have permission to read the short description of: ' + grIncident.number + ' ' + grIncident.short_description);
    }
}

Ausgabe:

*** Script: You have permission to read the short description of: INC0009009 Unable to access the shared folder.
*** Script: You have permission to read the short description of: INC0009005 Email server is down.
*** Script: You have permission to read the short description of: INC0009001 Unable to post content on a Wiki page

Bereichsbezogenes Äquivalent

Zur Verwendung von CanRead() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: CanRead() .

GlideElement – canWrite()

Bestimmt, ob die Rolle des Anwenders es ihm ermöglicht, in den zugehörigen GlideRecord zu schreiben.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 6. Rückgaben

Typ	Beschreibung
Boolean	„Wahr“, wenn der Anwender in das Feld schreiben kann, andernfalls „falsch“.

Das folgende Beispiel zeigt, wie Sie eine Liste aktiver Incident-Datensätze mit einem beschreibbaren Kurzbeschreibungsfeld abrufen.

var grIncident = new GlideRecord('incident');
grIncident.addEncodedQuery("active=true"); //Query the Incident table for active incidents
grIncident.orderByDesc('number');
grIncident.setLimit(3); // limit to three results for example
grIncident.query();

while (grIncident.next()) {
    if (grIncident.short_description.canWrite()) { //check to see if the current user is allowed to write to the record
        gs.info('You have permission to write to the short description of: ' + grIncident.number + ' ' + grIncident.short_description);
    }
}

Ausgabe:

*** Script: You have permission to write to the short description of: INC0009009 Unable to access the shared folder.
*** Script: You have permission to write to the short description of: INC0009005 Email server is down.
*** Script: You have permission to write to the short description of: INC0009001 Unable to post content on a Wiki page

Bereichsbezogenes Äquivalent

Zur Verwendung von CanWrite() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: CanWrite() .

GlideElement – Changes()

Bestimmt, ob das aktuelle Feld geändert wurde. Diese Funktionalität ist für alle verfügbaren Datentypen mit Ausnahme von Journalfeldern verfügbar.

Hinweis:

Die Changes() Die Methode wird in ACL-Skripts nicht unterstützt.

Hinweis:

Wenn der GlideRecord, für den Sie diese Methode ausführen, nur initialisiert und gelesen wurde und nicht geschrieben wurde, sind die zugrunde liegenden vorher-Nachher-Werte identisch. In diesem Fall gibt die Methode „falsch“ zurück, da sich der Datenspeicher nicht geändert hat.

Ausführung der Business-Regel

Die ServiceNow AI Platform Ruft Business-Regeln auf ( BEFOREOder AFTER), bevor die internen vorherigen Werte für Spalten zurückgesetzt werden ( GlideElement Objekte) an die aktuellen Werte.

Diese Sequenz aktiviert die folgenden Aktionen:

• Wird ausgelöst AFTERBusiness-Regel in <column>.Changes-Bedingungen.
• Zugriff auf vorherige GlideRecord Objekt im Skriptabschnitt.

Sogar in AFTERBusiness-Regeln, Aktuell.<field>.Changes() Gibt zurück Wahr Da die internen vorherigen Werte noch nicht zurückgesetzt wurden. Die Bedingung Current.<field>.value != previous.<field>.value Gibt auch zurück Wahr .

Vorherige Werte werden erst nach den folgenden Aktivitäten zurückgesetzt:

• Die Datenbankaktualisierung ist abgeschlossen.
• Alle AFTERBusiness-Regeln wurden verarbeitet.

Innerhalb einer AFTER-Business-Regel Changes() Methode gibt noch zurück Wahr Wenn der Feldwert geändert wurde, obwohl die Regel nach dem Update ausgeführt wird.

Tabelle : 7. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 8. Rückgaben

Typ	Beschreibung
Boolean	„Wahr“, wenn sich das Feld geändert hat, andernfalls „falsch“.

Das folgende Beispiel aus einer Business-Regel zeigt, wie ein Ereignis in der EventQueue erstellt wird, wenn der Wert von ist Assigned_to Feldänderungen. Ein umfassendes Beispiel finden Sie unter Sample scripts from the change events business rule.

if (!current.assigned_to.nil() && current.assigned_to.changes()) {
  gs.eventQueue('incident.assigned', current, current.assigned_to.getDisplayValue(), previous.assigned_to.getDisplayValue());
}

Bereichsbezogenes Äquivalent

Zur Verwendung von Changes() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: Changes() .

GlideElement – changesfrom(Objektwert)

Bestimmt, ob der vorherige Wert des aktuellen Felds mit dem angegebenen Objekt übereinstimmt.

Hinweis:

Wenn der GlideRecord, für den Sie diese Methode ausführen, nur initialisiert und gelesen wurde und nicht geschrieben wurde, sind die zugrunde liegenden vorher-Nachher-Werte identisch. In diesem Fall gibt die Methode „falsch“ zurück, da sich der Datenspeicher nicht geändert hat.

Tabelle : 9. Parameter

Name	Typ	Beschreibung
Wert	Objekt	Ein Objektwert, der anhand des vorherigen Werts des aktuellen Felds überprüft werden soll.

Tabelle : 10. Rückgaben

Typ	Beschreibung
Boolean	„Wahr“, wenn der vorherige Wert mit dem Parameter übereinstimmt, „falsch“, wenn dies nicht der Fall ist.

if (theState.changesTo(resolvedState)) {
  operation = 4; //Resolved
}
else if (theState.changesTo(closedState)) {
  operation = 11; //Resolution Accepted
}
else if (theState.changesFrom(resolvedState) || theState.changesFrom(closedState)) {
  operation = 10; //Re-open
}
else {
  operation = 6; //Update
}

Bereichsbezogenes Äquivalent

Zur Verwendung von Changesfrom() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: Changesfrom() .

GlideElement – changesTo(Objektwert)

Bestimmt, ob der neue Wert eines Felds nach einer Änderung mit dem angegebenen Objekt übereinstimmt.

Hinweis:

Die ChangesTo() Die Methode wird in ACL-Skripts nicht unterstützt.

Hinweis:

Wenn der GlideRecord, für den Sie diese Methode ausführen, nur initialisiert und gelesen wurde und nicht geschrieben wurde, sind die zugrunde liegenden vorher-Nachher-Werte identisch. In diesem Fall gibt die Methode „falsch“ zurück, da sich der Datenspeicher nicht geändert hat.

Tabelle : 11. Parameter

Name	Typ	Beschreibung
Wert	Objekt	Ein Objektwert, der anhand des neuen Werts des aktuellen Felds überprüft werden soll.

Tabelle : 12. Rückgaben

Typ	Beschreibung
Boolean	„Wahr“, wenn der neue Wert mit dem Parameter übereinstimmt, „falsch“, wenn dies nicht der Fall ist.

if (theState.changesTo(resolvedState)) {
  operation = 4; //Resolved
}
else if (theState.changesTo(closedState)) {
  operation = 11; //Resolution Accepted
}
else if (theState.changesFrom(resolvedState) || theState.changesFrom(closedState)) {
  operation = 10; //Re-open
}
else {
  operation = 6; //Update
}

Bereichsbezogenes Äquivalent

Zur Verwendung von ChangesTo() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: ChangesTo() .

GlideElement – dateNumericValue()

Gibt die Anzahl der Millisekunden seit dem 1. Januar 1970, 00:00:00 GMT für ein Feld für die Dauer zurück. Erfordert nicht die Erstellung eines GlideDateTime-Objekts, da das Feld „Dauer“ bereits ein GlideDateTime-Objekt ist.

Tabelle : 13. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 14. Rückgaben

Typ	Beschreibung
Nummer	Anzahl der Millisekunden seit dem 1. Januar 1970, 00:00:00 GMT.

var inc = new GlideRecord('incident');
inc.get('17c90efb13418700cc36b1422244b05d');
gs.info(inc.calendar_duration.dateNumericValue());

Ausgabe: 98000

Bereichsbezogenes Äquivalent

Zur Verwendung von DateNumericWert() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: DateNumericWert() .

GlideElement – Debuggen (Objekt o)

Debuggen des Objekts und fügt Debug-Nachrichten mit hinzu SetError (Zeichenfolge) .

Tabelle : 15. Parameter

Name	Typ	Beschreibung
o	Objekt	Ein Objekt zum Debuggen.

Tabelle : 16. Rückgaben

Typ	Beschreibung
Keine

GlideElement – getAttribute(String attributeName)

Gibt den Wert des angegebenen Attributs aus dem Wörterbuch zurück.

Für boolesche Attribute können Sie verwenden GetBooleanAttribute() Methode zum Rückgeben des Werts als boolescher Wert anstelle einer Zeichenfolge.

Tabelle : 17. Parameter

Name	Typ	Beschreibung
attributeName	Zeichenfolge	Name des Attributs. Der Attributname wird in der Tabelle „Wörterbucheinträge“ [sys_dictionary] aufgeführt.

Tabelle : 18. Rückgaben

Typ	Beschreibung
Zeichenfolge	Wert des angegebenen Attributs.

Das folgende Beispiel zeigt, wie der Wert von abgerufen wird tree_pickerAttribut in locationSpalte der Anwendertabelle [sys_user] als Zeichenfolge.

var now_GR = new GlideRecord('sys_user');
now_GR.query("user_name","admin");

if (now_GR.next()) {
   gs.info("The value of the tree_picker attribute in the location column is " + now_GR.location.getAttribute("tree_picker"));
}

Ausgabe:

The value of the tree_picker attribute in the location column is true

Bereichsbezogenes Äquivalent

Zur Verwendung von GetAttribute() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: GetAttribute() .

GlideElement – getBaseTableName()

Ruft die Basistabelle des Felds ab.

Tabelle : 19. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 20. Rückgaben

Typ	Beschreibung
Zeichenfolge	Name der Basistabelle. Dieser Name kann sich von der Tabelle unterscheiden, in der das Feld definiert ist. Siehe Table extension and classes In der Produktdokumentation.

Das folgende Beispiel zeigt, wie die Basistabelle für das Feld „Zuweisungsgruppe“ eines Incident-Datensatzes verwendet wird.

var gr = new GlideRecord('incident');

//query the Incident Records which have category as Inquiry/Help
gr.addQuery('category','inquiry');

// sort them in the order of earlier to recent created date
gr.orderBy('sys_created_on');
gr.query();

if(gr.next()){ //If at least any one record exists matching this query

  //Print the base table for the Assignment Group field
  gs.print("The Base Table for the field Assignment Group is - " + gr.assignment_group.getBaseTableName()); 
};

Ausgabe:

The Base Table for the field Assignment Group is - task

GlideElement – getBooleanAttribute(Zeichenfolge attributeName)

Gibt ein angegebenes Attribut vom Typ „Boolesch“ aus dem Wörterbuch als booleschen Wert zurück.

Um den Attributwert als Zeichenfolge zurückzugeben, verwenden Sie GetAttribute() Methode.

Tabelle : 21. Parameter

Name	Typ	Beschreibung
attributeName	Zeichenfolge	Name des Attributs. Der Attributname wird in der Tabelle „Wörterbucheinträge“ [sys_dictionary] aufgeführt.

Tabelle : 22. Rückgaben

Typ	Beschreibung
Boolean	Gibt den Wert des Attributs als boolescher Wert „wahr“ oder „falsch“ an.

Das folgende Beispiel zeigt, wie boolesche Werte von abgerufen werden ignore_filter_on_newAttribut für zwei Felder.

var inc = new GlideRecord('incident');
inc.query();

if (inc.next())
 {
   // opened_by field has attribute "ignore_filter_on_new = true"
   gs.info(inc.opened_by.getBooleanAttribute("ignore_filter_on_new"));

  // short_description field does not have attribute ignore_filter_on_new
   gs.info(inc.short_description.getBooleanAttribute("ignore_filter_on_new"));
 }

Ausgabe:

true
false

Bereichsbezogenes Äquivalent

Zur Verwendung von GetBooleanAttribute() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: GetBooleanAttribute() .

GlideElement – getChoices (Zeichenfolgenabhängig)

Generiert eine Auswahlliste für ein Feld. Gibt die Auswahlwerte nur aus der Basistabelle zurück, nicht aus der erweiterten Tabelle.

Tabelle : 23. Parameter

Name	Typ	Beschreibung
Abhängig	Zeichenfolge	Optional. Feld im zugehörigen Datensatz, von dem das Auswahllistenfeld abhängt.

Tabelle : 24. Rückgaben

Typ	Beschreibung
Array-Liste	Die Auswahlwerte für das Feld.

var glideRecord = new GlideRecord('incident'); 
glideRecord.query('priority','1'); 
glideRecord.next(); 
 
// urgency has choice list: 1 - High, 2 - Medium, 3 - Low, with value: 1, 2, 3
var choices = glideRecord.urgency.getChoices();

Bereichsbezogenes Äquivalent

Zur Verwendung von GetChoices() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: GetChoices() .

GlideElement – getChoiceValue()

Ruft die Auswahlbezeichnung für den aktuellen Auswahlwert ab.

Tabelle : 25. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 26. Rückgaben

Typ	Beschreibung
Zeichenfolge	Die Auswahlbezeichnung.

Das folgende Beispiel zeigt, wie die Auswahlbezeichnung für Change-Anforderungsdatensätze mit dem Prioritätswert „Normal“ abgerufen wird.

var gr = new GlideRecord('change_request');

//query for the change records with change type as "Normal"
gr.addQuery('type','normal');

// sort them in the order of recent to earlier Created Date
gr.orderByDesc('sys_created_on'); 

// limit the query to 4 records
gr.setLimit(4); 
gr.query();

while(gr.next()){
 //Printing the choice label for those records
 gs.print("The label of the current priority '"+ gr.priority+"' for the change request - " + gr.number + " is - "+ gr.priority.getChoiceValue()); 
}

Ausgabe:

The label of the current priority '4' for the change request - CHG0000014 is - 4 - Low
The label of the current priority '4' for the change request - CHG0000013 is - 4 - Low
The label of the current priority '4' for the change request - CHG0000012 is - 4 - Low
The label of the current priority '4' for the change request - CHG0000011 is - 4 - Low

Bereichsbezogenes Äquivalent

Zur Verwendung von GetChoiceValue() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: GetChoiceValue() .

GlideElement – getDebugCount()

Ruft die Anzahl der protokollierten Debug-Nachrichten ab Debuggen() .

Tabelle : 27. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 28. Rückgaben

Typ	Beschreibung
Nummer	Die Anzahl der Debug-Nachrichten.

GlideElement – getDependent()

Gibt das Feld (Element) zurück, von dem ein angegebenes Feld abhängig ist.

Tabelle : 29. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 30. Rückgaben

Typ	Beschreibung
Zeichenfolge	Name des Felds, von dem das aktuelle Feld abhängt. Null, wenn keine Abhängigkeiten vorhanden sind.

Das folgende Beispiel zeigt, wie Sie das übergeordnete Feld des Felds „Konfigurationselement“ mithilfe von finden GetDependent() Methode.

var inc_gr = new GlideRecord('incident');
inc_gr.get('985f53d82fab301032e8808cf699b6e8'); // Get a particular Incident

var field_element = inc_gr.getElement('cmdb_ci'); // Get the Configuration Item element
var dependent_field = field_element.getDependent(); // Read the dependent field
gs.info("Dependent field: " + dependent_field);
if(dependent_field)
  {
    var dependent_field_value = inc_gr.getValue(dependent_field);  
    if(!dependent_field_value)
      {
        var base_table = field_element.getRefRecord(); // Retrieve the reference record
        var dependent_field_value = base_table.getValue(dependent_field); // Read the parent field value
      }
    inc_gr.setValue(dependent_field, dependent_field_value); // Update the parent field on the Incident
    inc_gr.update();
  }

Ausgabe:

company

GlideElement – getDependentTable()

Gibt den Namen der Tabelle zurück, von der ein Feld abhängig ist.

Tabelle : 31. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 32. Rückgaben

Typ	Beschreibung
Zeichenfolge	Name der Tabelle, wenn ein Feld eine abhängige Tabelle hat; andernfalls Null.

Das folgende Beispiel zeigt, wie bestimmt wird, ob ein Feld mit dem Namen benannt ist model_idHat eine abhängige Tabelle.

var gr = new GlideRecord('cmdb_ci_hardware');
gr.setLimit(1);
gr.query();

if (gr.next()) {
    var field_element = gr.getElement('model_id'); // Get the model_id field element
    var dependent_table = field_element.getDependentTable(); // Get the table that drives filtering

    gs.info("Field: " + field_element.getLabel());
    gs.info("Dependent table: " + dependent_table); // cmdb_model_category

    if (dependent_table) {
        // Use the dependent table to query what's controlling the filter
        var dep_gr = new GlideRecord(dependent_table);
        if (dep_gr.get(gr.getValue('model_category'))) {
            gs.info("Controlling record: " + dep_gr.getDisplayValue());
            gs.info("Only models belonging to category '" + dep_gr.getDisplayValue() + "' are valid for this CI");
        }
    }
}

Ausgabe:

Field: Model ID
Dependent table: null

GlideElement – getDisplayValue(Number maxChar)

Gibt den formatierten Anzeigewert des Felds zurück.

Anzeigewerte werden basierend auf dem ist-Wert in der Datenbank und den Anwender- oder Systemeinstellungen und -Einstellungen geändert.

Der zurückgegebene Anzeigewert ist vom Feldtyp abhängig.

• Auswahlfelder: Der Datenbankwert kann eine Zahl sein, der Anzeigewert ist jedoch beschreibender.
• Datumsfelder: Der Datenbankwert hat das UTC-Format, während der Anzeigewert auf der Zeitzone des Anwenders basiert.
• Verschlüsselter Text: Der Datenbankwert ist verschlüsselt, während der angezeigte Wert basierend auf dem Verschlüsselungskontext des Anwenders unverschlüsselt ist.
• Referenzfelder: Der Datenbankwert ist sys_ID, der Anzeigewert ist jedoch ein Anzeigefeld des referenzierten Datensatzes.

Tabelle : 33. Parameter

Name	Typ	Beschreibung
MaxChar	Nummer	Optional. Maximale Anzahl von Zeichen, die zurückgegeben werden sollen.

Tabelle : 34. Rückgaben

Typ	Beschreibung
Zeichenfolge	Anzeigewert des Felds.

var fields = current.getFields();
for (var i = 0; i < fields.size(); i++) { 
  var field = fields.get(i);
  var name = field.getName(); 
  var value = field.getDisplayValue(); 
  gs.print(i + ". " + name + "=" + value); 
}

Bereichsbezogenes Äquivalent

Zur Verwendung von GetDisplayValue() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: GetDisplayValue() .

GlideElement – getDisplayValueExt(Zahl maxChar, Zeichenfolge nullSub)

Gibt den formatierten Anzeigewert eines Felds oder einen angegebenen Ersatzwert zurück, wenn der Anzeigewert null oder leer ist.

Anzeigewerte werden basierend auf dem ist-Wert in der Datenbank und den Anwender- oder Systemeinstellungen und -Einstellungen geändert.

Der zurückgegebene Anzeigewert ist vom Feldtyp abhängig.

• Auswahlfelder: Der Datenbankwert kann eine Zahl sein, der Anzeigewert ist jedoch beschreibender.
• Datumsfelder: Der Datenbankwert hat das UTC-Format, während der Anzeigewert auf der Zeitzone des Anwenders basiert.
• Verschlüsselter Text: Der Datenbankwert ist verschlüsselt, während der angezeigte Wert basierend auf dem Verschlüsselungskontext des Anwenders unverschlüsselt ist.
• Referenzfelder: Der Datenbankwert ist sys_ID, der Anzeigewert ist jedoch ein Anzeigefeld des referenzierten Datensatzes.

Tabelle : 35. Parameter

Name	Typ	Beschreibung
MaxChar	Nummer	Optional. Maximale Anzahl von Zeichen, die zurückgegeben werden sollen. Standard: Alle
NullSub	Zeichenfolge	Wert, der zurückgegeben werden soll, wenn der Anzeigewert null oder leer ist.

Tabelle : 36. Rückgaben

Typ	Beschreibung
Zeichenfolge	Formatierter Anzeigewert des Felds oder der angegebene Ersatzwert.

Das folgende Beispiel zeigt, wie die beiden neuesten aktiven Datensätze in der Tabelle „Incidents [Incident]“ angezeigt werden.

var gr = new GlideRecord('incident');
gr.addQuery('active', true);      // get the active records
gr.orderByDesc('sys_updated_on'); // sort the records from most recent to oldest updated date
gr.setLimit(2);                   // limit the query to 2 records
gr.query();

while(gr.next()){ // Printing the Display Value of the Configuration Item field. 
  // If the Display Value is Null/Empty, then it will be substituted with Default value "I with Null/Empty Display Value"
  gs.info("The Display Value of the Configuration Item for the incident - "+ gr.number+ " is " + gr.cmdb_ci.getDisplayValueExt(40, " CI with Null/Empty Display Value"));
}

Ausgabe:

The Display Value of the Configuration Item for the incident - INC0007001 is  CI with Null/Empty Display Value
The Display Value of the Configuration Item for the incident - INC0000069 is NYC RAC

GlideElement – getDisplayValueLang(Zeichenfolgensprache)

Ruft den Anzeigewert des Felds in der als Parameter übergebenen Sprache ab.

Das Ergebnis gilt nur für übersetzbare Feldtypen wie Auswahl , Übersetztes Feld , Und Übersetzter Text . Für andere Feldtypen wird das Ergebnis standardmäßig auf festgelegt GetDisplayValue() .

Sie müssen über das entsprechende Sprach-Plugin verfügen, um einen übersetzten Wert abzurufen. Informationen hierzu finden Sie unter Activate a language.

Siehe auch Bereichsbezogenes GlideElement – getLabellang(Zeichenfolgensprache).

Tabelle : 37. Parameter

Name	Typ	Beschreibung
language	Zeichenfolge	Sprach-Tag gemäß IETF BCP-47.

Tabelle : 38. Rückgaben

Typ	Beschreibung
Zeichenfolge	Anzeigewert des Felds in der übergebenen Sprache. Wenn keine Übersetzung verfügbar ist, ruft die Methode einen Wert ab, der in die Sprache des aktuellen Anwenders übersetzt wurde. Wenn eine Übersetzung nicht verfügbar ist, wird das Ergebnis standardmäßig auf Englisch festgelegt.

Das folgende Beispiel zeigt, wie der Originaltext und der deutsch übersetzte Text aus abgerufen werden Akzeptieren Titelfeld (UI-Ansicht).

var uiView = new GlideRecord("sys_ui_view");
uiView.get("fa776f6d97700100f309124eda2975bc");

gs.info("getDisplayValue: " + uiView.getElement("title").getDisplayValue());
gs.info("getDisplayValueLang: " + uiView.getElement("title").getDisplayValueLang("de"));

Ausgabe:

getDisplayValue: Accept
getDisplayValueLang: Akzeptieren

Bereichsbezogenes Äquivalent

Zur Verwendung von GetDisplayValueLang() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: GetDisplayValueLang() .

GlideElement – getDynamicAttribute()

Gibt eine dynamische Attributdefinition für dieses GlideElement zurück.

Dynamische Attribute haben einen definierten Datentyp und eine sys_ID Weitere Informationen zu dynamischen Attributen finden Sie unter Dynamisches Schema .

Siehe auch:

• GlideDynamicAttribut – Global
• GlideDynamicAttributeStore – Global
• GlideDynamicNamespace – Global

Tabelle : 39. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 40. Rückgaben

Typ	Beschreibung
IDynamicAttribut	Objekt, das das Attribut beschreibt, das das GlideElement darstellt.

Das folgende Beispiel zeigt, wie Werte des Attributs „make“ aus der dynamischen Attributspeicherspalte „u_inc_Dynamic_Schema“ in der Incident-Tabelle abgerufen werden.

var gr_Inc = new GlideRecord('incident');
gr_Inc.query();
if(gr_Inc.next()) {
    var attr = gr_Inc.getDynamicAttribute('inc_dynamic_schema->make');
    gs.info(attr.getValue());
}

GlideElement – getDynamicNamespace()

Gibt ein zurück Dynamischer Namespace Objekt, das für das GlideElement konfiguriert ist.

Dynamische Attribute haben einen definierten Datentyp und eine sys_ID Weitere Informationen zu dynamischen Attributen finden Sie unter Dynamisches Schema .

Siehe auch:

• GlideDynamicAttribut – Global
• GlideDynamicAttributeStore – Global
• GlideDynamicNamespace – Global

Tabelle : 41. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 42. Rückgaben

Typ	Beschreibung
IDynamicNamespace	Objekt, das den dynamischen Namespace beschreibt.

Das folgende Beispiel zeigt, wie das Namespace-Objekt abgerufen wird, das für die dynamische Attributspeicherspalte „INC_Dynamic_Schema“ in der Incident-Tabelle konfiguriert ist.

var gr_Inc = new GlideRecord('incident');
gr_Inc.query();
if (gr_Inc.next()) {
    var ge_Make = gr_Inc.getElement('inc_dynamic_schema->make');
    var namespace = ge_Make.getDynamicNamespace();
 
    gs.info("toString:    " + namespace);
    gs.info("name:        " + namespace.getName());
    gs.info("isActive:    " + namespace.isActive());
    gs.info("isTransient: " + namespace.isTransient());
}

Ausgabe:

toString:    incident/inc_dynamic_schema
name:        incident/inc_dynamic_schema
isActive:    true
isTransient: false

GlideElement – getDynamicNamespaceName()

Ruft den Namen des dynamischen Namespace ab, der für konfiguriert ist GlideElement .

Dynamische Attribute haben einen definierten Datentyp und eine sys_ID Weitere Informationen zu dynamischen Attributen finden Sie unter Dynamisches Schema .

Siehe auch:

• GlideDynamicAttribut – Global
• GlideDynamicAttributeStore – Global
• GlideDynamicNamespace – Global

Tabelle : 43. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 44. Rückgaben

Typ	Beschreibung
Zeichenfolge	Name des dynamischen Namespace.

Das folgende Beispiel zeigt, wie der Name des dynamischen Attribut-Namespace zurückgegeben wird.

// Gets the name of the namespace from the inc_dynamic_schema dynamic_attribute_store column on the incident table
 
var gr_Inc = new GlideRecord('incident');
gr_Inc.query();
if (gr_Inc.next()) {
    var ge_Make = gr_Inc.getElement('inc_dynamic_schema->make');
    gs.info(ge_Make.getDynamicNamespaceName());
}

Ausgabe:

number,short_description,active

GlideElement – getED()

Gibt einen Elementdeskriptor zurück, der Informationen zu bestimmten Feldern und nicht zu den Daten in diesen Feldern bereitstellt.

Tabelle : 45. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 46. Rückgaben

Typ	Beschreibung
Elementdeskriptor	Elementdeskriptor des Felds.

Dieses Beispiel ruft die Felder und Felddeskriptoren für den aktuellen Datensatz ab.

var fields = current.getFields();
for (i=0; i<fields.size(); i++) { 
  var field = fields.get(i);
  var descriptor = field.getED(); 
  gs.print("type=" + descriptor.getType() + 
    " internalType=" + descriptor.getInternalType()); 
}

Bereichsbezogenes Äquivalent

Zur Verwendung von GetED() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: GetED() .

GlideElement – getElementValue(Zeichenfolgenwert)

Gibt den Wert für das angegebene Element zurück.

Tabelle : 47. Parameter

Name	Typ	Beschreibung
Wert	Zeichenfolge	Element, dessen Wert Sie zurückgeben möchten.

Tabelle : 48. Rückgaben

Typ	Beschreibung
Zeichenfolge	Wert des Elements.

var fields = current.getFields();
for (var i = 0; i < fields.size(); i++) {
  var field = fields.get(i);
  var name = field.getName();

  // Returns the unformatted value of the element
  var value = field.getElementValue(name);
  var disValue = field.getDisplayValue();
  gs.print(i + ". " + name + " = " + value + ' display value = ' + disValue);
}

Ausgabe

1. cmdb_ci = 109562a3c611227500a7b7ff98cc0dc7 display value = Storage Area Network 001
2. impact = 2 display value = 2 - Medium

GlideElement – getError()

Gibt eine Fehlermeldung zurück, die dem angegebenen Element zugeordnet ist.

Verwenden Sie SetError() Methode zum Festlegen eines Fehlers für ein bestimmtes Feld (Element).

Tabelle : 49. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 50. Rückgaben

Typ	Beschreibung
Zeichenfolge	Fehlermeldung, die derzeit für das angegebene Element festgelegt ist.

Dieses Beispiel zeigt, wie ein Fehler für das Element „short_description“ festgelegt und dann der Fehler zurückgelesen wird.

var incidentGR = new GlideRecord('incident');
incidentGR.setLimit(1);
incidentGR.query();
if (incidentGR.next()) {
    incidentGR.short_description.setError('The description is too short.');
    gs.info(incidentGR.short_description.getError()); // 'The description is too short.'
}

Ausgabe:

The description is too short.

Dieses Beispiel zeigt die Verwendung getError()In einem Funktionsaufruf.

// Before query business rule (order = 100)
(function executeRule(current, previous /*null when async*/) {
    var shortDescription = current.getValue('short_description');
    if (shortDescription.length < 10) {
        current.short_description.setError('The description is too short.');
        current.setAbortAction(true);
    }
})(current, previous);

// Before query business rule (order = 200)
(function executeRule(current, previous /*null when async*/) {
    var shortDescriptionErrMsg = current.short_description.getError();
    if (shortDescriptionErrMsg) {
        // Some error was set in one of the previous business rules.
    }
})(current, previous);

GlideElement – getEscapedValue()

Ruft den mit Escape versehenen Wert für das aktuelle Element ab.

Tabelle : 51. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 52. Rückgaben

Typ	Beschreibung
Zeichenfolge	Der mit Escape versehene Wert des aktuellen Elements.

Das folgende Beispiel zeigt, wie verwendet wird GetEscapedValue() Methode zum Anzeigen des Inhalts eines Incident-Kurzbeschreibungsfelds mit Escape-Zeichen.

/*** Overview - Update incident short description with escape characters and printing ***/
var inc = new GlideRecord('incident');
inc.query();
inc.next();
inc.short_description = 'Can\'t log into SAP from my laptop today'; 
inc.update();
gs.info("Short Description: "+inc.getElement('short_description').toString()); //without escape characters
gs.info("Escaped Short Description: "+inc.getElement('short_description').getEscapedValue()); // with escape characters

Ausgabe:

Short Description: Can't log into SAP from my laptop today
Escaped Short Description: Can\'t log into SAP from my laptop today

GlideElement – getFieldStyle()

Ruft den CSS-Stil für das Feld ab.

Tabelle : 53. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 54. Rückgaben

Typ	Beschreibung
Zeichenfolge	Der CSS-Stil für das Feld.

var fields = current.getFields();
for (var i = 0; i < fields.size(); i++) { 
  var field = fields.get(i);
  var css_style = field.getFieldStyle();  
  gs.print("CSS style" + "=" + css_style); 
}

GlideElement – getGlideObject()

Ruft das Plattformobjekt ab, das dem Wert des Felds zugeordnet ist.

Einen Anwendungsfall finden Sie unter Ändern Sie die Feldwerte „GlideDateTime“.

Tabelle : 55. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 56. Rückgaben

Typ	Beschreibung
Objekt	Ein Plattformobjekt, das dem Datentyp des Felds entspricht, z. B. GlideDateTime . Sie können dieses Objekt für typspezifische Vorgänge für den Wert verwenden. Beispiel: Datumsarithmetik, Formatierung und Zeitzonenkonvertierungen, die nicht verfügbar sind, wenn auf den Feldwert als einfache Zeichenfolge zugegriffen wird.

Das folgende Beispiel zeigt, wie die Dauer zwischen dem Eröffnungsdatum und dem Fälligkeitsdatum der Servicelevel-Vereinbarung (SLA) eines Incident-Datensatzes berechnet wird.

// Query an incident record with both opened_at and sla_due populated
var incGr = new GlideRecord('incident');
incGr.addQuery('opened_at', '!=', '');
incGr.addQuery('sla_due', '!=', '');
incGr.setLimit(1);
incGr.query();

if (incGr.next()) {
    gs.info("Incident: " + incGr.getValue('number'));
    gs.info("Opened at: " + incGr.getValue('opened_at'));
    gs.info("SLA due: " + incGr.getValue('sla_due'));

    var duration = calcDateDelta(incGr.opened_at, incGr.sla_due);
    if (duration) {
        gs.info("Duration in seconds: " + duration.getNumericValue() / 1000);
        gs.info("Duration display value: " + duration.getDisplayValue());
    }
}

function calcDateDelta(start, end) {
    var realStart = start.getGlideObject();
    var realEnd = end.getGlideObject();

    // Use GlideDuration to calculate the difference between two GlideDateTime objects
    var startMS = realStart.getNumericValue();
    var endMS = realEnd.getNumericValue();
    var deltaMS = endMS - startMS;

    // Create a GlideDuration from the millisecond difference
    var duration = new GlideDuration(deltaMS);
    return duration;
}

Ausgabe:

Incident: INC0000031
Opened at: 2025-03-06 00:18:03
SLA due: 2025-03-06 08:18:03
Duration in seconds: 28800
Duration display value: 8 Hours

Bereichsbezogenes Äquivalent

Zur Verwendung von GetGlideObject() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: GetGlideObject() .

GlideElement – getGlideRecord()

Ruft einen Glide-Datensatz ab.

Tabelle : 57. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 58. Rückgaben

Typ	Beschreibung
GlideRecord	Ein Glide-Datensatzobjekt.

var grInc = new GlideRecord('incident');
grInc.get('sys_id','ef43c6d40a0a0b5700c77f9bf387afe3');
gs.info("Initial grInc - " + grInc.getDisplayValue());

var caller = grInc.getElement("caller_id");
doit(caller);

function doit(caller) {
  var now_GR = caller.getGlideRecord();
  gs.info("doit gr is - " + now_GR.getDisplayValue());
}

Ausgabe

*** Script: Initial grInc - INC0000050
*** Script: doit gr is - INC0000050

GlideElement – getHTMLValue (Anzahl maxChars)

Gibt den HTML-Wert eines Felds zurück.

Tabelle : 59. Parameter

Name	Typ	Beschreibung
Max. Zeichen	Nummer	Optional. Maximale Anzahl von Zeichen, die zurückgegeben werden sollen.

Tabelle : 60. Rückgaben

Typ	Beschreibung
Zeichenfolge	HTML-Wert für das Feld.

Das folgende Beispiel zeigt, wie der HTML-Inhalt einer Besprechungsnotiz abgerufen wird.

/*
  getHTMLValueExt() This Function is used to get HTML Value of a field. It accepts 2 Parameters

a. maxChar- Number - The maximum number of characters to return.
b. nullSub - String - The value to return if the HTML value is null or empty.

*/


// get a cab meeting record by its sys_id
var gr = new GlideRecord('cab_meeting');
gr.addQuery('sys_id','7777777b6d2a20100sys70id534330f6');
gr.query();

if(gr.next()){
  var substituteString = 'Meeting Notes Unavailable';
  var maxLength = 50;
  gs.print(gr.meeting_notes.getHTMLValueExt(maxLength, substituteString));
}

Bereichsbezogenes Äquivalent

Zur Verwendung von GetHTMLWert() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: GetHTMLWert() .

GlideElement – getHTMLValueExt(Zahl maxChar, Zeichenfolge nullSub)

Gibt den HTML-Wert eines Felds oder einen angegebenen Ersatzwert zurück, wenn der HTML-Wert null oder leer ist.

Tabelle : 61. Parameter

Name	Typ	Beschreibung
MaxChar	Nummer	Die maximale Anzahl von Zeichen, die zurückgegeben werden sollen.
NullSub	Zeichenfolge	Der Wert, der zurückgegeben werden soll, wenn der HTML-Wert null oder leer ist.

Tabelle : 62. Rückgaben

Typ	Beschreibung
Zeichenfolge	Der HTML-Wert oder der angegebene Ersatzwert.

Das folgende Beispiel zeigt, wie der HTML-Inhalt einer Besprechungsnotiz abgerufen wird.

// get a cab meeting record by its sys_id
var gr = new GlideRecord('cab_meeting');
gr.addQuery('sys_id','7777777b6d2a20100sys70id534330f6');
gr.query();

if(gr.next()){
  var substituteString = 'Meeting Notes Unavailable';
  var maxLength = 50;
  gs.print(gr.meeting_notes.getHTMLValueExt(maxLength, substituteString));
}

Ausgabe, wenn die Besprechungsnotiz für den ausgewählten Datensatz nicht leer ist:

<p>Meeting note content.</p>

GlideElement – getJournalEntry(Nummer mostRecent)

Gibt entweder den neuesten Journaleintrag oder alle Journaleinträge zurück.

Tabelle : 63. Parameter

Name	Typ	Beschreibung
MostRecent	Nummer	Bei 1 wird der neueste Eintrag zurückgegeben. Bei -1 werden alle Journaleinträge zurückgegeben.

Tabelle : 64. Rückgaben

Typ	Beschreibung
Zeichenfolge	Gibt für den letzten Eintrag eine Zeichenfolge zurück, die die Feldbezeichnung, den Zeitstempel und den Anwenderanzeigenamen des Journaleintrags enthält. Gibt für alle Journaleinträge die gleichen Informationen für alle Journaleinträge zurück, die jemals eingegeben wurden, als einzelne Zeichenfolge, wobei jeder Eintrag durch „\n\n“ getrennt ist.

//gets all journal entries as a string where each entry is delimited by '\n\n'
var notes = current.work_notes.getJournalEntry(-1); 
//stores each entry into an array of strings
var na = notes.split("\n\n");  
                      
for (var i = 0; i < na.length; i++)                 
  gs.print(na[i]);

Bereichsbezogenes Äquivalent

Zur Verwendung von GetJournalEntry() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: GetJournalEntry() .

GlideElement – getLabel()

Gibt die Bezeichnung des Objekts zurück.

Tabelle : 65. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 66. Rückgaben

Typ	Beschreibung
Zeichenfolge	Bezeichnung des Objekts

var now_GR = new GlideRecord("sc_req_item");
now_GR.addQuery("request", current.sysapproval);
now_GR.query();
while(now_GR.next()) {
    var nicePrice = now_GR.price.toString();
    if (nicePrice != ) {
        nicePrice = parseFloat(nicePrice);
        nicePrice = nicePrice.toFixed(2);
    }
    template.print(now_GR.number + ":  " + now_GR.quantity + " X " + now_GR.cat_item.getDisplayValue() + " at $" + nicePrice + " each \n");
    template.print("    Options:\n");
    var variables = now_GR.variables.getElements();    
    for (var key in variables) {
      var now_V = variables[key];
      if(now_V.getQuestion().getLabel() != ) {
         template.space(4);
         template.print('     ' +  now_V.getQuestion().getLabel() + " = " + now_V.getDisplayValue() + "\n");  
      }
    }
}

Bereichsbezogenes Äquivalent

Zur Verwendung von GetLabel() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: GetLabel() .

GlideElement – getLabellang (Zeichenfolgensprache)

Ruft den Bezeichnungswert des Felds in der als Parameter übergebenen Sprache ab.

Sie müssen über das entsprechende Sprach-Plugin verfügen, um einen übersetzten Wert abzurufen. Informationen hierzu finden Sie unter Activate a language.

Siehe auch:

• GetDisplayValueLang()
• GetLabel()

Tabelle : 67. Parameter

Name	Typ	Beschreibung
language	Zeichenfolge	Sprach-Tag gemäß IETF BCP-47.

Tabelle : 68. Rückgaben

Typ	Beschreibung
Zeichenfolge	Wert der Feldbezeichnung in der übergebenen Sprache. Wenn keine Übersetzung verfügbar ist, ruft die Methode einen Wert ab, der in die Sprache des aktuellen Anwenders übersetzt wurde. Wenn eine Übersetzung nicht verfügbar ist, wird das Ergebnis standardmäßig auf Englisch festgelegt.

Das folgende Beispiel zeigt, wie der ursprüngliche Bezeichnungstext und seine deutsche Übersetzung von abgerufen werden Akzeptieren Titel (UI-Ansicht).

var uiView = new GlideRecord("sys_ui_view");
uiView.get("fa776f6d97700100f309124eda2975bc");

gs.info("getLabel: " + uiView.getElement("title").getLabel());
gs.info("getLabelLang: " + uiView.getElement("title").getLabelLang("de"));

Ausgabe:

getLabel: Title
getLabelLang: Titel

Bereichsbezogenes Äquivalent

Zur Verwendung von GetLabellang() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: GetLabellang() .

GlideElement – getName()

Gibt den Namen des Felds zurück.

Tabelle : 69. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 70. Rückgaben

Typ	Beschreibung
Zeichenfolge	Feldname.

Das folgende Beispiel zeigt, wie der Name und andere Werte für jedes Feld in einem sys_user-Datensatz abgerufen werden.

var userRec = new GlideRecord("sys_user"); // GlideRecord to sys_user table

userRec.get("5137153cc611227c000bbd1bd8cd2005"); // Sys Id of user: Fred Luddy

var fields = userRec.getFields();

for (var i = 0; i < fields.size(); i++) {

    var field = fields.get(i);
    var name = field.getName(); // Name of the field
    var label = field.getLabel(); // Label of the field
    var value = field.getDisplayValue(); // Value of the field

    gs.info((Number(i) + 1) + ".\n" + "Field Label: " + label + "\n" + "Field Name: " + name + "\n" + "Field Value: " + value);

};

Ausgabe. Die Ergebnisse enthalten 62 Felder und wurden mit Auslassungspunkten (…) gekürzt. Um Platz zu sparen.

*** Script: 1.
Field Label: Country code
Field Name: country
Field Value: 
*** Script: 2.
Field Label: Calendar integration
Field Name: calendar_integration
Field Value: Outlook
...
*** Script: 47.
Field Label: First name
Field Name: first_name
Field Value: Fred
...
*** Script: 54.
Field Label: Last name
Field Name: last_name
Field Value: Luddy
...

Bereichsbezogenes Äquivalent

Zur Verwendung von GetName() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: GetName() .

GlideElement – getRefRecord()

Gibt ein GlideRecord-Objekt für ein bestimmtes Referenzelement zurück.

Für berechnete Felder ruft diese Methode den referenzierten Datensatz ab und führt eine Berechnung für einen geskripteten Standardwert aus.

Warnung:

Wenn das Referenzelement keinen Wert enthält, wird ein leeres GlideRecord-Objekt zurückgegeben, kein Null-Objekt.

Tabelle : 71. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 72. Rückgaben

Typ	Beschreibung
GlideRecord	Ein GlideRecord-Objekt

var grINC = new GlideRecord('incident'); 
grINC.notNullQuery('caller_id'); 
grINC.query(); 
if (grINC.next()) { 

// Get a GlideRecord object for the referenced sys_user record 
var grUSER = grINC.caller_id.getRefRecord(); 
if (grUSER.isValidRecord()) 
  gs.print( grUSER.getValue('name') ); 

} 

Bereichsbezogenes Äquivalent

Zur Verwendung von GetRefRecord() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: GetRefRecord() .

GlideElement – getStyle()

Ruft den CSS-Stil für den Wert ab.

Tabelle : 73. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 74. Rückgaben

Typ	Beschreibung
Zeichenfolge	Der CSS-Stil für den Wert.

// Get string of style field from Field Style record
var cssStyle = now_GR.state.getStyle();

GlideElement – getTableName()

Gibt den Namen der Tabelle zurück, die das Feld enthält.

Tabelle : 75. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 76. Rückgaben

Typ	Beschreibung
Zeichenfolge	Name der Tabelle, die das aufgerufene Feld enthält. Der zurückgegebene Wert kann sich von der Tabellenklasse unterscheiden, in der sich der Datensatz befindet. Weitere Informationen finden Sie unter Table extension and classes.

if (current.approver.getTableName() == "sysapproval_approver") {
    if (current.approver == email.from_sys_id) {
        current.comments = "reply from: " + email.from + "\n\n" + email.body_text;

        // if it's been cancelled, it's cancelled.
        var doit = true;
        if (current.state == 'cancelled')
            doit = false;

        if (email.body.state != undefined)
            current.state = email.body.state;

        if (doit)
            current.update();
    } else {
        gs.log("Approval for task " + current.sysapproval.getDisplayValue() +
            " rejected because user sending email " + email.from +
            " does not match the approver " + current.approver.getDisplayValue());
    }
}

Bereichsbezogenes Äquivalent

Zur Verwendung von GetTableName() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: GetTableName() .

GlideElement – getTextAreaDisplayValue()

Ruft den Anzeigewert für das zugeordnete Feld ab und setzt die HTML-Datei mit Escape-Zeichen.

Tabelle : 77. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 78. Rückgaben

Typ	Beschreibung
Zeichenfolge	Mit Escape Versehen Anzeigewert HTML für das zugeordnete Feld.

Das folgende Beispiel ruft den Anzeigewert eines KB-artikels ab.

var grh = new GlideRecord('kb_knowledge');
grh.get('c85cd2519f77230088aebde8132e70c2');  // Knowledge record sys_id
var t = grh.text.getTextAreaDisplayValue(); // Text is HTML type field
var d = GlideXMLUtil.parseHTML(t); // Parse the HTML
var b = d.getDocumentElement().getTextContent().trim();
gs.info(b);

Ausgabe:

This article explains how to use automatic replies in Outlook 2010 for Exchange accounts.

Setting Up Automatic Replies

Click the 
File tab.
Click 
Automatic Replies.
Select 
Send automatic replies.
If desired, select the 
Only send during this time range check box to schedule when your out of office replies are active. If you do not specify a start and end time, auto-replies will be sent until you select the
 Do not send automatic replies check box.
On the 
Inside My Organization tab, type the response that you want to send to colleagues while you are out of the office.
On the 
Outside My Organization tab, select the 
Auto-reply to people outside my organization check box, and then type the response that you want to send while you are out of the office. Select whether you want replies sent to 
My contacts only or to 
Anyone outside my organization who sends you messages.

NOTE:
If you select 
My Contacts only in step 6, replies will be sent 
only to contacts that exist in your Contacts folder.



Using Rules With Automatic Replies
It is also possible to use rules to manage your messages while you are out of office. For example, you can create rules to automatically move or copy messages to other folders, to delete messages, to send custom replies, and so on.

Click the 
File tab.
Click 
Automatic Replies.
Click 
Rules, and then click 
Add Rule.
Under 
When a message arrives that meets the following conditions, specify the conditions that the message must meet for the rule to be applied. If you want to specify more conditions, click 
Advanced, enter or select the options that you want, and then click 
OK.
If you want to specify that this rule must be applied last, select the 
Do not process subsequent rules check box.
Under 
Perform these actions, select the actions that you want. You can select more than one action.
Click 
OK three times.

NOTES:

Automatic Replies rules can also be edited by following the above procedure.
To turn Automatic Replies rules on or off, in the Automatic Reply Rules dialog box, select or clear the check box of the rule that you want to turn on or off.

GlideElement – getValue()

Gibt den Wert des Felds in der Datenbank zurück.

Tabelle : 79. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 80. Rückgaben

Typ	Beschreibung
Zeichenfolge	Der Wert des Felds.

Das folgende Beispiel ruft den Wert eines angegebenen Felds in der Datenbank ab.

var now_GR = new GlideRecord('incident');
now_GR.get('9c573169c611228700193229fff72400'); //INC0000001
gs.info('Display Values');
gs.info('Opened at ' + now_GR.opened_at.getDisplayValue());
gs.info('Opened by ' + now_GR.opened_by.getDisplayValue());
gs.info('Priority ' + now_GR.priority.getDisplayValue());
gs.info('Values');
gs.info('Opened at ' + now_GR.opened_at.getValue());
gs.info('Opened by ' + now_GR.opened_by.getValue());
gs.info('Priority ' + now_GR.priority.getValue());

Ausgabe:

Display Values
Opened at 2022-02-01 15:09:51
Opened by Joe Employee
Priority 1 - Critical
Values
Opened at 2022-02-01 23:09:51
Opened by 681ccaf9c0a8016400b98a06818d57c7
Priority 1

Bereichsbezogenes Äquivalent

Zur Verwendung von GetValue() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: Bereichsbezogenes GlideElement – getValue().

GlideElement – getXHTMLValue()

Ruft den XHTML-Wert eines Felds ab.

Tabelle : 81. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 82. Rückgaben

Typ	Beschreibung
Zeichenfolge	Der XHTML-Wert

GlideElement – getXMLValue()

Ruft den XML-Wert eines Felds als Zeichenfolge ab.

Tabelle : 83. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 84. Rückgaben

Typ	Beschreibung
Zeichenfolge	Der XML-Wert

GlideElement – HasAttribute(String attributeName)

Bestimmt, ob ein Feld ein angegebenes Attribut hat.

Tabelle : 85. Parameter

Name	Typ	Beschreibung
attributeName	Zeichenfolge	Name des Attributs. Der Attributname wird in der Tabelle „Wörterbucheinträge“ [sys_dictionary] aufgeführt.

Tabelle : 86. Rückgaben

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob ein Feld das angegebene Attribut hat. Gültige Werte: Wahr: Das Feld hat das angegebene Attribut. Falsch: Das Feld hat nicht das angegebene Attribut.

Das folgende Beispiel zeigt, wie Felder aus der Anwendertabelle [sys_user] mit abgerufen werden edge_encryption_enabledAttribut.

var fields = new GlideRecord('sys_user');

fields.query();

var userFields = fields.getFields();

for (var num = 0; num < userFields.size(); num++) {
    var ed = userFields.get(num).getED();

    if (ed.hasAttribute("edge_encryption_enabled")) {
        gs.info(userFields.get(num).getName());
    }
}

Ausgabe:

*** Script: hashed_user_id
*** Script: federated_id

GlideElement – hasRightsTo(Zeichenfolge operationName)

Bestimmt, ob der Anwender berechtigt ist, einen bestimmten Vorgang auszuführen.

Tabelle : 87. Parameter

Name	Typ	Beschreibung
operationName	Zeichenfolge	Name des zu überprüfenden Vorgangs

Tabelle : 88. Rückgaben

Typ	Beschreibung
Boolean	„Wahr“, wenn der Anwender zur Ausführung des Vorgangs berechtigt ist, andernfalls „falsch“. Kennzeichnung, die angibt, ob ein Anwender die Berechtigung zum Ausführen eines Vorgangs hat. Gültige Werte: Wahr: Anwender hat Berechtigungen. Falsch: Anwender hat keine Berechtigungen.

Das folgende Beispiel zeigt, wie bestimmt werden kann, ob ein Anwender Rechte zum Lesen einer bestimmten Tabelle hat.

// Pass table name and userId to check if user has read access against given table name
checkAccess('incident', 'adela.cervantsz');

function checkAccess(tableName, userID) {

    var inc = new GlideRecordSecure(tableName);
    inc.get('$[sys_id]');

    var secureManager = GlideSecurityManager.get();

    //fetch a different user, using user_name field on the target user record
    var userObj = gs.getUser().getUserByID(userID); 
    secureManager.setUser(userObj);

    var access = 'record/incident/read';

    //check if user has right to access
    var canRead = secureManager.hasRightsTo(access, inc); 
    gs.info('canRead: ' + canRead);
}

Ausgabe:

canRead: false

GlideElement – hasValue()

Bestimmt, ob das Feld einen Wert hat.

Tabelle : 89. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 90. Rückgaben

Typ	Beschreibung
Boolean	„Wahr“, wenn das Feld einen Wert hat, andernfalls „falsch“.

GlideElement – nil()

Bestimmt, ob das Feld null ist.

Tabelle : 91. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 92. Rückgaben

Typ	Beschreibung
Boolean	„Wahr“, wenn das Feld null oder eine leere Zeichenfolge ist, andernfalls „falsch“.

if (current.start_date.changes() || current.end_date.changes() || current.assigned_to.changes()) { 
  if (!current.start_date.nil() && !current.end_date.nil() && !current.assigned_to.nil()) {
 gs.eventQueue("change.calendar.notify", current, current.assigned_to, previous.assigned_to);
 
}

Bereichsbezogenes Äquivalent

Zur Verwendung von Nil() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: Nil() .

GlideElement – setDateNumericValue(Anzahl Millisekunden)

Legt das Feld „Dauer“ für ein Feld „Dauer“ auf eine Anzahl von Millisekunden seit dem 1. Januar 1970, 00:00:00 GMT fest. Erfordert nicht die Erstellung eines GlideDateTime-Objekts, da das Feld „Dauer“ bereits ein GlideDateTime-Objekt ist.

Tabelle : 93. Parameter

Name	Typ	Beschreibung
Millisekunden	Nummer	Anzahl der Millisekunden, die von der Dauer abgedeckt werden.

Tabelle : 94. Rückgaben

Typ	Beschreibung
Ungültig

var inc = new GlideRecord('incident');
inc.get('17c90efb13418700cc36b1422244b05d');
var timems = inc.calendar_duration.dateNumericValue();
timems = timems + 11*1000; 
inc.calendar_duration.setDateNumericValue(timems)
gs.info(inc.calendar_duration.getValue());

Ausgabe:

1970-01-01 00:01:38

Bereichsbezogenes Äquivalent

Zur Verwendung von SetDateNumericWert() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: SetDateNumericWert() .

GlideElement – setDisplayValue(Object DisplayValue)

Legt den Anzeigewert des Felds fest.

Tabelle : 95. Parameter

Name	Typ	Beschreibung
displayValue	Objekt	Anzuzeigender Wert.

Tabelle : 96. Rückgaben

Typ	Beschreibung
Ungültig

Bereichsbezogenes Äquivalent

Zur Verwendung von SetDisplayWert() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: SetDisplayWert() .

GlideElement – setError(Zeichenfolge errorMessage)

Fügt dem zugeordneten Feld eine Fehlermeldung hinzu.

Sie können die Fehlermeldung mit abrufen GetError() Methode.

Tabelle : 97. Parameter

Name	Typ	Beschreibung
errorMessage	Zeichenfolge	Die Fehlermeldung.

Tabelle : 98. Rückgaben

Typ	Beschreibung
Keine

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.setAbortAction(true);
    current.u_date1.setError('start must be before end');
  }
}

Bereichsbezogenes Äquivalent

Zur Verwendung von SetError() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: SetError() .

GlideElement – setInitialValue(Objektwert)

Legt den Anfangswert eines Felds fest.

Diese Methode war veraltet. Verwenden GlideElement – setValue(Objektwert) Für diese Funktionalität.

Tabelle : 99. Parameter

Name	Typ	Beschreibung
Wert	Objekt	Anfangswert für das Feld.

Tabelle : 100. Rückgaben

Typ	Beschreibung
Ungültig

GlideElement – setJournalEntry(Zeichenfolgeneintrag, Zeichenfolgenanwendername)

Fügt einen Journaleintrag und einen Autor als Arbeitsnotiz- oder Kommentarfeld hinzu.

Tabelle : 101. Parameter

Name	Typ	Beschreibung
Eintrag	Zeichenfolge	Inhalt des Journaleintrags.
userName	Zeichenfolge	Optional. Der Anwender, dem der Journaleintrag zugeordnet werden soll.

Tabelle : 102. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie eine Arbeitsnotiz und ihr Autor einem Datensatz hinzugefügt werden.

var now_GR = new GlideRecord("incident");

now_GR.addQuery("sys_id", "<sys_id_value>");
now_GR.query();

if(now_GR.next()){
  now_GR.work_notes.setJournalEntry("Content of the journal entry.", "abel.tuter");  
  now_GR.update();
}

GlideElement – setValue(Objektwert)

Legt den Wert eines Felds fest.

Hinweis:

Vor dem Aufrufen dieser Methode muss das Element bereits vorhanden sein, indem ein vorhandener Datensatz abgefragt oder verwendet wird now_GR.initialize() Methode zum Initialisieren eines neuen Datensatzes.

Nicht für Authentifizierung mit Passwort2-Feldern

Die SetWert() Die Methode übergibt Passwort2-Daten als Klartext, was zu einem Fehler beim erwartet verschlüsselter Daten führt. Darüber hinaus werden durch die Verwendung der setValue()-Methode für Passwort2-Felder Daten verfügbar gemacht, die verschlüsselt werden sollen.

Verwenden Sie für die Passwort2-Authentifizierung SetDisplayWert() Stattdessen Methode.

Siehe auch:

• Deprecate GlideEncrypter usage of 3DES for password2 fields
• Alternativen zur Nutzung von GlideEncrypter im Knowledge Base-artikel KB1320986
• Password2 encryption with the Key Management Framework (KMF)

Tabelle : 103. Parameter

Name	Typ	Beschreibung
Wert	Objekt	Der Wert, auf den das Feld festgelegt werden soll.

Tabelle : 104. Rückgaben

Typ	Beschreibung
Keine

Legen Sie den Wert fest, der eine Zeichenfolge übergibt.

var glideRecord = new GlideRecord('incident');
glideRecord.query('priority','1');
glideRecord.next();
glideRecord.short_description.setValue('Network failure');

Legen Sie den Wert fest, der ein Objekt übergeben wird.

var now_GR  = new GlideRecord('student');
now_GR.initialize();
now_GR.setValue('first_name', 'Joe');
now_GR.setValue('last_name', 'Smith');
now_GR.insert();

Bereichsbezogenes Äquivalent

Zur Verwendung von SetWert() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: SetWert() .

GlideElement – toString()

Konvertiert den Wert des Felds in eine Zeichenfolge.

Tabelle : 105. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 106. Rückgaben

Typ	Beschreibung
Zeichenfolge	Der Wert des Felds als Zeichenfolge.

doit();
 
function doit() { 
 
  var now_GR = new GlideRecord('sys_user');
  now_GR.query();
  while (now_GR.next()) {
  if ((now_GR().length != now_GR.first_name.toString().trim().length) || (now_GR.last_name.toString().length 
         != now_GR.last_name.toString().trim().length)) {
      now_GR.first_name = now_GR.first_name.toString().trim();
      now_GR.last_name = now_GR.last_name.toString().trim();
      now_GR.autoSysFields(false);
      now_GR.update();
    }
  }
 
}

Bereichsbezogenes Äquivalent

Zur Verwendung von ToString() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: ToString() .