CMDBTransformUtil – Global

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

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

    Das IRE-Framework gleicht auch CI-Attribute ab, indem nur Informationen aus autorisierten Quellen akzeptiert werden, wenn CMDB in onBefore- Transform Map-Skripts aktualisiert wird. Sie können diese Klasse nicht in anderen Skripts verwenden. Weitere Informationen zur Funktionsweise des Identification and Reconciliation-Frameworks finden Sie unter CMDB Identification and Reconciliation.

    CMDBTransformUtil – CMDBTransformUtil()

    Erstellt ein CMDBTransformUtil-Objekt.

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

    CMDBTransformUtil – getError()

    Gibt alle Fehler zurück, die durch den vorherigen Aufruf der Methode identifyAndReconcile() oder identifyAndReconcileEnhanced() generiert wurden.

    Verwenden Sie diese Methode in onBefore-Transform Map-Skripts, um Fehler abzurufen. Verwenden Sie die Methode hasError(), um zuerst Fehler in der Methode identifyAndReconcile() oder identifyAndReconcileEnhanced() zu erkennen.

    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 Aufruf der Methode identifyAndReconcile() oder identifyAndReconcileEnhanced() zurück.

    Verwenden Sie diese Methode in onBefore-Transform Map-Skripts.

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

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

    Datentyp: Array

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

    Diese Informationen werden derzeit nicht zurückgegeben.

    Datentyp: Array

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

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

    Datentyp: Array von Zahlen oder Array von Objekten

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

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

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

    Mögliche Werte:

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

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

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

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

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

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

    Datentyp: Array

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

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

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

    Datentyp: Array

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

    Mögliche Werte:

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

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

    Datentyp: Array

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

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

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

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

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

    Datentyp: Array

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

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

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

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

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

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

    Datentyp: Array

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

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

    Datentyp: Array

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

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

    Datentyp: Array oder Zahlen

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

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

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

    Mögliche Werte:

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

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

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

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

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

    Datentyp: Array

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

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

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

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

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

    Mögliche Werte:

    • EINFÜGEN
    • AKTUALISIEREN
    • KEINE_ÄNDERUNG

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

    Datentyp: Zeichenfolge

    		 
    // 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 Konfigurationselements (CI) zurück, das eingefügt oder aktualisiert wurde.

    Verwenden Sie diese Methode in onBefore-Transform Map-Skripts.

    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(Object source, Object map, Object log)

    Gibt die JSON-Nutzlast zurück, die aus der angegebenen Eingabe generiert wurde.

    Sie können dann die Nutzlast ändern und die Methode setPayload() verwenden, um die aktualisierte Nutzlast zu speichern. 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 und den eingehenden Datensatz enthält.
    Zuordnen Objekt In Transformationszuordnungsskripts verfügbares Zuordnungsobjekt, das den aktuellen Transformationszuordnungsdatensatz enthält.
    Protokoll Objekt Protokollobjekt, das in Transformationszuordnungsskripts verfügbar ist.
    Tabelle : 9. Ergebnisse
    Parameter Beschreibung
    <String> JSON-formatierte Zeichenfolge, die eine Liste der Ergebnisse für die Konfigurationselemente in der Eingabezeichenfolge ist.

    Datentyp: Zeichenfolge

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

    Datentyp: Array

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

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

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

    Datentyp: Array

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

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

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

    Datentyp: Zeichenfolge

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

    Datentyp: Array

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

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

    Datentyp: Array

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

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

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

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

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

    Datentyp: Array

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

    Datentyp: Array

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

    Datentyp: Array

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

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

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

    Datentyp: Array

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

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

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

    Datentyp: Array

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

    Datentyp: Zeichenfolge

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

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

    Datentyp: Array

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

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

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

    Datentyp: Array

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

    Datentyp: Array

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

    Datentyp: Array

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

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

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

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

    Datentyp: Array

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

    Datentyp: Array

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

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

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

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

    Mögliche Werte:

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

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

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

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

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

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

    Datentyp: Array

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

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

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

    Datentyp: Array

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

    Mögliche Werte:

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

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

    Datentyp: Array

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

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

    Datentyp: Array

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

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

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

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

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

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

    Datentyp: Array

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

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

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

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

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

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

    Mögliche Werte:

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

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

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

    Datentyp: Array

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

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

    Datentyp: Array

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

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

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

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

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

    Datentyp: Array von Zahlen oder Array von Objekten

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

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

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

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

    Mögliche Werte:

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

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

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

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

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

    Datentyp: Array

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

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

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

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

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

    Datentyp: Array

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

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

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

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

    Datentyp: Array

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

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

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

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

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

    Mögliche Werte:

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

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

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

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

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

    Datentyp: Objekt

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

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

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

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

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

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

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

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

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

    Datentyp: Zahl

    Dieses Codebeispiel zeigt, wie Sie die Nutzlast eines ImportSet erhalten, in dem Sie die Nutzlast aktualisieren und dann die neue Nutzlast festlegen können, bevor Sie die cmdbUtil.identifyAndReconcileEnhanced()- Methode aufrufen, um die Nutzlast zu verarbeiten.

    // 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()

    Ermittelt, ob beim vorherigen Aufruf der Methode identifyAndReconcile() oder identifyAndReconcileEnhanced() ein Fehler aufgetreten ist.

    Verwenden Sie diese Methode in onBefore-Transform Map-Skripts.

    Tabelle : 10. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 11. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob in der zuvor aufgerufenen Methode identifyAndReconcile() oder identifyAndReconcileEnhanced() ein Fehler aufgetreten ist.
    Mögliche Werte:
    • true: Ein Fehler ist aufgetreten
    • false: Es ist 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(Object source, Object map, Object log)

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

    Verwenden Sie diese Methode in onBefore-Transform Map-Skripts. Wenn Sie diese Methode verwenden, anstatt sich auf die Transformation zu verlassen, um den Konfigurationselement-Datensatz einzufügen oder zu aktualisieren, werden doppelte Einträge in der CMDB reduziert. Weitere Informationen finden Sie unter CI-Identifizierung und -Abgleich auf Importsätze anwenden.

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

    Tabelle : 12. Parameter
    Name Typ Beschreibung
    Quelle Objekt Globales Objekt, das in Transformationszuordnungsskripts verfügbar ist und den eingehenden Datensatz enthält.
    Zuordnen Objekt In Transformationszuordnungsskripts verfügbares Zuordnungsobjekt, das den aktuellen Transformationszuordnungsdatensatz enthält.
    Protokoll Objekt Protokollobjekt, das in Transformationszuordnungsskripts verfügbar ist.
    Tabelle : 13. Ergebnisse
    Typ Beschreibung
    void

    Dieses Codebeispiel zeigt, wie die identifyAndReconcile()- Methode aufgerufen wird, um die aktuelle Zeile der Eingabenutzlast zu verarbeiten.

    // 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(Object source, Object map, Object log)

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

    Diese Methode bietet nicht nur die Funktionalität der CMDBTransformUtil.identifyAndReconcile() -Methode, sondern unterstützt auch Folgendes:

    • Teilnutzlasten werden verarbeitet
    • Umgang mit teilweisen Commits
    • Doppelte Elemente innerhalb einer Nutzlast werden entfernt
    • Ausgabezusammenfassungen werden generiert

    Weitere Informationen zu Identifizierung und Abgleich und 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 und den eingehenden Datensatz enthält.
    Zuordnen Objekt In Transformationszuordnungsskripts verfügbares Zuordnungsobjekt, das den aktuellen Transformationszuordnungsdatensatz enthält.
    Protokoll Objekt Protokollobjekt, das in Transformationszuordnungsskripts verfügbar ist.
    Tabelle : 15. Ergebnisse
    Typ Beschreibung
    Keine

    Dieses Codebeispiel zeigt, wie die identifyAndReconcileEnhanced()- Methode aufgerufen wird, um die übergebene Nutzlast zu verarbeiten.

    // 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(Object log)

    Protokolliert die Anzahl der Konfigurationselemente (CIs), die eingefügt, aktualisiert, übersprungen wurden oder Fehler aufwiesen.

    Verwenden Sie diese Methode in onComplete-Transform Map-Skripts.

    Tabelle : 16. Parameter
    Name Typ Beschreibung
    log Objekt Protokollobjekt, das in Transformationszuordnungsskripts verfügbar ist.
    Tabelle : 17. Ergebnisse
    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 zu verwendende Datenquelle fest, wenn die Methode identifyAndReconcile() oder identifyAndReconcileEnhanced() aufgerufen wird.

    Verwenden Sie diese Methode in onBefore- Transform Map-Skripts. Wenn diese Methode nicht aufgerufen wird, wird der Standardwert ImportSet verwendet.

    Tabelle : 18. Parameter
    Name Typ Beschreibung
    Quelle Zeichenfolge Datenquelle für den Datensatz des Quellkonfigurationselements.
    Tabelle : 19. Ergebnisse
    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.