• Products
  • Get started
  • Documentation
  • Resources

Create attributes and references from your data

Insight in Jira Service Management is a Premium and Enterprise only feature. Learn more about Insight.

To import data into Insight in Jira Service Management, you must first create an import connection, and then you must map the data into Insight using object type mapping.

Next, you can map attributes from the data using object type attribute mapping. Additionally, if you want to create references in your object schema you can use object type attribute mapping and placeholders to map these references into Insight.

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 map in Insight, you must create an object type.

  4. For each attribute or reference that you want to map in Insight, you must create an attribute.

 Create attributes from data using object type attribute mapping

  1. In the Import tab, click on the Import Configuration to expand it.

  2. In the Import Configuration, click on the Object type mapping to expand it.

  3. For each attribute you want to add to the object type:

    1. Select a Data Locator. The data locator specifies the location of the data in the import configuration.

    2. Select an Insight Attribute to map with the Data Locator.

    3. Click Add, at right.

Create references from data using object type attribute mapping and placeholders

  1. In the Import tab, click on the Import Configuration to expand it.

  2. In the Import Configuration, click on the Object type mapping to expand it.

  3. For each reference you want to add to the object type:

    1. Select a Data Locator. The data locator specifies the location of the data in the import configuration.

    2. Select an Insight Attribute to map with the Data Locator.

    3. Use the Object Mapping (IQL) column to enter IQL that maps the label of the reference to a placeholder for the data locator.

      1. If you are mapping only one reference from the data, enter Label = ${Locator} where Locator is replaced by the name of the Locator.

      2. If you are mapping multiple references from the data, enter Label IN ( ${Locator${0}} ) where Locators is replaced by the name of the Locators.

    4. Click Add, at right.

 

Next steps

  1. Use child object type mapping to create hierarchical parent and child structures (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 5:09 AM on Apr 12, 2021 |

Additional Help

Ask the Community