Last updated Oct 7, 2021

Rate this page:

Insight imports

About

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. Each of these import types is called a module.

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.

For more information or to try out imports in Insight you can follow our documentation at https://support.atlassian.com/jira-service-management-cloud/docs/what-does-importing-into-insight-involve/

Types of imports

We can divide Insight import sources between file-based and external import sources.

File based imports

File based imports are performed manually by customers uploading a file with data to Insight and setting a mapping configuration to transform its contents into Insight objects.

The file types supported are:

  • Json
  • CSV
  • Discovery zip files

External imports

External imports are those where an external application or script pushes data to Insight directly, without the user having to handle a file upload manually.

The external application also handles the creation of an object schema and import mapping configuration.

Authentication and authorization for imports

While file based imports follow Insight's conventions regarding authorization, external imports authentication and authorization is handled entirely with OAuth tokens. Insight administrators will be able to obtain a token when they configure the import source in Insight's UI, and external applications or scripts can use it to call all the related APIs.

Rate this page: