• Get started
  • Documentation

What are imports?

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

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

Currently, you can import data from CSV, JSON, and Assets Discovery. You can also use our REST API framework to import data from external sources. Learn more about importing using the Imports REST API guide in our developer documentation section.

Assets 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 Assets 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, Assets will create a default structure and configuration based up on the type of data you are importing, for example, a CSV, JSON, or Assets 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 Assets:

  • 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 Assets, 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 Assets

  1. There are five steps when importing your data into Assets:

    1. Prepare your data.

    2. Create an import structure. There are four different types of import available:

      1. Discovery. Learn more about how to bring data from Discovery into Assets.

      2. CSV. Learn more about how to configure your CSV for importing.

      3. JSON import. Learn more about importing data from a JSON file.

      4. External import. Learn more about how to develop an app to import data into Assets.

    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 Assets object types

        2. Using object type attribute mapping to create Assets 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.

Still need help?

The Atlassian Community is here for you.