• 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, Insight Discovery, and external sources.

Insight can store and run multiple imports of different types. An import structure 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 structure, you have the option of manually or automatically creating object types and attributes. If you choose to automatically create object types and attributes, Insight will create a default structure and configuration based up on the type of data you are importing, for example, a CSV, JSON, or Insight Discovery file. You also have the option of creating an import manually - this means you will have to 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 structure, map your data (either automatically or manually), and then execute the import.

How to import data into Insight

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