Identifizierungs -Engine: Bereichsbezogen

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 64 Minuten Lesedauer

    • Die IdentificationEngine- API verwendet das Identification and Reconciliation Framework (Identifizierung und Abgleich), um die Erstellung von doppelten Configuration Items (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-Bezeichner sn_cmdb.

    IdentificationEngine – createOrUpdateCI(String source, String input)

    Fügt Configuration Items (CI) und Nicht-Configuration Management Database (CMDB) - CIs (Klassen, die sich nicht von cmdb_ci erstrecken) in CMDB basierend auf Identifizierungs- und Abgleichsregeln ein oder aktualisiert sie. Verwenden Sie diese API, anstatt CMDB direkt zu aktualisieren.

    Weitere Informationen zur Erfassung von Nicht-CMDB-Tabellen 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 zum Hinzufügen oder Aktualisieren. 
    "input" { 
 "items": [Array],
 "referenceItems": [Array],
 "relations": [Array]
}
    input.items Array von Objekten Elemente zum Hinzufügen oder Aktualisieren.
    "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 zu erstellenden oder zu aktualisierenden Configuration Items (CI).

    Dieser Wert kann eine beliebige Klasse/Tabelle CMDB 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 anstatt in diesem Parameter.

    Referenzfeldnamen hängen von den vom Anwender 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 von Objekten 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 zurück auf cmdb_ci enthält.

    Zum 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 zu erstellenden oder zu aktualisierenden Configuration Items (CI).

    Dieser Wert kann eine beliebige Klasse/Tabelle CMDB 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, verwenden Sie dieses Feld, um den Namen des Feeds anzugeben, der dieses Element sendet.

    Die Datenquelle generiert diesen Feed-Namen. Es kann sich um eine beliebige Zeichenfolge handeln, 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 sich um eine beliebige Zeichenfolge handeln, 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 anstelle des values -Objekts.

    Feldnamen und -typen hängen von den vom Anwender 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 Element der obersten Ebene, das die zugehörige Liste enthält. Regeln im zugehörigen Eintrag [cmdb_related_entry] definieren, welche Arten von Datensätzen dieses Array enthalten darf. 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, muss es aber 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 zu erstellenden oder zu aktualisierenden Configuration Items (CI).

    Dieser Wert kann eine beliebige Klasse/Tabelle CMDB 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, verwenden Sie dieses Feld, um den Namen des Feeds anzugeben, der dieses Element sendet.

    Die Datenquelle generiert diesen Feed-Namen. Es kann sich um eine beliebige Zeichenfolge handeln, 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 sich um eine beliebige Zeichenfolge handeln, 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
    Eingabe.Elemente.zugehörige.Werte 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 anstelle des values -Objekts.

    Feldnamen und -typen hängen von den vom Anwender 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 definieren, welche Arten von Updates zulässig sind.
    "settings": { 
  "skipReclassificationRestrictionRules": Boolean, 
  "updateWithoutDowngrade": Boolean, 
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    input.items.settings.reclassificationRestrictionRules überspringen Boolean Kennzeichnung, die angibt, ob IRE die Regel zur Einschränkung der Neuklassifizierung, die der Klasse für das Nutzlastelement entspricht, nicht ausführen soll.
    Gültige Werte:
    • true: Ausführung der Regel überspringen.
    • „falsch“: Führen Sie die Regel aus.

    Standardwert: false
    input.items.settings.updateWithoutDowngrade Boolean Kennzeichnung, die angibt, ob Update und Downgrade für dieses Element zulässig sind.
    Gültige Werte:
    • „wahr“: Element wird aktualisiert, Downgrade ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Downgrades sind zulässig.

    Standardwert: false
    input.items.settings.updateWithoutUpgrade Boolean Kennzeichnung, die angibt, ob Update und Upgrade für diesen Artikel zulässig sind.
    Gültige Werte:
    • „wahr“: Element wird aktualisiert, aber Upgrade ist nicht zulässig.
    • „falsch“: Sowohl Element-Updates 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:
    • „wahr“: Element wird aktualisiert, aber Klassenwechsel ist 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, verwenden Sie dieses Feld, um den Namen des Feeds anzugeben, der dieses Element sendet.

    Die Datenquelle generiert diesen Feed-Namen. Es kann sich um eine beliebige Zeichenfolge handeln, 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 sich um eine beliebige Zeichenfolge handeln, 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 anstelle des values -Objekts.

    Feldnamen und -typen hängen von den vom Anwender 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 von Objekten Liste, die Referenzen zwischen Elementen in der Eingabenutzlast definiert. 
    "referenceItems": [
  { 
    "referenced": "String", 
    "referencedBy": "String", 
    "referenceField": "String" 
  }
]
    input.referenceItems.referenced Zeichenfolge internal_id, das für das Element definiert ist, auf das von einem anderen Element verwiesen wird.
    input.referenceItems.referencedBy Zeichenfolge internal_id, das für das Element definiert ist und auf ein anderes Element verweist.
    input.referenceItems.referenceField Zeichenfolge Name des Referenzfelds in der Klasse/Tabelle für das Element referencedBy.
    Eingabebeziehungen Array von Objekten Liste, die Beziehungen zwischen Elementen in der Eingabenutzlast angibt.
    Ein Objekt in diesem Array kann zwei Formate verwenden.
    • Das Objekt kann eine Beziehung zwischen zwei Elementen der obersten Ebene (nur) mithilfe von Name-Wert-Paaren parent und child definieren, wobei Werte Elementindizes aus dem Nutzlast-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 Elementen der obersten Ebene, zugehörigen Elementen oder Suchelementen, indem Schlüssel-Wert-Paare parent_id und child_id verwendet werden, wobei -Werte die für diese Elemente definierten internal_id -Werte darstellen.
      "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    input.beziehungen.untergeordnetes Element Nummer Ganzzahlindex des CI-Objekts im Array items, das das untergeordnete Element in der Beziehung darstellt („items“, „items.related“ oder „items.lookup“).
    input.beziehungen.child_id Zeichenfolge internal_id des untergeordneten Elements in der Beziehung („items“, „items.related“ oder „items.lookup“)
    Eingabe.Beziehungen.übergeordnet Nummer Ganzzahlindex des übergeordneten Elements im Array items („items“, „items.related“ oder „items.lookup“)
    input.beziehungen.parent_id Zeichenfolge internal_id des übergeordneten Elements in der Beziehung („items“, „items.related“ oder „items.lookup“)
    input.beziehungen.sys_rel_source_info Objekt Informationen zur Discovery-Quelle für die Beziehung. Bei Nicht-Abhängigkeits-Beziehungen werden diese Informationen in der Tabelle „Beziehungsquellen“ [sys_rel_source] gespeichert (werden für die Methoden identifizierenCIEnhanced() und identifizierenCI() nicht beibehalten).

    Datentyp: Objekt

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

    Standard: Discovery-Quelle, die im API-Methodenparameter übergeben wird.
    input.beziehungen.sys_rel_source_info.source_feed Zeichenfolge Beliebige Zeichenfolge, die eine Unter-Discovery/ein Unterscan innerhalb der Discovery-Quelle ist.

    Standard: „UNBEKANNT“ wird in der Spalte „source_feed“ gespeichert, wenn ein Datensatz in der Tabelle „sys_rel_source“ erstellt wird.
    Eingabe.Beziehungen.Typ 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. Rückgaben
    Typ Beschreibung
    <String> JSON-formatierte Zeichenfolge, die eine Liste von Ergebnissen 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 Beschreibung der erstellten oder aktualisierten CIs.

    Datentyp: Objekt

    "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.zusätzlicheZugehörigeElemente Liste von Informationen über zusätzliche Suche und zugehörige Elemente, die verarbeitet, aber nicht als Teil der Eingabenutzlast bereitgestellt wurden. Diese Elemente stammen aus Teilnutzlasten.

    Diese Informationen werden derzeit nicht zurückgegeben.

    Datentyp: Array von Objekten

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

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

    Datentyp: Array von Zahlen oder Array von Objekten

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

    Datentyp: Zahl
    <String>.items.zusätzlicheZugehörigeElemente.eingabeindizes.subindex Indexwert aus dem Array des Anforderungstexts items.lookup, der dem zusätzlichen zugehörigen Element entspricht.

    Datentyp: Zahl
    <String>.items.zusätzlicheZugehörigeElemente.vorgang 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 erstellten oder aktualisierten CI.

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

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

    Datentyp: Zahl
    <String>.items.errors Liste der bei der Verarbeitung des CI aufgetretenen Fehler.

    Datentyp: Array von Objekten

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.items.errors.error Typ des Fehlers, der bei der Verarbeitung 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 CIs zu identifizieren.

    Datentyp: Array von Objekten

    "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:

    • ABGEGLICHEN: Identifizierung erfolgreich. In der Identifier-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • Multi_MATCH: Die Identifizierung ist mit einem Fehler fehlgeschlagen. In der Identifier-Regeltabelle wurden beim Abgleich mit den angegebenen Attributen doppelte CIs gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • ÜBERSPRUNGEN: 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.identificationVersuche.attribute 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.identificationVersuche.bezeichnername Identifier-Regel, die für diesen CI-Identifizierungsversuch verwendet wird.

    Datentyp: Zeichenfolge
    <String>.items.identificationAttempts.searchOnTable Name der Tabelle, die während des Identifizierungsprozesses durchsucht wurde.

    Datentyp: Zeichenfolge
    <String>.items.identifierEntrySysId Sys_id für die Identifier-Regel, die zum Identifizieren des CI verwendet wird.

    Datentyp: Zeichenfolge

    Tabelle: Bezeichnereintrag [cmdb_identifier_entry]
    <String>.items.info Liste, die zusätzliche Informationen zur Verarbeitung des Artikels enthält.

    Datentyp: Array von Objekten

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

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

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

    Datentyp: Zeichenfolge
    <String>.items.inputIndices Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem CI entsprechen.

    Datentyp: Array
    <String>.items.maskedAttributes Liste der Attribute, deren Aktualisierung durch eine nicht autorisierte Datenquelle gemäß den Abgleichsregelnübersprungen wurde.

    Datentyp: Array
    <String>.items.relatedItems Liste, die Informationen zu den verarbeiteten zugehörigen Elementen enthält.

    Datentyp: Array von Objekten

    "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 von Objekten

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

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

    Datentyp: Array oder Zahlen

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

    Datentyp: Zahl
    <String>.items.relatedItems.inputIndices.subindex Ganzzahlwert aus dem Array des Anforderungstexts 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 Array des Anforderungstexts items.lookup.

    Bemerkbare 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 Informationen zu den verarbeiteten Beziehungen.

    Datentyp: Array von Objekten

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

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

    Datentyp: Zeichenfolge
    <String>.Beziehungen.Fehleranzahl Anzahl der Fehler.

    Datentyp: Zahl
    <String>.Beziehungen.Eingabeindizes Verzeichnisse der entsprechenden Eingabebeziehungen.

    Datentyp: Array
    <String>.Beziehungen.Vorgang Typ des durchgeführten Vorgangs.

    Mögliche Werte:

    • EINFÜGEN
    • AKTUALISIEREN
    • NO_CHANGE

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

    Datentyp: Zeichenfolge

    Im Folgenden wird gezeigt, wie Sie ein Configuration Item neu klassifizieren.

    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 Sie ein Configuration Item aktualisieren.

    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 suchbasierter 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(Zeichenfolgenquelle, Zeichenfolgeneingabe, Objektoptionen)

    Fügt Configuration Items (CI) und Nicht-Configuration Management Database (CMDB) - CIs (Klassen, die sich nicht von cmdb_ci erstrecken) in CMDB basierend auf Identifizierungs- und Abgleichsregeln ein oder aktualisiert sie. Verwenden Sie diese API, anstatt CMDB direkt zu aktualisieren.

    Diese Methode stellt nicht nur die Funktionalität der Methode createOrUpdateCI() bereit, sondern unterstützt auch:
    • Es werden Teilnutzlasten verarbeitet
    • Teilweise Commits verarbeiten
    • Doppelte Elemente werden in einer Nutzlast entfernt
    • Ausgabezusammenfassungen werden generiert
    Weitere Informationen zu IRE und ausführlichere Erklärungen der von dieser Methode verwendeten Daten finden Sie unter Identifizierung und Abgleich (IRE).

    Weitere Informationen zur Erfassung von Nicht-CMDB-Tabellen 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 zum Hinzufügen oder Aktualisieren. 
    "input" { 
 "items": [Array],
 "referenceItems": [Array],
 "relations": [Array]
}
    input.items Array von Objekten Elemente zum Hinzufügen oder Aktualisieren.
    "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 zu erstellenden oder zu aktualisierenden Configuration Items (CI).

    Dieser Wert kann eine beliebige Klasse/Tabelle CMDB 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 anstatt in diesem Parameter.

    Referenzfeldnamen hängen von den vom Anwender 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 von Objekten 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 zurück auf cmdb_ci enthält.

    Zum 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 zu erstellenden oder zu aktualisierenden Configuration Items (CI).

    Dieser Wert kann eine beliebige Klasse/Tabelle CMDB sein, z. B. cmdb_serial_number oder cmdb_ci_network_adapter.
    input.items.lookup.internal_id Zeichenfolge Eindeutiger Suchelementbezeichner 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 aufweisen.
    "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, verwenden Sie dieses Feld, um den Namen des Feeds anzugeben, der dieses Element sendet.

    Die Datenquelle generiert diesen Feed-Namen. Es kann sich um eine beliebige Zeichenfolge handeln, 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 sich um eine beliebige Zeichenfolge handeln, 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 Anwender 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 von Objekten Verweis auf das Element der obersten Ebene, das die zugehörige Liste enthält. Regeln im zugehörigen Eintrag [cmdb_related_entry] definieren, welche Arten von Datensätzen dieses Array enthalten darf. 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, muss es aber 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 zu erstellenden oder zu aktualisierenden Configuration Items (CI).

    Dieser Wert kann eine beliebige Klasse/Tabelle CMDB sein, z. B. cmdb_software_instance oder cmdb_key_value.
    input.items.related.internal_id Zeichenfolge Eindeutiger Bezeichner für das zugehörige Element in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber 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 aufweisen.
    "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, verwenden Sie dieses Feld, um den Namen des Feeds anzugeben, der dieses Element sendet.

    Die Datenquelle generiert diesen Feed-Namen. Es kann sich um eine beliebige Zeichenfolge handeln, 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 sich um eine beliebige Zeichenfolge handeln, 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
    Eingabe.Elemente.zugehörige.Werte 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 anstelle des values -Objekts.

    Feldnamen und -typen hängen von den vom Anwender 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 definieren, welche Arten von Updates zulässig sind.
    "settings": { 
  "skipReclassificationRestrictionRules": Boolean, 
  "updateWithoutDowngrade": Boolean, 
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    input.items.settings.reclassificationRestrictionRules überspringen Boolean Kennzeichnung, die angibt, ob IRE die Regel zur Einschränkung der Neuklassifizierung, die der Klasse für das Nutzlastelement entspricht, nicht ausführen soll.
    Gültige Werte:
    • true: Ausführung der Regel überspringen.
    • „falsch“: Führen Sie die Regel aus.

    Standardwert: false
    input.items.settings.updateWithoutDowngrade Boolean Kennzeichnung, die angibt, ob Update und Downgrade für dieses Element zulässig sind.
    Gültige Werte:
    • „wahr“: Element wird aktualisiert, Downgrade ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Downgrades 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:
    • „wahr“: Element wird aktualisiert, aber Klassenwechsel ist nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Klassenwechsel sind zulässig.

    Standardwert: false
    input.items.settings.updateWithoutUpgrade Boolean Kennzeichnung, die angibt, ob Update und Upgrade für diesen Artikel zulässig sind.
    Gültige Werte:
    • „wahr“: Element wird aktualisiert, aber Upgrade ist nicht zulässig.
    • „falsch“: Sowohl Element-Updates 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, verwenden Sie dieses Feld, um den Namen des Feeds anzugeben, der dieses Element sendet.

    Die Datenquelle generiert diesen Feed-Namen. Es kann sich um eine beliebige Zeichenfolge handeln, 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 sich um eine beliebige Zeichenfolge handeln, 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 anstelle des values -Objekts.

    Feldnamen und -typen hängen von den vom Anwender 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 von Objekten Liste, die Referenzen zwischen Elementen in der Eingabenutzlast definiert. 
    "referenceItems": [
  { 
    "referenced": "String", 
    "referencedBy": "String", 
    "referenceField": "String" 
  }
]
    input.referenceItems.referenced Zeichenfolge internal_id, das für das Element definiert ist, auf das von einem anderen Element verwiesen wird.
    input.referenceItems.referencedBy Zeichenfolge internal_id, das für das Element definiert ist und auf ein anderes Element verweist.
    input.referenceItems.referenceField Zeichenfolge Name des Referenzfelds in der Klasse/Tabelle für das Element referencedBy.
    Eingabebeziehungen Array von Objekten Liste, die Beziehungen zwischen Elementen in der Eingabenutzlast angibt.
    Ein Objekt in diesem Array kann zwei Formate verwenden.
    • Das Objekt kann eine Beziehung zwischen zwei Elementen der obersten Ebene (nur) mithilfe von Name-Wert-Paaren parent und child definieren, wobei Werte Elementindizes aus dem Nutzlast-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 Elementen der obersten Ebene, zugehörigen Elementen oder Suchelementen, indem Schlüssel-Wert-Paare parent_id und child_id verwendet werden, wobei -Werte die für diese Elemente definierten internal_id -Werte darstellen.
      "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    input.beziehungen.untergeordnetes Element Nummer Ganzzahlindex des CI-Objekts im Array items, das das untergeordnete Element in der Beziehung darstellt („items“, „items.related“ oder „items.lookup“).
    input.beziehungen.child_id Zeichenfolge internal_id des untergeordneten Elements in der Beziehung („items“, „items.related“ oder „items.lookup“)
    Eingabe.Beziehungen.übergeordnet Nummer Ganzzahlindex des übergeordneten Elements im Array items („items“, „items.related“ oder „items.lookup“)
    input.beziehungen.parent_id Zeichenfolge internal_id des übergeordneten Elements in der Beziehung („items“, „items.related“ oder „items.lookup“)
    input.beziehungen.sys_rel_source_info Objekt Informationen zur Discovery-Quelle für die Beziehung. Bei Nicht-Abhängigkeits-Beziehungen werden diese Informationen in der Tabelle „Beziehungsquellen“ [sys_rel_source] gespeichert (werden für die Methoden identifizierenCIEnhanced() und identifizierenCI() nicht beibehalten).

    Datentyp: Objekt

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

    Standard: Discovery-Quelle, die im API-Methodenparameter übergeben wird.
    input.beziehungen.sys_rel_source_info.source_feed Zeichenfolge Beliebige Zeichenfolge, die eine Unter-Discovery/ein Unterscan innerhalb der Discovery-Quelle ist.

    Standard: „UNBEKANNT“ wird in der Spalte „source_feed“ gespeichert, wenn ein Datensatz in der Tabelle „sys_rel_source“ erstellt wird.
    Eingabe.Beziehungen.Typ 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 wichtig 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
}
    optionen.deduplizieren_nutzlasten Boolean Kennzeichnung, die angibt, ob doppelte Elemente zusammengeführt oder als Fehler betrachtet werden.

    Gültige Werte:

    • „wahr“: Doppelte Elemente zusammenführen.
    • „falsch“: Doppelte Elemente werden als Fehler betrachtet.

    Standardwert: wahr
    Optionen.Generieren_Zusammenfassung Boolean Kennzeichnung, die angibt, ob die zurückgegebenen Ergebnisse Zusammenfassungsinformationen enthalten. Einzelheiten zu den zurückgegebenen Zusammenfassungsinformationen finden Sie unter <String>.summary in der Tabelle der Rückgabeergebnisse.

    Gültige Werte:

    • „wahr“: Zusammenfassungsinformationen einschließen.
    • „falsch“: Keine Zusammenfassungsinformationen einschließen.

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

    Gültige Werte:

    • „wahr“: Teilweiser Commit aktiviert.
    • „falsch“: Teilweiser Commit deaktiviert.

    Standardwert: wahr
    Optionen.partielle_Nutzlasten Boolean Kennzeichnung, die angibt, ob die Unterstützung einer teilweisen Nutzlast aktiviert ist. Weitere Informationen zu Teilnutzlasten finden Sie unter Erweiterte IRE-Funktionen und IRE-Datenquellenregel erstellen.

    Gültige Werte:

    • „wahr“: Teilnutzlast aktiviert.
    • „falsch“: Teilnutzlast deaktiviert.

    Standardwert: wahr
    optionen.überspringen_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:
    • wahr: Wenn der Parameter source_recency_timestamp nicht in sys_object_source_infoübergeben wird, wird das Zeitfeld „last_scan“ von „sys_object_source“ nicht aktualisiert.
    • „falsch“: 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“.
    optionen.überspringen_aktualisierung_quelle_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, werden die Felder „discovery_source“ und „last_discovered“ nicht aktualisiert.
    • „falsch“: Aktualisiert die Felder „discovery_source“ und „last_discovered“.

    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. Rückgaben
    Parameter Beschreibung
    <String> JSON-formatierte Zeichenfolge, die eine Liste von Ergebnissen 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 committet wurden, aber nicht in der aktuellen Eingabenutzlast vorhanden waren.

    Datentyp: Array von Objekten

    "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 bei der Verarbeitung dieses zusätzlichen CI aufgetretenen Fehler.

    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 bei der Verarbeitung des zusätzlichen CI aufgetreten ist.

    Datentyp: Zeichenfolge
    <String>.zusätzlicheCommittedItems.errors.message Fehlermeldung bei der Verarbeitung des zusätzlichen CI.

    Datentyp: Zeichenfolge
    <String>.zusätzlicheCommittedItems.identificationAttempts Array von Objekten, in dem jedes Objekt einen Versuch beschreibt, der unternommen wurde, um dieses zusätzliche CI zu identifizieren.
    Datentyp: Array von Objekten
    "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:
    • ABGEGLICHEN: Identifizierung erfolgreich. In der Identifier-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • Multi_MATCH: Die Identifizierung ist mit einem Fehler fehlgeschlagen. In der Identifier-Regeltabelle wurden beim Abgleich mit den angegebenen Attributen doppelte CIs gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • ÜBERSPRUNGEN: 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 CI-Bezeichner-Eintragsattribute, 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-Identifier-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.identificationVersuche.bezeichnername Identifier-Regel, die für diesen zusätzlichen CI-Identifizierungsversuch verwendet wird.

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

    Datentyp: Zeichenfolge
    <String>.zusätzlicheCommittedItems.bezeichnerEintragSysId Sys_id für die Identifier-Regel, die zum Identifizieren dieses zusätzlichen CI verwendet wird.

    Bemerkbare Werte – Unbekannt: Die Identifizierung dieses zusätzlichen CI ist fehlgeschlagen. Details siehe errors.
    <String>.zusätzlicheCommittedItems.inputIndices Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem zusätzlichen CI entsprechen.

    Datentyp: Zahlen-Array

    "inputIndices": [
  {
    Number
  }
]
    <String>.zusätzlicheCommittedItems.markers Markerwerte für interne Verwendung.

    Datentyp: Array

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

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    <String>.additionalCommittedItems.operation Für dieses zusätzliche CI durchgeführter Vorgang.

    Datentyp: Zeichenfolge

    Mögliche Werte:
    • LÖSCHEN: 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 allgemeinere 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ängerklasse oder untergeordnete Klasse ist.
    • UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (absteigende Klasse) geändert.
    <String>.zusätzlicheCommittedItems.sysId Sys_id für dieses zusätzliche CI durch Identifizierung gefunden.

    Datentyp: Zeichenfolge

    Bemerkbare Werte – Unbekannt: Die Identifizierung dieses zusätzlichen CI ist fehlgeschlagen. Details siehe errors.
    <String>.zusätzlicheCommittedItems.Warnungen Beschreibung der Warnungen, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind.

    Datentyp: Array von Objekten

    "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 Bei der Verarbeitung dieses zusätzlichen CI ist eine Warnmeldung aufgetreten.

    Datentyp: Zeichenfolge
    <String>.ZusätzlicheCommittedRelations Beschreibung eines abhängigen Beziehungs-CI, das nicht in der Liste des Anforderungstexts relations zum Einfügen oder Aktualisieren enthalten war.

    Datentyp: Array von Objekten

    "additionalCommittedRelations": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String"
  }
]
    <String>.zusätzlicheCommittedRelations.className 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.Fehler Beschreibung der Fehler, die bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    <String>.additionalCommittedRelations.errors.message Fehlermeldung beim Verarbeiten dieses zusätzlichen abhängigen Beziehungs-CI.

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

    Datentyp: Array

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

    Datentyp: Array

    "markers": []
    <String>.additionalCommittedRelations.mergedPayloadIds Sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten“ [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>.additionalCommittedRelations.operation Vorgang, der für das zusätzliche abhängige Beziehungs-CI ausgeführt wurde.
    Mögliche Werte:
    • INSERT: Das CI der abhängigen Beziehung 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 der teilweisen CMDB-IRE-Nutzlasten [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>.hat Warnung Kennzeichnung, die angibt, ob für ein Element oder eine Beziehung Warnungen vorliegen.

    Datentyp: Boolesch
    <String>.items Beschreibung der erstellten oder aktualisierten CIs.

    Datentyp: Array von Objekten

    "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.zusätzlicheZugehörigeElemente Informationen zu zusätzlicher Suche und zu zugehörigen Elementen, die verarbeitet wurden, aber nicht als Teil der Eingabenutzlast bereitgestellt wurden. Diese Elemente stammen aus Teilnutzlasten.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    <String>.items.zusätzlicheZugehörigeElemente.eingabeindizes Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem zugehörigen Element entsprechen.

    Datentyp: Zahlen-Array
    <String>.items.zusätzlicheZugehörigeElemente.zusammengeführteNutzlastIds Liste der sys_ids der Teilnutzlasten, die mit dem zugehörigen Element zusammengeführt wurden.

    Datentyp: Array

    Tabelle: Teilweise Nutzlasten von CMDB-IRE [cmdb_ire_partial_payloads]
    <String>.items.zusätzlicheZugehörigeElemente.vorgang 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 erstellten oder aktualisierten CI.

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

    Datentyp: Array
    <String>.items.errorCount Anzahl der bei der Verarbeitung des Artikels aufgetretenen Fehler.

    Datentyp: Zahl
    <String>.items.errors Liste der bei der Verarbeitung des CI aufgetretenen Fehler.

    Datentyp: Array von Objekten

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.items.errors.error Typ des Fehlers, der bei der Verarbeitung 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 CIs zu identifizieren.

    Datentyp: Array von Objekten

    "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:

    • ABGEGLICHEN: Identifizierung erfolgreich. In der Identifier-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • Multi_MATCH: Die Identifizierung ist mit einem Fehler fehlgeschlagen. In der Identifier-Regeltabelle wurden beim Abgleich mit den angegebenen Attributen doppelte CIs gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • ÜBERSPRUNGEN: 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.identificationVersuche.attribute 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>elemente.identifizierungsversuche.hybridEintragCiAttribute 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.identificationVersuche.bezeichnername Identifier-Regel, die für diesen CI-Identifizierungsversuch verwendet wird.

    Datentyp: Zeichenfolge
    <String>.items.identificationAttempts.searchOnTable Name der Tabelle, die während des Identifizierungsprozesses durchsucht wurde.

    Datentyp: Zeichenfolge
    <String>.items.identifierEntrySysId Sys_id für die Identifier-Regel, die zum Identifizieren des CI verwendet wird.

    Datentyp: Zeichenfolge

    Tabelle: Bezeichnereintrag [cmdb_identifier_entry]
    <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 „Unvollständige CMDB-IRE-Nutzlasten“ [cmdb_ire_incomplete_payloads].

    Datentyp: Zeichenfolge
    <String>.items.info Zusätzliche Informationen zur Verarbeitung des Elements.

    Datentyp: Array von Objekten

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

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

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

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

    Datentyp: Zahlen-Array
    <String>.items.maskedAttributes Liste der Attribute, deren Aktualisierung durch eine nicht autorisierte Datenquelle gemäß den Abgleichsregelnübersprungen wurde.

    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 der Tabelle „cmdb_ire_partial_payloads“ gespeichert.
    • UPDATE: Vorhandenes CI wurde aktualisiert.
    • UPDATE_WITH_DOWNGRADE: CI wurde aktualisiert, und die Klasse wurde in eine allgemeinere Klasse geändert (Vorgängerklasse).
    • UPDATE_WITH_SWITCH: CI wurde aktualisiert, und die Klasse wurde in eine Klasse geändert, die nicht übergeordnet oder untergeordnet ist.
    • UPDATE_WITH_UPDRADE: CI wurde aktualisiert und die Klasse wurde in eine spezialisiertere Klasse (absteigende 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 Teilnutzlast-Datensatzes.

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

    Datentyp: Array von Objekten

    "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 bei der Verarbeitung des zugehörigen Elements aufgetreten sind.

    Datentyp: Array von Objekten

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.items.relatedItems.errors.error Typ des Fehlers, der bei der Verarbeitung 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 „Unvollständige CMDB-IRE-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 von Ganzzahlen. Für zugehörige Elemente 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 Array des Anforderungstexts items, der dem übergeordneten CI des zugehörigen Elements entspricht.

    Datentyp: Zahl
    <String>.items.relatedItems.inputIndices.subindex Indexwert aus dem Array des Anforderungstexts 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 in das 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 der 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 allgemeinere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: Das zugehörige CI wurde aktualisiert, und die Klasse wurde in eine Klasse geändert, die nicht übergeordnet oder untergeordnet ist.
    • UPDATE_WITH_UPDRADE: Zugehöriges CI wurde aktualisiert, und die Klasse wurde in eine spezialisiertere Klasse (absteigende Klasse) geändert.

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

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

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

    Datentyp: Zahl
    <String>.items.relatedItems.warnings Beschreibung der Warnungen, die bei der Verarbeitung der zugehörigen Elemente aufgetreten sind.

    Datentyp: Array von Objekten

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

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

    Datentyp: Zeichenfolge
    <String>.items.relatedSysIds Liste der sys_id-Werte der CIs, die bei der suchbasierten 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 Beschreibung eines abhängigen Beziehungs-CI aus dem Array des Anforderungstexts relations.

    Datentyp: Array von Objekten

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

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

    Datentyp: Zeichenfolge
    <String>.Beziehungen.Fehleranzahl Anzahl der Fehler, die bei der Verarbeitung des abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Zahl
    <String>.Beziehungen.Fehler Liste, die Fehler beschreibt, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Array von Objekten

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.Beziehungen.Fehler.Fehler Typ des Fehlers, der bei der Verarbeitung des CI der abhängigen Beziehung aufgetreten ist.

    Datentyp: Zeichenfolge
    <String>.Beziehungen.Fehler.Nachricht Fehlermeldung bei der Verarbeitung dieses abhängigen Beziehungs-CI.

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

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

    Datentyp: Array
    <String>.Beziehungen.Vorgang 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 der teilweisen CMDB-IRE-Nutzlasten [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>.beziehungen.partialSysIds Wenn die Beziehung Fehler aufwies und als teilweise Nutzlast gespeichert wurde, ist dieser Wert die sys_id des Datensatzes in der Tabelle „Teilweise Nutzlasten von CMDB-IRE“ [cmdb_ire_partial_payloads].

    Datentyp: Zeichenfolge
    <String>.beziehungen.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> .errorCount Anzahl der Fehler, die bei der Verarbeitung von Elementen auftreten.

    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 werden.

    Datentyp: Zahl
    <String>.Zusammenfassung<class_name> .eingefügtElementAnzahl 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 Elemente, die übersprungen wurden.

    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 den Vorgang in der Datenbank festzuschreiben.

    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 zu erstellenden oder zu aktualisierenden CI.
    • Lookup:[{}]: Liste der Datensätze, wobei jedes Element Name-Wert-Paare wie die Elementliste aufweist.
    • Werte:{}: Feldinformationen für das CI als Name-Wert-Paare, wobei der Name der Feldname ist.
    Mögliche Name-Wert-Paare in der Beziehungsliste sind:
    • Untergeordnetes Element: Index des untergeordneten Elements in der Abhängigkeitsbeziehung
    • parent: Index des übergeordneten 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.
    • duplicateIndices: Liste mit Indizes von Elementen, die Duplikate des aktuellen Elements sind.
    • Fehler: Liste der Fehler im Format (Fehler, Nachrichtenzeichenfolge)
    • IdentificationAttempts: Liste der Versuche.
      • attemptResult: Einer der folgenden Werte ist SKIPPED, NO_MATCH, MATCHED, Multi_MATCH.
      • Attribute: Attribute des Identifier-Eintrags, der während der Identifizierung verwendet wird.
      • IdentifierName: CI-Bezeichner, zu dem dieser Bezeichnereintrag gehört.
      • searchOnTable: Tabelle, die während des Identifizierungsprozesses durchsucht wurde.
    • indicatorEntrySysId: Sys_id des Identifier-Eintrags, der während des Abgleichs verwendet wird.
    • Operation: Auszuführender Vorgang, bei dem es sich um einen der folgenden handelt:
      • DELETE
      • EINFÜGEN
      • AKTUALISIEREN
      • UPDATE_MIT_DOWNGRADE
      • UPDATE_MIT_SWITCH
      • UPDATE_MIT_UPGRADE
    • relatedSysIds: Liste der sys_id-Werte von CIs, die während der suchbasierten Identifizierung verwendet werden.
    • sysId: Sys_id des CI, das aktualisiert oder erstellt wurde.
    Mögliche Name-Wert-Paare in der Beziehungsliste 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 Sie ein Configuration Item neu klassifizieren.

    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 – identifizierenCIEnhanced(Zeichenfolgenquelle, Zeichenfolgeneingabe, Objektoptionen)

    Bestimmt den Configuration Management Database (CMDB) -Vorgang (Einfügen/Aktualisieren), der mit der angegebenen Nutzlast (Anforderungstext) ausgeführt werden soll, ohne dass die Vorgänge in der Datenbank committet 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 folgenden Funktionen:
    • Teilnutzlasten
      • Gibt an, ob ein Artikelvorgang INSERT_AS_partial oder INSERT_INCOMPLETE ist, wenn für ein Element eine Warnung oder ein Fehler auftritt.
      • Gibt die sys_ids von Teilnutzlasten zurück, die mit vorhandenen Teilnutzlasten zusammengeführt wurden.
    • Unterstützt die Funktion zur Deduplizierung der Nutzlast.
    • Generiert eine Zusammenfassung.
    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Eingabe Zeichenfolge Erforderlich. Eingabenutzlast Eine JSON-formatierte Zeichenfolge von Konfigurationselementen zum Hinzufügen oder Aktualisieren. 
    "input" { 
 "items": [Array],
 "referenceItems": [Array],
 "relations": [Array]
}
    input.items Array von Objekten Elemente zum Hinzufügen oder Aktualisieren.
    "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 zu erstellenden oder zu aktualisierenden Configuration Items (CI).

    Dieser Wert kann eine beliebige Klasse/Tabelle CMDB 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 anstatt in diesem Parameter.

    Referenzfeldnamen hängen von den vom Anwender 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 von Objekten 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 zurück auf cmdb_ci enthält.

    Zum 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 zu erstellenden oder zu aktualisierenden Configuration Items (CI).

    Dieser Wert kann eine beliebige Klasse/Tabelle CMDB sein, z. B. cmdb_serial_number oder cmdb_ci_network_adapter.
    input.items.lookup.internal_id Zeichenfolge Eindeutiger Suchelementbezeichner 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 aufweisen.
    "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, verwenden Sie dieses Feld, um den Namen des Feeds anzugeben, der dieses Element sendet.

    Die Datenquelle generiert diesen Feed-Namen. Es kann sich um eine beliebige Zeichenfolge handeln, 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 sich um eine beliebige Zeichenfolge handeln, 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 Anwender 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 von Objekten Verweis auf das Element der obersten Ebene, das die zugehörige Liste enthält. Regeln im zugehörigen Eintrag [cmdb_related_entry] definieren, welche Arten von Datensätzen dieses Array enthalten darf. 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, muss es aber 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 zu erstellenden oder zu aktualisierenden Configuration Items (CI).

    Dieser Wert kann eine beliebige Klasse/Tabelle CMDB sein, z. B. cmdb_software_instance oder cmdb_key_value.
    input.items.related.internal_id Zeichenfolge Eindeutiger Bezeichner für das zugehörige Element in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber 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 aufweisen.
    "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, verwenden Sie dieses Feld, um den Namen des Feeds anzugeben, der dieses Element sendet.

    Die Datenquelle generiert diesen Feed-Namen. Es kann sich um eine beliebige Zeichenfolge handeln, 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 sich um eine beliebige Zeichenfolge handeln, 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
    Eingabe.Elemente.zugehörige.Werte 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 anstelle des values -Objekts.

    Feldnamen und -typen hängen von den vom Anwender 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 definieren, welche Arten von Updates zulässig sind.
    "settings": { 
  "skipReclassificationRestrictionRules": Boolean, 
  "updateWithoutDowngrade": Boolean, 
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    input.items.settings.reclassificationRestrictionRules überspringen Boolean Kennzeichnung, die angibt, ob IRE die Regel zur Einschränkung der Neuklassifizierung, die der Klasse für das Nutzlastelement entspricht, nicht ausführen soll.
    Gültige Werte:
    • true: Ausführung der Regel überspringen.
    • „falsch“: Führen Sie die Regel aus.

    Standardwert: false
    input.items.settings.updateWithoutDowngrade Boolean Kennzeichnung, die angibt, ob Update und Downgrade für dieses Element zulässig sind.
    Gültige Werte:
    • „wahr“: Element wird aktualisiert, Downgrade ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Downgrades 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:
    • „wahr“: Element wird aktualisiert, aber Klassenwechsel ist nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Klassenwechsel sind zulässig.

    Standardwert: false
    input.items.settings.updateWithoutUpgrade Boolean Kennzeichnung, die angibt, ob Update und Upgrade für diesen Artikel zulässig sind.
    Gültige Werte:
    • „wahr“: Element wird aktualisiert, aber Upgrade ist nicht zulässig.
    • „falsch“: Sowohl Element-Updates 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, verwenden Sie dieses Feld, um den Namen des Feeds anzugeben, der dieses Element sendet.

    Die Datenquelle generiert diesen Feed-Namen. Es kann sich um eine beliebige Zeichenfolge handeln, 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 sich um eine beliebige Zeichenfolge handeln, 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 anstelle des values -Objekts.

    Feldnamen und -typen hängen von den vom Anwender 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 von Objekten Liste, die Referenzen zwischen Elementen in der Eingabenutzlast definiert. 
    "referenceItems": [
  { 
    "referenced": "String", 
    "referencedBy": "String", 
    "referenceField": "String" 
  }
]
    input.referenceItems.referenced Zeichenfolge internal_id, das für das Element definiert ist, auf das von einem anderen Element verwiesen wird.
    input.referenceItems.referencedBy Zeichenfolge internal_id, das für das Element definiert ist und auf ein anderes Element verweist.
    input.referenceItems.referenceField Zeichenfolge Name des Referenzfelds in der Klasse/Tabelle für das Element referencedBy.
    Eingabebeziehungen Array von Objekten Liste, die Beziehungen zwischen Elementen in der Eingabenutzlast angibt.
    Ein Objekt in diesem Array kann zwei Formate verwenden.
    • Das Objekt kann eine Beziehung zwischen zwei Elementen der obersten Ebene (nur) mithilfe von Name-Wert-Paaren parent und child definieren, wobei Werte Elementindizes aus dem Nutzlast-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 Elementen der obersten Ebene, zugehörigen Elementen oder Suchelementen, indem Schlüssel-Wert-Paare parent_id und child_id verwendet werden, wobei -Werte die für diese Elemente definierten internal_id -Werte darstellen.
      "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    input.beziehungen.untergeordnetes Element Nummer Ganzzahlindex des CI-Objekts im Array items, das das untergeordnete Element in der Beziehung darstellt („items“, „items.related“ oder „items.lookup“).
    input.beziehungen.child_id Zeichenfolge internal_id des untergeordneten Elements in der Beziehung („items“, „items.related“ oder „items.lookup“)
    Eingabe.Beziehungen.übergeordnet Nummer Ganzzahlindex des übergeordneten Elements im Array items („items“, „items.related“ oder „items.lookup“)
    input.beziehungen.parent_id Zeichenfolge internal_id des übergeordneten Elements in der Beziehung („items“, „items.related“ oder „items.lookup“)
    input.beziehungen.sys_rel_source_info Objekt Informationen zur Discovery-Quelle für die Beziehung. Bei Nicht-Abhängigkeits-Beziehungen werden diese Informationen in der Tabelle „Beziehungsquellen“ [sys_rel_source] gespeichert (werden für die Methoden identifizierenCIEnhanced() und identifizierenCI() nicht beibehalten).

    Datentyp: Objekt

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

    Standard: Discovery-Quelle, die im API-Methodenparameter übergeben wird.
    input.beziehungen.sys_rel_source_info.source_feed Zeichenfolge Beliebige Zeichenfolge, die eine Unter-Discovery/ein Unterscan innerhalb der Discovery-Quelle ist.

    Standard: „UNBEKANNT“ wird in der Spalte „source_feed“ gespeichert, wenn ein Datensatz in der Tabelle „sys_rel_source“ erstellt wird.
    Eingabe.Beziehungen.Typ 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 wichtig 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
}
    optionen.deduplizieren_nutzlasten Boolean Kennzeichnung, die angibt, ob doppelte Elemente zusammengeführt oder als Fehler betrachtet werden.

    Gültige Werte:

    • „wahr“: Doppelte Elemente zusammenführen.
    • „falsch“: Doppelte Elemente werden als Fehler betrachtet.

    Standardwert: wahr
    Optionen.Generieren_Zusammenfassung Boolean Kennzeichnung, die angibt, ob die zurückgegebenen Ergebnisse Zusammenfassungsinformationen enthalten. Einzelheiten zu den zurückgegebenen Zusammenfassungsinformationen finden Sie unter <String>.summary in der Tabelle der Rückgabeergebnisse.

    Gültige Werte:

    • „wahr“: Zusammenfassungsinformationen einschließen.
    • „falsch“: Keine Zusammenfassungsinformationen einschließen.

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

    Gültige Werte:

    • „wahr“: Teilweiser Commit aktiviert.
    • „falsch“: Teilweiser Commit deaktiviert.

    Standardwert: wahr
    Optionen.partielle_Nutzlasten Boolean Kennzeichnung, die angibt, ob die Unterstützung einer teilweisen Nutzlast aktiviert ist. Weitere Informationen zu Teilnutzlasten finden Sie unter Erweiterte IRE-Funktionen und IRE-Datenquellenregel erstellen.

    Gültige Werte:

    • „wahr“: Teilnutzlast aktiviert.
    • „falsch“: Teilnutzlast deaktiviert.

    Standardwert: wahr
    optionen.überspringen_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:
    • wahr: Wenn der Parameter source_recency_timestamp nicht in sys_object_source_infoübergeben wird, wird das Zeitfeld „last_scan“ von „sys_object_source“ nicht aktualisiert.
    • „falsch“: 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“.
    optionen.überspringen_aktualisierung_quelle_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, werden die Felder „discovery_source“ und „last_discovered“ nicht aktualisiert.
    • „falsch“: Aktualisiert die Felder „discovery_source“ und „last_discovered“.

    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. Rückgaben
    Typ Beschreibung
    <String> JSON-formatierte Zeichenfolge, die eine Liste von Ergebnissen 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 committet wurden, aber nicht in der aktuellen Eingabenutzlast vorhanden waren.

    Datentyp: Array von Objekten

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

    Datentyp: Array von Objekten

    "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>.hat Warnung Kennzeichnung, die angibt, ob für ein Element oder eine Beziehung Warnungen vorliegen.

    Datentyp: Boolesch
    <String>.items Beschreibung der erstellten oder aktualisierten CIs.

    Datentyp: Array von Objekten

    "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.zusätzlicheZugehörigeElemente Informationen zu zusätzlicher Suche und zu zugehörigen Elementen, die verarbeitet wurden, aber nicht als Teil der Eingabenutzlast bereitgestellt wurden. Diese Elemente stammen aus Teilnutzlasten.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    <String>.items.zusätzlicheZugehörigeElemente.eingabeindizes Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem zugehörigen Element entsprechen.

    Datentyp: Zahlen-Array
    <String>.items.zusätzlicheZugehörigeElemente.zusammengeführteNutzlastIds Liste der sys_ids der Teilnutzlasten, die mit dem zugehörigen Element zusammengeführt wurden.

    Datentyp: Array

    Tabelle: Teilweise Nutzlasten von CMDB-IRE [cmdb_ire_partial_payloads]
    <String>.items.zusätzlicheZugehörigeElemente.vorgang 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 erstellten oder aktualisierten CI.

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

    Datentyp: Array
    <String>.items.errorCount Anzahl der bei der Verarbeitung des Artikels aufgetretenen Fehler.

    Datentyp: Zahl
    <String>.items.errors Liste der bei der Verarbeitung des CI aufgetretenen Fehler.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    <String>.items.errors.message Fehlermeldung bei der Verarbeitung des CI.

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

    Datentyp: Array von Objekten

    "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:

    • ABGEGLICHEN: Identifizierung erfolgreich. In der Identifier-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • Multi_MATCH: Die Identifizierung ist mit einem Fehler fehlgeschlagen. In der Identifier-Regeltabelle wurden beim Abgleich mit den angegebenen Attributen doppelte CIs gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • ÜBERSPRUNGEN: 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.identificationVersuche.attribute 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.identificationVersuche.bezeichnername Identifier-Regel, die für diesen CI-Identifizierungsversuch verwendet wird.

    Datentyp: Zeichenfolge
    <String>.items.identificationAttempts.searchOnTable Name der Tabelle, die während des Identifizierungsprozesses durchsucht wurde.

    Datentyp: Zeichenfolge
    <String>.items.identifierEntrySysId Sys_id für die Identifier-Regel, die zum Identifizieren des CI verwendet wird.

    Datentyp: Zeichenfolge

    Tabelle: Bezeichnereintrag [cmdb_identifier_entry]
    <String>.items.info Zusätzliche Informationen zur Verarbeitung des Elements.

    Datentyp: Array von Objekten

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

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

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

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

    Datentyp: Zahlen-Array
    <String>.items.maskedAttributes Liste der Attribute, deren Aktualisierung durch eine nicht autorisierte Datenquelle gemäß den Abgleichsregelnübersprungen wurde.

    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 der Tabelle „cmdb_ire_partial_payloads“ gespeichert.
    • UPDATE: Vorhandenes CI wurde aktualisiert.
    • UPDATE_WITH_DOWNGRADE: CI wurde aktualisiert, und die Klasse wurde in eine allgemeinere Klasse geändert (Vorgängerklasse).
    • UPDATE_WITH_SWITCH: CI wurde aktualisiert, und die Klasse wurde in eine Klasse geändert, die nicht übergeordnet oder untergeordnet ist.
    • UPDATE_WITH_UPDRADE: CI wurde aktualisiert und die Klasse wurde in eine spezialisiertere Klasse (absteigende Klasse) geändert.

    Datentyp: Zeichenfolge
    <String>.items.relatedItems Informationen zu den verarbeiteten zugehörigen Elementen.

    Datentyp: Array von Objekten

    "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 bei der Verarbeitung des zugehörigen Elements aufgetreten sind.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    <String>.items.relatedItems.errors.message Fehlermeldung beim Verarbeiten des zugehörigen Elements.

    Datentyp: Zeichenfolge
    <String>.items.relatedItems.inputIndices Index des entsprechenden Eingabeelements. Bei Elementen der obersten Ebene handelt es sich um eine Liste von Ganzzahlen. Für zugehörige Elemente 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 Array des Anforderungstexts items, der dem übergeordneten CI des zugehörigen Elements entspricht.

    Datentyp: Zahl
    <String>.items.relatedItems.inputIndices.subindex Indexwert aus dem Array des Anforderungstexts 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 in das 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 der 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 allgemeinere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: Das zugehörige CI wurde aktualisiert, und die Klasse wurde in eine Klasse geändert, die nicht übergeordnet oder untergeordnet ist.
    • UPDATE_WITH_UPDRADE: Zugehöriges CI wurde aktualisiert, und die Klasse wurde in eine spezialisiertere Klasse (absteigende Klasse) geändert.

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

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

    Datentyp: Zahl
    <String>.items.relatedItems.warnings Beschreibung der Warnungen, die bei der Verarbeitung der zugehörigen Elemente aufgetreten sind.

    Datentyp: Array von Objekten

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.items.relatedSysIds Liste der sys_id-Werte der CIs, die bei der suchbasierten 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 Informationen zu den verarbeiteten Beziehungen.

    Datentyp: Array von Objekten

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

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

    Datentyp: Zeichenfolge
    <String>.Beziehungen.Fehleranzahl Anzahl der Fehler, die bei der Verarbeitung des abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Zahl
    <String>.Beziehungen.Fehler Liste, die Fehler beschreibt, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Array von Objekten

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

    Datentyp: Array
    <String>.Beziehungen.Vorgang 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 der teilweisen CMDB-IRE-Nutzlasten [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>.beziehungen.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> .errorCount Anzahl der Fehler, die bei der Verarbeitung von Elementen auftreten.

    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 werden.

    Datentyp: Zahl
    <String>.Zusammenfassung<class_name> .eingefügtElementAnzahl 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 Elemente, die übersprungen wurden.

    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 Configuration Item (CI) durch, 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);