IdentificationEngine – Scoped

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

    • Die IdentificationEngine -API verwendet das Identification and Reconciliation-Framework, um die Erstellung doppelter Konfigurationselemente (CIs) zu minimieren und CI-Attribute abzugleichen, indem beim Aktualisieren von Configuration Management Database (CMDB)nur Informationen aus autorisierten Datenquellen akzeptiert werden.

    Wenn Sie diese Klasse in einer bereichsbezogenen Anwendung verwenden, verwenden Sie den Namespace-Identifier sn_cmdb.

    IdentificationEngine – createOrUpdateCI(String source, String input)

    Fügt Konfigurationselemente (CIs) und NichtConfiguration Management Database (CMDB) - -CIs (Klassen, die sich nicht aus cmdb_ci erstrecken) basierend auf Identifizierungs- und Abgleichregeln in CMDB ] ein oder aktualisiert sie. Verwenden Sie diese API, anstatt CMDB direkt zu aktualisieren.

    Weitere Informationen zur Nicht-CMDB-Tabellenerfassung finden Sie unter IRE support for non-CMDB tables.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Eingabe Zeichenfolge Erforderlich. Eingabenutzlast Eine JSON-formatierte Zeichenfolge von Konfigurationselementen, die hinzugefügt oder aktualisiert werden soll. 
    "input" { 
 "items": [Array],
 "referenceItems": [Array],
 "relations": [Array]
}
    input.items Array Array von Objekten, die die hinzuzufügenden oder zu aktualisierenden Elemente definieren.
    "items": [
  { 
    "className": "String",
    "display_values": {Object},
    "internal_id": "String",
    "lookup": [Array],
    "related": [Array],
    "settings": {Object},
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    input.items.className Zeichenfolge Erforderlich. Klassen-/Tabellenname, sys_class_name, des Konfigurationselements (CI), das erstellt oder aktualisiert werden soll.

    Dieser Wert kann eine beliebige CMDB Klasse/Tabelle sein, z. B. cmdb_ci_linux_server oder cmdb_ci_win_server.
    input.items.display_values Objekt Referenzfelder, die für dieses zugehörige Element als Name-Wert-Paare erstellt oder aktualisiert werden sollen, wobei der Name der Feldname und der Wert der referenzierte Anzeigewert ist. Wenn Sie die sys_id anstelle des Anzeigewerts für Referenzfelder verwenden möchten, übergeben Sie die Informationen im Parameter input.items.lookup.values und nicht in diesem Parameter.

    Referenzfeldnamen hängen von den vom Benutzer ausgewählten Feldern ab, z. B.:

    "display_values": {
  "model_id": "String",
  "location": "String"
}
    input.items.internal_id Zeichenfolge Eindeutiger Elementbezeichner für die zugeordnete Nutzlast.

    Dies kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein.
    input.items.lookup Array Identifiziert das Element der obersten Ebene, das die Suche enthält (suchbasierte Identifizierung). Diese Datensätze werden verwendet, um das Konfigurationselement basierend auf einer Suchtabelle zu identifizieren, die einen Verweis auf cmdb_ci enthält.

    Beispiel:

    "lookup": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    input.items.lookup.className Zeichenfolge Erforderlich. Klassen-/Tabellenname, sys_class_name, des Konfigurationselements (CI), das erstellt oder aktualisiert werden soll.

    Dieser Wert kann eine beliebige CMDB Klasse/Tabelle sein, z. B. cmdb_serial_number oder cmdb_ci_network_adapter.
    input.items.lookup.internal_id Zeichenfolge Eindeutiger Elementbezeichner für die zugeordnete Nutzlast.

    Dies kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein.
    input.items.lookup.sys_object_source_info Objekt Eindeutiger CI-Bezeichner für eine bestimmte Quelle.
    "sys_object_source_info": { 
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    input.items.lookup.sys_object_source_info.source_feed Zeichenfolge Wenn die Quelle mehrere Feeds haben kann, geben Sie in diesem Feld den Namen des Feeds an, der dieses Element sendet.

    Die Datenquelle generiert diesen Feed-Namen. Es kann eine beliebige Zeichenfolge sein, die den Quell-Feed eindeutig identifiziert.
    input.items.lookup.sys_object_source_info.source_name Zeichenfolge Datenquelle der CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.
    input.items.lookup.sys_object_source_info.source_native_key Zeichenfolge Eindeutiger Schlüssel/ID für das Element aus der Quelle.

    Die Datenquelle generiert diesen Schlüssel. Es kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist.
    input.items.lookup.sys_object_source_info.source_recency_timestamp Zeichenfolge UTC-Datum und Uhrzeit, zu der das Element gescannt wurde.

    Format: JJJJ-MM-TT hh:mm:ss
    input.items.lookup.values Objekt Felder, die für dieses zugehörige Element als Name/Wert-Paare erstellt oder aktualisiert werden sollen, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_id sein. Wenn Sie den Anzeigewert anstelle der sys_id für Referenzfelder verwenden möchten, übergeben Sie diese Informationen in einem display_values -Objekt anstatt im values -Objekt.

    Feldnamen und -typen hängen von den vom Benutzer ausgewählten Feldern ab, z. B.:

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    input.items.related Array Verweis auf das oberste Element, das die zugehörige Liste enthält. Regeln im Zugehörigen Eintrag [cmdb_related_entry] definieren, welche Art von Datensätzen in diesem Array enthalten sein kann. Diese Datensätze werden verwendet, um Elemente basierend auf einer zugehörigen Tabelle hinzuzufügen, die einen Verweis auf das identifizierte CI enthält.

    Die zugehörige Tabelle kann cmdb_ci erweitern oder nicht. Diese Datensätze werden nicht zum Identifizieren des Konfigurationselements verwendet.

    "related" [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    input.items.related.className Zeichenfolge Erforderlich. Klassen-/Tabellenname, sys_class_name, des Konfigurationselements (CI), das erstellt oder aktualisiert werden soll.

    Dieser Wert kann eine beliebige CMDB Klasse/Tabelle sein, z. B. cmdb_software_instance oder cmdb_key_value.
    input.items.related.internal_id Zeichenfolge Eindeutiger Elementbezeichner für die zugeordnete Nutzlast.

    Dies kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein.
    input.items.related.sys_object_source_info Objekt Eindeutiger CI-Bezeichner für eine bestimmte Quelle.
    "sys_object_source_info": { 
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    input.items.related.sys_object_source_info.source_feed Zeichenfolge Wenn die Quelle mehrere Feeds haben kann, geben Sie in diesem Feld den Namen des Feeds an, der dieses Element sendet.

    Die Datenquelle generiert diesen Feed-Namen. Es kann eine beliebige Zeichenfolge sein, die den Quell-Feed eindeutig identifiziert.
    input.items.related.sys_object_source_info.source_name Zeichenfolge Datenquelle der CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.
    input.items.related.sys_object_source_info.source_native_key Zeichenfolge Eindeutiger Schlüssel/ID für das Element aus der Quelle.

    Die Datenquelle generiert diesen Schlüssel. Es kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist.
    input.items.related.sys_object_source_info.source_recency_timestamp Zeichenfolge UTC-Datum und Uhrzeit, zu der das Element gescannt wurde.

    Format: JJJJ-MM-TT hh:mm:ss
    input.items.related.values Objekt Felder, die für dieses zugehörige Element als Name/Wert-Paare erstellt oder aktualisiert werden sollen, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_id sein. Wenn Sie den Anzeigewert anstelle der sys_id für Referenzfelder verwenden möchten, übergeben Sie diese Informationen in einem display_values -Objekt anstatt im values -Objekt.

    Feldnamen und -typen hängen von den vom Benutzer ausgewählten Feldern ab, z. B.:

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    input.items.settings Objekt Parameter, die die zulässigen Aktualisierungstypen definieren.
    "settings": { 
  "skipReclassificationRestrictionRules": Boolean, 
  "updateWithoutDowngrade": Boolean, 
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    input.items.settings.skipReclassificationRestrictionRules Boolean Kennzeichnung, die angibt, ob IRE die Regel zur Einschränkung der Neuklassifizierung ausführen soll, die der Klasse für das Nutzlastelement entspricht.
    Gültige Werte:
    • true: Ausführung der Regel überspringen.
    • false: Regel wird ausgeführt.

    Standardwert: false
    input.items.settings.updateWithoutDowngrade Boolean Kennzeichnung, die angibt, ob sowohl Aktualisierung als auch Downgrade für dieses Element zulässig sind.
    Gültige Werte:
    • true: Element aktualisieren, Downgrade ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierung als auch Downgrade sind zulässig.

    Standardwert: false
    input.items.settings.updateOhneUpgrade Boolean Kennzeichnung, die angibt, ob Update und Upgrade für dieses Element zulässig sind.
    Gültige Werte:
    • true: Element wird aktualisiert, Upgrade ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Upgrades sind zulässig.

    Standardwert: false
    input.items.settings.updateWithoutSwitch Boolean Kennzeichnung, die angibt, ob das Element aktualisiert und die Klasse gewechselt werden kann.
    Gültige Werte:
    • true: Element aktualisieren, Klassenwechsel ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Klassenwechsel sind zulässig.

    Standardwert: false
    input.items.sys_object_source_info Objekt Eindeutiger CI-Bezeichner für eine bestimmte Quelle.
    "sys_object_source_info": { 
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    input.items.sys_object_source_info.source_feed Zeichenfolge Wenn die Quelle mehrere Feeds haben kann, geben Sie in diesem Feld den Namen des Feeds an, der dieses Element sendet.

    Die Datenquelle generiert diesen Feed-Namen. Es kann eine beliebige Zeichenfolge sein, die den Quell-Feed eindeutig identifiziert.
    input.items.sys_object_source_info.source_name Zeichenfolge Datenquelle der CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.
    input.items.sys_object_source_info.source_native_key Zeichenfolge Eindeutiger Schlüssel/ID für das Element aus der Quelle.

    Die Datenquelle generiert diesen Schlüssel. Es kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist.
    input.items.sys_object_source_info.source_recency_timestamp Zeichenfolge UTC-Datum und Uhrzeit, zu der das Element gescannt wurde.

    Format: JJJJ-MM-TT hh:mm:ss
    input.items.values Objekt Felder, die für dieses zugehörige Element als Name/Wert-Paare erstellt oder aktualisiert werden sollen, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_id sein. Wenn Sie den Anzeigewert anstelle der sys_id für Referenzfelder verwenden möchten, übergeben Sie diese Informationen in einem display_values -Objekt anstatt im values -Objekt.

    Feldnamen und -typen hängen von den vom Benutzer ausgewählten Feldern ab, z. B.:

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    input.referenceItems Array Array von Objekten, die Referenzen zwischen Elementen in der Eingabenutzlast definieren. 
    "referenceItems": [
  { 
    "referenced": "String", 
    "referencedBy": "String", 
    "referenceField": "String" 
  }
]
    input.referenceItems.referenced Zeichenfolge Der internal_id, der für das Element definiert ist, auf das von einem anderen Element verwiesen wird.
    input.referenceItems.referencedBy Zeichenfolge Der internal_id, der für das Element definiert ist, das auf ein anderes Element verweist.
    input.referenceItems.referenceField Zeichenfolge Name des Referenzfelds in der Klasse/Tabelle für das Element referencedBy.
    input.relations Array Array von Objekten, die Beziehungen zwischen Elementen in der Eingabenutzlast angeben.
    Ein Objekt in diesem Array kann eines von zwei Formaten verwenden.
    • Das Objekt kann (nur) mithilfe der Name-Wert-Paare parent und child eine Beziehung zwischen zwei Elementen der obersten Ebene definieren, wobei Werte Elementindizes aus dem Payload-Array items darstellen.
      "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    • Das Objekt kann eine Beziehung zwischen zwei beliebigen Elementen definieren, einschließlich oberster Ebene, zugehöriger Elemente oder Suchelemente, wobei die Schlüssel/Wert-Paare parent_id und child_id verwendet werden, wobei -Werte internal_id Werte darstellen, die für diese Elemente definiert sind.
      "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    input.relations.child Nummer Integer-Index des CI-Objekts im Array items, das das untergeordnete Element in der Beziehung darstellt (items, items.related oder items.lookup).
    input.relations.child_id Zeichenfolge internal_id des untergeordneten Elements in der Beziehung (items, items.related oder items.lookup).
    input.relations.parent Nummer Integer-Index des übergeordneten Elements im items -Array (items, items.related oder items.lookup.)
    input.relations.parent_id Zeichenfolge internal_id des übergeordneten Elements in der Beziehung (items, items.related oder items.lookup).
    input.relations.sys_rel_source_info Objekt Discovery-Quelleninformationen für die Beziehung. Bei Nicht-Abhängigkeitsbeziehungen werden diese Informationen in der Tabelle „Beziehungsquellen“ [sys_rel_source] gespeichert (nicht beibehalten für die Methoden identifyCIEnhanced() oder identifyCI() ).

    Datentyp: Objekt

    "sys_rel_source_info": { 
  "source_name": "String", 
  "source_feed": "String" 
}
    input.relations.sys_rel_source_info.source_name Zeichenfolge Name der Discovery-Quelle

    Standard: Discovery-Quelle, die im API-Methodenparameter übergeben wird.
    input.relations.sys_rel_source_info.source_feed Zeichenfolge Jede Zeichenfolge, die eine Untererkennung/ein Scan innerhalb der Erkennungsquelle ist.

    Standard: „UNKNOWN“ wird in der Spalte „source_feed“ gespeichert, wenn ein Datensatz in der Tabelle „sys_rel_source“ erstellt wird.
    input.relations.type Zeichenfolge Typ der Beziehung, die zwischen den übergeordneten und untergeordneten Elementen besteht. Dies muss ein Namensfeldwert aus der Tabelle „CI-Beziehungstyp“ [cmdb_rel_type] sein.
    Quelle Zeichenfolge Gibt die Datenquelle der CI-Informationen an. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle cmdb_ci definiert sind.
    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    <String> JSON-formatierte Zeichenfolge, die eine Liste der Ergebnisse für die Konfigurationselemente in der Eingabezeichenfolge ist. Jede Ergebniszeichenfolge hat das Format „items: [{}], relations: [{}]“, wobei jedes Element in den items- und relations-Listen Name-Wert-Paare enthält.

    Datentyp: Zeichenfolge
    <String>.zusätzlicheCommittedItems Derzeit werden keine Werte zurückgegeben.
    <String>.zusätzlicheCommittedRelations Derzeit werden keine Werte zurückgegeben.
    <String>.items Liste der Objekte, die die erstellten oder aktualisierten CIs beschreiben.

    Datentyp: Array

    "items": { 
  "additionalRelatedItems": [Array],
  "className": "String",
  "duplicateIndices": [Array],
  "errorCount": Number,
  "errors": [Array],
  "identificationAttempts": [Array],
  "identifierEntrySysId": "String",
  "info": [Array],
  "inputIndices": [Array],
  "maskedAttributes": [Array],
  "operation": "String",
  "relatedItems": [Array],
  "relatedSysIds": [Array],
  "sysId": "String"
}
    <String>.items.additionalRelatedItems Liste der JSON-Objekte, die Informationen zu zusätzlichen Such- und zugehörigen Elementen bereitstellen, die verarbeitet, aber nicht als Teil der Eingabenutzlast bereitgestellt wurden. Diese Elemente stammen aus Teilnutzlasten.

    Diese Informationen werden derzeit nicht zurückgegeben.

    Datentyp: Array

    "additionalRelatedItems": [ 
  {
    "className": "String", 
    "inputIndices": [Array], 
    "operation": "String",
    "sysId": "String"
  }
]
    <String>.items.zusätzlicheZugehörigeElemente.Klassenname Klassen-/Tabellenname (sys_class_name) des CI, das erstellt oder aktualisiert wurde.

    Datentyp: Zeichenfolge
    <String>.items.additionalRelatedItems.inputIndices Index des entsprechenden Eingabeelements. Bei Elementen der obersten Ebene handelt es sich um eine Liste mit Ganzzahlen. Für zugehörige oder Suchelemente ist dies eine Liste von JSON-Objekten.

    Datentyp: Array von Zahlen oder Array von Objekten

    "inputIndices": [
  { 
   "mainIndex": Number, 
   "subIndex": Number 
  }
]
    <String>.items.additionalRelatedItems.inputIndices.mainIndex Indexwert aus dem Anforderungstext-Array items, der dem übergeordneten CI des zusätzlichen zugehörigen Elements entspricht.

    Datentyp: Zahl
    <String>.items.additionalRelatedItems.inputIndices.subIndex Indexwert aus dem Anforderungstext-Array items.lookup, der dem zusätzlichen zugehörigen Element entspricht.

    Datentyp: Zahl
    <String>.items.additionalRelatedItems.operation Typ des Vorgangs.

    Mögliche Werte:

    • EINFÜGEN: Neues CI wurde in die Datenbank eingefügt.
    • NO_CHANGE: Es wurden keine CI-Änderungen vorgenommen.
    • UPDATE: Vorhandenes CI wurde aktualisiert.

    Datentyp: Zeichenfolge
    <String>.items.zusätzlicheZugehörigeElemente.sysId Sys_id der zusätzlichen zugehörigen Elemente.

    Datentyp: Zeichenfolge
    <String>.items.className Klassen-/Tabellenname (sys_class_name) des CI, das erstellt oder aktualisiert wurde.

    Datentyp: Zeichenfolge
    <String>.items.duplicateIndices Liste der Indizes von CIs, die Duplikate des aktuellen Elements sind.

    Datentyp: Array
    <String>.items.errorAnzahl Anzahl der Fehler.

    Datentyp: Zahl
    <String>.items.errors Array von Objekten, in dem jedes Objekt einen Fehler beschreibt, der bei der Verarbeitung dieses CI aufgetreten ist.

    Datentyp: Array

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.items.errors.error Typ des Fehlers, der beim Verarbeiten des CI aufgetreten ist.

    Datentyp: Zeichenfolge
    <String>.items.errors.message Fehlermeldung, die dem Fehler zugeordnet ist.

    Datentyp: Zeichenfolge
    <String>.items.identificationAttempts Liste der Versuche, die unternommen wurden, um die CIs zu identifizieren.

    Datentyp: Array

    "identificationAttempts": [
  { 
    "attemptResult": "String", 
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identifierName": "String",
    "searchOnTable": "String" 
  }
]
    <String>.items.identificationAttempts.attemptResult Ergebnisse des Versuchs, das CI zu identifizieren

    Mögliche Werte:

    • MATCHED: Identifizierung erfolgreich. In der Bezeichner-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • MULTI_MATCH: Identifizierung mit einem Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichner-Regeltabelle beim Abgleich mit den angegebenen Attributen gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • SKIPPED: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet.

    Datentyp: Zeichenfolge
    <String>.items.identificationAttempts.attributes Liste der CI-Bezeichner-Eintragsattribute, die während des Identifizierungsprozesses verwendet wurden.

    Datentyp: Array

    Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.:

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    <String>.items.identificationAttempts.hybridEntryCiAttributes Derzeit werden keine Werte zurückgegeben.
    <String>.items.identificationAttempts.identifierName Bezeichnerregel, die für diesen CI-Identifizierungsversuch verwendet wird.

    Datentyp: Zeichenfolge
    <String>.items.identificationAttempts.searchOnTable Name der während des Identifizierungsprozesses durchsuchten Tabelle.

    Datentyp: Zeichenfolge
    <String>.items.identifierEntrySysId Sys_id für die Bezeichnerregel, die zum Identifizieren des CI verwendet wird. Befindet sich in der Tabelle „Bezeichnereintrag“ [cmdb_identifier_entry].

    Datentyp: Zeichenfolge
    <String>.items.info Liste der Objekte, die zusätzliche Informationen zur Verarbeitung des Elements enthalten.

    Datentyp: Array

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    <String>.items.info.code Reklassifizierungstyp, der übersprungen wurde.
    Mögliche Werte:
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_UPGRADE

    Datentyp: Zeichenfolge
    <String>.items.info.message Nachricht, die zusätzliche Einblicke in den Grund für das Überspringen der Neuklassifizierung bietet.

    Datentyp: Zeichenfolge
    <String>.items.info.ruleSysId Sys_id der abgeglichenen Reklassifizierungs-Einschränkungsregel. Gilt nur, wenn IRE die Neuklassifizierung aufgrund der Regel zur Einschränkung der Neuklassifizierung überspringt. Dieser Wert ist leer, wenn die Neuklassifizierung aufgrund einer Nutzlast oder einer globalen Kennzeichnung übersprungen wird.

    Datentyp: Zeichenfolge
    <String>.items.inputIndizes Indexwerte für CIs aus dem Anforderungstext-Array items, die diesem CI entsprechen.

    Datentyp: Array
    <String>.items.maskedAttributes Liste der Attribute, deren Aktualisierung durch eine nicht autorisierende Datenquelle übersprungen wurde, wie in den Abgleichsregelndefiniert.

    Datentyp: Array
    <String>.items.relatedItems Liste der JSON-Objekte, die Informationen zu den verarbeiteten zugehörigen Elementen bereitstellen.

    Datentyp: Array

    "relatedItems": [
  { 
    "className": "String",
    "errors": [Array],
    "errorCount": Number, 
    "inputIndices": [Array],
    "operation": "String",
    "sysId": "String"
  }
]
    <String>.items.relatedItems.className Klassen-/Tabellenname (sys_class_name) des zugehörigen Elements.

    Datentyp: Zeichenfolge
    <String>.items.relatedItems.errors Liste der Fehler, die während der Verarbeitung aufgetreten sind.

    Datentyp: Array

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.items.relatedItems.errorCount Anzahl der während der Verarbeitung erkannten Fehler.

    Datentyp: Zahl
    <String>.items.relatedItems.inputIndices Indizes der entsprechenden zugehörigen Elemente.

    Datentyp: Array oder Zahlen

    "inputIndices": [
  { 
   "mainIndex": Number, 
   "subIndex": Number 
  }
]
    <String>.items.relatedItems.inputIndices.mainIndex Ganzzahliger Wert aus dem Anforderungstext-Array items, der dem übergeordneten CI des zugehörigen Elements entspricht.

    Datentyp: Zahl
    <String>.items.relatedItems.inputIndices.subIndex Ganzzahliger Wert aus dem Anforderungstext-Array items.lookup, der dem zugehörigen Element entspricht.

    Datentyp: Zahl
    <String>.items.relatedItems.operation Typ des Vorgangs.

    Mögliche Werte:

    • EINFÜGEN: Neues CI wurde in die Datenbank eingefügt.
    • NO_CHANGE: Es wurden keine CI-Änderungen vorgenommen.
    • UPDATE: Vorhandenes CI wurde aktualisiert.

    Datentyp: Zeichenfolge
    <String>.items.relatedSysIds Liste der sys_id-Werte für zugehörige Elemente (Tabellensuchelemente) aus dem Anforderungstext-Array items.lookup.

    Bemerkenswerte Werte – null: Für dieses zugehörige Element wurde keine sys_id identifiziert.

    Datentyp: Array
    <String>.items.sys_id Sys_id des CI, das aktualisiert oder erstellt wurde

    Datentyp: Zeichenfolge
    <String>.Beziehungen Liste der JSON-Objekte, die Informationen zu den verarbeiteten Beziehungen bereitstellen.

    Datentyp: Array

    "relations":[
  { 
    "className": "String",
    "errorCount": Number,
    "inputIndices": [Array],
    "operation": "String",
    "sysId": "String" 
  }
]
    <String>.relations.Klassenname Sys_class_name dieses abhängigen Beziehungs-CI.

    Einziger unterstützter Wert: cmdb_rel_ci: CI-Beziehungstabelle.

    Datentyp: Zeichenfolge
    <String>.relations.errorAnzahl Anzahl der Fehler.

    Datentyp: Zahl
    <String>.relations.inputIndices Indizes der entsprechenden Eingabebeziehungen.

    Datentyp: Array
    <String>.relations.operation Typ des durchgeführten Vorgangs.

    Mögliche Werte:

    • EINFÜGEN
    • AKTUALISIEREN
    • KEINE_ÄNDERUNG

    Datentyp: Zeichenfolge
    <String>.relations.sysId Sys_id des abhängigen Beziehungs-CI.

    Datentyp: Zeichenfolge

    Im Folgenden wird gezeigt, wie ein Konfigurationselement neu klassifiziert wird.

    var payload = {
  "items": [
    {
      "className": "cmdb_ci_win_server",
      "values": {
        "short_description": "Linux server description",
        "name": "Linux Server 1"
      }
    }
  ]
};

var input = JSON.stringify(payload);
var output = sn_cmdb.IdentificationEngine.createOrUpdateCI('ServiceNow', input);

gs.info(JSON.stringify(JSON.parse(output), null, 2));

    Ausgabe:

    {
  "items": [
    {
      "className": "cmdb_ci_linux_server",
      "operation": "NO_CHANGE",
      "sysId": "440577800f321010150efc91ff767e94",
      "identifierEntrySysId": "556eb250c3400200d8d4bea192d3ae92",
      "identificationAttempts": [
        {
          "attributes": [],
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "serial_number",
            "serial_number_type"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "searchOnTable": "cmdb_serial_number",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "serial_number"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "name"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "MATCHED",
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        }
      ],
      "info": [
        {
          "message": "CI Reclassification not allowed from class: [cmdb_ci_linux_server] to [cmdb_ci_win_server] by a reclassification restriction rule",
          "code": "SKIPPED_CLASS_SWITCH",
          "ruleSysId": "b3d4b3800f321010150efc91ff767eab"
        }
      ],
      "errorCount": 0,
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ],
      "mergedPayloadIds": []
    }
  ],
  "additionalCommittedItems": [],
  "relations": [],
  "additionalCommittedRelations": []
}

    Im Folgenden wird gezeigt, wie ein Konfigurationselement aktualisiert wird.

    var payload = {
"items": [
{
 "className": "cmdb_ci_win_server", 
 "values": {
   "chassis_type": "Desktop",
   "os": "Windows 2012 R2 Datacenter",
   "name": "Windows2012Server1",
   "serial_number": "0000-0011-1690-8730-8636-5722-52",
   "cpu_count": "1"
  },
  "lookup": [
  {
     "values": {
       "valid": "true",
       "serial_number": "0000-0011-1690-8730-8636-5722-52",
       "serial_number_type": "bios"
      },
     "className": "cmdb_serial_number"
   },
   {
     "values": {
       "valid": "true",
       "serial_number": "3311-9736-4988-9744-1749-4183-41",
       "serial_number_type": "chassis"
      },
     "className": "cmdb_serial_number"
   }],

    "internal_id": "16777219",
    "sys_object_source_info": {
      "source_feed": "SN Discovery Feed 1",
      "source_name": "ServiceNow",
      "source_native_key": "16777219",
      "source_recency_timestamp": "2019-10-18 08:31:23"
   }},
   {  
   "className": "cmdb_ci_spkg",
   "values": {
     "name": "Windows 2012 R2 Datacenter",
     "key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL"
     },

  "related": [
    {
      "internal_id": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219",
      "values": {
        "name": "Windows 2012 R2 Datacenter-SAMLABVM52"
      },
      "className": "cmdb_software_instance",
      "sys_object_source_info": {
        "source_feed": "SN Discovery Feed 1",
        "source_name": "ServiceNow",
        "source_native_key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219"
  }}]}, 
  {
  "className": "cmdb_ci_app_server_tomcat",
  "values": {
    "running_process_key_parameters": "/opt/OV/nonOV/tomcat/b/temp org.apache.catalina.startup.Bootstrap start",
    "install_directory": "/opt/OV/nonOV/tomcat/b",
    "name": "Tomcat@hpom9:3443",
    "server_port": "8006",
    "sys_class_name": "cmdb_ci_app_server_tomcat"
  },

  "internal_id": "tomcat_id"
  }],

"relations": [
  {
    "parent_id": "tomcat_id",
    "child_id": "16777219",
    "type": "Runs on::Runs"
  }],

"referenceItems": [
  {
    "referenceField": "installed_on",
    "referenced": "16777219",
    "referencedBy": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219"
  }]};

var input = JSON.stringify(payload);
var output = sn_cmdb.IdentificationEngine.createOrUpdateCI('ServiceNow', input);

gs.info(JSON.stringify(JSON.parse(output), null, 2));

    Ausgabe:

    {
  "items": [
    {
      "className": "cmdb_ci_win_server",
      "operation": "INSERT",
      "sysId": "d56ab6eadbd510102f67dfea5e96194e",
      "relatedSysIds": [
        "dd6af62adb1910102f67dfea5e96197f",
        "996af62adb1910102f67dfea5e961980"
      ],
      "relatedItems": [
        {
          "errors": [],
          "operation": "INSERT",
          "errorCount": 0,
          "mergedPayloadIds": [],
          "warningCount": 0,
          "sysId": "dd6af62adb1910102f67dfea5e96197f",
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 0,
              "subIndex": 0
            }
          ],
          "className": "cmdb_serial_number"
        },
        {
          "errors": [],
          "operation": "INSERT",
          "errorCount": 0,
          "mergedPayloadIds": [],
          "warningCount": 0,
          "sysId": "996af62adb1910102f67dfea5e961980",
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 0,
              "subIndex": 1
            }
          ],
          "className": "cmdb_serial_number"
        }
      ],
      "identifierEntrySysId": "Unknown",
      "identificationAttempts": [
        {
          "info": "sys_object_source NO_MATCH",
          "identifierName": "",
          "attemptResult": "NO_MATCH",
          "attributes": [],
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "attributes": [
            "serial_number",
            "serial_number_type"
          ],
          "searchOnTable": "cmdb_serial_number",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "attributes": [
            "serial_number"
          ],
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "attributes": [
            "name"
          ],
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "attributes": [
            "mac_address",
            "name"
          ],
          "searchOnTable": "cmdb_ci_network_adapter",
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ]
    },
    {
      "className": "cmdb_ci_spkg",
      "operation": "INSERT",
      "sysId": "116af62adb1910102f67dfea5e961981",
      "relatedSysIds": [
        "6d6af62adb1910102f67dfea5e961984"
      ],
      "relatedItems": [
        {
          "errors": [],
          "operation": "INSERT",
          "errorCount": 0,
          "mergedPayloadIds": [],
          "warningCount": 0,
          "sysId": "6d6af62adb1910102f67dfea5e961984",
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 1,
              "subIndex": 0
            }
          ],
          "className": "cmdb_software_instance"
        }
      ],
      "identifierEntrySysId": "Unknown",
      "identificationAttempts": [
        {
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "attributes": [],
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Software",
          "attemptResult": "NO_MATCH",
          "attributes": [
            "key"
          ],
          "searchOnTable": "cmdb_ci_spkg",
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        1
      ]
    },
    {
      "className": "cmdb_ci_app_server_tomcat",
      "operation": "INSERT",
      "sysId": "e96af62adb1910102f67dfea5e961985",
      "identifierEntrySysId": "Unknown",
      "identificationAttempts": [
        {
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "attributes": [],
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        2
      ]
    }
  ],
  "additionalCommittedItems": [],
  "relations": [
    {
      "className": "cmdb_rel_ci",
      "operation": "INSERT",
      "sysId": "e96af62adb1910102f67dfea5e961989",
      "identifierEntrySysId": "Unknown",
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ]
    }
  ],
  "additionalCommittedRelations": []
}

    Identifizieren eines abhängigen CI.

    var payload = 
              {items: [ 
                    {className:'cmdb_ci_web_server', 
                     values: {name:'apache linux den 200', 
                              running_process_command: 'xyz',  
                              running_process_key_parameters: 'abc', 
                              tcp_port:'3452'}}, 
                    {className:'cmdb_ci_linux_server', 
                     values: {name:'lnux100', ram:'2048'}}],
               relations:[{parent: 0, child: 1, type: 'Runs on::Runs'}]
              };

var input = JSON.stringify(payload);
var output = sn_cmdb.IdentificationEngine.createOrUpdateCI('ServiceNow', input);

gs.info(JSON.stringify(JSON.parse(output), null, 2));

    Ausgabe:

    {
  "items": [
    {
      "className": "cmdb_ci_web_server",
      "operation": "INSERT",
      "sysId": "b9bb766adb1910102f67dfea5e961962",
      "identifierEntrySysId": "Unknown",
      "identificationAttempts": [
        {
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "attributes": [],
          "hybridEntryCiAttributes": []
        },
        {
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "attributes": [],
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ]
    },
    {
      "className": "cmdb_ci_linux_server",
      "operation": "INSERT",
      "sysId": "a5bb766adb1910102f67dfea5e96195b",
      "identifierEntrySysId": "Unknown",
      "identificationAttempts": [
        {
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "attributes": [],
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "attributes": [
            "serial_number",
            "serial_number_type"
          ],
          "searchOnTable": "cmdb_serial_number",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "attributes": [
            "serial_number"
          ],
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "attributes": [
            "name"
          ],
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "attributes": [
            "mac_address",
            "name"
          ],
          "searchOnTable": "cmdb_ci_network_adapter",
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        1
      ]
    }
  ],
  "additionalCommittedItems": [],
  "relations": [
    {
      "className": "cmdb_rel_ci",
      "operation": "INSERT",
      "sysId": "fdbb766adb1910102f67dfea5e961964",
      "identifierEntrySysId": "Unknown",
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ]
    }
  ],
  "additionalCommittedRelations": []
}

    Identifizieren Sie ein unabhängiges CI mit Lookup-basierter Identifizierung.

    var payload = {items: [
           {className:'cmdb_ci_netgear', 
               values: {name:'ny8500-nbxs08',
                        ports:'1200'}, 
               lookup: [{className:'cmdb_serial_number',
                            values:{serial_number:'1234ABCD', serial_number_type:'uuid',absent:'false',valid:'true'}},
                        {className:'cmdb_serial_number',
                            values:{serial_number:'3456EFGH', serial_number_type:'system',absent:'false',valid:'true'}}]}]};

var input = JSON.stringify(payload);
var output = sn_cmdb.IdentificationEngine.createOrUpdateCI('ServiceNow', input);

gs.info(JSON.stringify(JSON.parse(output), null, 2));

    Ausgabe:

    {
  "items": [
    {
      "className": "cmdb_ci_netgear",
      "operation": "INSERT",
      "sysId": "787c7e6adb1910102f67dfea5e96196e",
      "relatedSysIds": [
        "f47c7e6adb1910102f67dfea5e961977",
        "3c7c7e6adb1910102f67dfea5e961977"
      ],
      "relatedItems": [
        {
          "errors": [],
          "operation": "INSERT",
          "errorCount": 0,
          "mergedPayloadIds": [],
          "warningCount": 0,
          "sysId": "f47c7e6adb1910102f67dfea5e961977",
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 0,
              "subIndex": 0
            }
          ],
          "className": "cmdb_serial_number"
        },
        {
          "errors": [],
          "operation": "INSERT",
          "errorCount": 0,
          "mergedPayloadIds": [],
          "warningCount": 0,
          "sysId": "3c7c7e6adb1910102f67dfea5e961977",
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 0,
              "subIndex": 1
            }
          ],
          "className": "cmdb_serial_number"
        }
      ],
      "identifierEntrySysId": "Unknown",
      "identificationAttempts": [
        {
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "attributes": [],
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "attributes": [
            "serial_number",
            "serial_number_type"
          ],
          "searchOnTable": "cmdb_serial_number",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "attributes": [
            "serial_number"
          ],
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "attributes": [
            "name"
          ],
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "attributes": [
            "mac_address",
            "name"
          ],
          "searchOnTable": "cmdb_ci_network_adapter",
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "mergedPayloadIds": [],
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ]
    }
  ],
  "additionalCommittedItems": [],
  "relations": [],
  "additionalCommittedRelations": []
}

    IdentificationEngine – createOrUpdateCIEnhanced(String source, String input, Object options)

    Fügt Konfigurationselemente (CIs) und NichtConfiguration Management Database (CMDB) - -CIs (Klassen, die sich nicht aus cmdb_ci erstrecken) basierend auf Identifizierungs- und Abgleichregeln in CMDB ] ein oder aktualisiert sie. Verwenden Sie diese API, anstatt CMDB direkt zu aktualisieren.

    Diese Methode bietet nicht nur die Funktionalität der Methode createOrUpdateCI(), sondern unterstützt auch Folgendes:
    • Teilnutzlasten werden verarbeitet
    • Umgang mit teilweisen Commits
    • Doppelte Elemente innerhalb einer Nutzlast werden entfernt
    • Ausgabezusammenfassungen werden generiert
    Weitere Informationen zu IRE und detailliertere Erklärungen der von dieser Methode verwendeten Daten finden Sie unter Identifizierung und Abgleich (IRE).

    Weitere Informationen zur Nicht-CMDB-Tabellenerfassung finden Sie unter IRE support for non-CMDB tables.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Eingabe Zeichenfolge Erforderlich. Eingabenutzlast Eine JSON-formatierte Zeichenfolge von Konfigurationselementen, die hinzugefügt oder aktualisiert werden soll. 
    "input" { 
 "items": [Array],
 "referenceItems": [Array],
 "relations": [Array]
}
    input.items Array Array von Objekten, die die hinzuzufügenden oder zu aktualisierenden Elemente definieren.
    "items": [
  { 
    "className": "String",
    "display_values": {Object},
    "internal_id": "String",
    "lookup": [Array],
    "related": [Array],
    "settings": {Object},
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    input.items.className Zeichenfolge Erforderlich. Klassen-/Tabellenname, sys_class_name, des Konfigurationselements (CI), das erstellt oder aktualisiert werden soll.

    Dieser Wert kann eine beliebige CMDB Klasse/Tabelle sein, z. B. cmdb_ci_linux_server oder cmdb_ci_win_server.
    input.items.display_values Objekt Referenzfelder, die für dieses zugehörige Element als Name-Wert-Paare erstellt oder aktualisiert werden sollen, wobei der Name der Feldname und der Wert der referenzierte Anzeigewert ist. Wenn Sie die sys_id anstelle des Anzeigewerts für Referenzfelder verwenden möchten, übergeben Sie die Informationen im Parameter input.items.lookup.values und nicht in diesem Parameter.

    Referenzfeldnamen hängen von den vom Benutzer ausgewählten Feldern ab, z. B.:

    "display_values": {
  "model_id": "String",
  "location": "String"
}
    input.items.internal_id Zeichenfolge Eindeutiger Elementbezeichner für die zugeordnete Nutzlast.

    Dies kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein.
    input.items.lookup Array Identifiziert das Element der obersten Ebene, das die Suche enthält (suchbasierte Identifizierung). Diese Datensätze werden verwendet, um das Konfigurationselement basierend auf einer Suchtabelle zu identifizieren, die einen Verweis auf cmdb_ci enthält.

    Beispiel:

    "lookup": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    input.items.lookup.className Zeichenfolge Erforderlich. Klassen-/Tabellenname, sys_class_name, des Konfigurationselements (CI), das erstellt oder aktualisiert werden soll.

    Dieser Wert kann eine beliebige CMDB Klasse/Tabelle sein, z. B. cmdb_serial_number oder cmdb_ci_network_adapter.
    input.items.lookup.internal_id Zeichenfolge Eindeutiger Bezeichner des Suchelements für die zugeordnete Nutzlast.

    Dies kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein.
    input.items.lookup.sys_object_source_info Objekt Definiert einen eindeutigen CI-Bezeichner für eine bestimmte Datenquelle. Verschiedene Quellen können unterschiedliche Name-Wert-Paare für dasselbe CI haben.
    "sys_object_source_info": { 
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    input.items.lookup.sys_object_source_info.source_feed Zeichenfolge Wenn die Quelle mehrere Feeds haben kann, geben Sie in diesem Feld den Namen des Feeds an, der dieses Element sendet.

    Die Datenquelle generiert diesen Feed-Namen. Es kann eine beliebige Zeichenfolge sein, die den Quell-Feed eindeutig identifiziert.
    input.items.lookup.sys_object_source_info.source_name Zeichenfolge Datenquelle der CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.
    input.items.lookup.sys_object_source_info.source_native_key Zeichenfolge Eindeutige Schlüssel-ID für das Element aus der Quelle.

    Die Datenquelle generiert diesen Schlüssel. Es kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist.
    input.items.lookup.sys_object_source_info.source_recency_timestamp Zeichenfolge UTC-Datum/Uhrzeit, zu der das Element gescannt wurde.

    Format: JJJJ-MM-TT hh:mm:ss
    input.items.lookup.values Objekt Feldinformationen für das CI als Name-Wert-Paare, wobei der Name der Feldname ist. Bei der Aktualisierung von Referenzfeldern muss der Wert die referenzierte sys_id sein.

    Feldnamen und -typen hängen von den vom Benutzer ausgewählten Feldern ab, z. B.:

    "values": {
  "serial_number": "String",
  "serial_number_type": "String",
  "valid": "String",
  "ip_address": "String",
  "mac_address": "String"
}
    input.items.related Array Verweis auf das oberste Element, das die zugehörige Liste enthält. Regeln im Zugehörigen Eintrag [cmdb_related_entry] definieren, welche Art von Datensätzen in diesem Array enthalten sein kann. Diese Datensätze werden verwendet, um Elemente basierend auf einer zugehörigen Tabelle hinzuzufügen, die einen Verweis auf das identifizierte CI enthält.

    Die zugehörige Tabelle kann cmdb_ci erweitern oder nicht. Diese Datensätze werden nicht zum Identifizieren des Konfigurationselements verwendet.

    "related" [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    input.items.related.className Zeichenfolge Erforderlich. Klassen-/Tabellenname, sys_class_name, des Konfigurationselements (CI), das erstellt oder aktualisiert werden soll.

    Dieser Wert kann eine beliebige CMDB Klasse/Tabelle sein, z. B. cmdb_software_instance oder cmdb_key_value.
    input.items.related.internal_id Zeichenfolge Eindeutiger Bezeichner für dieses zugehörige Element in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein.
    input.items.related.sys_object_source_info Objekt Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle darstellt. Verschiedene Quellen können unterschiedliche Name-Wert-Paare für dasselbe CI haben.
    "sys_object_source_info": { 
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    input.items.related.sys_object_source_info.source_feed Zeichenfolge Wenn die Quelle mehrere Feeds haben kann, geben Sie in diesem Feld den Namen des Feeds an, der dieses Element sendet.

    Die Datenquelle generiert diesen Feed-Namen. Es kann eine beliebige Zeichenfolge sein, die den Quell-Feed eindeutig identifiziert.
    input.items.related.sys_object_source_info.source_name Zeichenfolge Gibt die Datenquelle der CI-Informationen an. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.
    input.items.related.sys_object_source_info.source_native_key Zeichenfolge Eindeutiger Schlüssel/ID aus der Quelle für das zugehörige Element.

    Die Datenquelle generiert diesen Schlüssel. Es kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist.
    input.items.related.sys_object_source_info.source_recency_timestamp Zeichenfolge UTC-Datum und Uhrzeit, zu der das Element gescannt wurde.

    Format: JJJJ-MM-TT hh:mm:ss
    input.items.related.values Objekt Felder, die für dieses zugehörige Element als Name/Wert-Paare erstellt oder aktualisiert werden sollen, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_id sein. Wenn Sie den Anzeigewert anstelle der sys_id für Referenzfelder verwenden möchten, übergeben Sie diese Informationen in einem display_values -Objekt anstatt im values -Objekt.

    Feldnamen und -typen hängen von den vom Benutzer ausgewählten Feldern ab, z. B.:

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    input.items.settings Objekt Parameter, die die zulässigen Aktualisierungstypen definieren.
    "settings": { 
  "skipReclassificationRestrictionRules": Boolean, 
  "updateWithoutDowngrade": Boolean, 
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    input.items.settings.skipReclassificationRestrictionRules Boolean Kennzeichnung, die angibt, ob IRE die Regel zur Einschränkung der Neuklassifizierung ausführen soll, die der Klasse für das Nutzlastelement entspricht.
    Gültige Werte:
    • true: Ausführung der Regel überspringen.
    • false: Regel wird ausgeführt.

    Standardwert: false
    input.items.settings.updateWithoutDowngrade Boolean Kennzeichnung, die angibt, ob sowohl Aktualisierung als auch Downgrade für dieses Element zulässig sind.
    Gültige Werte:
    • true: Element aktualisieren, Downgrade ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierung als auch Downgrade sind zulässig.

    Standardwert: false
    input.items.settings.updateWithoutSwitch Boolean Kennzeichnung, die angibt, ob das Element aktualisiert und die Klasse gewechselt werden kann.
    Gültige Werte:
    • true: Element aktualisieren, Klassenwechsel ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Klassenwechsel sind zulässig.

    Standardwert: false
    input.items.settings.updateOhneUpgrade Boolean Kennzeichnung, die angibt, ob Update und Upgrade für dieses Element zulässig sind.
    Gültige Werte:
    • true: Element wird aktualisiert, Upgrade ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Upgrades sind zulässig.

    Standardwert: false
    input.items.sys_object_source_info Objekt Eindeutiger CI-Bezeichner für eine bestimmte Quelle.
    "sys_object_source_info": { 
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    input.items.sys_object_source_info.source_feed Zeichenfolge Wenn die Quelle mehrere Feeds haben kann, geben Sie in diesem Feld den Namen des Feeds an, der dieses Element sendet.

    Die Datenquelle generiert diesen Feed-Namen. Es kann eine beliebige Zeichenfolge sein, die den Quell-Feed eindeutig identifiziert.
    input.items.sys_object_source_info.source_name Zeichenfolge Datenquelle der CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.
    input.items.sys_object_source_info.source_native_key Zeichenfolge Eindeutiger Schlüssel/ID für das Element aus der Quelle.

    Die Datenquelle generiert diesen Schlüssel. Es kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist.
    input.items.sys_object_source_info.source_recency_timestamp Zeichenfolge UTC-Datum und Uhrzeit, zu der das Element gescannt wurde.

    Format: JJJJ-MM-TT hh:mm:ss
    input.items.values Objekt Felder, die für dieses zugehörige Element als Name/Wert-Paare erstellt oder aktualisiert werden sollen, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_id sein. Wenn Sie den Anzeigewert anstelle der sys_id für Referenzfelder verwenden möchten, übergeben Sie diese Informationen in einem display_values -Objekt anstatt im values -Objekt.

    Feldnamen und -typen hängen von den vom Benutzer ausgewählten Feldern ab, z. B.:

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    input.referenceItems Array Array von Objekten, die Referenzen zwischen Elementen in der Eingabenutzlast definieren. 
    "referenceItems": [
  { 
    "referenced": "String", 
    "referencedBy": "String", 
    "referenceField": "String" 
  }
]
    input.referenceItems.referenced Zeichenfolge Der internal_id, der für das Element definiert ist, auf das von einem anderen Element verwiesen wird.
    input.referenceItems.referencedBy Zeichenfolge Der internal_id, der für das Element definiert ist, das auf ein anderes Element verweist.
    input.referenceItems.referenceField Zeichenfolge Name des Referenzfelds in der Klasse/Tabelle für das Element referencedBy.
    input.relations Array Array von Objekten, die Beziehungen zwischen Elementen in der Eingabenutzlast angeben.
    Ein Objekt in diesem Array kann eines von zwei Formaten verwenden.
    • Das Objekt kann (nur) mithilfe der Name-Wert-Paare parent und child eine Beziehung zwischen zwei Elementen der obersten Ebene definieren, wobei Werte Elementindizes aus dem Payload-Array items darstellen.
      "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    • Das Objekt kann eine Beziehung zwischen zwei beliebigen Elementen definieren, einschließlich oberster Ebene, zugehöriger Elemente oder Suchelemente, wobei die Schlüssel/Wert-Paare parent_id und child_id verwendet werden, wobei -Werte internal_id Werte darstellen, die für diese Elemente definiert sind.
      "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    input.relations.child Nummer Integer-Index des CI-Objekts im Array items, das das untergeordnete Element in der Beziehung darstellt (items, items.related oder items.lookup).
    input.relations.child_id Zeichenfolge internal_id des untergeordneten Elements in der Beziehung (items, items.related oder items.lookup).
    input.relations.parent Nummer Integer-Index des übergeordneten Elements im items -Array (items, items.related oder items.lookup.)
    input.relations.parent_id Zeichenfolge internal_id des übergeordneten Elements in der Beziehung (items, items.related oder items.lookup).
    input.relations.sys_rel_source_info Objekt Discovery-Quelleninformationen für die Beziehung. Bei Nicht-Abhängigkeitsbeziehungen werden diese Informationen in der Tabelle „Beziehungsquellen“ [sys_rel_source] gespeichert (nicht beibehalten für die Methoden identifyCIEnhanced() oder identifyCI() ).

    Datentyp: Objekt

    "sys_rel_source_info": { 
  "source_name": "String", 
  "source_feed": "String" 
}
    input.relations.sys_rel_source_info.source_name Zeichenfolge Name der Discovery-Quelle

    Standard: Discovery-Quelle, die im API-Methodenparameter übergeben wird.
    input.relations.sys_rel_source_info.source_feed Zeichenfolge Jede Zeichenfolge, die eine Untererkennung/ein Scan innerhalb der Erkennungsquelle ist.

    Standard: „UNKNOWN“ wird in der Spalte „source_feed“ gespeichert, wenn ein Datensatz in der Tabelle „sys_rel_source“ erstellt wird.
    input.relations.type Zeichenfolge Typ der Beziehung, die zwischen den übergeordneten und untergeordneten Elementen besteht. Dies muss ein Namensfeldwert aus der Tabelle „CI-Beziehungstyp“ [cmdb_rel_type] sein.
    Optionen Objekt Optional, aber {} oder null muss übergeben werden. Optionen zum Aktivieren oder Deaktivieren von Funktionen.
    Hinweis:
    Standardmäßig oder wenn partial_payloads auf „true“ festgelegt ist, sind sowohl partial_commits als auch deduplicate_payloads aktiviert, auch wenn sie auf „false“ festgelegt sind, da diese Funktionen für die Funktionalität von Teilnutzlasten erforderlich sind.
    "options": { 
 "deduplicate_payloads": "Boolean",
 "generate_summary": "Boolean", 
 "partial_commits": "Boolean", 
 "partial_payloads": "Boolean",
 "skip_updating_last_scan_to_now": "Boolean",
 "skip_updating_source_last_discovered_to_now": "Boolean"
}
    options.deduplizieren_nutzlasten Boolean Kennzeichnung, die angibt, ob doppelte Elemente zusammengeführt oder als Fehler betrachtet werden.

    Gültige Werte:

    • true: Doppelte Elemente werden zusammengeführt.
    • false: Doppelte Elemente werden als Fehler betrachtet.

    Standardwert: true
    options.generate_summary Boolean Kennzeichnung, die angibt, ob die zurückgegebenen Ergebnisse Zusammenfassungsinformationen enthalten. Weitere Informationen zu den zurückgegebenen Zusammenfassungsinformationen finden Sie unter <String>.summary in der Tabelle „Rückgabeergebnisse“.

    Gültige Werte:

    • true: Zusammenfassungsinformationen einbeziehen.
    • false: Zusammenfassungsinformationen nicht einbeziehen.

    Standardwert: false
    options.partial_commits Boolean Kennzeichnung, die angibt, ob die Unterstützung für teilweisen Commit aktiviert ist. Weitere Informationen zu Teil-Commits finden Sie unter Erweiterte IRE-Funktionen.

    Gültige Werte:

    • true: Teilweiser Commit aktiviert.
    • false: Teilweiser Commit deaktiviert.

    Standardwert: true
    options.partial_payloads Boolean Kennzeichnung, die angibt, ob die Unterstützung teilweiser Nutzlasten aktiviert ist. Weitere Informationen zu Teilnutzlasten finden Sie unter Erweiterte IRE-Funktionen und IRE-Datenquellenregel erstellen.

    Gültige Werte:

    • true: Teilnutzlast aktiviert.
    • false: Teilnutzlast deaktiviert.

    Standardwert: true
    options.skip_updating_last_scan_to_now Boolean Kennzeichnung, die angibt, ob die Aktualisierung des Zeitfelds „last_scan“ von sys_object_source übersprungen werden soll.
    Gültige Werte:
    • true: Wenn der Parameter source_recency_timestamp nicht in sys_object_source_infoübergeben wird, aktualisieren Sie das Zeitfeld last_scan von sys_object_source nicht.
    • false: Aktualisiert das Zeitfeld „last_scan“ von sys_object_source.

    Standard: Verwendet den Wert in der Systemeigenschaft glide.identification_engine.skip_updating_last_scan_to_now.
    options.skip_updating_source_last_discovered_to_now Boolean Kennzeichnung, die angibt, ob die Aktualisierung der Felder discovery_source und last_discovered in der Tabelle „Konfigurationselement“ [cmdb_ci] übersprungen werden soll.
    Gültige Werte:
    • true: Wenn „last_discovered“ in den Nutzlastelementwerten nicht angegeben ist, aktualisieren Sie die Felder „discovery_source“ und „last_discovered“ nicht.
    • false: Felder discovery_source und last_discovered aktualisieren.

    Standard: Verwendet den Wert in der Systemeigenschaft glide.identification_engine.skip_updating_source_last_discovered_to_now.
    Quelle Zeichenfolge Datenquelle der CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.
    Tabelle : 4. Ergebnisse
    Parameter Beschreibung
    <String> JSON-formatierte Zeichenfolge, die eine Liste der Ergebnisse für die Konfigurationselemente in der Eingabezeichenfolge ist.

    Datentyp: Zeichenfolge

    { 
  "additionalCommittedItems": [Array],  
  "additionalCommittedRelations": [Array], 
  "hasError": "Boolean", 
  "hasWarning": "Boolean",
  "items": [Array],  
  "relations": [Array], 
  "summary": {Object} 
}
    <String>.zusätzlicheCommittedItems Liste der CIs, die während der IRE-Verarbeitung der aktuellen Nutzlast festgeschrieben wurden, aber in der aktuellen Eingabenutzlast nicht vorhanden waren.

    Datentyp: Array

    "additionalCommittedItems": [
  {
    "className": "String",
    "errorCount": Number,
    "operation": "String",
    "identificationAttempts": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloads": [Array],
    "sysId": "String"
  }
]
    <String>.zusätzlicheCommittedItems.className Sys_class_name dieses zusätzlichen CI.

    Datentyp: Zeichenfolge
    <String>.zusätzlicheCommittedItems.errorCount Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind.

    Datentyp: Zahl
    <String>.zusätzlicheCommittedItems.errors Array von Objekten, das Fehler beschreibt, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind.

    Datentyp: Array

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.zusätzlicheCommittedItems.errors.error Typ des Fehlers, der beim Verarbeiten des zusätzlichen CI aufgetreten ist.

    Datentyp: Zeichenfolge
    <String>.zusätzlicheCommittedItems.errors.message Fehlermeldung beim Verarbeiten des zusätzlichen CI.

    Datentyp: Zeichenfolge
    <String>.zusätzlicheCommittedItems.identificationAttempts Array von Objekten, in dem jedes Objekt einen Versuch beschreibt, dieses zusätzliche CI zu identifizieren.
    Datentyp: Array
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    <String>.zusätzlicheCommittedItems.identificationAttempts.attemptResult Ergebnis dieses zusätzlichen CI-Identifizierungsversuchs.

    Datentyp: Zeichenfolge

    Mögliche Werte:
    • MATCHED: Identifizierung erfolgreich. In der Bezeichner-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • MULTI_MATCH: Identifizierung mit einem Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichner-Regeltabelle beim Abgleich mit den angegebenen Attributen gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • SKIPPED: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet.
    <String>.zusätzlicheCommittedItems.identificationAttempts.attributes Array von CI-Bezeichner-Eintragsattributen, die bei diesem zusätzlichen CI-Identifizierungsversuch verwendet werden.

    Datentyp: Array

    Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.:

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    <String>.zusätzlicheCommittedItems.identificationAttempts.hybridEntryCiAttributes Array von CI-Bezeichner-Eintragsattributen, die bei diesem zusätzlichen CI-Identifizierungsversuch verwendet werden.

    Datentyp: Array

    Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.:

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    <String>.zusätzlicheCommittedItems.identificationAttempts.identifierName Identifier-Regel, die für diesen zusätzlichen CI-Identifizierungsversuch verwendet wird.

    Datentyp: Zeichenfolge
    <String>.zusätzlicheCommittedItems.identificationAttempts.searchOnTable Name der Tabelle, die nach diesem zusätzlichen CI-Identifizierungsversuch durchsucht wurde.

    Datentyp: Zeichenfolge
    <String>.zusätzlicheCommittedItems.identifierEntrySysId Sys_id für die Bezeichnerregel, die zum Identifizieren dieses zusätzlichen CI verwendet wird.

    Bemerkenswerte Werte – Unbekannt: Identifizierung dieses zusätzlichen CI fehlgeschlagen. Details siehe errors.
    <String>.zusätzlicheCommittedItems.inputIndices Array von Indexwerten für CIs aus dem Anforderungstext-Array items, die diesem zusätzlichen CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  {
    Number
  }
]
    <String>.zusätzlicheCommittedItems.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    <String>.zusätzlicheCommittedItems.mergedPayloads Array von sys_id-Werten für Teilnutzlasten aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung dieses zusätzlichen CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    <String>.zusätzlicheCommittedItems.operation Vorgang, der für dieses zusätzliche CI ausgeführt wird.

    Datentyp: Zeichenfolge

    Mögliche Werte:
    • DELETE: Ein vorhandenes CI wird aus der Zieltabelle entfernt.
    • EINFÜGEN: Das zusätzliche CI wird als neuer Datensatz in die Zieltabelle eingefügt.
    • NO_CHANGE: Für das zusätzliche CI wird kein Vorgang ausgeführt.
    • UPDATE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert.
    • UPDATE_WITH_DOWNGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine generischere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgänger- oder Nachfolgeklasse ist.
    • UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (untergeordnete Klasse) geändert.
    <String>.zusätzlicheCommittedItems.sysId Sys_id für dieses zusätzliche CI durch Identifizierung gefunden.

    Datentyp: Zeichenfolge

    Bemerkenswerte Werte – Unbekannt: Identifizierung dieses zusätzlichen CI fehlgeschlagen. Details siehe errors.
    <String>.zusätzlicheCommittedItems.warnings Array von Objekten, die eine Warnung beschreiben, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Array

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.zusätzlicheCommittedItems.warnings.error Typ der Warnung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Zeichenfolge
    <String>.zusätzlicheCommittedItems.warnings.message Beim Verarbeiten dieses zusätzlichen CI ist eine Warnmeldung aufgetreten.

    Datentyp: Zeichenfolge
    <String>.zusätzlicheCommittedRelations Array von Objekten, die ein abhängiges Beziehungs-CI beschreiben, das nicht in der Liste des Anforderungstexts relations zum Einfügen oder Aktualisieren enthalten war.

    Datentyp: Array

    "additionalCommittedRelations": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String"
  }
]
    <String>.zusätzlicheCommittedRelations.Klassenname Der sys_class_name dieses zusätzlichen abhängigen Beziehungs-CI.

    Datentyp: Zeichenfolge

    Einziger unterstützter Wert: cmdb_rel_ci: Die CI-Beziehungstabelle.
    <String>.zusätzlicheCommittedRelations.errorCount Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Zahl
    <String>.zusätzlicheCommittedRelations.errors Array von Objekten, die Fehler beschreiben, die bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Array

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.zusätzlicheCommittedRelations.errors.error Typ des Fehlers, der beim Verarbeiten des zusätzlichen abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    <String>.zusätzlicheCommittedRelations.errors.message Die Fehlermeldung, die beim Verarbeiten dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    <String>.zusätzlicheCommittedRelations.inputIndices Indexwerte für abhängige Beziehungs-CI-Objekte im Anforderungstext-Array relations, die diesem zusätzlichen abhängigen Beziehungs-CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  Number
]
    <String>.zusätzlicheCommittedRelations.markers Markerwerte für die interne Verwendung.

    Datentyp: Array

    "markers": []
    <String>.zusätzlicheCommittedRelations.mergedPayloadIds Sys_id-Werte für Teilnutzlasten aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads], die für dieses CI zusammengeführt wurden. die während der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    <String>.zusätzlicheCommittedRelations.operation Vorgang, der für das zusätzliche abhängige Beziehungs-CI ausgeführt wurde.
    Mögliche Werte:
    • EINFÜGEN: Das abhängige Beziehungs-CI wird als neuer Datensatz in die Zieltabelle eingefügt.
    • INSERT_AS_INCOMPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle „CMDB IRE – unvollständige Nutzlasten“ [cmdb_ire_incomplete_payloads] eingefügt.
    • INSERT_AS_partial: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads] eingefügt.
    • NO_CHANGE: Für das abhängige Beziehungs-CI wird kein Vorgang ausgeführt.
    • UPDATE: Ein vorhandenes abhängiges Beziehungs-CI in der Zieltabelle wird aktualisiert.

    Datentyp: Zeichenfolge
    <String>.hasError Kennzeichnung, die angibt, ob ein Element oder eine Beziehung Fehler aufweist.

    Datentyp: Boolesch
    <String>.hatWarnung Kennzeichnung, die angibt, ob für ein Element oder eine Beziehung Warnungen vorliegen.

    Datentyp: Boolesch
    <String>.items Array von Objekten, die die erstellten oder aktualisierten CIs beschreiben.

    Datentyp: Array

    "items": [
  {  
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateIndices": [Array],
    "errorCount": Number, 
    "errors": [Array], 
    "identificationAttempts": [Array], 
    "identifierEntrySysId": "String",  
    "incompleteSysIds": "String",
    "info": [Array],
    "inputIndices": [Array], 
    "maskedAttributes": [Array],
    "operation": "String", 
    "partialSysIds": "String", 
    "relatedItems": [Array], 
    "relatedSysIds": [Array], 
    "sysId": "String" 
  }
]
    <String>.items.additionalRelatedItems Liste der JSON-Objekte, die Informationen zu zusätzlichen Such- und zugehörigen Elementen bereitstellen, die verarbeitet, aber nicht als Teil der Eingabenutzlast bereitgestellt wurden. Diese Elemente stammen aus Teilnutzlasten.

    Datentyp: Array

    "additionalRelatedItems": [ 
  {
    "className": "String", 
    "inputIndices": [Array],
    "mergedPayloadIds": [Array], 
    "operation": "String",
    "sysId": "String"
  }
]
    <String>.items.zusätzlicheZugehörigeElemente.Klassenname Klassen-/Tabellenname (sys_class_name) des CI, das erstellt oder aktualisiert wurde.

    Datentyp: Zeichenfolge
    <String>.items.additionalRelatedItems.inputIndices Indexwerte für CIs aus dem Anforderungstext-Array items, die diesem zugehörigen Element entsprechen.

    Datentyp: Array von Zahlen
    <String>.items.additionalRelatedItems.mergedPayloadIds Liste der sys_ids der Teilnutzlasten, die mit dem zugehörigen Element zusammengeführt wurden. Befindet sich in der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads].

    Datentyp: Array
    <String>.items.additionalRelatedItems.operation Typ des Vorgangs.

    Mögliche Werte:

    • EINFÜGEN: Neues CI wurde in die Datenbank eingefügt.
    • NO_CHANGE: Es wurden keine CI-Änderungen vorgenommen.
    • UPDATE: Vorhandenes CI wurde aktualisiert.

    Datentyp: Zeichenfolge
    <String>.items.zusätzlicheZugehörigeElemente.sysId Sys_id des CI, das aktualisiert oder erstellt wurde

    Datentyp: Zeichenfolge
    <String>.items.className Klassen-/Tabellenname (sys_class_name) des CI, das erstellt oder aktualisiert wurde.

    Datentyp: Zeichenfolge
    <String>.items.duplicateIndices Liste der Indizes von CIs, die Duplikate des aktuellen Elements sind.

    Datentyp: Array
    <String>.items.errorAnzahl Anzahl der beim Verarbeiten des Elements aufgetretenen Fehler.

    Datentyp: Zahl
    <String>.items.errors Array von Objekten, in dem jedes Objekt einen Fehler beschreibt, der bei der Verarbeitung dieses CI aufgetreten ist.

    Datentyp: Array

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.items.errors.error Typ des Fehlers, der beim Verarbeiten des CI aufgetreten ist.

    Datentyp: Zeichenfolge
    <String>.items.errors.message Fehlermeldung, die dem Fehler zugeordnet ist.

    Datentyp: Zeichenfolge
    <String>.items.identificationAttempts Liste der Versuche, die unternommen wurden, um die CIs zu identifizieren.

    Datentyp: Array

    "identificationAttempts": [
  { 
    "attemptResult": "String", 
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identifierName": "String",
    "searchOnTable": "String" 
  }
]
    <String>.items.identificationAttempts.attemptResult Ergebnisse des Versuchs, das CI zu identifizieren

    Mögliche Werte:

    • MATCHED: Identifizierung erfolgreich. In der Bezeichner-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • MULTI_MATCH: Identifizierung mit einem Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichner-Regeltabelle beim Abgleich mit den angegebenen Attributen gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • SKIPPED: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet.

    Datentyp: Zeichenfolge
    <String>.items.identificationAttempts.attributes Liste der CI-Bezeichner-Eintragsattribute, die während des Identifizierungsprozesses verwendet wurden.

    Datentyp: Array

    Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.:

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    <String>items.identificationAttempts.hybridEntryCiAttributes Liste der CI-Bezeichner-Eintragsattribute, die während des Identifizierungsprozesses verwendet wurden.

    Datentyp: Array

    Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.:

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    <String>.items.identificationAttempts.identifierName Bezeichnerregel, die für diesen CI-Identifizierungsversuch verwendet wird.

    Datentyp: Zeichenfolge
    <String>.items.identificationAttempts.searchOnTable Name der während des Identifizierungsprozesses durchsuchten Tabelle.

    Datentyp: Zeichenfolge
    <String>.items.identifierEntrySysId Sys_id für die Bezeichnerregel, die zum Identifizieren des CI verwendet wird. Befindet sich in der Tabelle „Bezeichnereintrag“ [cmdb_identifier_entry].

    Datentyp: Zeichenfolge
    <String>.items.incompleteSysIds Wenn das Element Fehler aufwies und als unvollständige Nutzlast gespeichert wurde, enthält dieser Parameter die sys_id des Datensatzes in der Tabelle „CMDB IRE – unvollständige Nutzlasten“ [cmdb_ire_incomplete_payloads].

    Datentyp: Zeichenfolge
    <String>.items.info Liste der Objekte, die zusätzliche Informationen zur Verarbeitung des Elements enthalten.

    Datentyp: Array

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    <String>.items.info.code Reklassifizierungstyp, der übersprungen wurde.
    Mögliche Werte:
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_UPGRADE

    Datentyp: Zeichenfolge
    <String>.items.info.message Nachricht, die zusätzliche Einblicke in den Grund für das Überspringen der Neuklassifizierung bietet.

    Datentyp: Zeichenfolge
    <String>.items.info.ruleSysId Sys_id der abgeglichenen Reklassifizierungs-Einschränkungsregel. Gilt nur, wenn IRE die Neuklassifizierung aufgrund der Regel zur Einschränkung der Neuklassifizierung überspringt. Dieser Wert ist leer, wenn die Neuklassifizierung aufgrund einer Nutzlast oder einer globalen Kennzeichnung übersprungen wird.

    Datentyp: Zeichenfolge
    <String>.items.inputIndizes Indizes des entsprechenden Eingabe-CI Bei Elementen der obersten Ebene handelt es sich um eine Liste mit Ganzzahlen. Für zugehörige CIs oder Such-CIs ist dies eine Liste von JSON-Objekten.

    Datentyp: Array von Zahlen
    <String>.items.maskedAttributes Liste der Attribute, deren Aktualisierung durch eine nicht autorisierende Datenquelle übersprungen wurde, wie in den Abgleichsregelndefiniert.

    Datentyp: Array
    <String>.items.operation Vorgang, der stattgefunden hat.

    Mögliche Werte:

    • EINFÜGEN: Neues CI wurde in die Datenbank eingefügt.
    • INSERT_AS_INCOMPLETE: Element wurde in der Tabelle „cmdb_ire_incomplete_payloads“ gespeichert.
    • INSERT_AS_partial: Element wurde in Tabelle „cmdb_ire_partial_payloads“ gespeichert.
    • UPDATE: Vorhandenes CI wurde aktualisiert.
    • UPDATE_WITH_DOWNGRADE: CI wurde aktualisiert, und die Klasse wurde in eine generischere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: CI wurde aktualisiert, und die Klasse wurde in eine Klasse geändert, die weder Vorgänger noch untergeordnet ist.
    • UPDATE_WITH_UPDRADE: CI wurde aktualisiert, und die Klasse wurde in eine spezialisiertere Klasse (untergeordnete Klasse) geändert.

    Datentyp: Zeichenfolge
    <String>.items.partialSysIds Wenn das Element Fehler aufwies und als Teilnutzlast gespeichert wurde, enthält dieser Parameter die sys_id des Datensatzes der Teilnutzlast.

    Datentyp: Zeichenfolge
    <String>.items.relatedItems Liste der JSON-Objekte, die ein zugehöriges CI (Tabellensuch-CI) aus dem Anforderungstext-Array items.lookup beschreiben.

    Datentyp: Array

    "relatedItems": [
  { 
    "className": "String",
    "errors": [Array],
    "errorCount": Number, 
    "incompleteSysIds": [Array],
    "inputIndices": [Array],
    "mergePayloadIds": [Array],
    "operation": "String",
    "partialSysIds": [Array], 
    "sysId": "String",
    "warningCount": Number,
    "warnings": [Array]
  }
]
    <String>.items.relatedItems.className Klassen-/Tabellenname (sys_class_name) des zugehörigen Elements.

    Datentyp: Zeichenfolge
    <String>.items.relatedItems.errors Liste der Fehler, die während der Verarbeitung des zugehörigen Elements aufgetreten sind.

    Datentyp: Array

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.items.relatedItems.errors.error Typ des Fehlers, der beim Verarbeiten des zugehörigen Elements aufgetreten ist.

    Datentyp: Zeichenfolge
    <String>.items.relatedItems.errors.message Fehlermeldung, die dem Fehler zugeordnet ist.

    Datentyp: Zeichenfolge
    <String>.items.relatedItems.errorCount Anzahl der bei der Verarbeitung der zugehörigen Elemente erkannten Fehler.

    Datentyp: Zahl
    <String>.items.relatedItems.incompleteSysIds Wenn die Beziehung Fehler aufwies und als unvollständige Nutzlast gespeichert wurde, ist dieser Wert die sys_id des Datensatzes in der Tabelle „CMDB IRE – unvollständige Nutzlasten“ [cmdb_ire_incomplete_payloads].

    Datentyp: Zeichenfolge
    <String>.items.relatedItems.inputIndices Index des entsprechenden Eingabeelements. Bei Elementen der obersten Ebene handelt es sich um eine Liste mit Ganzzahlen. Für zugehörige oder Suchelemente ist dies eine Liste von JSON-Objekten.

    Datentyp: Array von Zahlen oder Array von Objekten

    "inputIndices": [
  { 
   "mainIndex": Number, 
   "subIndex": Number 
  }
]
    <String>.items.relatedItems.inputIndices.mainIndex Indexwert aus dem Anforderungstext-Array items, der dem übergeordneten CI des zugehörigen Elements entspricht.

    Datentyp: Zahl
    <String>.items.relatedItems.inputIndices.subIndex Indexwert aus dem Anforderungstext-Array items.lookup, der dem zugehörigen Element entspricht.

    Datentyp: Zahl
    <String>.items.relatedItems.mergedPayloadIds Liste der sys_ids der Teilnutzlasten, die während der Verarbeitung mit dem CI zusammengeführt wurden.

    Datentyp: Array
    <String>.items.relatedItems.operation Vorgang, der stattgefunden hat.

    Mögliche Werte:

    • EINFÜGEN: Neues zugehöriges CI wurde in die Datenbank eingefügt.
    • INSERT_AS_INCOMPLETE: Element wurde in der Tabelle „cmdb_ire_incomplete_payloads“ gespeichert.
    • INSERT_AS_partial: Element wurde in Tabelle „cmdb_ire_partial_payloads“ gespeichert.
    • NO_CHANGE: Es wurden keine zugehörigen CI-Änderungen vorgenommen.
    • UPDATE: Vorhandenes zugehöriges CI wurde aktualisiert.
    • UPDATE_WITH_DOWNGRADE: Zugehöriges CI wurde aktualisiert, und die Klasse wurde in eine generischere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: Zugehöriges CI wurde aktualisiert, und die Klasse wurde in eine Klasse geändert, die weder Vorgänger noch untergeordnet ist.
    • UPDATE_WITH_UPDRADE: Zugehöriges CI wurde aktualisiert, und die Klasse wurde in eine spezialisiertere Klasse (untergeordnete Klasse) geändert.

    Datentyp: Zeichenfolge
    <String>.items.relatedItems.partialSysIds Wenn das zugehörige Element Fehler aufwies und als Teilnutzlast gespeichert wurde, enthält dies eine Liste der sys_ids der zugeordneten Datensätze in der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads].

    Datentyp: Array
    <String>.items.relatedItems.sysId Die sys_id des zugehörigen Elements.

    Datentyp: Zeichenfolge
    <String>.items.relatedItems.warningCount Anzahl der Warnungen, die beim Verarbeiten der zugehörigen Elemente aufgetreten sind.

    Datentyp: Zahl
    <String>.items.relatedItems.warnings Array von Objekten, das eine Warnung beschreibt, die bei der Verarbeitung der zugehörigen Elemente aufgetreten ist.

    Datentyp: Array

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.items.relatedItems.warnings.error Typ der Warnung, die beim Verarbeiten des zugehörigen Elements aufgetreten ist.

    Datentyp: Zeichenfolge
    <String>.items.relatedItems.warnings.message Nachricht, die der Warnung zugeordnet ist.

    Datentyp: Zeichenfolge
    <String>.items.relatedSysIds Liste der sys_id-Werte der CIs, die bei der Lookup-basierten Identifizierung zugehöriger Elemente verwendet werden.

    Datentyp: Zeichenfolge
    <String>.items.sys_id Sys_id des CI, das aktualisiert oder erstellt wurde

    Datentyp: Zeichenfolge
    <String>.Beziehungen Liste der JSON-Objekte, die ein abhängiges Beziehungs-CI aus dem Anforderungstext-Array relations beschreiben.

    Datentyp: Array

    "relations": [ 
  { 
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "incompleteSysIds": "String",
    "inputIndices": [Array],
    "operation": "String",
    "partialSysIds": "String",
    "sysId": "String" 
  }
]
    <String>.relations.Klassenname Sys_class_name dieses abhängigen Beziehungs-CI.

    Einziger unterstützter Wert: cmdb_rel_ci: CI-Beziehungstabelle.

    Datentyp: Zeichenfolge
    <String>.relations.errorAnzahl Anzahl der Fehler, die beim Verarbeiten des abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Zahl
    <String>.Beziehungen.Fehler Array von Objekten, die Fehler beschreiben, die beim Verarbeiten dieses abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Array

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.Beziehungen.Fehler.Fehler Typ des Fehlers, der beim Verarbeiten des abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    <String>.Beziehungen.Fehler.Nachricht Fehlermeldung beim Verarbeiten dieses abhängigen Beziehungs-CI.

    Datentyp: Zeichenfolge
    <String>.relations.incompleteSysIds Wenn die Beziehung Fehler aufwies und als unvollständige Nutzlast gespeichert wurde, ist dieser Wert die sys_id des Datensatzes in der Tabelle „CMDB IRE – unvollständige Nutzlasten“ [cmdb_ire_incomplete_payloads].

    Datentyp: Zeichenfolge
    <String>.relations.inputIndices Indizes für die abhängigen Beziehungs-CI-Objekte im Anforderungstext-Array relations, die diesem abhängigen Beziehungs-CI entsprechen.

    Datentyp: Array
    <String>.relations.operation Typ des durchgeführten Vorgangs.

    Mögliche Werte:

    • EINFÜGEN: Das abhängige Beziehungs-CI wurde als neuer Datensatz in die Zieltabelle eingefügt.
    • INSERT_AS_INCOMPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „CMDB-IRE – unvollständige Nutzlasten“ [cmdb_ire_incomplete_payloads] eingefügt.
    • INSERT_AS_partial: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads] eingefügt.
    • NO_CHANGE: Es wurde kein Vorgang ausgeführt.
    • UPDATE: Ein vorhandenes abhängiges Beziehungs-CI in der Zieltabelle wurde aktualisiert.

    Datentyp: Zeichenfolge
    <String>.relations.partialSysIds Wenn die Beziehung Fehler aufwies und als Teilnutzlast gespeichert wurde, ist dieser Wert die sys_id des Datensatzes in der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads].

    Datentyp: Zeichenfolge
    <String>.relations.sysId Sys_id des abhängigen Beziehungs-CI.

    Datentyp: Zeichenfolge
    <String>.Zusammenfassung Liste der JSON-Eigenschaften, die Statistiken darüber bereitstellen, wie viele Elemente pro Klasse eingefügt, aktualisiert usw. wurden.

    Datentyp: Array
    <String>.Zusammenfassung.<class_name> Statistiken für eine bestimmte Klasse.

    Datentyp: Objekt

    <class_name>: {
 "additionalInsertedItemCount": Number, 
 "errorCount": Number,
 "incompleteItemCount": Number,
 "insertedItemCount": Number,
 "partialItemCount": Number,
 "skippedItemCount": Number,
 "unchangedItemCount": Number,
 "updatedItemCount": Number,
 "warningCount": Number 
}
    <String>.Zusammenfassung.<class_name> .zusätzlicheEingefügteElementAnzahl Anzahl der aufgrund der Verarbeitung von Teilnutzlasten eingefügten Elemente.

    Datentyp: Zahl
    <String>.Zusammenfassung.<class_name> .errorAnzahl Anzahl der beim Verarbeiten von Elementen aufgetretenen Fehler.

    Datentyp: Zahl
    <String>.Zusammenfassung.<class_name> .incompleteItemCount Anzahl der Elemente, die in die Tabelle „CMDB IRE Unvollständige Nutzlasten“ [cmdb_ire_incomplete_payloads] eingefügt wurden.

    Datentyp: Zahl
    <String>.Zusammenfassung.<class_name> .insertedItemCount Anzahl der erstellten Elemente.

    Datentyp: Zahl
    <String>.Zusammenfassung.<class_name> .partialItemCount Anzahl der in der Tabelle „Teilnutzlast“ [cmdb_ire_partial_payloads] gespeicherten Elemente.

    Datentyp: Zahl
    <String>.Zusammenfassung.<class_name> .übersprungenElementAnzahl Anzahl der übersprungenen Elemente.

    Datentyp: Zahl
    <String>.Zusammenfassung.<class_name> .unchangedItemCount Anzahl der Elemente, die Einträge hatten, aber nicht geändert wurden.

    Datentyp: Zahl
    <String>.Zusammenfassung.<class_name> .updatedItemCount Anzahl der aktualisierten Elemente.

    Datentyp: Zahl
    <String>.Zusammenfassung.<class_name> .WarnungAnzahl Anzahl der Elemente, die bei der Verarbeitung eine Warnung generiert haben.

    Datentyp: Zahl

    Dieses Beispiel zeigt, wie mehrere CI-Einträge importiert werden.

    var payload = {
"items": [
{
 "className": "cmdb_ci_win_server", 
 "values": {
   "chassis_type": "Desktop",
   "os": "Windows 2012 R2 Datacenter",
   "name": "Windows2012Server1",
   "serial_number": "0000-0011-1690-8730-8636-5722-52",
   "cpu_count": "1"
  },
  "lookup": [
  {
     "values": {
       "valid": "true",
       "serial_number": "0000-0011-1690-8730-8636-5722-52",
       "serial_number_type": "bios"
      },
     "className": "cmdb_serial_number"
   },
   {
     "values": {
       "valid": "true",
       "serial_number": "3311-9736-4988-9744-1749-4183-41",
       "serial_number_type": "chassis"
      },
     "className": "cmdb_serial_number"
   }],

    "internal_id": "16777219",
    "sys_object_source_info": {
      "source_feed": "SN Discovery Feed 1",
      "source_name": "ServiceNow",
      "source_native_key": "16777219",
      "source_recency_timestamp": "2019-10-18 08:31:23"
   }},
   {  
   "className": "cmdb_ci_spkg",
   "values": {
     "name": "Windows 2012 R2 Datacenter",
     "key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL"
     },

  "related": [
    {
      "internal_id": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219",
      "values": {
        "name": "Windows 2012 R2 Datacenter-SAMLABVM52"
      },
      "className": "cmdb_software_instance",
      "sys_object_source_info": {
        "source_feed": "SN Discovery Feed 1",
        "source_name": "ServiceNow",
        "source_native_key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219"
  }}], 
  "settings" : {
        "skipReclassificationRestrictionRules" : "false",
        "updateWithoutDowngrade" : "true",
        "updateWithoutUpgrade" : "true",
        "updateWithoutSwitch" : "true"
      }}, 
  {
  "className": "cmdb_ci_app_server_tomcat",
  "values": {
    "running_process_key_parameters": "/opt/OV/nonOV/tomcat/b/temp org.apache.catalina.startup.Bootstrap start",
    "install_directory": "/opt/OV/nonOV/tomcat/b",
    "name": "Tomcat@hpom9:3443",
    "server_port": "8006",
    "sys_class_name": "cmdb_ci_app_server_tomcat"
  },

  "internal_id": "tomcat_id"
  }],

"relations": [
  {
    "parent_id": "tomcat_id",
    "child_id": "16777219",
    "type": "Runs on::Runs"
  }],

"referenceItems": [
  {
    "referenceField": "installed_on",
    "referenced": "16777219",
    "referencedBy": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219"
  }]};

