---
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


---

# Duplikatvorlage -- Umfang

# Duplikatvorlage -- Umfang {#ariaid-title1}

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

Die Duplikatvorlage Die API bietet Methoden für die Interaktion mit Deduplizierungsvorlagen, indem für jede Methode eine Reihe von Validierungen erzwungen werden.

Die Korrektur von Deduplizierungsaufgaben kann zeitaufwändiger als wünschenswert sein, wenn sie einzeln behandelt wird. Duplizierungsvorlagen ermöglichen das Gruppieren einer Reihe doppelter Aufgaben und die gemeinsame Ausführung. Verwenden Sie Duplikatvorlage API zum Erstellen und Verwenden von Deduplizierungsvorlagen. Diese API wird in ausgeführt `sn_cmdb `Namespace und erfordert die Rolle „cmdb_dedup_admin" für den Zugriff.

Wenn eine Instanz während der Identifizierung und des Abgleichs doppelte Konfigurationselemente (CIs) erkennt, gruppiert sie jeden Satz doppelter CIs zu 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=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US).

Siehe auch: [IdentifikationEngine -- Umfang](https://servicenow-prod.fluidtopics.net/4ZcQFI3j8bMdK9eaUkVVig#IdentificationEngineScopedAPI "Die IdentifikationEngine Die API verwendet das Identifizierungs- und Abgleich-Framework, um die Erstellung doppelter Konfigurationselemente (CIs) zu minimieren und CI-Attribute abzugleichen, indem beim Aktualisieren von nur Informationen aus autorisierten Datenquellen akzeptiert werden Configuration Management Database (CMDB).")

Vorlagenlebenszyklus
:
    1. Verwenden Sie [Vorlage erstellen ()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-createTemplate_O "Erstellt eine Deduplizierungsvorlage im Entwurfsstatus.")Methode zum Erstellen einer Vorlage im Entwurfsstatus.  
       Sie können die folgenden Methoden verwenden, um die Vorlage abzurufen oder zu aktualisieren:
       * [GetTemplate()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-getTemplate_S "Ruft das Vorlagenobjekt ab.")
       * [CanAddTasksToTemplate()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-canAddTasksToTemplate_A_S "Überprüft, ob die angegebene Liste von Aufgaben einer Vorlage hinzugefügt werden kann.")
       * [UpdateTemplate()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-updateTemplate_S_O "Aktualisiert eine Deduplizierungsvorlage im Entwurfsstatus.")
       {#DuplicateTemplateScopedAPI__ul_gd1_by1_cyb}
    2. Verwenden Sie [PublishTemplate()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-publishTemplate_S "Veröffentlicht eine Vorlage. Wenn erfolgreich, wechselt die Vorlage vom Status „Entwurf“ in den Status „veröffentlicht“.")Methode zum Verschieben der Vorlage vom Status „Entwurf" in den Status „veröffentlicht".  
       Hinweis:  
       Verwenden Sie [UnPublishTemplate()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-unPublishTemplate_S "Hebt die Veröffentlichung einer Vorlage auf.")Methode, um eine veröffentlichte Vorlage in den Entwurfsstatus zurückzugeben und die Vorlage zu aktualisieren.
    3. Optional. Verwenden Sie [CMDBDuplicateTemplateUtil](https://servicenow-prod.fluidtopics.net/8CrMsGrul1GGtRcJXC0rQQ#CMDBDuplicateTemplateUtilAPI "Die CMDBDuplicateTemplateUtil Die Skripteinbindung bietet Methoden zum Hinzufügen und Entfernen von Deduplizierungsaufgaben zu einer Deduplizierungsvorlage.")Skripteinbindung zum Hinzufügen oder Entfernen von Aufgaben.
    4. Verwenden Sie [Ausführungsvorlage ()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#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 zum Ausführen der Vorlage.

       Verwenden Sie zum Abbrechen einer laufenden Aufgabe [Anforderungsabbruch()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-requestCancellation_S "Bricht eine vorhandene Vorlagenausführung ab.")Methode.
    5. Wenn die Vorlage nicht mehr benötigt wird, können Sie die Vorlage mit stilllegen [Stilllegen von Vorlage()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-retireTemplate_S "Legt eine Vorlage außer Kraft.")Methode.
    {#DuplicateTemplateScopedAPI__ol_kmg_qx1_cyb}

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

    1. Verwenden Sie [Vorschauvorlage()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-previewTemplate_S_S "Generiert eine Vorschau darauf, wie verschiedene Vorlagenoptionen auf die Deduplizierungsaufgabe angewendet wurden und wie sie korrigiert werden soll.")Methode zum Vorschauen der Korrektur einer einzelnen Aufgabe mit einer Vorlage.
    2. Verwenden Sie [RemediateTask()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-remediateTask_S_S "Korrigiert eine Deduplizierungsaufgabe mithilfe der Vorlage.")Methode zum Nachbessern der Deduplizierungsaufgabe mit einer Vorlage.
    {#DuplicateTemplateScopedAPI__ol_es1_3nr_dyb}

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

Überprüft, ob die angegebene Liste von Aufgaben 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, aber die angegebenen Deduplizierungsaufgaben werden für Linux-Server erstellt. Diese Aufgaben haben keine übereinstimmende Vorlagenklasse, daher können sie 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 fehlgeschlagenen Aufgaben hinzugefügt werden können. { "success": [ "<task_id_1>", "<task_id_2>", "<task_id_3>" ], "failed": [ "<task_id_4>" ], "skipped": [ "<task_id_5>" ] } |
| Fehlgeschlagen | Fehler beim Überprüfen, ob die Aufgabe mit der Vorlage kompatibel ist. Siehe auch [Detecting duplicate CIs](https://www.servicenow.com/docs/access?context=id-detect-dup-ci&version=yokohama&pubname=yokohama-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 stimmt mit der Vorlagenklasse überein und kann der Vorlage hinzugefügt werden. |
[Tabelle : 2. Rückgaben]

{#DupTemp-canAddTasksToTemplate_A_S__table_sl4_t5c_txb}  
Das folgende Beispiel zeigt, wie nach Aufgaben gesucht wird, 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__d3687e466}{#DupTemp-createTemplate_O__d2864e106}{#DupTemp-createTemplate_O__ph_DupTemp-template-mrgRel-itms}{#DupTemp-createTemplate_O__d2864e106}{#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__d2864e106}

| 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 Haupt-CI-Attribute bei der Lösung von Attributkonflikten für CIs innerhalb einer Deduplizierungsaufgabe mit Nullwerten aus doppelten CIs aktualisiert werden. Gültige Werte: * Wahr: Die Haupt-CI-Attribute werden mit Nullwerten aus doppelten CIs aktualisiert. * Falsch: Die Haupt-CI-Attribute werden nicht mit Nullwerten aus doppelten CIs aktualisiert. {#DupTemp-createTemplate_O__ul_h4x_nhb_cyb} Standard: Falsch |
| Template.allow_Master_ci_​null_Update | Boolean | Optional. Enthält nur Updates aus doppelten CIs, wenn der Haupt-CI-Wert null ist. Kennzeichnung, die angibt, ob nur Updates aus doppelten CIs einbezogen werden sollen, wenn der Haupt-CI-Wert null ist. Gültige Werte: * Wahr: Updates aus doppelten CIs nur einschließen, wenn der Haupt-CI-Wert null ist. * Falsch: Updates aus allen doppelten CIs einschließen. {#DupTemp-createTemplate_O__ul_hmn_phb_cyb} Standard: Falsch |
| 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: * löschen * Aktualisieren (Angabe erforderlich duplicate_ci_updates) {#DupTemp-createTemplate_O__ul_cby_1ng_5xb} |
| Template.duplicate_​ci_Updates | Array | Optional, es sei denn, die Einstellung für ist duplicate_ci_actionIst <kbd class="ph userinput">Aktualisieren </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.Duplikat_​ci_Updates.Element | Zeichenfolge | Der Systemwörterbuchname eines Referenzfelds. |
| Template.Duplikat_​ci_Updates.Element_label | Zeichenfolge | Die Bezeichnung, die das Referenzfeld anzeigt. |
| Template.Duplikat_​ci_Updates.value | Zeichenfolge | Wert für ein Referenzfeld, d. h. den 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 der Anwendung dieser Vorlage für eine Deduplizierungsaufgabe ausgewählt wird. Mögliche Optionen: * Bedingt (muss angegeben werden master_ci_condition) * Most_related_items: Attribute, die aus dem CI mit den am meisten zugehörigen Elementen zum Haupt-CI zusammengeführt werden sollen. * Most_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_erstellte: Kommagetrennte Attribute, die vom ältesten erstellten CI mit dem Haupt-CI zusammengeführt werden sollen. {#DupTemp-createTemplate_O__ul_hlj_wlg_5xb} |
| Template.Master_ci_ Bedingung | Zeichenfolge | Optional (erforderlich, wenn der Wert von master_ci_optionIst <kbd class="ph userinput">Bedingt </kbd>). 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 identifiziert tableEigenschaft. Weitere Informationen finden Sie unter [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US) . |
| Template.Merge_Relations | Zeichenfolge | Optional. Gibt an, wie die Beziehungen für doppelte CIs innerhalb einer Deduplizierungsaufgabe beim Anwenden 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 beim Anwenden dieser Vorlage zusammengeführt werden. Mögliche Optionen: * alle * Bedingt * Keine {#DupTemp-createTemplate_O__d3687e471} |
| Template.Merge_Relations_-​Bedingung | Zeichenfolge | Optional (erforderlich, wenn der Wert von merge_relationsIst <kbd class="ph userinput">Bedingt </kbd>). 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 „wahr" zurückgibt, werden alle Beziehungen zusammengeführt. Bei „falsch" werden keine Beziehungen zusammengeführt. Die codierte Abfrage wird für die Vorlagentabelle ausgewertet. Diese Tabelle wird in identifiziert tableEigenschaft. Weitere Informationen finden Sie unter [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=yokohama&pubname=yokohama-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 mit dem Haupt-CI zusammengeführt werden, wenn diese Vorlage angewendet wird. Siehe auch [Remediate a de-duplication task (legacy)](https://www.servicenow.com/docs/access?context=reconcile-dup-task&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US). Mögliche Optionen: * All_available: Enthält die standardbezogenen Tabellen und alle zugehörigen Tabellen, die auf doppelte CIs für die über die Vorlage korrigierte Deduplizierungsaufgabe verweisen. * Bedingt * Standard: Schließt zugehörige Einträge ein, die vom Modul „Nachbesserung von CI-Duplikaten" bereitgestellt werden. * Keine {#DupTemp-createTemplate_O__ul_thg_vmg_5xb} |
| Template.MERGE_related_items_-​Bedingung | 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 „wahr" zurückgibt, werden die zugehörigen Einträge während der Korrektur einer Deduplizierungsaufgabe zusammengeführt. Bei „falsch" 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} Weitere Informationen finden Sie unter [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US) . |
| Template.most_Relations_​MERGE_attributes | Zeichenfolge | Optional. Kommagetrennte Attribute, die aus dem CI mit den meisten Beziehungen zum Haupt-CI zusammengeführt werden sollen. |
| Template.most_related_items_​MERGE_attributes | Zeichenfolge | Optional. Kommagetrennte Attribute, die aus dem CI mit den am meisten zugehörigen Elementen zum Haupt-CI zusammengeführt werden sollen. |
| template.name | Zeichenfolge | Name der Vorlage. |
| Template.neueste_aktualisierte_​zusammenführen_Attribute | 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.Tabelle | Zeichenfolge | Tabelle, für die die Vorlage erstellt wird. |
| Template.Task_conditions | Zeichenfolge | Optional. Codierte Abfrage, die bei Ausführung der Vorlage ausgewertet werden soll. Diese Abfrage wird in der Tabelle „doppelte Aufgabendaten abgleichen" \[reconcile_duplicate_task_data\] ausgewertet. Alle von dieser Abfrage zurückgegebenen Aufgaben werden bei 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. Weitere Informationen finden Sie unter [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=yokohama&pubname=yokohama-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. Rückgaben]

{#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(Zeichenfolge 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 Haupt-CI-Attribute bei der Lösung von Attributkonflikten für CIs innerhalb einer Deduplizierungsaufgabe mit Nullwerten aus doppelten CIs aktualisiert werden. Gültige Werte: * Wahr: Die Haupt-CI-Attribute werden mit Nullwerten aus doppelten CIs aktualisiert. * Falsch: Die Haupt-CI-Attribute werden nicht mit Nullwerten aus doppelten CIs aktualisiert. {#DupTemp-getTemplate_S__ul_h4x_nhb_cyb} Datentyp: Boolescher Wert |
| \<Object\>.Allow_Master_ci_ null_Update | Enthält nur Updates aus doppelten CIs, wenn der Haupt-CI-Wert null ist. Gültige Werte: * Wahr: Updates aus doppelten CIs nur einschließen, wenn der Haupt-CI-Wert null ist. * Falsch: Updates aus allen doppelten CIs einschließen. {#DupTemp-getTemplate_S__ul_hmn_phb_cyb} Datentyp: Boolescher Wert |
| \<Object\>.Beschreibung | 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: * löschen * Aktualisieren (Angabe erforderlich duplicate_ci_updates) {#DupTemp-getTemplate_S__ul_cby_1ng_5xb} Datentyp: Zeichenfolge |
| \<Object\>.Duplikat_ 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, d. h. den Inhalt des Referenzfelds. Datentyp: Zeichenfolge |
| \<Object\>.DuplicateCIUpdates.Display | Anzeigewert für ein Referenzfeld. Datentyp: Zeichenfolge |
| \<Object\>.Master_ci_-Option | Gibt an, wie das Haupt-CI bei der Anwendung dieser Vorlage für eine Deduplizierungsaufgabe ausgewählt wird. Mögliche Optionen: * Bedingt (muss angegeben werden master_ci_condition) * Most_related_items: Attribute, die aus dem CI mit den am meisten zugehörigen Elementen zum Haupt-CI zusammengeführt werden sollen. * Most_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_erstellte: Kommagetrennte 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 beim Anwenden 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 mit dem Haupt-CI zusammengeführt werden, wenn diese Vorlage angewendet wird. Siehe auch [Remediate a de-duplication task (legacy)](https://www.servicenow.com/docs/access?context=reconcile-dup-task&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US). Mögliche Optionen: * All_available: Enthält die standardbezogenen Tabellen und alle zugehörigen Tabellen, die auf doppelte CIs für die über die Vorlage korrigierte Deduplizierungsaufgabe verweisen. * Bedingt * Standard: Schließt zugehörige Einträge ein, die vom Modul „Nachbesserung von CI-Duplikaten" bereitgestellt werden. * Keine {#DupTemp-getTemplate_S__ul_thg_vmg_5xb} Datentyp: Zeichenfolge |
| \<Object\>Bedingung „.Merge_related_items_" | 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 „wahr" zurückgibt, werden die zugehörigen Einträge während der Korrektur einer Deduplizierungsaufgabe zusammengeführt. Bei „falsch" werden zugehörige Einträge nicht zusammengeführt. Weitere Informationen finden Sie unter [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=yokohama&pubname=yokohama-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 am meisten zugehörigen Elementen zum Haupt-CI zusammengeführt werden sollen. Datentyp: Zeichenfolge |
| \<Object\>.Name | Name der Vorlage. Datentyp: Zeichenfolge |
| \<Object\>.Neueste_aktualisierte_ 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 „doppelte Aufgabendaten abgleichen" \[reconcile_duplicate_task_data\]. Der Wert ändert sich nie, und die Tabelle ist nur für den internen Gebrauch vorgesehen. Datentyp: Zeichenfolge |
| \<Object\>.Task_conditions | Codierte Abfrage, die bei Ausführung der Vorlage ausgewertet werden soll. Diese Abfrage wird in der Tabelle „doppelte Aufgabendaten abgleichen" \[reconcile_duplicate_task_data\] ausgewertet. Alle von dieser Abfrage zurückgegebenen Aufgaben werden bei 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. Weitere Informationen finden Sie unter [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US) .{#DupTemp-getTemplate_S__d2864e106} Datentyp: Zeichenfolge |
[Tabelle : 6. Rückgaben]

{#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 -- PreviewTemplate(Zeichenfolge templateId, Zeichenfolge taskId) {#ariaid-title5}

Generiert eine Vorschau darauf, 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 einer Deduplizierungsaufgabe anzuzeigen.  
Die folgenden Attribute sind erforderlich:

* Duplikat_ci_action
* Master_ci_Option
* Zusammenführen_related_items
* Merge_Relations
* name
* table
{#DupTemp-previewTemplate_S_S__ul_dmr_bbd_txb}  
Hinweis:  
Obwohl diese Methode alle Attribute validiert, ist es nicht erforderlich, dass sich die Vorlage für eine Vorschau im Status „veröffentlicht" befindet.

Verwenden Sie [RemediateTask()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-remediateTask_S_S "Korrigiert eine Deduplizierungsaufgabe mithilfe der Vorlage.")Methode zum Nachbessern von Deduplizierungsaufgaben.
{#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 „Duplikataufgabe korrigieren" \[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 korrigiert 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. 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: * löschen * Aktualisieren (Angabe erforderlich 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, d. h. den Inhalt des Referenzfelds. Datentyp: Zeichenfolge |
| \<Object\>.DuplicateCIUpdates.Display | 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 beim Anwenden 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 mit dem Haupt-CI zusammengeführt werden, wenn diese Vorlage angewendet wird. Siehe auch [Remediate a de-duplication task (legacy)](https://www.servicenow.com/docs/access?context=reconcile-dup-task&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US). Mögliche Optionen: * All_available: Enthält die standardbezogenen Tabellen und alle zugehörigen Tabellen, die auf doppelte CIs für die über die Vorlage korrigierte Deduplizierungsaufgabe verweisen. * Bedingt * Standard: Schließt zugehörige Einträge ein, die vom Modul „Nachbesserung von CI-Duplikaten" bereitgestellt werden. * Keine {#DupTemp-previewTemplate_S_S__ul_thg_vmg_5xb} Datentyp: Array |
| \<Object\>.ResolvedFieldCIMap | 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 aus einem doppelten CI mit dem Haupt-CI zusammengeführt werden soll. Datentyp: Zeichenfolge |
| \<Object\>.ResolvedFieldCIMap. ​sys_ID | SYS_ID des Elements, das aus einem doppelten CI mit dem Haupt-CI zusammengeführt werden soll. Datentyp: Zeichenfolge |
| \<Object\>.TaskId | SYS_ID der Deduplizierungsaufgabe, die in der Tabelle „Duplikataufgabe korrigieren" \[Reconcile_duplicate_Task\] aufgeführt ist. Datentyp: Zeichenfolge |
| \<Object\>.TooManyDuplikate | Kennzeichnung, die angibt, ob die Aufgabe mehr als die maximale Anzahl von CIs hat. Der Schwellenwert wird durch Vergleich des Werts der Systemeigenschaft „Glide.duplicate_ci_ Remediator.max.cis" (Standardwert 1000 CIs) bestimmt. Gültige Werte: * Wahr: Die Aufgabenzahl von CIs überschreitet die maximale Anzahl von CIs. * Falsch: Die Aufgabenzahl von CIs überschreitet die maximale Anzahl von CIs nicht. {#DupTemp-previewTemplate_S_S__ul_bmc_1vl_5xb} Datentyp: Boolescher Wert |
[Tabelle : 8. Rückgaben]

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

    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 -- publishTemplate(Zeichenfolge templateId) {#ariaid-title6}

Veröffentlicht eine Vorlage. Wenn erfolgreich, wechselt die Vorlage vom Status „Entwurf" in den Status „veröffentlicht".
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 angegeben werden, bevor eine Vorlage veröffentlicht wird.  
Die folgenden Attribute sind erforderlich:

* Duplikat_ci_action
* Master_ci_Option
* Zusammenführen_related_items
* Merge_Relations
* name
* table
{#DupTemp-publishTemplate_S__ul_dmr_bbd_txb}

Im Status „veröffentlicht" können Sie die Vorlage mit ausführen [Ausführungsvorlage ()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#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.  
Siehe auch:

* [Vorschauvorlage()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-previewTemplate_S_S "Generiert eine Vorschau darauf, wie verschiedene Vorlagenoptionen auf die Deduplizierungsaufgabe angewendet wurden und wie sie korrigiert werden soll.")
* [UnPublishTemplate()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-unPublishTemplate_S "Hebt die Veröffentlichung einer Vorlage auf.")
* [UpdateTemplate()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#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. Rückgaben]

{#DupTemp-publishTemplate_S__table_sl4_t5c_txb}  
Das folgende Beispiel zeigt, wie eine Vorlage veröffentlicht und Ergebnisse angezeigt werden.

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

Ausgabe:

    true

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

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

Verwenden Sie [Vorschauvorlage()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-previewTemplate_S_S "Generiert eine Vorschau darauf, wie verschiedene Vorlagenoptionen auf die Deduplizierungsaufgabe angewendet wurden und wie sie korrigiert werden soll.")Methode zur Vorschau der Korrektur von Deduplizierungsaufgaben.  
Siehe auch.

* [Duplicate CIs remediation](https://www.servicenow.com/docs/access?context=de-duplication-tasks&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US)
* [PublishTemplate()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-publishTemplate_S "Veröffentlicht eine Vorlage. Wenn erfolgreich, wechselt die Vorlage vom Status „Entwurf“ in den Status „veröffentlicht“.")
* [Remediate a de-duplication task (legacy)](https://www.servicenow.com/docs/access?context=reconcile-dup-task&version=yokohama&pubname=yokohama-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 „Duplikataufgabe korrigieren" \[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 | Wenn erfolgreich, die ID der Zusammenführungslösung für die Korrektur der Deduplizierungsaufgabe. Diese Zusammenführungs-Lösungs-ID ist die sys_ID eines Datensatzes in der Tabelle „Nachbesserung doppelter CIs \[cmdb_duplicate_ci_remediation\]". Wenn nicht erfolgreich, befindet sich die Vorlage möglicherweise nicht im Status „veröffentlicht". |
[Tabelle : 12. Rückgaben]

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

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

Ausgabe:

    <merge_resolution_id>

## DuplicateTemplate -- requestCancellation(Zeichenfolge templateRunId) {#ariaid-title8}

Bricht eine vorhandene Vorlagenausführung ab.
Eine Abbruchanforderung kann nur für eine Vorlagenausführung erstellt werden, wenn sie sich im Status „Entwurf", „bereit" oder „wird ausgeführt" befindet.

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

Durch die Ausführung dieser Methode werden Vorlagenausführungen im Status „bereit" oder „Entwurf" nicht automatisch abgebrochen. Der Ausführungsstatus der Vorlage ändert sich erst in „Abgebrochen", wenn die ausgeführten Aufgaben abgeschlossen sind. An diesem Punkt werden alle verbleibenden Aufgaben, die für die Korrektur bereitgestellt werden, von „Abbrechen angefordert" zu „Abgebrochen" geändert.  
Siehe auch:

* [PublishTemplate()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-publishTemplate_S "Veröffentlicht eine Vorlage. Wenn erfolgreich, wechselt die Vorlage vom Status „Entwurf“ in den Status „veröffentlicht“.")
* [Ausführungsvorlage ()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#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.")
* [Stilllegen von Vorlage()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-retireTemplate_S "Legt eine Vorlage außer Kraft.")
{#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. Rückgaben]

{#DupTemp-requestCancellation_S__table_sl4_t5c_txb}  
Das folgende Beispiel zeigt, wie eine Vorlagenausführung abgebrochen und angezeigt wird, ob der Vorgang erfolgreich ist.

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

Ausgabe:

    true

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

Legt eine Vorlage außer Kraft.
Verwenden Sie diese Methode, um eine Vorlage in den Status „Stilllegen" 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:

* [PublishTemplate()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-publishTemplate_S "Veröffentlicht eine Vorlage. Wenn erfolgreich, wechselt die Vorlage vom Status „Entwurf“ in den Status „veröffentlicht“.")
* [Ausführungsvorlage ()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#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.")
* [Anforderungsabbruch()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-requestCancellation_S "Bricht eine vorhandene Vorlagenausführung ab.")
* [DuplicateTemplate -- unPublishTemplate(Zeichenfolge templateId)](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#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 ist stillgelegt. * Falsch: Die Vorlage konnte nicht stillgelegt werden, da sie ausgeführt wurde, die Ausführung geplant ist oder sich im Status „veröffentlicht" befindet {#DupTemp-retireTemplate_S__ul_qks_v5c_txb} |
[Tabelle : 16. Rückgaben]

{#DupTemp-retireTemplate_S__table_sl4_t5c_txb}  
Das folgende Beispiel zeigt, wie eine Vorlage stillgelegt und Ergebnisse angezeigt werden.

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

Ausgabe:

    true

## DuplicateTemplate -- runTemplate(Zeichenfolge 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 [PublishTemplate()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-publishTemplate_S "Veröffentlicht eine Vorlage. Wenn erfolgreich, wechselt die Vorlage vom Status „Entwurf“ in den Status „veröffentlicht“.")Methode zum Verschieben der Vorlage vom Status „Entwurf" in den Status „veröffentlicht".

Verwenden Sie zum Abbrechen einer laufenden Aufgabe [Anforderungsabbruch()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-requestCancellation_S "Bricht eine vorhandene Vorlagenausführung ab.")Methode.
{#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 ausgeführten Vorlage, die in der Tabelle „Ausführung der Deduplizierungsvorlage \[reconcile_duplicate_template_run\]" aufgeführt ist. Wenn nicht erfolgreich, befindet sich die Vorlage möglicherweise nicht im Status „veröffentlicht". |
[Tabelle : 18. Rückgaben]

{#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(Zeichenfolge templateId) {#ariaid-title11}

Hebt die Veröffentlichung einer Vorlage auf.
Diese Methode verschiebt die Vorlage vom Status „veröffentlicht" in den Status „Entwurf", wodurch die Vorlage aktualisiert werden kann. Die Veröffentlichung der Vorlage kann nicht rückgängig gemacht werden, wenn sie ausgeführt wird oder deren Ausführung geplant ist.  
Siehe auch:

* [PublishTemplate()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-publishTemplate_S "Veröffentlicht eine Vorlage. Wenn erfolgreich, wechselt die Vorlage vom Status „Entwurf“ in den Status „veröffentlicht“.")
* [Anforderungsabbruch()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-requestCancellation_S "Bricht eine vorhandene Vorlagenausführung ab.")
* [UpdateTemplate()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#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: Die Veröffentlichung der Vorlage wurde nicht erfolgreich aufgehoben. Die Vorlage wird möglicherweise ausgeführt oder soll ausgeführt werden. {#DupTemp-unPublishTemplate_S__ul_qks_v5c_txb} |
[Tabelle : 20. Rückgaben]

{#DupTemp-unPublishTemplate_S__table_sl4_t5c_txb}  
Das folgende Beispiel zeigt, wie die Veröffentlichung einer Vorlage rückgängig gemacht und Ergebnisse angezeigt werden.

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

Ausgabe:

    true

## DuplicateTemplate -- updateTemplate(Zeichenfolge templateId, Objektvorlage) {#ariaid-title12}

Aktualisiert eine Deduplizierungsvorlage im Entwurfsstatus.
Siehe auch:

* [UnPublishTemplate()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-unPublishTemplate_S "Hebt die Veröffentlichung einer Vorlage auf.")
* [CanAddTasksToTemplate()](https://servicenow-prod.fluidtopics.net/bnNSgJb28UNrcv026nz9CA#DupTemp-canAddTasksToTemplate_A_S "Überprüft, ob die angegebene Liste von Aufgaben 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__d3687e466}{#DupTemp-updateTemplate_S_O__d2864e106}{#DupTemp-updateTemplate_S_O__ph_DupTemp-template-mrgRel-itms}{#DupTemp-updateTemplate_S_O__d2864e106}{#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__d2864e106}

| 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 Haupt-CI-Attribute bei der Lösung von Attributkonflikten für CIs innerhalb einer Deduplizierungsaufgabe mit Nullwerten aus doppelten CIs aktualisiert werden. Gültige Werte: * Wahr: Die Haupt-CI-Attribute werden mit Nullwerten aus doppelten CIs aktualisiert. * Falsch: Die Haupt-CI-Attribute werden nicht mit Nullwerten aus doppelten CIs aktualisiert. {#DupTemp-updateTemplate_S_O__ul_h4x_nhb_cyb} Standard: Falsch |
| Template.allow_Master_ci_​null_Update | Boolean | Optional. Enthält nur Updates aus doppelten CIs, wenn der Haupt-CI-Wert null ist. Kennzeichnung, die angibt, ob nur Updates aus doppelten CIs einbezogen werden sollen, wenn der Haupt-CI-Wert null ist. Gültige Werte: * Wahr: Updates aus doppelten CIs nur einschließen, wenn der Haupt-CI-Wert null ist. * Falsch: Updates aus allen doppelten CIs einschließen. {#DupTemp-updateTemplate_S_O__ul_hmn_phb_cyb} Standard: Falsch |
| 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: * löschen * Aktualisieren (Angabe erforderlich duplicate_ci_updates) {#DupTemp-updateTemplate_S_O__ul_cby_1ng_5xb} |
| Template.duplicate_​ci_Updates | Array | Optional, es sei denn, die Einstellung für ist duplicate_ci_actionIst <kbd class="ph userinput">Aktualisieren </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.Duplikat_​ci_Updates.Element | Zeichenfolge | Der Systemwörterbuchname eines Referenzfelds. |
| Template.Duplikat_​ci_Updates.Element_label | Zeichenfolge | Die Bezeichnung, die das Referenzfeld anzeigt. |
| Template.Duplikat_​ci_Updates.value | Zeichenfolge | Wert für ein Referenzfeld, d. h. den 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 der Anwendung dieser Vorlage für eine Deduplizierungsaufgabe ausgewählt wird. Mögliche Optionen: * Bedingt (muss angegeben werden master_ci_condition) * Most_related_items: Attribute, die aus dem CI mit den am meisten zugehörigen Elementen zum Haupt-CI zusammengeführt werden sollen. * Most_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_erstellte: Kommagetrennte Attribute, die vom ältesten erstellten CI mit dem Haupt-CI zusammengeführt werden sollen. {#DupTemp-updateTemplate_S_O__ul_hlj_wlg_5xb} |
| Template.Master_ci_ Bedingung | Zeichenfolge | Optional (erforderlich, wenn der Wert von master_ci_optionIst <kbd class="ph userinput">Bedingt </kbd>). 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 identifiziert tableEigenschaft. Weitere Informationen finden Sie unter [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US) . |
| Template.Merge_Relations | Zeichenfolge | Optional. Gibt an, wie die Beziehungen für doppelte CIs innerhalb einer Deduplizierungsaufgabe beim Anwenden 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 beim Anwenden dieser Vorlage zusammengeführt werden. Mögliche Optionen: * alle * Bedingt * Keine {#DupTemp-updateTemplate_S_O__d3687e471} |
| Template.Merge_Relations_-​Bedingung | Zeichenfolge | Optional (erforderlich, wenn der Wert von merge_relationsIst <kbd class="ph userinput">Bedingt </kbd>). 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 „wahr" zurückgibt, werden alle Beziehungen zusammengeführt. Bei „falsch" werden keine Beziehungen zusammengeführt. Die codierte Abfrage wird für die Vorlagentabelle ausgewertet. Diese Tabelle wird in identifiziert tableEigenschaft. Weitere Informationen finden Sie unter [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=yokohama&pubname=yokohama-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 mit dem Haupt-CI zusammengeführt werden, wenn diese Vorlage angewendet wird. Siehe auch [Remediate a de-duplication task (legacy)](https://www.servicenow.com/docs/access?context=reconcile-dup-task&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US). Mögliche Optionen: * All_available: Enthält die standardbezogenen Tabellen und alle zugehörigen Tabellen, die auf doppelte CIs für die über die Vorlage korrigierte Deduplizierungsaufgabe verweisen. * Bedingt * Standard: Schließt zugehörige Einträge ein, die vom Modul „Nachbesserung von CI-Duplikaten" bereitgestellt werden. * Keine {#DupTemp-updateTemplate_S_O__ul_thg_vmg_5xb} |
| Template.MERGE_related_items_-​Bedingung | 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 „wahr" zurückgibt, werden die zugehörigen Einträge während der Korrektur einer Deduplizierungsaufgabe zusammengeführt. Bei „falsch" 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} Weitere Informationen finden Sie unter [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US) . |
| Template.most_Relations_​MERGE_attributes | Zeichenfolge | Optional. Kommagetrennte Attribute, die aus dem CI mit den meisten Beziehungen zum Haupt-CI zusammengeführt werden sollen. |
| Template.most_related_items_​MERGE_attributes | Zeichenfolge | Optional. Kommagetrennte Attribute, die aus dem CI mit den am meisten zugehörigen Elementen zum Haupt-CI zusammengeführt werden sollen. |
| template.name | Zeichenfolge | Name der Vorlage. |
| Template.neueste_aktualisierte_​zusammenführen_Attribute | 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.Tabelle | Zeichenfolge | Tabelle, für die die Vorlage erstellt wird. |
| Template.Task_conditions | Zeichenfolge | Optional. Codierte Abfrage, die bei Ausführung der Vorlage ausgewertet werden soll. Diese Abfrage wird in der Tabelle „doppelte Aufgabendaten abgleichen" \[reconcile_duplicate_task_data\] ausgewertet. Alle von dieser Abfrage zurückgegebenen Aufgaben werden bei 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. Weitere Informationen finden Sie unter [Codierte Abfragezeichenfolgen](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=yokohama&pubname=yokohama-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. Rückgaben]

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

    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


