CMDBTransformUtil – Global

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

    • Die CMDBTransformUtil Die Skripteinbindung verwendet das Ire-Framework (Identification and Reconciliation), um die Erstellung doppelter Konfigurationselemente (Configuration Items, CI) zu minimieren.

    Das IRE-Framework stimmt auch CI-Attribute ab, indem beim Aktualisieren von nur Informationen aus autorisierten Quellen akzeptiert werden CMDB In OnBefore Transformationszuordnungsskripts. Sie können diese Klasse nicht in anderen Skripts verwenden. Weitere Informationen zur Funktionsweise des IRE-Frameworks finden Sie unter CMDB-Identifizierung und -Abgleich .

    CMDBTransformUtil – CMDBTransformUtil()

    Erstellt ein CMDBTransformUtil-Objekt.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine 
    var cmdbUtil = new CMDBTransformUtil();

    CMDBTransformUtil – getError()

    Gibt alle vom vorherigen generierten Fehler zurück IdentifyAndReconcile() Oder IdentifyAndReconcileEnhanced() Methodenaufruf.

    Verwenden Sie diese Methode in onBefore-Transformationszuordnungsskripts, um Fehler zu erhalten. Verwenden Sie HasError() Methode zum Erkennen von Fehlern zuerst von IdentifyAndReconcile() Oder IdentifyAndReconcileEnhanced() Methode.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 3. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Fehlermeldung von IdentifyAndReconcile() Oder IdentifyAndReconcileEnhanced() . 
    // Add this code to the onBefore transform map script
// Call CMDB API to do Identification and Reconciliation of the current row
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.setDataSource('ImportSet');
cmdbUtil.identifyAndReconcileEnhanced(source, map, log);
ignore = true;

if (cmdbUtil.hasError()) {
  var errorMessage = cmdbUtil.getError();
  log.error(errorMessage);
} else {
  log.info('IE Output Payload: ' + cmdbUtil.getOutputPayload());
  log.info('Imported CI: ' + cmdbUtil.getOutputRecordSysId());
}

    Bereichsbezogenes Äquivalent

    Für diese Methode gibt es kein bereichsbezogenes Äquivalent.

    CMDBTransformUtil – getOutputPayload()

    Gibt die JSON-Nutzlast aus dem vorherigen zurück IdentifyAndReconcile() Oder IdentifyAndReconcileEnhanced() Methodenaufruf.

    Verwenden Sie diese Methode in onBefore-Transformationszuordnungsskripts.

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 5. Rückgaben
    Typ Beschreibung
    <String> JSON-formatierte Zeichenfolge, die eine Liste von Ergebnissen für die Konfigurationselemente in der Eingabezeichenfolge ist. Jede Ergebniszeichenfolge hat das Format „items: [{}], relations: [{}]“, wobei jedes Element in den items- und relations-Listen Name-Wert-Paare enthält.

    Datentyp: Zeichenfolge
    <String>.ZusätzlichenKommittedElemente Derzeit werden keine Werte zurückgegeben.
    <String>.ZusätzlichenMitarbeiterbeziehungen 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>.Elemente.ZusätzlichenVerwandte Elemente 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.

    Datentyp: Zeichenfolge
    <String>.items.additionalRelatedItems.sysId SYS_ID der zusätzlichen zugehörigen Elemente.

    Datentyp: Zeichenfolge
    <String>.Elemente.Klassenname Klassen-/Tabellenname (sys_class_Name) des CI, das erstellt oder aktualisiert wurde.

    Datentyp: Zeichenfolge
    <String>.Elemente.Duplikatindizes 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>.Elemente.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.Weiterleiten 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 Identifier-Regeltabellensuche erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet.

    Datentyp: Zeichenfolge
    <String>.Items.IdentifikationAttempts.Attribute Liste der CI-Identifier-Eintragsattribute, die während des Identifizierungsprozesses verwendet wurden.

    Datentyp: Array

    Attributnamen und -Typen hängen von den Daten des Anforderungstexts und dem verwendeten Bezeichner ab, z. B.:

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    <String>.items.identificationAttempts.hybridEntryCiAttribute Derzeit werden keine Werte zurückgegeben.
    <String>.items.IdentifikationAttempts.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.identifierEintrags-SysId 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 Neuklassifizierungstyp, der übersprungen wurde.
    Mögliche Werte:
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_UPGRADE

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

    Datentyp: Zeichenfolge
    <String>.items.info.ruleSysId SYS_ID der 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 .

    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>.Elemente.zugehörigElemente.Klassenname Klassen-/Tabellenname (sys_class_Name) des zugehörigen Elements.

    Datentyp: Zeichenfolge
    <String>.Elemente.zugehörigElemente.Fehler 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>.Elemente.zugehörigElemente.Vorgang Typ des Vorgangs.

    Mögliche Werte:

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

    Datentyp: Zeichenfolge
    <String>.Items.Related SysIds Liste der sys_ID-Werte für zugehörige Elemente (Tabellensuchelemente) aus dem Anforderungstext items.lookupArray.

    Wichtige 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

    		 
    // Add this code to the onBefore transform map script
