• Products
  • Get started
  • Documentation
  • Resources

Jira Automation docs have moved

All content related to Jira Cloud Automation, previously under the Automate your Jira processes and workflows section, have moved to the new Cloud Automation docs.

Go to Cloud Automation documentation | Why did we do this?

Create attributes and references from 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 in Jira Service Management, you must first create an import structure, 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 structure.

  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. 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 view the object type mappings.

  5. Select Edit attributes mapping to view the attribute type mappings.

  6. Every object imported into Insight will require at least one piece of information - the data locator that lets Insight know how to differentiate objects in the data.

    1. Select a Data source field. The data source field specifies the location of the data in the import configuration. Your object type attribute will be disabled until you supply a data locator for the name of the objects.

    2. Select a Destination attribute to map with the Data Locator.

    3. Optionally, you can modify the default settings for this attribute mapping:

      1. IQL - enter an IQL statement here to create references from data.

      2. Concatenator - enter an alternative concatenator here that applies only to this attribute mapping.

      3. Regular expression - enter a regular expression here (regex) that applies only to this attribute mapping.

      4. Base 64 - enter an alternate Base 64 value here.

  7. Click Add, at right.

Create references from data using object type attribute mapping and placeholders

  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 view the object type mappings.

  5. Select Edit attributes mapping to view the attribute type mappings.

  6. 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 (Insight Query Language (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 Locator is replaced by the name of the Locator.

    4. Click Add, at right.

If you want to create multiple references from a single field in your data source, use double pipes “||” (CSV or JSON format) or a comma “,” (JSON format only) to separate multiple values.

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