CMDBDuplicateTemplateUtil – Global

Die CMDBDuplicateTemplateUtil Die Skripteinbindung bietet Methoden zum Hinzufügen und Entfernen von Deduplizierungsaufgaben zu einer Deduplizierungsvorlage.

Weitere Informationen zur Deduplizierung von CIs, Deduplizierungsaufgaben und Deduplizierungsvorlagen finden Sie unter Duplicate CIs remediation.

CMDBDuplicateTemplateUtils: CMDBDuplicateTemplateUtils()

Erstellt eine Instanz von CMDBDuplicateTemplateUtils Klasse.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Keine

Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird, um ein CMDBDuplicateTemplateUtils-Objekt zu erstellen.

var dupTemp = new CMDBDuplicateTemplateUtils();

CMDBDuplicateTemplateUtils – addTasksToTemplate(Zeichenfolge templateId, Array taskIds)

Fügt einer angegebenen Deduplizierungsvorlage eine oder mehrere Deduplizierungsaufgaben hinzu.

Diese Methode überschreibt alle vorhandenen Vorlagenwerte, protokolliert jedoch die vorherigen Werte für jede Vorlage in den Systemprotokollen.

Die folgende Liste beschreibt Szenarien, in denen eine Aufgabe keiner Vorlage hinzugefügt wird und dann als übersprungen oder fehlgeschlagen markiert wird:

• Die angegebene Vorlage befindet sich nicht im Status „veröffentlicht“. Alle Aufgaben sind als übersprungen markiert.
• Die angegebene Vorlage wird ausgeführt. Alle Aufgaben sind als übersprungen markiert.
• Die Aufgabe befindet sich nicht im Status „Offen“. Die Aufgabe ist als übersprungen markiert.
• Die Aufgabe ist nicht mit der angegebenen Vorlage kompatibel. Beispielsweise kann die angegebene Vorlage für Anwendungsserver Tomcat erstellt werden, aber die angegebene Deduplizierungsaufgabe wird für Linux Server erstellt. Die Aufgabe ist als übersprungen markiert.
• Die angegebene Vorlage ist nicht vorhanden. Alle Aufgaben sind als fehlgeschlagen markiert.
• Das GlideRecord-Update für die Vorlagenspalte in der Aufgabe schlägt fehl. Die Aufgabe ist als fehlgeschlagen markiert.

Tabelle : 2. Parameter

Name	Typ	Beschreibung
templateId	Zeichenfolge	SYS_ID der Deduplizierungsvorlage, die der Deduplizierungsaufgabe zugeordnet werden soll.
taskIds	Array	Liste der sys_IDs der Deduplizierungsaufgaben, die der angegebenen Vorlage zugeordnet werden sollen.

Tabelle : 3. Rückgaben

