CMDBDuplicateTemplateUtil : Global

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

Weitere Informationen zur Deduplizierung von CIs, zu Deduplizierungsaufgaben und zu 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 alle vorhandenen Vorlagenwerte, protokolliert jedoch die vorherigen Werte für jede Vorlage in den Systemprotokollen.

Die folgende Liste beschreibt Szenarien, in denen eine Aufgabe nicht zu einer 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 wird als übersprungen markiert.
• Die Aufgabe ist mit der angegebenen Vorlage nicht 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 wurden als fehlgeschlagen markiert.
• Die GlideRecord-Aktualisierung für die Vorlagenspalte in der Aufgabe schlägt fehl. Die Aufgabe wurde 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, die der angegebenen Vorlage zugeordnet werden sollten. 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.Meldung	Meldung, die beschreibt, warum die Aufgabe der Vorlage nicht zugeordnet werden konnte. 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 der Vorlage zugeordneten Methode übersprungen wurde. Datentyp: Zeichenfolge
Erfolg	Liste der Aufgaben, die der Vorlage erfolgreich zugeordnet wurden. Datentyp: Array von Objekten "success": [ { "message": "String", "messageType: "String", "taskId": "String" } ]
erfolgreich.message	Wird derzeit nicht verwendet. Datentyp: Zeichenfolge
erfolg.messageType	Wird derzeit nicht verwendet. Datentyp: Zeichenfolge
erfolg.aufgabenId	Sys_id einer Aufgabe, die der Vorlage zugeordnet war. 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 – entfernenTemplateFromTask(Array taskIds)

Löscht den Wert der Deduplizierungsvorlage in den angegebenen Datensätzen für Deduplizierungsaufgaben. Durch 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 wird 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 wurde als fehlgeschlagen markiert.

Tabelle : 4. Parameter

Name	Typ	Beschreibung
taskIds	Array	Liste der sys_ids der Datensätze für Deduplizierungsaufgaben, aus denen der Wert der Deduplizierungsvorlage gelöscht werden soll.

Tabelle : 5. Rückgaben

Typ	Beschreibung
Objekt	Ergebnisobjekt, das die Anzahl der Aufgaben enthält, für die das Entfernen 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 von der Methode beim Entfernen des Werts der Deduplizierungsvorlage übersprungen wurden. 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