---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CMDBDuplicateTemplateUtil -- Global

# CMDBDuplicateTemplateUtil -- Global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 Minuten Lesedauer

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](https://www.servicenow.com/docs/access?context=de-duplication-tasks&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US).

## CMDBDuplicateTemplateUtils -- CMDBDuplicateTemplateUtils() {#ariaid-title2}

Erstellt eine Instanz von CMDBDuplicateTemplateUtils Klasse.
{#CDupTempU-CMDBDupTemplateUtils__table_bhp_st5_xxb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

{#CDupTempU-CMDBDupTemplateUtils__table_bhp_st5_xxb}  
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) {#ariaid-title3}

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 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.
{#CDupTempU-addTasksToTemplate_S_A__ul_b45_fmh_yxb}
{#CDupTempU-addTasksToTemplate_S_A__table_tch_4y5_xxb__entry__3}

| 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 : 2. Parameter]

{#CDupTempU-addTasksToTemplate_S_A__table_tch_4y5_xxb} {#CDupTempU-addTasksToTemplate_S_A__table_uch_4y5_xxb__entry__2}

| 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 der Vorlage nicht zugeordnet werden konnte. Datentyp: Zeichenfolge |
| Failed.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.message | Nachricht, die beschreibt, warum die Aufgabe übersprungen wurde. Datentyp: Zeichenfolge |
| Übersprungen.messageType | Grund für die übersprungene Aufgabe. Datentyp: Zeichenfolge |
| Übersprungen.taskId | SYS_ID einer Aufgabe, die die Methode übersprungen hat, 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.taskId | 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 |
[Tabelle : 3. Rückgaben]

{#CDupTempU-addTasksToTemplate_S_A__table_uch_4y5_xxb}  
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) {#ariaid-title4}

Löscht den Wert der Deduplizierungsvorlage in den angegebenen Datensätzen der Deduplizierungsaufgabe. 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 und als übersprungen oder fehlgeschlagen markiert ist:

* Die der Aufgabe zugeordnete Deduplizierungsvorlage wird ausgeführt. Die Aufgabe ist als übersprungen markiert.
* Der Aufgabenstatus ist „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.
{#CDupTempU-removeTemplateFromTasks_A__table_pn5_g3v_xxb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| taskIds | Array | Liste der sys_IDs der Deduplizierungsaufgabendatensätze, aus denen der Deduplizierungsvorlagenwert gelöscht werden soll. |
[Tabelle : 4. Parameter]

{#CDupTempU-removeTemplateFromTasks_A__table_pn5_g3v_xxb} {#CDupTempU-removeTemplateFromTasks_A__table_qn5_g3v_xxb__entry__2}

| 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, für die die Methode das Entfernen des Werts der Deduplizierungsvorlage übersprungen hat. Datentyp: Zahl |
[Tabelle : 5. Rückgaben]

{#CDupTempU-removeTemplateFromTasks_A__table_qn5_g3v_xxb}  
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


