GlideElement – Global

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 29 Minuten Lesedauer

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

    GlideElement – canCreate()

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

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob der aktuelle Benutzer über Berechtigungen zum Erstellen neuer Einträge im zugehörigen Feld verfügt.
    Mögliche Werte:
    • true: Benutzer kann neue Einträge erstellen.
    • false: Benutzer kann keine neuen Einträge erstellen.

    Das folgende Beispiel zeigt, wie Sie feststellen können, ob der Benutzer über Berechtigungen zum Erstellen von Einträgen für die drei letzten Datensätze in der Problemtabelle [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

    Um die canCreate()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: canCreate().

    GlideElement – canRead()

    Bestimmt, ob die Rolle des Benutzers das Lesen des zugeordneten GlideRecord zulässt.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn das Feld gelesen werden kann, andernfalls „false“.

    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

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

    GlideElement – canWrite()

    Bestimmt, ob die Rolle des Benutzers das Schreiben im zugeordneten GlideRecord zulässt.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 6. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn der Benutzer in das Feld schreiben kann, andernfalls „false“.

    Das folgende Beispiel zeigt, wie eine Liste aktiver Incident-Datensätze mit einem beschreibbaren 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.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

    Um die canWrite()-Methode in einer bereichsbezogenen Anwendung zu verwenden, 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 außer Journalfeldern verfügbar.

    Hinweis:
    Die changes()-Methode wird in ACL-Skripts nicht unterstützt.
    Hinweis:
    Wenn der GlideRecord, mit dem Sie diese Methode ausführen, nur initialisiert und gelesen und nicht geschrieben wurde, sind die zugrunde liegenden Vorher-Nachher-Werte gleich. In diesem Fall gibt die Methode „false“ zurück, da der Datenspeicher nicht geändert wurde.
    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn sich das Feld geändert hat, andernfalls „false“.

    Das folgende Beispiel aus einer Business Rule zeigt, wie ein Event in der EventQueue erstellt wird, wenn sich der Wert des Felds assigned_to ändert.

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

    Bereichsbezogenes Äquivalent

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

    GlideElement – changesFrom (Object value)

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

    Hinweis:
    Wenn der GlideRecord, mit dem Sie diese Methode ausführen, nur initialisiert und gelesen und nicht geschrieben wurde, sind die zugrunde liegenden Vorher-Nachher-Werte gleich. In diesem Fall gibt die Methode „false“ zurück, da der Datenspeicher nicht geändert wurde.
    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Wert Objekt Ein Objektwert, der mit dem vorherigen Wert des aktuellen Feldes verglichen werden soll.
    Tabelle : 10. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn der vorherige Wert mit dem Parameter übereinstimmt, „false“, 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

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

    GlideElement – changesTo(Object value)

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

    Hinweis:
    Die changesTo()-Methode wird in ACL-Skripts nicht unterstützt.
    Hinweis:
    Wenn der GlideRecord, mit dem Sie diese Methode ausführen, nur initialisiert und gelesen und nicht geschrieben wurde, sind die zugrunde liegenden Vorher-Nachher-Werte gleich. In diesem Fall gibt die Methode „false“ zurück, da der Datenspeicher nicht geändert wurde.
    Tabelle : 11. Parameter
    Name Typ Beschreibung
    Wert Objekt Ein Objektwert, der mit dem neuen Wert des aktuellen Feldes verglichen werden soll.
    Tabelle : 12. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn der neue Wert mit dem Parameter übereinstimmt, „false“, 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

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

    GlideElement – dateNumericValue()

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

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 14. Ergebnisse
    Typ Beschreibung
    Zahl 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

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

    GlideElement – debug(Object o)

    Debuggt das Objekt und fügt Debug-Meldungen mithilfe von setError (String) hinzu.

    Tabelle : 15. Parameter
    Name Typ Beschreibung
    o Objekt Ein Objekt zum Debuggen.
    Tabelle : 16. Ergebnisse
    Typ Beschreibung
    void

    GlideElement – getAttribute(String attributeName)

    Gibt den Wert des angegebenen Attributs aus dem Dictionary zurück.

    Wenn das Attribut ein boolean Attribut ist, verwenden Sie getBooleanAttribute(String), um den Wert als boolean- und nicht als String-Typ zu erhalten.

    Tabelle : 17. Parameter
    Name Typ Beschreibung
    attributName Zeichenfolge Attributname
    Tabelle : 18. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Attributwert 
    doit();
function doit() {
  var now_GR = new GlideRecord('sys_user');
  now_GR.query("user_name","admin");
  if (now_GR.next()) {
    gs.print("we got one");
    gs.print(now_GR.location.getAttribute("tree_picker"));
  }
 
}

    Bereichsbezogenes Äquivalent

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

    GlideElement – getBaseTableName()

    Ruft die Basistabelle des Feldes ab.

    Tabelle : 19. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 20. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Name der Basistabelle Dieser Name kann sich von der Tabelle unterscheiden, in der das Feld definiert ist. Siehe Tabellenerweiterungen und Klassen 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(String attributName)

    Gibt den boolean Wert des angegebenen Attributs aus dem Dictionary zurück.

    Um den Wert als String zu erhalten, verwenden Sie getAttribute(string).

    Tabelle : 21. Parameter
    Name Typ Beschreibung
    attributName Zeichenfolge Attributname
    Tabelle : 22. Ergebnisse
    Typ Beschreibung
    Boolean Boolean Wert des Attributs. Gibt „false“ zurück, wenn das Attribut nicht existiert.

    Das folgende Beispiel zeigt, wie boolesche Werte des Attributs ignore_filter_on_new für zwei Felder abgerufen werden.

    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

    Um die getBooleanAttribute()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: getBooleanAttribute().

    GlideElement – getChoices(String abhängig)

    Erzeugt 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
    dependent Zeichenfolge Optional. Feld innerhalb des zugeordneten Datensatzes, von dem das Auswahllistenfeld abhängt.
    Tabelle : 24. Ergebnisse
    Typ Beschreibung
    array list 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

    Um die getChoices()-Methode in einer bereichsbezogenen Anwendung zu verwenden, 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. Ergebnisse
    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

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

    GlideElement – getDebugCount()

    Ruft die Anzahl der Debug-Meldungen ab, die von debug protokolliert werden.

    Tabelle : 27. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 28. Ergebnisse
    Typ Beschreibung
    Zahl Die Anzahl der Debug-Meldungen.

    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. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Name des Feldes, von dem das aktuelle Feld abhängt. NULL, wenn keine Abhängigkeiten vorhanden sind.

    Das folgende Beispiel zeigt, wie das Feld „Übergeordnet“ des Felds „Configuration Item“ mithilfe der Methode getDependent() gefunden wird.

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

    Ruft die Tabelle ab, von der die aktuelle Tabelle abhängig ist.

    Tabelle : 31. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 32. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der Name der Tabelle.

    GlideElement – getDisplayValue(Number maxChar)

    Gibt den formatierten Anzeigewert des Felds zurück.

    Anzeigewerte werden auf Grundlage des tatsächlichen Werts in der Datenbank und der Benutzer- oder Systemeinstellungen und Voreinstellungen geändert.

    Der zurückgegebene Anzeigewert ist vom Feldtyp abhängig.
    • Auswahlfelder: Der Datenbankwert kann eine Zahl sein, der Anzeigewert ist jedoch aussagekräftiger.
    • Datumsfelder: Der Datenbankwert liegt im UTC-Format vor, während der Anzeigewert auf der Zeitzone des Benutzers basiert.
    • Verschlüsselter Text: Der Datenbankwert ist verschlüsselt, während der Anzeigewert entsprechend dem Verschlüsselungskontext des Benutzers 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 der Zeichen, die zurückgegeben werden sollen.
    Tabelle : 34. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Anzeigewert des Feldes. 
    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

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

    GlideElement – getDisplayValueExt(Number maxChar, String nullSub)

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

    Anzeigewerte werden auf Grundlage des tatsächlichen Werts in der Datenbank und der Benutzer- oder Systemeinstellungen und Voreinstellungen geändert.

    Der zurückgegebene Anzeigewert ist vom Feldtyp abhängig.
    • Auswahlfelder: Der Datenbankwert kann eine Zahl sein, der Anzeigewert ist jedoch aussagekräftiger.
    • Datumsfelder: Der Datenbankwert liegt im UTC-Format vor, während der Anzeigewert auf der Zeitzone des Benutzers basiert.
    • Verschlüsselter Text: Der Datenbankwert ist verschlüsselt, während der Anzeigewert entsprechend dem Verschlüsselungskontext des Benutzers 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 der zurückzugebenden Zeichen.

    Standard: Alle
    nullSub Zeichenfolge Wert, der zurückgegeben werden soll, wenn der Anzeigewert NULL oder leer ist.
    Tabelle : 36. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Formatierter Anzeigewert des Felds oder der angegebene Ersatzwert.

    Das folgende Beispiel zeigt, wie die beiden letzten aktiven Datensätze in der Incident-Tabelle [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(String language)

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

    Das Ergebnis gilt nur für übersetzbare Feldtypen wie Auswahl, Übersetztes Feldund Übersetzter Text. Bei anderen Feldtypen lautet das Ergebnis standardmäßig getDisplayValue().

    Sie benötigen das entsprechende Sprach-Plugin, um einen übersetzten Wert abzurufen. Diesbezügliche Informationen finden Sie unter Activate a language.

    Siehe auch Scoped GlideElement – getLabelLang(String language).

    Tabelle : 37. Parameter
    Name Typ Beschreibung
    language Zeichenfolge Sprach-Tag, das IETF BCP-47 entspricht.
    Tabelle : 38. Ergebnisse
    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 Benutzers übersetzt wurde. Wenn keine Übersetzung verfügbar ist, wird standardmäßig Englisch verwendet.

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

    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

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

    GlideElement – getED()

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

    Tabelle : 39. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 40. Ergebnisse
    Typ Beschreibung
    ElementDescriptor Der Elementdeskriptor des Feldes.

    In diesem Beispiel werden die Felder und Felddeskriptoren für den aktuellen Datensatz abgerufen.

    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

    Um die getED()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: getED().

    GlideElement – getElementValue(String value)

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

    Tabelle : 41. Parameter
    Name Typ Beschreibung
    Wert Zeichenfolge Element, dessen Wert zurückgegeben werden soll.
    Tabelle : 42. Ergebnisse
    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 die Methode setError(), um einen Fehler für ein bestimmtes Feld (Element) festzulegen.

    Tabelle : 43. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 44. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Fehlermeldung, die derzeit für das angegebene Element festgelegt ist.

    Dieses Beispiel zeigt, wie Sie einen Fehler für das short_description-Element festlegen und den Fehler dann zurücklesen.

    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, wie getError() in einem Funktionsaufruf verwendet wird.

    // 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 Escape-Wert für das aktuelle Element ab.

    Tabelle : 45. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 46. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der Escape-Wert des aktuellen Elements.

    Das folgende Beispiel zeigt, wie Sie mit der Methode getEscapedValue() den Inhalt eines Felds für die Kurzbeschreibung eines Incident mit Escape-Zeichen anzeigen.

    /*** 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 : 47. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 48. Ergebnisse
    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 ein Glide Objekt ab.

    Tabelle : 49. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 50. Ergebnisse
    Typ Beschreibung
    Objekt Ein Glide-Objekt. 
    function calcDateDelta(start, end, calendar) {
  var cal = GlideCalendar.getCalendar(calendar);
  if (!cal.isValid())
      return null;
  var realStart = start.getGlideObject();
  var realEnd = end.getGlideObject();  
  var duration = cal.subtract(realStart, realEnd);
  return duration;
}

    GlideElement – getGlideRecord()

    Erhält einen Glide Record.

    Tabelle : 51. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 52. Ergebnisse
    Typ Beschreibung
    GlideRecord Ein GlideRecord-Objekt. 
    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(Number maxChars)

    Gibt den HTML-Wert eines Feldes zurück.

    Tabelle : 53. Parameter
    Name Typ Beschreibung
    maxChars Zahl Optional. Maximale Anzahl der Zeichen, die zurückgegeben werden sollen.
    Tabelle : 54. Ergebnisse
    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

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

    GlideElement – getHTMLValueExt(Number maxChar, String nullSub)

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

    Tabelle : 55. Parameter
    Name Typ Beschreibung
    maxChar Zahl 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 : 56. Ergebnisse
    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(Number mostRecent)

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

    Tabelle : 57. Parameter
    Name Typ Beschreibung
    mostRecent Zahl Bei 1 wird der neueste Eintrag zurückgegeben. Bei -1 werden alle Journaleinträge zurückgegeben.
    Tabelle : 58. Ergebnisse
    Typ Beschreibung
    Zeichenfolge

    Gibt für den neuesten Eintrag eine Zeichenfolge zurück, die die Feldbezeichnung, den Zeitstempel und den Anzeigenamen des Benutzers des Journaleintrags enthält.

    Gibt für alle Journaleinträge die gleichen Informationen für alle jemals eingetragenen Journaleinträge als einzelne Zeichenfolge zurück, wobei jeder Eintrag durch „\n\n“ abgetrennt 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

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

    GlideElement – getLabel()

    Gibt die Objektbezeichnung zurück.

    Tabelle : 59. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 60. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Objektbezeichnung 
    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

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

    GlideElement – getLabelLang(String language)

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

    Sie benötigen das entsprechende Sprach-Plugin, um einen übersetzten Wert abzurufen. Diesbezügliche Informationen finden Sie unter Activate a language.

    Siehe auch:
    Tabelle : 61. Parameter
    Name Typ Beschreibung
    language Zeichenfolge Sprach-Tag, das IETF BCP-47 entspricht.
    Tabelle : 62. Ergebnisse
    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 Benutzers übersetzt wurde. Wenn keine Übersetzung verfügbar ist, wird standardmäßig Englisch verwendet.

    Das folgende Beispiel zeigt, wie der ursprüngliche Bezeichnungstext und die englische Übersetzung des Akzeptieren -Titels (UI-Ansicht) abgerufen werden.

    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

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

    GlideElement – getName ()

    Gibt den Namen des Feldes zurück.

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

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

    GlideElement – getRefRecord()

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

    Warnung:
    Wenn das Referenzelement keinen Wert enthält, wird ein leeres GlideRecord-Objekt zurückgegeben, kein NULL-Objekt.
    Tabelle : 65. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 66. Ergebnisse
    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

    Um die getRefRecord()-Methode in einer Bereichsanwendung zu verwenden, verwenden Sie die entsprechende Bereichsmethode: getRefRecord().

    GlideElement – getStyle()

    Rufen Sie den CSS-Stil für den Wert ab.

    Tabelle : 67. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 68. Ergebnisse
    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 Feldtabelle zurück.

    Tabelle : 69. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 70. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Name der Tabelle. Dies kann sich von der Tabellenklasse unterscheiden, in der das Feld definiert ist. Siehe Tabellen und Klassen in der Produktdokumentation. 
    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

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

    GlideElement – getTextAreaDisplayValue()

    Ruft den Anzeigewert für das zugeordnete Feld ab und versieht den HTML-Code mit Escape-Zeichen.

    Tabelle : 71. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 72. Ergebnisse
    Typ Beschreibung
    Zeichenfolge HTML- Anzeigewert mit Escape-Zeichen für das zugeordnete Feld.

    Im folgenden Beispiel wird der Anzeigewert eines KB-Artikels abgerufen.

    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 : 73. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 74. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der Wert des Felds.

    Im folgenden Beispiel wird der Wert eines angegebenen Felds in der Datenbank abgerufen.

    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

    GlideElement – getXHTMLValue()

    Ruft den XHTML-Wert eines Feldes ab.

    Tabelle : 75. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 76. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der XHTML-Wert

    GlideElement – getXMLValue()

    Ruft den XML-Wert eines Feldes als Zeichenfolge ab.

    Tabelle : 77. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 78. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der XML-Wert

    GlideElement – hasAttribute(String attributeName)

    Bestimmt, ob ein Feld ein bestimmtes Attribut hat.

    Tabelle : 79. Parameter
    Name Typ Beschreibung
    attributName Zeichenfolge Das Attribut, das überprüft werden soll
    Tabelle : 80. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn das Feld das Attribut hat, andernfalls „false“. 
    var totalCritical = 0;
 
var filledCritical = 0; var fields = current.getFields(); gs.print(fields); for (var num = 0; num < fields.size(); num++) { 
 
    gs.print("RUNNING ARRAY VALUE " + num);
   var ed = fields.get(num).getED();
   if(ed.hasAttribute("tiaa_critical")) {
       gs.print("CRITICAL FIELD FOUND");
       totalCritical ++;
       if (!fields.get(num).isNil()) {
           filledCritical ++;
       }
   }
 
} var answer = 0; gs.print("TOTAL - " + totalCritical); gs.print("FILLED - " + filledCritical); if (filledCritical > 0 && totalCritical > 0){ 
 
    var pcnt = (filledCritical/totalCritical)*100;
   answer = pcnt.toFixed(2);;    
 
} answer;

    GlideElement – hasRightsTo(String operationName)

    Bestimmt, ob der Benutzer das Recht hat, eine bestimmte Operation auszuführen.

    Tabelle : 81. Parameter
    Name Typ Beschreibung
    operationName Zeichenfolge Name des Vorgangs, der überprüft werden soll
    Tabelle : 82. Ergebnisse
    Typ Beschreibung
    Boolean True, wenn der Benutzer die Berechtigung zum Ausführen des Vorgangs hat, andernfalls false.

    Kennzeichnung, die angibt, ob ein Benutzer die Berechtigung zum Ausführen eines Vorgangs hat.

    Gültige Werte:
    • true: Benutzer hat Berechtigungen.
    • false: Benutzer hat keine Berechtigungen.

    Das folgende Beispiel zeigt, wie Sie feststellen können, ob ein Benutzer über Leserechte für eine bestimmte Tabelle verfügt.

    // 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 : 83. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 84. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn das Feld einen Wert hat, andernfalls „false“.

    GlideElement – nil()

    Bestimmt, ob das Feld null ist.

    Tabelle : 85. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 86. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn das Feld null oder eine leere Zeichenfolge ist, andernfalls „false“. 
    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

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

    GlideElement – setDateNumericValue(Number milliseconds)

    Legt das Dauerfeld auf eine Anzahl von Millisekunden seit dem 1. Januar 1970 um 00:00:00 GMT fest. Erfordert nicht die Erstellung eines GlideDateTime-Objekts, da das Dauerfeld bereits ein GlideDateTime-Objekt ist.

    Tabelle : 87. Parameter
    Name Typ Beschreibung
    milliseconds Zahl Anzahl der Millisekunden (Dauer).
    Tabelle : 88. Ergebnisse
    Typ Beschreibung
    void 
    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

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

    GlideElement – setDisplayValue(Object displayValue)

    Legt den Anzeigewert des Feldes fest.

    Tabelle : 89. Parameter
    Name Typ Beschreibung
    displayValue Objekt Wert, der angezeigt werden soll.
    Tabelle : 90. Ergebnisse
    Typ Beschreibung
    void

    Bereichsbezogenes Äquivalent

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

    GlideElement – setError(String message)

    Fügt dem zugeordneten Feld (Element) eine Fehlermeldung hinzu.

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

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

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

    GlideElement – setInitialValue(Object value)

    Legt den Anfangswert eines Feldes fest.

    Diese Methode ist veraltet. Verwenden Sie GlideElement – setValue(Object value) für diese Funktionalität.

    Tabelle : 93. Parameter
    Name Typ Beschreibung
    Wert Objekt Anfangswert für das Feld.
    Tabelle : 94. Ergebnisse
    Typ Beschreibung
    void

    GlideElement – setJournalEntry(String entry, String userName)

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

    Tabelle : 95. Parameter
    Name Typ Beschreibung
    Eintrag Zeichenfolge Inhalt des Journaleintrags.
    userName Zeichenfolge Optional. Der Benutzer, dem der Journaleintrag zugeordnet werden soll. Legt nicht das „created by“-Feld des Journaleintrags fest.
    Tabelle : 96. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Sie eine Arbeitsnotiz und ihren Autor zu einem Datensatz hinzufügen.

    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(Object value)

    Legt den Wert eines Felds fest.

    Hinweis:
    Vor dem Aufruf dieser Methode muss das Element bereits vorhanden sein, indem ein vorhandener Datensatz abgefragt oder ein neuer Datensatz mit der Methode now_GR.initialize() initialisiert wird.
    Tabelle : 97. Parameter
    Name Typ Beschreibung
    Wert Objekt Der Wert, auf den das Feld gesetzt werden soll.
    Tabelle : 98. Ergebnisse
    Typ Beschreibung
    void

    Legen Sie den Wert fest, indem Sie eine Zeichenfolge übergeben.

    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

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

    GlideElement – toString()

    Konvertiert den Feldwert in eine Zeichenfolge.

    Tabelle : 99. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 100. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der Feldwert 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

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