• Products
  • Get started
  • Documentation
  • Resources

Create objects from data using object type mapping

Insight in Jira Service Management is a Premium and Enterprise only feature. It is compatible only with company-managed projects. Learn more about Insight.

To import information into Insight in Jira Service Management you’ll need to create an import structure, map your data, and then execute the import.

If you decide to manually map your data into Insight, you will create need to create objects from your data using object type mapping.

 

Before you begin

  1. You must prepare your data for importing into Insight.

  2. You must create an import structure.

  3. For each type of object that you want to import into Insight, create an object type.

 Create objects from data using object type mapping

  1. From your service project, go to Insight > Object schemas.

  2. Select an Object schema.

  3. Select Configure, then choose the Import tab.

  4. In the Import tab, select on Edit mapping on your import structure to expand it.

  5. You must create a separate object type mapping for each object type that you wish to create from the data. Select the Create mapping button to create a new object type mapping. In the Create a new object type mapping screen, enter the following information:

    1. Object type - select what object type to create from the data. You must have already created an object type to import the data, as per step (2), above.

    2. Filter data source by IQL - An optional IQL to query the objects fetched from source. If you wish to filter the objects from data, you can accomplish that here.

    3. Identifier case matching - select either:

      1. Case sensitive - Identifiers will be compared respecting case, 'Data Value' will NOT be considered the same as 'data value'.

      2. Case insensitive - Identifiers will be compared ignoring case, 'Data Value' will be considered the same as 'data value'.

    4. Missing objects - select from:

      1. Remove - Only entries from the import will persist as Insight object/s. Any object manually created in Insight will be deleted.

      2. Update - All objects in Insight not present in the import will have an attribute edited.

      3. Ignore - Object in Insight that is not found in the import won't be removed or updated.

    5. Missing objects outbound references - select from:

      1. Remove - Only outbound references from the import will persist as Insight references. Any outbound references manually created in Insight will be deleted.

      2. Ignore - Outbound references in Insight that aren’t found in the import won't be removed or updated.

    6. Empty values - When an object is updated, choose if empty values from the external source should remove the existing value. Select from:

      1. Use default - use the value specified in the “Define import structure” screen for this object type.

      2. Remove - remove the current value for this object type.

      3. Ignore - keep the current value for this object type.

    7. Unknown values - When an object is updated, should unknown values from the external source be added to the Insight attribute configuration. Select from:

      1. Use default - use the default value.

      2. Add - add the two values together.

      3. Ignore - keep the current value.

  6. Select Create.

 

How to import data into Insight

  1. There are four steps when importing your data into Insight:

    1. Prepare your data.

    2. Create an import structure;

    3. Map your data. There are two options:

      1. Map your data automatically by automatically creating object types and attributes, or;

      2. Map your data manually by:

        1. Using object type mapping to create Insight object types

        2. Using object type attribute mapping to create Insight attributes and references

        3. Using child object type mapping to create hierarchical parent and child structures.

    4. After you have created your object type mappings you must enable them. The import structure will not be executable until all object type mappings are set to ENABLED. If your object type mappings are not enabled, right-click on your object type mapping and click Enable to enable them.

    5. Execute the import.

 

Additional Help