var input = JSON.stringify((payload));
var output = sn_cmdb.IdentificationEngine.createOrUpdateCIEnhanced('ServiceNow', input, {});

gs.info(JSON.stringify(JSON.parse(output), null, 2));

    Ausgabe:

    {

"items": [
{
  "className": "cmdb_ci_win_server",
  "operation": "NO_CHANGE",
  "sysId": "65d873d2b3a0001028f6eae2c6a8dc2a",
  "relatedSysIds": [
    "a1d873d2b3a0001028f6eae2c6a8dc32",
    "a1d873d2b3a0001028f6eae2c6a8dc33"
],

"relatedItems": [
{
  "className": "cmdb_serial_number",
  "sysId": "a1d873d2b3a0001028f6eae2c6a8dc32",
  "markers": [],
  "inputIndices": [
  {
    "mainIndex": 0,
    "subIndex": 0
  }]
},
  "className": "cmdb_serial_number",
  "sysId": "a1d873d2b3a0001028f6eae2c6a8dc33",
  "markers": [],
  "inputIndices": [
  {
    "mainIndex": 0,
    "subIndex": 1
  }]
}],

"additionalRelatedItems": [],
"identificationAttempts": [],
"errorCount": 0,
"inputIndices": [0]
},
{
"className": "cmdb_ci_spkg",
"operation": "NO_CHANGE",
"sysId": "c764e971b320001028f6eae2c6a8dc44",

"relatedSysIds": [
  "8b64e971b320001028f6eae2c6a8dc47"
],
"relatedItems": [
  {
  "className": "cmdb_software_instance",
  "sysId": "8b64e971b320001028f6eae2c6a8dc47",
  "markers": [],
  "inputIndices": [
    {
      "mainIndex": 1,
      "subIndex": 0
    }]
  }],

"additionalRelatedItems": [],
"identifierEntrySysId": "a52a87c03746220006b216a543990e8c",
"identificationAttempts": [
  {
    "attributes": [
      "key"
     ],
    "identifierName": "Software",
    "attemptResult": "MATCHED",
    "searchOnTable": "cmdb_ci_spkg",
    "hybridEntryCiAttributes": []
  }],

"errorCount": 0,
"inputIndices": [1]
},

{
"className": "cmdb_ci_app_server_tomcat",
"operation": "INSERT",
"sysId": "6f29f3d2b3a0001028f6eae2c6a8dcc6",
"identifierEntrySysId": "Unknown",
"identificationAttempts": [
{
  "attributes": [
    "install_directory",
    "running_process_key_parameters",
    "sys_class_name"
  ],
"identifierName": "Tomcat",
"attemptResult": "NO_MATCH",
"searchOnTable": "cmdb_ci_app_server_tomcat",
"hybridEntryCiAttributes": []
},
{
"attributes": [
  "cl_port",
  "sys_class_name"
],
"identifierName": "Application Rule",
"attemptResult": "SKIPPED",
"searchOnTable": "cmdb_ci_appl",
"hybridEntryCiAttributes": []
},
{
"attributes": [
  "running_process_command",
  "running_process_key_parameters",
  "sys_class_name"
],
"identifierName": "Application Rule",
"attemptResult": "NO_MATCH",
"searchOnTable": "cmdb_ci_appl",
"hybridEntryCiAttributes": []
}
],

"errorCount": 0,
"inputIndices": [2]
}
],
"additionalCommittedItems": [],
"relations": [
{
  "className": "cmdb_rel_ci",
  "operation": "INSERT",
  "sysId": "6729f3d2b3a0001028f6eae2c6a8dcc9",
  "errorCount": 0,
  "inputIndices": [0]
}],
"additionalCommittedRelations": []
}

    IdentificationEngine – identifyCI(String jsonString)

    Bestimmt den Vorgang (Einfügen/Aktualisieren), der mit der angegebenen Nutzlast ausgeführt werden soll, ohne dass der Vorgang in der Datenbank festgeschrieben wird.

    Dies funktioniert genau wie createOrUpdateCI(), schreibt jedoch das Ergebnis nicht fest.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    jsonString Zeichenfolge Eine JSON-formatierte Zeichenfolge mit Configuration Items, die hinzugefügt oder aktualisiert werden sollen. Jede Eingabezeichenfolge hat das Format „items: [{}], relations: [{}]“, wobei jedes Element in den items- und relations-Listen Name-Wert-Paare enthält.
    Die möglichen Name-Wert-Paare innerhalb der Elementliste sind:
    • className – Sys_class_name des CI, das erstellt oder aktualisiert werden soll.
    • values:{} – Feldinformationen für das CI als Name-Wert-Paare, wobei der Name der Feldname ist.
    • Suche:[{}] – Liste von Datensätzen, wobei jedes Element Name-Wert-Paare wie die Elementliste aufweist.
    Die möglichen Name-Wert-Paare innerhalb der relations-Liste sind:
    • parent: Index des übergeordneten Elements in der Abhängigkeitsbeziehung
    • child: Index des untergeordneten Elements in der Abhängigkeitsbeziehung
    • Typ: Beziehungstyp. Dies ist einer der Namensfeldwerte aus der Tabelle „cmdb_rel_type“.
    Tabelle : 6. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Eine JSON-formatierte Zeichenfolge, die eine Ergebnisliste darstellt. Jede Ergebniszeichenfolge hat das Format „items: [{}], relations: [{}]“, wobei jedes Element in den items- und relations-Listen Name-Wert-Paare enthält.
    Die möglichen Name-Wert-Paare innerhalb der Elementliste sind:
    • className – Sys_class_name für das CI, das aktualisiert oder erstellt wurde.
    • operation: Auszuführender Vorgang, einer der folgenden:
      • LÖSCHEN
      • EINFÜGEN
      • AKTUALISIEREN
      • UPDATE_WITH_DOWNGRADE
      • UPDATE_WITH_SWITCH
      • UPDATE_MIT_UPGRADE
    • sysId: Sys_id des CI, das aktualisiert oder erstellt wurde.
    • relatedSysIds – Liste der sys_id-Werte von CIs, die bei der Lookup-basierten Identifizierung verwendet werden.
    • identifyEntrySysId: Sys_id des Bezeichnereintrags, der während des Abgleichs verwendet wird.
    • Fehler: Liste der Fehler im Format (Fehler, Nachrichtenzeichenfolge)
    • doubleIndices: Liste der Indizes von Elementen, die Duplikate des aktuellen Elements sind.
    • identifyAttempts: Liste der Versuche im Format (attributes, identiferName, attemptResult, searchOnTable).
      • Attribute: Attribute des Bezeichnereintrags, der während der Identifizierung verwendet wird
      • identiferName – CI-Bezeichner, zu dem dieser Bezeichnereintrag gehört
      • attemptResult: SKIPPED, NO_MATCH, MATCHED, MULTI_MATCH
      • searchOnTable: Tabelle, die während des Identifizierungsprozesses durchsucht wird.
    Die möglichen Name-Wert-Paare innerhalb der relations-Liste sind:
    • className – Klassenname des Beziehungs-CI; immer cmdb_rel_ci
    • operation: Typ des Vorgangs: INSERT, UPDATE, NO_CHANGE
    • sysId: Sys_id des eingefügten oder aktualisierten Beziehungs-CI

    Im Folgenden wird gezeigt, wie ein Konfigurationselement neu klassifiziert wird.

    var payload = {
  "items": [
    {
      "className": "cmdb_ci_win_server",
      "values": {
        "short_description": "Linux server description",
        "name": "Linux Server 1"
      }
    }
  ]
};

