CMDBTransformUtil : Global

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

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

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

    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 identifizierenAndReconcile() oder identifizierenAndReconcileEnhanced() generiert wurden.

    Verwenden Sie diese Methode in onBefore-Transformationszuordnungsskripts, um -Fehler abzurufen. Verwenden Sie die Methode hasError(), um zuerst Fehler aus der Methode identifizierenAndReconcile() oder identifizierenAndReconcileEnhanced() zu erkennen.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 3. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Fehlermeldung von identifizierenAndReconcile() oder identifizierenAndReconcileEnhanced(). 
    // 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-Payload aus dem vorherigen Aufruf der Methode identifizierenAndReconcile() oder identifizierenAndReconcileEnhanced() zurück.

    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ätzlicheCommittedItems Derzeit werden keine Werte zurückgegeben.
    <String>.ZusätzlicheCommittedRelations Derzeit werden keine Werte zurückgegeben.
    <String>.items Beschreibung der erstellten oder aktualisierten CIs.

    Datentyp: Objekt

    "items": { 
  "additionalRelatedItems": [Array],
  "className": "String",
  "duplicateIndices": [Array],
  "errorCount": Number,
  "errors": [Array],
  "identificationAttempts": [Array],
  "identifierEntrySysId": "String",
  "info": [Array],
  "inputIndices": [Array],
  "maskedAttributes": [Array],
  "operation": "String",
  "relatedItems": [Array],
  "relatedSysIds": [Array],
  "sysId": "String"
}
    <String>.items.zusätzlicheZugehörigeElemente Liste von Informationen über zusätzliche Suche und zugehörige Elemente, die verarbeitet, aber nicht als Teil der Eingabenutzlast bereitgestellt wurden. Diese Elemente stammen aus Teilnutzlasten.

    Diese Informationen werden derzeit nicht zurückgegeben.

    Datentyp: Array von Objekten

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

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

    Datentyp: Array von Zahlen oder Array von Objekten

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

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

    Datentyp: Zahl
    <String>.items.zusätzlicheZugehörigeElemente.vorgang Typ des Vorgangs

    Mögliche Werte:

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

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

    Datentyp: Zeichenfolge
    <String>.items.className Klassen-/Tabellenname (sys_class_name) des erstellten oder aktualisierten CI.

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

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

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

    Datentyp: Array von Objekten

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

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

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

    Datentyp: Array von Objekten

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

    Mögliche Werte:

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

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

    Datentyp: Array

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

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

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

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

    Datentyp: Zeichenfolge

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

    Datentyp: Array von Objekten

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

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

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

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

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

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

    Datentyp: Array von Objekten

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

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

    Datentyp: Array von Objekten

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

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

    Datentyp: Array oder Zahlen

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

    Datentyp: Zahl
    <String>.items.relatedItems.inputIndices.subindex Ganzzahlwert aus dem Array des Anforderungstexts items.lookup, der dem zugehörigen Element entspricht.

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

    Mögliche Werte:

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

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

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

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

    Datentyp: Zeichenfolge
    <String>.Beziehungen Informationen zu den verarbeiteten Beziehungen.

    Datentyp: Array von Objekten

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

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

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

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

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

    Mögliche Werte:

    • EINFÜGEN
    • AKTUALISIEREN
    • NO_CHANGE

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

    Datentyp: Zeichenfolge

    		 
    // 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 bzw. 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 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 zum Verarbeiten der Nutzlast identifizierte Elementeaus der Liste.

    Tabelle : 8. Parameter
    Name Typ Beschreibung
    Quelle Objekt Globales Objekt, das in Transformationszuordnungsskripts verfügbar ist, die den eingehenden Datensatz enthalten.
    Zuordnen Objekt In Transformationszuordnungsskripts verfügbares Zuordnungsobjekt, das den aktuellen Transformationszuordnungsdatensatz enthält.
    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ätzlicheCommittedItems Liste der CIs, die während der IRE-Verarbeitung der aktuellen Nutzlast committet wurden, aber nicht in der aktuellen Eingabenutzlast vorhanden waren.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    <String>.zusätzlicheCommittedItems.errorCount Anzahl der bei der Verarbeitung dieses zusätzlichen CI aufgetretenen Fehler.

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

    Datentyp: Array

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

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

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

    Datentyp: Zeichenfolge

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

    Datentyp: Array

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

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

    Datentyp: Array

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

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

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

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

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

    Datentyp: Zahlen-Array

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

    Datentyp: Array

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

    Datentyp: Array

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

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

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

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    <String>.zusätzlicheCommittedItems.warnings.message Bei der Verarbeitung dieses zusätzlichen CI ist eine Warnmeldung aufgetreten.

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

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge

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

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

    Datentyp: Array von Objekten

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

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

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

    Datentyp: Array

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

    Datentyp: Array

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

    Datentyp: Array

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

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

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

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

    Datentyp: Array von Objekten

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

    Datentyp: Array von Objekten

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

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

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

    Datentyp: Array

    Tabelle: Teilweise Nutzlasten von CMDB-IRE [cmdb_ire_partial_payloads]
    <String>.items.zusätzlicheZugehörigeElemente.vorgang Typ des Vorgangs

    Mögliche Werte:

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

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

    Datentyp: Zeichenfolge
    <String>.items.className Klassen-/Tabellenname (sys_class_name) des erstellten oder aktualisierten CI.

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

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

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

    Datentyp: Array von Objekten

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

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

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

    Datentyp: Array von Objekten

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

    Mögliche Werte:

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

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

    Datentyp: Array

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

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

    Datentyp: Array

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

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    <String>.items.identificationVersuche.bezeichnername Identifier-Regel, die für diesen CI-Identifizierungsversuch verwendet wird.

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

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

    Datentyp: Zeichenfolge

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

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

    Datentyp: Array von Objekten

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

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

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

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

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

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

    Mögliche Werte:

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

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

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

    Datentyp: Array von Objekten

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

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

    Datentyp: Array von Objekten

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

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

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

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

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

    Datentyp: Array von Zahlen oder Array von Objekten

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

    Datentyp: Zahl
    <String>.items.relatedItems.inputIndices.subindex Indexwert aus dem Array des Anforderungstexts items.lookup, der dem zugehörigen Element entspricht.

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

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

    Mögliche Werte:

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

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

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

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

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

    Datentyp: Array von Objekten

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

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

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

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

    Datentyp: Zeichenfolge
    <String>.Beziehungen Beschreibung eines abhängigen Beziehungs-CI aus dem Array des Anforderungstexts relations.

    Datentyp: Array von Objekten

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

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

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

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

    Datentyp: Array von Objekten

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

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

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

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

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

    Mögliche Werte:

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

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

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

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

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

    Datentyp: Objekt

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

    Datentyp: Zahl
    <String>.Zusammenfassung<class_name> .errorCount Anzahl der Fehler, die bei der Verarbeitung von Elementen auftreten.

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

    Datentyp: Zahl
    <String>.Zusammenfassung<class_name> .eingefügtElementAnzahl Anzahl der erstellten Elemente.

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

    Datentyp: Zahl
    <String>.Zusammenfassung<class_name> .übersprungenElementAnzahl Anzahl der Elemente, die übersprungen wurden.

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

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

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

    Datentyp: Zahl

    Dieses Codebeispiel zeigt, wie Sie die Nutzlast eines ImportSet abrufen, wobei Sie dann die Nutzlast aktualisieren und dann die neue Nutzlast festlegen können, bevor Sie die Methode cmdbUtil.identifyAndReconcileEnhanced() 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()

    Bestimmt, ob im vorherigen Aufruf der Methode identifizierenAndReconcile() oder identifizierenAndReconcileEnhanced() ein Fehler aufgetreten ist.

    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 der zuvor aufgerufenen Methode „IdentifizierenAndReconcile()“ oder „IdentifizierenAndReconcileEnhanced()“ ein Fehler aufgetreten ist.
    Mögliche Werte:
    • true: Ein Fehler ist aufgetreten
    • „falsch“: 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 - identifizierenAndReconcile(Objektquelle, Objektzuordnung, Objektprotokoll)

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

    Verwenden Sie diese Methode in onBefore-Transformationszuordnungsskripts. Wenn Sie diese Methode verwenden, anstatt sich beim Einfügen oder Aktualisieren des Konfigurationselementdatensatzes auf die Transformation zu verlassen, 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 Ignorieren = Wahrfest.

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

    Dieses Codebeispiel zeigt, wie die identifizierteAndReconcile()- 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 – identifizierenAndReconcileEnhanced (Objektquelle, Objektzuordnung, Objektprotokoll)

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

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

    • Es werden Teilnutzlasten verarbeitet
    • Teilweise Commits verarbeiten
    • Doppelte Elemente werden in einer Nutzlast entfernt
    • Ausgabezusammenfassungen werden generiert

    Weitere Informationen zu Identification and Reconciliation (Identifizierung und Abgleich) und ausführlichere Erklärungen zu den von dieser Methode verwendeten Daten finden Sie unter Identification and Reconciliation (IRE).

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

    Dieses Codebeispiel zeigt, wie die identifizierteAndReconcileEnhanced()- 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(Objektprotokoll)

    Protokolliert die Anzahl der Configuration Items (CI), die eingefügt, aktualisiert, übersprungen wurden oder bei denen Fehler aufgetreten sind.

    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 zu verwendende Datenquelle fest, wenn die Methode „identifyAndReconcile()“ oder „identifyAndReconcileEnhanced()“ aufgerufen wird.

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

    Tabelle : 18. Parameter
    Name Typ Beschreibung
    Quelle Zeichenfolge Datenquelle für den Quell-Configuration Item-Datensatz.
    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.