GlideElement : Bereichsbezogen

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

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

Scoped GlideElement – canRead()

Gibt an, 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

Scoped 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

Scoped 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 die Felder geändert wurden, „false“, wenn das Feld nicht geändert wurde.

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

Scoped GlideElement – changesFrom(Object o)

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
o	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 übereinstimmt, „false“, wenn dies nicht der Fall ist.

// The following example shows that in a business rule, if "active" field is changed from true, 
// insert a event in the EventQueue.
if (current.active.changesFrom(true)) {
  gs.eventQueue("incident.inactive", current, current.incident_state, previous.incident_state);
}

Scoped GlideElement – changesTo(Object o)

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
o	Objekt	Ein Objektwert, der mit dem neuen Wert des aktuellen Feldes verglichen werden soll.

Tabelle : 12. Ergebnisse

Typ	Beschreibung
Boolean	„True“, wenn der vorherige Wert übereinstimmt, „false“, wenn dies nicht der Fall ist.

// The following example shows that in a business rule, if "active" field is changed to false, 
// insert a event in the EventQueue.
if (current.active.changesTo(false)) {
  gs.eventQueue("incident.inactive", current, current.incident_state, previous.incident_state);
}

Bereichsbezogenes 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

Scoped 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 : 15. Parameter

Name	Typ	Beschreibung
attributName	Zeichenfolge	Attributname

Tabelle : 16. 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.info("we got one");
    gs.info(now_GR.location.getAttribute("tree_picker"));
  }
}

Scoped GlideElement – getBooleanAttribute(String attributeName)

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

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

Tabelle : 17. Parameter

Name	Typ	Beschreibung
attributName	Zeichenfolge	Attributname

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

Scoped GlideElement – getChoices(String dependent)

Gibt die Auswahlliste für ein angegebenes Feld zurück.

Das Feld, für das die Auswahlliste zurückgegeben werden soll, ist im Methodenaufruf angegeben. Beispiel: varauswahl = glideRecord.rugency.getChoices();. Informationen zu den Typen von Auswahllistenfeldern und den zugehörigen Funktionen finden Sie unter Auswahllistenfeldtyp.

Tabelle : 19. Parameter

Name	Typ	Beschreibung
dependent	Zeichenfolge	Optional. Feld im zugeordneten Datensatz, von dem das Auswahllistenfeld abhängt.

Tabelle : 20. Rückgaben

Typ	Beschreibung
Array	Liste der möglichen Werte für die Auswahlliste. Dies sind die Werte in der Auswahltabelle [sys_choice]. Wenn der Parameter dependent übergeben wird, spiegeln die zurückgegebenen Ergebnisse nur die Auswahlmöglichkeiten wider, die für das angegebene abhängige Feld verfügbar sind.

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

Scoped GlideElement – getChoiceValue()

Gibt die Auswahlbezeichnung für die aktuelle Auswahl zurück.

Eine Auswahl hat einen Wert (Zahl) und eine Beschriftung (Zeichenfolge). Diese Methode gibt die Bezeichnung zurück.

Tabelle : 21. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 22. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Die Bezeichnung der ausgewählten Auswahl.

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 choiceLabel = glideRecord.urgency.getChoiceValue(); 
gs.info(choiceLabel);

Ausgabe:

1 - High

Scoped GlideElement – getDecryptedValue()

Gibt den Klartextwert für Passwortfelder (2-fach verschlüsselt) in bereichsbezogenen Anwendungen zurück.

Tabelle : 23. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 24. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Das Klartext-Passwort.

var tablename = 'x_scoped_app_table'
var CI = new GlideRecord(tablename);  
CI.addQuery('number', '0001002'); 
CI.query(); 
CI.next(); 

var password = CI.password_field
var decrypted = password.getDecryptedValue(); 
gs.info(decrypted);

Ausgabe:

x_scoped_app: cleartextpassword

Scoped GlideElement – getDisplayValue(Number maxCharacters)

Gibt den formatierten Anzeigewert eines angegebenen Felds aus einem zugeordneten GlideRecord-Objekt 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.

Weitere Informationen zu Anzeigewerten finden Sie unter Anzeigewerte.

Tabelle : 25. Parameter

Name	Typ	Beschreibung
maxCharacters	Nummer	Optional. Maximale Anzahl von Zeichen. Standard: Alle

Tabelle : 26. Rückgaben

Typ	Beschreibung
Zeichenfolge	Anzeigewert des angegebenen Felds.

