---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# DuplicateTemplate - inclus dans le champ d'application

# DuplicateTemplate - inclus dans le champ d'application {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 27 minutes de lecture

L'API DuplicateTemplate fournit des méthodes permettant aux utilisateurs d'interagir avec les modèles de déduplication en appliquant un ensemble de validations pour chaque méthode.

La remédiation des tâches de déduplication peut prendre plus de temps qu'il n'est souhaitable lorsqu'elle est gérée individuellement. Les modèles de duplication permettent de regrouper un ensemble de tâches en double et de les exécuter ensemble. Utilisez l'API DuplicateTemplate pour créer et utiliser des modèles de déduplication. Cette API s'exécute dans l'espace de noms `sn_cmdb` et nécessite le rôle cmdb_dedup_admin pour y accéder.

Lorsqu'une instance détecte des éléments de configuration (CI) en double pendant l'identification et le rapprochement, elle regroupe chaque ensemble de CI en double dans une tâche de déduplication pour examen et correction. Les tâches de déduplication fournissent des détails sur la duplication, notamment une liste de tous les CI en double. (pour en savoir plus, consultez [Duplicate CIs remediation](https://www.servicenow.com/docs/access?context=de-duplication-tasks&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)) ;

Voir aussi : [IdentificationEngine : inclus dans le champ d'application](https://servicenow-prod.fluidtopics.net/IOSvtIlIBPRKVhFJK4jWzA#IdentificationEngineScopedAPI "L’API IdentificationEngine utilise le cadre de travail Identification et rapprochement pour minimiser la création d’éléments de configuration (CI) en double et pour rapprocher les attributs de CI en acceptant uniquement des informations provenant de sources de données autorisées lors de la mise à jour du Base de données de gestion des configurations (CMDB)fichier .")

Cycle de vie du modèle
:
    1. Utilisez la méthode [CreateTemplate()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-createTemplate_O "Crée un modèle de déduplication à l’état brouillon.") pour créer un modèle à l'état de brouillon.  
       Vous pouvez utiliser les méthodes suivantes pour récupérer ou mettre à jour le modèle :
       * [getTemplate()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-getTemplate_S "Obtient l’objet de modèle.")
       * [canAddTasksToTemplate()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-canAddTasksToTemplate_A_S "Vérifie si la liste de tâches fournie peut être ajoutée à un modèle.")
       * [updateTemplate()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-updateTemplate_S_O "Met à jour un modèle de déduplication à l’état brouillon.")
       {#DuplicateTemplateScopedAPI__ul_gd1_by1_cyb}
    2. Utilisez la méthode [publishTemplate()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-publishTemplate_S "Publie un modèle. En cas de réussite, le modèle passe de l’état Brouillon à l’état Publié.") pour faire passer le modèle de l'état Brouillon à l'état Publié.  
       Remarque :  
       Utilisez la méthode [unPublishTemplate()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-unPublishTemplate_S "Annule la publication d’un modèle.") pour remettre un modèle publié à l'état de brouillon et mettre à jour le modèle.
    3. Facultatif. Utilisez l'include de script [include CMDBDuplicateTemplateUtil](https://servicenow-prod.fluidtopics.net/GitznsVJgbY0VDYkyxA4BQ#CMDBDuplicateTemplateUtilAPI "L’include de script CMDBDuplicateTemplateUtil fournit des méthodes permettant d’ajouter et de supprimer des tâches de déduplication vers/depuis un modèle de déduplication.") pour ajouter ou supprimer des tâches.
    4. Utilisez la méthode [runTemplate()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-runTemplate_S "Planifie une exécution de rattrapage pour un modèle de déduplication à l’état Publié. Un modèle peut être exécuté plusieurs fois, mais vous ne pouvez en planifier qu’une seule à la fois.") pour exécuter le modèle.

       Pour annuler une tâche en cours d'exécution, utilisez la méthode [requestCancellation().](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-requestCancellation_S "Annule une exécution de modèle existante.")
    5. Si le modèle n'est plus nécessaire, vous pouvez le mettre hors service à l'aide de la méthode [retireTemplate().](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-retireTemplate_S "Met un modèle hors service.")
    {#DuplicateTemplateScopedAPI__ol_kmg_qx1_cyb}

Correction d'une tâche unique à l'aide d'un modèle
:   Pour corriger une seule tâche sans exécuter le modèle, vous pouvez prévisualiser et corriger les tâches de déduplication.

    1. Utilisez la méthode [previewTemplate()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-previewTemplate_S_S "Génère un aperçu de la façon dont les différentes options de modèle ont été appliquées à la tâche de déduplication et de la façon dont elle doit être corrigée.") pour prévisualiser le rattrapage d'une tâche unique avec un modèle.
    2. Utilisez la méthode [remediateTask()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-remediateTask_S_S "Corrige une tâche de déduplication à l’aide du modèle.") pour corriger la tâche de déduplication à l'aide d'un modèle.
    {#DuplicateTemplateScopedAPI__ol_es1_3nr_dyb}

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

Vérifie si la liste de tâches fournie peut être ajoutée à un modèle.
Utilisez cette méthode pour déterminer si les tâches peuvent être ajoutées au modèle. Par exemple, le modèle spécifié peut être créé pour le serveur d'applications Tomcat, mais les tâches de déduplication spécifiées sont créées pour le serveur Linux. Ces tâches n'ont pas de classe de modèle correspondante, elles ne peuvent donc pas être ajoutées au modèle.
{#DupTemp-canAddTasksToTemplate_A_S__table_rl4_t5c_txb__entry__3}{#DupTemp-canAddTasksToTemplate_A_S__ph_DupTemp-templateID}

| Nom | Type | Description |
|-|-|-|
| taskIds | Tableau | Tableau des sys_ids des tâches de déduplication à ajouter au modèle. |
| ID de modèle | Chaîne | Sys_id du modèle répertorié dans la table Rapprocher le modèle en double \[reconcile_duplicate_template\]. |
[Tableau 1. Paramètres]

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

| Type | Description |
|-|-|
| Objet | Objet de résultat contenant les tâches qui peuvent être ajoutées, ignorées ou échouées. { "success": [ "<task_id_1>", "<task_id_2>", "<task_id_3>" ], "failed": [ "<task_id_4>" ], "skipped": [ "<task_id_5>" ] } |
| échoué | Une erreur s'est produite lors de la vérification de la compatibilité de la tâche avec le modèle. Voir aussi [Detecting duplicate CIs](https://www.servicenow.com/docs/access?context=id-detect-dup-ci&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US). |
| ignoré | Les tâches sont incompatibles, car elles n'ont pas de classe de modèle correspondante, par conséquent la tâche a été ignorée. |
| succès | La tâche correspond à la classe de modèle et peut être ajoutée au modèle. |
[Tableau 2. Renvoie]

{#DupTemp-canAddTasksToTemplate_A_S__table_sl4_t5c_txb}  
L'exemple suivant montre comment vérifier les tâches qui peuvent être ajoutées au modèle.

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

Sortie :

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

## DuplicateTemplate : createTemplate (modèle d'objet) {#ariaid-title3}

Crée un modèle de déduplication à l'état brouillon.
{#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__d2830e464}{#DupTemp-createTemplate_O__d2804e105}{#DupTemp-createTemplate_O__ph_DupTemp-template-mrgRel-itms}{#DupTemp-createTemplate_O__d2804e105}{#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__d2804e105}

| Nom | Type | Description |
|-|-|-|
| modèle | Objet | Objet de modèle avec différentes options de création du modèle. { "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 | Booléen | Facultatif. Marqueur indiquant si les attributs de CI principaux sont mis à jour avec des valeurs nulles provenant de CI en double lors de la résolution de conflits d'attributs pour les CI dans le cadre d'une tâche de déduplication. Valeurs valides : * vrai : les attributs de CI principaux sont mis à jour avec les valeurs null des CI en double. * faux : les attributs de CI principal ne sont pas mis à jour avec les valeurs null des CI en double. {#DupTemp-createTemplate_O__ul_h4x_nhb_cyb} Valeur par défaut : false |
| template.allow_master_ci_null_update | Booléen | Facultatif. Inclut uniquement les mises à jour des CI en double si la valeur principale du CI est nulle. Marqueur indiquant s'il faut inclure uniquement les mises à jour des CI en double si la valeur principale du CI est nulle. Valeurs valides : * vrai : n'incluez les mises à jour des CI en double que si la valeur principale du CI est nulle. * faux : inclure les mises à jour de tous les CI en double. {#DupTemp-createTemplate_O__ul_hmn_phb_cyb} Valeur par défaut : false |
| modèle.description | Chaîne | Facultatif. Description pour stocker plus d'informations sur le modèle. |
| template.duplicate_ci_action | Chaîne | Facultatif. Spécifie si le CI en double doit être supprimé ou mis à jour avec des valeurs personnalisées uniques. Options possibles : * supprimer * Mettre à jour (nécessite d'être spécifié duplicate_ci_updates) {#DupTemp-createTemplate_O__ul_cby_1ng_5xb} |
| template.duplicate_ci_updates | Tableau | Facultatif, sauf si le paramètre pour est <kbd class="ph userinput">Mettre à</kbd>duplicate_ci_action jour. Tableau d'objets spécifiant comment les valeurs de CI en double sont mises à jour. [ { "element": "String", "element_label": "String", "value": "String", "display": "String" } ] {#DupTemp-createTemplate_O__codeb_DupTemp-template-dup-ci-upd} |
| template.duplicate_ci_updates.element | Chaîne | Nom du dictionnaire système d'un champ de référence. |
| template.duplicate_ci_updates.element_label | Chaîne | Étiquette affichée dans le champ de référence. |
| template.duplicate_ci_updates.valeur | Chaîne | Valeur d'un champ de référence, c'est-à-dire le contenu du champ de référence. |
| template.duplicate_ci_updates.display | Chaîne | Valeur d'affichage d'un champ de référence. |
| template.master_ci_option | Chaîne | Facultatif. Spécifie comment le CI principal est sélectionné pour une tâche de déduplication lors de l'application de ce modèle. Options possibles : * Conditionnel (doit préciser master_ci_condition) * most_related_items : attributs à fusionner à partir du CI avec le plus d'éléments connexes au CI principal. * most_relations : attributs à fusionner à partir du CI ayant le plus de relations avec le CI principal. * newest_created : attributs séparés à fusionner à partir de la dernière mise à jour du CI vers le CI principal. * oldest_created : attributs séparés par des virgules à fusionner du CI le plus ancien vers le CI principal. {#DupTemp-createTemplate_O__ul_hlj_wlg_5xb} |
| template.master_ci_condition | Chaîne | Facultatif (obligatoire si la valeur de master_ci_option est <kbd class="ph userinput">conditionnelle</kbd>). Requête codée pour spécifier comment le CI principal est sélectionné. Si plusieurs CI ou aucun CI ne correspondent à la requête, la méthode sélectionne le CI le plus récemment mis à jour comme CI principal. La requête codée est évaluée pour la table de modèles. Cette table est identifiée dans la table propriété. Pour plus [d'informations, consultez Chaînes de requêtes codées](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) . |
| template.merge_relations | Chaîne | Facultatif. Spécifie comment les relations des CI en double au sein d'une tâche de déduplication sont fusionnées lors de l'application de ce modèle. Options possibles : * tous * conditionnel * aucun {#DupTemp-createTemplate_O__ul_shw_nmg_5xb} |
| template.merge_relations | Chaîne | Facultatif. Spécifie comment les relations des CI en double au sein d'une tâche de déduplication sont fusionnées lors de l'application de ce modèle. Options possibles : * tous * conditionnel * aucun {#DupTemp-createTemplate_O__d2830e469} |
| template.merge_relations_condition | Chaîne | Facultatif (obligatoire si la valeur de merge_relations est <kbd class="ph userinput">conditionnelle</kbd>). Requête codée pour spécifier si toutes les relations des CI en double sont fusionnées ou aucune. La requête est évaluée sur le CI principal sélectionné pour la tâche de déduplication. Si la requête renvoie vrai, toutes les relations sont fusionnées. Si la valeur est définie sur Faux, aucune relation n'est fusionnée. La requête codée est évaluée pour la table de modèles. Cette table est identifiée dans la table propriété. Pour plus [d'informations, consultez Chaînes de requêtes codées](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) . |
| template.merge_related_items | Chaîne | Facultatif. Spécifie les tables connexes des CI en double dans une tâche de déduplication qui sont fusionnées dans le CI principal lors de l'application de ce modèle. Voir aussi [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). Options possibles : * all_available : inclut les tables connexes par défaut et toutes les tables connexes qui font référence aux CI en double pour la tâche de déduplication corrigée via le modèle. * conditionnel * Par défaut : inclut les entrées connexes fournies par le module Éléments associés par défaut du correcteur de CI en double. * aucun {#DupTemp-createTemplate_O__ul_thg_vmg_5xb} |
| template.merge_related_items_condition | Tableau | Facultatif. Liste des entrées associées avec une requête codée pour chaque entrée associée. Chaque requête est évaluée sur le CI principal sélectionné pour la tâche. Si la requête renvoie vrai, les entrées connexes sont fusionnées lors du rattrapage d'une tâche de déduplication. Si la valeur est définie sur false, les entrées connexes ne sont pas fusionnées. "merge_related_items_condition": [ { "related_entry": "String", "condition": "String" } ] {#DupTemp-createTemplate_O__cb_DupTem-template-mrgRel-itmCnd} Pour plus [d'informations, consultez Chaînes de requêtes codées](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) . |
| template.most_relations_merge_attributes | Chaîne | Facultatif. Attributs séparés par des virgules à fusionner à partir du CI ayant le plus de relations avec le CI principal. |
| template.most_related_items_merge_attributes | Chaîne | Facultatif. Attributs séparés par des virgules à fusionner à partir du CI avec le plus d'éléments associés au CI principal. |
| template.name | Chaîne | Nom du modèle. |
| template.newest_updated_merge_attributes | Chaîne | Facultatif. Attributs séparés par des virgules à fusionner du CI le plus récemment mis à jour vers le CI principal. |
| template.oldest_created_merge_attributes | Chaîne | Facultatif. Attributs séparés par des virgules à fusionner du CI le plus ancien vers le CI principal. |
| modèle.table | Chaîne | Table pour laquelle le modèle est créé. |
| template.task_conditions | Chaîne | Facultatif. Requête codée à évaluer lors de l'exécution du modèle. Cette requête est évaluée sur la table Rapprocher les données de la tâche en double \[reconcile_duplicate_task_data\]. Toutes les tâches renvoyées par cette requête sont prises en compte lors de l'évaluation du modèle. Remarque : Même si une tâche est renvoyée dans le cadre de la requête, cela ne garantit pas que l'exécution du modèle traite la tâche. D'autres facteurs peuvent entraîner l'omission de la tâche pendant le traitement du modèle. Pour plus [d'informations, consultez Chaînes de requêtes codées](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) . |
[Tableau 3. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Sys_id du modèle créé dans la table Rapprocher les modèles en double \[reconcile_duplicate_template\]. |
[Tableau 4. Renvoie]

{#DupTemp-createTemplate_O__table_sl4_t5c_txb}  
L'exemple suivant montre comment créer un modèle de déduplication.

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

Sortie :

    8dfcd36e042b2510f877c1665753a485

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

Obtient l'objet de modèle.
{#DupTemp-getTemplate_S__table_rl4_t5c_txb__entry__3}{#DupTemp-getTemplate_S__ph_DupTemp-templateID}

| Nom | Type | Description |
|-|-|-|
| ID de modèle | Chaîne | Sys_id du modèle répertorié dans la table Rapprocher le modèle en double \[reconcile_duplicate_template\]. |
[Tableau 5. Paramètres]

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

| Type | Description |
|-|-|
| Objet | Objet de modèle avec différentes options de création du modèle. { "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 | Marqueur indiquant si les attributs de CI principaux sont mis à jour avec des valeurs nulles provenant de CI en double lors de la résolution de conflits d'attributs pour les CI dans le cadre d'une tâche de déduplication. Valeurs valides : * vrai : les attributs de CI principaux sont mis à jour avec les valeurs null des CI en double. * faux : les attributs de CI principal ne sont pas mis à jour avec les valeurs null des CI en double. {#DupTemp-getTemplate_S__ul_h4x_nhb_cyb} Type de données : booléennes |
| \<Object\>.allow_master_ci_ null_update | Inclut uniquement les mises à jour des CI en double si la valeur principale du CI est nulle. Valeurs valides : * vrai : n'incluez les mises à jour des CI en double que si la valeur principale du CI est nulle. * faux : inclure les mises à jour de tous les CI en double. {#DupTemp-getTemplate_S__ul_hmn_phb_cyb} Type de données : booléennes |
| \<Object\>.description | Description pour stocker plus d'informations sur le modèle. Type de données : chaîne |
| \<Object\>.duplicate_ ci_action | Spécifie si le CI en double doit être supprimé ou mis à jour avec des valeurs personnalisées uniques. Options possibles : * supprimer * Mettre à jour (nécessite d'être spécifié duplicate_ci_updates) {#DupTemp-getTemplate_S__ul_cby_1ng_5xb} Type de données : chaîne |
| \<Object\>.duplicate_ ci_updates | Tableau d'objets spécifiant comment les valeurs de CI en double sont mises à jour. [ { "element": "String", "element_label": "String", "value": "String", "display": "String" } ] Type de données : objet |
| \<Object\>.duplicateCIUpdates.element | Nom du dictionnaire système d'un champ de référence. Type de données : chaîne |
| \<Object\>.duplicateCIUpdates.element_label | Étiquette affichée dans le champ de référence. Type de données : chaîne |
| \<Object\>.duplicateCIUpdates.value | Valeur d'un champ de référence, c'est-à-dire le contenu du champ de référence. Type de données : chaîne |
| \<Object\>.duplicateCIUpdates.display | Valeur d'affichage d'un champ de référence. Type de données : chaîne |
| \<Object\>.master_ci_ option | Spécifie comment le CI principal est sélectionné pour une tâche de déduplication lors de l'application de ce modèle. Options possibles : * Conditionnel (doit préciser master_ci_condition) * most_related_items : attributs à fusionner à partir du CI avec le plus d'éléments connexes au CI principal. * most_relations : attributs à fusionner à partir du CI ayant le plus de relations avec le CI principal. * newest_created : attributs séparés à fusionner à partir de la dernière mise à jour du CI vers le CI principal. * oldest_created : attributs séparés par des virgules à fusionner du CI le plus ancien vers le CI principal. {#DupTemp-getTemplate_S__ul_hlj_wlg_5xb} Type de données : chaîne |
| \<Object\>.merge_relations | Spécifie comment les relations des CI en double au sein d'une tâche de déduplication sont fusionnées lors de l'application de ce modèle. Options possibles : * tous * conditionnel * aucun {#DupTemp-getTemplate_S__ul_shw_nmg_5xb} Type de données : chaîne |
| \<Object\>.merge_related_items | Spécifie les tables connexes des CI en double dans une tâche de déduplication qui sont fusionnées dans le CI principal lors de l'application de ce modèle. Voir aussi [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). Options possibles : * all_available : inclut les tables connexes par défaut et toutes les tables connexes qui font référence aux CI en double pour la tâche de déduplication corrigée via le modèle. * conditionnel * Par défaut : inclut les entrées connexes fournies par le module Éléments associés par défaut du correcteur de CI en double. * aucun {#DupTemp-getTemplate_S__ul_thg_vmg_5xb} Type de données : chaîne |
| \<Object\>.merge_related_items_ condition | Liste des entrées associées avec une requête codée pour chaque entrée associée. Chaque requête est évaluée sur le CI principal sélectionné pour la tâche. Si la requête renvoie vrai, les entrées connexes sont fusionnées lors du rattrapage d'une tâche de déduplication. Si la valeur est définie sur false, les entrées connexes ne sont pas fusionnées. Pour plus [d'informations, consultez Chaînes de requêtes codées](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} Type de données : tableau |
| \<Object\>.most_relations_ merge_attributes | Attributs séparés par des virgules à fusionner à partir du CI ayant le plus de relations avec le CI principal. Type de données : chaîne |
| \<Object\>.most_related_items_ merge_attributes | Attributs séparés par des virgules à fusionner à partir du CI avec le plus d'éléments associés au CI principal. Type de données : chaîne |
| \<Object\>.nom | Nom du modèle. Type de données : chaîne |
| \<Object\>.newest_updated_ merge_attributes | Attributs séparés par des virgules à fusionner du CI le plus récemment mis à jour vers le CI principal. Type de données : chaîne |
| \<Object\>.oldest_created_ merge_attributes | Attributs séparés par des virgules à fusionner du CI le plus ancien vers le CI principal. Type de données : chaîne |
| \<Object\>.table | Table pour laquelle le modèle est créé. Type de données : chaîne |
| \<Object\>.task_condition_table | Emplacement de la table Conditions de tâche, c'est-à-dire la table Rapprocher les données de la tâche en double \[reconcile_duplicate_task_data\]. La valeur ne change jamais et la table est destinée à une utilisation interne uniquement. Type de données : chaîne |
| \<Object\>.task_conditions | Requête codée à évaluer lors de l'exécution du modèle. Cette requête est évaluée sur la table Rapprocher les données de la tâche en double \[reconcile_duplicate_task_data\]. Toutes les tâches renvoyées par cette requête sont prises en compte lors de l'évaluation du modèle. Remarque : Même si une tâche est renvoyée dans le cadre de la requête, cela ne garantit pas que l'exécution du modèle traite la tâche. D'autres facteurs peuvent entraîner l'omission de la tâche pendant le traitement du modèle. Pour plus [d'informations, consultez Chaînes de requêtes codées](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) .{#DupTemp-getTemplate_S__d2804e105} Type de données : chaîne |
[Tableau 6. Renvoie]

{#DupTemp-getTemplate_S__table_sl4_t5c_txb}  
L'exemple suivant montre comment récupérer un modèle.

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

Sortie :

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

Génère un aperçu de la façon dont les différentes options de modèle ont été appliquées à la tâche de déduplication et de la façon dont elle doit être corrigée.
Cette méthode valide tous les attributs requis avant de générer l'aperçu de la tâche à l'aide du modèle. Les modèles peuvent être créés ou mis à jour sans spécifier les attributs requis. Les attributs requis doivent être fournis pour prévisualiser toute tâche de déduplication.  
Les attributs suivants sont requis :

* duplicate_ci_action
* master_ci_option
* merge_related_items
* merge_relations
* nom
* table
{#DupTemp-previewTemplate_S_S__ul_dmr_bbd_txb}  
Remarque :  
Bien que cette méthode valide tous les attributs, il n'est pas nécessaire que le modèle soit à l'état Publié pour un aperçu.

Utilisez la méthode [remediateTask()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-remediateTask_S_S "Corrige une tâche de déduplication à l’aide du modèle.") pour corriger les tâches de déduplication.
{#DupTemp-previewTemplate_S_S__table_rl4_t5c_txb__entry__3}{#DupTemp-previewTemplate_S_S__ph_DupTemp-templateID}{#DupTemp-previewTemplate_S_S__ph_DupTemp-taskID}

| Nom | Type | Description |
|-|-|-|
| ID de modèle | Chaîne | Sys_id du modèle répertorié dans la table Rapprocher le modèle en double \[reconcile_duplicate_template\]. |
| taskId | Chaîne | Sys_id de la tâche de déduplication répertoriée dans la table Tâches de correction des doublons \[reconcile_duplicate_task\]. |
[Tableau 7. Paramètres]

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

| Type | Description |
|-|-|
| Objet | Prévisualisez l'objet avec des valeurs montrant comment les tâches de déduplication peuvent être corrigées à l'aide du modèle. { "allClassCIMap": {Object}, "duplicateCIAction": "String", "duplicateCIUpdates": [Array], "masterCI": "String", "mergeRelations": Boolean, "relatedTablesMerged": [Array], "resolvedFieldCIMap": [Array], "taskId": "String", "tooManyDuplicates": Boolean } |
| \<Object\>.allClassCIMap | Liste des sys_ids de CI au sein d'une tâche de déduplication, regroupés par classe CI. Par exemple, cmdb_ci_computer. "allClassCIMap": { "<ci_class_name>": [ "<ci_sys_id_1>", "<ci_sys_id_2>" ] } Type de données : objet |
| \<Object\>.duplicateCIAction | Spécifie si le CI en double doit être supprimé ou mis à jour avec des valeurs personnalisées uniques. Options possibles : * supprimer * Mettre à jour (nécessite d'être spécifié duplicate_ci_updates) {#DupTemp-previewTemplate_S_S__ul_cby_1ng_5xb} Type de données : chaîne |
| \<Object\>.duplicateCIUpdates | Tableau d'objets spécifiant comment les valeurs de CI en double sont mises à jour. [ { "element": "String", "element_label": "String", "value": "String", "display": "String" } ] Type de données : tableau |
| \<Object\>.duplicateCIUpdates.element | Nom du dictionnaire système d'un champ de référence. Type de données : chaîne |
| \<Object\>.duplicateCIUpdates.element_label | Étiquette affichée dans le champ de référence. Type de données : chaîne |
| \<Object\>.duplicateCIUpdates.value | Valeur d'un champ de référence, c'est-à-dire le contenu du champ de référence. Type de données : chaîne |
| \<Object\>.duplicateCIUpdates.display | Valeur d'affichage d'un champ de référence. Type de données : chaîne |
| \<Object\>.masterCI | Sys_id du CI sélectionné comme CI principal. Type de données : chaîne |
| \<Object\>.mergeRelations | Spécifie comment les relations des CI en double au sein d'une tâche de déduplication sont fusionnées lors de l'application de ce modèle. Options possibles : * tous * conditionnel * aucun {#DupTemp-previewTemplate_S_S__ul_shw_nmg_5xb} Type de données : chaîne |
| \<Object\>.relatedTablesMerged | Spécifie les tables connexes des CI en double dans une tâche de déduplication qui sont fusionnées dans le CI principal lors de l'application de ce modèle. Voir aussi [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). Options possibles : * all_available : inclut les tables connexes par défaut et toutes les tables connexes qui font référence aux CI en double pour la tâche de déduplication corrigée via le modèle. * conditionnel * Par défaut : inclut les entrées connexes fournies par le module Éléments associés par défaut du correcteur de CI en double. * aucun {#DupTemp-previewTemplate_S_S__ul_thg_vmg_5xb} Type de données : tableau |
| \<Object\>.resolvedFieldCIMap | Tableau d'éléments à fusionner des doublons de CI vers le CI principal. "resolvedFieldCIMap": [ { "element": "String", "sys_id": "String" } ] Type de données : tableau |
| \<Object\>.resolvedFieldCIMap.élément | Nom de l'élément à fusionner d'un CI en double vers le CI principal. Type de données : chaîne |
| \<Object\>.resolvedFieldCIMap.sys_id | Sys_id de l'élément à fusionner d'un CI en double vers le CI principal. Type de données : chaîne |
| \<Object\>.taskId | Sys_id de la tâche de déduplication répertoriée dans la table Tâches de correction des doublons \[reconcile_duplicate_task\]. Type de données : chaîne |
| \<Object\>.tooManyDuplicates | Marqueur indiquant si la tâche a plus de CI que le nombre maximal. Le seuil est déterminé en comparant la valeur de la propriété système glide.duplicate_ci_ remediator.max.cis (valeur par défaut 1 000 CI). Valeurs valides : * vrai : le nombre de CI de la tâche dépasse le nombre maximal de CI. * faux : le nombre de CI de la tâche ne dépasse pas le nombre maximal de CI. {#DupTemp-previewTemplate_S_S__ul_bmc_1vl_5xb} Type de données : booléennes |
[Tableau 8. Renvoie]

{#DupTemp-previewTemplate_S_S__table_sl4_t5c_txb}  
L'exemple suivant montre comment obtenir un aperçu du rattrapage de déduplication pour un modèle spécifié.

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

Sortie :

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

Publie un modèle. En cas de réussite, le modèle passe de l'état Brouillon à l'état Publié.
Cette méthode valide tous les attributs requis avant de publier le modèle. Vous pouvez créer ou mettre à jour des modèles sans spécifier les attributs requis, mais les attributs doivent être fournis avant la publication d'un modèle.  
Les attributs suivants sont requis :

* duplicate_ci_action
* master_ci_option
* merge_related_items
* merge_relations
* nom
* table
{#DupTemp-publishTemplate_S__ul_dmr_bbd_txb}

À l'état Publié, vous pouvez exécuter le modèle à l'aide de la méthode [runTemplate().](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-runTemplate_S "Planifie une exécution de rattrapage pour un modèle de déduplication à l’état Publié. Un modèle peut être exécuté plusieurs fois, mais vous ne pouvez en planifier qu’une seule à la fois.")  
Voir aussi :

* [previewTemplate()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-previewTemplate_S_S "Génère un aperçu de la façon dont les différentes options de modèle ont été appliquées à la tâche de déduplication et de la façon dont elle doit être corrigée.")
* [unPublishTemplate()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-unPublishTemplate_S "Annule la publication d’un modèle.")
* [updateTemplate()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-updateTemplate_S_O "Met à jour un modèle de déduplication à l’état brouillon.")
{#DupTemp-publishTemplate_S__ul_y4f_sw1_xxb}
{#DupTemp-publishTemplate_S__table_rl4_t5c_txb__entry__3}{#DupTemp-publishTemplate_S__ph_DupTemp-templateID}

| Nom | Type | Description |
|-|-|-|
| ID de modèle | Chaîne | Sys_id du modèle répertorié dans la table Rapprocher le modèle en double \[reconcile_duplicate_template\]. |
[Tableau 9. Paramètres]

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

| Type | Description |
|-|-|
| Booléen | Marqueur indiquant si le modèle a été publié. Valeurs valides : * true : le modèle a été publié. * false : le modèle n'a pas été publié. {#DupTemp-publishTemplate_S__ul_qks_v5c_txb} |
[Tableau 10. Renvoie]

{#DupTemp-publishTemplate_S__table_sl4_t5c_txb}  
L'exemple suivant montre comment publier un modèle et afficher des résultats.

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

Sortie :

    true

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

Corrige une tâche de déduplication à l'aide du modèle.
Si le modèle n'est pas à l'état Publié, il ne peut pas être exécuté et la méthode lève une exception.

Utilisez la méthode [previewTemplate()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-previewTemplate_S_S "Génère un aperçu de la façon dont les différentes options de modèle ont été appliquées à la tâche de déduplication et de la façon dont elle doit être corrigée.") pour prévisualiser la façon dont les tâches de déduplication doivent être corrigées.  
Voir aussi.

* [Duplicate CIs remediation](https://www.servicenow.com/docs/access?context=de-duplication-tasks&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)
* [publishTemplate()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-publishTemplate_S "Publie un modèle. En cas de réussite, le modèle passe de l’état Brouillon à l’état Publié.")
* [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}

| Nom | Type | Description |
|-|-|-|
| ID de modèle | Chaîne | Sys_id du modèle répertorié dans la table Rapprocher le modèle en double \[reconcile_duplicate_template\]. |
| taskId | Chaîne | Sys_id de la tâche de déduplication répertoriée dans la table Tâches de correction des doublons \[reconcile_duplicate_task\]. |
[Tableau 11. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | En cas de réussite, l'ID de résolution de fusion pour le rattrapage de la tâche de déduplication. Cette résolution de fusion ID le sys_id d'un enregistrement dans la table Rattrapage de CI en double \[cmdb_duplicate_ci_remediation\]. En cas d'échec, le modèle n'est peut-être pas à l'état Publié. |
[Tableau 12. Renvoie]

{#DupTemp-remediateTask_S_S__table_sl4_t5c_txb}  
L'exemple suivant montre comment corriger une tâche de déduplication.

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

Sortie :

    <merge_resolution_id>

## DuplicateTemplate : requestCancellation(String templateRunId) {#ariaid-title8}

Annule une exécution de modèle existante.
Une demande d'annulation ne peut être effectuée que pour une exécution de modèle si elle est à l'état Brouillon, Prêt ou En cours d'exécution.

Après une demande d'annulation d'exécution de modèle, l'état d'exécution du modèle passe à l'étape intermédiaire Annulation demandée.

L'exécution de cette méthode n'annule pas automatiquement les exécutions de modèles à l'état Prêt ou Brouillon. L'état d'exécution du modèle ne passe pas à Annulé tant que toutes les tâches en cours d'exécution ne sont pas terminées. À ce stade, toutes les tâches restantes préparées pour le rattrapage passent de l'état Annulé demandé à l'état Annulé.  
Voir aussi :

* [publishTemplate()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-publishTemplate_S "Publie un modèle. En cas de réussite, le modèle passe de l’état Brouillon à l’état Publié.")
* [runTemplate()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-runTemplate_S "Planifie une exécution de rattrapage pour un modèle de déduplication à l’état Publié. Un modèle peut être exécuté plusieurs fois, mais vous ne pouvez en planifier qu’une seule à la fois.")
* [retireTemplate()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-retireTemplate_S "Met un modèle hors service.")
{#DupTemp-requestCancellation_S__ul_jkx_snz_5xb}
{#DupTemp-requestCancellation_S__table_rl4_t5c_txb__entry__3}

| Nom | Type | Description |
|-|-|-|
| ID modèle | Chaîne | Sys_id d'exécution du modèle répertoriée dans la table Exécution du modèle de déduplication \[reconcile_duplicate_template_run\]. |
[Tableau 13. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Marqueur indiquant si la demande d'annulation a abouti. Valeurs valides : * true : la demande d'annulation a abouti. * false : échec de la demande d'annulation. {#DupTemp-requestCancellation_S__ul_qks_v5c_txb} |
[Tableau 14. Renvoie]

{#DupTemp-requestCancellation_S__table_sl4_t5c_txb}  
L'exemple suivant montre comment annuler l'exécution d'un modèle et afficher si l'opération réussit.

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

Sortie :

    true

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

Met un modèle hors service.
Utilisez cette méthode pour passer un modèle à l'état de mise hors service s'il n'est plus nécessaire.  
Le modèle ne peut pas être mis hors service et la méthode lève une exception dans les conditions suivantes :

* Le modèle est à l'état Publié.
* Le modèle est en cours d'exécution ou doit s'exécuter.
{#DupTemp-retireTemplate_S__ul_w51_czw_cyb}  
Voir aussi :

* [publishTemplate()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-publishTemplate_S "Publie un modèle. En cas de réussite, le modèle passe de l’état Brouillon à l’état Publié.")
* [runTemplate()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-runTemplate_S "Planifie une exécution de rattrapage pour un modèle de déduplication à l’état Publié. Un modèle peut être exécuté plusieurs fois, mais vous ne pouvez en planifier qu’une seule à la fois.")
* [requestCancellation()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-requestCancellation_S "Annule une exécution de modèle existante.")
* [DuplicateTemplate : unPublishTemplate(String templateId)](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-unPublishTemplate_S "Annule la publication d’un modèle.")
{#DupTemp-retireTemplate_S__ul_jkx_snz_5xb}
{#DupTemp-retireTemplate_S__table_rl4_t5c_txb__entry__3}{#DupTemp-retireTemplate_S__ph_DupTemp-templateID}

| Nom | Type | Description |
|-|-|-|
| ID de modèle | Chaîne | Sys_id du modèle répertorié dans la table Rapprocher le modèle en double \[reconcile_duplicate_template\]. |
[Tableau 15. Paramètres]

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

| Type | Description |
|-|-|
| Booléen | Marqueur indiquant si le modèle est retiré. Valeurs valides : * true : le modèle est retiré. * faux : le modèle n'a pas pu être mis hors service, car il était en cours d'exécution, planifié pour être exécuté ou à l'état publié {#DupTemp-retireTemplate_S__ul_qks_v5c_txb} |
[Tableau 16. Renvoie]

{#DupTemp-retireTemplate_S__table_sl4_t5c_txb}  
L'exemple suivant montre comment mettre hors service un modèle et afficher des résultats.

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

Sortie :

    true

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

Planifie une exécution de rattrapage pour un modèle de déduplication à l'état Publié. Un modèle peut être exécuté plusieurs fois, mais vous ne pouvez en planifier qu'une seule à la fois.
Si le modèle n'est pas à l'état Publié, il ne peut pas être exécuté et la méthode lève une exception. Utilisez la méthode [publishTemplate()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-publishTemplate_S "Publie un modèle. En cas de réussite, le modèle passe de l’état Brouillon à l’état Publié.") pour faire passer le modèle de l'état Brouillon à l'état Publié.

Pour annuler une tâche en cours d'exécution, utilisez la méthode [requestCancellation().](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-requestCancellation_S "Annule une exécution de modèle existante.")
{#DupTemp-runTemplate_S__table_rl4_t5c_txb__entry__3}{#DupTemp-runTemplate_S__ph_DupTemp-templateID}

| Nom | Type | Description |
|-|-|-|
| ID de modèle | Chaîne | Sys_id du modèle répertorié dans la table Rapprocher le modèle en double \[reconcile_duplicate_template\]. |
[Tableau 17. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Sys_id du modèle exécuté répertorié dans la table Exécution du modèle de déduplication \[reconcile_duplicate_template_run\]. En cas d'échec, le modèle n'est peut-être pas à l'état Publié. |
[Tableau 18. Renvoie]

{#DupTemp-runTemplate_S__table_sl4_t5c_txb}  
L'exemple suivant montre comment planifier une exécution pour un modèle de déduplication publié.

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

Sortie :

    487c67e2046b2510f877c1665753a4cc

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

Annule la publication d'un modèle.
Cette méthode fait passer le modèle de l'état Publié à l'état Brouillon, ce qui permet de mettre à jour le modèle. La publication du modèle ne peut pas être annulée s'il est en cours d'exécution ou si son exécution est planifiée.  
Voir aussi :

* [publishTemplate()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-publishTemplate_S "Publie un modèle. En cas de réussite, le modèle passe de l’état Brouillon à l’état Publié.")
* [requestCancellation()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-requestCancellation_S "Annule une exécution de modèle existante.")
* [updateTemplate()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-updateTemplate_S_O "Met à jour un modèle de déduplication à l’état brouillon.")
{#DupTemp-unPublishTemplate_S__ul_f5y_sv1_xxb}
{#DupTemp-unPublishTemplate_S__table_rl4_t5c_txb__entry__3}{#DupTemp-unPublishTemplate_S__ph_DupTemp-templateID}

| Nom | Type | Description |
|-|-|-|
| ID de modèle | Chaîne | Sys_id du modèle répertorié dans la table Rapprocher le modèle en double \[reconcile_duplicate_template\]. |
[Tableau 19. Paramètres]

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

| Type | Description |
|-|-|
| Booléen | Marqueur indiquant si la publication du modèle a bien été annulée. Valeurs valides : * vrai : la publication du modèle a été annulée avec succès. * false : la publication du modèle n'a pas été annulée avec succès. Le modèle peut être en cours d'exécution ou planifier son exécution. {#DupTemp-unPublishTemplate_S__ul_qks_v5c_txb} |
[Tableau 20. Renvoie]

{#DupTemp-unPublishTemplate_S__table_sl4_t5c_txb}  
L'exemple suivant montre comment annuler la publication d'un modèle et afficher les résultats.

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

Sortie :

    true

## DuplicateTemplate : updateTemplate(String templateId, modèle d'objet) {#ariaid-title12}

Met à jour un modèle de déduplication à l'état brouillon.
Voir aussi :

* [unPublishTemplate()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-unPublishTemplate_S "Annule la publication d’un modèle.")
* [canAddTasksToTemplate()](https://servicenow-prod.fluidtopics.net/OQymTbUUqukiulIhW8nn1A#DupTemp-canAddTasksToTemplate_A_S "Vérifie si la liste de tâches fournie peut être ajoutée à un modèle.")
{#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__d2830e464}{#DupTemp-updateTemplate_S_O__d2804e105}{#DupTemp-updateTemplate_S_O__ph_DupTemp-template-mrgRel-itms}{#DupTemp-updateTemplate_S_O__d2804e105}{#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__d2804e105}

| Nom | Type | Description |
|-|-|-|
| ID de modèle | Chaîne | Sys_id du modèle répertorié dans la table Rapprocher le modèle en double \[reconcile_duplicate_template\]. |
| modèle | Objet | Objet de modèle avec différentes options de création du modèle. { "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 | Booléen | Facultatif. Marqueur indiquant si les attributs de CI principaux sont mis à jour avec des valeurs nulles provenant de CI en double lors de la résolution de conflits d'attributs pour les CI dans le cadre d'une tâche de déduplication. Valeurs valides : * vrai : les attributs de CI principaux sont mis à jour avec les valeurs null des CI en double. * faux : les attributs de CI principal ne sont pas mis à jour avec les valeurs null des CI en double. {#DupTemp-updateTemplate_S_O__ul_h4x_nhb_cyb} Valeur par défaut : false |
| template.allow_master_ci_null_update | Booléen | Facultatif. Inclut uniquement les mises à jour des CI en double si la valeur principale du CI est nulle. Marqueur indiquant s'il faut inclure uniquement les mises à jour des CI en double si la valeur principale du CI est nulle. Valeurs valides : * vrai : n'incluez les mises à jour des CI en double que si la valeur principale du CI est nulle. * faux : inclure les mises à jour de tous les CI en double. {#DupTemp-updateTemplate_S_O__ul_hmn_phb_cyb} Valeur par défaut : false |
| modèle.description | Chaîne | Facultatif. Description pour stocker plus d'informations sur le modèle. |
| template.duplicate_ci_action | Chaîne | Facultatif. Spécifie si le CI en double doit être supprimé ou mis à jour avec des valeurs personnalisées uniques. Options possibles : * supprimer * Mettre à jour (nécessite d'être spécifié duplicate_ci_updates) {#DupTemp-updateTemplate_S_O__ul_cby_1ng_5xb} |
| template.duplicate_ci_updates | Tableau | Facultatif, sauf si le paramètre pour est <kbd class="ph userinput">Mettre à</kbd>duplicate_ci_action jour. Tableau d'objets spécifiant comment les valeurs de CI en double sont mises à jour. [ { "element": "String", "element_label": "String", "value": "String", "display": "String" } ] {#DupTemp-updateTemplate_S_O__codeb_DupTemp-template-dup-ci-upd} |
| template.duplicate_ci_updates.element | Chaîne | Nom du dictionnaire système d'un champ de référence. |
| template.duplicate_ci_updates.element_label | Chaîne | Étiquette affichée dans le champ de référence. |
| template.duplicate_ci_updates.valeur | Chaîne | Valeur d'un champ de référence, c'est-à-dire le contenu du champ de référence. |
| template.duplicate_ci_updates.display | Chaîne | Valeur d'affichage d'un champ de référence. |
| template.master_ci_option | Chaîne | Facultatif. Spécifie comment le CI principal est sélectionné pour une tâche de déduplication lors de l'application de ce modèle. Options possibles : * Conditionnel (doit préciser master_ci_condition) * most_related_items : attributs à fusionner à partir du CI avec le plus d'éléments connexes au CI principal. * most_relations : attributs à fusionner à partir du CI ayant le plus de relations avec le CI principal. * newest_created : attributs séparés à fusionner à partir de la dernière mise à jour du CI vers le CI principal. * oldest_created : attributs séparés par des virgules à fusionner du CI le plus ancien vers le CI principal. {#DupTemp-updateTemplate_S_O__ul_hlj_wlg_5xb} |
| template.master_ci_condition | Chaîne | Facultatif (obligatoire si la valeur de master_ci_option est <kbd class="ph userinput">conditionnelle</kbd>). Requête codée pour spécifier comment le CI principal est sélectionné. Si plusieurs CI ou aucun CI ne correspondent à la requête, la méthode sélectionne le CI le plus récemment mis à jour comme CI principal. La requête codée est évaluée pour la table de modèles. Cette table est identifiée dans la table propriété. Pour plus [d'informations, consultez Chaînes de requêtes codées](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) . |
| template.merge_relations | Chaîne | Facultatif. Spécifie comment les relations des CI en double au sein d'une tâche de déduplication sont fusionnées lors de l'application de ce modèle. Options possibles : * tous * conditionnel * aucun {#DupTemp-updateTemplate_S_O__ul_shw_nmg_5xb} |
| template.merge_relations | Chaîne | Facultatif. Spécifie comment les relations des CI en double au sein d'une tâche de déduplication sont fusionnées lors de l'application de ce modèle. Options possibles : * tous * conditionnel * aucun {#DupTemp-updateTemplate_S_O__d2830e469} |
| template.merge_relations_condition | Chaîne | Facultatif (obligatoire si la valeur de merge_relations est <kbd class="ph userinput">conditionnelle</kbd>). Requête codée pour spécifier si toutes les relations des CI en double sont fusionnées ou aucune. La requête est évaluée sur le CI principal sélectionné pour la tâche de déduplication. Si la requête renvoie vrai, toutes les relations sont fusionnées. Si la valeur est définie sur Faux, aucune relation n'est fusionnée. La requête codée est évaluée pour la table de modèles. Cette table est identifiée dans la table propriété. Pour plus [d'informations, consultez Chaînes de requêtes codées](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) . |
| template.merge_related_items | Chaîne | Facultatif. Spécifie les tables connexes des CI en double dans une tâche de déduplication qui sont fusionnées dans le CI principal lors de l'application de ce modèle. Voir aussi [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). Options possibles : * all_available : inclut les tables connexes par défaut et toutes les tables connexes qui font référence aux CI en double pour la tâche de déduplication corrigée via le modèle. * conditionnel * Par défaut : inclut les entrées connexes fournies par le module Éléments associés par défaut du correcteur de CI en double. * aucun {#DupTemp-updateTemplate_S_O__ul_thg_vmg_5xb} |
| template.merge_related_items_condition | Tableau | Facultatif. Liste des entrées associées avec une requête codée pour chaque entrée associée. Chaque requête est évaluée sur le CI principal sélectionné pour la tâche. Si la requête renvoie vrai, les entrées connexes sont fusionnées lors du rattrapage d'une tâche de déduplication. Si la valeur est définie sur false, les entrées connexes ne sont pas fusionnées. "merge_related_items_condition": [ { "related_entry": "String", "condition": "String" } ] {#DupTemp-updateTemplate_S_O__cb_DupTem-template-mrgRel-itmCnd} Pour plus [d'informations, consultez Chaînes de requêtes codées](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) . |
| template.most_relations_merge_attributes | Chaîne | Facultatif. Attributs séparés par des virgules à fusionner à partir du CI ayant le plus de relations avec le CI principal. |
| template.most_related_items_merge_attributes | Chaîne | Facultatif. Attributs séparés par des virgules à fusionner à partir du CI avec le plus d'éléments associés au CI principal. |
| template.name | Chaîne | Nom du modèle. |
| template.newest_updated_merge_attributes | Chaîne | Facultatif. Attributs séparés par des virgules à fusionner du CI le plus récemment mis à jour vers le CI principal. |
| template.oldest_created_merge_attributes | Chaîne | Facultatif. Attributs séparés par des virgules à fusionner du CI le plus ancien vers le CI principal. |
| modèle.table | Chaîne | Table pour laquelle le modèle est créé. |
| template.task_conditions | Chaîne | Facultatif. Requête codée à évaluer lors de l'exécution du modèle. Cette requête est évaluée sur la table Rapprocher les données de la tâche en double \[reconcile_duplicate_task_data\]. Toutes les tâches renvoyées par cette requête sont prises en compte lors de l'évaluation du modèle. Remarque : Même si une tâche est renvoyée dans le cadre de la requête, cela ne garantit pas que l'exécution du modèle traite la tâche. D'autres facteurs peuvent entraîner l'omission de la tâche pendant le traitement du modèle. Pour plus [d'informations, consultez Chaînes de requêtes codées](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) . |
[Tableau 21. Paramètres]

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

| Type | Description |
|-|-|
| Booléen | Marqueur indiquant si le modèle a été mis à jour. Valeurs valides : * true : le modèle a été mis à jour. * false : le modèle a été mis à jour. Le modèle n'est peut-être pas à l'état de brouillon (non publié). {#DupTemp-updateTemplate_S_O__ul_qks_v5c_txb} |
[Tableau 22. Renvoie]

{#DupTemp-updateTemplate_S_O__table_sl4_t5c_txb}  
L'exemple suivant montre comment mettre à jour plusieurs propriétés d'un modèle de déduplication existant.

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

Sortie :

    true