// Call CMDB API to do Identification and Reconciliation of the current row
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.setDataSource('ImportSet');
cmdbUtil.identifyAndReconcileEnhanced(source, map, log);
ignore = true;

if (cmdbUtil.hasError()) {
  var errorMessage = cmdbUtil.getError();
  log.error(errorMessage);
} else {
  log.info('IE Output Payload: ' + cmdbUtil.getOutputPayload());
  log.info('Imported CI: ' + cmdbUtil.getOutputRecordSysId());
}

    Bereichsbezogenes Äquivalent

    Für diese Methode gibt es kein bereichsbezogenes Äquivalent.

    CMDBTransformUtil – getOutputRecordSysId()

    Gibt die sys_ID des Configuration Item (CI) zurück, das eingefügt oder aktualisiert wurde.

    Verwenden Sie diese Methode in onBefore-Transformationszuordnungsskripts.

    Tabelle : 6. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 7. Ergebnisse
    Typ Beschreibung
    Zeichenfolge SYS_ID des CI, das eingefügt oder aktualisiert wurde. 
    // Add this code to the onBefore transform map script
// Call CMDB API to do Identification and Reconciliation of current row
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.setDataSource('ImportSet');
cmdbUtil.identifyAndReconcileEnhanced(source, map, log);
ignore = true;

