---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# DuplicateTemplate : Bereichsbezogen

# DuplicateTemplate : Bereichsbezogen {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 23 Minuten Lesedauer

Die DuplicateTemplate -API bietet Methoden für Anwender zur Interaktion mit Deduplizierungsvorlagen, indem für jede Methode eine Reihe von Validierungen erzwungen wird.

Die Nachbesserung von Deduplizierungsaufgaben kann zeitaufwändiger sein als wünschenswert, wenn sie einzeln behandelt werden. Duplizierungsvorlagen ermöglichen das Gruppieren eines Satzes von doppelten Aufgaben und deren gemeinsame Ausführung. Verwenden Sie die DuplicateTemplate -API, um Deduplizierungsvorlagen zu erstellen und zu nutzen. Diese API wird im Namespace `sn_cmdb ausgeführt` und erfordert für den Zugriff die Rolle cmdb_dedup_admin.

Wenn eine Instanz während der Identifizierung und des Abgleichs doppelte Configuration Items (CIs) erkennt, gruppiert sie jeden Satz doppelter CIs in einer Deduplizierungsaufgabe zur Überprüfung und Korrektur. Deduplizierungsaufgaben enthalten Details zur Duplizierung, einschließlich einer Liste aller doppelten CIs. Informationen hierzu finden Sie unter [Duplicate CIs remediation](https://www.servicenow.com/docs/access?context=de-duplication-tasks&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US).

Siehe auch: [Identifizierungs -Engine: Bereichsbezogen](https://www.servicenow.com/docs/Cd~vFurqBFyrmDL~fBT8PQ#IdentificationEngineScopedAPI "Die IdentificationEngine -API verwendet das Identification and Reconciliation Framework (Identifizierung und Abgleich), um die Erstellung von doppelten Configuration Items (CIs) zu minimieren und CI-Attribute abzugleichen, indem beim Aktualisieren von Configuration Management Database (CMDB)nur Informationen aus autorisierten Datenquellen akzeptiert werden.")

Vorlagenlebenszyklus
:
    1. Verwenden Sie die [CreateTemplate()-](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-createTemplate_O "Erstellt eine Deduplizierungsvorlage im Entwurfsstatus.") Methode, um eine Vorlage im Entwurfsstatus zu erstellen.  
       Sie können die folgenden Methoden verwenden, um die Vorlage abzurufen oder zu aktualisieren:
       * [abrufenVorlage ()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-getTemplate_S "Ruft das Vorlagenobjekt ab.")
       * [kannZurVorlageAufgabenhinzufügen ()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-canAddTasksToTemplate_A_S "Überprüft, ob die bereitgestellte Aufgabenliste einer Vorlage hinzugefügt werden kann.")
       * [updateTemplate ()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-updateTemplate_S_O "Aktualisiert eine Deduplizierungsvorlage im Entwurfsstatus.")
       {#DuplicateTemplateScopedAPI__ul_gd1_by1_cyb}
    2. Verwenden Sie die [PublisherTemplate()-](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-publishTemplate_S "Veröffentlicht eine Vorlage. Bei Erfolg wird die Vorlage vom Status „Entwurf“ in den Status „Veröffentlicht“ verschoben.") Methode, um die Vorlage vom Status „Entwurf" in den Status „Veröffentlicht" zu versetzen.  
       Hinweis:  
       Verwenden Sie die Methode [unPublishTemplate()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-unPublishTemplate_S "Hebt die Veröffentlichung einer Vorlage auf."), um eine veröffentlichte Vorlage in den Entwurfsstatus zurückzusetzen und die Vorlage zu aktualisieren.
    3. Optional. Verwenden Sie die [CMDBDuplicateTemplateUtil-Skripteinbindung](https://www.servicenow.com/docs/_uZM6jaCbgpVCstSMitcZA#CMDBDuplicateTemplateUtilAPI "Die CMDBDuplicateTemplateUtil -Skripteinbindung bietet Methoden zum Hinzufügen und Entfernen von Deduplizierungsaufgaben zu/von einer Deduplizierungsvorlage."), um Aufgaben hinzuzufügen oder zu entfernen.
    4. Verwenden Sie die Methode [runTemplate()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-runTemplate_S "Plant eine Korrekturausführung für eine Deduplizierungsvorlage im Status „Veröffentlicht“. Eine Vorlage kann mehrmals ausgeführt werden, Sie können jedoch jeweils nur eine Ausführung planen."), um die Vorlage auszuführen.

       Um eine laufende Aufgabe abzubrechen, verwenden Sie die Methode [requestCancelation()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-requestCancellation_S "Bricht eine vorhandene Vorlagenausführung ab.").
    5. Wenn die Vorlage nicht mehr benötigt wird, können Sie sie mit der Methode [retireTemplate() stilllegen](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-retireTemplate_S "Legt eine Vorlage still.").
    {#DuplicateTemplateScopedAPI__ol_kmg_qx1_cyb}

Eine einzelne Aufgabe mithilfe einer Vorlage nachbessern
:   Um eine einzelne Aufgabe zu korrigieren, ohne die Vorlage auszuführen, können Sie eine Vorschau der Deduplizierungsaufgaben anzeigen und sie korrigieren.

    1. Verwenden Sie die Methode „ [previewTemplate()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-previewTemplate_S_S "Generiert eine Vorschau, wie verschiedene Vorlagenoptionen auf die Deduplizierungsaufgabe angewendet wurden und wie sie korrigiert werden soll.") ", um eine Vorschau der Korrektur einer Einzelaufgabe mit einer Vorlage anzuzeigen.
    2. Verwenden Sie die Methode [remediateTask()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-remediateTask_S_S "Behebt eine Deduplizierungsaufgabe mithilfe der Vorlage."), um die Deduplizierungsaufgabe mit einer Vorlage zu korrigieren.
    {#DuplicateTemplateScopedAPI__ol_es1_3nr_dyb}

## DuplicateTemplate -- canAddTasksToTemplate(Array taskIds, String templatId) {#ariaid-title2}

Überprüft, ob die bereitgestellte Aufgabenliste einer Vorlage hinzugefügt werden kann.
Verwenden Sie diese Methode, um zu bestimmen, ob Aufgaben zum Hinzufügen zur Vorlage geeignet sind. Beispielsweise kann die angegebene Vorlage für Anwendungsserver Tomcat erstellt werden, die angegebenen Deduplizierungsaufgaben werden jedoch für Linux Server erstellt. Diese Aufgaben haben keine übereinstimmende Vorlagenklasse und können der Vorlage nicht hinzugefügt werden.
{#DupTemp-canAddTasksToTemplate_A_S__table_rl4_t5c_txb__entry__3}{#DupTemp-canAddTasksToTemplate_A_S__ph_DupTemp-templateID}

| Name | Typ | Beschreibung |
|-|-|-|
| taskIds | Array | Array von sys_ids der Deduplizierungsaufgaben, die der Vorlage hinzugefügt werden sollen. |
| templateId | Zeichenfolge | Sys_id der Vorlage, die in der Tabelle „Duplikatvorlage abgleichen" \[reconcile_duplicate_template\] aufgeführt ist. |
[Tabelle : 1. Parameter]

{#DupTemp-canAddTasksToTemplate_A_S__table_rl4_t5c_txb} {#DupTemp-canAddTasksToTemplate_A_S__table_sl4_t5c_txb__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Ergebnisobjekt, das enthält, welche Aufgaben hinzugefügt, übersprungen oder fehlgeschlagen werden können. { "success": [ "<task_id_1>", "<task_id_2>", "<task_id_3>" ], "failed": [ "<task_id_4>" ], "skipped": [ "<task_id_5>" ] } |
| Fehlgeschlagen | Beim Überprüfen, ob die Aufgabe mit der Vorlage kompatibel ist, ist ein Fehler aufgetreten. Siehe auch [Detecting duplicate CIs](https://www.servicenow.com/docs/access?context=id-detect-dup-ci&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US). |
| übersprungen | Die Aufgaben sind nicht kompatibel, da sie keine übereinstimmende Vorlagenklasse haben. Daher wurde die Aufgabe übersprungen. |
| Erfolg | Die Aufgabe entspricht der Vorlagenklasse und kann der Vorlage hinzugefügt werden. |
[Tabelle : 2. Ergebnisse]

{#DupTemp-canAddTasksToTemplate_A_S__table_sl4_t5c_txb}  
Das folgende Beispiel zeigt, wie Sie nach Aufgaben suchen, die der Vorlage hinzugefügt werden können.

    var taskIds = [];
    taskIds.push(<task_id_1>);
    taskIds.push(<task_id_2>);
    taskIds.push(<task_id_3>);

    var result = sn_cmdb.DuplicateTemplate.canAddTasksToTemplate(taskIds, <template_id>);

    gs.info('Success:' + result.success);
    gs.info('Failed:' + result.failed);
    gs.info('Skipped:' + result.skipped);

Ausgabe:

    Success: <task_id_1>
    Failed: <task_id_2>
    Skipped: <task_id_3>

## DuplicateTemplate -- createTemplate(Objektvorlage) {#ariaid-title3}

Erstellt eine Deduplizierungsvorlage im Entwurfsstatus.
{#DupTemp-createTemplate_O__table_rl4_t5c_txb__entry__3}{#DupTemp-createTemplate_O__ph_DupTemp-templateObj}{#DupTemp-createTemplate_O__ph_DupTemp-template-allow-null-attr}{#DupTemp-createTemplate_O__ph_DupTemp-template-master-ci-nul}{#DupTemp-createTemplate_O__ph_DupTemp-template-desc}{#DupTemp-createTemplate_O__ph_DupTemp-template-dup-ci-action}{#DupTemp-createTemplate_O__ph_DupTemp-template-dup-ci-updts}{#DupTemp-createTemplate_O__ph_DupTemp-template-dup-ci-upd-lmt}{#DupTemp-createTemplate_O__ph_DupTemp-template-dup-ci-upd-lbl}{#DupTemp-createTemplate_O__ph_DupTemp-template-dup-ci-upd-val}{#DupTemp-createTemplate_O__ph_DupTemp-template-dup-ci-upd-dsp}{#DupTemp-createTemplate_O__ph_DupTemp-template-master-ci-opt}{#DupTemp-createTemplate_O__link_encoded_query_strings}{#DupTemp-createTemplate_O__ph_DupTemp-template-mrg-relations}{#DupTemp-createTemplate_O__d2830e465}{#DupTemp-createTemplate_O__d2804e106}{#DupTemp-createTemplate_O__ph_DupTemp-template-mrgRel-itms}{#DupTemp-createTemplate_O__d2804e106}{#DupTemp-createTemplate_O__ph_DupTemp-template-most-relationsMA}{#DupTemp-createTemplate_O__ph_DupTemp-template-mostRel-itmMA}{#DupTemp-createTemplate_O__ph_DupTemp-template-name}{#DupTemp-createTemplate_O__ph_DupTemp-template-newst-updtdMA}{#DupTemp-createTemplate_O__ph_DupTemp-template-oldst-crtdMA}{#DupTemp-createTemplate_O__ph_DupTemp-template-table}{#DupTemp-createTemplate_O__d2804e106}

| Name | Typ | Beschreibung |
|-|-|-|
| Vorlage | Objekt | Das Vorlagenobjekt mit verschiedenen Optionen zum Erstellen der Vorlage. { "allow_master_ci_null_update": Boolean, "allow_null_attribute_update": Boolean, "description": "String", "duplicate_ci_action": "String", "duplicate_ci_updates": [Array], "master_ci_condition": "String", "master_ci_option": "String", "merge_related_items": "String", "merge_related_items_condition": [Array], "merge_relations_condition": "String", "merge_relations": "String", "most_related_items_merge_attributes": "String", "most_relations_merge_attributes": "String", "name": "String", "newest_updated_merge_attributes": "String", "oldest_created_merge_attributes": "String", "table": "String", "task_conditions": "String" } {#DupTemp-createTemplate_O__cb_DupTemp-templateObj} |
| template.allow_null_​attribute_update | Boolean | Optional. Kennzeichnung, die angibt, ob die Haupt-CI-Attribute mit Null-Werten aus doppelten CIs aktualisiert werden, wenn Attributkonflikte für CIs innerhalb einer Deduplizierungsaufgabe gelöst werden. Gültige Werte: * „wahr": Die Haupt-CI-Attribute werden mit Nullwerten aus doppelten CIs aktualisiert. * „falsch": Die Haupt-CI-Attribute werden nicht mit NULL-Werten aus doppelten CIs aktualisiert. {#DupTemp-createTemplate_O__ul_h4x_nhb_cyb} Standardwert: False |
| template.allow_master_ci_​null_update | Boolean | Optional. Schließt nur Updates von doppelten CIs ein, wenn der Haupt-CI-Wert NULL ist. Kennzeichnung, die angibt, ob nur Updates von doppelten CIs einbezogen werden sollen, wenn der Haupt-CI-Wert NULL ist. Gültige Werte: * „wahr": Es werden nur Updates von doppelten CIs einbezogen, wenn der Haupt-CI-Wert NULL ist. * „falsch": Updates aus allen doppelten CIs einbeziehen. {#DupTemp-createTemplate_O__ul_hmn_phb_cyb} Standardwert: False |
| template.description | Zeichenfolge | Optional. Beschreibung zum Speichern weiterer Informationen zur Vorlage. |
| template.duplicate_​ci_action | Zeichenfolge | Optional. Gibt an, ob das doppelte CI gelöscht oder mit eindeutigen anwenderdefinierten Werten aktualisiert werden soll. Mögliche Optionen: * delete * update (erfordert die Angabe von duplicate_ci_updates) {#DupTemp-createTemplate_O__ul_cby_1ng_5xb} |
| template.duplicate_​ci_updates | Array | Optional, es sei denn, die Einstellung für duplicate_ci_action lautet <kbd class="ph userinput">update</kbd>. Array von Objekten, die angeben, wie die doppelten CI-Werte aktualisiert werden. [ { "element": "String", "element_label": "String", "value": "String", "display": "String" } ] {#DupTemp-createTemplate_O__codeb_DupTemp-template-dup-ci-upd} |
| template.duplicate_​ci_updates.element | Zeichenfolge | Der Systemwörterbuchname eines Referenzfelds. |
| template.duplicate_​ci_updates.element_label | Zeichenfolge | Die Bezeichnung, die das Referenzfeld anzeigt. |
| template.duplicate_​ci_updates.value | Zeichenfolge | Wert für ein Referenzfeld, also der Inhalt des Referenzfelds. |
| template.duplicate_​ci_updates.display | Zeichenfolge | Anzeigewert für ein Referenzfeld. |
| template.master_ci_​option | Zeichenfolge | Optional. Gibt an, wie das Haupt-CI bei Anwendung dieser Vorlage für eine Deduplizierungsaufgabe ausgewählt wird. Mögliche Optionen: * bedingt ( master_ci_conditionmuss angegeben werden) * major_related_items: Attribute, die aus dem CI mit den meisten zugehörigen Elementen mit dem Haupt-CI zusammengeführt werden sollen. * major_relations: Attribute, die aus dem CI mit den meisten Beziehungen zum Haupt-CI zusammengeführt werden sollen. * neueste_created: Getrennte Attribute, die vom zuletzt aktualisierten CI mit dem Haupt-CI zusammengeführt werden sollen. * älteste_kreiert: Durch Kommas getrennte Attribute, die vom ältesten erstellten CI mit dem Haupt-CI zusammengeführt werden sollen. {#DupTemp-createTemplate_O__ul_hlj_wlg_5xb} |
| Bedingung „template.master_ci_" | Zeichenfolge | Optional (erforderlich, wenn der Wert von master_ci_option<kbd class="ph userinput">bedingt</kbd>ist). Codierte Abfrage, um anzugeben, wie das Haupt-CI ausgewählt wird. Wenn mehrere CIs oder keine CIs mit der Abfrage übereinstimmen, wählt die -Methode das zuletzt aktualisierte CI als Haupt-CI aus. Die codierte Abfrage wird für die Vorlagentabelle ausgewertet. Diese Tabelle wird in der Eigenschaft table identifiziert. Einzelheiten finden Sie unter [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) . |
| template.merge_relations | Zeichenfolge | Optional. Gibt an, wie die Beziehungen für doppelte CIs innerhalb einer Deduplizierungsaufgabe bei Anwendung dieser Vorlage zusammengeführt werden. Mögliche Optionen: * alle * bedingt * Keine {#DupTemp-createTemplate_O__ul_shw_nmg_5xb} |
| template.merge_relations | Zeichenfolge | Optional. Gibt an, wie die Beziehungen für doppelte CIs innerhalb einer Deduplizierungsaufgabe bei Anwendung dieser Vorlage zusammengeführt werden. Mögliche Optionen: * alle * bedingt * Keine {#DupTemp-createTemplate_O__d2830e470} |
| template.merge_relations_​condition | Zeichenfolge | Optional (erforderlich, wenn der Wert von merge_relations<kbd class="ph userinput">bedingt</kbd>ist). Codierte Abfrage, um anzugeben, ob alle oder keine der Beziehungen aus doppelten CIs zusammengeführt werden. Die Abfrage wird für das Haupt-CI ausgewertet, das für die Deduplizierungsaufgabe ausgewählt ist. Wenn die Abfrage „true" zurückgibt, werden alle Beziehungen zusammengeführt. Bei „false" werden keine Beziehungen zusammengeführt. Die codierte Abfrage wird für die Vorlagentabelle ausgewertet. Diese Tabelle wird in der Eigenschaft table identifiziert. Einzelheiten finden Sie unter [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) . |
| template.merge_related_items | Zeichenfolge | Optional. Gibt an, welche zugehörigen Tabellen für doppelte CIs innerhalb einer Deduplizierungsaufgabe bei Anwendung dieser Vorlage mit dem Haupt-CI zusammengeführt werden. Siehe auch [Remediate a de-duplication task (legacy)](https://www.servicenow.com/docs/access?context=reconcile-dup-task&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US). Mögliche Optionen: * all_available: Enthält die standardmäßigen zugehörigen Tabellen und alle zugehörigen Tabellen, die auf doppelte CIs für die über die Vorlage korrigierte Deduplizierungsaufgabe verweisen. * bedingt * Standard -- Enthält zugehörige Einträge, die vom Modul „CI-Duplikatsnachbesserung -- Zugehörige Standardelemente" bereitgestellt werden. * Keine {#DupTemp-createTemplate_O__ul_thg_vmg_5xb} |
| template.merge_related_items_​condition | Array | Optional. Liste der zugehörigen Einträge mit einer codierten Abfrage für jeden zugehörigen Eintrag. Jede Abfrage wird für das Haupt-CI ausgewertet, das für die Aufgabe ausgewählt ist. Wenn die Abfrage „true" zurückgibt, werden die zugehörigen Einträge während der Korrektur einer Deduplizierungsaufgabe zusammengeführt. Bei „false" werden zugehörige Einträge nicht zusammengeführt. "merge_related_items_condition": [ { "related_entry": "String", "condition": "String" } ] {#DupTemp-createTemplate_O__cb_DupTem-template-mrgRel-itmCnd} Einzelheiten finden Sie unter [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) . |
| template.host_relations_​merge_attributes | Zeichenfolge | Optional. Kommagetrennte Attribute, die aus dem CI mit den meisten Beziehungen zum Haupt-CI zusammengeführt werden sollen. |
| template.host_related_items_​merge_attributes | Zeichenfolge | Optional. Kommagetrennte Attribute, die aus dem CI mit den meisten zugehörigen Elementen mit dem Haupt-CI zusammengeführt werden sollen. |
| template.name | Zeichenfolge | Name der Vorlage. |
| template.neest_updated_​merge_attributes | Zeichenfolge | Optional. Kommagetrennte Attribute, die vom zuletzt aktualisierten CI mit dem Haupt-CI zusammengeführt werden sollen. |
| template.oldest_created_​merge_attributes | Zeichenfolge | Optional. Kommagetrennte Attribute, die vom ältesten erstellten CI mit dem Haupt-CI zusammengeführt werden sollen. |
| template.table | Zeichenfolge | Tabelle, für die die Vorlage erstellt wird. |
| template.task_conditions | Zeichenfolge | Optional. Codierte Abfrage, die ausgewertet werden soll, wenn die Vorlage ausgeführt wird. Diese Abfrage wird in der Tabelle „Daten doppelter Aufgaben abgleichen" \[reconcile_duplicate_task_data\] ausgewertet. Alle von dieser Abfrage zurückgegebenen Aufgaben werden während der Vorlagenauswertung berücksichtigt. Hinweis: Selbst wenn eine Aufgabe als Teil der Abfrage zurückgegeben wird, garantiert dies nicht, dass die Vorlagenausführung die Aufgabe verarbeitet. Andere Faktoren können dazu führen, dass die Aufgabe während der Vorlagenverarbeitung übersprungen wird. Einzelheiten finden Sie unter [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) . |
[Tabelle : 3. Parameter]

{#DupTemp-createTemplate_O__table_rl4_t5c_txb} {#DupTemp-createTemplate_O__table_sl4_t5c_txb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Sys_id der Vorlage, die in der Tabelle „Doppelte Vorlagen abgleichen" \[reconcile_duplicate_template\] erstellt wurde. |
[Tabelle : 4. Ausgabe]

{#DupTemp-createTemplate_O__table_sl4_t5c_txb}  
Das folgende Beispiel zeigt, wie eine Deduplizierungsvorlage erstellt wird.

    var template = {
      "name": "Test Windows Template",
      "table": "cmdb_ci_win_server",
      "description": "This is a Windows server template",
      "master_ci_option": "oldest_created",
      "master_ci_condition": "",
      "allow_null_attribute_update": false,
      "allow_master_ci_null_update": false,
      "oldest_created_merge_attributes": "serial_number,os_version",
      "merge_relations": "all",
      "merge_relations_condition": "",
      "merge_related_items": "conditional",
      "merge_related_items_condition": [
        {
          "related_entry": "change_request.cmdb_ci",
          "condition": "ramCONTAINS1024"
        },
        {
          "related_entry": "incident.cmdb_ci",
          "condition": "os_versionCONTAINSWindows"
        }
      ],
      "duplicate_ci_action": "delete",
      "duplicate_ci_updates":   [{
        "element": "ram",
        "element_label": "RAM (MB)",
        "value": "1024",
        "display": "1024"
      }],
      "task_conditions": "category=attribute^key=serial_number^value=E2BX1^EQ"
    };

    var templateId = sn_cmdb.DuplicateTemplate.createTemplate(template);

    gs.info(templateId);

Ausgabe:

    8dfcd36e042b2510f877c1665753a485

## DuplicateTemplate -- getTemplate(String templateId) {#ariaid-title4}

Ruft das Vorlagenobjekt ab.
{#DupTemp-getTemplate_S__table_rl4_t5c_txb__entry__3}{#DupTemp-getTemplate_S__ph_DupTemp-templateID}

| Name | Typ | Beschreibung |
|-|-|-|
| templateId | Zeichenfolge | Sys_id der Vorlage, die in der Tabelle „Duplikatvorlage abgleichen" \[reconcile_duplicate_template\] aufgeführt ist. |
[Tabelle : 5. Parameter]

{#DupTemp-getTemplate_S__table_rl4_t5c_txb} {#DupTemp-getTemplate_S__table_sl4_t5c_txb__entry__2}{#DupTemp-getTemplate_S__row_DupTemp-templateObj}{#DupTemp-getTemplate_S__row_DupTemp-template-allow-null-attr}{#DupTemp-getTemplate_S__row_DupTemp-template-master-ci-nul}{#DupTemp-getTemplate_S__row_DupTemp-template-desc}{#DupTemp-getTemplate_S__row_DupTemp-template-dup-ci-action}{#DupTemp-getTemplate_S__row_DupTemp-template-dup-ci-updts}{#DupTemp-getTemplate_S__row_DupTemp-template-master-ci-opt}{#DupTemp-getTemplate_S__row_DupTemp-template-mrg-relations}{#DupTemp-getTemplate_S__row_DupTemp-template-mrgRel-itms}{#DupTemp-getTemplate_S__row_DupTemp-template-mrgRel-itmCnd}{#DupTemp-getTemplate_S__row_DupTemp-template-most-relationsMA}{#DupTemp-getTemplate_S__row_DupTemp-template-mostRel-itmMA}{#DupTemp-getTemplate_S__row_DupTemp-template-name}{#DupTemp-getTemplate_S__row_DupTemp-template-newst-updtdMA}{#DupTemp-getTemplate_S__row_DupTemp-template-oldst-crtdMA}{#DupTemp-getTemplate_S__row_DupTemp-template-table}{#DupTemp-getTemplate_S__row_DupTemp-template-task-cond}

| Typ | Beschreibung |
|-|-|
| Objekt | Das Vorlagenobjekt mit verschiedenen Optionen zum Erstellen der Vorlage. { "allow_master_ci_null_update": Boolean, "allow_null_attribute_update": Boolean, "description": "String", "duplicate_ci_action": "String", "duplicate_ci_updates": [Array], "master_ci_condition": "String", "master_ci_option": "String", "merge_related_items": "String", "merge_related_items_condition": [Array], "merge_relations_condition": "String", "merge_relations": "String", "most_related_items_merge_attributes": "String", "most_relations_merge_attributes": "String", "name": "String", "newest_updated_merge_attributes": "String", "oldest_created_merge_attributes": "String", "table": "String", "task_conditions": "String" } |
| \<Object\>.allow_null_ attribute_update | Kennzeichnung, die angibt, ob die Haupt-CI-Attribute mit Null-Werten aus doppelten CIs aktualisiert werden, wenn Attributkonflikte für CIs innerhalb einer Deduplizierungsaufgabe gelöst werden. Gültige Werte: * „wahr": Die Haupt-CI-Attribute werden mit Nullwerten aus doppelten CIs aktualisiert. * „falsch": Die Haupt-CI-Attribute werden nicht mit NULL-Werten aus doppelten CIs aktualisiert. {#DupTemp-getTemplate_S__ul_h4x_nhb_cyb} Datentyp: Boolesch |
| \<Object\>.allow_master_ci_ null_update | Schließt nur Updates von doppelten CIs ein, wenn der Haupt-CI-Wert NULL ist. Gültige Werte: * „wahr": Es werden nur Updates von doppelten CIs einbezogen, wenn der Haupt-CI-Wert NULL ist. * „falsch": Updates aus allen doppelten CIs einbeziehen. {#DupTemp-getTemplate_S__ul_hmn_phb_cyb} Datentyp: Boolesch |
| \<Object\>.description | Beschreibung zum Speichern weiterer Informationen zur Vorlage. Datentyp: Zeichenfolge |
| \<Object\>.duplicate_ci_action | Gibt an, ob das doppelte CI gelöscht oder mit eindeutigen anwenderdefinierten Werten aktualisiert werden soll. Mögliche Optionen: * delete * update (erfordert die Angabe von duplicate_ci_updates) {#DupTemp-getTemplate_S__ul_cby_1ng_5xb} Datentyp: Zeichenfolge |
| \<Object\>.duplicate_ci_updates | Array von Objekten, die angeben, wie die doppelten CI-Werte aktualisiert werden. [ { "element": "String", "element_label": "String", "value": "String", "display": "String" } ] Datentyp: Objekt |
| \<Object\>.duplicateCIUpdates.element | Der Systemwörterbuchname eines Referenzfelds. Datentyp: Zeichenfolge |
| \<Object\>.duplicateCIUpdates.element_label | Die Bezeichnung, die das Referenzfeld anzeigt. Datentyp: Zeichenfolge |
| \<Object\>.duplicateCIUpdates.value | Wert für ein Referenzfeld, also der Inhalt des Referenzfelds. Datentyp: Zeichenfolge |
| \<Object\>.duplicateCIUpdates.anzeigen | Anzeigewert für ein Referenzfeld. Datentyp: Zeichenfolge |
| \<Object\>Option .master_ci_ | Gibt an, wie das Haupt-CI bei Anwendung dieser Vorlage für eine Deduplizierungsaufgabe ausgewählt wird. Mögliche Optionen: * bedingt ( master_ci_conditionmuss angegeben werden) * major_related_items: Attribute, die aus dem CI mit den meisten zugehörigen Elementen mit dem Haupt-CI zusammengeführt werden sollen. * major_relations: Attribute, die aus dem CI mit den meisten Beziehungen zum Haupt-CI zusammengeführt werden sollen. * neueste_created: Getrennte Attribute, die vom zuletzt aktualisierten CI mit dem Haupt-CI zusammengeführt werden sollen. * älteste_kreiert: Durch Kommas getrennte Attribute, die vom ältesten erstellten CI mit dem Haupt-CI zusammengeführt werden sollen. {#DupTemp-getTemplate_S__ul_hlj_wlg_5xb} Datentyp: Zeichenfolge |
| \<Object\>.merge_relations | Gibt an, wie die Beziehungen für doppelte CIs innerhalb einer Deduplizierungsaufgabe bei Anwendung dieser Vorlage zusammengeführt werden. Mögliche Optionen: * alle * bedingt * Keine {#DupTemp-getTemplate_S__ul_shw_nmg_5xb} Datentyp: Zeichenfolge |
| \<Object\>.merge_related_items | Gibt an, welche zugehörigen Tabellen für doppelte CIs innerhalb einer Deduplizierungsaufgabe bei Anwendung dieser Vorlage mit dem Haupt-CI zusammengeführt werden. Siehe auch [Remediate a de-duplication task (legacy)](https://www.servicenow.com/docs/access?context=reconcile-dup-task&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US). Mögliche Optionen: * all_available: Enthält die standardmäßigen zugehörigen Tabellen und alle zugehörigen Tabellen, die auf doppelte CIs für die über die Vorlage korrigierte Deduplizierungsaufgabe verweisen. * bedingt * Standard -- Enthält zugehörige Einträge, die vom Modul „CI-Duplikatsnachbesserung -- Zugehörige Standardelemente" bereitgestellt werden. * Keine {#DupTemp-getTemplate_S__ul_thg_vmg_5xb} Datentyp: Zeichenfolge |
| \<Object\>.merge_related_items_ Bedingung | Liste der zugehörigen Einträge mit einer codierten Abfrage für jeden zugehörigen Eintrag. Jede Abfrage wird für das Haupt-CI ausgewertet, das für die Aufgabe ausgewählt ist. Wenn die Abfrage „true" zurückgibt, werden die zugehörigen Einträge während der Korrektur einer Deduplizierungsaufgabe zusammengeführt. Bei „false" werden zugehörige Einträge nicht zusammengeführt. Einzelheiten finden Sie unter [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) .{#DupTemp-getTemplate_S__link_encoded_query_strings} Datentyp: Array |
| \<Object\>.Most_relations_merge_attributes | Kommagetrennte Attribute, die aus dem CI mit den meisten Beziehungen zum Haupt-CI zusammengeführt werden sollen. Datentyp: Zeichenfolge |
| \<Object\>.Most_related_items_merge_attributes | Kommagetrennte Attribute, die aus dem CI mit den meisten zugehörigen Elementen mit dem Haupt-CI zusammengeführt werden sollen. Datentyp: Zeichenfolge |
| \<Object\>.name | Name der Vorlage. Datentyp: Zeichenfolge |
| \<Object\>.newest_updated_merge_attributes | Kommagetrennte Attribute, die vom zuletzt aktualisierten CI mit dem Haupt-CI zusammengeführt werden sollen. Datentyp: Zeichenfolge |
| \<Object\>.oldest_created_ merge_attributes | Kommagetrennte Attribute, die vom ältesten erstellten CI mit dem Haupt-CI zusammengeführt werden sollen. Datentyp: Zeichenfolge |
| \<Object\>.Tabelle | Tabelle, für die die Vorlage erstellt wird. Datentyp: Zeichenfolge |
| \<Object\>.task_condition_table | Speicherort der Tabellenaufgabenbedingungen, d. h. der Tabelle zum Abgleich von doppelten Aufgabendaten \[reconcile_duplicate_task_data\]. Der Wert ändert sich nie, und die Tabelle ist nur zur internen Verwendung vorgesehen. Datentyp: Zeichenfolge |
| \<Object\>.task_conditions | Codierte Abfrage, die ausgewertet werden soll, wenn die Vorlage ausgeführt wird. Diese Abfrage wird in der Tabelle „Daten doppelter Aufgaben abgleichen" \[reconcile_duplicate_task_data\] ausgewertet. Alle von dieser Abfrage zurückgegebenen Aufgaben werden während der Vorlagenauswertung berücksichtigt. Hinweis: Selbst wenn eine Aufgabe als Teil der Abfrage zurückgegeben wird, garantiert dies nicht, dass die Vorlagenausführung die Aufgabe verarbeitet. Andere Faktoren können dazu führen, dass die Aufgabe während der Vorlagenverarbeitung übersprungen wird. Einzelheiten finden Sie unter [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) .{#DupTemp-getTemplate_S__d2804e106} Datentyp: Zeichenfolge |
[Tabelle : 6. Ausgabe]

{#DupTemp-getTemplate_S__table_sl4_t5c_txb}  
Das folgende Beispiel zeigt, wie eine Vorlage abgerufen wird.

    var template = sn_cmdb.DuplicateTemplate.getTemplate('<template_id>');
    gs.info(JSON.stringify(template));

Ausgabe:

    {
      "most_relations_merge_attributes": "",
      "task_conditions": "category=attribute^key=serial_number^value=E2BX1^EQ",
      "duplicate_ci_updates": "org.mozilla.javascript.NativeArray@5d3b19ef",
      "description": "This is a Windows server template",
      "master_ci_option": "oldest_created",
      "merge_related_items": "conditional",
      "duplicate_ci_action": "delete",
      "newest_updated_merge_attributes": "",
      "merge_related_items_condition": [
        {
          "condition": "os_versionCONTAINSWindows",
          "related_entry": "incident.cmdb_ci"
        },
        {
          "condition": "ramCONTAINS1024",
          "related_entry": "change_request.cmdb_ci"
        }
      ],
      "most_related_items_merge_attributes": "",
      "merge_relations": "all",
      "task_condition_table": "reconcile_duplicate_task_data",
      "name": "Test Windows Template",
      "allow_null_attribute_update": false,
      "table": "cmdb_ci_win_server",
      "allow_master_ci_null_update": false,
      "oldest_created_merge_attributes": "serial_number,os_version"
    }

## DuplicateTemplate -- Vorschau der Vorlage (Zeichenfolge für Vorlagen-ID, Aufgaben-ID für Zeichenfolge) {#ariaid-title5}

Generiert eine Vorschau, wie verschiedene Vorlagenoptionen auf die Deduplizierungsaufgabe angewendet wurden und wie sie korrigiert werden soll.
Diese Methode validiert alle erforderlichen Attribute, bevor die Vorschau für die Aufgabe mithilfe der Vorlage generiert wird. Vorlagen können erstellt oder aktualisiert werden, ohne die erforderlichen Attribute anzugeben. Die erforderlichen Attribute müssen angegeben werden, um eine Vorschau auf eine Deduplizierungsaufgabe anzuzeigen.  
Die folgenden Attribute sind erforderlich:

* duplicate_ci_action
* Master_CI_Option
* „merge_related_items"
* merge_relations
* name
* Tabelle
{#DupTemp-previewTemplate_S_S__ul_dmr_bbd_txb}  
Hinweis:  
Obwohl diese Methode alle Attribute validiert, muss sich die Vorlage für eine Vorschau nicht im Status „Veröffentlicht" befinden.

Verwenden Sie die Methode [remediateTask()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-remediateTask_S_S "Behebt eine Deduplizierungsaufgabe mithilfe der Vorlage."), um Deduplizierungsaufgaben zu korrigieren.
{#DupTemp-previewTemplate_S_S__table_rl4_t5c_txb__entry__3}{#DupTemp-previewTemplate_S_S__ph_DupTemp-templateID}{#DupTemp-previewTemplate_S_S__ph_DupTemp-taskID}

| Name | Typ | Beschreibung |
|-|-|-|
| templateId | Zeichenfolge | Sys_id der Vorlage, die in der Tabelle „Duplikatvorlage abgleichen" \[reconcile_duplicate_template\] aufgeführt ist. |
| Aufgaben-ID | Zeichenfolge | Sys_id der Deduplizierungsaufgabe, die in der Tabelle „Aufgabe zur Duplikatnachbesserung" \[reconcile_duplicate_task\] aufgeführt ist. |
[Tabelle : 7. Parameter]

{#DupTemp-previewTemplate_S_S__table_rl4_t5c_txb} {#DupTemp-previewTemplate_S_S__table_sl4_t5c_txb__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Vorschauobjekt mit Werten, die zeigen, wie die Deduplizierungsaufgaben mithilfe der Vorlage behoben werden können. { "allClassCIMap": {Object}, "duplicateCIAction": "String", "duplicateCIUpdates": [Array], "masterCI": "String", "mergeRelations": Boolean, "relatedTablesMerged": [Array], "resolvedFieldCIMap": [Array], "taskId": "String", "tooManyDuplicates": Boolean } |
| \<Object\>.allClassCImap | Liste der sys_ids der CIs innerhalb einer Deduplizierungsaufgabe,, gruppiert nach CI-Klasse. Zum Beispiel cmdb_ci_computer. "allClassCIMap": { "<ci_class_name>": [ "<ci_sys_id_1>", "<ci_sys_id_2>" ] } Datentyp: Objekt |
| \<Object\>.duplicateCIAction | Gibt an, ob das doppelte CI gelöscht oder mit eindeutigen anwenderdefinierten Werten aktualisiert werden soll. Mögliche Optionen: * delete * update (erfordert die Angabe von duplicate_ci_updates) {#DupTemp-previewTemplate_S_S__ul_cby_1ng_5xb} Datentyp: Zeichenfolge |
| \<Object\>.duplicateCIUpdates | Array von Objekten, die angeben, wie die doppelten CI-Werte aktualisiert werden. [ { "element": "String", "element_label": "String", "value": "String", "display": "String" } ] Datentyp: Array |
| \<Object\>.duplicateCIUpdates.element | Der Systemwörterbuchname eines Referenzfelds. Datentyp: Zeichenfolge |
| \<Object\>.duplicateCIUpdates.element_label | Die Bezeichnung, die das Referenzfeld anzeigt. Datentyp: Zeichenfolge |
| \<Object\>.duplicateCIUpdates.value | Wert für ein Referenzfeld, also der Inhalt des Referenzfelds. Datentyp: Zeichenfolge |
| \<Object\>.duplicateCIUpdates.anzeigen | Anzeigewert für ein Referenzfeld. Datentyp: Zeichenfolge |
| \<Object\>.masterCI | Sys_id des CI, das als Haupt-CI ausgewählt wurde. Datentyp: Zeichenfolge |
| \<Object\>.mergeRelations | Gibt an, wie die Beziehungen für doppelte CIs innerhalb einer Deduplizierungsaufgabe bei Anwendung dieser Vorlage zusammengeführt werden. Mögliche Optionen: * alle * bedingt * Keine {#DupTemp-previewTemplate_S_S__ul_shw_nmg_5xb} Datentyp: Zeichenfolge |
| \<Object\>.relatedTablesMerged | Gibt an, welche zugehörigen Tabellen für doppelte CIs innerhalb einer Deduplizierungsaufgabe bei Anwendung dieser Vorlage mit dem Haupt-CI zusammengeführt werden. Siehe auch [Remediate a de-duplication task (legacy)](https://www.servicenow.com/docs/access?context=reconcile-dup-task&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US). Mögliche Optionen: * all_available: Enthält die standardmäßigen zugehörigen Tabellen und alle zugehörigen Tabellen, die auf doppelte CIs für die über die Vorlage korrigierte Deduplizierungsaufgabe verweisen. * bedingt * Standard -- Enthält zugehörige Einträge, die vom Modul „CI-Duplikatsnachbesserung -- Zugehörige Standardelemente" bereitgestellt werden. * Keine {#DupTemp-previewTemplate_S_S__ul_thg_vmg_5xb} Datentyp: Array |
| \<Object\>.resolvedFieldCIZuordnung | Array von Elementen, die aus doppelten CIs mit dem Haupt-CI zusammengeführt werden sollen. "resolvedFieldCIMap": [ { "element": "String", "sys_id": "String" } ] Datentyp: Array |
| \<Object\>.resolvedFieldCIMap.​Element | Name des Elements, das von einem doppelten CI mit dem Haupt-CI zusammengeführt werden soll. Datentyp: Zeichenfolge |
| \<Object\>.resolvedFieldCIMap.​sys_id | Sys_id des Elements, das von einem doppelten CI mit dem Haupt-CI zusammengeführt werden soll. Datentyp: Zeichenfolge |
| \<Object\>.taskId | Sys_id der Deduplizierungsaufgabe, die in der Tabelle „Aufgabe zur Duplikatnachbesserung" \[reconcile_duplicate_task\] aufgeführt ist. Datentyp: Zeichenfolge |
| \<Object\>.tooManyDuplicates | Kennzeichnung, die angibt, ob die Aufgabe mehr als die maximale Anzahl von CIs aufweist. Der Schwellenwert wird durch Vergleich des Werts der Systemeigenschaft glide.duplicate_ci_ remediator.max.cis (Standardwert 1000 CIs) bestimmt. Gültige Werte: * „wahr": Die Aufgabenanzahl von CIs überschreitet die maximale Anzahl von CIs. * „falsch": Anzahl der CIs der Aufgabe überschreitet nicht die maximale Anzahl von CIs. {#DupTemp-previewTemplate_S_S__ul_bmc_1vl_5xb} Datentyp: Boolesch |
[Tabelle : 8. Ausgabe]

{#DupTemp-previewTemplate_S_S__table_sl4_t5c_txb}  
Das folgende Beispiel zeigt, wie Sie eine Vorschau der Deduplizierungskorrektur für eine angegebene Vorlage abrufen.

    var preview = sn_cmdb.DuplicateTemplate.previewTemplate("<template_id>", "<task_id>");
    gs.info(JSON.stringify(preview));

Ausgabe:

    {
      "taskId": "<task_id>",
      "masterCI": "<ci_sys_id_1>",
      "allClassCIMap": {
        "cmdb_ci_computer": [
          "<ci_sys_id_1>",
          "<ci_sys_id_2>"
        ]
      },
      "resolvedFieldCIMap": [
        {
          "element": "ram",
          "sys_id": "<ci_sys_id_2>"
        },
        {
          "element": "os_version",
          "sys_id": "<ci_sys_id_2>"
        }
      ],
      "mergeRelations": true,
      "relatedTablesMerged": [
        "incident.cmdb_ci",
        "change_request.cmdb_ci"
      ],
      "duplicateCIAction": "delete",
      "duplicateCIUpdates": [],
      "tooManyDuplicates": false
    }

## DuplicateTemplate -- veröffentlichenTemplate(String templateId) {#ariaid-title6}

Veröffentlicht eine Vorlage. Bei Erfolg wird die Vorlage vom Status „Entwurf" in den Status „Veröffentlicht" verschoben.
Diese Methode validiert alle erforderlichen Attribute, bevor die Vorlage veröffentlicht wird. Sie können Vorlagen erstellen oder aktualisieren, ohne die erforderlichen Attribute anzugeben. Die Attribute müssen jedoch vor dem Veröffentlichen einer Vorlage angegeben werden.  
Die folgenden Attribute sind erforderlich:

* duplicate_ci_action
* Master_CI_Option
* „merge_related_items"
* merge_relations
* name
* Tabelle
{#DupTemp-publishTemplate_S__ul_dmr_bbd_txb}

Im Status „Veröffentlicht" können Sie die Vorlage mit der [runTemplate()-](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-runTemplate_S "Plant eine Korrekturausführung für eine Deduplizierungsvorlage im Status „Veröffentlicht“. Eine Vorlage kann mehrmals ausgeführt werden, Sie können jedoch jeweils nur eine Ausführung planen.") Methode ausführen.  
Siehe auch:

* [VorschauVorlage ()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-previewTemplate_S_S "Generiert eine Vorschau, wie verschiedene Vorlagenoptionen auf die Deduplizierungsaufgabe angewendet wurden und wie sie korrigiert werden soll.")
* [unPublishTemplate ()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-unPublishTemplate_S "Hebt die Veröffentlichung einer Vorlage auf.")
* [updateTemplate ()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-updateTemplate_S_O "Aktualisiert eine Deduplizierungsvorlage im Entwurfsstatus.")
{#DupTemp-publishTemplate_S__ul_y4f_sw1_xxb}
{#DupTemp-publishTemplate_S__table_rl4_t5c_txb__entry__3}{#DupTemp-publishTemplate_S__ph_DupTemp-templateID}

| Name | Typ | Beschreibung |
|-|-|-|
| templateId | Zeichenfolge | Sys_id der Vorlage, die in der Tabelle „Duplikatvorlage abgleichen" \[reconcile_duplicate_template\] aufgeführt ist. |
[Tabelle : 9. Parameter]

{#DupTemp-publishTemplate_S__table_rl4_t5c_txb} {#DupTemp-publishTemplate_S__table_sl4_t5c_txb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob die Vorlage veröffentlicht wurde. Gültige Werte: * wahr: Die Vorlage wurde veröffentlicht. * „falsch": Die Vorlage wurde nicht veröffentlicht. {#DupTemp-publishTemplate_S__ul_qks_v5c_txb} |
[Tabelle : 10. Ausgabe]

{#DupTemp-publishTemplate_S__table_sl4_t5c_txb}  
Das folgende Beispiel zeigt, wie Sie eine Vorlage veröffentlichen und Ergebnisse anzeigen.

    var isPublished = sn_cmdb.DuplicateTemplate.publishTemplate('<template_id>');
    gs.info(isPublished);

Ausgabe:

    true

## DuplicateTemplate -- remediateTask(Zeichenfolge templateId, Zeichenfolge taskId) {#ariaid-title7}

Behebt eine Deduplizierungsaufgabe mithilfe der Vorlage.
Wenn sich die Vorlage nicht im Status „Veröffentlicht" befindet, kann sie nicht ausgeführt werden, und die Methode löst eine Ausnahme aus.

Verwenden Sie die Methode „ [previewTemplate()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-previewTemplate_S_S "Generiert eine Vorschau, wie verschiedene Vorlagenoptionen auf die Deduplizierungsaufgabe angewendet wurden und wie sie korrigiert werden soll.") ", um eine Vorschau der zu behebenden Deduplizierungsaufgaben anzuzeigen.  
Siehe auch.

* [Duplicate CIs remediation](https://www.servicenow.com/docs/access?context=de-duplication-tasks&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)
* [VeröffentlichenVorlage ()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-publishTemplate_S "Veröffentlicht eine Vorlage. Bei Erfolg wird die Vorlage vom Status „Entwurf“ in den Status „Veröffentlicht“ verschoben.")
* [Remediate a de-duplication task (legacy)](https://www.servicenow.com/docs/access?context=reconcile-dup-task&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)
{#DupTemp-remediateTask_S_S__ul_b5c_st1_xxb}
{#DupTemp-remediateTask_S_S__table_rl4_t5c_txb__entry__3}{#DupTemp-remediateTask_S_S__ph_DupTemp-templateID}{#DupTemp-remediateTask_S_S__ph_DupTemp-taskID}

| Name | Typ | Beschreibung |
|-|-|-|
| templateId | Zeichenfolge | Sys_id der Vorlage, die in der Tabelle „Duplikatvorlage abgleichen" \[reconcile_duplicate_template\] aufgeführt ist. |
| Aufgaben-ID | Zeichenfolge | Sys_id der Deduplizierungsaufgabe, die in der Tabelle „Aufgabe zur Duplikatnachbesserung" \[reconcile_duplicate_task\] aufgeführt ist. |
[Tabelle : 11. Parameter]

{#DupTemp-remediateTask_S_S__table_rl4_t5c_txb} {#DupTemp-remediateTask_S_S__table_sl4_t5c_txb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Bei Erfolg die Zusammenführungslösungs-ID für die Korrektur der Deduplizierungsaufgabe. Diese Zusammenführungslösungs-ID ist die sys_id eines Datensatzes in der Tabelle „Nachbesserung von CI-Duplikaten" \[cmdb_duplicate_ci_remediation\]. Wenn dies nicht erfolgreich ist, befindet sich die Vorlage möglicherweise nicht im Status „Veröffentlicht". |
[Tabelle : 12. Ausgabe]

{#DupTemp-remediateTask_S_S__table_sl4_t5c_txb}  
Das folgende Beispiel zeigt, wie eine Deduplizierungsaufgabe behoben wird.

    var mergeResolutionId = sn_cmdb.DuplicateTemplate.remediateTask("<template_id>", "<task_id>");
    gs.info(mergeResolutionId);

Ausgabe:

    <merge_resolution_id>

## DuplicateTemplate -- requestCancelation(String templateRunId) {#ariaid-title8}

Bricht eine vorhandene Vorlagenausführung ab.
Eine Abbruchanforderung kann nur für eine Vorlagenausführung im Status „Entwurf", „Bereit" oder „Wird ausgeführt" gestellt werden.

Nach einer Anforderung zum Abbrechen der Vorlagenausführung ändert sich der Status der Vorlagenausführung in die Zwischenstufe Abbrechen angefordert.

Durch das Ausführen dieser Methode werden Vorlagenausführungen im Status „Bereit" oder „Entwurf" nicht automatisch abgebrochen. Der Ausführungsstatus der Vorlage ändert sich erst in „Abgebrochen", wenn alle laufenden Aufgaben abgeschlossen sind. Zu diesem Zeitpunkt werden alle verbleibenden Aufgaben, die für eine Korrektur bereitgestellt werden, von Abbruch angefordert in Abgebrochen geändert.  
Siehe auch:

* [VeröffentlichenVorlage ()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-publishTemplate_S "Veröffentlicht eine Vorlage. Bei Erfolg wird die Vorlage vom Status „Entwurf“ in den Status „Veröffentlicht“ verschoben.")
* [ausführenVorlage ()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-runTemplate_S "Plant eine Korrekturausführung für eine Deduplizierungsvorlage im Status „Veröffentlicht“. Eine Vorlage kann mehrmals ausgeführt werden, Sie können jedoch jeweils nur eine Ausführung planen.")
* [retireTemplate ()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-retireTemplate_S "Legt eine Vorlage still.")
{#DupTemp-requestCancellation_S__ul_jkx_snz_5xb}
{#DupTemp-requestCancellation_S__table_rl4_t5c_txb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| templateRunId | Zeichenfolge | Sys_id der Vorlagenausführung, die in der Tabelle „Deduplizierungsvorlagenausführung" \[reconcile_duplicate_template_run\] aufgeführt ist. |
[Tabelle : 13. Parameter]

{#DupTemp-requestCancellation_S__table_rl4_t5c_txb} {#DupTemp-requestCancellation_S__table_sl4_t5c_txb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Kennzeichnung, die angibt, ob die Abbruchanforderung erfolgreich war. Gültige Werte: * wahr: Die Abbruchanforderung war erfolgreich. * „falsch": Die Abbruchanforderung war nicht erfolgreich. {#DupTemp-requestCancellation_S__ul_qks_v5c_txb} |
[Tabelle : 14. Ergebnisse]

{#DupTemp-requestCancellation_S__table_sl4_t5c_txb}  
Das folgende Beispiel zeigt, wie Sie eine Vorlagenausführung abbrechen und anzeigen, ob der Vorgang erfolgreich war.

    var isCancelled = sn_cmdb.DuplicateTemplate.requestCancellation("487c67e2046b2510f877c1665753a4cc");
    gs.info(isCancelled);

Ausgabe:

    true

## DuplicateTemplate -- retireTemplate(String templateId) {#ariaid-title9}

Legt eine Vorlage still.
Verwenden Sie diese Methode, um eine Vorlage in den Status „Stillgelegt" zu verschieben, wenn sie nicht mehr benötigt wird.  
Die Vorlage kann nicht stillgelegt werden, und die Methode löst unter den folgenden Bedingungen eine Ausnahme aus:

* Die Vorlage befindet sich im Status „Veröffentlicht".
* Die Vorlage wird ausgeführt oder soll ausgeführt werden.
{#DupTemp-retireTemplate_S__ul_w51_czw_cyb}  
Siehe auch:

* [VeröffentlichenVorlage ()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-publishTemplate_S "Veröffentlicht eine Vorlage. Bei Erfolg wird die Vorlage vom Status „Entwurf“ in den Status „Veröffentlicht“ verschoben.")
* [ausführenVorlage ()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-runTemplate_S "Plant eine Korrekturausführung für eine Deduplizierungsvorlage im Status „Veröffentlicht“. Eine Vorlage kann mehrmals ausgeführt werden, Sie können jedoch jeweils nur eine Ausführung planen.")
* [Stornierung anfordern ()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-requestCancellation_S "Bricht eine vorhandene Vorlagenausführung ab.")
* [DuplicateTemplate -- unPublishTemplate(String templateId)](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-unPublishTemplate_S "Hebt die Veröffentlichung einer Vorlage auf.")
{#DupTemp-retireTemplate_S__ul_jkx_snz_5xb}
{#DupTemp-retireTemplate_S__table_rl4_t5c_txb__entry__3}{#DupTemp-retireTemplate_S__ph_DupTemp-templateID}

| Name | Typ | Beschreibung |
|-|-|-|
| templateId | Zeichenfolge | Sys_id der Vorlage, die in der Tabelle „Duplikatvorlage abgleichen" \[reconcile_duplicate_template\] aufgeführt ist. |
[Tabelle : 15. Parameter]

{#DupTemp-retireTemplate_S__table_rl4_t5c_txb} {#DupTemp-retireTemplate_S__table_sl4_t5c_txb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob die Vorlage stillgelegt ist. Gültige Werte: * „wahr": Die Vorlage wird deaktiviert. * „falsch": Die Vorlage konnte nicht stillgelegt werden, da sie ausgeführt wurde, zur Ausführung geplant war oder sich im Status „Veröffentlicht" befand {#DupTemp-retireTemplate_S__ul_qks_v5c_txb} |
[Tabelle : 16. Ausgabe]

{#DupTemp-retireTemplate_S__table_sl4_t5c_txb}  
Das folgende Beispiel zeigt, wie Sie eine Vorlage stilllegen und Ergebnisse anzeigen.

    var isRetired = sn_cmdb.DuplicateTemplate.retireTemplate(<template_id>);
    gs.info(isRetired);

Ausgabe:

    true

## DuplicateTemplate -- runTemplate(String templateId) {#ariaid-title10}

Plant eine Korrekturausführung für eine Deduplizierungsvorlage im Status „Veröffentlicht". Eine Vorlage kann mehrmals ausgeführt werden, Sie können jedoch jeweils nur eine Ausführung planen.
Wenn sich die Vorlage nicht im Status „Veröffentlicht" befindet, kann sie nicht ausgeführt werden, und die Methode löst eine Ausnahme aus. Verwenden Sie die [PublisherTemplate()-](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-publishTemplate_S "Veröffentlicht eine Vorlage. Bei Erfolg wird die Vorlage vom Status „Entwurf“ in den Status „Veröffentlicht“ verschoben.") Methode, um die Vorlage vom Status „Entwurf" in den Status „Veröffentlicht" zu versetzen.

Um eine laufende Aufgabe abzubrechen, verwenden Sie die Methode [requestCancelation()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-requestCancellation_S "Bricht eine vorhandene Vorlagenausführung ab.").
{#DupTemp-runTemplate_S__table_rl4_t5c_txb__entry__3}{#DupTemp-runTemplate_S__ph_DupTemp-templateID}

| Name | Typ | Beschreibung |
|-|-|-|
| templateId | Zeichenfolge | Sys_id der Vorlage, die in der Tabelle „Duplikatvorlage abgleichen" \[reconcile_duplicate_template\] aufgeführt ist. |
[Tabelle : 17. Parameter]

{#DupTemp-runTemplate_S__table_rl4_t5c_txb} {#DupTemp-runTemplate_S__table_sl4_t5c_txb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Sys_id der Vorlage, die in der Tabelle „Deduplizierungsvorlagenausführung" \[reconcile_duplicate_template_run\] aufgeführt wurde. Wenn dies nicht erfolgreich ist, befindet sich die Vorlage möglicherweise nicht im Status „Veröffentlicht". |
[Tabelle : 18. Ausgabe]

{#DupTemp-runTemplate_S__table_sl4_t5c_txb}  
Das folgende Beispiel zeigt, wie Sie eine Ausführung für eine veröffentlichte Deduplizierungsvorlage planen.

    var template = sn_cmdb.DuplicateTemplate.runTemplate('<template_id>');
    gs.info(JSON.stringify(template));

Ausgabe:

    487c67e2046b2510f877c1665753a4cc

## DuplicateTemplate -- unPublishTemplate(String templateId) {#ariaid-title11}

Hebt die Veröffentlichung einer Vorlage auf.
Diese Methode versetzt die Vorlage vom Status „Veröffentlicht" in den Status „Entwurf", wodurch die Vorlage aktualisiert werden kann. Die Veröffentlichung der Vorlage kann nicht aufgehoben werden, wenn sie ausgeführt wird oder ihre Ausführung geplant ist.  
Siehe auch:

* [VeröffentlichenVorlage ()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-publishTemplate_S "Veröffentlicht eine Vorlage. Bei Erfolg wird die Vorlage vom Status „Entwurf“ in den Status „Veröffentlicht“ verschoben.")
* [Stornierung anfordern ()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-requestCancellation_S "Bricht eine vorhandene Vorlagenausführung ab.")
* [updateTemplate ()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-updateTemplate_S_O "Aktualisiert eine Deduplizierungsvorlage im Entwurfsstatus.")
{#DupTemp-unPublishTemplate_S__ul_f5y_sv1_xxb}
{#DupTemp-unPublishTemplate_S__table_rl4_t5c_txb__entry__3}{#DupTemp-unPublishTemplate_S__ph_DupTemp-templateID}

| Name | Typ | Beschreibung |
|-|-|-|
| templateId | Zeichenfolge | Sys_id der Vorlage, die in der Tabelle „Duplikatvorlage abgleichen" \[reconcile_duplicate_template\] aufgeführt ist. |
[Tabelle : 19. Parameter]

{#DupTemp-unPublishTemplate_S__table_rl4_t5c_txb} {#DupTemp-unPublishTemplate_S__table_sl4_t5c_txb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob die Veröffentlichung der Vorlage erfolgreich aufgehoben wurde. Gültige Werte: * „wahr": Die Veröffentlichung der Vorlage wurde erfolgreich aufgehoben. * „falsch": Das Aufheben der Veröffentlichung der Vorlage wurde nicht erfolgreich aufgehoben. Die Vorlage wird möglicherweise ausgeführt oder ist zur Ausführung geplant. {#DupTemp-unPublishTemplate_S__ul_qks_v5c_txb} |
[Tabelle : 20. Ausgabe]

{#DupTemp-unPublishTemplate_S__table_sl4_t5c_txb}  
Im folgenden Beispiel wird gezeigt, wie Sie die Veröffentlichung einer Vorlage aufheben und Ergebnisse anzeigen.

    var isUnPublished = sn_cmdb.DuplicateTemplate.unPublishTemplate(<template_id>);
    gs.info(isUnPublished);

Ausgabe:

    true

## DuplicateTemplate -- updateTemplate(String templateId, Object template) {#ariaid-title12}

Aktualisiert eine Deduplizierungsvorlage im Entwurfsstatus.
Siehe auch:

* [unPublishTemplate ()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-unPublishTemplate_S "Hebt die Veröffentlichung einer Vorlage auf.")
* [kannZurVorlageAufgabenhinzufügen ()](https://www.servicenow.com/docs/GyrZpnBk0UWvpiKN84IUIQ#DupTemp-canAddTasksToTemplate_A_S "Überprüft, ob die bereitgestellte Aufgabenliste einer Vorlage hinzugefügt werden kann.")
{#DupTemp-updateTemplate_S_O__ul_bdd_vlw_cyb}
{#DupTemp-updateTemplate_S_O__table_rl4_t5c_txb__entry__3}{#DupTemp-updateTemplate_S_O__ph_DupTemp-templateID}{#DupTemp-updateTemplate_S_O__ph_DupTemp-templateObj}{#DupTemp-updateTemplate_S_O__ph_DupTemp-template-allow-null-attr}{#DupTemp-updateTemplate_S_O__ph_DupTemp-template-master-ci-nul}{#DupTemp-updateTemplate_S_O__ph_DupTemp-template-desc}{#DupTemp-updateTemplate_S_O__ph_DupTemp-template-dup-ci-action}{#DupTemp-updateTemplate_S_O__ph_DupTemp-template-dup-ci-updts}{#DupTemp-updateTemplate_S_O__ph_DupTemp-template-dup-ci-upd-lmt}{#DupTemp-updateTemplate_S_O__ph_DupTemp-template-dup-ci-upd-lbl}{#DupTemp-updateTemplate_S_O__ph_DupTemp-template-dup-ci-upd-val}{#DupTemp-updateTemplate_S_O__ph_DupTemp-template-dup-ci-upd-dsp}{#DupTemp-updateTemplate_S_O__ph_DupTemp-template-master-ci-opt}{#DupTemp-updateTemplate_S_O__link_encoded_query_strings}{#DupTemp-updateTemplate_S_O__ph_DupTemp-template-mrg-relations}{#DupTemp-updateTemplate_S_O__d2830e465}{#DupTemp-updateTemplate_S_O__d2804e106}{#DupTemp-updateTemplate_S_O__ph_DupTemp-template-mrgRel-itms}{#DupTemp-updateTemplate_S_O__d2804e106}{#DupTemp-updateTemplate_S_O__ph_DupTemp-template-most-relationsMA}{#DupTemp-updateTemplate_S_O__ph_DupTemp-template-mostRel-itmMA}{#DupTemp-updateTemplate_S_O__ph_DupTemp-template-name}{#DupTemp-updateTemplate_S_O__ph_DupTemp-template-newst-updtdMA}{#DupTemp-updateTemplate_S_O__ph_DupTemp-template-oldst-crtdMA}{#DupTemp-updateTemplate_S_O__ph_DupTemp-template-table}{#DupTemp-updateTemplate_S_O__d2804e106}

| Name | Typ | Beschreibung |
|-|-|-|
| templateId | Zeichenfolge | Sys_id der Vorlage, die in der Tabelle „Duplikatvorlage abgleichen" \[reconcile_duplicate_template\] aufgeführt ist. |
| Vorlage | Objekt | Das Vorlagenobjekt mit verschiedenen Optionen zum Erstellen der Vorlage. { "allow_master_ci_null_update": Boolean, "allow_null_attribute_update": Boolean, "description": "String", "duplicate_ci_action": "String", "duplicate_ci_updates": [Array], "master_ci_condition": "String", "master_ci_option": "String", "merge_related_items": "String", "merge_related_items_condition": [Array], "merge_relations_condition": "String", "merge_relations": "String", "most_related_items_merge_attributes": "String", "most_relations_merge_attributes": "String", "name": "String", "newest_updated_merge_attributes": "String", "oldest_created_merge_attributes": "String", "table": "String", "task_conditions": "String" } {#DupTemp-updateTemplate_S_O__cb_DupTemp-templateObj} |
| template.allow_null_​attribute_update | Boolean | Optional. Kennzeichnung, die angibt, ob die Haupt-CI-Attribute mit Null-Werten aus doppelten CIs aktualisiert werden, wenn Attributkonflikte für CIs innerhalb einer Deduplizierungsaufgabe gelöst werden. Gültige Werte: * „wahr": Die Haupt-CI-Attribute werden mit Nullwerten aus doppelten CIs aktualisiert. * „falsch": Die Haupt-CI-Attribute werden nicht mit NULL-Werten aus doppelten CIs aktualisiert. {#DupTemp-updateTemplate_S_O__ul_h4x_nhb_cyb} Standardwert: False |
| template.allow_master_ci_​null_update | Boolean | Optional. Schließt nur Updates von doppelten CIs ein, wenn der Haupt-CI-Wert NULL ist. Kennzeichnung, die angibt, ob nur Updates von doppelten CIs einbezogen werden sollen, wenn der Haupt-CI-Wert NULL ist. Gültige Werte: * „wahr": Es werden nur Updates von doppelten CIs einbezogen, wenn der Haupt-CI-Wert NULL ist. * „falsch": Updates aus allen doppelten CIs einbeziehen. {#DupTemp-updateTemplate_S_O__ul_hmn_phb_cyb} Standardwert: False |
| template.description | Zeichenfolge | Optional. Beschreibung zum Speichern weiterer Informationen zur Vorlage. |
| template.duplicate_​ci_action | Zeichenfolge | Optional. Gibt an, ob das doppelte CI gelöscht oder mit eindeutigen anwenderdefinierten Werten aktualisiert werden soll. Mögliche Optionen: * delete * update (erfordert die Angabe von duplicate_ci_updates) {#DupTemp-updateTemplate_S_O__ul_cby_1ng_5xb} |
| template.duplicate_​ci_updates | Array | Optional, es sei denn, die Einstellung für duplicate_ci_action lautet <kbd class="ph userinput">update</kbd>. Array von Objekten, die angeben, wie die doppelten CI-Werte aktualisiert werden. [ { "element": "String", "element_label": "String", "value": "String", "display": "String" } ] {#DupTemp-updateTemplate_S_O__codeb_DupTemp-template-dup-ci-upd} |
| template.duplicate_​ci_updates.element | Zeichenfolge | Der Systemwörterbuchname eines Referenzfelds. |
| template.duplicate_​ci_updates.element_label | Zeichenfolge | Die Bezeichnung, die das Referenzfeld anzeigt. |
| template.duplicate_​ci_updates.value | Zeichenfolge | Wert für ein Referenzfeld, also der Inhalt des Referenzfelds. |
| template.duplicate_​ci_updates.display | Zeichenfolge | Anzeigewert für ein Referenzfeld. |
| template.master_ci_​option | Zeichenfolge | Optional. Gibt an, wie das Haupt-CI bei Anwendung dieser Vorlage für eine Deduplizierungsaufgabe ausgewählt wird. Mögliche Optionen: * bedingt ( master_ci_conditionmuss angegeben werden) * major_related_items: Attribute, die aus dem CI mit den meisten zugehörigen Elementen mit dem Haupt-CI zusammengeführt werden sollen. * major_relations: Attribute, die aus dem CI mit den meisten Beziehungen zum Haupt-CI zusammengeführt werden sollen. * neueste_created: Getrennte Attribute, die vom zuletzt aktualisierten CI mit dem Haupt-CI zusammengeführt werden sollen. * älteste_kreiert: Durch Kommas getrennte Attribute, die vom ältesten erstellten CI mit dem Haupt-CI zusammengeführt werden sollen. {#DupTemp-updateTemplate_S_O__ul_hlj_wlg_5xb} |
| Bedingung „template.master_ci_" | Zeichenfolge | Optional (erforderlich, wenn der Wert von master_ci_option<kbd class="ph userinput">bedingt</kbd>ist). Codierte Abfrage, um anzugeben, wie das Haupt-CI ausgewählt wird. Wenn mehrere CIs oder keine CIs mit der Abfrage übereinstimmen, wählt die -Methode das zuletzt aktualisierte CI als Haupt-CI aus. Die codierte Abfrage wird für die Vorlagentabelle ausgewertet. Diese Tabelle wird in der Eigenschaft table identifiziert. Einzelheiten finden Sie unter [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) . |
| template.merge_relations | Zeichenfolge | Optional. Gibt an, wie die Beziehungen für doppelte CIs innerhalb einer Deduplizierungsaufgabe bei Anwendung dieser Vorlage zusammengeführt werden. Mögliche Optionen: * alle * bedingt * Keine {#DupTemp-updateTemplate_S_O__ul_shw_nmg_5xb} |
| template.merge_relations | Zeichenfolge | Optional. Gibt an, wie die Beziehungen für doppelte CIs innerhalb einer Deduplizierungsaufgabe bei Anwendung dieser Vorlage zusammengeführt werden. Mögliche Optionen: * alle * bedingt * Keine {#DupTemp-updateTemplate_S_O__d2830e470} |
| template.merge_relations_​condition | Zeichenfolge | Optional (erforderlich, wenn der Wert von merge_relations<kbd class="ph userinput">bedingt</kbd>ist). Codierte Abfrage, um anzugeben, ob alle oder keine der Beziehungen aus doppelten CIs zusammengeführt werden. Die Abfrage wird für das Haupt-CI ausgewertet, das für die Deduplizierungsaufgabe ausgewählt ist. Wenn die Abfrage „true" zurückgibt, werden alle Beziehungen zusammengeführt. Bei „false" werden keine Beziehungen zusammengeführt. Die codierte Abfrage wird für die Vorlagentabelle ausgewertet. Diese Tabelle wird in der Eigenschaft table identifiziert. Einzelheiten finden Sie unter [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) . |
| template.merge_related_items | Zeichenfolge | Optional. Gibt an, welche zugehörigen Tabellen für doppelte CIs innerhalb einer Deduplizierungsaufgabe bei Anwendung dieser Vorlage mit dem Haupt-CI zusammengeführt werden. Siehe auch [Remediate a de-duplication task (legacy)](https://www.servicenow.com/docs/access?context=reconcile-dup-task&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US). Mögliche Optionen: * all_available: Enthält die standardmäßigen zugehörigen Tabellen und alle zugehörigen Tabellen, die auf doppelte CIs für die über die Vorlage korrigierte Deduplizierungsaufgabe verweisen. * bedingt * Standard -- Enthält zugehörige Einträge, die vom Modul „CI-Duplikatsnachbesserung -- Zugehörige Standardelemente" bereitgestellt werden. * Keine {#DupTemp-updateTemplate_S_O__ul_thg_vmg_5xb} |
| template.merge_related_items_​condition | Array | Optional. Liste der zugehörigen Einträge mit einer codierten Abfrage für jeden zugehörigen Eintrag. Jede Abfrage wird für das Haupt-CI ausgewertet, das für die Aufgabe ausgewählt ist. Wenn die Abfrage „true" zurückgibt, werden die zugehörigen Einträge während der Korrektur einer Deduplizierungsaufgabe zusammengeführt. Bei „false" werden zugehörige Einträge nicht zusammengeführt. "merge_related_items_condition": [ { "related_entry": "String", "condition": "String" } ] {#DupTemp-updateTemplate_S_O__cb_DupTem-template-mrgRel-itmCnd} Einzelheiten finden Sie unter [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) . |
| template.host_relations_​merge_attributes | Zeichenfolge | Optional. Kommagetrennte Attribute, die aus dem CI mit den meisten Beziehungen zum Haupt-CI zusammengeführt werden sollen. |
| template.host_related_items_​merge_attributes | Zeichenfolge | Optional. Kommagetrennte Attribute, die aus dem CI mit den meisten zugehörigen Elementen mit dem Haupt-CI zusammengeführt werden sollen. |
| template.name | Zeichenfolge | Name der Vorlage. |
| template.neest_updated_​merge_attributes | Zeichenfolge | Optional. Kommagetrennte Attribute, die vom zuletzt aktualisierten CI mit dem Haupt-CI zusammengeführt werden sollen. |
| template.oldest_created_​merge_attributes | Zeichenfolge | Optional. Kommagetrennte Attribute, die vom ältesten erstellten CI mit dem Haupt-CI zusammengeführt werden sollen. |
| template.table | Zeichenfolge | Tabelle, für die die Vorlage erstellt wird. |
| template.task_conditions | Zeichenfolge | Optional. Codierte Abfrage, die ausgewertet werden soll, wenn die Vorlage ausgeführt wird. Diese Abfrage wird in der Tabelle „Daten doppelter Aufgaben abgleichen" \[reconcile_duplicate_task_data\] ausgewertet. Alle von dieser Abfrage zurückgegebenen Aufgaben werden während der Vorlagenauswertung berücksichtigt. Hinweis: Selbst wenn eine Aufgabe als Teil der Abfrage zurückgegeben wird, garantiert dies nicht, dass die Vorlagenausführung die Aufgabe verarbeitet. Andere Faktoren können dazu führen, dass die Aufgabe während der Vorlagenverarbeitung übersprungen wird. Einzelheiten finden Sie unter [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) . |
[Tabelle : 21. Parameter]

{#DupTemp-updateTemplate_S_O__table_rl4_t5c_txb} {#DupTemp-updateTemplate_S_O__table_sl4_t5c_txb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob die Vorlage aktualisiert wurde. Gültige Werte: * wahr: Die Vorlage wurde aktualisiert. * „falsch": Die Vorlage wurde aktualisiert. Die Vorlage befindet sich möglicherweise nicht im Entwurfsstatus (nicht veröffentlicht). {#DupTemp-updateTemplate_S_O__ul_qks_v5c_txb} |
[Tabelle : 22. Ausgabe]

{#DupTemp-updateTemplate_S_O__table_sl4_t5c_txb}  
Das folgende Beispiel zeigt, wie Sie mehrere Eigenschaften einer vorhandenen Deduplizierungsvorlage aktualisieren.

    var template = {
      "name": "Test Windows Template",
      "table": "cmdb_ci_win_server",
      "description": "This is a windows server template",
      "master_ci_option": "newest_updated",
      "master_ci_condition": "",
      "allow_null_attribute_update": false,
      "allow_master_ci_null_update": false,
      "oldest_created_merge_attributes": "",
      "newest_updated_merge_attributes": "ram,cpu_count",
      "most_relations_merge_attributes": "",
      "most_related_items_merge_attributes": "",
      "merge_relations": "all",
      "merge_relations_condition": "",
      "merge_related_items": "conditional",
      "merge_related_items_condition": [
        {
          "related_entry": "change_request.cmdb_ci",
          "condition": "ramCONTAINS1024"
        },
        {
          "related_entry": "incident.cmdb_ci",
          "condition": "os_versionCONTAINSWindows"
        }
      ],
      "duplicate_ci_action": "delete",
      "duplicate_ci_updates": "",
      "task_conditions": "category=attribute^key=serial_number^value=E2BX1^EQ"
    };

    sn_cmdb.DuplicateTemplate.updateTemplate(<template_id>, template);

Ausgabe:

    true