• Products
  • Get started
  • Documentation
  • Resources

What are imports?

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

Importing is a way to bring outside data into Insight and automatically convert it into Insight object types, objects, attributes and references.

Currently, you can import data from CSV, JSON, and Insight Discovery and there are plans to add data from external databases and the Jira environment itself.

Insight can store and run multiple imports of different types. An import configuration is a package of information about where to find the data and how Insight will manage a specific import task.

When you create a new import configuration, you have the option of creating a predefined structure and/or configuration for the objects that you create. A predefined structure and configuration is a default structure and configuration based upon the type of data you are importing, for example, a CSV, JSON, or Discovery file. You also have the option of creating an import configuration without a predefined structure and configuration - this means you would manually map your data into object types, objects, attributes, and references.

There are several ways to map data into Insight:

  • Use object type mapping to create object types.

  • Use object type attribute mapping to create attributes.

  • Use object type mapping with placeholders to create references.

  • Use child object type mapping to create parent and child hierarchies within your object schema.

To import information into Insight, you’ll need to create an import configuration, map your data, and then execute the import.

How to import data into Insight

There are four steps to importing your data into Insight:

  1. Prepare your data.

  2. Create an import configuration;

  3. Map your data into Insight. There are two options:

    1. Map your data automatically, using a Predefined structure and configuration, or;

    2. Map your data manually:

      1. Use object type mapping to create Insight object types

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

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

  4. Execute the import.

Additional Help