Zum Inhalt

Objekte identifizieren bei Importen#

Bitte erstellen Sie vor jeder Änderung an einer Schnittstelle/Import einen vollständiges Backup. Falls das Ergebnis nicht zufriedenstellend ist kann dieses dann wiederhergestellt werden

i-doit verfügt über diverse Datenimporte. Bestehende Daten in der IT-Dokumentation können dabei aktualisiert werden, anstatt meist unnötige Redundanzen zu erzeugen. Damit dies funktioniert, versucht i-doit bestehende Objekte anhand von verschiedenen Attributen zu identifizieren.

Betroffene Datenimporte#

Betrachtet werden in diesem Artikel folgende Datenimporte:

Weitere Datenimporte verfolgen mitunter andere Vorgehensweisen.

Vorgehensweise#

Die Identifizierung von Objekten erfolgt zweistufig:

  1. Die höchste Priorität genießen die eindeutigen Attribute der jeweiligen Datenquellen:

  2. CSV-Datenimport: nicht anwendbar

  3. JDisc: Device ID
  4. OCS Inventory NG: nicht anwendbar
  5. h-inventory: Seriennummer

Diese Attribute werden beim ersten Datenimport gespeichert und können bei folgenden Datenimporten als Identifizierungsmerkmal verwendet werden. Falls diese Attribute nicht zur Verfügung stehen, folgt Schritt 2.

  1. Anhand von Profilen erfolgt ein sogenanntes Objekt-Matching (siehe unten).

Profile bilden#

Einige Attribute sind geeignet, um Objekte eindeutig zu referenzieren. Diesen Umstand kann man sich zu nutze machen, wenn es um den Import von Daten aus Drittapplikationen geht, wo ähnliche Eindeutigkeiten existieren. Um für verschiedene Import-Fälle gewappnet zu sein, können in i-doit sogenannte Objekt-Matching Profile gebildet werden, die beim Import berücksichtigt werden sollen. Die zentrale Konfiguration befindet sich unter Verwaltung → Import und Schnittstellen → Import Matching Profile. Es können beliebig viele Profile erstellt werden.

Objekt-Matching Profile Liste

In der Standard-Installation von i-doit ist bereits ein Profil mit dem Namen Default enthalten, das nicht bearbeitet oder gelöscht werden darf. Über den Button Neu kann ein neues erstellt, über Editieren eines bearbeitet und über Purge ein Profil unwiderruflich gelöscht werden.

Pro Profil sind mehrere Angaben zu machen:

  • Name:
    eine aussagekräftige Beschreibung des Profils
  • Matchings:
    Hier stehen verschiedene Attribute und andere Felder zur Auswahl. Anhand dieser werden bereits dokumentierte Objekte gesucht und mit den zu importierenden Daten verglichen. Die Reihenfolge ist irrelevant und kann nicht verändert werden.
  • Minimum Match:
    Beim Abgleich von zu importierenden Daten und Objekten in i-doit wird überprüft, wie viele Attribute eines Objektes übereinstimmen müssen. Die auswählbare Zahl richtet sich nach der Anzahl der Attribute unter Matchings.
  • Filter für neue Objekte (JDISC):
    Die Option Neuer Objektfilter betrifft nur NEUE Objekte beim JDisc-Import. Objekte vom Import ausschließen, welche nicht über konfigurierte Attribute verfügen. Möglich sind Hostname, Seriennummer, Objekt-Titel, MAC und IP-Adresse.
  • Minimale Filterübereinstimmung (JDISC):
    Mindestanzahl fehlender Attribute, um NEUE Importobjekte zu ignorieren.

Objekt-Matching Profile

Mögliche Identifizierungsmerkmale#

Identifizierungsmerkmal Anmerkungen JDisc CSV-Datenimport OCS Inventory NG h-inventory
IP-Adresse Netzwerkfähiges Gerät importieren; siehe Kategorie Hostadresse ja ja nein nein
Benutzername Person importieren; siehe Kategorie Personen → Login, Attribut Username nein ja nein nein
Objekt-SYSID Siehe Kategorie Allgemein, Attribut SYS-ID nein ja nein nein
IMEI-Nummer Siehe Kategorie Mobilfunk nein ja nein nein
Seriennummer Siehe Kategorie Modell ja ja ja ja
Service Tag Siehe Kategorie Modell nein ja nein nein
Inventarnummer Siehe Kategorie Buchhaltung nein ja nein nein
Standort Siehe Kategorie Standort nein ja nein nein
Objekttyp Konstante Objekttyp muss übereinstimmen; siehe benutzerdefinierte Objekttypen nein ja ja nein
Objekt-Titel Siehe Kategorie Allgemein, Attribut Bezeichnung ja ja ja ja
Objekt-ID Siehe Kategorie Allgemein, Attribut Objekt ID nein ja nein nein
Hostname Netzwerkfähiges Gerät importieren; siehe Kategorie Hostadresse ja ja ja ja
E-Mail-Adresse Siehe Kategorie E-Mail-Adressen nein ja nein nein
Raumnummer Raum importieren; siehe Kategorie Raum nein ja nein nein
Host Alias Netzwerkfähiges Gerät importieren; siehe Kategorie Hostadresse ja ja ja ja
FQDN Netzwerkfähiges Gerät importieren; siehe Kategorie Hostadresse ja ja ja ja
MAC Netzwerkfähiges Gerät importieren; siehe Kategorie Netzwerk → Port, Attribut MAC-Adresse ja ja ja ja
LDAP DN Werden Personen über LDAP/AD synchronisiert, speichert i-doit im Hintergrund den jeweiligen DN. Dieses Attribut ist in i-doit nicht einsehbar, kann aber als Identifizierungsmerkmal genutzt werden. nein ja nein nein