• Products
  • Get started
  • Documentation
  • Resources

Create a parent and child hierarchy for your data

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 data into Insight, you must first create an import connection, and then you must map the data into Insight using object type mapping.

If you want to create a hierarchy of imported objects when mapping your data into Insight, you can use a Child object type mapping to automatically link the child object types to the parent object type. This will cause the child object types to inherit all of the attributes of the parent object types.

Before you begin

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

  2. You must create an import configuration.

  3. For each parent object that you want to map in Insight, you must create an object type.

  4. In the parent object type, you must allow the attributes to be inherited by object type children. You must do this before creating any child object types.

  5. For each child object that you want to map in Insight, you must create an object type.

Create a parent and child hierarchy for your data using child object type mapping

  1. Select a relevant 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. Click on Create Child Object type mapping button to create a new object type mapping.

  5. In the Create a new object type mapping pop-up, enter the following information:

    1. Object - select what object type to create from the data. You must have already created an object type to hold the data.

    2. Description - the description for this mapping.

    3. Selector - The selector cannot be modified on child object type mappings.

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

    5. Match identifier - The match identifier cannot be modified on child object type mappings.

    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 - Unknown values options cannot be modified on child object type mappings.

  6. Click Save Object Type Mapping.

  7. 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. Click on 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.

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

  9. Click Update, to the right.

Next steps

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

  2. 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 click Enable to enable the new object mapping(s).

  3. Execute the import.

Last modified on Apr 1, 2021
Cached at 7:03 PM on Oct 27, 2021 |

Additional Help