DuplicateTemplate : Bereichsbezogen

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 23 Minuten Lesedauer

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

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

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

    Siehe auch: Identifizierungs -Engine: Bereichsbezogen

    Vorlagenlebenszyklus
    1. Verwenden Sie die CreateTemplate()- Methode, 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 PublisherTemplate()- Methode, um die Vorlage vom Status „Entwurf“ in den Status „Veröffentlicht“ zu versetzen.
      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 CMDBDuplicateTemplateUtil-Skripteinbindung, 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 requestCancelation().

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

    DuplicateTemplate – canAddTasksToTemplate(Array taskIds, String templatId)

    Überprüft, ob die bereitgestellte Aufgabenliste einer Vorlage hinzugefügt werden kann.

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

    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 nicht kompatibel, da sie keine übereinstimmende Vorlagenklasse haben. Daher wurde die Aufgabe übersprungen.
    Erfolg Die Aufgabe entspricht der Vorlagenklasse und kann der Vorlage hinzugefügt werden.

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

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

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

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

    Ausgabe:

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

    DuplicateTemplate – createTemplate(Objektvorlage)

    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 die Haupt-CI-Attribute mit Null-Werten aus doppelten CIs aktualisiert werden, wenn Attributkonflikte für CIs innerhalb einer Deduplizierungsaufgabe gelöst werden.
    Gültige Werte:
    • „wahr“: Die Haupt-CI-Attribute werden mit Nullwerten aus doppelten CIs aktualisiert.
    • „falsch“: Die Haupt-CI-Attribute werden nicht mit NULL-Werten aus doppelten CIs aktualisiert.

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

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

    Gültige Werte:
    • „wahr“: Es werden nur Updates von doppelten CIs einbezogen, wenn der Haupt-CI-Wert NULL ist.
    • „falsch“: Updates aus allen doppelten CIs einbeziehen.

    Standardwert: False
    template.description Zeichenfolge Optional. Beschreibung zum Speichern weiterer Informationen zur Vorlage.
    template.duplicate_​ci_action Zeichenfolge Optional. Gibt an, ob das doppelte CI gelöscht oder mit eindeutigen anwenderdefinierten Werten aktualisiert werden soll.
    Mögliche Optionen:
    • delete
    • update (erfordert die Angabe von duplicate_ci_updates)
    template.duplicate_​ci_updates Array Optional, es sei denn, die Einstellung für duplicate_ci_action lautet update. Array von Objekten, die angeben, 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 bei Anwendung dieser Vorlage für eine Deduplizierungsaufgabe ausgewählt wird.
    Mögliche Optionen:
    • bedingt ( master_ci_conditionmuss angegeben werden)
    • major_related_items: Attribute, die aus dem CI mit den meisten zugehörigen Elementen mit dem Haupt-CI zusammengeführt werden sollen.
    • major_relations: Attribute, die aus dem CI mit den meisten Beziehungen zum Haupt-CI zusammengeführt werden sollen.
    • neueste_created: Getrennte Attribute, die vom zuletzt aktualisierten CI mit dem Haupt-CI zusammengeführt werden sollen.
    • älteste_kreiert: Durch Kommas getrennte Attribute, die vom ältesten erstellten CI mit dem Haupt-CI zusammengeführt werden sollen.
    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.

    Einzelheiten 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 ist. Wenn die Abfrage „true“ zurückgibt, werden alle Beziehungen zusammengeführt. Bei „false“ werden keine Beziehungen zusammengeführt.

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

    Einzelheiten finden Sie unter Codierte Abfragezeichenfolgen .
    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äßigen zugehörigen Tabellen und alle zugehörigen Tabellen, die auf doppelte CIs für die über die Vorlage korrigierte Deduplizierungsaufgabe verweisen.
    • bedingt
    • Standard – Enthält zugehörige Einträge, die vom Modul „CI-Duplikatsnachbesserung – Zugehörige Standardelemente“ bereitgestellt werden.
    • Keine
    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"
  }
]

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

    Einzelheiten finden Sie unter Codierte Abfragezeichenfolgen .
    Tabelle : 4. Ausgabe
    Typ Beschreibung
    Zeichenfolge Sys_id der Vorlage, die in der Tabelle „Doppelte Vorlagen 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 die Haupt-CI-Attribute mit Null-Werten aus doppelten CIs aktualisiert werden, wenn Attributkonflikte für CIs innerhalb einer Deduplizierungsaufgabe gelöst werden.
    Gültige Werte:
    • „wahr“: Die Haupt-CI-Attribute werden mit Nullwerten aus doppelten CIs aktualisiert.
    • „falsch“: Die Haupt-CI-Attribute werden nicht mit NULL-Werten aus doppelten CIs aktualisiert.

    Datentyp: Boolesch
    <Object>.allow_master_ci_ null_update Schließt nur Updates von doppelten CIs ein, wenn der Haupt-CI-Wert NULL ist.
    Gültige Werte:
    • „wahr“: Es werden nur Updates von doppelten CIs einbezogen, wenn der Haupt-CI-Wert NULL ist.
    • „falsch“: Updates aus allen doppelten CIs einbeziehen.

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

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

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

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

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

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

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

    Datentyp: Zeichenfolge
    <Object>Option .master_ci_ Gibt an, wie das Haupt-CI bei Anwendung dieser Vorlage für eine Deduplizierungsaufgabe ausgewählt wird.
    Mögliche Optionen:
    • bedingt ( master_ci_conditionmuss angegeben werden)
    • major_related_items: Attribute, die aus dem CI mit den meisten zugehörigen Elementen mit dem Haupt-CI zusammengeführt werden sollen.
    • major_relations: Attribute, die aus dem CI mit den meisten Beziehungen zum Haupt-CI zusammengeführt werden sollen.
    • neueste_created: Getrennte Attribute, die vom zuletzt aktualisierten CI mit dem Haupt-CI zusammengeführt werden sollen.
    • älteste_kreiert: Durch Kommas getrennte Attribute, die vom ältesten erstellten CI mit dem Haupt-CI zusammengeführt werden sollen.

    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äßigen zugehörigen Tabellen und alle zugehörigen Tabellen, die auf doppelte CIs für die über die Vorlage korrigierte Deduplizierungsaufgabe verweisen.
    • bedingt
    • Standard – Enthält zugehörige Einträge, die vom Modul „CI-Duplikatsnachbesserung – Zugehörige Standardelemente“ bereitgestellt werden.
    • Keine

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

    Einzelheiten finden Sie unter Codierte Abfragezeichenfolgen .

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

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

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

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

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

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

    Datentyp: Zeichenfolge
    <Object>.task_condition_table Speicherort der Tabellenaufgabenbedingungen, d. h. der Tabelle zum Abgleich von doppelten Aufgabendaten [reconcile_duplicate_task_data]. Der Wert ändert sich nie, und die Tabelle ist nur zur internen Verwendung vorgesehen.

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

    Einzelheiten finden Sie unter Codierte Abfragezeichenfolgen .

    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 – Vorschau der Vorlage (Zeichenfolge für Vorlagen-ID, Aufgaben-ID für Zeichenfolge)

    Generiert eine Vorschau, wie verschiedene Vorlagenoptionen auf die Deduplizierungsaufgabe angewendet wurden und wie sie korrigiert werden soll.

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

    Die folgenden Attribute sind erforderlich:
    • duplicate_ci_action
    • Master_CI_Option
    • „merge_related_items“
    • merge_relations
    • name
    • Tabelle
    Hinweis:
    Obwohl diese Methode alle Attribute validiert, muss sich die Vorlage für eine Vorschau nicht im Status „Veröffentlicht“ befinden.

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

    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 „Aufgabe zur Duplikatnachbesserung“ [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 anwenderdefinierten Werten aktualisiert werden soll.
    Mögliche Optionen:
    • delete
    • update (erfordert die Angabe von duplicate_ci_updates)

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

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

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

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

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

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

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

    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äßigen zugehörigen Tabellen und alle zugehörigen Tabellen, die auf doppelte CIs für die über die Vorlage korrigierte Deduplizierungsaufgabe verweisen.
    • bedingt
    • Standard – Enthält zugehörige Einträge, die vom Modul „CI-Duplikatsnachbesserung – Zugehörige Standardelemente“ bereitgestellt werden.
    • Keine

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

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

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

    Datentyp: Zeichenfolge
    <Object>.taskId Sys_id der Deduplizierungsaufgabe, die in der Tabelle „Aufgabe zur Duplikatnachbesserung“ [reconcile_duplicate_task] aufgeführt ist.

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

    Datentyp: Boolesch

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

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

    Ausgabe:

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

    DuplicateTemplate – veröffentlichenTemplate(String templateId)

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

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

    Die folgenden Attribute sind erforderlich:
    • duplicate_ci_action
    • Master_CI_Option
    • „merge_related_items“
    • merge_relations
    • name
    • Tabelle

    Im Status „Veröffentlicht“ können Sie die Vorlage mit der runTemplate()- Methode 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:
    • wahr: Die Vorlage wurde veröffentlicht.
    • „falsch“: Die Vorlage wurde nicht veröffentlicht.

    Das folgende Beispiel zeigt, wie Sie eine Vorlage veröffentlichen und Ergebnisse anzeigen.

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

    Ausgabe:

    true

    DuplicateTemplate – remediateTask(Zeichenfolge templateId, Zeichenfolge taskId)

    Behebt eine Deduplizierungsaufgabe mithilfe der Vorlage.

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

    Verwenden Sie die Methode „ previewTemplate() “, 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 „Aufgabe zur Duplikatnachbesserung“ [reconcile_duplicate_task] aufgeführt ist.
    Tabelle : 12. Ausgabe
    Typ Beschreibung
    Zeichenfolge Bei Erfolg die Zusammenführungslösungs-ID für die Korrektur der Deduplizierungsaufgabe. Diese Zusammenführungslösungs-ID ist die sys_id eines Datensatzes in der Tabelle „Nachbesserung von CI-Duplikaten“ [cmdb_duplicate_ci_remediation]. Wenn dies nicht erfolgreich ist, befindet sich die Vorlage möglicherweise nicht im Status „Veröffentlicht“.

    Das folgende Beispiel zeigt, wie eine Deduplizierungsaufgabe behoben wird.

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

    Ausgabe:

    <merge_resolution_id>

    DuplicateTemplate – requestCancelation(String templateRunId)

    Bricht eine vorhandene Vorlagenausführung ab.

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

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

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

    Siehe auch:
    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 Abbruchanforderung erfolgreich war.

    Gültige Werte:
    • wahr: Die Abbruchanforderung war erfolgreich.
    • „falsch“: Die Abbruchanforderung war nicht erfolgreich.

    Das folgende Beispiel zeigt, wie Sie eine Vorlagenausführung abbrechen und anzeigen, ob der Vorgang erfolgreich war.

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

    Ausgabe:

    true

    DuplicateTemplate – retireTemplate(String templateId)

    Legt eine Vorlage still.

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

    Die Vorlage kann nicht stillgelegt werden, und die Methode löst unter den folgenden Bedingungen eine Ausnahme aus:
    • Die Vorlage befindet sich im Status „Veröffentlicht“.
    • Die Vorlage wird ausgeführt oder soll ausgeführt werden.
    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 stillgelegt ist.
    Gültige Werte:
    • „wahr“: Die Vorlage wird deaktiviert.
    • „falsch“: Die Vorlage konnte nicht stillgelegt werden, da sie ausgeführt wurde, zur Ausführung geplant war oder sich im Status „Veröffentlicht“ befand

    Das folgende Beispiel zeigt, wie Sie eine Vorlage stilllegen und Ergebnisse anzeigen.

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

    Ausgabe:

    true

    DuplicateTemplate – runTemplate(String templateId)

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

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

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

    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 Vorlage, die in der Tabelle „Deduplizierungsvorlagenausführung“ [reconcile_duplicate_template_run] aufgeführt wurde. Wenn dies nicht erfolgreich ist, befindet sich die Vorlage möglicherweise nicht im Status „Veröffentlicht“.

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

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

    Ausgabe:

    487c67e2046b2510f877c1665753a4cc

    DuplicateTemplate – unPublishTemplate(String templateId)

    Hebt die Veröffentlichung einer Vorlage auf.

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

    Siehe auch:
    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:
    • „wahr“: Die Veröffentlichung der Vorlage wurde erfolgreich aufgehoben.
    • „falsch“: Das Aufheben der Veröffentlichung der Vorlage wurde nicht erfolgreich aufgehoben. Die Vorlage wird möglicherweise ausgeführt oder ist zur Ausführung geplant.

    Im folgenden Beispiel wird gezeigt, wie Sie die Veröffentlichung einer Vorlage aufheben und Ergebnisse anzeigen.

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

    Ausgabe:

    true

    DuplicateTemplate – updateTemplate(String templateId, Object template)

    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 die Haupt-CI-Attribute mit Null-Werten aus doppelten CIs aktualisiert werden, wenn Attributkonflikte für CIs innerhalb einer Deduplizierungsaufgabe gelöst werden.
    Gültige Werte:
    • „wahr“: Die Haupt-CI-Attribute werden mit Nullwerten aus doppelten CIs aktualisiert.
    • „falsch“: Die Haupt-CI-Attribute werden nicht mit NULL-Werten aus doppelten CIs aktualisiert.

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

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

    Gültige Werte:
    • „wahr“: Es werden nur Updates von doppelten CIs einbezogen, wenn der Haupt-CI-Wert NULL ist.
    • „falsch“: Updates aus allen doppelten CIs einbeziehen.

    Standardwert: False
    template.description Zeichenfolge Optional. Beschreibung zum Speichern weiterer Informationen zur Vorlage.
    template.duplicate_​ci_action Zeichenfolge Optional. Gibt an, ob das doppelte CI gelöscht oder mit eindeutigen anwenderdefinierten Werten aktualisiert werden soll.
    Mögliche Optionen:
    • delete
    • update (erfordert die Angabe von duplicate_ci_updates)
    template.duplicate_​ci_updates Array Optional, es sei denn, die Einstellung für duplicate_ci_action lautet update. Array von Objekten, die angeben, 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 bei Anwendung dieser Vorlage für eine Deduplizierungsaufgabe ausgewählt wird.
    Mögliche Optionen:
    • bedingt ( master_ci_conditionmuss angegeben werden)
    • major_related_items: Attribute, die aus dem CI mit den meisten zugehörigen Elementen mit dem Haupt-CI zusammengeführt werden sollen.
    • major_relations: Attribute, die aus dem CI mit den meisten Beziehungen zum Haupt-CI zusammengeführt werden sollen.
    • neueste_created: Getrennte Attribute, die vom zuletzt aktualisierten CI mit dem Haupt-CI zusammengeführt werden sollen.
    • älteste_kreiert: Durch Kommas getrennte Attribute, die vom ältesten erstellten CI mit dem Haupt-CI zusammengeführt werden sollen.
    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.

    Einzelheiten 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 ist. Wenn die Abfrage „true“ zurückgibt, werden alle Beziehungen zusammengeführt. Bei „false“ werden keine Beziehungen zusammengeführt.

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

    Einzelheiten finden Sie unter Codierte Abfragezeichenfolgen .
    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äßigen zugehörigen Tabellen und alle zugehörigen Tabellen, die auf doppelte CIs für die über die Vorlage korrigierte Deduplizierungsaufgabe verweisen.
    • bedingt
    • Standard – Enthält zugehörige Einträge, die vom Modul „CI-Duplikatsnachbesserung – Zugehörige Standardelemente“ bereitgestellt werden.
    • Keine
    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"
  }
]

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

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

    Kennzeichnung, die angibt, ob die Vorlage aktualisiert wurde.

    Gültige Werte:
    • wahr: Die Vorlage wurde aktualisiert.
    • „falsch“: Die Vorlage wurde aktualisiert. Die Vorlage befindet sich möglicherweise nicht im Entwurfsstatus (nicht veröffentlicht).

    Das folgende Beispiel zeigt, wie Sie mehrere Eigenschaften einer vorhandenen Deduplizierungsvorlage aktualisieren.

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

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

    Ausgabe:

    true