GlideElement – Umfang

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

Bereichsbezogenes GlideElement – canCreate()

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

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 2. Rückgaben

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

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

var gr = new GlideRecord('problem');

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

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

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

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

Ausgabe:

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

Bereichsbezogenes Äquivalent

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

Bereichsbezogenes GlideElement – canRead()

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

Tabelle : 3. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 4. Rückgaben

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

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

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

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

Ausgabe:

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

Bereichsbezogenes GlideElement – canWrite()

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

Tabelle : 5. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 6. Rückgaben

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

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

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

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

Ausgabe:

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

Bereichsbezogenes GlideElement – Changes()

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

Hinweis:

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

Hinweis:

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

Tabelle : 7. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 8. Rückgaben

Typ	Beschreibung
Boolean	„Wahr“, wenn die Felder geändert wurden, „falsch“, wenn das Feld nicht geändert wurde.

Das folgende Beispiel aus einer Business-Regel zeigt, wie ein Ereignis in der EventQueue erstellt wird, wenn der Wert von ist Assigned_to Feldänderungen.

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

Bereichsbezogenes GlideElement – changesfrom(Object o)

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

Hinweis:

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

Tabelle : 9. Parameter

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

Tabelle : 10. Rückgaben

Typ	Beschreibung
Boolean	„Wahr“, wenn der vorherige Wert übereinstimmt, „falsch“, 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);
}

Bereichsbezogenes GlideElement – changesTo(Objekt o)

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

Hinweis:

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

Hinweis:

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

Tabelle : 11. Parameter

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

Tabelle : 12. Rückgaben

Typ	Beschreibung
Boolean	„Wahr“, wenn der vorherige Wert übereinstimmt, „falsch“, 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, 00:00:00 GMT für ein Feld für die Dauer zurück. Erfordert nicht die Erstellung eines GlideDateTime-Objekts, da das Feld „Dauer“ bereits ein GlideDateTime-Objekt ist.

Tabelle : 13. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 14. Rückgaben

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

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

Ausgabe:

98000

Bereichsbezogenes GlideElement – getAttribute(Zeichenfolge attributeName)

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

Wenn das Attribut ein boolesches Attribut ist, verwenden Sie GetBooleanAttribute (Zeichenfolge) Dient zum Abrufen des Werts als boolescher Wert und nicht als Zeichenfolge.

Tabelle : 15. Parameter

Name	Typ	Beschreibung
attributeName	Zeichenfolge	Attributname

Tabelle : 16. Rückgaben

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

Bereichsbezogenes GlideElement – getBooleanAttribute(String attributeName)

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

Verwenden Sie, um den Wert als Zeichenfolge abzurufen GetAttribute(Zeichenfolge) .

Tabelle : 17. Parameter

Name	Typ	Beschreibung
attributeName	Zeichenfolge	Attributname

Tabelle : 18. Rückgaben

Typ	Beschreibung
Boolean	Boolescher Wert des Attributs. Gibt „falsch“ zurück, wenn das Attribut nicht vorhanden ist.

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

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

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

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

Ausgabe:

true
false

Bereichsbezogenes GlideElement – getChoices (Zeichenfolgenabhängig)

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

Das Feld, für das die Auswahlliste zurückgegeben werden soll, wird im Methodenaufruf angegeben. Beispiel: VAR-Auswahlmöglichkeiten = glideRecord.Dringlichkeit.getChoices(); . Informationen zu Auswahllistenfeldtypen und den zugehörigen Fähigkeiten finden Sie unter Feldtyp der Auswahlliste .

Tabelle : 19. Parameter

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

Tabelle : 20. Rückgaben

Typ	Beschreibung
Array	Liste der möglichen Werte für die Auswahlliste, die die Werte in der Auswahltabelle [sys_choice] sind. Wenn dependentParameter wird übergeben, die Rückgabeergebnisse spiegeln 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();

Bereichsbezogenes GlideElement – getChoiceValue()

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

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

Tabelle : 21. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 22. Rückgaben

Typ	Beschreibung
Zeichenfolge	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

Bereichsbezogenes GlideElement – getDecryptedValue()

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

Tabelle : 23. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 24. Rückgaben

Typ	Beschreibung
Zeichenfolge	Das Klartextpasswort.

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

Bereichsbezogenes GlideElement – getDisplayValue(Number maxCharacters)

Gibt den formatierten Anzeigewert eines angegebenen Felds aus einem zugeordneten GlideRecord-Objekt zurück.

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

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

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

Weitere Informationen zu Anzeigewerten finden Sie unter Anzeigewerte .

Tabelle : 25. Parameter

Name	Typ	Beschreibung
Max. Zeichen	Nummer	Optional. Maximal Zeichen erforderlich. Standard: Alle

Tabelle : 26. Rückgaben

Typ	Beschreibung
Zeichenfolge	Anzeigewert des angegebenen Felds.

Das folgende Beispiel zeigt, wie der Anzeigewert des Prioritätsfelds 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 der angegebenen 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 Feld , Und Übersetzter Text . Für andere Feldtypen wird das Ergebnis standardmäßig auf festgelegt GetDisplayValue() .

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

Siehe auch Bereichsbezogenes GlideElement – getLabellang(Zeichenfolgensprache).

Tabelle : 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 Wert ab, der in die Sprache des aktuellen Anwenders übersetzt wurde. Wenn eine Übersetzung nicht verfügbar ist, wird das Ergebnis standardmäßig auf Englisch festgelegt.

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

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

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

Ausgabe:

