Top > How to import data > Creating and configuring objects > Configuring general properties

Configuring general properties

To configure the properties on the General page of the Add Destination Object wizard:

  1. Select the Destination Object Class. This is the object (class) that will be created in the CMDB. Choose an object class that corresponds to the source data; for example, if you are importing software license contractual data into the IT Asset Management Pack, choose the correct agreement, such as Software License Agreement.

  2. Enter a Destination Object Name. The Name is only used to help you identify objects within the wizard. It does not appear in the object instances that are created after the import.

  3. Choose one of the Object Processing Options to determine whether you wish the objects to be created, updated, or both depending on certain cri­teria. The criteria must be defined on the Criteria page.

    Option

    Mapping

    Criteria

    Description

    Create only

    Mandatory

    Optional

    Creates all instances of the object. If you are certain that the instances do not already exist in the database, criteria are unnecessary and could slow the import down. If there is a chance that the source data could result in duplicate instances, define criteria to eliminate them.

    Create or update

    Mandatory

    Mandatory

    Updates all instances of the object that meet the criteria. Creates all instances of the object that do not meet the criteria. The criteria are therefore used to filter on the instances that you wish to update.

    Update only

    Mandatory

    Mandatory

    Updates all instances of the object that meet the criteria. Ignores all instances of the object that do not meet the criteria.

    Reference Object

    None

    None

    Use only when removing a relationship. This option indicates that any item can be removed from the relationship. In a one to one relation­ship, the instance of the reference object is  removed. In a one to many relationship, all instances of the reference object are removed. Mapping and criteria are not permitted with this option.

    Reference Instance

    None

    Mandatory

    Use when creating, updating or removing a relationship. It is designed to identify a specific instance of an object in a relationship. No changes are performed on the instance itself; however, the instance must already exist or be created during the import before you use this option. Mapping is not permitted, but criteria are required to identify the instance. For exam­ple, if you wish to create the Assigned to relationship on a hardware asset, then you would need to identify the specific user on the object. The criteria for the Reference Instance would include Alison Kraus to ensure that she becomes the Assigned to in the relationship.

    Delete

     

    Mandatory

    Deletes all object instances that meet the crite­ria. Instances deleted using this processing option are actually moved to the Deleted Items folder and must be permanently removed from there. Relationships are also removed from deleted instances. If you decide to restore an instance from the Deleted Items folder, its rela­tionships are returned intact.

  4. NOTE:

    If you select either the Update or the Create or Update option and you do not define any Criteria, then nothing will be updated.

  5. (Optional) If you do not want object instances to be created, based on the appearance of certain values in your source data, select the Source Col­umn having those values.

  6. Add one or more values from the source column.