• 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 configuration, 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 configuration.

  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. Select an Object schema.

  2. Select Configure, then choose the Import tab.

  3. In the Import tab, click on the Import Configuration you have created to expand it.

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

    1. Object - 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. Description - the description for this mapping.

    3. Selector - If you are importing from a large data source, you can use a selector to specify a subset of your data to import. The selector is in a formatted specific to the data type that you are importing.

      1. CSV - No selector is permitted.

      2. JSON - Only JSON arrays in the format [[Attribute.*[Attribute]] are permitted.

      3. Discovery - No selector is permitted.

    4. 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.

    5. Match identifier - 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'.

    6. 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.

    7. Threshold number - The number of executions before removing or updating objects.

    8. 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 default value.

      2. Remove - remove the current value.

      3. Ignore - keep the current value.

    9. 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.

  5. Select Save Object Type Mapping.

  6. Every object imported into Insight will require at least one attribute - the data locator that lets Insight know how to differentiate objects in the data. Select the object type mapping to expand it. Your object type attribute will be disabled until you supply a data locator for the name of the objects.

  7. Select the data locator from the list of values. Now that you have a data locator selected, when you run the import one object will be created for each unique data locator value. If there are multiple data locator values, extra objects will be overwritten.

  8. Select Update.


Next steps

  1. Use object type attribute mapping to create Insight attributes and references (optional).

  2. Use child object type mapping to create hierarchical parent and child structures (optional).

  3. After you have created your object type mappings you must enable them. The import configuration will not be executable until all object type mappings are set to Enabled. Right-click on your object type mapping and select Enable to enable the new object mapping(s).

  4. Execute the import.

Additional Help