Typ	Beschreibung
Objekt	Ergebnisobjekt, das den Status aller Aufgaben enthält, deren Zuordnung zur angegebenen Vorlage versucht wurde. Datentyp: Objekt { "failed": [Array], "skipped": [Array], "success": [Array], "summary": "String" }
Fehlgeschlagen	Liste der Aufgaben, die der Vorlage nicht zugeordnet werden konnten. Datentyp: Array von Objekten "failed": [ { "message": "String", "messageType: "String", "taskId": "String" } ]
Fehlgeschlagen.Nachricht	Nachricht, die beschreibt, warum die Aufgabe nicht mit der Vorlage verknüpft wurde. Datentyp: Zeichenfolge
Fehlgeschlagen.messageType	Grund für den Fehler. Datentyp: Zeichenfolge
Fehlgeschlagen.taskId	SYS_ID einer Aufgabe, die der Vorlage nicht zugeordnet werden konnte. Datentyp: Zeichenfolge
übersprungen	Liste der Aufgaben, die nicht fehlgeschlagen sind, aber der Vorlage nicht zugeordnet wurden (übersprungen). Datentyp: Array von Objekten "skipped": [ { "message": "String", "messageType: "String", "taskId": "String" } ]
Übersprungen.Nachricht	Nachricht, die beschreibt, warum die Aufgabe übersprungen wurde. Datentyp: Zeichenfolge
Übersprungen.messageType	Grund für das Überspringen der Aufgabe. Datentyp: Zeichenfolge
Übersprungen.taskId	SYS_ID einer Aufgabe, die von der Methode übersprungen wurde, die der Vorlage zugeordnet ist. Datentyp: Zeichenfolge
Erfolg	Liste der Aufgaben, die der Vorlage erfolgreich zugeordnet wurden. Datentyp: Array von Objekten "success": [ { "message": "String", "messageType: "String", "taskId": "String" } ]
Erfolg.Nachricht	Derzeit nicht verwendet. Datentyp: Zeichenfolge
Erfolg.messageType	Derzeit nicht verwendet. Datentyp: Zeichenfolge
Erfolg.Aufgaben-ID	SYS_ID einer Aufgabe, die der Vorlage zugeordnet war. Datentyp: Zeichenfolge
Zusammenfassung	Kurze Beschreibung aller insgesamt aufgetretenen Verarbeitungsfehler, z. B. wenn die angegebene Vorlage nicht vorhanden ist. Datentyp: Zeichenfolge

Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird, um einer Deduplizierungsvorlage Deduplizierungsaufgaben hinzuzufügen.

// Add tasks to template
var taskIds = [];
taskIds.push("96d2d25113152200eef2dd828144b0a4");
taskIds.push("f785a2c3d7012201de92a5f75e610398");
taskIds.push("635dd3dbc128ce0100655f1ec66ed41d");

var result = new CMDBDuplicateTemplateUtils().addTasksToTemplate("6b43105c37301000deeabfc8bcbe5db2", taskIds);
); 
gs.info('Success: ' + result.success);
gs.info('Failed: ' + result.failed);
gs.info('Skipped: ' + result.skipped);
gs.info(Summary: ' + result.summary);

Ausgabe:

Success: [
    {
      "taskId": "f785a2c3d7012201de92a5f75e610398",
      "message": "",
      "messageType": ""
    }
  ]
Failed: [
    {
      "taskId": "96d2d25113152200eef2dd828144b0a4",
      "message": "Failed to add task 96d2d25113152200eef2dd828144b0a4 to template 6b43105c37301000deeabfc8bcbe5db2 because there were update errors.",
      "messageType": "update_failed"
    }
  ]
Skipped: [
    {
      "taskId": "635dd3dbc128ce0100655f1ec66ed41d",
      "message": "Cannot add de-duplication task(s) to template 6b43105c37301000deeabfc8bcbe5db2 because the template is not published. Publish the template before adding tasks.",
      "messageType": "unpublished_template"
    }
  ]
Summary:

CMDBDuplicateTemplateUtils – removeTemplateFromTask(Array taskIds)

Löscht den Wert der Deduplizierungsvorlage in den angegebenen Datensätzen der Deduplizierungsaufgabe. Durch das Löschen dieses Werts wird die Zuordnung zwischen einer Vorlage und der Aufgabe entfernt.

Die folgende Liste beschreibt Szenarien, in denen der Vorlagenwert nicht aus dem Aufgabendatensatz entfernt und als übersprungen oder fehlgeschlagen markiert ist:

• Die der Aufgabe zugeordnete Deduplizierungsvorlage wird ausgeführt. Die Aufgabe ist als übersprungen markiert.
• Der Aufgabenstatus lautet „in Arbeit“, oder die Aufgabe wurde nicht gefunden. Die Aufgabe ist als übersprungen markiert.
• Das GlideRecord-Update für die Vorlagenspalte in der Aufgabe schlägt fehl. Die Aufgabe ist als fehlgeschlagen markiert.

Tabelle : 4. Parameter

Name	Typ	Beschreibung
taskIds	Array	Liste der sys_IDs der Deduplizierungsaufgaben-Datensätze, aus denen der Deduplizierungsvorlagenwert gelöscht werden soll.

Tabelle : 5. Rückgaben

Typ	Beschreibung
Objekt	Ergebnisobjekt, das die Anzahl der Aufgaben enthält, für die die Entfernung des Vorlagenwerts erfolgreich, übersprungen oder fehlgeschlagen ist. { "failed": Number, "success": Number, "skipped": Number }
Fehlgeschlagen	Anzahl der Aufgaben, bei denen der Wert der Deduplizierungsvorlage nicht entfernt werden konnte. Datentyp: Zahl
Erfolg	Anzahl der Aufgaben, die den Wert der Deduplizierungsvorlage erfolgreich entfernt haben. Datentyp: Zahl
übersprungen	Anzahl der Aufgaben, bei denen die Methode das Entfernen des Werts der Deduplizierungsvorlage übersprungen hat. Datentyp: Zahl

Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird, um Deduplizierungsvorlagenwerte aus Datensätzen von Deduplizierungsaufgaben zu entfernen.

// Remove tasks from template
var taskIds = [];
taskIds.push("96d2d25113152200eef2dd828144b0a4");
taskIds.push("f785a2c3d7012201de92a5f75e610398");
taskIds.push("635dd3dbc128ce0100655f1ec66ed41d");

var result = new CMDBDuplicateTemplateUtils().removeTemplateFromTasks(taskIds);
); 
gs.info('Success: ' + result.success);
gs.info('Failed: ' + result.failed);
gs.info('Skipped: ' + result.skipped);

Ausgabe:

Success: 2
Failed: 0
Skipped: 1