DuplicateTemplate – Scoped

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 23 Minuten Lesedauer

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

    Die Korrektur von Deduplizierungsaufgaben kann zeitaufwändiger sein, wenn sie einzeln behandelt wird. Duplizierungsvorlagen ermöglichen es, einen Satz doppelter Aufgaben zu gruppieren und zusammen auszuführen. Verwenden Sie die DuplicateTemplate -API, um Deduplizierungsvorlagen zu erstellen und zu verwenden. Diese API wird im Namespace sn_cmdb ausgeführt und erfordert für den Zugriff die Rolle cmdb_dedup_admin.

    Wenn eine Instanz während der Identifizierung und des Abgleichs doppelte Konfigurationselemente (CIs) erkennt, gruppiert sie jeden Satz doppelter CIs in einer Deduplizierungsaufgabe zur Überprüfung und Korrektur. Deduplizierungsaufgaben enthalten Details zur Duplizierung, einschließlich einer Liste aller doppelten CIs. Diesbezügliche Informationen finden Sie unter Duplicate CIs remediation.

    Siehe auch: IdentificationEngine – Scoped

    Vorlagenlebenszyklus
    1. Verwenden Sie die Methode CreateTemplate(), um eine Vorlage im Entwurfsstatus zu erstellen.
      Sie können die folgenden Methoden verwenden, um die Vorlage abzurufen oder zu aktualisieren:
    2. Verwenden Sie die veröffentlichenTemplate()- Methode, um die Vorlage vom Status „Entwurf“ in den Status „Veröffentlicht“ zu verschieben.
      Hinweis:
      Verwenden Sie die Methode unPublishTemplate(), um eine veröffentlichte Vorlage in den Entwurfsstatus zurückzusetzen und die Vorlage zu aktualisieren.
    3. (Optional) Verwenden Sie die Skripteinbindung CMDBDuplicateTemplateUtil, um Aufgaben hinzuzufügen oder zu entfernen.
    4. Verwenden Sie die Methode runTemplate(), um die Vorlage auszuführen.

      Um eine laufende Aufgabe abzubrechen, verwenden Sie die Methode requestCancellation().

    5. Wenn die Vorlage nicht mehr benötigt wird, können Sie sie mit der Methode retireTemplate() stilllegen.
    Korrektur einer einzelnen Aufgabe mithilfe einer Vorlage
    Um eine einzelne Aufgabe zu korrigieren, ohne die Vorlage auszuführen, können Sie eine Vorschau anzeigen und Deduplizierungsaufgaben korrigieren.
    1. Verwenden Sie die Methode „ previewTemplate() “, um eine Vorschau der Fehlerkorrektur einer Einzelaufgabe mit einer Vorlage anzuzeigen.
    2. Verwenden Sie die Methode remediateTask(), um die Deduplizierungsaufgabe mit einer Vorlage zu beheben.

    DuplicateTemplate – canAddTasksToTemplate(Array taskIds, String templatId)

    Überprüft, ob die bereitgestellte Liste von Aufgaben einer Vorlage hinzugefügt werden kann.

    Verwenden Sie diese Methode, um zu bestimmen, ob Aufgaben zum Hinzufügen zur Vorlage geeignet sind. Beispielsweise kann die angegebene Vorlage für Anwendungsserver Tomcat erstellt werden, die angegebenen Deduplizierungsaufgaben werden jedoch für Linux-Server erstellt. Diese Aufgaben haben keine übereinstimmende Vorlagenklasse und können daher der Vorlage nicht hinzugefügt werden.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    taskIds Array Array von sys_ids der Deduplizierungsaufgaben, die der Vorlage hinzugefügt werden sollen.
    templateId Zeichenfolge Sys_id der Vorlage, die in der Tabelle „Duplikatvorlage abgleichen“ [reconcile_duplicate_template] aufgeführt ist.
    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    Objekt Ergebnisobjekt, das enthält, welche Aufgaben hinzugefügt, übersprungen oder fehlgeschlagen werden können.
    {
  "success": [
    "<task_id_1>",
    "<task_id_2>",
    "<task_id_3>"
  ],
  "failed": [
    "<task_id_4>"
  ],
  "skipped": [
    "<task_id_5>"
  ]
}
    Fehlgeschlagen Beim Überprüfen, ob die Aufgabe mit der Vorlage kompatibel ist, ist ein Fehler aufgetreten. Siehe auch Detecting duplicate CIs.
    übersprungen Die Aufgaben sind inkompatibel, da sie keine übereinstimmende Vorlagenklasse haben. Daher wurde die Aufgabe übersprungen.
    Erfolg Die Aufgabe entspricht der Vorlagenklasse und kann der Vorlage hinzugefügt werden.

    Das folgende Beispiel zeigt, wie Sie nach Aufgaben suchen, die der Vorlage hinzugefügt werden können.

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

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

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

    Ausgabe:

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

    DuplicateTemplate – createTemplate(Object template)

    Erstellt eine Deduplizierungsvorlage im Entwurfsstatus.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Vorlage Objekt Das Vorlagenobjekt mit verschiedenen Optionen zum Erstellen der Vorlage. 
    {
  "allow_master_ci_null_update": Boolean,
  "allow_null_attribute_update": Boolean,
  "description": "String",
  "duplicate_ci_action": "String",
  "duplicate_ci_updates": [Array],
  "master_ci_condition": "String",
  "master_ci_option": "String",
  "merge_related_items": "String",
  "merge_related_items_condition": [Array],
  "merge_relations_condition": "String",
  "merge_relations": "String",
  "most_related_items_merge_attributes": "String",
  "most_relations_merge_attributes": "String",
  "name": "String",
  "newest_updated_merge_attributes": "String",
  "oldest_created_merge_attributes": "String",
  "table": "String",
  "task_conditions": "String"
}
    template.allow_null_​attribute_update Boolean Optional. Kennzeichnung, die angibt, ob Haupt-CI-Attribute mit Nullwerten aus doppelten CIs aktualisiert werden, wenn Attributkonflikte für CIs innerhalb einer Deduplizierungsaufgabe aufgelöst werden.
    Gültige Werte:
    • true: Die Haupt-CI-Attribute werden mit Nullwerten aus doppelten CIs aktualisiert.
    • false: Die Haupt-CI-Attribute werden nicht mit Nullwerten aus doppelten CIs aktualisiert.

    Standardwert: False
    template.allow_master_ci_​null_update Boolean Optional. Beinhaltet nur Updates von doppelten CIs, wenn der Haupt-CI-Wert NULL ist.

    Kennzeichnung, die angibt, ob nur Updates von doppelten CIs einbezogen werden sollen, wenn der Haupt-CI-Wert NULL ist.

    Gültige Werte:
    • true: Bezieht nur Updates von doppelten CIs ein, wenn der Haupt-CI-Wert NULL ist.
    • false: Updates von allen doppelten CIs einbeziehen.

    Standardwert: False
    template.description Zeichenfolge Optional. Beschreibung zum Speichern weiterer Informationen zur Vorlage.
    template.duplicate_​ci_action Zeichenfolge Optional. Gibt an, ob das doppelte CI gelöscht oder mit eindeutigen benutzerdefinierten Werten aktualisiert werden soll.
    Mögliche Optionen:
    • löschen
    • update (erfordert die Angabe von duplicate_ci_updates)
    template.duplicate_​ci_updates Array Optional, es sei denn, die Einstellung für duplicate_ci_action ist update. Array von Objekten, das angibt, wie die doppelten CI-Werte aktualisiert werden.
    [
  {
    "element": "String",
    "element_label": "String",
    "value": "String",
    "display": "String"
  }
]
    template.duplicate_​ci_updates.element Zeichenfolge Der Systemwörterbuchname eines Referenzfelds.
    template.duplicate_​ci_updates.element_label Zeichenfolge Die Bezeichnung, die das Referenzfeld anzeigt.
    template.duplicate_​ci_updates.value Zeichenfolge Wert für ein Referenzfeld, also der Inhalt des Referenzfelds.
    template.duplicate_​ci_updates.display Zeichenfolge Anzeigewert für ein Referenzfeld.
    template.master_ci_​option Zeichenfolge Optional. Gibt an, wie das Haupt-CI für eine Deduplizierungsaufgabe bei Anwendung dieser Vorlage ausgewählt wird.
    Mögliche Optionen:
    • bedingt ( master_ci_conditionmuss angegeben werden)
    • most_related_items: Attribute, die aus dem CI mit den am häufigsten zugehörigen Elementen mit dem Haupt-CI zusammengeführt werden sollen.
    • most_relations: Attribute, die vom CI mit den meisten Beziehungen zum Haupt-CI zusammengeführt werden sollen.
    • neueste_erstellt – getrennte Attribute, die vom zuletzt aktualisierten CI mit dem Haupt-CI zusammengeführt werden sollen.
    • old_created – Kommagetrennte Attribute, die vom ältesten erstellten CI mit dem Haupt-CI zusammengeführt werden sollen.
    Bedingung template.master_ci_. Zeichenfolge Optional (erforderlich, wenn der Wert von master_ci_optionbedingtist). Codierte Abfrage, um anzugeben, wie das Haupt-CI ausgewählt wird. Wenn mehrere CIs oder keine CIs mit der Abfrage übereinstimmen, wählt die Methode das zuletzt aktualisierte CI als Haupt-CI aus. Die codierte Abfrage wird für die Vorlagentabelle ausgewertet. Diese Tabelle wird in der Eigenschaft table identifiziert.

    Weitere Informationen finden Sie unter Codierte Abfragezeichenfolgen .
    template.merge_relations Zeichenfolge Optional. Gibt an, wie die Beziehungen für doppelte CIs innerhalb einer Deduplizierungsaufgabe bei Anwendung dieser Vorlage zusammengeführt werden.
    Mögliche Optionen:
    • alle
    • bedingt
    • Keine
    template.merge_relations Zeichenfolge Optional. Gibt an, wie die Beziehungen für doppelte CIs innerhalb einer Deduplizierungsaufgabe bei Anwendung dieser Vorlage zusammengeführt werden.
    Mögliche Optionen:
    • alle
    • bedingt
    • Keine
    template.merge_relations_​condition Zeichenfolge Optional (erforderlich, wenn der Wert von merge_relationsbedingtist). Codierte Abfrage, um anzugeben, ob alle oder keine der Beziehungen aus doppelten CIs zusammengeführt werden. Die Abfrage wird für das Haupt-CI ausgewertet, das für die Deduplizierungsaufgabe ausgewählt wurde. Wenn die Abfrage „true“ zurückgibt, werden alle Beziehungen zusammengeführt. Bei „false“ werden keine Beziehungen zusammengeführt.

    Die codierte Abfrage wird für die Vorlagentabelle ausgewertet. Diese Tabelle wird in der Eigenschaft table identifiziert.

    Weitere Informationen finden Sie unter Codierte Abfragezeichenfolgen .
    template.merge_related_items Zeichenfolge Optional. Gibt an, welche zugehörigen Tabellen für doppelte CIs innerhalb einer Deduplizierungsaufgabe bei Anwendung dieser Vorlage mit dem Haupt-CI zusammengeführt werden. Siehe auch Remediate a de-duplication task (legacy).
    Mögliche Optionen:
    • all_available – Enthält die standardmäßig zugehörigen Tabellen und alle zugehörigen Tabellen, die auf doppelte CIs für die über die Vorlage behobene Deduplizierungsaufgabe verweisen.
    • bedingt
    • Standard – Enthält zugehörige Einträge, die vom Modul „Standardmäßige zugehörige Elemente der Remediator-CI-Duplikat-Korrektur“ bereitgestellt werden.
    • Keine
    template.merge_related_items_​condition Array Optional. Liste der zugehörigen Einträge mit einer codierten Abfrage für jeden zugehörigen Eintrag. Jede Abfrage wird für das Haupt-CI ausgewertet, das für die Aufgabe ausgewählt ist. Wenn die Abfrage „true“ zurückgibt, werden die zugehörigen Einträge während der Korrektur einer Deduplizierungsaufgabe zusammengeführt. Bei „false“ werden zugehörige Einträge nicht zusammengeführt.
    "merge_related_items_condition": [
  {
    "related_entry": "String",
    "condition": "String"
  }
]

    Weitere Informationen finden Sie unter Codierte Abfragezeichenfolgen .
    template. most_relations_​merge_attributes Zeichenfolge Optional. Kommagetrennte Attribute, die vom CI mit den meisten Beziehungen zum Haupt-CI zusammengeführt werden sollen.
    template. most_related_items_​merge_attributes Zeichenfolge Optional. Kommagetrennte Attribute, die aus dem CI mit den am meisten zugehörigen Elementen mit dem Haupt-CI zusammengeführt werden sollen.
    template.name Zeichenfolge Name der Vorlage.
    template.newest_updated_​merge_attributes Zeichenfolge Optional. Kommagetrennte Attribute, die vom zuletzt aktualisierten CI mit dem Haupt-CI zusammengeführt werden sollen.
    template.oldest_created_​merge_attributes Zeichenfolge Optional. Kommagetrennte Attribute, die vom ältesten erstellten CI mit dem Haupt-CI zusammengeführt werden sollen.
    template.table Zeichenfolge Tabelle, für die die Vorlage erstellt wird.
    template.task_conditions Zeichenfolge Optional. Codierte Abfrage, die ausgewertet werden soll, wenn die Vorlage ausgeführt wird. Diese Abfrage wird in der Tabelle „Daten zu doppelten Aufgaben abgleichen“ [reconcile_duplicate_task_data] ausgewertet. Alle von dieser Abfrage zurückgegebenen Aufgaben werden bei der Vorlagenauswertung berücksichtigt.
    Hinweis:
    Selbst wenn eine Aufgabe als Teil der Abfrage zurückgegeben wird, kann nicht garantiert werden, dass die Vorlagenausführung die Aufgabe verarbeitet. Andere Faktoren können dazu führen, dass die Aufgabe während der Vorlagenverarbeitung übersprungen wird.

    Weitere Informationen finden Sie unter Codierte Abfragezeichenfolgen .
    Tabelle : 4. Ausgabe
    Typ Beschreibung
    Zeichenfolge Sys_id der Vorlage, die in der Tabelle „Duplikatsvorlagen abgleichen“ [reconcile_duplicate_template] erstellt wurde.

    Das folgende Beispiel zeigt, wie eine Deduplizierungsvorlage erstellt wird.

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

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

