CIUtils : Global

Die Skripteinbindung CIUtils ist eine Dienstprogrammklasse, die Methoden für die Arbeit mit Configuration Items (CI) bereitstellt.

Standardmäßig verwendet das System beim Durchlaufen von CI-Beziehungen eine maximale Tiefe von 10. Sie können diesen Wert überschreiben, indem Sie die Eigenschaft „glide.relationship.max_tiefe“ ändern.

Die maximale Anzahl von Elementergebnissen ist 1000. Sie können diesen Wert überschreiben, indem Sie die Eigenschaft glide.relationship.threshold ändern.

Die Klasse CIUtils ist für serverseitige Skripts verfügbar.

CIUtils – servicesAffectedByCI(String CI_sys_id)

Bestimmt, welche Business-Services von dem spezifischen Configuration Item (CI) betroffen sind.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
CI_sys_id	Zeichenfolge	Die sys_id eines zu überprüfenden Konfigurationselements (cmdb_ci).

Tabelle : 2. Rückgaben

Typ	Beschreibung
Array	Ein Array von sys_id-Werten für cmdb_ci-Datensätze hinter dem angegebenen Element (oder solche, die davon beeinflusst werden).

In diesem Beispiel werden die Namen der Services angezeigt, die von den CI-Elementen mit dem Namen = lnux100 betroffen sind.

var CIUtil = new CIUtils();
 
//get a server record
var server = new GlideRecord("cmdb_ci_server");
server.addQuery("name", "lnux100");
server.query();
if (server.next()) {
  //get the affected services, array of ids
  var serviceIds = CIUtil.servicesAffectedByCI(server.getUniqueValue());
  for (var i=0; i < serviceIds.length; i++) {
    //get the service record
    var service = new GlideRecord("cmdb_ci_service");
    service.get(serviceIds[i]);
    gs.print(service.getDisplayValue());
  }
}

Ausgabe:

Client Services
IT Services
Bond Trading

CIUtils – servicesAffectedByTask(GlideRecord task)

Bestimmt, welche Business-Services von der angegebenen Aufgabe betroffen sind.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
task	GlideRecord	Aufgaben-GlideRecord, z. B. „Incident“, „change_request“ oder „problem“.

Tabelle : 4. Rückgaben

Typ	Beschreibung
Array	Liste der sys_id-Werte für CIs, die dem Konfigurationselement nachgelagert sind (oder von diesem betroffen sind), auf das das Feld „cmdb_ci“ der Aufgabe verweist.

In diesem Beispiel werden die Namen der Services angezeigt, die vom Incident INC00050 betroffen sind.

var CIUtil = new CIUtils();
 
//get an incident record
var inc = new GlideRecord("incident");
inc.addQuery("number", "INC00050");
inc.query();
if (inc.next()) {
  //get the affected services, array of ids
  var serviceIds = CIUtil.servicesAffectedByTask(inc);
  for (var i=0; i < serviceIds.length; i++) {
    //get the service record
    var service = new GlideRecord("cmdb_ci_service");
    service.get(serviceIds[i]);
    gs.print(service.getDisplayValue());
  }
}

Ausgabe:

IT Services
Email
Windows Mobile
Electronic Messaging
Outlook Web Access (OWA)
Blackberry