CI-Identifizierung und -Abgleich auf Import Sets anwenden

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 3 Minuten Lesedauer
  • Sie können Prozesse von CMDB-Identifikation und -Abgleich anwenden, wenn Import Sets zum Importieren von CIs in die CMDB verwendet werden. Durch die CI-Identifizierung können doppelte CIs in der CMDB verhindert werden, die Import Sets sonst verursachen könnten.

    Das Auffüllen von CMDB-Tabellen mit Import Sets kann unabsichtlich zu doppelten CIs führen, wenn mehrere importierte Datensätze mit einem vorhandenen CI identisch sind. Um diese Duplizierung zu minimieren, können Sie beim Importieren neuer Datensätze in CMDB-Tabellen Prozesse von CMDB-Identifikation und -Abgleich auf Import Sets anwenden.

    Transform Map-Skript

    Fügen Sie im onBefore-Transformationszuordnungsskript für einen Importsatz einen Aufruf an die CMDBTransformUtil- API hinzu, ähnlich dem folgenden Codebeispiel:
    (function runTransformScript(source, map, log, target) {
    // Call CMDB API to do Identification and Reconciliation of current row
    var cmdbUtil = new CMDBTransformUtil();
    cmdbUtil.identifyAndReconcile(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());
    }
    
    })(source, map, log, target);

    Der Code-Satz ignore = true verhindert, dass Import Sets denselben Datensatz erneut erstellen, nachdem er von der Identifizierungsmaschine verarbeitet wurde.

    Prozess

    Die Identifizierungsmaschine führt eine Identifizierung jedes Quelldatensatzes durch, bevor er in die CMDB eingefügt wird. Die Identifizierungsmaschine ermittelt, ob der Datensatz ein Duplikat eines vorhandenen CI ist, und führt dann Folgendes aus:
    • Wenn nicht doppelt vorhanden: Fügt den Datensatz in die Zieltabelle ein.
    • Wenn doppelt vorhanden: Aktualisiert das vorhandene CI in der CMDB mit Daten aus dem Quelldatensatz.

    Die CMDBTransformUtil-API verarbeitet die Quelldaten vor und übergibt dann die Eingabewerte an die Identifizierungs-Engine, wobei Import Set standardmäßig die Datenquelle ist. Die API „CMDBTransformUtil“ unterstützt ein Zielfeld, das ein Referenzfeld ist, auf dieselbe Weise wie Import Sets es unterstützt. Die API „CMDBTransformUtil“ unterstützt auch ein Quellskript, bei dem Quellskripts ausgewertet werden, um den Zielwert zu ermitteln, der dann an die Identifizierungsmaschine übergeben wird. Weitere Informationen finden Sie unter Feldzuordnung erstellen.

    Geben Sie mehrere Zieltabellen für einen Importsatz an

    Sie können jeden Datensatz in einem Import Set mit einer eigenen Zieltabelle konfigurieren. Anstatt dann alle transformierten Datensätze in eine einzige Zieltabelle einzufügen, werden die Datensätze in die verschiedenen Zieltabellen eingefügt, die pro Datensatz angegeben sind. Beispielsweise müssen Sie möglicherweise einige Datensätze aus dem Import Set in die Klasse „Computer“ und andere Datensätze in die Klasse „Server“ einfügen.

    Berücksichtigen Sie beim Importieren von Daten mit Import Setsdie folgenden Schritte:
    • Fügen Sie in der Datenquellendatei eine Zieltabellenspalte hinzu. Verwenden Sie eine Zeichenfolge wie „MyTable“, um die Spaltenkopfzeile zu kennzeichnen. Geben Sie in jeder Datensatzzeile die Zieltabelle für den Datensatz als gültigen CMDB-Klassennamen ein, z. B. „cmdb_ci_computer“.
    • Fügen Sie nach der automatischen Zuordnung von übereinstimmenden Feldern im Formular „Tabellentransformationszuordnung“ eine Feldzuordnung für die hinzugefügte Zieltabellenspalte hinzu, um eine Beziehung zwischen Klassen und den Zieltabellen in der CMDB herzustellen.
      1. Klicken Sie in der zugehörigen Liste „ Feldzuordnung “ im Formular „Tabellentransformationszuordnung“ auf Neu.
      2. Legen Sie das Quellfeld auf die Kopfzeile der Zieltabellenspalte fest, die Sie in der Datenquellendatei hinzugefügt haben, z. B. MyTable.
      3. Legen Sie das Zielfeld auf Klasse fest.
      4. Klicken Sie auf Absenden.

    Wenn Sie einen Importsatz mit mehreren Zieltabellen konfigurieren, wie in den obigen Schritten beschrieben, wird die im Formular „ Tabellentransformationszuordnung “ angegebene Zieltabelle nicht verwendet.

    Beschränkungen

    Es gelten folgende Einschränkungen:
    • Ein Import Set sollte einer einzelnen Transform Map zugeordnet werden. Stellen Sie beim Hinzufügen eines Aufrufs zur API „CMDBTransformUtil“ sicher, dass noch eine einzelne Transform Map für das Import Set vorhanden ist.
    • Die CMDBTransformUtil-API überprüft nicht, ob Pflichtfelder Werte enthalten, wenn sie mit Import Sets verwendet werden. Unabhängig davon, ob enforce mandatory fields in der Transformationszuordnung festgelegt ist, schlägt der Datenimport fehl, wenn ein Pflichtfeld keinen Wert enthält.
    • CI-Identifizierung und -Abgleich kann nicht auf Import Sets für abhängige CIs (CIs mit abhängigen Identifizierungsregeln) angewendet werden.