Contents

i-doit provides various data imports. Existing data in the IT documentation can be updated with imports instead of generating (often) unnecessary redundancy. In order to achieve this, i-doit tries to identify existing objects by means of various attributes.

Data Imports Concerned

The following data imports are considered in this article:

Other data imports might have another way of proceeding.

Approach

The identification of objects is carried out in two steps:

  1. The unambiguous attributes of the respective data sources have the highest priority:

    CSV data import: not applicable
    JDisc: Device ID
    OCS Inventory NG: not applicable
    h-inventory: serial number

    With the first data import, these attributes are saved and can then be used as identification feature for following data imports. If these attributes are not available, step 2 follows.

  2. A so-called object matching (see below) is carried out by means of profiles.

Creation of Profiles

Some attributes are suitable to reference objects unambiguously. You can use this characteristic regarding the data import of third-party applications with similar unambiguity. To be prepared for various import cases you can create so-called object-matching profiles in i-doit which are to be observed during import. The central configuration is under Administration → Interfaces / external data → Import → Object-matching profiles. You can create any number of profiles.

The i-doit default installation already contains a profile named Default which mustn't be edited or deleted. With the New button you can create a new profile, with Edit you  can edit a profile while Purge deletes a profile irrevocably.

Several details are required per profile:

  • Name: a meaningful description of the profile
  • Matchings: Various attributes and other fields can be selected. With help of these attributes and fields already documented objects are searched and compared to the data to be imported. The order is irrelevant and cannot be changed.
  • Minimum Match: During the matching process of data and objects to be imported in i-doit a check is carried out as to how many attributes of an object have to match. The selectable number follows the number of attributes under Matchings.

Possible Identifiers

IdentifierCommentsCSV data importJDiscOCS Inventory NGh-inventory
UsernameImport of person; see category for Persons → Login, Username attributeyesnonono
E-mail addressSee category for E-mail addressyesnonono
FQDNImport of network-compatible device; see category for Host addressyesyesyesyes
HostnameImport of network-compatible device; see category for Host addressyesyesyesyes
IMEI numberSee category Mobile ratio, IMEI attributeyesnonono
Inventory numberSee category Accounting, Inventory number attributeyesnonono
IP addressImport of network-compatible device; see category Host addressyesyesnono
LDAP DNWhen persons are synchronized via LDAP/AD, i-doit saves the corresponding DN in the background. You can't see this attribute in i-doit but you can use it as an identificationyesnonono
MACImport of network-compatible device; see category Network → PortMAC address attributeyesyesyesyes
Object IDSee category General, Object ID attributeyesnonono
Object SYSIDSee category GeneralSYS-ID attributeyesnonono
Object titleSee category General, Description attributeyesyesyesyes
Object type constantObject type has to match; see custom object typesyesnoyesno
Room numberImport of room; see category Roomyesnonono
Serial numberSee category Modellyesyesyesyes
Service tagSee category Modellyesnonono
LocationSee category Locationyesnonono