CMDBDuplicateTemplateUtil – Global

Die Skripteinbindung CMDBDuplicateTemplateUtil stellt Methoden zum Hinzufügen und Entfernen von Deduplizierungsaufgaben zu/aus einer Deduplizierungsvorlage bereit.

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

CMDBDuplicateTemplateUtils – CMDBDuplicateTemplateUtils()

Erstellt eine Instanz der 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(String templateId, Array taskIds)

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

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

In der folgenden Liste werden Szenarien beschrieben, in denen eine Aufgabe keiner Vorlage hinzugefügt und dann als übersprungen oder fehlgeschlagen markiert wird:

• Die angegebene Vorlage befindet sich nicht im Status „Veröffentlicht“. Alle Aufgaben werden als übersprungen markiert.
• Die angegebene Vorlage wird ausgeführt. Alle Aufgaben werden als übersprungen markiert.
• Die Aufgabe befindet sich nicht im Status „Offen“. Die Aufgabe wird als übersprungen markiert.
• Die Aufgabe ist nicht mit der angegebenen Vorlage kompatibel. Beispielsweise kann die angegebene Vorlage für Anwendungsserver Tomcat erstellt werden, die angegebene Deduplizierungsaufgabe wird jedoch für Linux-Server erstellt. Die Aufgabe wird als übersprungen markiert.
• Die angegebene Vorlage ist nicht vorhanden. Alle Aufgaben werden als fehlgeschlagen markiert.
• Die GlideRecord-Aktualisierung für die Vorlagenspalte in der Aufgabe schlägt fehl. Die Aufgabe wird 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. Ergebnisse

Typ	Beschreibung
Objekt	Ergebnisobjekt, das den Status aller Aufgaben enthält, von denen versucht wurde, sie der angegebenen Vorlage zuzuordnen. 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": [ { "taskId": "String", "message": "String", "messageType: "String" } ]
fehlgeschlagen.taskId	Sys_id einer Aufgabe, die der Vorlage nicht zugeordnet werden konnte. Datentyp: Zeichenfolge
fehlgeschlagen.Nachricht	Nachricht, die beschreibt, warum die Aufgabe nicht mit der Vorlage verknüpft werden konnte. Datentyp: Zeichenfolge
fehlgeschlagen.messageType	Grund für den Fehler. Datentyp: Zeichenfolge
übersprungen	Liste der Aufgaben, die nicht fehlgeschlagen sind, aber nicht mit der Vorlage verknüpft waren (übersprungen). Datentyp: Array von Objekten "skipped": [ { "taskId": "String", "message": "String", "messageType: "String" } ]
übersprungen.taskId	Sys_id einer Aufgabe, die die Methode übersprungen hat, die der Vorlage zugeordnet ist. Datentyp: Zeichenfolge
übersprungen.Nachricht	Nachricht, die beschreibt, warum die Aufgabe übersprungen wurde. Datentyp: Zeichenfolge
übersprungen.messageType	Grund dafür, dass die Aufgabe übersprungen wird. Datentyp: Zeichenfolge
Erfolg	Liste der Aufgaben, die der Vorlage erfolgreich zugeordnet wurden. Datentyp: Array von Objekten "success": [ { "taskId": "String", "message": "String", "messageType: "String" } ]
success.taskId	Sys_id einer Aufgabe, die der Vorlage zugeordnet wurde. Datentyp: Zeichenfolge
success.message	Derzeit nicht verwendet. Datentyp: Zeichenfolge
success.messageType	Derzeit nicht verwendet. Datentyp: Zeichenfolge
Zusammenfassung	Kurze Beschreibung aller allgemeinen Verarbeitungsfehler, die aufgetreten sind, 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 Deduplizierungsvorlagenwert in den angegebenen Deduplizierungsaufgabendatensätzen. Durch Löschen dieses Werts wird die Zuordnung zwischen einer Vorlage und der Aufgabe entfernt.

In der folgenden Liste werden Szenarien beschrieben, in denen der Vorlagenwert nicht aus dem Aufgabendatensatz entfernt und entweder als übersprungen oder als fehlgeschlagen markiert wird:

• Die der Aufgabe zugeordnete Deduplizierungsvorlage wird ausgeführt. Die Aufgabe wird als übersprungen markiert.
• Der Aufgabenstatus ist „In Arbeit“, oder die Aufgabe wurde nicht gefunden. Die Aufgabe wird als übersprungen markiert.
• Die GlideRecord-Aktualisierung für die Vorlagenspalte in der Aufgabe schlägt fehl. Die Aufgabe wird 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. Ergebnisse

Typ	Beschreibung
Objekt	Ergebnisobjekt, das die Anzahl der Aufgaben enthält, für die die Entfernung des Vorlagenwerts erfolgreich war, übersprungen wurde 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, die die Methode beim Entfernen des Deduplizierungsvorlagenwerts übersprungen hat. Datentyp: Zahl

Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird, um Deduplizierungsvorlagenwerte aus Deduplizierungsaufgabendatensätzen 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