GlideRecordUtil – Global

Eine Dienstprogrammklasse für die Arbeit mit GlideRecords.

Die GlideRecordUtil-Klasse ist in serverseitigen Skripts verfügbar. Informationen zu Anwendungsfällen finden Sie unter Discovery-Skripteinbindungenverwenden.

GlideRecordUtil – getCIGR(String sys_id)

Gibt das GlideRecord-Objekt für das angegebene Konfigurationselement (CI) zurück und verwendet nur die sys_id des CI.

Verwenden Sie diese Methode, um schnell ein bestimmtes CI zu erhalten, ohne die zugehörige Klasse/Tabelle zu kennen.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
sys_id	Zeichenfolge	Sys_id des gewünschten CI.

Tabelle : 2. Ergebnisse

Typ	Beschreibung
GlideRecord	GlideRecord-Objekt des angegebenen CI.

Im folgenden Beispiel wird das GlideRecord-Objekt für das angegebene CI zurückgegeben, wobei nur die sys_id des CI verwendet wird.

var now_GR = new GlideRecordUtil().getCIGR("2dfd7c8437201000deeabfc8bcbe5d56");

GlideRecordUtil – getFields(GlideRecord gr)

Gibt ein Array aller Felder im angegebenen GlideRecord zurück.

Hinweis:

Wenn ein Feldname mit dem Tabellennamen identisch ist, gibt die Methode getFields() nicht den Wert des Felds zurück.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
gr	GlideRecord	GlideRecord-Instanz, die an einem gültigen Datensatz positioniert ist.

Tabelle : 4. Ergebnisse

Typ	Beschreibung
Array	Feldnamen für den angegebenen GlideRecord.

var queryString = "priority=1^ORpriority=2";
var now_GR = new GlideRecord('incident');
now_GR.addEncodedQuery(queryString);
now_GR.query();
now_GR.next();

var gRU = new GlideRecordUtil();
var fieldList = gRU.getFields(now_GR);
gs.info(fieldList);

Ausgabe: Zeilenumbrüche für die Präsentation hinzugefügt.

sys_id,skills,closed_by,assigned_to,contract,category,escalation,state,reassignment_count,location,
time_worked,order,due_date,number,upon_approval,sys_tags,sla_due,follow_up,reopen_count,notify,business_stc,
caused_by,rejection_goto,assignment_group,comments_and_work_notes,incident_state,opened_at,parent_incident,
business_service,wf_activity,calendar_duration,group_list,caller_id,comments,priority,sys_updated_by,
variables,delivery_task,resolved_at,sys_updated_on,parent,active,opened_by,expected_start,watch_list,
company,upon_reject,work_notes,sys_created_by,additional_assignee_list,approval_set,cmdb_ci,user_input,
sys_created_on,close_code,contact_type,resolved_by,rfc,approval_history,activity_due,severity,child_incidents,
,subcategory,work_end,closed_at,close_notes,variables,business_duration,knowledge,approval,sys_domain_path,
sys_mod_count,problem_id,calendar_stc,work_start,sys_domain,correlation_id,sys_class_name,short_description,
impact,description,correlation_display,urgency,made_sla,delivery_plan,work_notes_list

GlideRecordUtil – getGR(String baseTable, String sys_id)

Gibt eine GlideRecord-Instanz für die angegebene Tabelle zurück, positioniert an der angegebenen sys_id und mit der richtigen Klasse (Tabelle).

Diese Methode ist nützlich, wenn Sie einen GlideRecord aus einer sys_id laden müssen, aber Sie nicht wissen, was die tatsächliche Tabelle ist (da sie möglicherweise von der Basistabelle aus erweitert wird). Diese Methode gibt immer einen GlideRecord des korrekten Typs „base_table“ zurück: den Namen der Basistabelle, in der sich die angegebene sys_id befindet.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
baseTable	Zeichenfolge	Name der Basistabelle, die die sys_id enthält.
sys_id	Zeichenfolge	sys_id des gewünschten Datensatzes.

