---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# IdentifikationEngine -- Umfang

# IdentifikationEngine -- Umfang {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 63 Minuten Lesedauer

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

Wenn Sie diese Klasse in einer bereichsbezogenen Anwendung verwenden, verwenden Sie `sn_cmdb `Namespace-Bezeichner.

## IdentifikationEngine -- createOrUpdateCI (Zeichenfolgenquelle, Zeichenfolgeneingabe) {#ariaid-title2}

Fügt Konfigurationselemente (CI) ein oder aktualisiert sie und nicht- Configuration Management Database (CMDB)CIs (Klassen, die sich nicht von cmdb_ci erstrecken) in CMDBBasierend auf Identifizierungs- und Abgleichsregeln. Verwenden Sie diese API, anstatt zu aktualisieren CMDBDirekt.
Weitere Informationen zur Erfassung von nicht-CMDB-Tabellen finden Sie unter [IRE support for non-CMDB tables](https://www.servicenow.com/docs/access?context=ire-support-non-cmdb-tables&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US).
{#IESS-createorUpdateCI_S_S__entry__3}{#IESS-createorUpdateCI_S_S__entry_input}{#IESS-createorUpdateCI_S_S__entry_items}{#IESS-createorUpdateCI_S_S__entry_className}{#IESS-createorUpdateCI_S_S__entry-display_values-ire}{#IESS-createorUpdateCI_S_S__entry_internal_id}{#IESS-createorUpdateCI_S_S__entry_lookup}{#IESS-createorUpdateCI_S_S__row_items_settings}{#IESS-createorUpdateCI_S_S__items_set_skipReclassRestrictRules-entry-IRE}{#IESS-createorUpdateCI_S_S__row_items_settings_updateWithoutDowngrade}{#IESS-createorUpdateCI_S_S__row_items_settings_updateWithoutUpgrade}{#IESS-createorUpdateCI_S_S__row_items_settings_updateWithoutSwitch}{#IESS-createorUpdateCI_S_S__entry_values}{#IESS-createorUpdateCI_S_S__entry_referenceItems}{#IESS-createorUpdateCI_S_S__entry_referenceItems_referenced}{#IESS-createorUpdateCI_S_S__entry_referenceItems_referencedBy}{#IESS-createorUpdateCI_S_S__entry_referenceItems_referenceField}{#IESS-createorUpdateCI_S_S__entry_relations}{#IESS-createorUpdateCI_S_S__entry_relations_child}{#IESS-createorUpdateCI_S_S__entry_relations_child_id}{#IESS-createorUpdateCI_S_S__entry_relations_parent}{#IESS-createorUpdateCI_S_S__entry_relations_parent_id}{#IESS-createorUpdateCI_S_S__sys_rel_source_info-entry-IRE}{#IESS-createorUpdateCI_S_S__sys_rel_source_info-source_name-entry-ire}{#IESS-createorUpdateCI_S_S__sys_rel_source_into-source_feed-entry-ire}{#IESS-createorUpdateCI_S_S__entry_relations_type}

| Name | Typ | Beschreibung |
|-|-|-|
| Eingabe | Zeichenfolge | Erforderlich. Eingabenutzlast. Eine JSON-formatierte Zeichenfolge von Konfigurationselementen, die hinzugefügt oder aktualisiert werden sollen. "input" { "items": [Array], "referenceItems": [Array], "relations": [Array] } |
| input.items | Objekt-Array | Elemente, die hinzugefügt oder aktualisiert werden sollen. "items": [ { "className": "String", "display_values": {Object}, "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ] |
| input.items.className | Zeichenfolge | Erforderlich. Klassen-/Tabellenname, sys_class_Name, des Konfigurationselements (CI), das erstellt oder aktualisiert werden soll. Dieser Wert kann beliebig sein CMDBKlasse/Tabelle, 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 in input.items.lookup.valuesParameter anstelle von 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 zugehörige Nutzlast. Dies kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein. |
| input.items.lookup | Objekt-Array | Gibt das Element der obersten Ebene an, das die Suche enthält (suchbasierte Identifizierung). Diese Datensätze werden verwendet, um das Konfigurationselement basierend auf einer Suchtabelle zu identifizieren, die einen Verweis auf cmdb_ci hat. 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 Konfigurationselements (CI), das erstellt oder aktualisiert werden soll. Dieser Wert kann beliebig sein CMDBKlasse/Tabelle, z. B. cmdb_Serial_number oder cmdb_ci_network_adapter. |
| input.items.lookup.internal_id | Zeichenfolge | Eindeutiger Elementbezeichner für die zugehörige 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 eine beliebige Zeichenfolge sein, die den Quell-Feed eindeutig identifiziert. |
| input.items.lookup.sys_object_source_info.source_name | Zeichenfolge | Datenquelle der CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. |
| input.items.lookup.sys_object_source_info.source_native_key | Zeichenfolge | Eindeutiger Schlüssel/ID für das Element aus der Quelle. Die Datenquelle generiert diesen Schlüssel. Es kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. |
| input.items.lookup.sys_object_source_info.source_recency_timestamp | Zeichenfolge | UTC-Datum und -Uhrzeit, zu der das Element gescannt wurde. Format: JJJJ-MM-TT hh:mm:ss |
| input.items.lookup.values | Objekt | Felder, die für dieses zugehörige Element als Name/Wert-Paare erstellt oder aktualisiert werden sollen, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_ID sein Wenn Sie den Anzeigewert anstelle der sys_ID für Referenzfelder verwenden möchten, übergeben Sie diese Informationen in einem display_valuesObjekt anstelle von in valuesObjekt. 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 Art von Datensätzen in diesem Array sein kann. Diese Datensätze werden verwendet, um Elemente basierend auf einer zugehörigen Tabelle hinzuzufügen, die einen Verweis auf das identifizierte CI enthält. Die zugehörige Tabelle kann cmdb_ci erweitern oder nicht. Diese Datensätze werden nicht zur Identifizierung des Konfigurationselements verwendet. "related" [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] |
| input.items.related.className | Zeichenfolge | Erforderlich. Klassen-/Tabellenname, sys_class_Name, des Konfigurationselements (CI), das erstellt oder aktualisiert werden soll. Dieser Wert kann beliebig sein CMDBKlasse/Tabelle, z. B. cmdb_Software_instance oder cmdb_key_value. |
| input.items.related.internal_id | Zeichenfolge | Eindeutiger Elementbezeichner für die zugehörige 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 eine beliebige Zeichenfolge sein, die den Quell-Feed eindeutig identifiziert. |
| input.items.related.sys_object_source_info.source_name | Zeichenfolge | Datenquelle der CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. |
| input.items.related.sys_object_source_info.source_native_key | Zeichenfolge | Eindeutiger Schlüssel/ID für das Element aus der Quelle. Die Datenquelle generiert diesen Schlüssel. Es kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. |
| input.items.related.sys_object_source_info.source_recency_timestamp | Zeichenfolge | UTC-Datum und -Uhrzeit, zu der das Element gescannt wurde. Format: JJJJ-MM-TT hh:mm:ss |
| input.items.related.values | Objekt | Felder, die für dieses zugehörige Element als Name/Wert-Paare erstellt oder aktualisiert werden sollen, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_ID sein Wenn Sie den Anzeigewert anstelle der sys_ID für Referenzfelder verwenden möchten, übergeben Sie diese Informationen in einem display_valuesObjekt anstelle von in valuesObjekt. 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 die Arten der zulässigen Updates definieren. "settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean } |
| input.items.settings.skipReclassificationRestrictionRules | Boolean | Kennzeichnung, die angibt, ob Ire die Reklassifizierungseinschränkungsregel nicht ausführen soll, die der Klasse für das Nutzlastelement entspricht. Gültige Werte: * Wahr: Ausführung der Regel wird übersprungen. * Falsch: Führen Sie die Regel aus. {#IESS-createorUpdateCI_S_S__ul_tl4_qwp_snb} Standard: Falsch |
| input.items.settings.updateWithoutDowngrade | Boolean | Kennzeichnung, die angibt, ob Update und Downgrade für dieses Element zulässig sind. Gültige Werte: * Wahr: Aktualisieren Sie das Element, ein Downgrade ist jedoch nicht zulässig. * Falsch: Sowohl Elementaktualisierung als auch Downgrade sind zulässig. {#IESS-createorUpdateCI_S_S__ul_jdl_pfb_sjb} Standard: Falsch |
| input.items.settings.updateWithoutUpgrade | Boolean | Kennzeichnung, die angibt, ob Aktualisierung und Upgrade für dieses Element zulässig sind. Gültige Werte: * Wahr: Aktualisieren Sie das Element, aber ein Upgrade ist nicht zulässig. * Falsch: Elementaktualisierung und Upgrade sind zulässig. {#IESS-createorUpdateCI_S_S__ul_vqx_xfb_sjb} Standard: Falsch |
| input.items.settings.updateWithoutSwitch | Boolean | Kennzeichnung, die angibt, ob das Element aktualisiert und die Klasse gewechselt werden kann. Gültige Werte: * Wahr: Aktualisieren Sie das Element, aber Klassenwechsel ist nicht zulässig. * Falsch: Sowohl Elementaktualisierung als auch Klassenwechsel sind zulässig. {#IESS-createorUpdateCI_S_S__ul_h4p_2gb_sjb} Standard: Falsch |
| 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 eine beliebige Zeichenfolge sein, die den Quell-Feed eindeutig identifiziert. |
| input.items.sys_object_source_info.source_name | Zeichenfolge | Datenquelle der CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. |
| input.items.sys_object_source_info.source_native_key | Zeichenfolge | Eindeutiger Schlüssel/ID für das Element aus der Quelle. Die Datenquelle generiert diesen Schlüssel. Es kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. |
| input.items.sys_object_source_info.source_recency_timestamp | Zeichenfolge | UTC-Datum und -Uhrzeit, zu der das Element gescannt wurde. Format: JJJJ-MM-TT hh:mm:ss |
| input.items.values | Objekt | Felder, die für dieses zugehörige Element als Name/Wert-Paare erstellt oder aktualisiert werden sollen, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_ID sein Wenn Sie den Anzeigewert anstelle der sys_ID für Referenzfelder verwenden möchten, übergeben Sie diese Informationen in einem display_valuesObjekt anstelle von in valuesObjekt. 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" } |
| Eingabe.referenceItems | Objekt-Array | Liste, die Verweise zwischen Elementen in der Eingabenutzlast definiert. "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ] |
| Eingabe.referenzierenElemente.referenziert | Zeichenfolge | Die internal_idDefiniert für das Element, auf das von einem anderen Element verwiesen wird. |
| Eingabe.referenceItems.referencedBy | Zeichenfolge | Die internal_idDefiniert für das Element, das auf ein anderes Element verweist. |
| Eingabe.referenceItems.referenceField | Zeichenfolge | Name des Referenzfelds in der Klasse/Tabelle für referencedByElement. |
| Eingabe.Beziehungen | Objekt-Array | 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) mit definieren parentUnd childName-Wert-Paare, deren Werte Elementindizes aus der Nutzlast darstellen itemsArray. "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 parent_idUnd child_idSchlüssel-Wert-Paare, wobei Werte darstellen internal_idWerte, die für diese Elemente definiert sind. "relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ] {#IESS-createorUpdateCI_S_S__ul_s1s_phb_nlb} |
| input.relations.child | Nummer | Ganzzahliger Index des CI-Objekts in itemsArray, das das untergeordnete Element in der Beziehung darstellt (items, items.related oder items.search) |
| input.relations.child_id | Zeichenfolge | Die internal_idDes untergeordneten Elements in der Beziehung (items, items.related oder items.search.) |
| Eingabe.Beziehungen.übergeordnetes Element | Nummer | Ganzzahliger Index des übergeordneten Elements in itemsArray (items, items.related oder items.search.) |
| Eingabe.Beziehungen.parent_ID | Zeichenfolge | Die internal_idDes übergeordneten Elements in der Beziehung (items, items.related oder items.Lookup.) |
| input.relations.sys_rel_source_info | Objekt | Discovery-Quellinformationen für die Beziehung. Für Beziehungen ohne Abhängigkeiten werden diese Informationen in der Tabelle „Beziehungsquellen" \[sys_rel_Source\] gespeichert (nicht beibehalten für IdentifyCIErweitert() Oder IdentifyCI() Methoden.) Datentyp: Objekt "sys_rel_source_info": { "source_name": "String", "source_feed": "String" } |
| input.relations.sys_rel_source_info.source_name | Zeichenfolge | Name der Discovery-Quelle. Standard: Discovery-Quelle im API-Methodenparameter übergeben. |
| input.relations.sys_rel_source_info.source_feed | Zeichenfolge | Jede Zeichenfolge, die eine untergeordnete Discovery/Scan 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 CI-Beziehungstyp-Tabelle \[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 : 1. Parameter]

{#IESS-createorUpdateCI_S_S__table_yyd_zxn_ylb__entry__2}{#IESS-createorUpdateCI_S_S__entry_return_item_className}{#IESS-createorUpdateCI_S_S__entry_return_items_duplicateIndices}{#IESS-createorUpdateCI_S_S__entry_return_item_error}{#IESS-createorUpdateCI_S_S__items_errors_errors-entry-IRE}{#IESS-createorUpdateCI_S_S__items_errors_msg-entry-IRE}{#IESS-createorUpdateCI_S_S__entry_return_item_identificationAttempts}{#IESS-createorUpdateCI_S_S__entry_return_item_identificationAttempts_attemptResult}{#IESS-createorUpdateCI_S_S__entry_return_item_identificationAttempts_attributes}{#IESS-createorUpdateCI_S_S__entry_return_item_identificationAttempts_identifierName}{#IESS-createorUpdateCI_S_S__entry_return_item_identificationAttempts_searchOnTable}{#IESS-createorUpdateCI_S_S__entry_return_item_identifierEntrySysId}{#IESS-createorUpdateCI_S_S__items_info-entry-IREE}{#IESS-createorUpdateCI_S_S__entry_return_item_maskedAttributes}{#IESS-createorUpdateCI_S_S__entry_return_item_sys_id}{#IESS-createorUpdateCI_S_S__entry_return_relations_className}{#IESS-createorUpdateCI_S_S__entry_return_relations_sys_id}

| Typ | Beschreibung |
|-|-|
| \<String\> | JSON-formatierte Zeichenfolge, die eine Liste von Ergebnissen für die Konfigurationselemente in der Eingabezeichenfolge ist. Jede Ergebniszeichenfolge hat das Format „Elemente: \[{}\], Beziehungen:\[{}\]", wobei jedes Element innerhalb der Elemente- und Beziehungslisten Name-Wert-Paare enthält. Datentyp: Zeichenfolge |
| \<String\>.zusätzliche KommittedElemente | Derzeit werden keine Werte zurückgegeben. |
| \<String\>.ZusätzlichZusammenarbeitenBeziehungen | Derzeit werden keine Werte zurückgegeben. |
| \<String\>.Elemente | 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.additionalRelatedItems | Liste von Informationen zu zusätzlichen Suchelementen und zugehörigen Elementen, 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.additionalRelatedItems.className | Klassen-/Tabellenname (sys_class_Name) des CI, das erstellt oder aktualisiert wurde. Datentyp: Zeichenfolge |
| \<String\>.items.additionalRelatedItems.inputIndices | Index des entsprechenden Eingabeelements. Für Elemente der obersten Ebene ist dies 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.additionalRelatedItems.inputIndices.mainIndex | Indexwert aus dem Anforderungstext itemsArray, das dem übergeordneten CI des zusätzlichen zugehörigen Elements entspricht. Datentyp: Zahl |
| \<String\>.items.additionalRelatedItems.inputIndices.subIndex | Indexwert aus dem Anforderungstext items.lookupArray, das dem zusätzlichen zugehörigen Element entspricht. Datentyp: Zahl |
| \<String\>.items.additionalRelatedItems.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. {#IESS-createorUpdateCI_S_S__ul_zk2_jrt_ylb} Datentyp: Zeichenfolge |
| \<String\>.items.additionalRelatedItems.sysId | SYS_ID der zusätzlichen zugehörigen Elemente. Datentyp: Zeichenfolge |
| \<String\>.Items.className | Klassen-/Tabellenname (sys_class_Name) des CI, das erstellt oder aktualisiert wurde. Datentyp: Zeichenfolge |
| \<String\>.items.duplicateIndices | Liste der Indizes von CIs, die Duplikate des aktuellen Elements sind. Datentyp: Array |
| \<String\>.items.Fehleranzahl | Anzahl der Fehler. Datentyp: Zahl |
| \<String\>.Elemente.Fehler | Liste der Fehler, die bei der Verarbeitung dieses CI aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| \<String\>.Elemente.Fehler.Fehler | Typ des beim Verarbeiten des CI aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| \<String\>.Elemente.Fehler.Nachricht | Fehlermeldung, die dem Fehler zugeordnet ist. Datentyp: Zeichenfolge |
| \<String\>.items.identifikationVermutungen | Liste der Versuche, die zur Identifizierung der CIs unternommen wurden. Datentyp: Array von Objekten "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identifierName": "String", "searchOnTable": "String" } ] |
| \<String\>.Elemente.IdentifikationVersuchen.Versuch.Befolgen | Ergebnisse des Versuchs, das CI zu identifizieren. Mögliche Werte: * ÜBEREINSTIMMEND: Identifizierung erfolgreich. In der Bezeichnerregeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmte. * MULTI_MATCH: Identifizierung mit Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichnerregeltabelle beim Abgleich mit den angegebenen Attributen gefunden. * NO_MATCH: Identifizierung fehlgeschlagen. In der Bezeichnerregeltabelle wurde kein CI gefunden, das den angegebenen Attributen entsprach. * ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für diese Bezeichnerregeltabellensuche erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet. Datentyp: Zeichenfolge |
| \<String\>.items.identificationAttempts.attributes | Liste der CI-Bezeichnereintragsattribute, die während des Identifizierungsprozesses verwendet wurden. Datentyp: Array Attributnamen und -Typen hängen von den Anforderungstext-Daten und dem verwendeten Bezeichner ab, z. B.: "attributes": [ "serial_number": "String", "serial_number_type": "String", ] |
| \<String\>.items.identificationAttempts.hybridEntryCiAttributes | Derzeit werden keine Werte zurückgegeben. |
| \<String\>.items.identificationAttempts.identifierName | Bezeichnerregel, die für diesen CI-Identifizierungsversuch verwendet wird. Datentyp: Zeichenfolge |
| \<String\>.items.identificationAttempts.searchOnTable | Name der Tabelle, die während des Identifizierungsprozesses gesucht wird. Datentyp: Zeichenfolge |
| \<String\>.items.identifierEintragSysId | SYS_ID für die Bezeichnerregel, die zur Identifizierung des CI verwendet wird. Datentyp: Zeichenfolge Tabelle: Bezeichnereintrag \[cmdb_Identifier_entry\] |
| \<String\>.items.info | Liste, die zusätzliche Informationen zur Verarbeitung des Elements enthält. Datentyp: Array von Objekten "info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ] |
| \<String\>.items.info.code | Reklassifizierungstyp, der übersprungen wurde. Mögliche Werte: * ÜBERSPRUNGEN_CLASS_SWITCH * SKIPPED_CLASS_DOWNGRADE * ÜBERSPRUNGEN_CLASS_UPGRADE {#IESS-createorUpdateCI_S_S__ul_cqz_yyp_snb} Datentyp: Zeichenfolge |
| \<String\>.items.info.message | Nachricht, die zusätzliche Einblicke in den Grund für das Überspringen der Neuklassifizierung bietet. Datentyp: Zeichenfolge |
| \<String\>.items.info.ruleSysId | SYS_ID der Reklassifizierungseinschränkungsregel, die abgeglichen wurde. Gilt nur, wenn Ire die Neuklassifizierung aufgrund der Reklassifizierungseinschränkungsregel überspringt. Dieser Wert ist leer, wenn die Neuklassifizierung aufgrund einer Nutzlast oder einer globalen Kennzeichnung übersprungen wird. Datentyp: Zeichenfolge |
| \<String\>.items.inputIndices | Indexwerte für CIs aus dem Anforderungstext itemsArray, das diesem CI entspricht. Datentyp: Array |
| \<String\>.items.maskedAttribute | Liste der Attribute, deren Aktualisierung durch eine nicht autorisierende Datenquelle wie von definiert übersprungen wurde [Abgleichsregeln](https://www.servicenow.com/docs/access?context=create-reconciliation-rule&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US). Datentyp: Array |
| \<String\>.Elemente.zugehörigElemente | 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.error | Liste der Fehler, die während der Verarbeitung aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| \<String\>.items.relatedItems.Fehleranzahl | Anzahl der während der Verarbeitung erkannten Fehler. Datentyp: Zahl |
| \<String\>.items.relatedItems.inputIndices | Indizes der entsprechenden zugehörigen Elemente. Datentyp: Array oder Nummern "inputIndices": [ { "mainIndex": Number, "subIndex": Number } ] |
| \<String\>.items.relatedItems.inputIndices.mainIndex | Ganzzahliger Wert aus dem Anforderungstext itemsArray, das dem übergeordneten CI des zugehörigen Elements entspricht. Datentyp: Zahl |
| \<String\>.items.relatedItems.inputIndices.subIndex | Ganzzahliger Wert aus dem Anforderungstext items.lookupArray, das dem zugehörigen Element entspricht. Datentyp: Zahl |
| \<String\>.items.relatedItems.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. {#IESS-createorUpdateCI_S_S__ul_a4r_kf4_ylb} Datentyp: Zeichenfolge |
| \<String\>.items.relatedSysIds | Liste der sys_ID-Werte für zugehörige Elemente (Tabellensuchelemente) aus dem Anforderungstext items.lookupArray. Bedeutende 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. Nur unterstützter Wert: cmdb_rel_ci: CI-Beziehungstabelle. Datentyp: Zeichenfolge |
| \<String\>.Beziehungen.Fehleranzahl | Anzahl der Fehler. Datentyp: Zahl |
| \<String\>.relations.inputIndices | Indizes der entsprechenden Eingabebeziehungen. Datentyp: Array |
| \<String\>.Beziehungen.Vorgang | Typ des ausgeführten Vorgangs. Mögliche Werte: * EINFÜGEN * AKTUALISIEREN * NO_CHANGE Datentyp: Zeichenfolge |
| \<String\>.Beziehungen.sysId | SYS_ID des abhängigen Beziehungs-CI. Datentyp: Zeichenfolge |
[Tabelle : 2. Rückgaben]

{#IESS-createorUpdateCI_S_S__table_yyd_zxn_ylb}  
Im Folgenden wird gezeigt, wie ein Konfigurationselement neu klassifiziert wird.

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

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

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

Ausgabe:

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

Im Folgenden wird gezeigt, wie ein Konfigurationselement aktualisiert wird.

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

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

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

      "internal_id": "tomcat_id"
      }],

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

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

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

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

Ausgabe:

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

Identifizieren Sie ein abhängiges 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": []
    }

## IdentifikationEngine -- createOrUpdateCIEnhanced (Zeichenfolgenquelle, Zeichenfolgeneingabe, Objektoptionen) {#ariaid-title3}

Fügt Konfigurationselemente (CI) ein oder aktualisiert sie und nicht- Configuration Management Database (CMDB)CIs (Klassen, die sich nicht von cmdb_ci erstrecken) in CMDBBasierend auf Identifizierungs- und Abgleichsregeln. Verwenden Sie diese API, anstatt zu aktualisieren CMDBDirekt.
Zusätzlich zur Bereitstellung der Funktionalität von CreateOrUpdateCI() Methode, diese Methode unterstützt auch:

* Verarbeitung von Teilnutzlasten
* Teilweise Commits werden verarbeitet
* Doppelte Elemente in einer Nutzlast werden entfernt
* Ausgabezusammenfassungen werden generiert

{#IESS-createOrUpdateCIEnhanced_S_S_S__ul_wyg_3f1_njb}Weitere Informationen zu Ire und detailliertere Erklärungen der von dieser Methode verwendeten Daten finden Sie unter [Identifizierung und Abgleich (Ire)](https://www.servicenow.com/docs/access?context=ire&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US).

Weitere Informationen zur Erfassung von nicht-CMDB-Tabellen finden Sie unter [IRE support for non-CMDB tables](https://www.servicenow.com/docs/access?context=ire-support-non-cmdb-tables&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US).
{#IESS-createOrUpdateCIEnhanced_S_S_S__IRE-payload__entry__3}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_input}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_items}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_className}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry-display_values-ire}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_internal_id}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_lookup}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry-input_items_lookup_className}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_related}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry-input_items_related_className}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_items_settings}{#IESS-createOrUpdateCIEnhanced_S_S_S__items_set_skipReclassRestrictRules-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_items_settings_updateWithoutDowngrade}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_items_settings_updateWithoutSwitch}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_items_settings_updateWithoutUpgrade}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_items_sys_object_source_info}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_items_sys_object_source_info_source_feed}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_items_sys_object_source_info_source_name}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_items_sys_object_source_info_source_native_key}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_items_sys_object_source_info_source_recency_timestamp}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_values}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_referenceItems}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_referenceItems_referenced}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_referenceItems_referencedBy}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_referenceItems_referenceField}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_relations}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_relations_child}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_relations_child_id}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_relations_parent}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_relations_parent_id}{#IESS-createOrUpdateCIEnhanced_S_S_S__sys_rel_source_info-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__sys_rel_source_info-source_name-entry-ire}{#IESS-createOrUpdateCIEnhanced_S_S_S__sys_rel_source_into-source_feed-entry-ire}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_relations_type}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_options}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_options_deduplicate_payloads}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_options_generate_summary}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_options_partial_commits}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_options_partial_payloads}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_source}

| Name | Typ | Beschreibung |
|-|-|-|
| Eingabe | Zeichenfolge | Erforderlich. Eingabenutzlast. Eine JSON-formatierte Zeichenfolge von Konfigurationselementen, die hinzugefügt oder aktualisiert werden sollen. "input" { "items": [Array], "referenceItems": [Array], "relations": [Array] } |
| input.items | Objekt-Array | Elemente, die hinzugefügt oder aktualisiert werden sollen. "items": [ { "className": "String", "display_values": {Object}, "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ] |
| input.items.className | Zeichenfolge | Erforderlich. Klassen-/Tabellenname, sys_class_Name, des Konfigurationselements (CI), das erstellt oder aktualisiert werden soll. Dieser Wert kann beliebig sein CMDBKlasse/Tabelle, 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 in input.items.lookup.valuesParameter anstelle von 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 zugehörige Nutzlast. Dies kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein. |
| input.items.lookup | Objekt-Array | Gibt das Element der obersten Ebene an, das die Suche enthält (suchbasierte Identifizierung). Diese Datensätze werden verwendet, um das Konfigurationselement basierend auf einer Suchtabelle zu identifizieren, die einen Verweis auf cmdb_ci hat. 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 Konfigurationselements (CI), das erstellt oder aktualisiert werden soll. Dieser Wert kann beliebig sein CMDBKlasse/Tabelle, z. B. cmdb_Serial_number oder cmdb_ci_network_adapter. |
| input.items.lookup.internal_id | Zeichenfolge | Eindeutiger Suchelementbezeichner für die zugehörige 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 verschiedene Name-Wert-Paare für dasselbe CI haben. "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| input.items.lookup.sys_object_source_info.source_feed | Zeichenfolge | Wenn die Quelle mehrere Feeds haben kann, verwenden Sie dieses Feld, um den Namen des Feeds anzugeben, der dieses Element sendet. Die Datenquelle generiert diesen Feed-Namen. Es kann eine beliebige Zeichenfolge sein, die den Quell-Feed eindeutig identifiziert. |
| input.items.lookup.sys_object_source_info.source_name | Zeichenfolge | Datenquelle der CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. |
| input.items.lookup.sys_object_source_info.source_native_key | Zeichenfolge | Eindeutige Schlüssel-ID für das Element aus der Quelle. Die Datenquelle generiert diesen Schlüssel. Es kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. |
| input.items.lookup.sys_object_source_info.source_recency_timestamp | Zeichenfolge | UTC-Datum/Uhrzeit, zu der das Element gescannt wurde. Format: JJJJ-MM-TT hh:mm:ss |
| input.items.lookup.values | Objekt | Feldinformationen für das CI als Name-Wert-Paare, wobei der Name der Feldname ist. Beim Aktualisieren 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 | Objekt-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 Art von Datensätzen in diesem Array sein kann. Diese Datensätze werden verwendet, um Elemente basierend auf einer zugehörigen Tabelle hinzuzufügen, die einen Verweis auf das identifizierte CI enthält. Die zugehörige Tabelle kann cmdb_ci erweitern oder nicht. Diese Datensätze werden nicht zur Identifizierung des Konfigurationselements verwendet. "related" [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] |
| input.items.related.className | Zeichenfolge | Erforderlich. Klassen-/Tabellenname, sys_class_Name, des Konfigurationselements (CI), das erstellt oder aktualisiert werden soll. Dieser Wert kann beliebig sein CMDBKlasse/Tabelle, z. B. cmdb_Software_instance oder cmdb_key_value. |
| input.items.related.internal_id | Zeichenfolge | Eindeutiger Bezeichner für dieses zugehörige Element in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein. |
| input.items.related.sys_object_source_info | Objekt | Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle bildet. Verschiedene Quellen können verschiedene Name-Wert-Paare für dasselbe CI haben. "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| input.items.related.sys_object_source_info.source_feed | Zeichenfolge | Wenn die Quelle mehrere Feeds haben kann, verwenden Sie dieses Feld, um den Namen des Feeds anzugeben, der dieses Element sendet. Die Datenquelle generiert diesen Feed-Namen. Es kann eine beliebige Zeichenfolge sein, die den Quell-Feed eindeutig identifiziert. |
| input.items.related.sys_object_source_info.source_name | Zeichenfolge | Gibt die Datenquelle der CI-Informationen an. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. |
| input.items.related.sys_object_source_info.source_native_key | Zeichenfolge | Eindeutiger Schlüssel/ID aus der Quelle für das zugehörige Element. Die Datenquelle generiert diesen Schlüssel. Es kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. |
| input.items.related.sys_object_source_info.source_recency_timestamp | Zeichenfolge | UTC-Datum und -Uhrzeit, zu der das Element gescannt wurde. Format: `JJJJ-MM-TT hh:mm:ss ` |
| input.items.related.values | Objekt | Felder, die für dieses zugehörige Element als Name/Wert-Paare erstellt oder aktualisiert werden sollen, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_ID sein Wenn Sie den Anzeigewert anstelle der sys_ID für Referenzfelder verwenden möchten, übergeben Sie diese Informationen in einem display_valuesObjekt anstelle von in valuesObjekt. 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 die Arten der zulässigen Updates definieren. "settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean } |
| input.items.settings.skipReclassificationRestrictionRules | Boolean | Kennzeichnung, die angibt, ob Ire die Reklassifizierungseinschränkungsregel nicht ausführen soll, die der Klasse für das Nutzlastelement entspricht. Gültige Werte: * Wahr: Ausführung der Regel wird übersprungen. * Falsch: Führen Sie die Regel aus. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_tl4_qwp_snb} Standard: Falsch |
| input.items.settings.updateWithoutDowngrade | Boolean | Kennzeichnung, die angibt, ob Update und Downgrade für dieses Element zulässig sind. Gültige Werte: * Wahr: Aktualisieren Sie das Element, ein Downgrade ist jedoch nicht zulässig. * Falsch: Sowohl Elementaktualisierung als auch Downgrade sind zulässig. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_jdl_pfb_sjb} Standard: Falsch |
| input.items.settings.updateWithoutSwitch | Boolean | Kennzeichnung, die angibt, ob das Element aktualisiert und die Klasse gewechselt werden kann. Gültige Werte: * Wahr: Aktualisieren Sie das Element, aber Klassenwechsel ist nicht zulässig. * Falsch: Sowohl Elementaktualisierung als auch Klassenwechsel sind zulässig. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_h4p_2gb_sjb} Standard: Falsch |
| input.items.settings.updateWithoutUpgrade | Boolean | Kennzeichnung, die angibt, ob Aktualisierung und Upgrade für dieses Element zulässig sind. Gültige Werte: * Wahr: Aktualisieren Sie das Element, aber ein Upgrade ist nicht zulässig. * Falsch: Elementaktualisierung und Upgrade sind zulässig. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_vqx_xfb_sjb} Standard: Falsch |
| 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 eine beliebige Zeichenfolge sein, die den Quell-Feed eindeutig identifiziert. |
| input.items.sys_object_source_info.source_name | Zeichenfolge | Datenquelle der CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. |
| input.items.sys_object_source_info.source_native_key | Zeichenfolge | Eindeutiger Schlüssel/ID für das Element aus der Quelle. Die Datenquelle generiert diesen Schlüssel. Es kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. |
| input.items.sys_object_source_info.source_recency_timestamp | Zeichenfolge | UTC-Datum und -Uhrzeit, zu der das Element gescannt wurde. Format: JJJJ-MM-TT hh:mm:ss |
| input.items.values | Objekt | Felder, die für dieses zugehörige Element als Name/Wert-Paare erstellt oder aktualisiert werden sollen, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_ID sein Wenn Sie den Anzeigewert anstelle der sys_ID für Referenzfelder verwenden möchten, übergeben Sie diese Informationen in einem display_valuesObjekt anstelle von in valuesObjekt. 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" } |
| Eingabe.referenceItems | Objekt-Array | Liste, die Verweise zwischen Elementen in der Eingabenutzlast definiert. "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ] |
| Eingabe.referenzierenElemente.referenziert | Zeichenfolge | Die internal_idDefiniert für das Element, auf das von einem anderen Element verwiesen wird. |
| Eingabe.referenceItems.referencedBy | Zeichenfolge | Die internal_idDefiniert für das Element, das auf ein anderes Element verweist. |
| Eingabe.referenceItems.referenceField | Zeichenfolge | Name des Referenzfelds in der Klasse/Tabelle für referencedByElement. |
| Eingabe.Beziehungen | Objekt-Array | 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) mit definieren parentUnd childName-Wert-Paare, deren Werte Elementindizes aus der Nutzlast darstellen itemsArray. "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 parent_idUnd child_idSchlüssel-Wert-Paare, wobei Werte darstellen internal_idWerte, die für diese Elemente definiert sind. "relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ] {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_s1s_phb_nlb} |
| input.relations.child | Nummer | Ganzzahliger Index des CI-Objekts in itemsArray, das das untergeordnete Element in der Beziehung darstellt (items, items.related oder items.search) |
| input.relations.child_id | Zeichenfolge | Die internal_idDes untergeordneten Elements in der Beziehung (items, items.related oder items.search.) |
| Eingabe.Beziehungen.übergeordnetes Element | Nummer | Ganzzahliger Index des übergeordneten Elements in itemsArray (items, items.related oder items.search.) |
| Eingabe.Beziehungen.parent_ID | Zeichenfolge | Die internal_idDes übergeordneten Elements in der Beziehung (items, items.related oder items.Lookup.) |
| input.relations.sys_rel_source_info | Objekt | Discovery-Quellinformationen für die Beziehung. Für Beziehungen ohne Abhängigkeiten werden diese Informationen in der Tabelle „Beziehungsquellen" \[sys_rel_Source\] gespeichert (nicht beibehalten für IdentifyCIErweitert() Oder IdentifyCI() Methoden.) Datentyp: Objekt "sys_rel_source_info": { "source_name": "String", "source_feed": "String" } |
| input.relations.sys_rel_source_info.source_name | Zeichenfolge | Name der Discovery-Quelle. Standard: Discovery-Quelle im API-Methodenparameter übergeben. |
| input.relations.sys_rel_source_info.source_feed | Zeichenfolge | Jede Zeichenfolge, die eine untergeordnete Discovery/Scan 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 CI-Beziehungstyp-Tabelle \[cmdb_rel_type\] sein. |
| Optionen | Objekt | Optional, {} oder Null muss übergeben werden. Optionen zum Aktivieren oder Deaktivieren von Funktionen. Hinweis: Standardmäßig oder wenn partial_payloadsIst auf „wahr" festgelegt, beides partial_commitsUnd deduplicate_payloadsSind aktiviert, auch wenn sie auf „falsch" festgelegt sind, da diese Funktionen für die Funktionalität von Teilnutzlasten von entscheidender Bedeutung sind. "options": { "deduplicate_payloads": Boolean, "generate_summary": Boolean, "partial_commits": Boolean, "partial_payloads": Boolean, "skip_updating_last_scan_to_now": Boolean, "skip_updating_source_last_discovered_to_now": Boolean } |
| options.deduplicate_payloads | Boolean | Kennzeichnung, die angibt, ob doppelte Elemente zusammengeführt oder als Fehler betrachtet werden. Gültige Werte: * Wahr: Führen Sie doppelte Elemente zusammen. * Falsch: Betrachten Sie doppelte Elemente als Fehler. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_xv5_bws_mjb} Standard: Wahr |
| Options.generate_summary | Boolean | Kennzeichnung, die angibt, ob die zurückgegebenen Ergebnisse Zusammenfassungsinformationen enthalten. Details der zurückgegebenen Zusammenfassungsinformationen finden Sie unter \<String\>.summaryIn der Tabelle „Ergebnisse zurückgeben". Gültige Werte: * Wahr: Zusammenfassungsinformationen einschließen. * Falsch: Keine Zusammenfassungsinformationen einschließen. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_w5w_mws_mjb} Standard: Falsch |
| Options.partial_Commits | Boolean | Kennzeichnung, die angibt, ob die teilweise Commit-Unterstützung aktiviert ist. Weitere Informationen zu partiellen Commits finden Sie unter [Erweiterte Ire-Funktionen](https://www.servicenow.com/docs/access?context=ire&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US). Gültige Werte: * Wahr: Teilweise Commit aktiviert. * Falsch: Teilweise Commit deaktiviert. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_k3p_wvs_mjb} Standard: Wahr |
| Options.part_Payloads | Boolean | Kennzeichnung, die angibt, ob die Unterstützung der Teilnutzlast aktiviert ist. Weitere Informationen zu Teilnutzlasten finden Sie unter [Erweiterte Ire-Funktionen](https://www.servicenow.com/docs/access?context=ire&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US)Und [Erstellen Sie eine Ire-Datenquellenregel](https://www.servicenow.com/docs/access?context=create-ire-data-source-rule&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US). Gültige Werte: * Wahr: Teilnutzlast aktiviert. * Falsch: Teilnutzlast deaktiviert. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_tzb_tvs_mjb} Standard: Wahr |
| options.skip_updating_last_scan_to_now | Boolean | Kennzeichnung, die angibt, ob die Aktualisierung des Last_Scan-Zeitfelds der sys_object_Source übersprungen werden soll. Gültige Werte: * Wahr: Wenn source_recency_timestampParameter wird nicht übergeben sys_object_source_info, Aktualisieren Sie nicht das Zeitfeld „Last_Scan" von sys_object_Source. * Falsch: Aktualisiert das Zeitfeld „Last_Scan" von sys_object_Source. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_rhk_4tx_brb} Standard: Verwendet den Wert in der Systemeigenschaft „glide.identification_engine.skip_updating_last_scan_to_now". |
| options.skip_updating_source_last_discovered_to_now | Boolean | Kennzeichnung, die angibt, ob die Aktualisierung der Felder „Discovery_Source" und „Last_detected" in der Tabelle „Konfigurationselement" \[cmdb_ci\] übersprungen werden soll. Gültige Werte: * Wahr: Wenn „Last_detected" in den Nutzlastelementwerten nicht angegeben ist, aktualisieren Sie die Felder „Discovery_Source" und „Last_detected" nicht. * Falsch: Aktualisieren Sie die Felder „Discovery_Source" und „Last_detected". 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 : 3. Parameter]

{#IESS-createOrUpdateCIEnhanced_S_S_S__table_vyh_fvh_sjb} {#IESS-createOrUpdateCIEnhanced_S_S_S__table_q4n_dvx_3lb__entry__2}{#IESS-createOrUpdateCIEnhanced_S_S_S__row-string-enhanced}{#IESS-createOrUpdateCIEnhanced_S_S_S__row_return_additionalCommittedItems}{#IESS-createOrUpdateCIEnhanced_S_S_S__row-return-additionalCommittedItems-className}{#IESS-createOrUpdateCIEnhanced_S_S_S__row-return-additionalCommittedItems-errorCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry-errors}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry-errors-error}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry-errors-message}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_identificationAttempts-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_idAtt_attemptResult-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_idAtt_attributes-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_idAtt_hybridEntryCIAtt-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_idAtt_identifierName-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_identifierEntrySysId-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_identifierEntrySysId2-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_inputIndices-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_markers-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_mergedPayloads-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_operation-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_sysId-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_warnings-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_warnings_error-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommItems_warnings_message-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_additionalCommittedRelations}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommRel_className-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommRel_errorCount-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommRel_errors-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommRel_errors_error-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommRel_errors_message-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommRel_inputIndices-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommRel_markers-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommRel_mergedPayloadIds-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__addCommRel_operations-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary_class_name_hasError}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary_class_name_hasWarning}{#IESS-createOrUpdateCIEnhanced_S_S_S__items-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_additionalRelatedItems}{#IESS-createOrUpdateCIEnhanced_S_S_S__items_addRelItems_className-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__items_addRelItems_inputIndices-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_additionalRelatedItems_mergedPayloadIds}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_additionalRelatedItems_operations}{#IESS-createOrUpdateCIEnhanced_S_S_S__items_addRelItems_sysId-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_className}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_items_duplicateIndices}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_errorCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_error}{#IESS-createOrUpdateCIEnhanced_S_S_S__items_errors_errors-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__items_errors_msg-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_identificationAttempts}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_identificationAttempts_attemptResult}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_identificationAttempts_attributes}{#IESS-createOrUpdateCIEnhanced_S_S_S__items_identAtt_hyEntCiAtt-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_identificationAttempts_identifierName}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_identificationAttempts_searchOnTable}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_identifierEntrySysId}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_incompleteSysId}{#IESS-createOrUpdateCIEnhanced_S_S_S__items_info-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__items_info_code-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__items_info_message-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__items_info_ruleSysId-entry-IRE}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_items_inputIndices}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_maskedAttributes}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_operation}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_partialSysId}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_relatedItems}{#IESS-createOrUpdateCIEnhanced_S_S_S__row_return_item_relatedItems_className}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_relatedItems_errors}{#IESS-createOrUpdateCIEnhanced_S_S_S__row_return_item_relatedItems_errors_error}{#IESS-createOrUpdateCIEnhanced_S_S_S__row_return_item_relatedItems_errors-message}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_relatedItems_errorCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_relatedItems_inputIndices}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_relatedItems_inputIndices.mainIndex}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_relatedItems_inputIndices.subIndex}{#IESS-createOrUpdateCIEnhanced_S_S_S__row_return_item_relatedItems_mergedPayloadIds}{#IESS-createOrUpdateCIEnhanced_S_S_S__row_return_item_relatedItems_operation}{#IESS-createOrUpdateCIEnhanced_S_S_S__row_return_item_relatedItems_sysId}{#IESS-createOrUpdateCIEnhanced_S_S_S__row_return_item_relatedItems_warningCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__row_return_item_relatedItems_wrnings}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_relatedSysIds}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_item_sys_id}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_relations}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_relations_className}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_relations_errorsCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_relations_errors}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_relations_incompleteSysId}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_relations_inputIndices}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_relations_operation}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_relations_partialSysId}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_relations_sys_id}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary_class_name}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary_class_name_additionalInsertedItemCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary_class_name_errorCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary_class_name_incompleteItemCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary_class_name_insertedItemCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary_class_name_partialItemCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__row_return_summary_class_name_skippedItemCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary_class_name_unchangedItemCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary_class_name_updatedItemCount}{#IESS-createOrUpdateCIEnhanced_S_S_S__entry_return_summary_class_name_warningCount}

| 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ätzliche KommittedElemente | Liste der CIs, die während der Ire-Verarbeitung der aktuellen Nutzlast bestätigt wurden, aber in der aktuellen Eingabenutzlast nicht vorhanden waren. Datentyp: Array von Objekten "additionalCommittedItems": [ { "className": "String", "errorCount": Number, "operation": "String", "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "sysId": "String" } ] |
| \<String\>.additionalCommittedItems.className | SYS_class_Name dieses zusätzlichen CI. Datentyp: Zeichenfolge |
| \<String\>.additionalCommittedItems.Fehleranzahl | Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind. Datentyp: Zahl |
| \<String\>.additionalCommittedItems.error | Array von Objekten, das Fehler beschreibt, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind. Datentyp: Array "errors": [ { "error": "String", "message": "String" } ] |
| \<String\>.additionalCommittedItems.error.error | Typ des beim Verarbeiten des zusätzlichen CI aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| \<String\>.additionalCommittedItems.error.message | Beim Verarbeiten des zusätzlichen CI ist eine Fehlermeldung aufgetreten. Datentyp: Zeichenfolge |
| \<String\>.ZusätzlichCommittedItems.identifikationAttempts | Array von Objekten, in denen jedes Objekt einen Versuch beschreibt, dieses zusätzliche CI zu identifizieren. Datentyp: Array von Objekten "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ] |
| \<String\>.ZusätzlichCommittedElemente.IdentifikationVersuchen.Versuch.Weiterleiten | Ergebnis dieses zusätzlichen CI-Identifizierungsversuchs. Datentyp: Zeichenfolge Mögliche Werte: * ÜBEREINSTIMMEND: Identifizierung erfolgreich. In der Bezeichnerregeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmte. * MULTI_MATCH: Identifizierung mit Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichnerregeltabelle beim Abgleich mit den angegebenen Attributen gefunden. * NO_MATCH: Identifizierung fehlgeschlagen. In der Bezeichnerregeltabelle wurde kein CI gefunden, das den angegebenen Attributen entsprach. * ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für diese Bezeichnerregeltabellensuche erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_axc_bxx_glb} |
| \<String\>.additionalCommittedItems.identifikationAttempts.Attribute | CI-Bezeichnereintragsattribute, die während dieses zusätzlichen CI-Identifizierungsversuchs verwendet werden. Datentyp: Array Attributnamen und -Typen hängen von den Anforderungstext-Daten und dem verwendeten Bezeichner ab, z. B.: "attributes": [ "serial_number": "String", "serial_number_type": "String", ] |
| \<String\>.additionalCommittedItems.identificationAttempts.hybridEntryCiAttribute | Array von CI-Bezeichnereintragsattributen, die während dieses zusätzlichen CI-Identifizierungsversuchs verwendet werden. Datentyp: Array Attributnamen und -Typen hängen von den Anforderungstext-Daten und dem verwendeten Bezeichner ab, z. B.: "hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ] |
| \<String\>.additionalCommittedItems.identificationAttempts.identifierName | Bezeichnerregel, die für diesen zusätzlichen CI-Identifizierungsversuch verwendet wird. Datentyp: Zeichenfolge |
| \<String\>.additionalCommittedItems.identificationAttempts.searchOnTable | Name der Tabelle, die für diesen zusätzlichen CI-Identifizierungsversuch gesucht wurde. Datentyp: Zeichenfolge |
| \<String\>.zusätzlichCommittedItems.identifierEintragungSysId | SYS_ID für die Bezeichnerregel, die zur Identifizierung dieses zusätzlichen CI verwendet wird. Bedeutende Werte -- Unbekannt: Identifizierung dieses zusätzlichen CI fehlgeschlagen. Details siehe errors. |
| \<String\>.additionalCommittedItems.inputIndices | Indexwerte für CIs aus dem Anforderungstext itemsArray, das diesem zusätzlichen CI entspricht. Datentyp: Array von Zahlen "inputIndices": [ { Number } ] |
| \<String\>.additionalCommittedItems.Markers | Markerwerte für interne Verwendung. Datentyp: Array "markers": [] |
| \<String\>.additionalCommittedItems.mergedNutzlasten | SYS_ID-Werte für Teilnutzlasten aus der Tabelle „Teilnutzlasten für CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung dieses zusätzlichen CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| \<String\>.additionalCommittedItems.Vorgang | Vorgang, der für dieses zusätzliche CI ausgeführt wird. 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. * AKTUALISIEREN: Ein vorhandenes CI in der Zieltabelle wird aktualisiert. * UPDATE_WITH_DOWNGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine generischere Klasse (Vorgängerklasse) geändert. * UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgänger- oder untergeordnete Klasse ist. * UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine speziellere Klasse (untergeordnete Klasse) geändert. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_dwt_qwx_glb} |
| \<String\>.additionalCommittedItems.sysId | SYS_ID für dieses zusätzliche CI durch Identifizierung gefunden. Datentyp: Zeichenfolge Bedeutende Werte -- Unbekannt: Identifizierung dieses zusätzlichen CI fehlgeschlagen. Details siehe errors. |
| \<String\>.zusätzlichCommittedItems.Warnungen | Beschreibung der Warnungen, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind. Datentyp: Array von Objekten "warnings": [ { "error": "String", "message": "String" } ] |
| \<String\>.additionalCommittedItems.Warnungen.Fehler | Typ der Warnung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist. Datentyp: Zeichenfolge |
| \<String\>.additionalCommittedElemente.Warnungen.Nachricht | Warnmeldung beim Verarbeiten dieses zusätzlichen CI aufgetreten. Datentyp: Zeichenfolge |
| \<String\>.ZusätzlichZusammenarbeitenBeziehungen | Beschreibung eines abhängigen Beziehungs-CI, das nicht im Anforderungstext enthalten war relationsListe zum Einfügen oder Aktualisieren. Datentyp: Array von Objekten "additionalCommittedRelations": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String" } ] |
| \<String\>.zusätzlichZusammenarbeitenBeziehungen.className | Der sys_class_Name dieses zusätzlichen abhängigen Beziehungs-CI. Datentyp: Zeichenfolge Nur unterstützter Wert: cmdb_rel_ci: Die CI-Beziehungstabelle. |
| \<String\>.zusätzlichZusammenarbeitenBeziehungen.Fehleranzahl | Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Zahl |
| \<String\>.zusätzlichZusammenarbeitenBeziehungen.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ätzlichenCommittedBeziehungen.error.error | Typ des beim Verarbeiten des zusätzlichen abhängigen Beziehungs-CI aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| \<String\>.zusätzlichZusammenarbeitenBeziehungen.Fehler.Nachricht | Beim Verarbeiten dieses zusätzlichen abhängigen Beziehungs-CI ist eine Fehlermeldung aufgetreten. Datentyp: Zeichenfolge |
| \<String\>.additionalCommittedRelations.inputIndices | Indexwerte für abhängige Beziehungs-CI-Objekte im Anforderungstext relationsArray, das diesem zusätzlichen abhängigen Beziehungs-CI entspricht. Datentyp: Array "inputIndices": [ Number ] |
| \<String\>.zusätzlichZusammenarbeitenBeziehungen.Markierungen | Markerwerte für interne Verwendung. Datentyp: Array "markers": [] |
| \<String\>.zusätzlichUnternehmensbeziehungen.mergedPayloadIds | SYS_ID-Werte für Teilnutzlasten aus der Tabelle „partielle Nutzlasten des CMDB-Ire \[cmdb_ire_partial_payloads\]", die für dieses CI zusammengeführt wurden.die während der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| \<String\>.zusätzlichCommittedBeziehungen.Vorgang | Vorgang, der für das zusätzliche abhängige Beziehungs-CI ausgeführt wurde. Mögliche Werte: * EINFÜGEN: Das abhängige Beziehungs-CI wird als neuer Datensatz in die Zieltabelle eingefügt. * INSERT_AS_INPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle „unvollständige Nutzlasten für CMDB-Ire \[cmdb_ire_incomplete_payloads\] eingefügt. * INSERT_AS_PARTIAL: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle „partielle Ire-Nutzlasten" \[cmdb_ire_partial_payloads\] eingefügt. * NO_CHANGE: Für das abhängige Beziehungs-CI wird kein Vorgang ausgeführt. * AKTUALISIEREN: Ein vorhandenes abhängiges Beziehungs-CI in der Zieltabelle wird aktualisiert. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_ltk_vxx_glb} Datentyp: Zeichenfolge |
| \<String\>.hasError | Kennzeichnung, die angibt, ob ein Element oder eine Beziehung Fehler aufweist. Datentyp: Boolescher Wert |
| \<String\>.hasWarnung | Kennzeichnung, die angibt, ob ein Element oder eine Beziehung Warnungen aufweist. Datentyp: Boolescher Wert |
| \<String\>.Elemente | 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.additionalRelatedItems | Informationen zu zusätzlichen Suchelementen und zugehörigen Elementen, die verarbeitet, 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.additionalRelatedItems.className | Klassen-/Tabellenname (sys_class_Name) des CI, das erstellt oder aktualisiert wurde. Datentyp: Zeichenfolge |
| \<String\>.items.additionalRelatedItems.inputIndices | Indexwerte für CIs aus dem Anforderungstext itemsArray, das diesem zugehörigen Element entspricht. Datentyp: Array von Zahlen |
| \<String\>.items.additionalRelatedItems.mergedPayloadIds | Liste der sys_IDs der Teilnutzlasten, die mit dem zugehörigen Element zusammengeführt wurden. Datentyp: Array Tabelle: Partielle CMDB-Ire-Nutzlasten \[cmdb_ire_partial_payloads\] |
| \<String\>.items.additionalRelatedItems.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. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_rk4_fxz_mjb} Datentyp: Zeichenfolge |
| \<String\>.items.additionalRelatedItems.sysId | SYS_ID des CI, das aktualisiert oder erstellt wurde. Datentyp: Zeichenfolge |
| \<String\>.Items.className | Klassen-/Tabellenname (sys_class_Name) des CI, das erstellt oder aktualisiert wurde. Datentyp: Zeichenfolge |
| \<String\>.items.duplicateIndices | Liste der Indizes von CIs, die Duplikate des aktuellen Elements sind. Datentyp: Array |
| \<String\>.items.Fehleranzahl | Anzahl der beim Verarbeiten des Elements aufgetretenen Fehler. Datentyp: Zahl |
| \<String\>.Elemente.Fehler | Liste der Fehler, die bei der Verarbeitung dieses CI aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| \<String\>.Elemente.Fehler.Fehler | Typ des beim Verarbeiten des CI aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| \<String\>.Elemente.Fehler.Nachricht | Fehlermeldung, die dem Fehler zugeordnet ist. Datentyp: Zeichenfolge |
| \<String\>.items.identifikationVermutungen | Liste der Versuche, die zur Identifizierung der CIs unternommen wurden. Datentyp: Array von Objekten "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identifierName": "String", "searchOnTable": "String" } ] |
| \<String\>.Elemente.IdentifikationVersuchen.Versuch.Befolgen | Ergebnisse des Versuchs, das CI zu identifizieren. Mögliche Werte: * ÜBEREINSTIMMEND: Identifizierung erfolgreich. In der Bezeichnerregeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmte. * MULTI_MATCH: Identifizierung mit Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichnerregeltabelle beim Abgleich mit den angegebenen Attributen gefunden. * NO_MATCH: Identifizierung fehlgeschlagen. In der Bezeichnerregeltabelle wurde kein CI gefunden, das den angegebenen Attributen entsprach. * ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für diese Bezeichnerregeltabellensuche erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet. Datentyp: Zeichenfolge |
| \<String\>.items.identificationAttempts.attributes | Liste der CI-Bezeichnereintragsattribute, die während des Identifizierungsprozesses verwendet wurden. Datentyp: Array Attributnamen und -Typen hängen von den Anforderungstext-Daten und dem verwendeten Bezeichner ab, z. B.: "attributes": [ "serial_number": "String", "serial_number_type": "String", ] |
| \<String\>items.identificationAttempts.hybridEntryCiAttributes | Liste der CI-Bezeichnereintragsattribute, die während des Identifizierungsprozesses verwendet wurden. Datentyp: Array Attributnamen und -Typen hängen von den Anforderungstext-Daten und dem verwendeten Bezeichner ab, z. B.: "hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ] |
| \<String\>.items.identificationAttempts.identifierName | Bezeichnerregel, die für diesen CI-Identifizierungsversuch verwendet wird. Datentyp: Zeichenfolge |
| \<String\>.items.identificationAttempts.searchOnTable | Name der Tabelle, die während des Identifizierungsprozesses gesucht wird. Datentyp: Zeichenfolge |
| \<String\>.items.identifierEintragSysId | SYS_ID für die Bezeichnerregel, die zur Identifizierung 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 Nutzlasten für CMDB-Ire" \[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 * ÜBERSPRUNGEN_CLASS_SWITCH * ÜBERSPRUNGEN_CLASS_UPGRADE {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_pb2_dxp_snb} Datentyp: Zeichenfolge |
| \<String\>.items.info.message | Nachricht, die zusätzliche Einblicke in den Grund für das Überspringen der Neuklassifizierung bietet. Datentyp: Zeichenfolge |
| \<String\>.items.info.ruleSysId | SYS_ID der Reklassifizierungseinschränkungsregel, die abgeglichen wurde. Gilt nur, wenn Ire die Neuklassifizierung aufgrund der Reklassifizierungseinschränkungsregel überspringt. Dieser Wert ist leer, wenn die Neuklassifizierung aufgrund einer Nutzlast oder einer globalen Kennzeichnung übersprungen wird. Datentyp: Zeichenfolge |
| \<String\>.items.inputIndices | Indizes des entsprechenden Eingabe-CI. Für Elemente der obersten Ebene ist dies eine Liste von Ganzzahlen. Für zugehörige CIs oder Such-CIs ist dies eine Liste von JSON-Objekten. Datentyp: Array von Zahlen |
| \<String\>.items.maskedAttribute | Liste der Attribute, deren Aktualisierung durch eine nicht autorisierende Datenquelle wie von definiert übersprungen wurde [Abgleichsregeln](https://www.servicenow.com/docs/access?context=create-reconciliation-rule&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US). Datentyp: Array |
| \<String\>.Elemente.Vorgang | Vorgang, der stattgefunden hat. Mögliche Werte: * EINFÜGEN: Neues CI wurde in die Datenbank eingefügt. * INSERT_AS_INFILET: Element wurde in der cmdb_ire_incomplete_payloads-Tabelle gespeichert. * INSERT_AS_PARTIAL: Element wurde in der cmdb_ire_partial_payloads-Tabelle gespeichert. * UPDATE: Vorhandenes CI wurde aktualisiert. * UPDATE_WITH_DOWNGRADE: CI wurde aktualisiert, und die Klasse wurde in eine generischere Klasse (Vorgängerklasse) geändert. * UPDATE_WITH_SWITCH: CI wurde aktualisiert, und die Klasse wurde in eine Klasse geändert, die nicht Vorgänger- oder untergeordnet ist. * UPDATE_WITH_UPDRADE: CI wurde aktualisiert, und die Klasse wurde in eine speziellere Klasse (untergeordnete Klasse) geändert. {#IESS-createOrUpdateCIEnhanced_S_S_S__ul_wyd_hj5_mjb} Datentyp: Zeichenfolge |
| \<String\>.items.partialSysIds | Wenn das Element Fehler aufwies und als Teilnutzlast gespeichert wurde, enthält dieser Parameter die sys_ID des Teilnutzlastdatensatzes. Datentyp: Zeichenfolge |
| \<String\>.Elemente.zugehörigElemente | Liste der JSON-Objekte, die ein zugehöriges CI (Tabellensuche-CI) aus dem Anforderungstext beschreiben items.lookupArray. 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.error | Liste der Fehler, die während der Verarbeitung des zugehörigen Elements aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| \<String\>.items.relatedItems.error.error | Typ des beim Verarbeiten des zugehörigen Elements aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| \<String\>.items.relatedItems.error.message | Fehlermeldung, die dem Fehler zugeordnet ist. Datentyp: Zeichenfolge |
| \<String\>.items.relatedItems.Fehleranzahl | Anzahl der Fehler, die bei der Verarbeitung der zugehörigen Elemente erkannt wurden. 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 Nutzlasten für CMDB-Ire" \[cmdb_ire_incomplete_payloads\]. Datentyp: Zeichenfolge |
| \<String\>.items.relatedItems.inputIndices | Index des entsprechenden Eingabeelements. Für Elemente der obersten Ebene ist dies 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 Anforderungstext itemsArray, das dem übergeordneten CI des zugehörigen Elements entspricht. Datentyp: Zahl |
| \<String\>.items.relatedItems.inputIndices.subIndex | Indexwert aus dem Anforderungstext items.lookupArray, das dem zugehörigen Element entspricht. Datentyp: Zahl |
| \<String\>.items.relatedItems.mergedPayloadIds | Liste der sys_IDs der Teilnutzlasten, die während der Verarbeitung mit dem CI zusammengeführt wurden. Datentyp: Array |
| \<String\>.items.relatedItems.Vorgang | Vorgang, der stattgefunden hat. Mögliche Werte: * EINFÜGEN: Neues zugehöriges CI wurde in die Datenbank eingefügt. * INSERT_AS_INFILET: Element wurde in der cmdb_ire_incomplete_payloads-Tabelle gespeichert. * INSERT_AS_PARTIAL: Element wurde in der cmdb_ire_partial_payloads-Tabelle gespeichert. * NO_CHANGE: Es wurden keine zugehörigen CI-Änderungen vorgenommen. * UPDATE: Vorhandenes zugehöriges CI wurde aktualisiert. * UPDATE_WITH_DOWNGRADE: Das zugehörige CI wurde aktualisiert, und die Klasse wurde in eine generischere Klasse (Vorgängerklasse) geändert. * UPDATE_WITH_SWITCH: Zugehöriges CI wurde aktualisiert, und die Klasse wurde in eine Klasse geändert, die nicht Vorgänger- oder untergeordnetes Element ist. * UPDATE_WITH_UPDRADE: Zugehöriges CI wurde aktualisiert, und die Klasse wurde in eine speziellere Klasse (untergeordnete Klasse) geändert. Datentyp: Zeichenfolge |
| \<String\>.items.relatedItems.partialSysIds | Wenn das zugehörige Element Fehler aufwies und als Teilnutzlast gespeichert wurde, enthält dies eine Liste der sys_IDs der zugehörigen Datensätze in der Tabelle „teilweise Nutzlasten des 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 beim Verarbeiten der zugehörigen Elemente aufgetretenen Warnungen. Datentyp: Zahl |
| \<String\>.items.relatedItems.Warnungen | 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.Warnungsfehler | Typ der Warnung, die beim Verarbeiten des zugehörigen Elements aufgetreten ist. Datentyp: Zeichenfolge |
| \<String\>.items.relatedItems.Warnungsnachricht | Nachricht, die der Warnung zugeordnet ist. Datentyp: Zeichenfolge |
| \<String\>.items.relatedSysIds | Liste der sys_ID-Werte der CIs, die während 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 Anforderungstext relationsArray. 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. Nur 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 beim Verarbeiten des abhängigen Beziehungs-CI aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| \<String\>.Beziehungen.Fehler.Nachricht | Fehlermeldung beim Verarbeiten dieses abhängigen Beziehungs-CI aufgetreten. Datentyp: Zeichenfolge |
| \<String\>.relations.incompleteSysIds | Wenn die Beziehung Fehler aufwies und als unvollständige Nutzlast gespeichert wurde, ist dieser Wert die sys_ID des Datensatzes in der Tabelle „unvollständige Nutzlasten für CMDB-Ire" \[cmdb_ire_incomplete_payloads\]. Datentyp: Zeichenfolge |
| \<String\>.relations.inputIndices | Indizes für die abhängigen Beziehungs-CI-Objekte im Anforderungstext relationsArray, das diesem abhängigen Beziehungs-CI entspricht. Datentyp: Array |
| \<String\>.Beziehungen.Vorgang | Typ des ausgeführten Vorgangs. Mögliche Werte: * EINFÜGEN: Das abhängige Beziehungs-CI wurde als neuer Datensatz in die Zieltabelle eingefügt. * INSERT_AS_INPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „unvollständige Nutzlasten für CMDB-Ire" \[cmdb_ire_incomplete_payloads\] eingefügt. * INSERT_AS_PARTIAL: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „partielle 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 Teilnutzlast gespeichert wurde, ist dieser Wert die sys_ID des Datensatzes in der Tabelle „teilweise Nutzlasten des 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\>.Summary.\<class_name\>.additionalInsertedItemCount | Anzahl der Elemente, die aufgrund der Verarbeitung von Teilnutzlasten eingefügt wurden. Datentyp: Zahl |
| \<String\>.Summary.\<class_name\>.Fehleranzahl | Anzahl der bei der Verarbeitung von Elementen aufgerufenen Fehler. Datentyp: Zahl |
| \<String\>.Summary.\<class_name\>.incomplete Elementanzahl | Anzahl der Elemente, die in die Tabelle „unvollständige Nutzlasten für CMDB-Ire" \[cmdb_ire_incomplete_payloads\] eingefügt wurden. Datentyp: Zahl |
| \<String\>.Summary.\<class_name\>.insertedElementanzahl | Anzahl der erstellten Elemente. Datentyp: Zahl |
| \<String\>.Summary.\<class_name\>.partialElementanzahl | Anzahl der in der Tabelle „Teilnutzlast" \[cmdb_ire_partial_payloads\] gespeicherten Elemente. Datentyp: Zahl |
| \<String\>.Summary.\<class_name\>.skippedItemCount | Anzahl der übersprungenen Elemente. Datentyp: Zahl |
| \<String\>.Summary.\<class_name\>.unchangedElementanzahl | Anzahl der Elemente, die Einträge enthielten, aber nicht geändert wurden. Datentyp: Zahl |
| \<String\>.Summary.\<class_name\>.updatedItemCount | Anzahl der aktualisierten Elemente. Datentyp: Zahl |
| \<String\>.Summary.\<class_name\>.warningCount | Anzahl der Elemente, die bei der Verarbeitung eine Warnung generiert haben. Datentyp: Zahl |
[Tabelle : 4. Rückgaben]

{#IESS-createOrUpdateCIEnhanced_S_S_S__table_q4n_dvx_3lb}  
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": []
    }

## IdentifikationEngine -- identifyCI(Zeichenfolge jsonString) {#ariaid-title4}

Bestimmt den Vorgang (Einfügen/Aktualisieren), der mit der angegebenen Nutzlast ausgeführt werden soll, ohne den Vorgang in der Datenbank zu bestätigen.
Dies funktioniert genau wie CreateOrUpdateCI() , Aber das Ergebnis wird nicht bestätigt.
{#IESS-identifyCI_S__id_mqd_n1t_pyb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| JsonString | Zeichenfolge | Eine JSON-formatierte Zeichenfolge von Konfigurationselementen, die hinzugefügt oder aktualisiert werden sollen. Jede Eingabezeichenfolge hat das Format „Elemente: \[{}\], Beziehungen:\[{}\]", wobei jedes Element innerhalb der Elemente- und Beziehungslisten Name-Wert-Paare enthält. Die möglichen Name-Wert-Paare in der Elementliste sind: * Klassenname: SYS_class_Name des CI, das erstellt oder aktualisiert werden soll. * Suche:\[{}\]: 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 * Übergeordnetes Element: Index des übergeordneten Elements in der Abhängigkeitsbeziehung * Typ: Beziehungstyp. Dies ist einer der Namensfeldwerte aus der Tabelle „cmdb_rel_type". |
[Tabelle : 5. Parameter]

{#IESS-identifyCI_S__id_mqd_n1t_pyb} {#IESS-identifyCI_S__id_vn1_51t_pyb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Eine JSON-formatierte Zeichenfolge, die eine Liste von Ergebnissen ist. Jede Ergebniszeichenfolge hat das Format „Elemente: \[{}\], Beziehungen:\[{}\]", wobei jedes Element innerhalb der Elemente- und Beziehungslisten Name-Wert-Paare enthält. Die möglichen Name-Wert-Paare in der Elementliste sind: * Klassenname: SYS_class_Name für das CI, das aktualisiert oder erstellt wurde. * DuplicateIndices: Liste der Indizes von Elementen, die Duplikate des aktuellen Elements sind. * Fehler: Liste der Fehler im Format (Fehler, Nachrichtenzeichenfolge) * IdentifikationAttempts: Liste der Versuche. * Versuch: ÜBERSPRUNGEN, NO_MATCH, MATCHED, MULTI_MATCH. * Attribute: Attribute des Bezeichnereintrags, der während der Identifizierung verwendet wird. * Identifikationsname: CI-Bezeichner, zu dem dieser Identifier-Eintrag gehört. * SearchOnTable: Tabelle, die während des Identifizierungsprozesses gesucht wird. * IdentifierEntrySysId: SYS_ID des Bezeichnereintrags, der während des Abgleichs verwendet wird. * Vorgang: Auszuführender Vorgang, der einer der folgenden ist: * LÖSCHEN * EINFÜGEN * AKTUALISIEREN * UPDATE_WITH_DOWNGRADE * UPDATE_WITH_SWITCH * UPDATE_WITH_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. {#IESS-identifyCI_S__ul_axv_x4h_1t} Mögliche Name-Wert-Paare in der Beziehungsliste sind: * Klassenname: Klassenname des Beziehungs-CI und ist immer cmdb_rel_ci * Vorgang: Typ des Vorgangs: INSERT, UPDATE, NO_CHANGE * SysId: SYS_ID des eingefügten oder aktualisierten Beziehungs-CI {#IESS-identifyCI_S__ul_ajf_wzl_jt} |
[Tabelle : 6. Rückgaben]

{#IESS-identifyCI_S__id_vn1_51t_pyb}  
Im Folgenden wird gezeigt, wie ein Konfigurationselement neu klassifiziert wird.

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

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

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

Ausgabe:

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

## IdentifikationEngine -- identifyCIEnhanced (Zeichenfolgenquelle, Zeichenfolgeneingabe, Objektoptionen) {#ariaid-title5}

Bestimmt Configuration Management Database (CMDB)Vorgang (Einfügen/Aktualisieren), der mit der angegebenen Nutzlast (Anforderungstext) ausgeführt werden soll, ohne die Vorgänge in der Datenbank zu bestätigen.
Verwenden Sie diese Methode, um die Übermittlung einer Nutzlast zu simulieren.  
Diese Methode ähnelt der [IdentifikationEngine -- identifyCI(Zeichenfolge jsonString)](https://servicenow-prod.fluidtopics.net/4ZcQFI3j8bMdK9eaUkVVig#IESS-identifyCI_S "Bestimmt den Vorgang (Einfügen/Aktualisieren), der mit der angegebenen Nutzlast ausgeführt werden soll, ohne den Vorgang in der Datenbank zu bestätigen.")Methode, unterstützt jedoch auch die folgende Funktionalität:

* Teilnutzlasten
  * Gibt bei einem Element mit einer Warnung oder einem Fehler an, ob ein Elementvorgang „INSERT_AS_PART" oder „INSERT_UNVOLLSTÄNDIG" ist.
  * Gibt die sys_IDs von Teilnutzlasten zurück, die mit vorhandenen Teilnutzlasten zusammengeführt wurden.
  {#IESS-identifyCIEnhanced_S_S_O__ul_x4s_nvk_xlb}
* Unterstützt die Deduplizierungsfunktion der Nutzlast.
* Generiert eine Zusammenfassung.
{#IESS-identifyCIEnhanced_S_S_O__ul_scj_jvk_xlb}
{#IESS-identifyCIEnhanced_S_S_O__IRE-payload__entry__3}{#IESS-identifyCIEnhanced_S_S_O__entry_input}{#IESS-identifyCIEnhanced_S_S_O__entry_items}{#IESS-identifyCIEnhanced_S_S_O__entry_className}{#IESS-identifyCIEnhanced_S_S_O__entry-display_values-ire}{#IESS-identifyCIEnhanced_S_S_O__entry_internal_id}{#IESS-identifyCIEnhanced_S_S_O__entry_lookup}{#IESS-identifyCIEnhanced_S_S_O__entry-input_items_lookup_className}{#IESS-identifyCIEnhanced_S_S_O__entry_related}{#IESS-identifyCIEnhanced_S_S_O__entry-input_items_related_className}{#IESS-identifyCIEnhanced_S_S_O__entry_items_settings}{#IESS-identifyCIEnhanced_S_S_O__items_set_skipReclassRestrictRules-entry-IRE}{#IESS-identifyCIEnhanced_S_S_O__entry_items_settings_updateWithoutDowngrade}{#IESS-identifyCIEnhanced_S_S_O__entry_items_settings_updateWithoutSwitch}{#IESS-identifyCIEnhanced_S_S_O__entry_items_settings_updateWithoutUpgrade}{#IESS-identifyCIEnhanced_S_S_O__entry_items_sys_object_source_info}{#IESS-identifyCIEnhanced_S_S_O__entry_items_sys_object_source_info_source_feed}{#IESS-identifyCIEnhanced_S_S_O__entry_items_sys_object_source_info_source_name}{#IESS-identifyCIEnhanced_S_S_O__entry_items_sys_object_source_info_source_native_key}{#IESS-identifyCIEnhanced_S_S_O__entry_items_sys_object_source_info_source_recency_timestamp}{#IESS-identifyCIEnhanced_S_S_O__entry_values}{#IESS-identifyCIEnhanced_S_S_O__entry_referenceItems}{#IESS-identifyCIEnhanced_S_S_O__entry_referenceItems_referenced}{#IESS-identifyCIEnhanced_S_S_O__entry_referenceItems_referencedBy}{#IESS-identifyCIEnhanced_S_S_O__entry_referenceItems_referenceField}{#IESS-identifyCIEnhanced_S_S_O__entry_relations}{#IESS-identifyCIEnhanced_S_S_O__entry_relations_child}{#IESS-identifyCIEnhanced_S_S_O__entry_relations_child_id}{#IESS-identifyCIEnhanced_S_S_O__entry_relations_parent}{#IESS-identifyCIEnhanced_S_S_O__entry_relations_parent_id}{#IESS-identifyCIEnhanced_S_S_O__sys_rel_source_info-entry-IRE}{#IESS-identifyCIEnhanced_S_S_O__sys_rel_source_info-source_name-entry-ire}{#IESS-identifyCIEnhanced_S_S_O__sys_rel_source_into-source_feed-entry-ire}{#IESS-identifyCIEnhanced_S_S_O__entry_relations_type}{#IESS-identifyCIEnhanced_S_S_O__entry_options}{#IESS-identifyCIEnhanced_S_S_O__entry_options_deduplicate_payloads}{#IESS-identifyCIEnhanced_S_S_O__entry_options_generate_summary}{#IESS-identifyCIEnhanced_S_S_O__entry_options_partial_commits}{#IESS-identifyCIEnhanced_S_S_O__entry_options_partial_payloads}{#IESS-identifyCIEnhanced_S_S_O__entry_source}

| Name | Typ | Beschreibung |
|-|-|-|
| Eingabe | Zeichenfolge | Erforderlich. Eingabenutzlast. Eine JSON-formatierte Zeichenfolge von Konfigurationselementen, die hinzugefügt oder aktualisiert werden sollen. "input" { "items": [Array], "referenceItems": [Array], "relations": [Array] } |
| input.items | Objekt-Array | Elemente, die hinzugefügt oder aktualisiert werden sollen. "items": [ { "className": "String", "display_values": {Object}, "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ] |
| input.items.className | Zeichenfolge | Erforderlich. Klassen-/Tabellenname, sys_class_Name, des Konfigurationselements (CI), das erstellt oder aktualisiert werden soll. Dieser Wert kann beliebig sein CMDBKlasse/Tabelle, 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 in input.items.lookup.valuesParameter anstelle von 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 zugehörige Nutzlast. Dies kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein. |
| input.items.lookup | Objekt-Array | Gibt das Element der obersten Ebene an, das die Suche enthält (suchbasierte Identifizierung). Diese Datensätze werden verwendet, um das Konfigurationselement basierend auf einer Suchtabelle zu identifizieren, die einen Verweis auf cmdb_ci hat. 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 Konfigurationselements (CI), das erstellt oder aktualisiert werden soll. Dieser Wert kann beliebig sein CMDBKlasse/Tabelle, z. B. cmdb_Serial_number oder cmdb_ci_network_adapter. |
| input.items.lookup.internal_id | Zeichenfolge | Eindeutiger Suchelementbezeichner für die zugehörige 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 verschiedene Name-Wert-Paare für dasselbe CI haben. "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| input.items.lookup.sys_object_source_info.source_feed | Zeichenfolge | Wenn die Quelle mehrere Feeds haben kann, verwenden Sie dieses Feld, um den Namen des Feeds anzugeben, der dieses Element sendet. Die Datenquelle generiert diesen Feed-Namen. Es kann eine beliebige Zeichenfolge sein, die den Quell-Feed eindeutig identifiziert. |
| input.items.lookup.sys_object_source_info.source_name | Zeichenfolge | Datenquelle der CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. |
| input.items.lookup.sys_object_source_info.source_native_key | Zeichenfolge | Eindeutige Schlüssel-ID für das Element aus der Quelle. Die Datenquelle generiert diesen Schlüssel. Es kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. |
| input.items.lookup.sys_object_source_info.source_recency_timestamp | Zeichenfolge | UTC-Datum/Uhrzeit, zu der das Element gescannt wurde. Format: JJJJ-MM-TT hh:mm:ss |
| input.items.lookup.values | Objekt | Feldinformationen für das CI als Name-Wert-Paare, wobei der Name der Feldname ist. Beim Aktualisieren 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 | Objekt-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 Art von Datensätzen in diesem Array sein kann. Diese Datensätze werden verwendet, um Elemente basierend auf einer zugehörigen Tabelle hinzuzufügen, die einen Verweis auf das identifizierte CI enthält. Die zugehörige Tabelle kann cmdb_ci erweitern oder nicht. Diese Datensätze werden nicht zur Identifizierung des Konfigurationselements verwendet. "related" [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] |
| input.items.related.className | Zeichenfolge | Erforderlich. Klassen-/Tabellenname, sys_class_Name, des Konfigurationselements (CI), das erstellt oder aktualisiert werden soll. Dieser Wert kann beliebig sein CMDBKlasse/Tabelle, z. B. cmdb_Software_instance oder cmdb_key_value. |
| input.items.related.internal_id | Zeichenfolge | Eindeutiger Bezeichner für dieses zugehörige Element in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein. |
| input.items.related.sys_object_source_info | Objekt | Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle bildet. Verschiedene Quellen können verschiedene Name-Wert-Paare für dasselbe CI haben. "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| input.items.related.sys_object_source_info.source_feed | Zeichenfolge | Wenn die Quelle mehrere Feeds haben kann, verwenden Sie dieses Feld, um den Namen des Feeds anzugeben, der dieses Element sendet. Die Datenquelle generiert diesen Feed-Namen. Es kann eine beliebige Zeichenfolge sein, die den Quell-Feed eindeutig identifiziert. |
| input.items.related.sys_object_source_info.source_name | Zeichenfolge | Gibt die Datenquelle der CI-Informationen an. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. |
| input.items.related.sys_object_source_info.source_native_key | Zeichenfolge | Eindeutiger Schlüssel/ID aus der Quelle für das zugehörige Element. Die Datenquelle generiert diesen Schlüssel. Es kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. |
| input.items.related.sys_object_source_info.source_recency_timestamp | Zeichenfolge | UTC-Datum und -Uhrzeit, zu der das Element gescannt wurde. Format: `JJJJ-MM-TT hh:mm:ss ` |
| input.items.related.values | Objekt | Felder, die für dieses zugehörige Element als Name/Wert-Paare erstellt oder aktualisiert werden sollen, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_ID sein Wenn Sie den Anzeigewert anstelle der sys_ID für Referenzfelder verwenden möchten, übergeben Sie diese Informationen in einem display_valuesObjekt anstelle von in valuesObjekt. 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 die Arten der zulässigen Updates definieren. "settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean } |
| input.items.settings.skipReclassificationRestrictionRules | Boolean | Kennzeichnung, die angibt, ob Ire die Reklassifizierungseinschränkungsregel nicht ausführen soll, die der Klasse für das Nutzlastelement entspricht. Gültige Werte: * Wahr: Ausführung der Regel wird übersprungen. * Falsch: Führen Sie die Regel aus. {#IESS-identifyCIEnhanced_S_S_O__ul_tl4_qwp_snb} Standard: Falsch |
| input.items.settings.updateWithoutDowngrade | Boolean | Kennzeichnung, die angibt, ob Update und Downgrade für dieses Element zulässig sind. Gültige Werte: * Wahr: Aktualisieren Sie das Element, ein Downgrade ist jedoch nicht zulässig. * Falsch: Sowohl Elementaktualisierung als auch Downgrade sind zulässig. {#IESS-identifyCIEnhanced_S_S_O__ul_jdl_pfb_sjb} Standard: Falsch |
| input.items.settings.updateWithoutSwitch | Boolean | Kennzeichnung, die angibt, ob das Element aktualisiert und die Klasse gewechselt werden kann. Gültige Werte: * Wahr: Aktualisieren Sie das Element, aber Klassenwechsel ist nicht zulässig. * Falsch: Sowohl Elementaktualisierung als auch Klassenwechsel sind zulässig. {#IESS-identifyCIEnhanced_S_S_O__ul_h4p_2gb_sjb} Standard: Falsch |
| input.items.settings.updateWithoutUpgrade | Boolean | Kennzeichnung, die angibt, ob Aktualisierung und Upgrade für dieses Element zulässig sind. Gültige Werte: * Wahr: Aktualisieren Sie das Element, aber ein Upgrade ist nicht zulässig. * Falsch: Elementaktualisierung und Upgrade sind zulässig. {#IESS-identifyCIEnhanced_S_S_O__ul_vqx_xfb_sjb} Standard: Falsch |
| 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 eine beliebige Zeichenfolge sein, die den Quell-Feed eindeutig identifiziert. |
| input.items.sys_object_source_info.source_name | Zeichenfolge | Datenquelle der CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. |
| input.items.sys_object_source_info.source_native_key | Zeichenfolge | Eindeutiger Schlüssel/ID für das Element aus der Quelle. Die Datenquelle generiert diesen Schlüssel. Es kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. |
| input.items.sys_object_source_info.source_recency_timestamp | Zeichenfolge | UTC-Datum und -Uhrzeit, zu der das Element gescannt wurde. Format: JJJJ-MM-TT hh:mm:ss |
| input.items.values | Objekt | Felder, die für dieses zugehörige Element als Name/Wert-Paare erstellt oder aktualisiert werden sollen, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_ID sein Wenn Sie den Anzeigewert anstelle der sys_ID für Referenzfelder verwenden möchten, übergeben Sie diese Informationen in einem display_valuesObjekt anstelle von in valuesObjekt. 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" } |
| Eingabe.referenceItems | Objekt-Array | Liste, die Verweise zwischen Elementen in der Eingabenutzlast definiert. "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ] |
| Eingabe.referenzierenElemente.referenziert | Zeichenfolge | Die internal_idDefiniert für das Element, auf das von einem anderen Element verwiesen wird. |
| Eingabe.referenceItems.referencedBy | Zeichenfolge | Die internal_idDefiniert für das Element, das auf ein anderes Element verweist. |
| Eingabe.referenceItems.referenceField | Zeichenfolge | Name des Referenzfelds in der Klasse/Tabelle für referencedByElement. |
| Eingabe.Beziehungen | Objekt-Array | 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) mit definieren parentUnd childName-Wert-Paare, deren Werte Elementindizes aus der Nutzlast darstellen itemsArray. "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 parent_idUnd child_idSchlüssel-Wert-Paare, wobei Werte darstellen internal_idWerte, die für diese Elemente definiert sind. "relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ] {#IESS-identifyCIEnhanced_S_S_O__ul_s1s_phb_nlb} |
| input.relations.child | Nummer | Ganzzahliger Index des CI-Objekts in itemsArray, das das untergeordnete Element in der Beziehung darstellt (items, items.related oder items.search) |
| input.relations.child_id | Zeichenfolge | Die internal_idDes untergeordneten Elements in der Beziehung (items, items.related oder items.search.) |
| Eingabe.Beziehungen.übergeordnetes Element | Nummer | Ganzzahliger Index des übergeordneten Elements in itemsArray (items, items.related oder items.search.) |
| Eingabe.Beziehungen.parent_ID | Zeichenfolge | Die internal_idDes übergeordneten Elements in der Beziehung (items, items.related oder items.Lookup.) |
| input.relations.sys_rel_source_info | Objekt | Discovery-Quellinformationen für die Beziehung. Für Beziehungen ohne Abhängigkeiten werden diese Informationen in der Tabelle „Beziehungsquellen" \[sys_rel_Source\] gespeichert (nicht beibehalten für IdentifyCIErweitert() Oder IdentifyCI() Methoden.) Datentyp: Objekt "sys_rel_source_info": { "source_name": "String", "source_feed": "String" } |
| input.relations.sys_rel_source_info.source_name | Zeichenfolge | Name der Discovery-Quelle. Standard: Discovery-Quelle im API-Methodenparameter übergeben. |
| input.relations.sys_rel_source_info.source_feed | Zeichenfolge | Jede Zeichenfolge, die eine untergeordnete Discovery/Scan 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 CI-Beziehungstyp-Tabelle \[cmdb_rel_type\] sein. |
| Optionen | Objekt | Optional, {} oder Null muss übergeben werden. Optionen zum Aktivieren oder Deaktivieren von Funktionen. Hinweis: Standardmäßig oder wenn partial_payloadsIst auf „wahr" festgelegt, beides partial_commitsUnd deduplicate_payloadsSind aktiviert, auch wenn sie auf „falsch" festgelegt sind, da diese Funktionen für die Funktionalität von Teilnutzlasten von entscheidender Bedeutung sind. "options": { "deduplicate_payloads": Boolean, "generate_summary": Boolean, "partial_commits": Boolean, "partial_payloads": Boolean, "skip_updating_last_scan_to_now": Boolean, "skip_updating_source_last_discovered_to_now": Boolean } |
| options.deduplicate_payloads | Boolean | Kennzeichnung, die angibt, ob doppelte Elemente zusammengeführt oder als Fehler betrachtet werden. Gültige Werte: * Wahr: Führen Sie doppelte Elemente zusammen. * Falsch: Betrachten Sie doppelte Elemente als Fehler. {#IESS-identifyCIEnhanced_S_S_O__ul_xv5_bws_mjb} Standard: Wahr |
| Options.generate_summary | Boolean | Kennzeichnung, die angibt, ob die zurückgegebenen Ergebnisse Zusammenfassungsinformationen enthalten. Details der zurückgegebenen Zusammenfassungsinformationen finden Sie unter \<String\>.summaryIn der Tabelle „Ergebnisse zurückgeben". Gültige Werte: * Wahr: Zusammenfassungsinformationen einschließen. * Falsch: Keine Zusammenfassungsinformationen einschließen. {#IESS-identifyCIEnhanced_S_S_O__ul_w5w_mws_mjb} Standard: Falsch |
| Options.partial_Commits | Boolean | Kennzeichnung, die angibt, ob die teilweise Commit-Unterstützung aktiviert ist. Weitere Informationen zu partiellen Commits finden Sie unter [Erweiterte Ire-Funktionen](https://www.servicenow.com/docs/access?context=ire&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US). Gültige Werte: * Wahr: Teilweise Commit aktiviert. * Falsch: Teilweise Commit deaktiviert. {#IESS-identifyCIEnhanced_S_S_O__ul_k3p_wvs_mjb} Standard: Wahr |
| Options.part_Payloads | Boolean | Kennzeichnung, die angibt, ob die Unterstützung der Teilnutzlast aktiviert ist. Weitere Informationen zu Teilnutzlasten finden Sie unter [Erweiterte Ire-Funktionen](https://www.servicenow.com/docs/access?context=ire&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US)Und [Erstellen Sie eine Ire-Datenquellenregel](https://www.servicenow.com/docs/access?context=create-ire-data-source-rule&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US). Gültige Werte: * Wahr: Teilnutzlast aktiviert. * Falsch: Teilnutzlast deaktiviert. {#IESS-identifyCIEnhanced_S_S_O__ul_tzb_tvs_mjb} Standard: Wahr |
| options.skip_updating_last_scan_to_now | Boolean | Kennzeichnung, die angibt, ob die Aktualisierung des Last_Scan-Zeitfelds der sys_object_Source übersprungen werden soll. Gültige Werte: * Wahr: Wenn source_recency_timestampParameter wird nicht übergeben sys_object_source_info, Aktualisieren Sie nicht das Zeitfeld „Last_Scan" von sys_object_Source. * Falsch: Aktualisiert das Zeitfeld „Last_Scan" von sys_object_Source. {#IESS-identifyCIEnhanced_S_S_O__ul_rhk_4tx_brb} Standard: Verwendet den Wert in der Systemeigenschaft „glide.identification_engine.skip_updating_last_scan_to_now". |
| options.skip_updating_source_last_discovered_to_now | Boolean | Kennzeichnung, die angibt, ob die Aktualisierung der Felder „Discovery_Source" und „Last_detected" in der Tabelle „Konfigurationselement" \[cmdb_ci\] übersprungen werden soll. Gültige Werte: * Wahr: Wenn „Last_detected" in den Nutzlastelementwerten nicht angegeben ist, aktualisieren Sie die Felder „Discovery_Source" und „Last_detected" nicht. * Falsch: Aktualisieren Sie die Felder „Discovery_Source" und „Last_detected". 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 : 7. Parameter]

{#IESS-identifyCIEnhanced_S_S_O__table_lqf_msb_jlb} {#IESS-identifyCIEnhanced_S_S_O__entry__170}{#IESS-identifyCIEnhanced_S_S_O__entry_return_additionalCommittedRelations}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary_class_name_hasError}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary_class_name_hasWarning}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_additionalRelatedItems}{#IESS-identifyCIEnhanced_S_S_O__items_addRelItems_className-entry-IRE}{#IESS-identifyCIEnhanced_S_S_O__items_addRelItems_inputIndices-entry-IRE}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_additionalRelatedItems_mergedPayloadIds}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_additionalRelatedItems_operations}{#IESS-identifyCIEnhanced_S_S_O__items_addRelItems_sysId-entry-IRE}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_className}{#IESS-identifyCIEnhanced_S_S_O__entry_return_items_duplicateIndices}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_errorCount}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_error}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_identificationAttempts}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_identificationAttempts_attemptResult}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_identificationAttempts_attributes}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_identificationAttempts_identifierName}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_identificationAttempts_searchOnTable}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_identifierEntrySysId}{#IESS-identifyCIEnhanced_S_S_O__entry_return_items_inputIndices}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_maskedAttributes}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_operation}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_relatedItems_identifyCI}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_relatedItems_errorCount}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_relatedItems_errors}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_relatedItems_inputIndices}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_relatedItems_inputIndices.mainIndex}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_relatedItems_inputIndices.subIndex}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_relatedSysIds}{#IESS-identifyCIEnhanced_S_S_O__entry_return_item_sys_id}{#IESS-identifyCIEnhanced_S_S_O___identifyCI}{#IESS-identifyCIEnhanced_S_S_O__entry_return_relations_className}{#IESS-identifyCIEnhanced_S_S_O__entry_return_relations_errorsCount}{#IESS-identifyCIEnhanced_S_S_O__entry_return_relations_errors}{#IESS-identifyCIEnhanced_S_S_O__entry_return_relations_inputIndices}{#IESS-identifyCIEnhanced_S_S_O__entry_return_relations_operation}{#IESS-identifyCIEnhanced_S_S_O__entry_return_relations_sys_id}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary_class_name}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary_class_name_additionalInsertedItemCount}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary_class_name_errorCount}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary_class_name_incompleteItemCount}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary_class_name_insertedItemCount}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary_class_name_partialItemCount}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary_class_name_unchangedItemCount}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary_class_name_updatedItemCount}{#IESS-identifyCIEnhanced_S_S_O__entry_return_summary_class_name_warningCount}

| 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ätzliche KommittedElemente | Liste der CIs, die während der Ire-Verarbeitung der aktuellen Nutzlast bestätigt wurden, aber in der aktuellen Eingabenutzlast nicht 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ätzlichZusammenarbeitenBeziehungen | Beschreibung eines abhängigen Beziehungs-CI, das nicht im Anforderungstext enthalten war relationsListe zum Einfügen oder Aktualisieren. 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: Boolescher Wert |
| \<String\>.hasWarnung | Kennzeichnung, die angibt, ob ein Element oder eine Beziehung Warnungen aufweist. Datentyp: Boolescher Wert |
| \<String\>.Elemente | 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.additionalRelatedItems | Informationen zu zusätzlichen Suchelementen und zugehörigen Elementen, die verarbeitet, 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.additionalRelatedItems.className | Klassen-/Tabellenname (sys_class_Name) des CI, das erstellt oder aktualisiert wurde. Datentyp: Zeichenfolge |
| \<String\>.items.additionalRelatedItems.inputIndices | Indexwerte für CIs aus dem Anforderungstext itemsArray, das diesem zugehörigen Element entspricht. Datentyp: Array von Zahlen |
| \<String\>.items.additionalRelatedItems.mergedPayloadIds | Liste der sys_IDs der Teilnutzlasten, die mit dem zugehörigen Element zusammengeführt wurden. Datentyp: Array Tabelle: Partielle CMDB-Ire-Nutzlasten \[cmdb_ire_partial_payloads\] |
| \<String\>.items.additionalRelatedItems.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. {#IESS-identifyCIEnhanced_S_S_O__ul_rk4_fxz_mjb} Datentyp: Zeichenfolge |
| \<String\>.items.additionalRelatedItems.sysId | SYS_ID des CI, das aktualisiert oder erstellt wurde. Datentyp: Zeichenfolge |
| \<String\>.Items.className | Klassen-/Tabellenname (sys_class_Name) des CI, das erstellt oder aktualisiert wurde. Datentyp: Zeichenfolge |
| \<String\>.items.duplicateIndices | Liste der Indizes von CIs, die Duplikate des aktuellen Elements sind. Datentyp: Array |
| \<String\>.items.Fehleranzahl | Anzahl der beim Verarbeiten des Elements aufgetretenen Fehler. Datentyp: Zahl |
| \<String\>.Elemente.Fehler | Liste der Fehler, die bei der Verarbeitung dieses CI aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| \<String\>.Elemente.Fehler.Fehler | Typ des beim Verarbeiten des CI aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| \<String\>.Elemente.Fehler.Nachricht | Fehlermeldung beim Verarbeiten des CI aufgetreten. Datentyp: Zeichenfolge |
| \<String\>.items.identifikationVermutungen | Liste der Versuche, die zur Identifizierung der CIs unternommen wurden. Datentyp: Array von Objekten "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identifierName": "String", "searchOnTable": "String" } ] |
| \<String\>.Elemente.IdentifikationVersuchen.Versuch.Befolgen | Ergebnisse des Versuchs, das CI zu identifizieren. Mögliche Werte: * ÜBEREINSTIMMEND: Identifizierung erfolgreich. In der Bezeichnerregeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmte. * MULTI_MATCH: Identifizierung mit Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichnerregeltabelle beim Abgleich mit den angegebenen Attributen gefunden. * NO_MATCH: Identifizierung fehlgeschlagen. In der Bezeichnerregeltabelle wurde kein CI gefunden, das den angegebenen Attributen entsprach. * ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für diese Bezeichnerregeltabellensuche erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet. Datentyp: Zeichenfolge |
| \<String\>.items.identificationAttempts.attributes | Liste der CI-Bezeichnereintragsattribute, die während des Identifizierungsprozesses verwendet wurden. Datentyp: Array Attributnamen und -Typen hängen von den Anforderungstext-Daten und dem verwendeten Bezeichner ab, z. B.: "attributes": [ "serial_number": "String", "serial_number_type": "String", ] |
| \<String\>.items.identificationAttempts.identifierName | Bezeichnerregel, die für diesen CI-Identifizierungsversuch verwendet wird. Datentyp: Zeichenfolge |
| \<String\>.items.identificationAttempts.searchOnTable | Name der Tabelle, die während des Identifizierungsprozesses gesucht wird. Datentyp: Zeichenfolge |
| \<String\>.items.identifierEintragSysId | SYS_ID für die Bezeichnerregel, die zur Identifizierung 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: * ÜBERSPRUNGEN_CLASS_SWITCH * SKIPPED_CLASS_DOWNGRADE * ÜBERSPRUNGEN_CLASS_UPGRADE {#IESS-identifyCIEnhanced_S_S_O__ul_m11_1zp_snb} Datentyp: Zeichenfolge |
| \<String\>.items.info.message | Nachricht, die zusätzliche Einblicke in den Grund für das Überspringen der Neuklassifizierung bietet. Datentyp: Zeichenfolge |
| \<String\>.items.info.ruleSysId | SYS_ID der Reklassifizierungseinschränkungsregel, die abgeglichen wurde. Gilt nur, wenn Ire die Neuklassifizierung aufgrund der Reklassifizierungseinschränkungsregel überspringt. Dieser Wert ist leer, wenn die Neuklassifizierung aufgrund einer Nutzlast oder einer globalen Kennzeichnung übersprungen wird. Datentyp: Zeichenfolge |
| \<String\>.items.inputIndices | Indizes des entsprechenden Eingabe-CI. Für Elemente der obersten Ebene ist dies eine Liste von Ganzzahlen. Für zugehörige CIs oder Such-CIs ist dies eine Liste von JSON-Objekten. Datentyp: Array von Zahlen |
| \<String\>.items.maskedAttribute | Liste der Attribute, deren Aktualisierung durch eine nicht autorisierende Datenquelle wie von definiert übersprungen wurde [Abgleichsregeln](https://www.servicenow.com/docs/access?context=create-reconciliation-rule&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US). Datentyp: Array |
| \<String\>.Elemente.Vorgang | Vorgang, der stattgefunden hat. Mögliche Werte: * EINFÜGEN: Neues CI wurde in die Datenbank eingefügt. * INSERT_AS_INFILET: Element wurde in der cmdb_ire_incomplete_payloads-Tabelle gespeichert. * INSERT_AS_PARTIAL: Element wurde in der cmdb_ire_partial_payloads-Tabelle gespeichert. * UPDATE: Vorhandenes CI wurde aktualisiert. * UPDATE_WITH_DOWNGRADE: CI wurde aktualisiert, und die Klasse wurde in eine generischere Klasse (Vorgängerklasse) geändert. * UPDATE_WITH_SWITCH: CI wurde aktualisiert, und die Klasse wurde in eine Klasse geändert, die nicht Vorgänger- oder untergeordnet ist. * UPDATE_WITH_UPDRADE: CI wurde aktualisiert, und die Klasse wurde in eine speziellere Klasse (untergeordnete Klasse) geändert. {#IESS-identifyCIEnhanced_S_S_O__ul_wyd_hj5_mjb} Datentyp: Zeichenfolge |
| \<String\>.Elemente.zugehörigElemente | 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.Fehleranzahl | Anzahl der Fehler, die bei der Verarbeitung der zugehörigen Elemente erkannt wurden. Datentyp: Zahl |
| \<String\>.items.relatedItems.error | Liste der Fehler, die während der Verarbeitung des zugehörigen Elements aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| \<String\>.items.relatedItems.error.error | Typ des beim Verarbeiten des zugehörigen Elements aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| \<String\>.items.relatedItems.error.message | Fehlermeldung beim Verarbeiten des zugehörigen Elements aufgetreten. Datentyp: Zeichenfolge |
| \<String\>.items.relatedItems.inputIndices | Index des entsprechenden Eingabeelements. Für Elemente der obersten Ebene ist dies 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 Anforderungstext itemsArray, das dem übergeordneten CI des zugehörigen Elements entspricht. Datentyp: Zahl |
| \<String\>.items.relatedItems.inputIndices.subIndex | Indexwert aus dem Anforderungstext items.lookupArray, das dem zugehörigen Element entspricht. Datentyp: Zahl |
| \<String\>.items.relatedItems.mergedPayloadIds | Liste der sys_IDs der Teilnutzlasten, die während der Verarbeitung mit dem CI zusammengeführt wurden. Datentyp: Array |
| \<String\>.items.relatedItems.Vorgang | Vorgang, der stattgefunden hat. Mögliche Werte: * EINFÜGEN: Neues zugehöriges CI wurde in die Datenbank eingefügt. * INSERT_AS_INFILET: Element wurde in der cmdb_ire_incomplete_payloads-Tabelle gespeichert. * INSERT_AS_PARTIAL: Element wurde in der cmdb_ire_partial_payloads-Tabelle gespeichert. * NO_CHANGE: Es wurden keine zugehörigen CI-Änderungen vorgenommen. * UPDATE: Vorhandenes zugehöriges CI wurde aktualisiert. * UPDATE_WITH_DOWNGRADE: Das zugehörige CI wurde aktualisiert, und die Klasse wurde in eine generischere Klasse (Vorgängerklasse) geändert. * UPDATE_WITH_SWITCH: Zugehöriges CI wurde aktualisiert, und die Klasse wurde in eine Klasse geändert, die nicht Vorgänger- oder untergeordnetes Element ist. * UPDATE_WITH_UPDRADE: Zugehöriges CI wurde aktualisiert, und die Klasse wurde in eine speziellere Klasse (untergeordnete Klasse) geändert. Datentyp: Zeichenfolge |
| \<String\>.items.relatedItems.sysId | SYS_ID des zugehörigen Elements. Datentyp: Zeichenfolge |
| \<String\>.items.relatedItems.warningCount | Anzahl der beim Verarbeiten der zugehörigen Elemente aufgetretenen Warnungen. Datentyp: Zahl |
| \<String\>.items.relatedItems.Warnungen | 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 während 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. Nur 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\>.relations.inputIndices | Indizes für die abhängigen Beziehungs-CI-Objekte im Anforderungstext relationsArray, das diesem abhängigen Beziehungs-CI entspricht. Datentyp: Array |
| \<String\>.Beziehungen.Vorgang | Typ des ausgeführten Vorgangs. Mögliche Werte: * EINFÜGEN: Das abhängige Beziehungs-CI wurde als neuer Datensatz in die Zieltabelle eingefügt. * INSERT_AS_INPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „unvollständige Nutzlasten für CMDB-Ire" \[cmdb_ire_incomplete_payloads\] eingefügt. * INSERT_AS_PARTIAL: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „partielle 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\>.Summary.\<class_name\>.additionalInsertedItemCount | Anzahl der Elemente, die aufgrund der Verarbeitung von Teilnutzlasten eingefügt wurden. Datentyp: Zahl |
| \<String\>.Summary.\<class_name\>.Fehleranzahl | Anzahl der bei der Verarbeitung von Elementen aufgerufenen Fehler. Datentyp: Zahl |
| \<String\>.Summary.\<class_name\>.incomplete Elementanzahl | Anzahl der Elemente, die in die Tabelle „unvollständige Nutzlasten für CMDB-Ire" \[cmdb_ire_incomplete_payloads\] eingefügt wurden. Datentyp: Zahl |
| \<String\>.Summary.\<class_name\>.insertedElementanzahl | Anzahl der erstellten Elemente. Datentyp: Zahl |
| \<String\>.Summary.\<class_name\>.partialElementanzahl | Anzahl der in der Tabelle „Teilnutzlast" \[cmdb_ire_partial_payloads\] gespeicherten Elemente. Datentyp: Zahl |
| \<String\>.Summary.\<class_name\>.skippedItemCount | Anzahl der übersprungenen Elemente. Datentyp: Zahl |
| \<String\>.Summary.\<class_name\>.unchangedElementanzahl | Anzahl der Elemente, die Einträge enthielten, aber nicht geändert wurden. Datentyp: Zahl |
| \<String\>.Summary.\<class_name\>.updatedItemCount | Anzahl der aktualisierten Elemente. Datentyp: Zahl |
| \<String\>.Summary.\<class_name\>.warningCount | Anzahl der Elemente, die bei der Verarbeitung eine Warnung generiert haben. Datentyp: Zahl |
[Tabelle : 8. Rückgaben]

    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": []
    }  

## IdentifikationEngine -- runIdentifikationAudit (GlideRecord Now_GR) {#ariaid-title6}

Führt ein Identifizierungs-Audit für das angegebene Konfigurationselement (CI) aus, um Duplikate zu erkennen.
Wenn Duplikate gefunden werden, werden Duplizierungsaufgaben erstellt. Verwenden Sie diese Methode nur für CI-Typen mit unabhängigen Identifizierungsregeln.
{#IESS-runIdentificationAudit_GR__table_l3p_n3c_tx__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Now_GR | GlideRecord | CI, für das das Audit ausgeführt werden soll, um Duplikate zu erkennen. Das CI muss unabhängige Identifizierungsregeln haben. |
[Tabelle : 9. Parameter]

{#IESS-runIdentificationAudit_GR__table_l3p_n3c_tx} {#IESS-runIdentificationAudit_GR__table_m3p_n3c_tx__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 10. Rückgaben]

{#IESS-runIdentificationAudit_GR__table_m3p_n3c_tx}  
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);


