GlideElement : Global

GlideElement – canCreate()

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

Tabelle : 1. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 2. Ergebnisse
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: Der Anwender kann neue Einträge erstellen. „falsch“: Der Anwender kann keine neuen Einträge erstellen.

Das folgende Beispiel zeigt, wie Sie feststellen können, ob ein Benutzer berechtigt ist, Einträge für die drei neuesten Datensätze in der Tabelle „Problem“ [problem] zu erstellen.

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 Sie eine Liste aktiver Incident-Datensätze mit einem lesbaren Feld Kurzbeschreibung 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.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 Sie eine Liste aktiver Incident-Datensätze mit einem beschreibbaren Feld Kurzbeschreibung 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

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 Geschäftsregel zeigt, wie ein Event in 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. Weitere Informationen finden Sie unter Table extension and classes in der Produktdokumentation.

Das folgende Beispiel zeigt, wie Sie die Basistabelle für das Feld Zuweisungsgruppe eines Incident-Datensatzes verwenden.

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 (Zeichenfolgenabhä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 im zugeordneten Datensatz, von dem das Auswahllistenfeld abhängt.

Tabelle : 24. Rückgaben
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 Sie die Auswahlbezeichnung für Change-Anforderungsdatensätze mit dem Prioritätswert Normal abrufen.

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.

Das folgende Beispiel zeigt, wie Sie das übergeordnete Feld des Felds Konfigurationselement mithilfe der Methode getDependent() finden.

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 hängt vom Feldtyp ab.

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 hängt vom Feldtyp ab.

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

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 wird als Ergebnis standardmäßig getDisplayValue()verwendet.

Sie müssen das entsprechende Sprach-Plugin haben, 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 in die Sprache des aktuellen Anwenders übersetzten Wert ab. Wenn keine Übersetzung verfügbar ist, wird standardmäßig Englisch als Ergebnis verwendet.

Das folgende Beispiel zeigt, wie Sie den Originaltext und den in Deutsch übersetzten Text aus dem Titelfeld Akzeptieren (UI-Ansicht) abrufen.

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 Methode getDisplayValueLang() 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 innerhalb dieser Felder.

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 Sie zurückgeben möchten.

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

In diesem Beispiel wird gezeigt, wie Sie einen Fehler für das Element short_description 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 die getEscapedValue()- Methode verwendet wird, um den Inhalt eines Felds mit Kurzbeschreibung für einen Incident mit Escape-Zeichen anzuzeigen.

/*** 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 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(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 Sie den HTML-Inhalt einer Besprechungsnotiz abrufen.

/*
  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 Sie den HTML-Inhalt einer Besprechungsnotiz abrufen.

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

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

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

Siehe auch:

Tabelle : 61. Parameter
Name	Typ	Beschreibung
language	Zeichenfolge	Sprach-Tag gemäß IETF BCP-47.

Tabelle : 62. Rückgaben
Typ	Beschreibung
Zeichenfolge	Wert der Feldbezeichnung in der übergebenen Sprache. Wenn keine Übersetzung verfügbar ist, ruft die Methode einen in die Sprache des aktuellen Anwenders übersetzten Wert ab. Wenn keine Übersetzung verfügbar ist, wird standardmäßig Englisch als Ergebnis verwendet.

Das folgende Beispiel zeigt, wie Sie den ursprünglichen Bezeichnungstext und die englische Übersetzung des Titels „ Akzeptieren (UI-Ansicht)“ abrufen.

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 Methode getLabelLang() in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende 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 Sie den Namen und andere Werte für jedes Feld in einem sys_user-Datensatz abrufen.

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.

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

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 für 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 Anwender zum Ausführen eines Vorgangs berechtigt ist. Gültige Werte: wahr: Der Anwender verfügt über Berechtigungen. „falsch“: Der Anwender 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(Anzahl Millisekunden)

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 getError()- Methode 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(Objektwert)

Legt den Anfangswert eines Feldes fest.

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

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

Tabelle : 94. Ergebnisse
Typ	Beschreibung
void

GlideElement – setJournalEntry(Zeichenfolgeneintrag, Zeichenfolge 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.

Tabelle : 96. Rückgaben
Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie einem Datensatz eine Arbeitsnotiz und ihren Autor 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 Aufrufen dieser Methode muss das Element bereits vorhanden sein, indem ein vorhandener Datensatz abgefragt oder die Methode now_GR.initialize() zum Initialisieren eines neuen Datensatzes verwendet wird.

Nicht für Authentifizierung mit Passwort2-Feldern

Die Methode „setValue()“ übergibt password2-Daten als Klartext, was zu einem Fehler führt, weil verschlüsselte Daten erwartet werden. Darüber hinaus werden durch die Verwendung der Methode „setValue()“ für password2-Felder Daten verfügbar gemacht, die verschlüsselt werden sollten.

Verwenden Sie für die password2-Authentifizierung stattdessen die Methode setDisplayValue().

Siehe auch:

Tabelle : 97. Parameter
Name	Typ	Beschreibung
Wert	Objekt	Der Wert, auf den das Feld gesetzt werden soll.

Tabelle : 98. Ergebnisse
Typ	Beschreibung
Keine

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, indem Sie ein Objekt übergeben.

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