Das folgende Beispiel zeigt, wie der Anzeigewert des Felds „Priorität“ in einem Incident-Datensatz abgerufen wird.

var glideRecord = new GlideRecord('incident');
glideRecord.query('priority','1');
glideRecord.next();
gs.info(glideRecord.priority.getDisplayValue());

Ausgabe:

1 - Critical

Das folgende Beispiel zeigt, wie sowohl der Anzeigewert als auch der interne Wert angegebener Felder in der Incident-Datenbank abgerufen werden.

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

Ausgabe:

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

Bereichsbezogenes 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 : 27. Parameter

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

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

Scoped GlideElement – getED()

Gibt den Elementdeskriptor des Feldes zurück.

Tabelle : 29. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 30. Ergebnisse

Typ	Beschreibung
GlideElementDescriptor	Der Elementdeskriptor des Feldes.

var grInc = new GlideRecord('incident');
grInc.query('priority', '1');
 
var field = grInc.getElement('priority');
var ed = field.getED();

Scoped GlideElement – getGlobalDisplayValue()

Gibt die Telefonnummer im internationalen Format zurück.

Tabelle : 31. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 32. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Telefonnummer im internationalen Format.

Das folgende Beispiel zeigt, wie Sie die Telefonnummer eines Walk-up-Standorts abrufen. Dieses Beispiel erfordert das Plugin Walk-Up Experience.

// Passing walkup location name and closed phone number in parameters
setWalkupLocPhone('Santa Clara Tech Lounge','phone_number');

function setWalkupLocPhone(locName, field) {
  var walkupLoc = new GlideRecord('wu_location_queue');
  walkupLoc.addQuery('name',locName);
  walkupLoc.query();
  walkupLoc.next();

  // Returns the phone number of walk-up location queue in international format
  gs.info(walkupLoc[field].getGlobalDisplayValue());
}

Ausgabe:

[phone]

Scoped GlideElement – getHTMLValue(Number maxChars)

Gibt den HTML-Wert eines Feldes zurück.

Tabelle : 33. Parameter

Name	Typ	Beschreibung
maxChars	Zahl	Optional. Maximale Anzahl der Zeichen, die zurückgegeben werden sollen.

Tabelle : 34. Ergebnisse

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

var inccause = new GlideRecord("incident");
inccause.short_description = current.short_description;
inccause.comments = current.comments.getHTMLValue();
inccause.insert();

Scoped GlideElement – getJournalEntry(Number mostRecent)

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

Tabelle : 35. Parameter

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

Tabelle : 36. 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.info(na[i]);

Scoped GlideElement – getLabel()

Gibt die Objektbezeichnung zurück.

Tabelle : 37. Parameter

Name	Typ	Beschreibung
Keine

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

• abrufenAnzeigewertLänger ()
• abrufenLabel ()

Tabelle : 39. Parameter

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

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

Scoped GlideElement – getName()

Gibt den Namen des Feldes zurück.

Tabelle : 41. Parameter

Name	Typ	Beschreibung
Keine

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

Scoped GlideElement – getReferenceTable()

Ruft den Tabellennamen für ein Referenzelement ab.

Tabelle : 43. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 44. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Tabellenname der Referenz.

var grINC = new GlideRecord('incident');
grINC.query('number','INC0010041'); // record assignment group assigned to "CAB Approval"
if (grINC.next()) { 
  // Get the table name 
  var tableName = grINC.assignment_group.getReferenceTable();
  gs.info( tableName ); 
}

Scoped 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 : 45. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 46. Ergebnisse

Typ	Beschreibung
GlideRecord	Ein GlideRecord-Objekt

var grINC = new GlideRecord('incident'); 
grINC.addNotNullQuery('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.info(grUSER.getValue('name')); 

} 

Scoped GlideElement – getTableName()

Gibt den Namen der Tabelle zurück, in der sich das Feld befindet.

Tabelle : 47. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 48. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Name der Tabelle. Der zurückgegebene Wert kann sich von der Tabellenklasse unterscheiden, in der sich der Datensatz befindet. 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()+")");
}
 
}

Scoped GlideElement – nil()

Bestimmt, ob ein Feld null ist.

Tabelle : 49. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 50. Ergebnisse

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob das Feld NULL ist. Mögliche Werte: wahr: Feld ist NULL. „falsch“: Feld ist nicht NULL.

var glideRecord = new GlideRecord('incident'); 
glideRecord.query('priority','1'); 
glideRecord.next(); 
gs.info(glideRecord.state.nil());

