DuplicateTemplate – Umfang

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 22 Minuten Lesedauer

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

    Die Korrektur von Deduplizierungsaufgaben kann zeitaufwändiger als wünschenswert sein, wenn sie einzeln behandelt wird. Mit Duplizierungsvorlagen können Sie eine Reihe doppelter Aufgaben gruppieren und gemeinsam ausführen. Verwenden Sie DuplicateTemplate API zum Erstellen und Verwenden von Deduplizierungsvorlagen. Diese API wird in ausgeführt sn_cmdb Namespace und erfordert die Rolle cmdb_dedup_admin für den Zugriff.

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

    Siehe auch: IdentifikationEngine – Umfang

    Vorlagenlebenszyklus
    1. Verwenden Sie CreateTemplate() Methode zum Erstellen einer Vorlage im Entwurfsstatus.
      Sie können die Vorlage mit den folgenden Methoden abrufen oder aktualisieren:
    2. Verwenden Sie PublishTemplate() Methode zum Verschieben der Vorlage vom Status „Entwurf“ in den Status „veröffentlicht“.
      Hinweis:
      Verwenden Sie UnPublishTemplate() Methode, um eine veröffentlichte Vorlage in den Entwurfsstatus zurückzugeben und die Vorlage zu aktualisieren.
    3. Optional. Verwenden Sie CMDBDuplicateTemplateUtil Skripteinbindung zum Hinzufügen oder Entfernen von Aufgaben.
    4. Verwenden Sie RunTemplate() Methode zum Ausführen der Vorlage.

      Um eine laufende Aufgabe abzubrechen, verwenden Sie Request Cancellation() Methode.

    5. Wenn die Vorlage nicht mehr benötigt wird, können Sie die Vorlage mit stilllegen RetireTemplate() Methode.
    Korrektur einer einzelnen Aufgabe mithilfe einer Vorlage
    Um eine einzelne Aufgabe zu korrigieren, ohne die Vorlage auszuführen, können Sie eine Vorschau der Deduplizierungsaufgaben anzeigen und korrigieren.
    1. Verwenden Sie PreviewTemplate() Methode zur Vorschau der Korrektur einer einzelnen Aufgabe mit einer Vorlage.
    2. Verwenden Sie RemediateTask() Methode zum Nachbessern der Deduplizierungsaufgabe mit einer Vorlage.

    DuplicateTemplate – canAddTasksToTemplate(Array taskIds, Zeichenfolge templatId)

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

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

    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. Rückgaben
    Typ Beschreibung
    Objekt Ergebnisobjekt, das enthält, welche Aufgaben hinzugefügt, übersprungen oder fehlgeschlagenen Aufgaben hinzugefügt werden können.
    {
  "success": [
    "<task_id_1>",
    "<task_id_2>",
    "<task_id_3>"
  ],
  "failed": [
    "<task_id_4>"
  ],
  "skipped": [
    "<task_id_5>"
  ]
}
    Fehlgeschlagen Fehler beim Überprüfen, ob die Aufgabe mit der Vorlage kompatibel ist. Siehe auch Detecting duplicate CIs.
    übersprungen Die Aufgaben sind inkompatibel, da sie keine übereinstimmende Vorlagenklasse haben, daher wurde die Aufgabe übersprungen.
    Erfolg Die Aufgabe stimmt mit der Vorlagenklasse überein und kann der Vorlage hinzugefügt werden.

    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 Haupt-CI-Attribute bei der Lösung von Attributkonflikten für CIs innerhalb einer Deduplizierungsaufgabe mit Nullwerten aus doppelten CIs aktualisiert werden.
    Gültige Werte:
    • Wahr: Die Haupt-CI-Attribute werden mit Nullwerten aus doppelten CIs aktualisiert.
    • Falsch: Die Haupt-CI-Attribute werden nicht mit Nullwerten aus doppelten CIs aktualisiert.

    Standardwert: False
    Template.allow_Master_ci_​null_Update Boolean Optional. Enthält nur Updates aus doppelten CIs, wenn der Haupt-CI-Wert Null ist.

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

    Gültige Werte:
    • Wahr: Updates aus doppelten CIs nur einschließen, wenn der CI-Hauptwert null ist.
    • Falsch: Updates von allen doppelten CIs einschließen.

    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:
    • löschen
    • Aktualisieren (muss angegeben werden duplicate_ci_updates)
    Template.duplicate_​ci_Updates Array Optional, es sei denn, die Einstellung für duplicate_ci_actionIst Aktualisieren . Array von Objekten, das angibt, wie die doppelten CI-Werte aktualisiert werden.
    [
  {
    "element": "String",
    "element_label": "String",
    "value": "String",
    "display": "String"
  }
]
    Template.Duplikat_​ci_Updates.Element Zeichenfolge Der Name des Systemwörterbuchs eines Referenzfelds.
    Template.Duplikat_​ci_Updates.Element_label Zeichenfolge Die Bezeichnung, die im Referenzfeld angezeigt wird.
    Template.duplicate_​ci_Updates.value Zeichenfolge Wert für ein Referenzfeld, d. h. den Inhalt des Referenzfelds.
    Template.duplicate_​ci_Updates.Display Zeichenfolge Anzeigewert für ein Referenzfeld.
    Template.Master_ci_-​Option Zeichenfolge Optional. Gibt an, wie das Haupt-CI für eine Deduplizierungsaufgabe ausgewählt wird, wenn diese Vorlage angewendet wird.
    Mögliche Optionen:
    • Bedingt (muss angegeben werden master_ci_condition)
    • Most_related_items: Attribute, die aus dem CI mit den am meisten zugehörigen Elementen zum Haupt-CI zusammengeführt werden sollen.
    • Most_Relations: Attribute, die aus dem CI mit den meisten Beziehungen zum Haupt-CI zusammengeführt werden sollen.
    • Neueste_erstellte: Getrennte Attribute, die vom zuletzt aktualisierten CI zum Haupt-CI zusammengeführt werden sollen.
    • Älteste_erstellte: Kommagetrennte Attribute, die vom ältesten erstellten CI mit dem Haupt-CI zusammengeführt werden sollen.
    Template.Master_ci_ Bedingung Zeichenfolge Optional (erforderlich, wenn der Wert von master_ci_optionIst Bedingt ). Codierte Abfrage, um anzugeben, wie das Haupt-CI ausgewählt wird. Wenn mehrere CIs oder keine CIs mit der Abfrage übereinstimmen, wählt die Methode das zuletzt aktualisierte CI als Haupt-CI aus. Die codierte Abfrage wird für die Vorlagentabelle ausgewertet. Diese Tabelle wird in identifiziert tableEigenschaft.

    Weitere Informationen finden Sie unter Codierte Abfragezeichenfolgen .
    Vorlage.Merge_Relations Zeichenfolge Optional. Gibt an, wie die Beziehungen für doppelte CIs innerhalb einer Deduplizierungsaufgabe beim Anwenden dieser Vorlage zusammengeführt werden.
    Mögliche Optionen:
    • alle
    • Bedingt
    • Keine
    Vorlage.Merge_Relations Zeichenfolge Optional. Gibt an, wie die Beziehungen für doppelte CIs innerhalb einer Deduplizierungsaufgabe beim Anwenden dieser Vorlage zusammengeführt werden.
    Mögliche Optionen:
    • alle
    • Bedingt
    • Keine
    Template.MERGE_Relations_-​Bedingung Zeichenfolge Optional (erforderlich, wenn der Wert von merge_relationsIst Bedingt ). Codierte Abfrage, um anzugeben, ob alle oder keine der Beziehungen aus doppelten CIs zusammengeführt werden. Die Abfrage wird für das Haupt-CI ausgewertet, das für die Deduplizierungsaufgabe ausgewählt ist. Wenn die Abfrage „wahr“ zurückgibt, werden alle Beziehungen zusammengeführt. Bei „falsch“ werden keine Beziehungen zusammengeführt.

    Die codierte Abfrage wird für die Vorlagentabelle ausgewertet. Diese Tabelle wird in identifiziert tableEigenschaft.

    Weitere Informationen finden Sie unter Codierte Abfragezeichenfolgen .
    Vorlage.MERGE_related_items Zeichenfolge Optional. Gibt an, welche zugehörigen Tabellen für doppelte CIs innerhalb einer Deduplizierungsaufgabe mit dem Haupt-CI zusammengeführt werden, wenn diese Vorlage angewendet wird. Siehe auch Remediate a de-duplication task (manual).
    Mögliche Optionen:
    • All_available: Enthält die standardbezogenen Tabellen und alle zugehörigen Tabellen, die auf doppelte CIs für die über die Vorlage korrigierte Deduplizierungsaufgabe verweisen.
    • Bedingt
    • Standard: Schließt zugehörige Einträge ein, die vom Modul „Nachbesserung von CI-Duplikaten“ für standardmäßige zugehörige Elemente bereitgestellt werden.
    • Keine
    Template.MERGE_related_items_-​Bedingung Array Optional. Liste der zugehörigen Einträge mit einer codierten Abfrage für jeden zugehörigen Eintrag. Jede Abfrage wird für das Haupt-CI ausgewertet, das für die Aufgabe ausgewählt ist. Wenn die Abfrage „wahr“ zurückgibt, werden die zugehörigen Einträge während der Korrektur einer Deduplizierungsaufgabe zusammengeführt. Bei „falsch“ werden zugehörige Einträge nicht zusammengeführt.
    "merge_related_items_condition": [
  {
    "related_entry": "String",
    "condition": "String"
  }
]

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

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

    Das folgende Beispiel zeigt, wie Sie eine Deduplizierungsvorlage erstellen.

    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 bei der Lösung von Attributkonflikten für CIs innerhalb einer Deduplizierungsaufgabe mit Nullwerten aus doppelten CIs aktualisiert werden.
    Gültige Werte:
    • Wahr: Die Haupt-CI-Attribute werden mit Nullwerten aus doppelten CIs aktualisiert.
    • Falsch: Die Haupt-CI-Attribute werden nicht mit Nullwerten aus doppelten CIs aktualisiert.

    Datentyp: Boolesch
    <Object>.Allow_Master_ci_ null_Update Enthält nur Updates aus doppelten CIs, wenn der Haupt-CI-Wert Null ist.
    Gültige Werte:
    • Wahr: Updates aus doppelten CIs nur einschließen, wenn der CI-Hauptwert null ist.
    • Falsch: Updates von allen doppelten CIs einschließen.

    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 anwenderdefinierten Werten aktualisiert werden soll.
    Mögliche Optionen:
    • löschen
    • Aktualisieren (muss angegeben werden duplicate_ci_updates)

    Datentyp: Zeichenfolge
    <Object>.Duplikat_ 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 Name des Systemwörterbuchs eines Referenzfelds.

    Datentyp: Zeichenfolge
    <Object>.DuplicateCIUpdates.Element_label Die Bezeichnung, die im Referenzfeld angezeigt wird.

    Datentyp: Zeichenfolge
    <Object>.DuplicateCIUpdates.value Wert für ein Referenzfeld, d. h. den Inhalt des Referenzfelds.

    Datentyp: Zeichenfolge
    <Object>.DuplikatCIUpdates.Anzeige Anzeigewert für ein Referenzfeld.

    Datentyp: Zeichenfolge
    <Object>.Master_ci_-Option Gibt an, wie das Haupt-CI für eine Deduplizierungsaufgabe ausgewählt wird, wenn diese Vorlage angewendet wird.
    Mögliche Optionen:
    • Bedingt (muss angegeben werden master_ci_condition)
    • Most_related_items: Attribute, die aus dem CI mit den am meisten zugehörigen Elementen zum Haupt-CI zusammengeführt werden sollen.
    • Most_Relations: Attribute, die aus dem CI mit den meisten Beziehungen zum Haupt-CI zusammengeführt werden sollen.
    • Neueste_erstellte: Getrennte Attribute, die vom zuletzt aktualisierten CI zum Haupt-CI zusammengeführt werden sollen.
    • Älteste_erstellte: 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 beim Anwenden 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 mit dem Haupt-CI zusammengeführt werden, wenn diese Vorlage angewendet wird. Siehe auch Remediate a de-duplication task (manual).
    Mögliche Optionen:
    • All_available: Enthält die standardbezogenen Tabellen und alle zugehörigen Tabellen, die auf doppelte CIs für die über die Vorlage korrigierte Deduplizierungsaufgabe verweisen.
    • Bedingt
    • Standard: Schließt zugehörige Einträge ein, die vom Modul „Nachbesserung von CI-Duplikaten“ für standardmäßige zugehörige Elemente 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 „wahr“ zurückgibt, werden die zugehörigen Einträge während der Korrektur einer Deduplizierungsaufgabe zusammengeführt. Bei „falsch“ werden zugehörige Einträge nicht zusammengeführt.

    Weitere Informationen finden Sie unter Codierte Abfragezeichenfolgen .

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

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

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

    Datentyp: Zeichenfolge
    <Object>.Neueste_aktualisierte_ MERGE_attributes Kommagetrennte Attribute, die vom zuletzt aktualisierten CI zum Haupt-CI zusammengeführt werden sollen.

    Datentyp: Zeichenfolge
    <Object>.Oldest_created_ MERGE_attributes Kommagetrennte Attribute, die vom ältesten erstellten CI zum Haupt-CI zusammengeführt werden sollen.

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

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

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

    Weitere Informationen finden Sie unter Codierte Abfragezeichenfolgen .

    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(Zeichenfolge templateId, Zeichenfolge taskId)

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

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

    Die folgenden Attribute sind erforderlich:
    • Duplikat_ci_Aktion
    • Master_ci_Option
    • Merge_related_items
    • Merge_Relations
    • name
    • table
    Hinweis:
    Diese Methode validiert zwar alle Attribute, es ist jedoch nicht erforderlich, dass die Vorlage für eine Vorschau im Status „veröffentlicht“ ist.

    Verwenden Sie RemediateTask() Methode zum Nachbessern von Deduplizierungsaufgaben.

    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 nachbessern“ [Reconcile_duplicate_Task] aufgeführt ist.
    Tabelle : 8. Ausgabe
    Typ Beschreibung
    Objekt Vorschauobjekt mit Werten, die zeigen, wie die Deduplizierungsaufgaben mit der Vorlage korrigiert werden können.
    {
  "allClassCIMap": {Object},
  "duplicateCIAction": "String",
  "duplicateCIUpdates": [Array],
  "masterCI": "String",
  "mergeRelations": Boolean,
  "relatedTablesMerged": [Array],  
  "resolvedFieldCIMap": [Array],
  "taskId": "String",
  "tooManyDuplicates": Boolean
}
    <Object>.AllClassCIMap Liste der sys_IDs der CIs innerhalb einer Deduplizierungsaufgabe , Gruppiert nach CI-Klasse. 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:
    • löschen
    • Aktualisieren (muss angegeben werden 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 Name des Systemwörterbuchs eines Referenzfelds.

    Datentyp: Zeichenfolge
    <Object>.DuplicateCIUpdates.Element_label Die Bezeichnung, die im Referenzfeld angezeigt wird.

    Datentyp: Zeichenfolge
    <Object>.DuplicateCIUpdates.value Wert für ein Referenzfeld, d. h. den Inhalt des Referenzfelds.

    Datentyp: Zeichenfolge
    <Object>.DuplikatCIUpdates.Anzeige Anzeigewert für ein Referenzfeld.

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

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

    Datentyp: Zeichenfolge
    <Object>.RelatedTablesMerged Gibt an, welche zugehörigen Tabellen für doppelte CIs innerhalb einer Deduplizierungsaufgabe mit dem Haupt-CI zusammengeführt werden, wenn diese Vorlage angewendet wird. Siehe auch Remediate a de-duplication task (manual).
    Mögliche Optionen:
    • All_available: Enthält die standardbezogenen Tabellen und alle zugehörigen Tabellen, die auf doppelte CIs für die über die Vorlage korrigierte Deduplizierungsaufgabe verweisen.
    • Bedingt
    • Standard: Schließt zugehörige Einträge ein, die vom Modul „Nachbesserung von CI-Duplikaten“ für standardmäßige zugehörige Elemente bereitgestellt werden.
    • Keine

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

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

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

    Datentyp: Zeichenfolge
    <Object>.TaskId SYS_ID der Deduplizierungsaufgabe, die in der Tabelle „Duplikataufgabe nachbessern“ [Reconcile_duplicate_Task] aufgeführt ist.

    Datentyp: Zeichenfolge
    <Object>.TooManyDuplikate Kennzeichnung, die angibt, ob die Aufgabe mehr als die maximale Anzahl von CIs hat. Der Schwellenwert wird durch Vergleich des Werts der Systemeigenschaft Glide.duplicate_ci_ Remediator.max.cis (Standardwert 1000 CIs) bestimmt.
    Gültige Werte:
    • Wahr: Die Aufgabenzahl von CIs überschreitet die maximale Anzahl von CIs.
    • Falsch: Die Aufgabenzahl von CIs überschreitet die maximale Anzahl von CIs nicht.

    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 – publishTemplate(Zeichenfolge templateId)

    Veröffentlicht eine Vorlage. Wenn erfolgreich, wechselt die Vorlage vom Status „Entwurf“ in den Status „veröffentlicht“.

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

    Die folgenden Attribute sind erforderlich:
    • Duplikat_ci_Aktion
    • Master_ci_Option
    • Merge_related_items
    • Merge_Relations
    • name
    • table

    Im Status „veröffentlicht“ können Sie die Vorlage mit ausführen RunTemplate() Methode.

    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 eine Vorlage veröffentlicht und Ergebnisse angezeigt werden.

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

    Ausgabe:

    true

    DuplicateTemplate – remediateTask(Zeichenfolge templateId, Zeichenfolge taskId)

    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 PreviewTemplate() Methode zur Vorschau der Korrektur von Deduplizierungsaufgaben.

    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 nachbessern“ [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ührungs-Lösungs-ID ist die sys_ID eines Datensatzes in der Tabelle „Nachbesserung doppelter CIs“ [cmdb_duplicate_ci_Remediation]. Wenn nicht erfolgreich, befindet sich die Vorlage möglicherweise nicht im Status „veröffentlicht“.

    Das folgende Beispiel zeigt, wie Sie eine Deduplizierungsaufgabe nachbessern.

    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 Abbruchanforderung 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 Zwischenphase „Abbrechen angefordert“.

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

    Siehe auch:
    Tabelle : 13. Parameter
    Name Typ Beschreibung
    TemplateRunId Zeichenfolge SYS_ID der Vorlagenausführung, die in der Tabelle „Ausführung der Deduplizierungsvorlage“ [Reconcile_duplicate_template_Run] aufgeführt ist.
    Tabelle : 14. Rückgaben
    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 ist.

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

    Ausgabe:

    true

    DuplicateTemplate – retireTemplate(Zeichenfolge templateId)

    Legt eine Vorlage außer Kraft.

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

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

    Das folgende Beispiel zeigt, wie eine Vorlage stillgelegt und Ergebnisse angezeigt werden.

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

    Ausgabe:

    true

    DuplicateTemplate – runTemplate(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 PublishTemplate() Methode zum Verschieben der Vorlage vom Status „Entwurf“ in den Status „veröffentlicht“.

    Um eine laufende Aufgabe abzubrechen, verwenden Sie Request Cancellation() Methode.

    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 „Ausführung der Deduplizierungsvorlage“ [Reconcile_duplicate_template_Run] aufgeführt ist. Wenn nicht erfolgreich, befindet sich die Vorlage möglicherweise nicht im Status „veröffentlicht“.

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

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

    Ausgabe:

    487c67e2046b2510f877c1665753a4cc

    DuplicateTemplate – unPublishTemplate(Zeichenfolge templateId)

    Hebt die Veröffentlichung einer Vorlage auf.

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

    Siehe auch:
    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: Die Veröffentlichung der Vorlage wurde nicht erfolgreich aufgehoben. Die Vorlage wird möglicherweise ausgeführt oder soll ausgeführt werden.

    Das folgende Beispiel zeigt, wie die Veröffentlichung einer Vorlage rückgängig gemacht und Ergebnisse angezeigt werden.

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

    Ausgabe:

    true

    DuplicateTemplate – updateTemplate(Zeichenfolge templateId, Objektvorlage)

    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 bei der Lösung von Attributkonflikten für CIs innerhalb einer Deduplizierungsaufgabe mit Nullwerten aus doppelten CIs aktualisiert werden.
    Gültige Werte:
    • Wahr: Die Haupt-CI-Attribute werden mit Nullwerten aus doppelten CIs aktualisiert.
    • Falsch: Die Haupt-CI-Attribute werden nicht mit Nullwerten aus doppelten CIs aktualisiert.

    Standardwert: False
    Template.allow_Master_ci_​null_Update Boolean Optional. Enthält nur Updates aus doppelten CIs, wenn der Haupt-CI-Wert Null ist.

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

    Gültige Werte:
    • Wahr: Updates aus doppelten CIs nur einschließen, wenn der CI-Hauptwert null ist.
    • Falsch: Updates von allen doppelten CIs einschließen.

    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:
    • löschen
    • Aktualisieren (muss angegeben werden duplicate_ci_updates)
    Template.duplicate_​ci_Updates Array Optional, es sei denn, die Einstellung für duplicate_ci_actionIst Aktualisieren . Array von Objekten, das angibt, wie die doppelten CI-Werte aktualisiert werden.
    [
  {
    "element": "String",
    "element_label": "String",
    "value": "String",
    "display": "String"
  }
]
    Template.Duplikat_​ci_Updates.Element Zeichenfolge Der Name des Systemwörterbuchs eines Referenzfelds.
    Template.Duplikat_​ci_Updates.Element_label Zeichenfolge Die Bezeichnung, die im Referenzfeld angezeigt wird.
    Template.duplicate_​ci_Updates.value Zeichenfolge Wert für ein Referenzfeld, d. h. den Inhalt des Referenzfelds.
    Template.duplicate_​ci_Updates.Display Zeichenfolge Anzeigewert für ein Referenzfeld.
    Template.Master_ci_-​Option Zeichenfolge Optional. Gibt an, wie das Haupt-CI für eine Deduplizierungsaufgabe ausgewählt wird, wenn diese Vorlage angewendet wird.
    Mögliche Optionen:
    • Bedingt (muss angegeben werden master_ci_condition)
    • Most_related_items: Attribute, die aus dem CI mit den am meisten zugehörigen Elementen zum Haupt-CI zusammengeführt werden sollen.
    • Most_Relations: Attribute, die aus dem CI mit den meisten Beziehungen zum Haupt-CI zusammengeführt werden sollen.
    • Neueste_erstellte: Getrennte Attribute, die vom zuletzt aktualisierten CI zum Haupt-CI zusammengeführt werden sollen.
    • Älteste_erstellte: Kommagetrennte Attribute, die vom ältesten erstellten CI mit dem Haupt-CI zusammengeführt werden sollen.
    Template.Master_ci_ Bedingung Zeichenfolge Optional (erforderlich, wenn der Wert von master_ci_optionIst Bedingt ). Codierte Abfrage, um anzugeben, wie das Haupt-CI ausgewählt wird. Wenn mehrere CIs oder keine CIs mit der Abfrage übereinstimmen, wählt die Methode das zuletzt aktualisierte CI als Haupt-CI aus. Die codierte Abfrage wird für die Vorlagentabelle ausgewertet. Diese Tabelle wird in identifiziert tableEigenschaft.

    Weitere Informationen finden Sie unter Codierte Abfragezeichenfolgen .
    Vorlage.Merge_Relations Zeichenfolge Optional. Gibt an, wie die Beziehungen für doppelte CIs innerhalb einer Deduplizierungsaufgabe beim Anwenden dieser Vorlage zusammengeführt werden.
    Mögliche Optionen:
    • alle
    • Bedingt
    • Keine
    Vorlage.Merge_Relations Zeichenfolge Optional. Gibt an, wie die Beziehungen für doppelte CIs innerhalb einer Deduplizierungsaufgabe beim Anwenden dieser Vorlage zusammengeführt werden.
    Mögliche Optionen:
    • alle
    • Bedingt
    • Keine
    Template.MERGE_Relations_-​Bedingung Zeichenfolge Optional (erforderlich, wenn der Wert von merge_relationsIst Bedingt ). Codierte Abfrage, um anzugeben, ob alle oder keine der Beziehungen aus doppelten CIs zusammengeführt werden. Die Abfrage wird für das Haupt-CI ausgewertet, das für die Deduplizierungsaufgabe ausgewählt ist. Wenn die Abfrage „wahr“ zurückgibt, werden alle Beziehungen zusammengeführt. Bei „falsch“ werden keine Beziehungen zusammengeführt.

    Die codierte Abfrage wird für die Vorlagentabelle ausgewertet. Diese Tabelle wird in identifiziert tableEigenschaft.

    Weitere Informationen finden Sie unter Codierte Abfragezeichenfolgen .
    Vorlage.MERGE_related_items Zeichenfolge Optional. Gibt an, welche zugehörigen Tabellen für doppelte CIs innerhalb einer Deduplizierungsaufgabe mit dem Haupt-CI zusammengeführt werden, wenn diese Vorlage angewendet wird. Siehe auch Remediate a de-duplication task (manual).
    Mögliche Optionen:
    • All_available: Enthält die standardbezogenen Tabellen und alle zugehörigen Tabellen, die auf doppelte CIs für die über die Vorlage korrigierte Deduplizierungsaufgabe verweisen.
    • Bedingt
    • Standard: Schließt zugehörige Einträge ein, die vom Modul „Nachbesserung von CI-Duplikaten“ für standardmäßige zugehörige Elemente bereitgestellt werden.
    • Keine
    Template.MERGE_related_items_-​Bedingung Array Optional. Liste der zugehörigen Einträge mit einer codierten Abfrage für jeden zugehörigen Eintrag. Jede Abfrage wird für das Haupt-CI ausgewertet, das für die Aufgabe ausgewählt ist. Wenn die Abfrage „wahr“ zurückgibt, werden die zugehörigen Einträge während der Korrektur einer Deduplizierungsaufgabe zusammengeführt. Bei „falsch“ werden zugehörige Einträge nicht zusammengeführt.
    "merge_related_items_condition": [
  {
    "related_entry": "String",
    "condition": "String"
  }
]

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

    Weitere Informationen finden Sie unter Codierte Abfragezeichenfolgen .
    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 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