var input = JSON.stringify(payload);
var output = sn_cmdb.IdentificationEngine.identifyCI(input);

gs.info(JSON.stringify(JSON.parse(output), null, 2));

    Ausgabe:

    {
  "items": [
    {
      "className": "cmdb_ci_linux_server",
      "operation": "NO_CHANGE",
      "sysId": "440577800f321010150efc91ff767e94",
      "identifierEntrySysId": "556eb250c3400200d8d4bea192d3ae92",
      "identificationAttempts": [
        {
          "attributes": [],
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "serial_number",
            "serial_number_type"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "searchOnTable": "cmdb_serial_number",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "serial_number"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "name"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "MATCHED",
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        }
      ],
      "info": [
        {
          "message": "CI Reclassification not allowed from class: [cmdb_ci_linux_server] to [cmdb_ci_win_server] by a reclassification restriction rule",
          "code": "SKIPPED_CLASS_SWITCH",
          "ruleSysId": "b3d4b3800f321010150efc91ff767eab"
        }
      ],
      "errorCount": 0,
      "warningCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ],
      "mergedPayloadIds": []
    }
  ],
  "additionalCommittedItems": [],
  "relations": [],
  "additionalCommittedRelations": []
}

    IdentificationEngine – identifyCIEnhanced(String source, String input, Object options)

    Bestimmt den Vorgang Configuration Management Database (CMDB) (Einfügen/Aktualisieren), der mit der angegebenen Nutzlast (Anforderungstext) ausgeführt werden soll, ohne dass die Vorgänge in der Datenbank festgeschrieben werden.

    Verwenden Sie diese Methode, um die Übermittlung einer Nutzlast zu simulieren.

    Diese Methode ähnelt der Methode IdentificationEngine – identifyCI(String jsonString), unterstützt jedoch auch die folgende Funktionalität:
    • Teilnutzlasten
      • Gibt bei einem Element mit einer Warnung oder einem Fehler an, ob ein Elementvorgang INSERT_AS_partial oder INSERT_INCOMPLETE ist.
      • Gibt die sys_ids von Teilnutzlasten zurück, die mit vorhandenen Teilnutzlasten zusammengeführt wurden.
    • Unterstützt die Funktion „Nutzlast-Deduplizierung“.
    • Generiert eine Zusammenfassung.
    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Eingabe Zeichenfolge Erforderlich. Eingabenutzlast Eine JSON-formatierte Zeichenfolge von Konfigurationselementen, die hinzugefügt oder aktualisiert werden soll. 
    "input" { 
 "items": [Array],
 "referenceItems": [Array],
 "relations": [Array]
}
    input.items Array Array von Objekten, die die hinzuzufügenden oder zu aktualisierenden Elemente definieren.
    "items": [
  { 
    "className": "String",
    "display_values": {Object},
    "internal_id": "String",
    "lookup": [Array],
    "related": [Array],
    "settings": {Object},
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    input.items.className Zeichenfolge Erforderlich. Klassen-/Tabellenname, sys_class_name, des Konfigurationselements (CI), das erstellt oder aktualisiert werden soll.

    Dieser Wert kann eine beliebige CMDB Klasse/Tabelle sein, z. B. cmdb_ci_linux_server oder cmdb_ci_win_server.
    input.items.display_values Objekt Referenzfelder, die für dieses zugehörige Element als Name-Wert-Paare erstellt oder aktualisiert werden sollen, wobei der Name der Feldname und der Wert der referenzierte Anzeigewert ist. Wenn Sie die sys_id anstelle des Anzeigewerts für Referenzfelder verwenden möchten, übergeben Sie die Informationen im Parameter input.items.lookup.values und nicht in diesem Parameter.

    Referenzfeldnamen hängen von den vom Benutzer ausgewählten Feldern ab, z. B.:

    "display_values": {
  "model_id": "String",
  "location": "String"
}
    input.items.internal_id Zeichenfolge Eindeutiger Elementbezeichner für die zugeordnete Nutzlast.

    Dies kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein.
    input.items.lookup Array Identifiziert das Element der obersten Ebene, das die Suche enthält (suchbasierte Identifizierung). Diese Datensätze werden verwendet, um das Konfigurationselement basierend auf einer Suchtabelle zu identifizieren, die einen Verweis auf cmdb_ci enthält.

    Beispiel:

    "lookup": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    input.items.lookup.className Zeichenfolge Erforderlich. Klassen-/Tabellenname, sys_class_name, des Konfigurationselements (CI), das erstellt oder aktualisiert werden soll.

    Dieser Wert kann eine beliebige CMDB Klasse/Tabelle sein, z. B. cmdb_serial_number oder cmdb_ci_network_adapter.
    input.items.lookup.internal_id Zeichenfolge Eindeutiger Bezeichner des Suchelements für die zugeordnete Nutzlast.

    Dies kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein.
    input.items.lookup.sys_object_source_info Objekt Definiert einen eindeutigen CI-Bezeichner für eine bestimmte Datenquelle. Verschiedene Quellen können unterschiedliche Name-Wert-Paare für dasselbe CI haben.
    "sys_object_source_info": { 
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    input.items.lookup.sys_object_source_info.source_feed Zeichenfolge Wenn die Quelle mehrere Feeds haben kann, geben Sie in diesem Feld den Namen des Feeds an, der dieses Element sendet.

    Die Datenquelle generiert diesen Feed-Namen. Es kann eine beliebige Zeichenfolge sein, die den Quell-Feed eindeutig identifiziert.
    input.items.lookup.sys_object_source_info.source_name Zeichenfolge Datenquelle der CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.
    input.items.lookup.sys_object_source_info.source_native_key Zeichenfolge Eindeutige Schlüssel-ID für das Element aus der Quelle.

    Die Datenquelle generiert diesen Schlüssel. Es kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist.
    input.items.lookup.sys_object_source_info.source_recency_timestamp Zeichenfolge UTC-Datum/Uhrzeit, zu der das Element gescannt wurde.

    Format: JJJJ-MM-TT hh:mm:ss
    input.items.lookup.values Objekt Feldinformationen für das CI als Name-Wert-Paare, wobei der Name der Feldname ist. Bei der Aktualisierung von Referenzfeldern muss der Wert die referenzierte sys_id sein.

    Feldnamen und -typen hängen von den vom Benutzer ausgewählten Feldern ab, z. B.:

    "values": {
  "serial_number": "String",
  "serial_number_type": "String",
  "valid": "String",
  "ip_address": "String",
  "mac_address": "String"
}
    input.items.related Array Verweis auf das oberste Element, das die zugehörige Liste enthält. Regeln im Zugehörigen Eintrag [cmdb_related_entry] definieren, welche Art von Datensätzen in diesem Array enthalten sein kann. Diese Datensätze werden verwendet, um Elemente basierend auf einer zugehörigen Tabelle hinzuzufügen, die einen Verweis auf das identifizierte CI enthält.

    Die zugehörige Tabelle kann cmdb_ci erweitern oder nicht. Diese Datensätze werden nicht zum Identifizieren des Konfigurationselements verwendet.

    "related" [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    input.items.related.className Zeichenfolge Erforderlich. Klassen-/Tabellenname, sys_class_name, des Konfigurationselements (CI), das erstellt oder aktualisiert werden soll.

    Dieser Wert kann eine beliebige CMDB Klasse/Tabelle sein, z. B. cmdb_software_instance oder cmdb_key_value.
    input.items.related.internal_id Zeichenfolge Eindeutiger Bezeichner für dieses zugehörige Element in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein.
    input.items.related.sys_object_source_info Objekt Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle darstellt. Verschiedene Quellen können unterschiedliche Name-Wert-Paare für dasselbe CI haben.
    "sys_object_source_info": { 
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    input.items.related.sys_object_source_info.source_feed Zeichenfolge Wenn die Quelle mehrere Feeds haben kann, geben Sie in diesem Feld den Namen des Feeds an, der dieses Element sendet.

    Die Datenquelle generiert diesen Feed-Namen. Es kann eine beliebige Zeichenfolge sein, die den Quell-Feed eindeutig identifiziert.
    input.items.related.sys_object_source_info.source_name Zeichenfolge Gibt die Datenquelle der CI-Informationen an. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.
    input.items.related.sys_object_source_info.source_native_key Zeichenfolge Eindeutiger Schlüssel/ID aus der Quelle für das zugehörige Element.

    Die Datenquelle generiert diesen Schlüssel. Es kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist.
    input.items.related.sys_object_source_info.source_recency_timestamp Zeichenfolge UTC-Datum und Uhrzeit, zu der das Element gescannt wurde.

    Format: JJJJ-MM-TT hh:mm:ss
    input.items.related.values Objekt Felder, die für dieses zugehörige Element als Name/Wert-Paare erstellt oder aktualisiert werden sollen, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_id sein. Wenn Sie den Anzeigewert anstelle der sys_id für Referenzfelder verwenden möchten, übergeben Sie diese Informationen in einem display_values -Objekt anstatt im values -Objekt.

    Feldnamen und -typen hängen von den vom Benutzer ausgewählten Feldern ab, z. B.:

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    input.items.settings Objekt Parameter, die die zulässigen Aktualisierungstypen definieren.
    "settings": { 
  "skipReclassificationRestrictionRules": Boolean, 
  "updateWithoutDowngrade": Boolean, 
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    input.items.settings.skipReclassificationRestrictionRules Boolean Kennzeichnung, die angibt, ob IRE die Regel zur Einschränkung der Neuklassifizierung ausführen soll, die der Klasse für das Nutzlastelement entspricht.
    Gültige Werte:
    • true: Ausführung der Regel überspringen.
    • false: Regel wird ausgeführt.

    Standardwert: false
    input.items.settings.updateWithoutDowngrade Boolean Kennzeichnung, die angibt, ob sowohl Aktualisierung als auch Downgrade für dieses Element zulässig sind.
    Gültige Werte:
    • true: Element aktualisieren, Downgrade ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierung als auch Downgrade sind zulässig.

    Standardwert: false
    input.items.settings.updateWithoutSwitch Boolean Kennzeichnung, die angibt, ob das Element aktualisiert und die Klasse gewechselt werden kann.
    Gültige Werte:
    • true: Element aktualisieren, Klassenwechsel ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Klassenwechsel sind zulässig.

    Standardwert: false
    input.items.settings.updateOhneUpgrade Boolean Kennzeichnung, die angibt, ob Update und Upgrade für dieses Element zulässig sind.
    Gültige Werte:
    • true: Element wird aktualisiert, Upgrade ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Upgrades sind zulässig.

    Standardwert: false
    input.items.sys_object_source_info Objekt Eindeutiger CI-Bezeichner für eine bestimmte Quelle.
    "sys_object_source_info": { 
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    input.items.sys_object_source_info.source_feed Zeichenfolge Wenn die Quelle mehrere Feeds haben kann, geben Sie in diesem Feld den Namen des Feeds an, der dieses Element sendet.

    Die Datenquelle generiert diesen Feed-Namen. Es kann eine beliebige Zeichenfolge sein, die den Quell-Feed eindeutig identifiziert.
    input.items.sys_object_source_info.source_name Zeichenfolge Datenquelle der CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.
    input.items.sys_object_source_info.source_native_key Zeichenfolge Eindeutiger Schlüssel/ID für das Element aus der Quelle.

    Die Datenquelle generiert diesen Schlüssel. Es kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist.
    input.items.sys_object_source_info.source_recency_timestamp Zeichenfolge UTC-Datum und Uhrzeit, zu der das Element gescannt wurde.

    Format: JJJJ-MM-TT hh:mm:ss
    input.items.values Objekt Felder, die für dieses zugehörige Element als Name/Wert-Paare erstellt oder aktualisiert werden sollen, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_id sein. Wenn Sie den Anzeigewert anstelle der sys_id für Referenzfelder verwenden möchten, übergeben Sie diese Informationen in einem display_values -Objekt anstatt im values -Objekt.

    Feldnamen und -typen hängen von den vom Benutzer ausgewählten Feldern ab, z. B.:

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    input.referenceItems Array Array von Objekten, die Referenzen zwischen Elementen in der Eingabenutzlast definieren. 
    "referenceItems": [
  { 
    "referenced": "String", 
    "referencedBy": "String", 
    "referenceField": "String" 
  }
]
    input.referenceItems.referenced Zeichenfolge Der internal_id, der für das Element definiert ist, auf das von einem anderen Element verwiesen wird.
    input.referenceItems.referencedBy Zeichenfolge Der internal_id, der für das Element definiert ist, das auf ein anderes Element verweist.
    input.referenceItems.referenceField Zeichenfolge Name des Referenzfelds in der Klasse/Tabelle für das Element referencedBy.
    input.relations Array Array von Objekten, die Beziehungen zwischen Elementen in der Eingabenutzlast angeben.
    Ein Objekt in diesem Array kann eines von zwei Formaten verwenden.
    • Das Objekt kann (nur) mithilfe der Name-Wert-Paare parent und child eine Beziehung zwischen zwei Elementen der obersten Ebene definieren, wobei Werte Elementindizes aus dem Payload-Array items darstellen.
      "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    • Das Objekt kann eine Beziehung zwischen zwei beliebigen Elementen definieren, einschließlich oberster Ebene, zugehöriger Elemente oder Suchelemente, wobei die Schlüssel/Wert-Paare parent_id und child_id verwendet werden, wobei -Werte internal_id Werte darstellen, die für diese Elemente definiert sind.
      "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    input.relations.child Nummer Integer-Index des CI-Objekts im Array items, das das untergeordnete Element in der Beziehung darstellt (items, items.related oder items.lookup).
    input.relations.child_id Zeichenfolge internal_id des untergeordneten Elements in der Beziehung (items, items.related oder items.lookup).
    input.relations.parent Nummer Integer-Index des übergeordneten Elements im items -Array (items, items.related oder items.lookup.)
    input.relations.parent_id Zeichenfolge internal_id des übergeordneten Elements in der Beziehung (items, items.related oder items.lookup).
    input.relations.sys_rel_source_info Objekt Discovery-Quelleninformationen für die Beziehung. Bei Nicht-Abhängigkeitsbeziehungen werden diese Informationen in der Tabelle „Beziehungsquellen“ [sys_rel_source] gespeichert (nicht beibehalten für die Methoden identifyCIEnhanced() oder identifyCI() ).

    Datentyp: Objekt

    "sys_rel_source_info": { 
  "source_name": "String", 
  "source_feed": "String" 
}
    input.relations.sys_rel_source_info.source_name Zeichenfolge Name der Discovery-Quelle

    Standard: Discovery-Quelle, die im API-Methodenparameter übergeben wird.
    input.relations.sys_rel_source_info.source_feed Zeichenfolge Jede Zeichenfolge, die eine Untererkennung/ein Scan innerhalb der Erkennungsquelle ist.

    Standard: „UNKNOWN“ wird in der Spalte „source_feed“ gespeichert, wenn ein Datensatz in der Tabelle „sys_rel_source“ erstellt wird.
    input.relations.type Zeichenfolge Typ der Beziehung, die zwischen den übergeordneten und untergeordneten Elementen besteht. Dies muss ein Namensfeldwert aus der Tabelle „CI-Beziehungstyp“ [cmdb_rel_type] sein.
    Optionen Objekt Optional, aber {} oder null muss übergeben werden. Optionen zum Aktivieren oder Deaktivieren von Funktionen.
    Hinweis:
    Standardmäßig oder wenn partial_payloads auf „true“ festgelegt ist, sind sowohl partial_commits als auch deduplicate_payloads aktiviert, auch wenn sie auf „false“ festgelegt sind, da diese Funktionen für die Funktionalität von Teilnutzlasten erforderlich sind.
    "options": { 
 "deduplicate_payloads": "Boolean",
 "generate_summary": "Boolean", 
 "partial_commits": "Boolean", 
 "partial_payloads": "Boolean",
 "skip_updating_last_scan_to_now": "Boolean",
 "skip_updating_source_last_discovered_to_now": "Boolean"
}
    options.deduplizieren_nutzlasten Boolean Kennzeichnung, die angibt, ob doppelte Elemente zusammengeführt oder als Fehler betrachtet werden.

    Gültige Werte:

    • true: Doppelte Elemente werden zusammengeführt.
    • false: Doppelte Elemente werden als Fehler betrachtet.

    Standardwert: true
    options.generate_summary Boolean Kennzeichnung, die angibt, ob die zurückgegebenen Ergebnisse Zusammenfassungsinformationen enthalten. Weitere Informationen zu den zurückgegebenen Zusammenfassungsinformationen finden Sie unter <String>.summary in der Tabelle „Rückgabeergebnisse“.

    Gültige Werte:

    • true: Zusammenfassungsinformationen einbeziehen.
    • false: Zusammenfassungsinformationen nicht einbeziehen.

    Standardwert: false
    options.partial_commits Boolean Kennzeichnung, die angibt, ob die Unterstützung für teilweisen Commit aktiviert ist. Weitere Informationen zu Teil-Commits finden Sie unter Erweiterte IRE-Funktionen.

    Gültige Werte:

    • true: Teilweiser Commit aktiviert.
    • false: Teilweiser Commit deaktiviert.

    Standardwert: true
    options.partial_payloads Boolean Kennzeichnung, die angibt, ob die Unterstützung teilweiser Nutzlasten aktiviert ist. Weitere Informationen zu Teilnutzlasten finden Sie unter Erweiterte IRE-Funktionen und IRE-Datenquellenregel erstellen.

    Gültige Werte:

    • true: Teilnutzlast aktiviert.
    • false: Teilnutzlast deaktiviert.

    Standardwert: true
    options.skip_updating_last_scan_to_now Boolean Kennzeichnung, die angibt, ob die Aktualisierung des Zeitfelds „last_scan“ von sys_object_source übersprungen werden soll.
    Gültige Werte:
    • true: Wenn der Parameter source_recency_timestamp nicht in sys_object_source_infoübergeben wird, aktualisieren Sie das Zeitfeld last_scan von sys_object_source nicht.
    • false: Aktualisiert das Zeitfeld „last_scan“ von sys_object_source.

    Standard: Verwendet den Wert in der Systemeigenschaft glide.identification_engine.skip_updating_last_scan_to_now.
    options.skip_updating_source_last_discovered_to_now Boolean Kennzeichnung, die angibt, ob die Aktualisierung der Felder discovery_source und last_discovered in der Tabelle „Konfigurationselement“ [cmdb_ci] übersprungen werden soll.
    Gültige Werte:
    • true: Wenn „last_discovered“ in den Nutzlastelementwerten nicht angegeben ist, aktualisieren Sie die Felder „discovery_source“ und „last_discovered“ nicht.
    • false: Felder discovery_source und last_discovered aktualisieren.

    Standard: Verwendet den Wert in der Systemeigenschaft glide.identification_engine.skip_updating_source_last_discovered_to_now.
    Quelle Zeichenfolge Datenquelle der CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.
    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    <String> JSON-formatierte Zeichenfolge, die eine Liste der Ergebnisse für die Konfigurationselemente in der Eingabezeichenfolge ist.

    Datentyp: Zeichenfolge

    { 
  "additionalCommittedItems": [Array],  
  "additionalCommittedRelations": [Array], 
  "hasError": "Boolean", 
  "hasWarning": "Boolean",
  "items": [Array],  
  "relations": [Array], 
  "summary": {Object} 
}
    <String>.zusätzlicheCommittedItems Liste der CIs, die während der IRE-Verarbeitung der aktuellen Nutzlast festgeschrieben wurden, aber in der aktuellen Eingabenutzlast nicht vorhanden waren.

    Datentyp: Array

    "additionalCommittedItems": [
  {
    "className": "String",
    "errorCount": Number,
    "operation": "String",
    "identificationAttempts": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloads": [Array],
    "sysId": "String"
  }
]
    <String>.zusätzlicheCommittedRelations Array von Objekten, die ein abhängiges Beziehungs-CI beschreiben, das nicht in der Liste des Anforderungstexts relations zum Einfügen oder Aktualisieren enthalten war.

    Datentyp: Array

    "additionalCommittedRelations": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String"
  }
]
    <String>.hasError Kennzeichnung, die angibt, ob ein Element oder eine Beziehung Fehler aufweist.

    Datentyp: Boolesch
    <String>.hatWarnung Kennzeichnung, die angibt, ob für ein Element oder eine Beziehung Warnungen vorliegen.

    Datentyp: Boolesch
    <String>.items Liste der Objekte, die die erstellten oder aktualisierten CIs beschreiben.

    Datentyp: Array

    "items": [ 
  {  
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateIndices": [Array],
    "errorCount": Number, 
    "errors": [Array], 
    "identificationAttempts": [Array], 
    "identifierEntrySysId": "String",
    "info": [Array], 
    "inputIndices": [Array], 
    "maskedAttributes": [Array],
    "operation": "String",
    "relatedSysIds": [Array], 
    "sysId": "String" 
  }
]
    <String>.items.additionalRelatedItems Liste der JSON-Objekte, die Informationen zu zusätzlichen Such- und zugehörigen Elementen bereitstellen, die verarbeitet, aber nicht als Teil der Eingabenutzlast bereitgestellt wurden. Diese Elemente stammen aus Teilnutzlasten.

    Datentyp: Array

    "additionalRelatedItems": [ 
  {
    "className": "String", 
    "inputIndices": [Array],
    "mergedPayloadIds": [Array], 
    "operation": "String",
    "sysId": "String"
  }
]
    <String>.items.zusätzlicheZugehörigeElemente.Klassenname Klassen-/Tabellenname (sys_class_name) des CI, das erstellt oder aktualisiert wurde.

    Datentyp: Zeichenfolge
    <String>.items.additionalRelatedItems.inputIndices Indexwerte für CIs aus dem Anforderungstext-Array items, die diesem zugehörigen Element entsprechen.

    Datentyp: Array von Zahlen
    <String>.items.additionalRelatedItems.mergedPayloadIds Liste der sys_ids der Teilnutzlasten, die mit dem zugehörigen Element zusammengeführt wurden. Befindet sich in der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads].

    Datentyp: Array
    <String>.items.additionalRelatedItems.operation Typ des Vorgangs.

    Mögliche Werte:

    • EINFÜGEN: Neues CI wurde in die Datenbank eingefügt.
    • NO_CHANGE: Es wurden keine CI-Änderungen vorgenommen.
    • UPDATE: Vorhandenes CI wurde aktualisiert.

    Datentyp: Zeichenfolge
    <String>.items.zusätzlicheZugehörigeElemente.sysId Sys_id des CI, das aktualisiert oder erstellt wurde

    Datentyp: Zeichenfolge
    <String>.items.className Klassen-/Tabellenname (sys_class_name) des CI, das erstellt oder aktualisiert wurde.

    Datentyp: Zeichenfolge
    <String>.items.duplicateIndices Liste der Indizes von CIs, die Duplikate des aktuellen Elements sind.

    Datentyp: Array
    <String>.items.errorAnzahl Anzahl der beim Verarbeiten des Elements aufgetretenen Fehler.

    Datentyp: Zahl
    <String>.items.errors Array von Objekten, in dem jedes Objekt einen Fehler beschreibt, der bei der Verarbeitung dieses CI aufgetreten ist.

    Datentyp: Array

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.items.errors.error Typ des Fehlers, der beim Verarbeiten des CI aufgetreten ist.

    Datentyp: Zeichenfolge
    <String>.items.errors.message Die Fehlermeldung, die beim Verarbeiten des CI aufgetreten ist.

    Datentyp: Zeichenfolge
    <String>.items.identificationAttempts Liste der Versuche, die unternommen wurden, um die CIs zu identifizieren.

    Datentyp: Array

    "identificationAttempts": [
  { 
    "attemptResult": "String", 
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identifierName": "String",
    "searchOnTable": "String" 
  }
]
    <String>.items.identificationAttempts.attemptResult Ergebnisse des Versuchs, das CI zu identifizieren

    Mögliche Werte:

    • MATCHED: Identifizierung erfolgreich. In der Bezeichner-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • MULTI_MATCH: Identifizierung mit einem Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichner-Regeltabelle beim Abgleich mit den angegebenen Attributen gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • SKIPPED: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet.

    Datentyp: Zeichenfolge
    <String>.items.identificationAttempts.attributes Liste der CI-Bezeichner-Eintragsattribute, die während des Identifizierungsprozesses verwendet wurden.

    Datentyp: Array

    Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.:

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    <String>.items.identificationAttempts.identifierName Bezeichnerregel, die für diesen CI-Identifizierungsversuch verwendet wird.

    Datentyp: Zeichenfolge
    <String>.items.identificationAttempts.searchOnTable Name der während des Identifizierungsprozesses durchsuchten Tabelle.

    Datentyp: Zeichenfolge
    <String>.items.identifierEntrySysId Sys_id für die Bezeichnerregel, die zum Identifizieren des CI verwendet wird. Befindet sich in der Tabelle „Bezeichnereintrag“ [cmdb_identifier_entry].

    Datentyp: Zeichenfolge
    <String>.items.info Liste der Objekte, die zusätzliche Informationen zur Verarbeitung des Elements enthalten.

    Datentyp: Array

    "info": [
 {
   "code": "String",
   "message": "String",
   "ruleSysId": "String"
 }
]
    <String>.items.info.code Reklassifizierungstyp, der übersprungen wurde.
    Mögliche Werte:
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_UPGRADE

    Datentyp: Zeichenfolge
    <String>.items.info.message Nachricht, die zusätzliche Einblicke in den Grund für das Überspringen der Neuklassifizierung bietet.

    Datentyp: Zeichenfolge
    <String>.items.info.ruleSysId Sys_id der abgeglichenen Reklassifizierungs-Einschränkungsregel. Gilt nur, wenn IRE die Neuklassifizierung aufgrund der Regel zur Einschränkung der Neuklassifizierung überspringt. Dieser Wert ist leer, wenn die Neuklassifizierung aufgrund einer Nutzlast oder einer globalen Kennzeichnung übersprungen wird.

    Datentyp: Zeichenfolge
    <String>.items.inputIndizes Indizes des entsprechenden Eingabe-CI Bei Elementen der obersten Ebene handelt es sich um eine Liste mit Ganzzahlen. Für zugehörige CIs oder Such-CIs ist dies eine Liste von JSON-Objekten.

    Datentyp: Array von Zahlen
    <String>.items.maskedAttributes Liste der Attribute, deren Aktualisierung durch eine nicht autorisierende Datenquelle übersprungen wurde, wie in den Abgleichsregelndefiniert.

    Datentyp: Array
    <String>.items.operation Vorgang, der stattgefunden hat.

    Mögliche Werte:

    • EINFÜGEN: Neues CI wurde in die Datenbank eingefügt.
    • INSERT_AS_INCOMPLETE: Element wurde in der Tabelle „cmdb_ire_incomplete_payloads“ gespeichert.
    • INSERT_AS_partial: Element wurde in Tabelle „cmdb_ire_partial_payloads“ gespeichert.
    • UPDATE: Vorhandenes CI wurde aktualisiert.
    • UPDATE_WITH_DOWNGRADE: CI wurde aktualisiert, und die Klasse wurde in eine generischere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: CI wurde aktualisiert, und die Klasse wurde in eine Klasse geändert, die weder Vorgänger noch untergeordnet ist.
    • UPDATE_WITH_UPDRADE: CI wurde aktualisiert, und die Klasse wurde in eine spezialisiertere Klasse (untergeordnete Klasse) geändert.

    Datentyp: Zeichenfolge
    <String>.items.relatedItems Liste der JSON-Objekte, die Informationen zu den verarbeiteten zugehörigen Elementen bereitstellen.

    Datentyp: Array

    "relatedItems": [
  { 
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "mergePayloadIds": [Array],
    "operation": "String",
    "sysId": "String",
    "warningCount": Number,
    "warnings": [Array]
  }
]
    <String>.items.relatedItems.className Klassen-/Tabellenname (sys_class_name) des zugehörigen Elements.

    Datentyp: Zeichenfolge
    <String>.items.relatedItems.errorCount Anzahl der bei der Verarbeitung der zugehörigen Elemente erkannten Fehler.

    Datentyp: Zahl
    <String>.items.relatedItems.errors Liste der Fehler, die während der Verarbeitung des zugehörigen Elements aufgetreten sind.

    Datentyp: Array

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.items.relatedItems.errors.error Typ des Fehlers, der beim Verarbeiten des zugehörigen Elements aufgetreten ist.

    Datentyp: Zeichenfolge
    <String>.items.relatedItems.errors.message Die Fehlermeldung, die beim Verarbeiten des zugehörigen Elements aufgetreten ist.

    Datentyp: Zeichenfolge
    <String>.items.relatedItems.inputIndices Index des entsprechenden Eingabeelements. Bei Elementen der obersten Ebene handelt es sich um eine Liste mit Ganzzahlen. Für zugehörige oder Suchelemente ist dies eine Liste von JSON-Objekten.

    Datentyp: Array von Zahlen oder Array von Objekten

    "inputIndices": [
  { 
   "mainIndex": Number, 
   "subIndex": Number 
  }
]
    <String>.items.relatedItems.inputIndices.mainIndex Indexwert aus dem Anforderungstext-Array items, der dem übergeordneten CI des zugehörigen Elements entspricht.

    Datentyp: Zahl
    <String>.items.relatedItems.inputIndices.subIndex Indexwert aus dem Anforderungstext-Array items.lookup, der dem zugehörigen Element entspricht.

    Datentyp: Zahl
    <String>.items.relatedItems.mergedPayloadIds Liste der sys_ids der Teilnutzlasten, die während der Verarbeitung mit dem CI zusammengeführt wurden.

    Datentyp: Array
    <String>.items.relatedItems.operation Vorgang, der stattgefunden hat.

    Mögliche Werte:

    • EINFÜGEN: Neues zugehöriges CI wurde in die Datenbank eingefügt.
    • INSERT_AS_INCOMPLETE: Element wurde in der Tabelle „cmdb_ire_incomplete_payloads“ gespeichert.
    • INSERT_AS_partial: Element wurde in Tabelle „cmdb_ire_partial_payloads“ gespeichert.
    • NO_CHANGE: Es wurden keine zugehörigen CI-Änderungen vorgenommen.
    • UPDATE: Vorhandenes zugehöriges CI wurde aktualisiert.
    • UPDATE_WITH_DOWNGRADE: Zugehöriges CI wurde aktualisiert, und die Klasse wurde in eine generischere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: Zugehöriges CI wurde aktualisiert, und die Klasse wurde in eine Klasse geändert, die weder Vorgänger noch untergeordnet ist.
    • UPDATE_WITH_UPDRADE: Zugehöriges CI wurde aktualisiert, und die Klasse wurde in eine spezialisiertere Klasse (untergeordnete Klasse) geändert.

    Datentyp: Zeichenfolge
    <String>.items.relatedItems.sysId Die sys_id des zugehörigen Elements.

    Datentyp: Zeichenfolge
    <String>.items.relatedItems.warningCount Anzahl der Warnungen, die beim Verarbeiten der zugehörigen Elemente aufgetreten sind.

    Datentyp: Zahl
    <String>.items.relatedItems.warnings Array von Objekten, das eine Warnung beschreibt, die bei der Verarbeitung der zugehörigen Elemente aufgetreten ist.

    Datentyp: Array

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.items.relatedSysIds Liste der sys_id-Werte der CIs, die bei der Lookup-basierten Identifizierung zugehöriger Elemente verwendet werden.

    Datentyp: Zeichenfolge
    <String>.items.sys_id Sys_id des CI, das aktualisiert oder erstellt wurde

    Datentyp: Zeichenfolge
    <String>.Beziehungen Liste der JSON-Objekte, die Informationen zu den verarbeiteten Beziehungen bereitstellen.

    Datentyp: Array

    "relations": [ 
  { 
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "operation": "String",
    "sysId": "String" 
  }
]
    <String>.relations.Klassenname Sys_class_name dieses abhängigen Beziehungs-CI.

    Einziger unterstützter Wert: cmdb_rel_ci: CI-Beziehungstabelle.

    Datentyp: Zeichenfolge
    <String>.relations.errorAnzahl Anzahl der Fehler, die beim Verarbeiten des abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Zahl
    <String>.Beziehungen.Fehler Array von Objekten, die Fehler beschreiben, die beim Verarbeiten dieses abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Array

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.relations.inputIndices Indizes für die abhängigen Beziehungs-CI-Objekte im Anforderungstext-Array relations, die diesem abhängigen Beziehungs-CI entsprechen.

    Datentyp: Array
    <String>.relations.operation Typ des durchgeführten Vorgangs.

    Mögliche Werte:

    • EINFÜGEN: Das abhängige Beziehungs-CI wurde als neuer Datensatz in die Zieltabelle eingefügt.
    • INSERT_AS_INCOMPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „CMDB-IRE – unvollständige Nutzlasten“ [cmdb_ire_incomplete_payloads] eingefügt.
    • INSERT_AS_partial: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads] eingefügt.
    • NO_CHANGE: Es wurde kein Vorgang ausgeführt.
    • UPDATE: Ein vorhandenes abhängiges Beziehungs-CI in der Zieltabelle wurde aktualisiert.

    Datentyp: Zeichenfolge
    <String>.relations.sysId Sys_id des abhängigen Beziehungs-CI.

    Datentyp: Zeichenfolge
    <String>.Zusammenfassung Liste der JSON-Eigenschaften, die Statistiken darüber bereitstellen, wie viele Elemente pro Klasse eingefügt, aktualisiert usw. wurden.

    Datentyp: Array
    <String>.Zusammenfassung.<class_name> Statistiken für eine bestimmte Klasse.

    Datentyp: Objekt

    <class_name>: {
 "additionalInsertedItemCount": Number, 
 "errorCount": Number,
 "incompleteItemCount": Number,
 "insertedItemCount": Number,
 "partialItemCount": Number,
 "skippedItemCount": Number,
 "unchangedItemCount": Number,
 "updatedItemCount": Number,
 "warningCount": Number 
}
    <String>.Zusammenfassung.<class_name> .zusätzlicheEingefügteElementAnzahl Anzahl der aufgrund der Verarbeitung von Teilnutzlasten eingefügten Elemente.

    Datentyp: Zahl
    <String>.Zusammenfassung.<class_name> .errorAnzahl Anzahl der beim Verarbeiten von Elementen aufgetretenen Fehler.

    Datentyp: Zahl
    <String>.Zusammenfassung.<class_name> .incompleteItemCount Anzahl der Elemente, die in die Tabelle „CMDB IRE Unvollständige Nutzlasten“ [cmdb_ire_incomplete_payloads] eingefügt wurden.

    Datentyp: Zahl
    <String>.Zusammenfassung.<class_name> .insertedItemCount Anzahl der erstellten Elemente.

    Datentyp: Zahl
    <String>.Zusammenfassung.<class_name> .partialItemCount Anzahl der in der Tabelle „Teilnutzlast“ [cmdb_ire_partial_payloads] gespeicherten Elemente.

    Datentyp: Zahl
    <String>.Zusammenfassung.<class_name> .übersprungenElementAnzahl Anzahl der übersprungenen Elemente.

    Datentyp: Zahl
    <String>.Zusammenfassung.<class_name> .unchangedItemCount Anzahl der Elemente, die Einträge hatten, aber nicht geändert wurden.

    Datentyp: Zahl
    <String>.Zusammenfassung.<class_name> .updatedItemCount Anzahl der aktualisierten Elemente.

    Datentyp: Zahl
    <String>.Zusammenfassung.<class_name> .WarnungAnzahl Anzahl der Elemente, die bei der Verarbeitung eine Warnung generiert haben.

    Datentyp: Zahl

    		 
    var payload = {
"items": [
{
"className": "cmdb_ci_win_server",
"values": {
   "chassis_type": "Desktop",
   "os": "Windows 2012 R2 Datacenter",
   "name": "Windows2012Server1",
   "serial_number": "0000-0011-1690-8730-8636-5722-52",
   "cpu_count": "1"
  },
  "lookup": [
  {
     "values": {
       "valid": "true",
       "serial_number": "0000-0011-1690-8730-8636-5722-52",
       "serial_number_type": "bios"
      },
     "className": "cmdb_serial_number"
   },
   {
     "values": {
       "valid": "true",
       "serial_number": "3311-9736-4988-9744-1749-4183-41",
       "serial_number_type": "chassis"
      },
     "className": "cmdb_serial_number"
   }],
 
    "internal_id": "16777219",
    "sys_object_source_info": {
      "source_feed": "SN Discovery Feed 1",
      "source_name": "ServiceNow",
      "source_native_key": "16777219",
      "source_recency_timestamp": "2019-10-18 08:31:23"
   }},
   {
   "className": "cmdb_ci_spkg",
   "values": {
     "name": "Windows 2012 R2 Datacenter",
     "key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL"
     },
 
  "related": [
    {
     "internal_id": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219",
      "values": {
        "name": "Windows 2012 R2 Datacenter-SAMLABVM52"
      },
      "className": "cmdb_software_instance",
      "sys_object_source_info": {
        "source_feed": "SN Discovery Feed 1",
        "source_name": "ServiceNow",
        "source_native_key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219"
  }},
  {
    "internal_id": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777229",
      "values": {
        "name": "Windows 2012 R2 Datacenter-SAMLABVM52"
      },
    "className": "cmdb_software_instance",
    "sys_object_source_info": {
      "source_feed": "SN Discovery Feed 1",
      "source_name": "ServiceNow",
      "source_native_key": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777229"
  }}
],
  "settings" : {
        "skipReclassificationRestrictionRules" : "false",
        "updateWithoutDowngrade" : "true",
        "updateWithoutUpgrade" : "true",
        "updateWithoutSwitch" : "true"
      }},
  {
  "className": "cmdb_ci_app_server_tomcat",
  "values": {
    "running_process_key_parameters": "/opt/OV/nonOV/tomcat/b/temp org.apache.catalina.startup.Bootstrap start",
    "install_directory": "/opt/OV/nonOV/tomcat/b",
    "name": "Tomcat@hpom9:3443",
    "server_port": "8006",
    "sys_class_name": "cmdb_ci_app_server_tomcat"
  },
 
  "internal_id": "tomcat_id"
  }],
 
"relations": [
  {
    "parent_id": "tomcat_id",
    "child_id": "16777219",
    "type": "Runs on::Runs"
  }],
 
"referenceItems": [
  {
    "referenceField": "installed_on",
    "referenced": "16777219",
    "referencedBy": "Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777219"
  }]};
 
var input = JSON.stringify(payload);
var output = sn_cmdb.IdentificationEngine.identifyCIEnhanced('ServiceNow', input, {});

gs.info(JSON.stringify(JSON.parse(output), null, 2));

    Ausgabe:

    {
  "items": [
    {
      "className": "cmdb_ci_win_server",
      "operation": "INSERT",
      "relatedSysIds": [
        null,
        null
      ],
      "relatedItems": [
        {
          "errors": [],
          "operation": "INSERT",
          "className": "cmdb_serial_number",
          "errorCount": 0,
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 0,
              "subIndex": 0
            }
          ],
          "mergedPayloadIds": [],
          "warningCount": 0
        },
        {
          "errors": [],
          "operation": "INSERT",
          "className": "cmdb_serial_number",
          "errorCount": 0,
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 0,
              "subIndex": 1
            }
          ],
          "mergedPayloadIds": [],
          "warningCount": 0
        }
      ],
      "identificationAttempts": [
        {
          "attributes": [],
          "info": "sys_object_source NO_MATCH",
          "identifierName": "",
          "attemptResult": "NO_MATCH",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "serial_number",
            "serial_number_type"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "searchOnTable": "cmdb_serial_number",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "serial_number"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "name"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "NO_MATCH",
          "searchOnTable": "cmdb_ci_hardware",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "mac_address",
            "name"
          ],
          "identifierName": "Hardware Rule",
          "attemptResult": "SKIPPED",
          "searchOnTable": "cmdb_ci_network_adapter",
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ],
      "mergedPayloadIds": [],
      "warningCount": 0
    },
    {
      "className": "cmdb_ci_spkg",
      "operation": "INSERT",
      "relatedSysIds": [
        null
      ],
      "relatedItems": [
        {
          "errors": [],
          "operation": "INSERT",
          "className": "cmdb_software_instance",
          "errorCount": 0,
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 1,
              "subIndex": 0
            }
          ],
          "mergedPayloadIds": [],
          "warningCount": 0
        },
        {
          "errors": [],
          "warnings": [
            {
              "error": "MISSING_MATCHING_ATTRIBUTES",
              "message": "In payload missing minimum set of input values for criterion (matching) attributes from identify rule for table [cmdb_software_instance]. Add these input values in payload item '{\"className\":\"cmdb_software_instance\",\"values\":{},\"internal_id\":\"f7273cccec30101056cd4bb46eb4db5d\",\"sys_object_source_info\":{\"source_feed\":\"SN Discovery Feed 1\",\"source_name\":\"ServiceNow\",\"source_native_key\":\"Microsoft Windows Server 2012 R2 Datacenter_:::_NULL|16777229\"},\"settings\":{},\"sys_ire_info\":{\"ire_received_time\":\"2020-05-10 17:57:48\"}}'"
            }
          ],
          "operation": "INSERT_AS_PARTIAL",
          "className": "cmdb_software_instance",
          "errorCount": 0,
          "sysId": "Unknown",
          "markers": [],
          "inputIndices": [
            {
              "mainIndex": 1,
              "subIndex": 1
            }
          ],
          "mergedPayloadIds": [],
          "warningCount": 1
        }
      ],
      "identificationAttempts": [
        {
          "attributes": [],
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "hybridEntryCiAttributes": []
        },
        {
          "attributes": [
            "key"
          ],
          "identifierName": "Software",
          "attemptResult": "NO_MATCH",
          "searchOnTable": "cmdb_ci_spkg",
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "markers": [],
      "inputIndices": [
        1
      ],
      "mergedPayloadIds": [],
      "warningCount": 0
    },
    {
      "className": "cmdb_ci_app_server_tomcat",
      "operation": "INSERT",
      "identificationAttempts": [
        {
          "attributes": [],
          "info": "sys_object_source SKIPPED",
          "identifierName": "",
          "attemptResult": "SKIPPED",
          "hybridEntryCiAttributes": []
        }
      ],
      "errorCount": 0,
      "markers": [],
      "inputIndices": [
        2
      ],
      "mergedPayloadIds": [],
      "warningCount": 0
    }
  ],
  "additionalCommittedItems": [],
  "relations": [
    {
      "className": "cmdb_rel_ci",
      "operation": "INSERT",
      "errorCount": 0,
      "markers": [],
      "inputIndices": [
        0
      ],
      "mergedPayloadIds": [],
      "warningCount": 0
    }
  ],
  "additionalCommittedRelations": []
} 

    IdentificationEngine – runIdentificationAudit(GlideRecord now_GR)

    Führt ein Identifizierungsaudit für das angegebene Konfigurationselement (CI) aus, um Duplikate zu erkennen.

    Wenn Duplikate gefunden werden, werden Duplizierungsaufgaben erstellt. Verwenden Sie diese Methode nur für CI-Typen mit unabhängigen Identifikationsregeln.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    now_GR GlideRecord CI, für das das Audit zur Erkennung von Duplikaten ausgeführt werden soll. Das CI muss über unabhängige Identifizierungsregeln verfügen.
    Tabelle : 10. Ergebnisse
    Typ Beschreibung
    void

    Das folgende Beispiel zeigt, wie ein Datensatz in der Tabelle „Linux-Server“ [cmdb_ci_linux_server] auf Duplikate überprüft wird.

    var sysId = '<cbdb_ci_sys_id>';
var gr = new GlideRecord('cmdb_ci_linux_server');
gr.get(sysId);
sn_cmdb.IdentificationEngine.runIdentificationAudit(gr);