Ausgabe:

false

Scoped GlideElement – setDateNumericValue(Number milliseconds)

Legt den Wert eines Datums-/Zeitelements auf die angegebene Anzahl von Millisekunden seit dem 1. Januar 1970 um 00:00:00 GMT fest.

Wenn setDateNumericValue() aufgerufen wird, wird automatisch das erforderliche GlideDateTime-/GlideDate-/GlideDuration-Objekt aufgerufen und dann das Element auf den angegebenen Wert gesetzt.

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.

Tabelle : 51. Parameter

Name	Typ	Beschreibung
milliseconds	Zahl	Anzahl der Millisekunden seit dem 1.1.1970

Tabelle : 52. Ergebnisse

Typ	Beschreibung
void

var now_GR = new GlideRecord("incident");
now_GR.initialize();
now_GR.opened_at.setDateNumericValue(10000);

Scoped GlideElement – setDisplayValue(Object value)

Legt den Anzeigewert des Feldes fest.

Tabelle : 53. Parameter

Name	Typ	Beschreibung
Wert	Objekt	Der Wert, der für das Feld festgelegt werden soll.

Tabelle : 54. Ergebnisse

Typ	Beschreibung
void

var glideRecord = new GlideRecord('incident'); 
glideRecord.query('priority','1'); 
glideRecord.next();
 
//change the urgency to 3 
glideRecord.urgency.setDisplayValue('3 - Low');
gs.info(glideRecord.urgency);

Scoped GlideElement – setError(String errorMessage)

Fügt eine Fehlermeldung hinzu. Verfügbar in Fuji-Patch 3.

Tabelle : 55. Parameter

Name	Typ	Beschreibung
errorMessage	Zeichenfolge	Die Fehlermeldung.

Tabelle : 56. Ergebnisse

Typ	Beschreibung
void

var glideRecord = new GlideRecord('incident');
glideRecord.query('priority','1');
glideRecord.next();
 
glideRecord.short_description.setError('Error text');

Scoped GlideElement – setPhoneNumber (Object phoneNumber, Boolean strict)

Legt das Feld auf die angegebene Telefonnummer fest.

Diese Methode ist nur für ein Telefonnummer-Glide Element verfügbar.

Tabelle : 57. Parameter

Name	Typ	Beschreibung
phoneNumber	Objekt	Die Telefonnummer, die festgelegt werden soll. Dies kann entweder im internationalen oder im lokalen Format erfolgen.
strict	Boolean	Bei „true“ wird angegeben, dass die angegebene Anzahl mit dem richtigen Format übereinstimmen muss. Bei „false“ versucht das System, eine falsch formatierte Telefonnummer zu korrigieren.

Tabelle : 58. Ergebnisse

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob der Telefonnummernwert festgelegt wurde. Mögliche Werte: true: Wert wurde festgelegt. „falsch“: Wert wurde nicht festgelegt.

Das folgende Beispiel zeigt, wie die Telefonnummer eines Walk-up-Standorts festgelegt wird. Dieses Beispiel erfordert das Plugin Walk-Up Experience.

setWalkupLocPhone('Santa Clara Tech Lounge','[phone]'); 

function setWalkupLocPhone(locName, phoneNumber) {
  var walkupLoc = new GlideRecord('wu_location_queue');
  walkupLoc.addQuery('name', locName);
  walkupLoc.query();
  walkupLoc.next();
  
  // Set phone number of walk-up location
  var isPhoneNumberSet = walkupLoc.phone_number.setPhoneNumber(phoneNumber, true);
  walkupLoc.update();
  gs.info('Phone Number: ' + walkupLoc.phone_number);
  gs.info('Is phone number specified match the correct format: ' + isPhoneNumberSet);
}

Ausgabe:

Phone Number: [phone]
Is phone number specified match the correct format: true

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

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

Tabelle : 59. Parameter

Name	Typ	Beschreibung
Wert	Objekt	Objektwert, auf den das Feld gesetzt werden soll.

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

Scoped GlideElement – toString()

Konvertiert den Wert eines GlideRecord-Felds in eine Zeichenfolge.

Tabelle : 61. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 62. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Wert als Zeichenfolge.

var glideRecord = new GlideRecord('incident');
glideRecord.query('priority','1');
glideRecord.next();
gs.info(glideRecord.opened_at.toString());

Ausgabe:

2019-08-31 23:09:51