Tabelle : 6. Ergebnisse

Typ	Beschreibung
GlideRecord	GlideRecord für die angegebene sys_id.

var now_GR = new GlideRecordUtil().getGR("cmdb_ci_computer", "2dfd7c8437201000deeabfc8bcbe5d56");

GlideRecordUtil – getTables(String tableName)

Gibt eine Java-ArrayList der Vorfahren des angegebenen Tabellennamens zurück.

Bei gegebenem cmdb_ci_linux_server würde dies beispielsweise cmdb_ci_linux_server, cmdb_ci_server, cmdb_ci_computer, cmdb_ci_hardware, cmdb_ci und cmdbr zurückgeben.

Tabelle : 7. Parameter

Name	Typ	Beschreibung
tableName	Zeichenfolge	Name der Tabelle.

Tabelle : 8. Ergebnisse

Typ	Beschreibung
ArrayList	Liste der Vorfahren der angegebenen Tabelle.

Das folgende Beispiel zeigt die Vorfahren der Tabelle cmdb_ci_linux_server.

var tables = new GlideRecordUtil().getTables("cmdb_ci_linux_server");
gs.info("Tables returned: " + tables);

Ausgabe:

Tables returned: [cmdb_ci_linux_server, cmdb_ci_server, cmdb_ci_computer, cmdb_ci_hardware, cmdb_ci, cmdb]

GlideRecordUtil – mergeToGR(Object hashMap, GlideRecord now_GR, Object ignore)

Legt die Felder im angegebenen GlideRecord mit den Feldwerten fest, die in der angegebenen Hashmap enthalten sind, es sei denn, dieser Feldname befindet sich in der ignore-Hashmap.

Tabelle : 9. Parameter

Name	Typ	Beschreibung
hashMap	Objekt	Objektinstanz (die als Hashmap verwendet wird), deren Eigenschaften nach Feldern benannt werden und deren Wert enthalten.
GlideRecord	GR	GlideRecord-Instanz, um die Feldwerte zu erhalten.
ignore	Objekt	Optionale Hashmap von zu ignorierenden Feldnamen.

Tabelle : 10. Ergebnisse

Typ	Beschreibung
void

In diesem Beispiel werden die Felder „Name“ und „System“ eines Computerdatendsatzes aktualisiert, das Feld „sys_created_by“ jedoch nicht:

var now_GR = new GlideRecordUtil().getGR("cmdb_ci_computer", "2dfd7c8437201000deeabfc8bcbe5d56");   
var obj = {"name": "xyz", "os": "windows 2000", "sys_created_by", "aleck.lin"};
var ignore = {"sys_created_by": true};
new GlideRecordUtil().mergeToGR(obj, now_GR, ignore);
now_GR.update();

GlideRecordUtil – populateFromGR(Object hashMap, GlideRecord now_GR, Object ignore)

Füllt die angegebene Hashmap aus der angegebenen GlideRecord-Instanz. Jedes Feld im GlideRecord wird zu einer Eigenschaft in der Hashmap.

Tabelle : 11. Parameter

Name	Typ	Beschreibung
hashMap	Objekt	Objekt, das als Hashmap verwendet wird.
now_GR	GlideRecord	Eine GlideRecord-Instanz, die an einem gültigen Datensatz positioniert ist.
ignore	Objekt	Optionale Hashmap von Dateinamen, die nicht gefüllt werden sollen.

Tabelle : 12. Ergebnisse

Typ	Beschreibung
void

var objectToPopulate = {};
var now_GR = new GlideRecordUtil().getGR("cmdb_ci_computer", "2dfd7c8437201000deeabfc8bcbe5d56");
var ignore = {"sys_created_on": true, "sys_updated_by": true};
new GlideRecordUtil().populateFromGR(objectToPopulate, now_GR, ignore);
// Now the objectToPopulate contains field/value pairs from the computer GlideRecord