---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# DuplicateTemplate - スコープ指定

# DuplicateTemplate - スコープ指定 {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：48分

DuplicateTemplate API は、各メソッドに一連の検証を強制することで、ユーザーが重複排除テンプレートを操作するためのメソッドを提供します。

重複排除タスクの修正は、個別に処理する場合、望ましいよりも時間がかかる可能性があります。複製テンプレートを使用すると、一連の重複タスクをグループ化して一緒に実行できます。重複排除テンプレートを作成して使用するには、 DuplicateTemplate API を使用します。この API は `sn_cmdb` 名前空間で実行され、アクセスするには cmdb_dedup_admin ロールが必要です。

インスタンスは、識別および調整中に重複する構成アイテム (CI) を検出すると、重複 CI の各セットをレビューおよび修正のために重複排除タスクにグループ化します。重複排除タスクは、すべての重複 CI のリストを含む、重複に関する詳細を提供します。詳細については、「[Duplicate CIs remediation](https://www.servicenow.com/docs/access?context=de-duplication-tasks&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)」を参照してください。

関連項目：[IdentificationEngine - スコープ指定](https://servicenow-prod.fluidtopics.net/0raPRiAvbITTm71R1Fuqug#IdentificationEngineScopedAPI "IdentificationEngine API は、識別および調整フレームワークを使用して、構成管理データベース (CMDB)の更新時に許可されたデータソースからの情報のみを受け入れることで、重複する構成アイテム (CI) の作成を最小限に抑え、CI 属性を調整します。")

テンプレートライフサイクル
:
    1. [CreateTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-createTemplate_O "ドラフトステータスの重複排除テンプレートを作成します。") メソッドを使用して、ドラフト状況のテンプレートを作成します。  
       次の方法を使用して、テンプレートを取得または更新できます。
       * [getTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-getTemplate_S "テンプレートオブジェクトを取得します。")
       * [canAddTasksToTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-canAddTasksToTemplate_A_S "指定されたタスクのリストをテンプレートに追加できるかどうかを確認します。")
       * [updateTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-updateTemplate_S_O "ドラフトステータスの重複排除テンプレートを更新します。")
       {#DuplicateTemplateScopedAPI__ul_gd1_by1_cyb}
    2. [publishTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-publishTemplate_S "テンプレートを公開します。成功すると、テンプレートのステータスがドラフトから公開済みに移行します。") メソッドを使用して、テンプレートをドラフトから公開ステータスに移動します。  
       注:  
       [unPublishTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-unPublishTemplate_S "テンプレートを非公開にします。") メソッドを使用して、公開されたテンプレートをドラフトステータスに戻し、テンプレートを更新します。
    3. オプション。[CMDBDuplicateTemplateUtil](https://servicenow-prod.fluidtopics.net/7smWY~Koq7eXorQumbsEig#CMDBDuplicateTemplateUtilAPI "CMDBDuplicateTemplateUtil スクリプトインクルードは、重複排除テンプレートに対して重複排除タスクを追加または削除するためのメソッドを提供します。") スクリプトインクルードを使用して、タスクを追加または削除します。
    4. [runTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-runTemplate_S "公開済みステータスの重複排除テンプレートの修正実行をスケジュールします。テンプレートは複数回実行できますが、一度に 1 つの実行のみをスケジュールできます。") メソッドを使用してテンプレートを実行します。

       実行中のタスクをキャンセルするには、 [requestCancellation()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-requestCancellation_S "既存のテンプレートの実行をキャンセルします。") メソッドを使用します。
    5. テンプレートが不要になった場合は、 [retireTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-retireTemplate_S "テンプレートを廃止します。") メソッドを使用してテンプレートを廃止できます。
    {#DuplicateTemplateScopedAPI__ol_kmg_qx1_cyb}

テンプレートを使用した単一のタスクの修正
:   テンプレートを実行せずに単一のタスクを修正するために、重複排除タスクをプレビューして修正します。

    1. [previewTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-previewTemplate_S_S "さまざまなテンプレートオプションが重複排除タスクにどのように適用され、どのように修正されるかのプレビューを生成します。") メソッドを使用して、テンプレートを使用して単一タスクの修復をプレビューします。
    2. テンプレートを使用して重複排除タスクを修正するには [、remediateTask()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-remediateTask_S_S "テンプレートを使用して重複排除タスクを修正します。") メソッドを使用します。
    {#DuplicateTemplateScopedAPI__ol_es1_3nr_dyb}

## DuplicateTemplate:canAddTasksToTemplate(アレイ taskIds, 文字列 templatId) {#ariaid-title2}

指定されたタスクのリストをテンプレートに追加できるかどうかを確認します。
この方法を使用して、タスクがテンプレートに追加するのに適しているかどうかを判断します。たとえば、指定されたテンプレートはアプリケーションサーバー Tomcat に対して作成されていても、指定された重複排除タスクは Linux サーバーに対して作成される場合があります。これらのタスクには一致するテンプレートクラスがないため、テンプレートに追加できません。
{#DupTemp-canAddTasksToTemplate_A_S__table_rl4_t5c_txb__entry__3}{#DupTemp-canAddTasksToTemplate_A_S__ph_DupTemp-templateID}

| 名前 | タイプ | 説明 |
|-|-|-|
| taskIds | アレイ | テンプレートに追加する重複排除タスクのsys_idsのアレイ。 |
| template_id | 文字列 | 重複調整テンプレート \[reconcile_duplicate_template\] テーブルにリストされているテンプレートのSys_id。 |
[表 : 1. パラメーター]

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

| タイプ | 説明 |
|-|-|
| オブジェクト | 追加、スキップ、または失敗できるタスクを含む結果オブジェクト。 { "success": [ "<task_id_1>", "<task_id_2>", "<task_id_3>" ], "failed": [ "<task_id_4>" ], "skipped": [ "<task_id_5>" ] } |
| 失敗 | タスクがテンプレートと互換性があるかどうかの確認中にエラーが発生しました。「[Detecting duplicate CIs](https://www.servicenow.com/docs/access?context=id-detect-dup-ci&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)」も参照してください。 |
| スキップ | 一致するテンプレートクラスがないため、タスクに互換性がないため、タスクはスキップされました。 |
| 成功 | タスクがテンプレートクラスに一致するため、テンプレートに追加できます。 |
[表 : 2. 返される内容]

{#DupTemp-canAddTasksToTemplate_A_S__table_sl4_t5c_txb}  
次の例は、テンプレートに追加できるタスクを確認する方法を示しています。

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

出力:

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

## DuplicateTemplate:createTemplate(オブジェクトテンプレート) {#ariaid-title3}

ドラフトステータスの重複排除テンプレートを作成します。
{#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__d3715e461}{#DupTemp-createTemplate_O__d3091e102}{#DupTemp-createTemplate_O__ph_DupTemp-template-mrgRel-itms}{#DupTemp-createTemplate_O__d3091e102}{#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__d3091e102}

| 名前 | タイプ | 説明 |
|-|-|-|
| template | オブジェクト | テンプレートを作成するためのさまざまなオプションを持つテンプレートオブジェクト。 { "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 | ブーリアン | オプション。重複排除タスク内の CI の属性競合を解決するときに、メイン CI 属性が重複 CI の null 値で更新されるかどうかを示すフラグ。 有効な値： * true:メイン CI 属性が重複 CI の null 値で更新されます。 * false:メイン CI 属性は重複 CI の null 値で更新されません。 {#DupTemp-createTemplate_O__ul_h4x_nhb_cyb} デフォルト値：False |
| template.allow_master_ci_null_update | ブーリアン | オプション。メイン CI 値が null の場合にのみ、重複 CI からの更新が含まれます。 メイン CI 値が null の場合に重複 CI からの更新のみを含めるかどうかを示すフラグ。 有効な値： * true:メイン CI 値が null の場合にのみ、重複 CI からの更新を含めます。 * false:すべての重複 CI からの更新を含めます。 {#DupTemp-createTemplate_O__ul_hmn_phb_cyb} デフォルト値：False |
| template.description | 文字列 | オプション。テンプレートに関する詳細情報を保存するための説明。 |
| template.duplicate_ci_action | 文字列 | オプション。重複 CI を削除するか、一意のカスタム値で更新するかを指定します。 選択可能なオプション： * delete * 更新 ( duplicate_ci_updatesの指定が必要) {#DupTemp-createTemplate_O__ul_cby_1ng_5xb} |
| template.duplicate_ci_updates | アレイ | duplicate_ci_actionの設定が<kbd class="ph userinput">更新</kbd>されている場合を除き、オプションです。重複 CI 値の更新方法を指定するオブジェクトのアレイ。 [ { "element": "String", "element_label": "String", "value": "String", "display": "String" } ] {#DupTemp-createTemplate_O__codeb_DupTemp-template-dup-ci-upd} |
| template.duplicate_ci_updates.element | 文字列 | 参照フィールドのシステムディクショナリ名。 |
| template.duplicate_ci_updates.element_label | 文字列 | 参照フィールドに表示されるラベル。 |
| template.duplicate_ci_updates.value | 文字列 | 参照フィールドの値、つまり参照フィールドの内容。 |
| template.duplicate_ci_updates.display | 文字列 | 参照フィールドの表示値。 |
| template.master_ci_option | 文字列 | オプション。このテンプレートを適用するときに重複排除タスクに対してメイン CI を選択する方法を指定します。 選択可能なオプション： * 条件付き ( master_ci_condition の指定必須) * most_related_items -- メイン CI に最も関連性の高いアイテムを持つ CI から結合される属性。 * most_relations - メイン CI と最も関係が多い CI から結合される属性。 * newest_created:最後に更新された CI からメイン CI に結合される個別の属性。 * oldest_created:最も作成が古い CI からメイン CI に結合されるカンマ区切りの属性。 {#DupTemp-createTemplate_O__ul_hlj_wlg_5xb} |
| template.master_ci_条件 | 文字列 | オプション ( master_ci_option の値が <kbd class="ph userinput">条件付きの</kbd>場合は必須)。メイン CI の選択方法を指定するエンコードされたクエリ。クエリに一致する CI が複数ある場合、または CI がない場合、メソッドは最後に更新された CI をメイン CI として選択します。テンプレートテーブルに対してエンコードされたクエリが評価されます。このテーブルは table プロパティで識別されます。 詳細については、「 [エンコードされたクエリ文字列」](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) を参照してください。 |
| template.merge_relations | 文字列 | オプション。このテンプレートを適用するときに、重複排除タスク内の重複 CI の関係をどのように結合するかを指定します。 選択可能なオプション： * すべて * 条件付き * なし {#DupTemp-createTemplate_O__ul_shw_nmg_5xb} |
| template.merge_relations | 文字列 | オプション。このテンプレートを適用するときに、重複排除タスク内の重複 CI の関係をどのように結合するかを指定します。 選択可能なオプション： * すべて * 条件付き * なし {#DupTemp-createTemplate_O__d3715e466} |
| template.merge_relations_condition | 文字列 | オプション ( merge_relations の値が <kbd class="ph userinput">条件付きの</kbd>場合は必須)。重複 CI の関係をすべて結合するか、まったく結合しないかを指定するエンコードされたクエリ。クエリーは、重複排除タスク用に選択されたメイン CI で評価されます。クエリーが true を返す場合、すべての関係が結合されます。false の場合、関係は結合されません。 テンプレートテーブルに対してエンコードされたクエリが評価されます。このテーブルは table プロパティで識別されます。 詳細については、「 [エンコードされたクエリ文字列」](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) を参照してください。 |
| template.merge_related_items | 文字列 | オプション。このテンプレートを適用するときに、重複排除タスク内の重複 CI のどの関連テーブルをメイン CI に結合するかを指定します。「 [Remediate a de-duplication task (manual)](https://www.servicenow.com/docs/access?context=reconcile-dup-task&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)」も参照してください。 選択可能なオプション： * all_available - デフォルトの関連テーブルと、テンプレートによって修正された重複排除タスクの重複 CI を参照する関連テーブルが含まれます。 * 条件付き * default - \[重複 CI レメディエーターのデフォルト関連アイテム\] モジュールによって提供される関連エントリーが含まれます。 * なし {#DupTemp-createTemplate_O__ul_thg_vmg_5xb} |
| template.merge_related_items_condition | アレイ | オプション。各関連エントリのエンコードされたクエリを含む関連エントリのリスト。各クエリーは、タスクに対して選択されたメイン CI で評価されます。クエリーが true を返した場合、重複排除タスクの修正中に関連エントリーが結合されます。false の場合、関連エントリーは結合されません。 "merge_related_items_condition": [ { "related_entry": "String", "condition": "String" } ] {#DupTemp-createTemplate_O__cb_DupTem-template-mrgRel-itmCnd} 詳細については、「 [エンコードされたクエリ文字列」](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) を参照してください。 |
| template.most_relations_merge_attributes | 文字列 | オプション。メイン CI との関係が最も多い CI から結合されるカンマ区切りの属性。 |
| template.most_related_items_merge_attributes | 文字列 | オプション。メイン CI に最も関連性の高いアイテムを持つ CI から結合されるカンマ区切りの属性。 |
| template.name | 文字列 | テンプレートの名前。 |
| template.newest_updated_merge_attributes | 文字列 | オプション。最後に更新された CI からメイン CI に結合されるカンマ区切りの属性。 |
| template.oldest_created_merge_attributes | 文字列 | オプション。作成が最も古い CI からメイン CI に結合されるカンマ区切り属性。 |
| template.table | 文字列 | テンプレートが作成されるテーブル。 |
| template.task_conditions | 文字列 | オプション。テンプレートの実行時に評価されるエンコードされたクエリ。このクエリは、重複タスクデータを調整 \[reconcile_duplicate_task_data\] テーブルで評価されます。このクエリーから返されたすべてのタスクは、テンプレートの評価時に考慮されます。 注: タスクがクエリの一部として返された場合でも、テンプレートの実行でタスクが処理されることは保証されません。他の要因により、テンプレートの処理中にタスクがスキップされる可能性があります。 詳細については、「 [エンコードされたクエリ文字列」](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) を参照してください。 |
[表 : 3. パラメーター]

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

| タイプ | 説明 |
|-|-|
| 文字列 | 重複調整テンプレート \[reconcile_duplicate_template\] テーブルで作成されたテンプレートのSys_id。 |
[表 : 4. 返される内容]

{#DupTemp-createTemplate_O__table_sl4_t5c_txb}  
次の例は、重複排除テンプレートの作成方法を示しています。

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

出力:

    8dfcd36e042b2510f877c1665753a485

## DuplicateTemplate:getTemplate(文字列 templateId) {#ariaid-title4}

テンプレートオブジェクトを取得します。
{#DupTemp-getTemplate_S__table_rl4_t5c_txb__entry__3}{#DupTemp-getTemplate_S__ph_DupTemp-templateID}

| 名前 | タイプ | 説明 |
|-|-|-|
| template_id | 文字列 | 重複調整テンプレート \[reconcile_duplicate_template\] テーブルにリストされているテンプレートのSys_id。 |
[表 : 5. パラメーター]

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

| タイプ | 説明 |
|-|-|
| オブジェクト | テンプレートを作成するためのさまざまなオプションを持つテンプレートオブジェクト。 { "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 | 重複排除タスク内の CI の属性競合を解決するときに、メイン CI 属性が重複 CI の null 値で更新されるかどうかを示すフラグ。 有効な値： * true:メイン CI 属性が重複 CI の null 値で更新されます。 * false:メイン CI 属性は重複 CI の null 値で更新されません。 {#DupTemp-getTemplate_S__ul_h4x_nhb_cyb} データタイプ：ブーリアン |
| \<Object\>.allow_master_ci_ null_update | メイン CI 値が null の場合にのみ、重複 CI からの更新が含まれます。 有効な値： * true:メイン CI 値が null の場合にのみ、重複 CI からの更新を含めます。 * false:すべての重複 CI からの更新を含めます。 {#DupTemp-getTemplate_S__ul_hmn_phb_cyb} データタイプ：ブーリアン |
| \<Object\>.description | テンプレートに関する詳細情報を保存するための説明。 データタイプ：文字列 |
| \<Object\>.duplicate_ ci_action | 重複 CI を削除するか、一意のカスタム値で更新するかを指定します。 選択可能なオプション： * delete * 更新 ( duplicate_ci_updatesの指定が必要) {#DupTemp-getTemplate_S__ul_cby_1ng_5xb} データタイプ：文字列 |
| \<Object\>.duplicate_ ci_updates | 重複 CI 値の更新方法を指定するオブジェクトのアレイ。 [ { "element": "String", "element_label": "String", "value": "String", "display": "String" } ] データタイプ: オブジェクト |
| \<Object\>.duplicateCIUpdates.element | 参照フィールドのシステムディクショナリ名。 データタイプ：文字列 |
| \<Object\>.duplicateCIUpdates.element_label | 参照フィールドに表示されるラベル。 データタイプ：文字列 |
| \<Object\>.duplicateCIUpdates.value | 参照フィールドの値、つまり参照フィールドの内容。 データタイプ：文字列 |
| \<Object\>.duplicateCIUpdates.display | 参照フィールドの表示値。 データタイプ：文字列 |
| \<Object\>.master_ci_オプション | このテンプレートを適用するときに重複排除タスクに対してメイン CI を選択する方法を指定します。 選択可能なオプション： * 条件付き ( master_ci_condition の指定必須) * most_related_items -- メイン CI に最も関連性の高いアイテムを持つ CI から結合される属性。 * most_relations - メイン CI と最も関係が多い CI から結合される属性。 * newest_created:最後に更新された CI からメイン CI に結合される個別の属性。 * oldest_created:最も作成が古い CI からメイン CI に結合されるカンマ区切りの属性。 {#DupTemp-getTemplate_S__ul_hlj_wlg_5xb} データタイプ：文字列 |
| \<Object\>.merge_relations | このテンプレートを適用するときに、重複排除タスク内の重複 CI の関係をどのように結合するかを指定します。 選択可能なオプション： * すべて * 条件付き * なし {#DupTemp-getTemplate_S__ul_shw_nmg_5xb} データタイプ：文字列 |
| \<Object\>.merge_related_items | このテンプレートを適用するときに、重複排除タスク内の重複 CI のどの関連テーブルをメイン CI に結合するかを指定します。「 [Remediate a de-duplication task (manual)](https://www.servicenow.com/docs/access?context=reconcile-dup-task&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)」も参照してください。 選択可能なオプション： * all_available - デフォルトの関連テーブルと、テンプレートによって修正された重複排除タスクの重複 CI を参照する関連テーブルが含まれます。 * 条件付き * default - \[重複 CI レメディエーターのデフォルト関連アイテム\] モジュールによって提供される関連エントリーが含まれます。 * なし {#DupTemp-getTemplate_S__ul_thg_vmg_5xb} データタイプ：文字列 |
| \<Object\>.merge_related_items_条件 | 各関連エントリのエンコードされたクエリを含む関連エントリのリスト。各クエリーは、タスクに対して選択されたメイン CI で評価されます。クエリーが true を返した場合、重複排除タスクの修正中に関連エントリーが結合されます。false の場合、関連エントリーは結合されません。 詳細については、「 [エンコードされたクエリ文字列」](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) を参照してください。{#DupTemp-getTemplate_S__link_encoded_query_strings} データタイプ：アレイ |
| \<Object\>.most_relations_ merge_attributes | メイン CI との関係が最も多い CI から結合されるカンマ区切りの属性。 データタイプ：文字列 |
| \<Object\>.most_related_items_ merge_attributes | メイン CI に最も関連性の高いアイテムを持つ CI から結合されるカンマ区切りの属性。 データタイプ：文字列 |
| \<Object\>.name | テンプレートの名前。 データタイプ：文字列 |
| \<Object\>.newest_updated_ merge_attributes | 最後に更新された CI からメイン CI に結合されるカンマ区切りの属性。 データタイプ：文字列 |
| \<Object\>.oldest_created_ merge_attributes | 作成が最も古い CI からメイン CI に結合されるカンマ区切り属性。 データタイプ：文字列 |
| \<Object\>.table | テンプレートが作成されるテーブル。 データタイプ：文字列 |
| \<Object\>.task_condition_table | テーブルのタスク条件、つまり重複タスクデータを調整 \[reconcile_duplicate_task_data\] テーブルの場所。値は変更されず、テーブルは内部使用専用です。 データタイプ：文字列 |
| \<Object\>.task_conditions | テンプレートの実行時に評価されるエンコードされたクエリ。このクエリは、重複タスクデータを調整 \[reconcile_duplicate_task_data\] テーブルで評価されます。このクエリーから返されたすべてのタスクは、テンプレートの評価時に考慮されます。 注: タスクがクエリの一部として返された場合でも、テンプレートの実行でタスクが処理されることは保証されません。他の要因により、テンプレートの処理中にタスクがスキップされる可能性があります。 詳細については、「 [エンコードされたクエリ文字列」](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) を参照してください。{#DupTemp-getTemplate_S__d3091e102} データタイプ：文字列 |
[表 : 6. 返される内容]

{#DupTemp-getTemplate_S__table_sl4_t5c_txb}  
次の例は、テンプレートを取得する方法を示しています。

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

出力:

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

さまざまなテンプレートオプションが重複排除タスクにどのように適用され、どのように修正されるかのプレビューを生成します。
このメソッドは、テンプレートを使用してタスクのプレビューを生成する前に、必要なすべての属性を検証します。テンプレートは、必要な属性を指定せずに作成または更新できます。重複排除タスクをプレビューするために必要な属性を指定する必要があります。  
次の属性が必要です。

* duplicate_ci_action
* master_ci_option
* merge_related_items
* merge_relations
* name
* table
{#DupTemp-previewTemplate_S_S__ul_dmr_bbd_txb}  
注:  
この方法ではすべての属性が検証されますが、プレビューでテンプレートが公開済みステータスである必要はありません。

[remediateTask()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-remediateTask_S_S "テンプレートを使用して重複排除タスクを修正します。") メソッドを使用して重複排除タスクを修復します。
{#DupTemp-previewTemplate_S_S__table_rl4_t5c_txb__entry__3}{#DupTemp-previewTemplate_S_S__ph_DupTemp-templateID}{#DupTemp-previewTemplate_S_S__ph_DupTemp-taskID}

| 名前 | タイプ | 説明 |
|-|-|-|
| template_id | 文字列 | 重複調整テンプレート \[reconcile_duplicate_template\] テーブルにリストされているテンプレートのSys_id。 |
| taskId | 文字列 | 重複修復タスク \[reconcile_duplicate_task\] テーブルにリストされている重複排除タスクのSys_id。 |
[表 : 7. パラメーター]

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

| タイプ | 説明 |
|-|-|
| オブジェクト | テンプレートを使用して重複排除タスクを修正する方法を示す値を含むオブジェクトをプレビューします。 { "allClassCIMap": {Object}, "duplicateCIAction": "String", "duplicateCIUpdates": [Array], "masterCI": "String", "mergeRelations": Boolean, "relatedTablesMerged": [Array], "resolvedFieldCIMap": [Array], "taskId": "String", "tooManyDuplicates": Boolean } |
| \<Object\>.allClassCIMap | 重複排除タスク内の CI の sys_ids のリスト、 CI クラス別にグループ化されます。cmdb_ci_computer など。 "allClassCIMap": { "<ci_class_name>": [ "<ci_sys_id_1>", "<ci_sys_id_2>" ] } データタイプ: オブジェクト |
| \<Object\>.duplicateCIAction | 重複 CI を削除するか、一意のカスタム値で更新するかを指定します。 選択可能なオプション： * delete * 更新 ( duplicate_ci_updatesの指定が必要) {#DupTemp-previewTemplate_S_S__ul_cby_1ng_5xb} データタイプ：文字列 |
| \<Object\>.duplicateCIUpdates | 重複 CI 値の更新方法を指定するオブジェクトのアレイ。 [ { "element": "String", "element_label": "String", "value": "String", "display": "String" } ] データタイプ：アレイ |
| \<Object\>.duplicateCIUpdates.element | 参照フィールドのシステムディクショナリ名。 データタイプ：文字列 |
| \<Object\>.duplicateCIUpdates.element_label | 参照フィールドに表示されるラベル。 データタイプ：文字列 |
| \<Object\>.duplicateCIUpdates.value | 参照フィールドの値、つまり参照フィールドの内容。 データタイプ：文字列 |
| \<Object\>.duplicateCIUpdates.display | 参照フィールドの表示値。 データタイプ：文字列 |
| \<Object\>.masterCI | メイン CI として選択された CI のSys_id。 データタイプ：文字列 |
| \<Object\>.mergeRelations | このテンプレートを適用するときに、重複排除タスク内の重複 CI の関係をどのように結合するかを指定します。 選択可能なオプション： * すべて * 条件付き * なし {#DupTemp-previewTemplate_S_S__ul_shw_nmg_5xb} データタイプ：文字列 |
| \<Object\>.relatedTablesMerged | このテンプレートを適用するときに、重複排除タスク内の重複 CI のどの関連テーブルをメイン CI に結合するかを指定します。「 [Remediate a de-duplication task (manual)](https://www.servicenow.com/docs/access?context=reconcile-dup-task&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)」も参照してください。 選択可能なオプション： * all_available - デフォルトの関連テーブルと、テンプレートによって修正された重複排除タスクの重複 CI を参照する関連テーブルが含まれます。 * 条件付き * default - \[重複 CI レメディエーターのデフォルト関連アイテム\] モジュールによって提供される関連エントリーが含まれます。 * なし {#DupTemp-previewTemplate_S_S__ul_thg_vmg_5xb} データタイプ：アレイ |
| \<Object\>.resolvedFieldCIMap | 重複 CI からメイン CI に結合される要素のアレイ。 "resolvedFieldCIMap": [ { "element": "String", "sys_id": "String" } ] データタイプ：アレイ |
| \<Object\>.resolvedFieldCIMap。要素 | 重複 CI からメイン CI に結合される要素の名前。 データタイプ：文字列 |
| \<Object\>.resolvedFieldCIMap。sys_id | 重複 CI からメイン CI に結合される要素のSys_id。 データタイプ：文字列 |
| \<Object\>.taskId | 重複修復タスク \[reconcile_duplicate_task\] テーブルにリストされている重複排除タスクのSys_id。 データタイプ：文字列 |
| \<Object\>.tooManyDuplicates | タスクの CI が最大数を超えているかどうかを示すフラグ。しきい値は、システムプロパティ glide.duplicate_ci_ remediator.max.cis (デフォルト値:1000 CI) の値を比較することによって決定されます。 有効な値： * true:CI のタスク数が CI の最大数を超えています。 * false:CI のタスク数が CI の最大数を超えません。 {#DupTemp-previewTemplate_S_S__ul_bmc_1vl_5xb} データタイプ：ブーリアン |
[表 : 8. 返される内容]

{#DupTemp-previewTemplate_S_S__table_sl4_t5c_txb}  
次の例は、指定したテンプレートの重複排除修正のプレビューを取得する方法を示しています。

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

出力:

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

テンプレートを公開します。成功すると、テンプレートのステータスがドラフトから公開済みに移行します。
このメソッドは、テンプレートを公開する前に必要なすべての属性を検証します。必要な属性を指定せずにテンプレートを作成または更新できますが、テンプレートを公開する前に属性を指定する必要があります。  
次の属性が必要です。

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

公開済みステータスでは、 [runTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-runTemplate_S "公開済みステータスの重複排除テンプレートの修正実行をスケジュールします。テンプレートは複数回実行できますが、一度に 1 つの実行のみをスケジュールできます。") メソッドを使用してテンプレートを実行できます。  
関連項目：

* [previewTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-previewTemplate_S_S "さまざまなテンプレートオプションが重複排除タスクにどのように適用され、どのように修正されるかのプレビューを生成します。")
* [unPublishTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-unPublishTemplate_S "テンプレートを非公開にします。")
* [updateTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-updateTemplate_S_O "ドラフトステータスの重複排除テンプレートを更新します。")
{#DupTemp-publishTemplate_S__ul_y4f_sw1_xxb}
{#DupTemp-publishTemplate_S__table_rl4_t5c_txb__entry__3}{#DupTemp-publishTemplate_S__ph_DupTemp-templateID}

| 名前 | タイプ | 説明 |
|-|-|-|
| template_id | 文字列 | 重複調整テンプレート \[reconcile_duplicate_template\] テーブルにリストされているテンプレートのSys_id。 |
[表 : 9. パラメーター]

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

| タイプ | 説明 |
|-|-|
| ブーリアン | テンプレートが公開されたかどうかを示すフラグ。 有効な値： * true:テンプレートが公開されました。 * false:テンプレートは公開されませんでした。 {#DupTemp-publishTemplate_S__ul_qks_v5c_txb} |
[表 : 10. 返される内容]

{#DupTemp-publishTemplate_S__table_sl4_t5c_txb}  
次の例は、テンプレートを公開して結果を表示する方法を示しています。

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

出力:

    true

## DuplicateTemplate:remediateTask(文字列 templateId, 文字列 taskId) {#ariaid-title7}

テンプレートを使用して重複排除タスクを修正します。
テンプレートが公開済みステータスでない場合、テンプレートは実行できず、メソッドは例外をスローします。

[previewTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-previewTemplate_S_S "さまざまなテンプレートオプションが重複排除タスクにどのように適用され、どのように修正されるかのプレビューを生成します。") メソッドを使用して、重複排除タスクの修復方法をプレビューします。  
関連項目。

* [Duplicate CIs remediation](https://www.servicenow.com/docs/access?context=de-duplication-tasks&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)
* [publishTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-publishTemplate_S "テンプレートを公開します。成功すると、テンプレートのステータスがドラフトから公開済みに移行します。")
* [Remediate a de-duplication task (manual)](https://www.servicenow.com/docs/access?context=reconcile-dup-task&version=australia&pubname=australia-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}

| 名前 | タイプ | 説明 |
|-|-|-|
| template_id | 文字列 | 重複調整テンプレート \[reconcile_duplicate_template\] テーブルにリストされているテンプレートのSys_id。 |
| taskId | 文字列 | 重複修復タスク \[reconcile_duplicate_task\] テーブルにリストされている重複排除タスクのSys_id。 |
[表 : 11. パラメーター]

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

| タイプ | 説明 |
|-|-|
| 文字列 | 成功した場合、重複排除タスク修正の結合解決 ID。この結合解決 ID は、重複 CI 修正 \[cmdb_duplicate_ci_remediation\] テーブル内のレコードのsys_idです。失敗した場合、テンプレートは公開済みステータスではない可能性があります。 |
[表 : 12. 返される内容]

{#DupTemp-remediateTask_S_S__table_sl4_t5c_txb}  
次の例は、重複排除タスクを修復する方法を示しています。

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

出力:

    <merge_resolution_id>

## DuplicateTemplate:requestCancellation(文字列 templateRunId) {#ariaid-title8}

既存のテンプレートの実行をキャンセルします。
キャンセル要求は、ドラフト、準備完了、または実行中ステータスのテンプレート実行に対してのみ行うことができます。

テンプレート実行のキャンセル要求の後、テンプレートの実行ステータスは中間ステージの \[キャンセル要求済み (Cancel Requested)\] に変更されます。

このメソッドを実行しても、\[準備完了\] または \[ドラフト\] ステータスのテンプレートの実行は自動的にキャンセルされません。実行中のタスクが完了するまで、テンプレートの実行状況は \[キャンセル\] に変更されません。その時点で、修復のためにステージングされた残りのタスクはすべて \[キャンセル要求\] から \[キャンセル\] に変更されます。  
関連項目：

* [publishTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-publishTemplate_S "テンプレートを公開します。成功すると、テンプレートのステータスがドラフトから公開済みに移行します。")
* [runTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-runTemplate_S "公開済みステータスの重複排除テンプレートの修正実行をスケジュールします。テンプレートは複数回実行できますが、一度に 1 つの実行のみをスケジュールできます。")
* [retireTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-retireTemplate_S "テンプレートを廃止します。")
{#DupTemp-requestCancellation_S__ul_jkx_snz_5xb}
{#DupTemp-requestCancellation_S__table_rl4_t5c_txb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| テンプレート RunId | 文字列 | 重複排除テンプレート実行 \[reconcile_duplicate_template_run\] テーブルにリストされているテンプレート実行のSys_id。 |
[表 : 13. パラメーター]

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

| タイプ | 説明 |
|-|-|
| 文字列 | キャンセル要求が成功したかどうかを示すフラグ。 有効な値： * true:キャンセル要求は成功しました。 * false:キャンセル要求は成功しませんでした。 {#DupTemp-requestCancellation_S__ul_qks_v5c_txb} |
[表 : 14. 返される内容]

{#DupTemp-requestCancellation_S__table_sl4_t5c_txb}  
次の例は、テンプレートの実行をキャンセルし、操作が成功したかどうかを表示する方法を示しています。

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

出力:

    true

## DuplicateTemplate:retireTemplate(文字列 templateId) {#ariaid-title9}

テンプレートを廃止します。
テンプレートが不要になった場合に、この方法を使用して廃止ステータスに移行します。  
テンプレートを廃止することはできず、メソッドは次の条件で例外をスローします。

* テンプレートは公開済みステータスです。
* テンプレートが実行中か、実行がスケジュールされています。
{#DupTemp-retireTemplate_S__ul_w51_czw_cyb}  
関連項目：

* [publishTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-publishTemplate_S "テンプレートを公開します。成功すると、テンプレートのステータスがドラフトから公開済みに移行します。")
* [runTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-runTemplate_S "公開済みステータスの重複排除テンプレートの修正実行をスケジュールします。テンプレートは複数回実行できますが、一度に 1 つの実行のみをスケジュールできます。")
* [requestCancellation()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-requestCancellation_S "既存のテンプレートの実行をキャンセルします。")
* [DuplicateTemplate:unPublishTemplate(文字列 templateId)](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-unPublishTemplate_S "テンプレートを非公開にします。")
{#DupTemp-retireTemplate_S__ul_jkx_snz_5xb}
{#DupTemp-retireTemplate_S__table_rl4_t5c_txb__entry__3}{#DupTemp-retireTemplate_S__ph_DupTemp-templateID}

| 名前 | タイプ | 説明 |
|-|-|-|
| template_id | 文字列 | 重複調整テンプレート \[reconcile_duplicate_template\] テーブルにリストされているテンプレートのSys_id。 |
[表 : 15. パラメーター]

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

| タイプ | 説明 |
|-|-|
| ブーリアン | テンプレートが廃止されたかどうかを示すフラグ。 有効な値： * true:テンプレートは廃止されています。 * false:テンプレートが実行中であるか、実行するようにスケジュールされているか、または公開済みステータスであるため、テンプレートを廃止できませんでした {#DupTemp-retireTemplate_S__ul_qks_v5c_txb} |
[表 : 16. 返される内容]

{#DupTemp-retireTemplate_S__table_sl4_t5c_txb}  
次の例は、テンプレートを廃止して結果を表示する方法を示しています。

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

出力:

    true

## DuplicateTemplate:runTemplate(文字列 templateId) {#ariaid-title10}

公開済みステータスの重複排除テンプレートの修正実行をスケジュールします。テンプレートは複数回実行できますが、一度に 1 つの実行のみをスケジュールできます。
テンプレートが公開済みステータスでない場合、テンプレートは実行できず、メソッドは例外をスローします。 [publishTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-publishTemplate_S "テンプレートを公開します。成功すると、テンプレートのステータスがドラフトから公開済みに移行します。") メソッドを使用して、テンプレートをドラフトから公開ステータスに移動します。

実行中のタスクをキャンセルするには、 [requestCancellation()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-requestCancellation_S "既存のテンプレートの実行をキャンセルします。") メソッドを使用します。
{#DupTemp-runTemplate_S__table_rl4_t5c_txb__entry__3}{#DupTemp-runTemplate_S__ph_DupTemp-templateID}

| 名前 | タイプ | 説明 |
|-|-|-|
| template_id | 文字列 | 重複調整テンプレート \[reconcile_duplicate_template\] テーブルにリストされているテンプレートのSys_id。 |
[表 : 17. パラメーター]

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

| タイプ | 説明 |
|-|-|
| 文字列 | 重複排除テンプレート実行 \[reconcile_duplicate_template_run\] テーブルにリストされている、実行されたテンプレートのSys_id。失敗した場合、テンプレートは公開済みステータスではない可能性があります。 |
[表 : 18. 返される内容]

{#DupTemp-runTemplate_S__table_sl4_t5c_txb}  
次の例は、公開済みの重複排除テンプレートの実行をスケジュールする方法を示しています。

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

出力:

    487c67e2046b2510f877c1665753a4cc

## DuplicateTemplate:unPublishTemplate(文字列 templateId) {#ariaid-title11}

テンプレートを非公開にします。
この方法では、テンプレートが公開済みステータスからドラフトステータスに移行し、テンプレートを更新できるようになります。テンプレートが実行中または実行がスケジュールされている場合、テンプレートを非公開にすることはできません。  
関連項目：

* [publishTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-publishTemplate_S "テンプレートを公開します。成功すると、テンプレートのステータスがドラフトから公開済みに移行します。")
* [requestCancellation()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-requestCancellation_S "既存のテンプレートの実行をキャンセルします。")
* [updateTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-updateTemplate_S_O "ドラフトステータスの重複排除テンプレートを更新します。")
{#DupTemp-unPublishTemplate_S__ul_f5y_sv1_xxb}
{#DupTemp-unPublishTemplate_S__table_rl4_t5c_txb__entry__3}{#DupTemp-unPublishTemplate_S__ph_DupTemp-templateID}

| 名前 | タイプ | 説明 |
|-|-|-|
| template_id | 文字列 | 重複調整テンプレート \[reconcile_duplicate_template\] テーブルにリストされているテンプレートのSys_id。 |
[表 : 19. パラメーター]

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

| タイプ | 説明 |
|-|-|
| ブーリアン | テンプレートが正常に非公開になったかどうかを示すフラグ。 有効な値： * true:テンプレートは正常に非公開になりました。 * false:テンプレートは正常に非公開にされませんでした。テンプレートが実行中であるか、実行されるようにスケジュールされている可能性があります。 {#DupTemp-unPublishTemplate_S__ul_qks_v5c_txb} |
[表 : 20. 返される内容]

{#DupTemp-unPublishTemplate_S__table_sl4_t5c_txb}  
次の例は、テンプレートを非公開にして結果を表示する方法を示しています。

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

出力:

    true

## DuplicateTemplate - updateTemplate(文字列 templateId, オブジェクトテンプレート) {#ariaid-title12}

ドラフトステータスの重複排除テンプレートを更新します。
関連項目：

* [unPublishTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-unPublishTemplate_S "テンプレートを非公開にします。")
* [canAddTasksToTemplate()](https://servicenow-prod.fluidtopics.net/NU5YBnetR999DIqdjEYtFg#DupTemp-canAddTasksToTemplate_A_S "指定されたタスクのリストをテンプレートに追加できるかどうかを確認します。")
{#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__d3715e461}{#DupTemp-updateTemplate_S_O__d3091e102}{#DupTemp-updateTemplate_S_O__ph_DupTemp-template-mrgRel-itms}{#DupTemp-updateTemplate_S_O__d3091e102}{#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__d3091e102}

| 名前 | タイプ | 説明 |
|-|-|-|
| template_id | 文字列 | 重複調整テンプレート \[reconcile_duplicate_template\] テーブルにリストされているテンプレートのSys_id。 |
| template | オブジェクト | テンプレートを作成するためのさまざまなオプションを持つテンプレートオブジェクト。 { "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 | ブーリアン | オプション。重複排除タスク内の CI の属性競合を解決するときに、メイン CI 属性が重複 CI の null 値で更新されるかどうかを示すフラグ。 有効な値： * true:メイン CI 属性が重複 CI の null 値で更新されます。 * false:メイン CI 属性は重複 CI の null 値で更新されません。 {#DupTemp-updateTemplate_S_O__ul_h4x_nhb_cyb} デフォルト値：False |
| template.allow_master_ci_null_update | ブーリアン | オプション。メイン CI 値が null の場合にのみ、重複 CI からの更新が含まれます。 メイン CI 値が null の場合に重複 CI からの更新のみを含めるかどうかを示すフラグ。 有効な値： * true:メイン CI 値が null の場合にのみ、重複 CI からの更新を含めます。 * false:すべての重複 CI からの更新を含めます。 {#DupTemp-updateTemplate_S_O__ul_hmn_phb_cyb} デフォルト値：False |
| template.description | 文字列 | オプション。テンプレートに関する詳細情報を保存するための説明。 |
| template.duplicate_ci_action | 文字列 | オプション。重複 CI を削除するか、一意のカスタム値で更新するかを指定します。 選択可能なオプション： * delete * 更新 ( duplicate_ci_updatesの指定が必要) {#DupTemp-updateTemplate_S_O__ul_cby_1ng_5xb} |
| template.duplicate_ci_updates | アレイ | duplicate_ci_actionの設定が<kbd class="ph userinput">更新</kbd>されている場合を除き、オプションです。重複 CI 値の更新方法を指定するオブジェクトのアレイ。 [ { "element": "String", "element_label": "String", "value": "String", "display": "String" } ] {#DupTemp-updateTemplate_S_O__codeb_DupTemp-template-dup-ci-upd} |
| template.duplicate_ci_updates.element | 文字列 | 参照フィールドのシステムディクショナリ名。 |
| template.duplicate_ci_updates.element_label | 文字列 | 参照フィールドに表示されるラベル。 |
| template.duplicate_ci_updates.value | 文字列 | 参照フィールドの値、つまり参照フィールドの内容。 |
| template.duplicate_ci_updates.display | 文字列 | 参照フィールドの表示値。 |
| template.master_ci_option | 文字列 | オプション。このテンプレートを適用するときに重複排除タスクに対してメイン CI を選択する方法を指定します。 選択可能なオプション： * 条件付き ( master_ci_condition の指定必須) * most_related_items -- メイン CI に最も関連性の高いアイテムを持つ CI から結合される属性。 * most_relations - メイン CI と最も関係が多い CI から結合される属性。 * newest_created:最後に更新された CI からメイン CI に結合される個別の属性。 * oldest_created:最も作成が古い CI からメイン CI に結合されるカンマ区切りの属性。 {#DupTemp-updateTemplate_S_O__ul_hlj_wlg_5xb} |
| template.master_ci_条件 | 文字列 | オプション ( master_ci_option の値が <kbd class="ph userinput">条件付きの</kbd>場合は必須)。メイン CI の選択方法を指定するエンコードされたクエリ。クエリに一致する CI が複数ある場合、または CI がない場合、メソッドは最後に更新された CI をメイン CI として選択します。テンプレートテーブルに対してエンコードされたクエリが評価されます。このテーブルは table プロパティで識別されます。 詳細については、「 [エンコードされたクエリ文字列」](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) を参照してください。 |
| template.merge_relations | 文字列 | オプション。このテンプレートを適用するときに、重複排除タスク内の重複 CI の関係をどのように結合するかを指定します。 選択可能なオプション： * すべて * 条件付き * なし {#DupTemp-updateTemplate_S_O__ul_shw_nmg_5xb} |
| template.merge_relations | 文字列 | オプション。このテンプレートを適用するときに、重複排除タスク内の重複 CI の関係をどのように結合するかを指定します。 選択可能なオプション： * すべて * 条件付き * なし {#DupTemp-updateTemplate_S_O__d3715e466} |
| template.merge_relations_condition | 文字列 | オプション ( merge_relations の値が <kbd class="ph userinput">条件付きの</kbd>場合は必須)。重複 CI の関係をすべて結合するか、まったく結合しないかを指定するエンコードされたクエリ。クエリーは、重複排除タスク用に選択されたメイン CI で評価されます。クエリーが true を返す場合、すべての関係が結合されます。false の場合、関係は結合されません。 テンプレートテーブルに対してエンコードされたクエリが評価されます。このテーブルは table プロパティで識別されます。 詳細については、「 [エンコードされたクエリ文字列」](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) を参照してください。 |
| template.merge_related_items | 文字列 | オプション。このテンプレートを適用するときに、重複排除タスク内の重複 CI のどの関連テーブルをメイン CI に結合するかを指定します。「 [Remediate a de-duplication task (manual)](https://www.servicenow.com/docs/access?context=reconcile-dup-task&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)」も参照してください。 選択可能なオプション： * all_available - デフォルトの関連テーブルと、テンプレートによって修正された重複排除タスクの重複 CI を参照する関連テーブルが含まれます。 * 条件付き * default - \[重複 CI レメディエーターのデフォルト関連アイテム\] モジュールによって提供される関連エントリーが含まれます。 * なし {#DupTemp-updateTemplate_S_O__ul_thg_vmg_5xb} |
| template.merge_related_items_condition | アレイ | オプション。各関連エントリのエンコードされたクエリを含む関連エントリのリスト。各クエリーは、タスクに対して選択されたメイン CI で評価されます。クエリーが true を返した場合、重複排除タスクの修正中に関連エントリーが結合されます。false の場合、関連エントリーは結合されません。 "merge_related_items_condition": [ { "related_entry": "String", "condition": "String" } ] {#DupTemp-updateTemplate_S_O__cb_DupTem-template-mrgRel-itmCnd} 詳細については、「 [エンコードされたクエリ文字列」](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) を参照してください。 |
| template.most_relations_merge_attributes | 文字列 | オプション。メイン CI との関係が最も多い CI から結合されるカンマ区切りの属性。 |
| template.most_related_items_merge_attributes | 文字列 | オプション。メイン CI に最も関連性の高いアイテムを持つ CI から結合されるカンマ区切りの属性。 |
| template.name | 文字列 | テンプレートの名前。 |
| template.newest_updated_merge_attributes | 文字列 | オプション。最後に更新された CI からメイン CI に結合されるカンマ区切りの属性。 |
| template.oldest_created_merge_attributes | 文字列 | オプション。作成が最も古い CI からメイン CI に結合されるカンマ区切り属性。 |
| template.table | 文字列 | テンプレートが作成されるテーブル。 |
| template.task_conditions | 文字列 | オプション。テンプレートの実行時に評価されるエンコードされたクエリ。このクエリは、重複タスクデータを調整 \[reconcile_duplicate_task_data\] テーブルで評価されます。このクエリーから返されたすべてのタスクは、テンプレートの評価時に考慮されます。 注: タスクがクエリの一部として返された場合でも、テンプレートの実行でタスクが処理されることは保証されません。他の要因により、テンプレートの処理中にタスクがスキップされる可能性があります。 詳細については、「 [エンコードされたクエリ文字列」](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) を参照してください。 |
[表 : 21. パラメーター]

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

| タイプ | 説明 |
|-|-|
| ブーリアン | テンプレートが更新されたかどうかを示すフラグ。 有効な値： * true:テンプレートが更新されました。 * false:テンプレートが更新されました。テンプレートがドラフト (未公開) ステータスではない可能性があります。 {#DupTemp-updateTemplate_S_O__ul_qks_v5c_txb} |
[表 : 22. 返される内容]

{#DupTemp-updateTemplate_S_O__table_sl4_t5c_txb}  
次の例は、既存の重複排除テンプレートのいくつかのプロパティを更新する方法を示しています。

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

出力:

    true