if (cmdbUtil.hasError()) {
  var errorMessage = cmdbUtil.getError();
  log.error(errorMessage);
} else {
  log.info('IE Output Payload: ' + cmdbUtil.getOutputPayload());
  log.info('Imported CI: ' + cmdbUtil.getOutputRecordSysId());
}

    Bereichsbezogenes Äquivalent

    Für diese Methode gibt es kein bereichsbezogenes Äquivalent.

    CMDBTransformUtil – getPayload(Objektquelle, Objektzuordnung, Objektprotokoll)

    Gibt die aus der angegebenen Eingabe generierte JSON-Nutzlast zurück.

    Sie können dann die Nutzlast ändern und verwenden SetPayload() Methode zum Speichern der aktualisierten Nutzlast. Sobald die Nutzlast geändert und gespeichert wurde, verwenden Sie IdentifyAndReconcile() Oder IdentifyAndReconcileEnhanced() Um die Nutzlast zu verarbeiten.

    Tabelle : 8. Parameter
    Name Typ Beschreibung
    Quelle Objekt Globales Objekt, das in Transformationszuordnungsskripts verfügbar ist, die den eingehenden Datensatz enthalten.
    Zuordnen Objekt Zuordnungsobjekt, das in Transformationszuordnungsskripts verfügbar ist, die den aktuellen Transformationszuordnungsdatensatz enthalten.
    log Objekt Protokollobjekt, das in Transformationszuordnungsskripts verfügbar ist.
    Tabelle : 9. Rückgaben
    Parameter Beschreibung
    <String> JSON-formatierte Zeichenfolge, die eine Liste von Ergebnissen für die Konfigurationselemente in der Eingabezeichenfolge ist.

    Datentyp: Zeichenfolge

    { 
  "additionalCommittedItems": [Array],  
  "additionalCommittedRelations": [Array], 
  "hasError": Boolean, 
  "hasWarning": Boolean,
  "items": [Array],  
  "relations": [Array], 
  "summary": {Object} 
}
    <String>.ZusätzlichenKommittedElemente 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ätzlichenKommittedElemente.Klassenname SYS_class_Name dieses zusätzlichen CI.

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

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

    Datentyp: Array

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.ZusätzlicheKommittedElemente.Fehler.Fehler Typ des beim Verarbeiten des zusätzlichen CI aufgetretenen Fehlers.

    Datentyp: Zeichenfolge
    <String>.ZusätzlichenKommitteElemente.Fehler.Nachricht Beim Verarbeiten des zusätzlichen CI ist eine Fehlermeldung aufgetreten.

    Datentyp: Zeichenfolge
    <String>.ZusätzlichenKommittedElemente.IdentifikationVermutungen 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ätzlichenKommitteElemente.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 Identifier-Regeltabellensuche erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet.
    <String>.ZusätzlichenKommittedElemente.IdentifikationAttempts.Attribute CI-Identifier-Eintragsattribute, die während dieses zusätzlichen CI-Identifizierungsversuchs verwendet werden.

    Datentyp: Array

    Attributnamen und -Typen hängen von den Daten des Anforderungstexts und dem verwendeten Bezeichner ab, z. B.:

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    <String>.ZusätzlichenKommittedElemente.identifikationAttempts.hybridEintragungCiAttribute Array von CI-Identifier-Eintragsattributen, die während dieses zusätzlichen CI-Identifizierungsversuchs verwendet werden.

    Datentyp: Array

    Attributnamen und -Typen hängen von den Daten des Anforderungstexts und dem verwendeten Bezeichner ab, z. B.:

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    <String>.ZusätzlichenKommittedElemente.IdentifikationAttempts.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ätzlichenKommittedElemente.identifierEintragSysId SYS_ID für die Bezeichnerregel, die zur Identifizierung dieses zusätzlichen CI verwendet wird.

    Wichtige 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>.ZusätzlichenKommittedElemente.Marker Markerwerte für interne Verwendung.

    Datentyp: Array

    "markers": []
    <String>.ZusätzlichenKommittedElemente.mergedNutzlasten SYS_ID-Werte für partielle Nutzlasten aus der Tabelle „partielle CMDB-IRE-Nutzlasten“ [cmdb_Ire_partial_Payloads], die während der Verarbeitung dieses zusätzlichen CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    <String>.ZusätzlichenKommittedElemente.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.
    • UPDATE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert.
    • UPDATE_WITH_DOWNGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine generischere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgänger- oder 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.
    <String>.zusätzlichCommittedItems.sysId SYS_ID für dieses zusätzliche CI durch Identifizierung gefunden.

    Datentyp: Zeichenfolge

    Wichtige Werte – Unbekannt: Identifizierung dieses zusätzlichen CI fehlgeschlagen. Details siehe errors.
    <String>.ZusätzlichenKommittedElemente.Warnungen Beschreibung der Warnungen, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    <String>.ZusätzlichenKommitteElemente.Warnungen.Nachricht Beim Verarbeiten dieses zusätzlichen CI ist eine Warnmeldung aufgetreten.

    Datentyp: Zeichenfolge
    <String>.ZusätzlichenMitarbeiterbeziehungen 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ätzlichenZusammenarbeitenBeziehungen.Klassenname Der sys_class_Name dieses zusätzlichen abhängigen Beziehungs-CI.

    Datentyp: Zeichenfolge

    Nur unterstützter Wert: cmdb_rel_ci: CI-Beziehungstabelle.
    <String>.ZusätzlichenMitarbeiterbeziehungen.Fehleranzahl Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Zahl
    <String>.ZusätzlichenZusammenarbeitenBeziehungen.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ätzlichenZusammenarbeitenBeziehungen.Fehler.Fehler Typ des beim Verarbeiten des zusätzlichen abhängigen Beziehungs-CI aufgetretenen Fehlers.

    Datentyp: Zeichenfolge
    <String>.ZusätzlichenZusammenarbeitenBeziehungen.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ätzlichenZusammenarbeitenBeziehungen.Markierungen Markerwerte für interne Verwendung.

    Datentyp: Array

    "markers": []
    <String>.zusätzliche Unternehmensbeziehungen.mergedNutzlastIds SYS_ID-Werte für Teilnutzlasten aus der Tabelle „partielle CMDB-IRE-Nutzlasten“ [cmdb_Ire_partial_Payloads], die für dieses CI zusammengeführt wurden.die während der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    <String>.ZusätzlichenZusammenarbeitenBeziehungen.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 CMDB-IRE-Nutzlasten“ [cmdb_Ire_INFILETE_Payloads] eingefügt.
    • INSERT_AS_PARTIAL: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle „partielle CMDB-IRE-Nutzlasten“ [cmdb_Ire_Partial_Payloads] eingefügt.
    • NO_CHANGE: Für das abhängige Beziehungs-CI wird kein Vorgang ausgeführt.
    • UPDATE: Ein vorhandenes abhängiges Beziehungs-CI in der Zieltabelle wird aktualisiert.

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

    Datentyp: Boolesch
    <String>.hasWarnung Kennzeichnung, die angibt, ob ein Element oder eine Beziehung Warnungen aufweist.

    Datentyp: Boolesch
    <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>.Elemente.ZusätzlichenVerwandte Elemente 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.additionalBeziehtElemente.mergedNutzlast-IDs Liste der sys_IDs der Teilnutzlasten, die mit dem zugehörigen Element zusammengeführt wurden.

    Datentyp: Array

    Tabelle: CMDB IRE – Teilnutzlasten [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.

    Datentyp: Zeichenfolge
    <String>.items.additionalRelatedItems.sysId SYS_ID des CI, das aktualisiert oder erstellt wurde.

    Datentyp: Zeichenfolge
    <String>.Elemente.Klassenname Klassen-/Tabellenname (sys_class_Name) des CI, das erstellt oder aktualisiert wurde.

    Datentyp: Zeichenfolge
    <String>.Elemente.Duplikatindizes 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>.Elemente.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.Weiterleiten 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 Identifier-Regeltabellensuche erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet.

    Datentyp: Zeichenfolge
    <String>.Items.IdentifikationAttempts.Attribute Liste der CI-Identifier-Eintragsattribute, die während des Identifizierungsprozesses verwendet wurden.

    Datentyp: Array

    Attributnamen und -Typen hängen von den Daten des Anforderungstexts und dem verwendeten Bezeichner ab, z. B.:

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

    Datentyp: Array

    Attributnamen und -Typen hängen von den Daten des Anforderungstexts und dem verwendeten Bezeichner ab, z. B.:

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    <String>.items.IdentifikationAttempts.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.identifierEintrags-SysId 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 CMDB-IRE-Nutzlasten“ [cmdb_Ire_unvollständig_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 Neuklassifizierungstyp, der übersprungen wurde.
    Mögliche Werte:
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_UPGRADE

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

    Datentyp: Zeichenfolge
    <String>.items.info.ruleSysId SYS_ID der 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 .

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

    Mögliche Werte:

    • EINFÜGEN: Neues CI wurde in die Datenbank eingefügt.
    • INSERT_AS_INPLEICTE: Element wurde in der Tabelle „cmdb_Ire_Inclusive_Payloads“ gespeichert.
    • INSERT_AS_PARTIAL: Element wurde in der Tabelle „cmdb_Ire_Partial_Payloads“ gespeichert.
    • UPDATE: Vorhandenes CI wurde aktualisiert.
    • UPDATE_WITH_DOWNGRADE: CI wurde aktualisiert, und die Klasse wurde in eine 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.

    Datentyp: Zeichenfolge
    <String>.Items.partialSysIds Wenn das Element Fehler aufweist 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>.Elemente.zugehörigElemente.Klassenname Klassen-/Tabellenname (sys_class_Name) des zugehörigen Elements.

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

    Datentyp: Array von Objekten

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <String>.Elemente.zugehörigElemente.Fehler.Fehler Typ des beim Verarbeiten des zugehörigen Elements aufgetretenen Fehlers.

    Datentyp: Zeichenfolge
    <String>.Elemente.relatedElemente.Fehler.Nachricht 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 CMDB-IRE-Nutzlasten“ [cmdb_Ire_Inclusive_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.Related Items.mergedPayloadIds Liste der sys_IDs der Teilnutzlasten, die während der Verarbeitung mit dem CI zusammengeführt wurden.

    Datentyp: Array
    <String>.Elemente.zugehörigElemente.Vorgang Vorgang, der stattgefunden hat.

    Mögliche Werte:

    • EINFÜGEN: Neues zugehöriges CI wurde in die Datenbank eingefügt.
    • INSERT_AS_INPLEICTE: Element wurde in der Tabelle „cmdb_Ire_Inclusive_Payloads“ gespeichert.
    • INSERT_AS_PARTIAL: Element wurde in der Tabelle „cmdb_Ire_Partial_Payloads“ gespeichert.
    • NO_CHANGE: Es wurden keine zugehörigen CI-Änderungen vorgenommen.
    • UPDATE: Vorhandenes zugehöriges CI wurde aktualisiert.
    • UPDATE_WITH_DOWNGRADE: Das zugehörige CI wurde aktualisiert, und die Klasse wurde in eine generischere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: Das zugehörige CI wurde aktualisiert, und die Klasse wurde in eine Klasse geändert, die nicht Vorgänger- oder untergeordnet ist.
    • UPDATE_WITH_UPDRADE: Das zugehörige 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 aufweist und als Teilnutzlast gespeichert wurde, enthält dies eine Liste der sys_IDs der zugehörigen Datensätze in der Tabelle „teilweise CMDB-IRE-Nutzlasten“ [cmdb_Ire_part_Payloads].

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

    Datentyp: Zeichenfolge
    <String>.Items.Related Items.warningCount Anzahl der beim Verarbeiten der zugehörigen Elemente aufgetretenen Warnungen.

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

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    <String>.Elemente.zugehörigElemente.Warnungen.Nachricht Nachricht, die der Warnung zugeordnet ist.

    Datentyp: Zeichenfolge
    <String>.Items.Related SysIds 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 Beim Verarbeiten dieses abhängigen Beziehungs-CI ist eine Fehlermeldung 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 CMDB-IRE-Nutzlasten“ [cmdb_Ire_Inclusive_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 CMDB-IRE-Nutzlasten“ [cmdb_Ire_INFILETE_Payloads] eingefügt.
    • INSERT_AS_PARTIAL: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „teilweise CMDB-IRE-Nutzlasten“ [cmdb_Ire_Partial_Payloads] eingefügt.
    • NO_CHANGE: Es wurde kein Vorgang ausgeführt.
    • UPDATE: Ein vorhandenes abhängiges Beziehungs-CI in der Zieltabelle wurde aktualisiert.

    Datentyp: Zeichenfolge
    <String>.Beziehungen.partialSysIds Wenn die Beziehung Fehler aufwies und als Teilnutzlast gespeichert wurde, ist dieser Wert die sys_ID des Datensatzes in der Tabelle „partielle CMDB-IRE-Nutzlasten“ [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>.additionalInsertedItemAnzahl Anzahl der Elemente, die aufgrund der Verarbeitung von Teilnutzlasten eingefügt wurden.

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

    Datentyp: Zahl
    <String>.Zusammenfassung.<class_name>.unvollständig Elementanzahl Anzahl der Elemente, die in die Tabelle „unvollständige CMDB-IRE-Nutzlasten“ [cmdb_Ire_Inclusive_Payloads] eingefügt wurden.

    Datentyp: Zahl
    <String>.Summary.<class_name>.insertedItemAnzahl Anzahl der erstellten Elemente.

    Datentyp: Zahl
    <String>.Zusammenfassung.<class_name>.partialElementanzahl Anzahl der Elemente, die in der Tabelle „Teilnutzlast“ [cmdb_Ire_partial_Payloads] gespeichert sind.

    Datentyp: Zahl
    <String>.Summary.<class_name>.SkippedItemAnzahl Anzahl der übersprungenen Elemente.

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

    Datentyp: Zahl
    <String>.Summary.<class_name>.updatedItemAnzahl Anzahl der aktualisierten Elemente.

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

    Datentyp: Zahl

    Dieses Codebeispiel zeigt, wie Sie die Nutzlast eines ImportSet abrufen, wo Sie dann die Nutzlast aktualisieren und dann die neue Nutzlast festlegen können, bevor Sie aufrufen CmdbUtil.identifyAndReconcileEnhanced() Methode zum Verarbeiten der Nutzlast.

    // Add this code to the onBefore transform map script
// Ability to modify the payload using get and set APIs
// Call cmdbUtil API to do Identification and Reconciliation of current row
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.setDataSource('ImportSet');
var payload = cmdbUtil.getPayload(source, map, log);
// Modify the payload here
cmdbUtil.setPayload(payload);
cmdbUtil.identifyAndReconcileEnhanced(source, map, log);
ignore = true;
 
if (cmdbUtil.hasError()) {
  var errorMessage = cmdbUtil.getError();
  log.error(errorMessage);
} else {
  log.info('IE Output Payload: ' + cmdbUtil.getOutputPayload());
  log.info('Imported CI: ' + cmdbUtil.getOutputRecordSysId());
}

    CMDBTransformUtil – hasError()

    Bestimmt, ob im vorherigen ein Fehler aufgetreten ist IdentifyAndReconcile() Oder IdentifyAndReconcileEnhanced() Methodenaufruf.

    Verwenden Sie diese Methode in onBefore-Transformationszuordnungsskripts.

    Tabelle : 10. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 11. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob in zuvor aufgerufener ein Fehler aufgetreten ist IdentifyAndReconcile() Oder IdentifyAndReconcileEnhanced() Methode.
    Mögliche Werte:
    • Wahr: Ein Fehler ist aufgetreten
    • Falsch: Kein Fehler aufgetreten
    		 
    // Add this code to the onBefore transform map script
// Call CMDB API to do Identification and Reconciliation of current row
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.setDataSource('ImportSet');
cmdbUtil.identifyAndReconcileEnhanced(source, map, log);
ignore = true;

if (cmdbUtil.hasError()) {
  var errorMessage = cmdbUtil.getError();
  log.error(errorMessage);
} else {
  log.info('IE Output Payload: ' + cmdbUtil.getOutputPayload());
  log.info('Imported CI: ' + cmdbUtil.getOutputRecordSysId());
}

    Bereichsbezogenes Äquivalent

    Für diese Methode gibt es kein bereichsbezogenes Äquivalent.

    CMDBTransformUtil – identifyAndReconcile (Objektquelle, Objektzuordnung, Objektprotokoll)

    Fügt ein Konfigurationselement (Configuration Item, CI) in ein oder aktualisiert es Configuration Management Database (CMDB).

    Verwenden Sie diese Methode in onBefore-Transformationszuordnungsskripts. Wenn Sie diese Methode verwenden, anstatt sich auf die Transformation zum Einfügen oder Aktualisieren des Konfigurationselementdatensatzes zu verlassen, werden doppelte Einträge in der CMDB reduziert. Weitere Informationen finden Sie unter Wenden Sie CI-Identifikation und -Abgleich auf Importsätze an .

    Um zu verhindern, dass die Transformation den Datensatz ein zweites Mal hinzufügt oder aktualisiert, legen Sie fest Ignorieren = wahr .

    Tabelle : 12. Parameter
    Name Typ Beschreibung
    Quelle Objekt Globales Objekt, das in Transformationszuordnungsskripts verfügbar ist, die den eingehenden Datensatz enthalten.
    Zuordnen Objekt Zuordnungsobjekt, das in Transformationszuordnungsskripts verfügbar ist, die den aktuellen Transformationszuordnungsdatensatz enthalten.
    log Objekt Protokollobjekt, das in Transformationszuordnungsskripts verfügbar ist.
    Tabelle : 13. Rückgaben
    Typ Beschreibung
    void

    Dieses Codebeispiel zeigt, wie Sie aufrufen IdentifyAndReconcile() Methode zum Verarbeiten der aktuellen Zeile der Eingabenutzlast.

    // Add this code to the onBefore transform map script
// Call CMDBTransformUtil API to do Identification and Reconciliation of the current row
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.identifyAndReconcile(source, map, log);
ignore = true;

    CMDBTransformUtil – identifyAndReconcileEnhanced(Objektquelle, Objektzuordnung, Objektprotokoll)

    Fügt ein Konfigurationselement (Configuration Item, CI) in ein oder aktualisiert es Configuration Management Database (CMDB).

    Zusätzlich zur Bereitstellung der Funktionalität von CMDBTransformUtil.identifyAndReconcile() Methode, diese Methode unterstützt auch:

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

    Weitere Informationen zur Identifizierung und zum Abgleich sowie detailliertere Erklärungen der von dieser Methode verwendeten Daten finden Sie unter Identifizierung und Abgleich (IRE) .

    Tabelle : 14. Parameter
    Name Typ Beschreibung
    Quelle Objekt Globales Objekt, das in Transformationszuordnungsskripts verfügbar ist, die den eingehenden Datensatz enthalten.
    Zuordnen Objekt Zuordnungsobjekt, das in Transformationszuordnungsskripts verfügbar ist, die den aktuellen Transformationszuordnungsdatensatz enthalten.
    log Objekt Protokollobjekt, das in Transformationszuordnungsskripts verfügbar ist.
    Tabelle : 15. Rückgaben
    Typ Beschreibung
    Keine

    Dieses Codebeispiel zeigt, wie Sie aufrufen IdentifyAndReconcileEnhanced() Methode zum Verarbeiten der übergebenen Nutzlast.

    // Add this code to the onBefore transform map script
// Call CMDBTransformUtil API to do Identification and Reconciliation
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.identifyAndReconcileEnhanced(source, map, log);
ignore = true;

    CMDBTransformUtil – logTransformStats (Objektprotokoll)

    Protokolliert die Anzahl der eingefügten, aktualisierten, übersprungenen oder fehlerhaften Konfigurationselemente.

    Verwenden Sie diese Methode in onComplete-Transformationszuordnungsskripts.

    Tabelle : 16. Parameter
    Name Typ Beschreibung
    log Objekt Protokollobjekt, das in Transformationszuordnungsskripts verfügbar ist.
    Tabelle : 17. Rückgaben
    Typ Beschreibung
    void 
    var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.logTransformStats(log);

    Bereichsbezogenes Äquivalent

    Für diese Methode gibt es kein bereichsbezogenes Äquivalent.

    CMDBTransformUtil – setDataSource(String source)

    Legt die Datenquelle fest, die verwendet werden soll, wenn IdentifyAndReconcile() Oder IdentifyAndReconcileEnhanced() Methode wird aufgerufen.

    Verwenden Sie diese Methode in OnBefore Transformationszuordnungsskripts. Wenn diese Methode nicht aufgerufen wird, der Standardwert ImportSet .

    Tabelle : 18. Parameter
    Name Typ Beschreibung
    Quelle Zeichenfolge Datenquelle für den Datensatz des Quellkonfigurationselements.
    Tabelle : 19. Rückgaben
    Typ Beschreibung
    void 
    // Add this code to the onBefore transform map script
// Call CMDB API to do Identification and Reconciliation of current row
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.setDataSource('ImportSet');
cmdbUtil.identifyAndReconcileEnhanced(source, map, log);
ignore = true;

if (cmdbUtil.hasError()) {
  var errorMessage = cmdbUtil.getError();
  log.error(errorMessage);
} else {
  log.info('IE Output Payload: ' + cmdbUtil.getOutputPayload());
  log.info('Imported CI: ' + cmdbUtil.getOutputRecordSysId());
}

    Bereichsbezogenes Äquivalent

    Für diese Methode gibt es kein bereichsbezogenes Äquivalent.