gs.info(templateId);

    Ausgabe:

    8dfcd36e042b2510f877c1665753a485

    DuplicateTemplate – getTemplate(String templateId)

    Ruft das Vorlagenobjekt ab.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    templateId Zeichenfolge Sys_id der Vorlage, die in der Tabelle „Duplikatvorlage abgleichen“ [reconcile_duplicate_template] aufgeführt ist.
    Tabelle : 6. Ausgabe
    Typ Beschreibung
    Objekt Das Vorlagenobjekt mit verschiedenen Optionen zum Erstellen der Vorlage.
    {
  "allow_master_ci_null_update": Boolean,
  "allow_null_attribute_update": Boolean,
  "description": "String",
  "duplicate_ci_action": "String",
  "duplicate_ci_updates": [Array],
  "master_ci_condition": "String",
  "master_ci_option": "String",
  "merge_related_items": "String",
  "merge_related_items_condition": [Array],
  "merge_relations_condition": "String",
  "merge_relations": "String",
  "most_related_items_merge_attributes": "String",
  "most_relations_merge_attributes": "String",
  "name": "String",
  "newest_updated_merge_attributes": "String",
  "oldest_created_merge_attributes": "String",
  "table": "String",
  "task_conditions": "String"
}
    <Object>.allow_null_ attribute_update Kennzeichnung, die angibt, ob Haupt-CI-Attribute mit Nullwerten aus doppelten CIs aktualisiert werden, wenn Attributkonflikte für CIs innerhalb einer Deduplizierungsaufgabe aufgelöst werden.
    Gültige Werte:
    • true: Die Haupt-CI-Attribute werden mit Nullwerten aus doppelten CIs aktualisiert.
    • false: Die Haupt-CI-Attribute werden nicht mit Nullwerten aus doppelten CIs aktualisiert.

    Datentyp: Boolesch
    <Object>.allow_master_ci_ null_update Beinhaltet nur Updates von doppelten CIs, wenn der Haupt-CI-Wert NULL ist.
    Gültige Werte:
    • true: Bezieht nur Updates von doppelten CIs ein, wenn der Haupt-CI-Wert NULL ist.
    • false: Updates von allen doppelten CIs einbeziehen.

    Datentyp: Boolesch
    <Object>.Beschreibung Beschreibung zum Speichern weiterer Informationen zur Vorlage.

    Datentyp: Zeichenfolge
    <Object>.duplicate_ci_action Gibt an, ob das doppelte CI gelöscht oder mit eindeutigen benutzerdefinierten Werten aktualisiert werden soll.
    Mögliche Optionen:
    • löschen
    • update (erfordert die Angabe von duplicate_ci_updates)

    Datentyp: Zeichenfolge
    <Object>.duplicate_ci_updates Array von Objekten, das angibt, wie die doppelten CI-Werte aktualisiert werden.
    [
  {
    "element": "String",
    "element_label": "String",
    "value": "String",
    "display": "String"
  }
]

    Datentyp: Objekt
    <Object>.duplicateCIUpdates.element Der Systemwörterbuchname eines Referenzfelds.

    Datentyp: Zeichenfolge
    <Object>.duplicateCIUpdates.element_label Die Bezeichnung, die das Referenzfeld anzeigt.

    Datentyp: Zeichenfolge
    <Object>.duplicateCIUpdates.value Wert für ein Referenzfeld, also der Inhalt des Referenzfelds.

    Datentyp: Zeichenfolge
    <Object>.duplicateCIUpdates.anzeigen Anzeigewert für ein Referenzfeld.

    Datentyp: Zeichenfolge
    <Object>Option .master_ci_ Gibt an, wie das Haupt-CI für eine Deduplizierungsaufgabe bei Anwendung dieser Vorlage ausgewählt wird.
    Mögliche Optionen:
    • bedingt ( master_ci_conditionmuss angegeben werden)
    • most_related_items: Attribute, die aus dem CI mit den am häufigsten zugehörigen Elementen mit dem Haupt-CI zusammengeführt werden sollen.
    • most_relations: Attribute, die vom CI mit den meisten Beziehungen zum Haupt-CI zusammengeführt werden sollen.
    • neueste_erstellt – getrennte Attribute, die vom zuletzt aktualisierten CI mit dem Haupt-CI zusammengeführt werden sollen.
    • old_created – Kommagetrennte Attribute, die vom ältesten erstellten CI mit dem Haupt-CI zusammengeführt werden sollen.

    Datentyp: Zeichenfolge
    <Object>.merge_relations Gibt an, wie die Beziehungen für doppelte CIs innerhalb einer Deduplizierungsaufgabe bei Anwendung dieser Vorlage zusammengeführt werden.
    Mögliche Optionen:
    • alle
    • bedingt
    • Keine

    Datentyp: Zeichenfolge
    <Object>.merge_related_items Gibt an, welche zugehörigen Tabellen für doppelte CIs innerhalb einer Deduplizierungsaufgabe bei Anwendung dieser Vorlage mit dem Haupt-CI zusammengeführt werden. Siehe auch Remediate a de-duplication task (legacy).
    Mögliche Optionen:
    • all_available – Enthält die standardmäßig zugehörigen Tabellen und alle zugehörigen Tabellen, die auf doppelte CIs für die über die Vorlage behobene Deduplizierungsaufgabe verweisen.
    • bedingt
    • Standard – Enthält zugehörige Einträge, die vom Modul „Standardmäßige zugehörige Elemente der Remediator-CI-Duplikat-Korrektur“ bereitgestellt werden.
    • Keine

    Datentyp: Zeichenfolge
    <Object>Bedingung .merge_related_items_ Liste der zugehörigen Einträge mit einer codierten Abfrage für jeden zugehörigen Eintrag. Jede Abfrage wird für das Haupt-CI ausgewertet, das für die Aufgabe ausgewählt ist. Wenn die Abfrage „true“ zurückgibt, werden die zugehörigen Einträge während der Korrektur einer Deduplizierungsaufgabe zusammengeführt. Bei „false“ werden zugehörige Einträge nicht zusammengeführt.

    Weitere Informationen finden Sie unter Codierte Abfragezeichenfolgen .

    Datentyp: Array
    <Object>.Most_relations_merge_attributes Kommagetrennte Attribute, die vom CI mit den meisten Beziehungen zum Haupt-CI zusammengeführt werden sollen.

    Datentyp: Zeichenfolge
    <Object>.Most_related_items_merge_attributes Kommagetrennte Attribute, die aus dem CI mit den am meisten zugehörigen Elementen mit dem Haupt-CI zusammengeführt werden sollen.

    Datentyp: Zeichenfolge
    <Object>.name Name der Vorlage.

    Datentyp: Zeichenfolge
    <Object>.netest_updated_ merge_attributes Kommagetrennte Attribute, die vom zuletzt aktualisierten CI mit dem Haupt-CI zusammengeführt werden sollen.

    Datentyp: Zeichenfolge
    <Object>.oldest_created_ merge_attributes Kommagetrennte Attribute, die vom ältesten erstellten CI mit dem Haupt-CI zusammengeführt werden sollen.

    Datentyp: Zeichenfolge
    <Object>.Tabelle Tabelle, für die die Vorlage erstellt wird.

    Datentyp: Zeichenfolge
    <Object>.task_condition_table Speicherort der Tabellenaufgabenbedingungen, d. h. der Tabelle „Doppelte Aufgabendaten abgleichen“ [reconcile_duplicate_task_data]. Der Wert ändert sich nie, und die Tabelle ist nur für den internen Gebrauch bestimmt.

    Datentyp: Zeichenfolge
    <Object>.task_conditions Codierte Abfrage, die ausgewertet werden soll, wenn die Vorlage ausgeführt wird. Diese Abfrage wird in der Tabelle „Daten zu doppelten Aufgaben abgleichen“ [reconcile_duplicate_task_data] ausgewertet. Alle von dieser Abfrage zurückgegebenen Aufgaben werden bei der Vorlagenauswertung berücksichtigt.
    Hinweis:
    Selbst wenn eine Aufgabe als Teil der Abfrage zurückgegeben wird, kann nicht garantiert werden, dass die Vorlagenausführung die Aufgabe verarbeitet. Andere Faktoren können dazu führen, dass die Aufgabe während der Vorlagenverarbeitung übersprungen wird.

    Weitere Informationen finden Sie unter Codierte Abfragezeichenfolgen .

    Datentyp: Zeichenfolge

    Das folgende Beispiel zeigt, wie eine Vorlage abgerufen wird.

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

    Ausgabe:

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

    DuplicateTemplate – previewTemplate(String templateId, String taskId)

    Generiert eine Vorschau darauf, wie verschiedene Vorlagenoptionen auf die Deduplizierungsaufgabe angewendet wurden und wie dies korrigiert werden muss.

    Diese Methode validiert alle erforderlichen Attribute, bevor die Vorschau für die Aufgabe anhand der Vorlage generiert wird. Vorlagen können erstellt oder aktualisiert werden, ohne die erforderlichen Attribute anzugeben. Die erforderlichen Attribute müssen angegeben werden, um eine Vorschau einer Deduplizierungsaufgabe anzuzeigen.

    Die folgenden Attribute sind erforderlich:
    • „duplicate_ci_action“.
    • Master_ci_option
    • merge_related_items
    • merge_relations
    • Name
    • Tabelle
    Hinweis:
    Obwohl diese Methode alle Attribute validiert, ist es nicht erforderlich, dass sich die Vorlage für eine Vorschau im Status „Veröffentlicht“ befindet.

    Verwenden Sie die Methode remediateTask(), um Deduplizierungsaufgaben zu beheben.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    templateId Zeichenfolge Sys_id der Vorlage, die in der Tabelle „Duplikatvorlage abgleichen“ [reconcile_duplicate_template] aufgeführt ist.
    Aufgaben-ID Zeichenfolge Sys_id der Deduplizierungsaufgabe, die in der Tabelle „Duplikataufgabe korrigieren“ [reconcile_duplicate_task] aufgeführt ist.
    Tabelle : 8. Ausgabe
    Typ Beschreibung
    Objekt Vorschauobjekt mit Werten, die zeigen, wie die Deduplizierungsaufgaben mithilfe der Vorlage behoben werden können.
    {
  "allClassCIMap": {Object},
  "duplicateCIAction": "String",
  "duplicateCIUpdates": [Array],
  "masterCI": "String",
  "mergeRelations": Boolean,
  "relatedTablesMerged": [Array],  
  "resolvedFieldCIMap": [Array],
  "taskId": "String",
  "tooManyDuplicates": Boolean
}
    <Object>.allClassCImap Liste der sys_ids der CIs innerhalb einer Deduplizierungsaufgabe,, gruppiert nach CI-Klasse. Zum Beispiel cmdb_ci_computer.
    "allClassCIMap": {
  "<ci_class_name>": [
    "<ci_sys_id_1>",
    "<ci_sys_id_2>"
  ]
}

    Datentyp: Objekt
    <Object>.duplicateCIAction Gibt an, ob das doppelte CI gelöscht oder mit eindeutigen benutzerdefinierten Werten aktualisiert werden soll.
    Mögliche Optionen:
    • löschen
    • update (erfordert die Angabe von duplicate_ci_updates)

    Datentyp: Zeichenfolge
    <Object>.duplicateCIUpdates Array von Objekten, das angibt, wie die doppelten CI-Werte aktualisiert werden.
    [
  {
    "element": "String",
    "element_label": "String",
    "value": "String",
    "display": "String"
  }
]

    Datentyp: Array
    <Object>.duplicateCIUpdates.element Der Systemwörterbuchname eines Referenzfelds.

    Datentyp: Zeichenfolge
    <Object>.duplicateCIUpdates.element_label Die Bezeichnung, die das Referenzfeld anzeigt.

    Datentyp: Zeichenfolge
    <Object>.duplicateCIUpdates.value Wert für ein Referenzfeld, also der Inhalt des Referenzfelds.

    Datentyp: Zeichenfolge
    <Object>.duplicateCIUpdates.anzeigen Anzeigewert für ein Referenzfeld.

    Datentyp: Zeichenfolge
    <Object>.masterCI Sys_id des CI, das als Haupt-CI ausgewählt wurde

    Datentyp: Zeichenfolge
    <Object>.mergeRelations Gibt an, wie die Beziehungen für doppelte CIs innerhalb einer Deduplizierungsaufgabe bei Anwendung dieser Vorlage zusammengeführt werden.
    Mögliche Optionen:
    • alle
    • bedingt
    • Keine

    Datentyp: Zeichenfolge
    <Object>.relatedTablesMerged Gibt an, welche zugehörigen Tabellen für doppelte CIs innerhalb einer Deduplizierungsaufgabe bei Anwendung dieser Vorlage mit dem Haupt-CI zusammengeführt werden. Siehe auch Remediate a de-duplication task (legacy).
    Mögliche Optionen:
    • all_available – Enthält die standardmäßig zugehörigen Tabellen und alle zugehörigen Tabellen, die auf doppelte CIs für die über die Vorlage behobene Deduplizierungsaufgabe verweisen.
    • bedingt
    • Standard – Enthält zugehörige Einträge, die vom Modul „Standardmäßige zugehörige Elemente der Remediator-CI-Duplikat-Korrektur“ bereitgestellt werden.
    • Keine

    Datentyp: Array
    <Object>.resolvedFieldCImap Array von Elementen, die aus doppelten CIs mit dem Haupt-CI zusammengeführt werden sollen.
    "resolvedFieldCIMap": [
  {
    "element": "String",
    "sys_id": "String"
  }
]

    Datentyp: Array
    <Object>.resolvedFieldCImap.​Element Name des Elements, das aus einem doppelten CI mit dem Haupt-CI zusammengeführt werden soll.

    Datentyp: Zeichenfolge
    <Object>.resolvedFieldCImap.​sys_id Sys_id des Elements, das aus einem doppelten CI mit dem Haupt-CI zusammengeführt werden soll.

    Datentyp: Zeichenfolge
    <Object>.Aufgaben-ID Sys_id der Deduplizierungsaufgabe, die in der Tabelle „Duplikataufgabe korrigieren“ [reconcile_duplicate_task] aufgeführt ist.

    Datentyp: Zeichenfolge
    <Object>.tooManyDuplicates Kennzeichnung, die angibt, ob die Aufgabe mehr als die maximale Anzahl von CIs aufweist. Der Schwellenwert wird durch Vergleich des Werts der Systemeigenschaft glide.duplicate_ci_ remediator.max.cis (Standardwert 1000 CIs) bestimmt.
    Gültige Werte:
    • true: Aufgabenanzahl von CIs überschreitet die maximale Anzahl von CIs.
    • false: Aufgabenanzahl von CIs überschreitet nicht die maximale Anzahl von CIs.

    Datentyp: Boolesch

    Das folgende Beispiel zeigt, wie Sie eine Vorschau der Deduplizierungskorrektur für eine angegebene Vorlage erhalten.

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

    Ausgabe:

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

    DuplicateTemplate – veröffentlichenTemplate(String templateId)

    Veröffentlicht eine Vorlage. Bei Erfolg wird die Vorlage vom Status „Entwurf“ in den Status „Veröffentlicht“ verschoben.

    Diese Methode validiert alle erforderlichen Attribute, bevor die Vorlage veröffentlicht wird. Sie können Vorlagen erstellen oder aktualisieren, ohne die erforderlichen Attribute anzugeben. Die Attribute müssen jedoch vor der Veröffentlichung einer Vorlage angegeben werden.

    Die folgenden Attribute sind erforderlich:
    • „duplicate_ci_action“.
    • Master_ci_option
    • merge_related_items
    • merge_relations
    • Name
    • Tabelle

    Im Status „Veröffentlicht“ können Sie die Vorlage mit der Methode runTemplate() ausführen.

    Siehe auch:
    Tabelle : 9. Parameter
    Name Typ Beschreibung
    templateId Zeichenfolge Sys_id der Vorlage, die in der Tabelle „Duplikatvorlage abgleichen“ [reconcile_duplicate_template] aufgeführt ist.
    Tabelle : 10. Ausgabe
    Typ Beschreibung
    Boolean

    Kennzeichnung, die angibt, ob die Vorlage veröffentlicht wurde.

    Gültige Werte:
    • true: Die Vorlage wurde veröffentlicht.
    • false: Die Vorlage wurde nicht veröffentlicht.

    Das folgende Beispiel zeigt, wie eine Vorlage veröffentlicht und Ergebnisse angezeigt werden.

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

    Ausgabe:

    true

    DuplicateTemplate – remediateTask(String templateId, String taskId)

    Korrigiert eine Deduplizierungsaufgabe mithilfe der Vorlage.

    Wenn sich die Vorlage nicht im Status „Veröffentlicht“ befindet, kann die Vorlage nicht ausgeführt werden, und die Methode löst eine Ausnahme aus.

    Verwenden Sie die Methode „ previewTemplate() “, um eine Vorschau der zu behebenden Deduplizierungsaufgaben anzuzeigen.

    Siehe auch.
    Tabelle : 11. Parameter
    Name Typ Beschreibung
    templateId Zeichenfolge Sys_id der Vorlage, die in der Tabelle „Duplikatvorlage abgleichen“ [reconcile_duplicate_template] aufgeführt ist.
    Aufgaben-ID Zeichenfolge Sys_id der Deduplizierungsaufgabe, die in der Tabelle „Duplikataufgabe korrigieren“ [reconcile_duplicate_task] aufgeführt ist.
    Tabelle : 12. Ausgabe
    Typ Beschreibung
    Zeichenfolge Wenn erfolgreich, die ID der Zusammenführungslösung für die Korrektur der Deduplizierungsaufgabe. Diese Zusammenführungslösungs-ID ist die sys_id eines Datensatzes in der Tabelle „Nachbesserung von CI-Duplikaten“ [cmdb_duplicate_ci_remediation]. Wenn dies nicht erfolgreich ist, befindet sich die Vorlage möglicherweise nicht im Status „Veröffentlicht“.

    Das folgende Beispiel zeigt, wie eine Deduplizierungsaufgabe korrigiert wird.

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

    Ausgabe:

    <merge_resolution_id>

    DuplicateTemplate – requestCancellation(String templateRunId)

    Bricht eine vorhandene Vorlagenausführung ab.

    Eine Anforderung zum Abbrechen kann nur für eine Vorlagenausführung gestellt werden, wenn sie sich im Status „Entwurf“, „Bereit“ oder „Wird ausgeführt“ befindet.

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

    Durch die Ausführung dieser Methode werden Vorlagenausführungen im Status „Bereit“ oder „Entwurf“ nicht automatisch abgebrochen. Der Ausführungsstatus der Vorlage ändert sich erst in „Abgebrochen“, wenn alle ausgeführten Aufgaben abgeschlossen sind. Zu diesem Zeitpunkt ändern sich alle verbleibenden Aufgaben, die zur Korrektur bereitgestellt werden, von Abbruch angefordert zu Abgebrochen.

    Siehe auch:
    Tabelle : 13. Parameter
    Name Typ Beschreibung
    templateRunId Zeichenfolge Sys_id der Vorlagenausführung, die in der Tabelle „Deduplizierungsvorlagenausführung“ [reconcile_duplicate_template_run] aufgeführt ist.
    Tabelle : 14. Ergebnisse
    Typ Beschreibung
    Zeichenfolge

    Kennzeichnung, die angibt, ob die Anforderung zum Abbrechen erfolgreich war.

    Gültige Werte:
    • true: Die Anforderung zum Abbrechen war erfolgreich.
    • false: Die Anforderung zum Abbrechen war nicht erfolgreich.

    Das folgende Beispiel zeigt, wie eine Vorlagenausführung abgebrochen und angezeigt wird, ob der Vorgang erfolgreich ist.

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

    Ausgabe:

    true

    DuplicateTemplate – retireTemplate(String templateId)

    Legt eine Vorlage still.

    Verwenden Sie diese Methode, um eine Vorlage in den Status „Stillgelegt“ zu verschieben, wenn sie nicht mehr benötigt wird.

    Die Vorlage kann nicht gelöscht werden, und die Methode löst unter den folgenden Bedingungen eine Ausnahme aus:
    • Die Vorlage befindet sich im Status „Veröffentlicht“.
    • Die Vorlage wird ausgeführt oder ist zur Ausführung geplant.
    Siehe auch:
    Tabelle : 15. Parameter
    Name Typ Beschreibung
    templateId Zeichenfolge Sys_id der Vorlage, die in der Tabelle „Duplikatvorlage abgleichen“ [reconcile_duplicate_template] aufgeführt ist.
    Tabelle : 16. Ausgabe
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob die Vorlage deaktiviert wurde.
    Gültige Werte:
    • true: Die Vorlage wird deaktiviert.
    • false: Die Vorlage konnte nicht stillgelegt werden, da sie ausgeführt wurde, ihre Ausführung geplant war oder sich im Status „Veröffentlicht“ befand

    Das folgende Beispiel zeigt, wie eine Vorlage gelöscht und die Ergebnisse angezeigt werden.

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

    Ausgabe:

    true

    DuplicateTemplate – runTemplate(String templateId)

    Plant eine Fehlerkorrektur für eine Deduplizierungsvorlage im Status „Veröffentlicht“. Eine Vorlage kann mehrmals ausgeführt werden, Sie können jedoch jeweils nur eine Ausführung planen.

    Wenn sich die Vorlage nicht im Status „Veröffentlicht“ befindet, kann sie nicht ausgeführt werden, und die Methode löst eine Ausnahme aus. Verwenden Sie die veröffentlichenTemplate()- Methode, um die Vorlage vom Status „Entwurf“ in den Status „Veröffentlicht“ zu verschieben.

    Um eine laufende Aufgabe abzubrechen, verwenden Sie die Methode requestCancellation().

    Tabelle : 17. Parameter
    Name Typ Beschreibung
    templateId Zeichenfolge Sys_id der Vorlage, die in der Tabelle „Duplikatvorlage abgleichen“ [reconcile_duplicate_template] aufgeführt ist.
    Tabelle : 18. Ausgabe
    Typ Beschreibung
    Zeichenfolge Sys_id der ausgeführten Vorlage, die in der Tabelle „Deduplizierungsvorlagenausführung“ [reconcile_duplicate_template_run] aufgeführt ist. Wenn dies nicht erfolgreich ist, befindet sich die Vorlage möglicherweise nicht im Status „Veröffentlicht“.

    Das folgende Beispiel zeigt, wie eine Ausführung für eine veröffentlichte Deduplizierungsvorlage geplant wird.

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

    Ausgabe:

    487c67e2046b2510f877c1665753a4cc

    DuplicateTemplate – unPublishTemplate(String templateId)

    Hebt die Veröffentlichung einer Vorlage auf.

    Diese Methode verschiebt die Vorlage vom Status „Veröffentlicht“ in den Status „Entwurf“, wodurch die Vorlage aktualisiert werden kann. Die Veröffentlichung der Vorlage kann nicht aufgehoben werden, wenn sie ausgeführt wird oder ihre Ausführung geplant ist.

    Siehe auch:
    Tabelle : 19. Parameter
    Name Typ Beschreibung
    templateId Zeichenfolge Sys_id der Vorlage, die in der Tabelle „Duplikatvorlage abgleichen“ [reconcile_duplicate_template] aufgeführt ist.
    Tabelle : 20. Ausgabe
    Typ Beschreibung
    Boolean

    Kennzeichnung, die angibt, ob die Veröffentlichung der Vorlage erfolgreich aufgehoben wurde.

    Gültige Werte:
    • true: Die Veröffentlichung der Vorlage wurde erfolgreich aufgehoben.
    • false: Die Veröffentlichung der Vorlage wurde nicht erfolgreich aufgehoben. Die Vorlage wird möglicherweise ausgeführt oder ist zur Ausführung geplant.

    Das folgende Beispiel zeigt, wie Sie die Veröffentlichung einer Vorlage aufheben und die Ergebnisse anzeigen.

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

    Ausgabe:

    true

    DuplicateTemplate – updateTemplate(String templateId, Object template)

    Aktualisiert eine Deduplizierungsvorlage im Entwurfsstatus.

    Siehe auch:
    Tabelle : 21. Parameter
    Name Typ Beschreibung
    templateId Zeichenfolge Sys_id der Vorlage, die in der Tabelle „Duplikatvorlage abgleichen“ [reconcile_duplicate_template] aufgeführt ist.
    Vorlage Objekt Das Vorlagenobjekt mit verschiedenen Optionen zum Erstellen der Vorlage. 
    {
  "allow_master_ci_null_update": Boolean,
  "allow_null_attribute_update": Boolean,
  "description": "String",
  "duplicate_ci_action": "String",
  "duplicate_ci_updates": [Array],
  "master_ci_condition": "String",
  "master_ci_option": "String",
  "merge_related_items": "String",
  "merge_related_items_condition": [Array],
  "merge_relations_condition": "String",
  "merge_relations": "String",
  "most_related_items_merge_attributes": "String",
  "most_relations_merge_attributes": "String",
  "name": "String",
  "newest_updated_merge_attributes": "String",
  "oldest_created_merge_attributes": "String",
  "table": "String",
  "task_conditions": "String"
}
    template.allow_null_​attribute_update Boolean Optional. Kennzeichnung, die angibt, ob Haupt-CI-Attribute mit Nullwerten aus doppelten CIs aktualisiert werden, wenn Attributkonflikte für CIs innerhalb einer Deduplizierungsaufgabe aufgelöst werden.
    Gültige Werte:
    • true: Die Haupt-CI-Attribute werden mit Nullwerten aus doppelten CIs aktualisiert.
    • false: Die Haupt-CI-Attribute werden nicht mit Nullwerten aus doppelten CIs aktualisiert.

    Standardwert: False
    template.allow_master_ci_​null_update Boolean Optional. Beinhaltet nur Updates von doppelten CIs, wenn der Haupt-CI-Wert NULL ist.

    Kennzeichnung, die angibt, ob nur Updates von doppelten CIs einbezogen werden sollen, wenn der Haupt-CI-Wert NULL ist.

    Gültige Werte:
    • true: Bezieht nur Updates von doppelten CIs ein, wenn der Haupt-CI-Wert NULL ist.
    • false: Updates von allen doppelten CIs einbeziehen.

    Standardwert: False
    template.description Zeichenfolge Optional. Beschreibung zum Speichern weiterer Informationen zur Vorlage.
    template.duplicate_​ci_action Zeichenfolge Optional. Gibt an, ob das doppelte CI gelöscht oder mit eindeutigen benutzerdefinierten Werten aktualisiert werden soll.
    Mögliche Optionen:
    • löschen
    • update (erfordert die Angabe von duplicate_ci_updates)
    template.duplicate_​ci_updates Array Optional, es sei denn, die Einstellung für duplicate_ci_action ist update. Array von Objekten, das angibt, wie die doppelten CI-Werte aktualisiert werden.
    [
  {
    "element": "String",
    "element_label": "String",
    "value": "String",
    "display": "String"
  }
]
    template.duplicate_​ci_updates.element Zeichenfolge Der Systemwörterbuchname eines Referenzfelds.
    template.duplicate_​ci_updates.element_label Zeichenfolge Die Bezeichnung, die das Referenzfeld anzeigt.
    template.duplicate_​ci_updates.value Zeichenfolge Wert für ein Referenzfeld, also der Inhalt des Referenzfelds.
    template.duplicate_​ci_updates.display Zeichenfolge Anzeigewert für ein Referenzfeld.
    template.master_ci_​option Zeichenfolge Optional. Gibt an, wie das Haupt-CI für eine Deduplizierungsaufgabe bei Anwendung dieser Vorlage ausgewählt wird.
    Mögliche Optionen:
    • bedingt ( master_ci_conditionmuss angegeben werden)
    • most_related_items: Attribute, die aus dem CI mit den am häufigsten zugehörigen Elementen mit dem Haupt-CI zusammengeführt werden sollen.
    • most_relations: Attribute, die vom CI mit den meisten Beziehungen zum Haupt-CI zusammengeführt werden sollen.
    • neueste_erstellt – getrennte Attribute, die vom zuletzt aktualisierten CI mit dem Haupt-CI zusammengeführt werden sollen.
    • old_created – Kommagetrennte Attribute, die vom ältesten erstellten CI mit dem Haupt-CI zusammengeführt werden sollen.
    Bedingung template.master_ci_. Zeichenfolge Optional (erforderlich, wenn der Wert von master_ci_optionbedingtist). Codierte Abfrage, um anzugeben, wie das Haupt-CI ausgewählt wird. Wenn mehrere CIs oder keine CIs mit der Abfrage übereinstimmen, wählt die Methode das zuletzt aktualisierte CI als Haupt-CI aus. Die codierte Abfrage wird für die Vorlagentabelle ausgewertet. Diese Tabelle wird in der Eigenschaft table identifiziert.

    Weitere Informationen finden Sie unter Codierte Abfragezeichenfolgen .
    template.merge_relations Zeichenfolge Optional. Gibt an, wie die Beziehungen für doppelte CIs innerhalb einer Deduplizierungsaufgabe bei Anwendung dieser Vorlage zusammengeführt werden.
    Mögliche Optionen:
    • alle
    • bedingt
    • Keine
    template.merge_relations Zeichenfolge Optional. Gibt an, wie die Beziehungen für doppelte CIs innerhalb einer Deduplizierungsaufgabe bei Anwendung dieser Vorlage zusammengeführt werden.
    Mögliche Optionen:
    • alle
    • bedingt
    • Keine
    template.merge_relations_​condition Zeichenfolge Optional (erforderlich, wenn der Wert von merge_relationsbedingtist). Codierte Abfrage, um anzugeben, ob alle oder keine der Beziehungen aus doppelten CIs zusammengeführt werden. Die Abfrage wird für das Haupt-CI ausgewertet, das für die Deduplizierungsaufgabe ausgewählt wurde. Wenn die Abfrage „true“ zurückgibt, werden alle Beziehungen zusammengeführt. Bei „false“ werden keine Beziehungen zusammengeführt.

    Die codierte Abfrage wird für die Vorlagentabelle ausgewertet. Diese Tabelle wird in der Eigenschaft table identifiziert.

    Weitere Informationen finden Sie unter Codierte Abfragezeichenfolgen .
    template.merge_related_items Zeichenfolge Optional. Gibt an, welche zugehörigen Tabellen für doppelte CIs innerhalb einer Deduplizierungsaufgabe bei Anwendung dieser Vorlage mit dem Haupt-CI zusammengeführt werden. Siehe auch Remediate a de-duplication task (legacy).
    Mögliche Optionen:
    • all_available – Enthält die standardmäßig zugehörigen Tabellen und alle zugehörigen Tabellen, die auf doppelte CIs für die über die Vorlage behobene Deduplizierungsaufgabe verweisen.
    • bedingt
    • Standard – Enthält zugehörige Einträge, die vom Modul „Standardmäßige zugehörige Elemente der Remediator-CI-Duplikat-Korrektur“ bereitgestellt werden.
    • Keine
    template.merge_related_items_​condition Array Optional. Liste der zugehörigen Einträge mit einer codierten Abfrage für jeden zugehörigen Eintrag. Jede Abfrage wird für das Haupt-CI ausgewertet, das für die Aufgabe ausgewählt ist. Wenn die Abfrage „true“ zurückgibt, werden die zugehörigen Einträge während der Korrektur einer Deduplizierungsaufgabe zusammengeführt. Bei „false“ werden zugehörige Einträge nicht zusammengeführt.
    "merge_related_items_condition": [
  {
    "related_entry": "String",
    "condition": "String"
  }
]

    Weitere Informationen finden Sie unter Codierte Abfragezeichenfolgen .
    template. most_relations_​merge_attributes Zeichenfolge Optional. Kommagetrennte Attribute, die vom CI mit den meisten Beziehungen zum Haupt-CI zusammengeführt werden sollen.
    template. most_related_items_​merge_attributes Zeichenfolge Optional. Kommagetrennte Attribute, die aus dem CI mit den am meisten zugehörigen Elementen mit dem Haupt-CI zusammengeführt werden sollen.
    template.name Zeichenfolge Name der Vorlage.
    template.newest_updated_​merge_attributes Zeichenfolge Optional. Kommagetrennte Attribute, die vom zuletzt aktualisierten CI mit dem Haupt-CI zusammengeführt werden sollen.
    template.oldest_created_​merge_attributes Zeichenfolge Optional. Kommagetrennte Attribute, die vom ältesten erstellten CI mit dem Haupt-CI zusammengeführt werden sollen.
    template.table Zeichenfolge Tabelle, für die die Vorlage erstellt wird.
    template.task_conditions Zeichenfolge Optional. Codierte Abfrage, die ausgewertet werden soll, wenn die Vorlage ausgeführt wird. Diese Abfrage wird in der Tabelle „Daten zu doppelten Aufgaben abgleichen“ [reconcile_duplicate_task_data] ausgewertet. Alle von dieser Abfrage zurückgegebenen Aufgaben werden bei der Vorlagenauswertung berücksichtigt.
    Hinweis:
    Selbst wenn eine Aufgabe als Teil der Abfrage zurückgegeben wird, kann nicht garantiert werden, dass die Vorlagenausführung die Aufgabe verarbeitet. Andere Faktoren können dazu führen, dass die Aufgabe während der Vorlagenverarbeitung übersprungen wird.

    Weitere Informationen finden Sie unter Codierte Abfragezeichenfolgen .
    Tabelle : 22. Ausgabe
    Typ Beschreibung
    Boolean

    Kennzeichnung, die angibt, ob die Vorlage aktualisiert wurde.

    Gültige Werte:
    • true: Die Vorlage wurde aktualisiert.
    • false: Die Vorlage wurde aktualisiert. Die Vorlage befindet sich möglicherweise nicht im Entwurfsstatus (nicht veröffentlicht).

    Das folgende Beispiel zeigt, wie mehrere Eigenschaften einer vorhandenen Deduplizierungsvorlage aktualisiert werden.

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

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

    Ausgabe:

    true