getDisplayValue: Accept
getDisplayValueLang: Akzeptieren

Bereichsbezogenes GlideElement – getED()

Gibt den Elementdeskriptor des Felds zurück.

Tabelle : 29. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 30. Rückgaben

Typ	Beschreibung
GlideElementdeskriptor	Elementdeskriptor des Felds.

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

Bereichsbezogenes GlideElement – getGlobalDisplayValue()

Gibt die Telefonnummer im internationalen Format zurück.

Tabelle : 31. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 32. Rückgaben

Typ	Beschreibung
Zeichenfolge	Telefonnummer im internationalen Format.

Das folgende Beispiel zeigt, wie die Telefonnummer eines Walk-up-Standorts abgerufen wird. Dieses Beispiel erfordert Walk-Up ExperiencePlugin.

// 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]

Bereichsbezogenes GlideElement – getHTMLValue(Number maxChars)

Gibt den HTML-Wert eines Felds zurück.

Tabelle : 33. Parameter

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

Tabelle : 34. Rückgaben

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

Bereichsbezogenes GlideElement – getJournalEntry(Number mostRecent)

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

Tabelle : 35. Parameter

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

Tabelle : 36. Rückgaben

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

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

Bereichsbezogenes GlideElement – getLabel()

Gibt die Objektbezeichnung zurück.

Tabelle : 37. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 38. Rückgaben

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 über das entsprechende Sprach-Plugin verfügen, um einen übersetzten Wert abzurufen. Informationen hierzu finden Sie unter Activate a language.

Siehe auch:

• GetDisplayValueLang()
• GetLabel()

Tabelle : 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 Wert ab, der in die Sprache des aktuellen Anwenders übersetzt wurde. Wenn eine Übersetzung nicht verfügbar ist, wird das Ergebnis standardmäßig auf Englisch festgelegt.

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

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

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

Ausgabe:

getLabel: Title
getLabelLang: Titel

Bereichsbezogenes GlideElement – getName()

Gibt den Namen des Felds zurück.

Tabelle : 41. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 42. Rückgaben

Typ	Beschreibung
Zeichenfolge	Feldname.

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

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

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

var fields = userRec.getFields();

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

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

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

};

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

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

Bereichsbezogenes GlideElement – getReferenceTable()

Ruft den Tabellennamen für ein Referenzelement ab.

Tabelle : 43. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 44. Rückgaben

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

Bereichsbezogenes GlideElement – getRefRecord()

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

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

Warnung:

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

Tabelle : 45. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 46. Rückgaben

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

} 

Bereichsbezogenes GlideElement – getTableName()

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

Tabelle : 47. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 48. Rückgaben

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

Bereichsbezogenes GlideElement – nil()

Bestimmt, ob ein Feld null ist.

Tabelle : 49. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 50. Rückgaben

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

Bereichsbezogenes GlideElement – setDateNumericValue(Anzahl Millisekunden)

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

Wenn aufgerufen wird, SetDateNumericWert() Erstellt automatisch das erforderliche GlideDateTime/GlideDate/GlideDuration-Objekt und legt das Element dann auf den angegebenen Wert fest.

Hinweis:

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

Tabelle : 51. Parameter

Name	Typ	Beschreibung
Millisekunden	Nummer	Anzahl der Millisekunden seit 1/1/1970

Tabelle : 52. Rückgaben

Typ	Beschreibung
Ungültig

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

Bereichsbezogenes GlideElement – setDisplayValue(Objektwert)

Legt den Anzeigewert des Felds fest.

Tabelle : 53. Parameter

Name	Typ	Beschreibung
Wert	Objekt	Der für das Feld festzulegende Wert.

Tabelle : 54. Rückgaben

Typ	Beschreibung
Ungültig

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

Bereichsbezogenes GlideElement – setError(Zeichenfolge errorMessage)

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

Tabelle : 55. Parameter

Name	Typ	Beschreibung
errorMessage	Zeichenfolge	Die Fehlermeldung.

Tabelle : 56. Rückgaben

Typ	Beschreibung
Ungültig

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

Bereichsbezogenes GlideElement – setPhoneNumber(Objekt-PhoneNumber, boolescher Wert strikt)

Legt das Feld auf die angegebene Telefonnummer fest.

Diese Methode ist nur für ein GlideElement einer Telefonnummer verfügbar.

Tabelle : 57. Parameter

Name	Typ	Beschreibung
phoneNumber	Objekt	Die festzulegende Telefonnummer. Dies kann entweder im internationalen oder lokalen Format vorliegen.
Strikt	Boolean	Bei „wahr“ wird angegeben, dass die angegebene Zahl dem richtigen Format entsprechen muss. Bei „falsch“ versucht das System, eine falsch formatierte Telefonnummer zu korrigieren.

Tabelle : 58. Rückgaben

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob der Telefonnummernwert festgelegt wurde. Mögliche Werte: Wahr: Wert wurde festgelegt. Falsch: Wert wurde nicht festgelegt.

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

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

Bereichsbezogenes GlideElement – setValue(Objektwert)

Legt den Wert eines Felds fest.

Hinweis:

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

Nicht für Authentifizierung mit Passwort2-Feldern

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

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

Siehe auch:

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

Tabelle : 59. Parameter

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

Tabelle : 60. Rückgaben

Typ	Beschreibung
Keine

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

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

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

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

Bereichsbezogenes GlideElement – toString()

Konvertiert den Wert eines GlideRecord-Felds in eine Zeichenfolge.

Tabelle : 61. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 62. Rückgaben

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