• Products
  • Get started
  • Documentation
  • Resources

Create objects from data using object type mapping

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

To import information into Assets in Jira Service Management you’ll need to create an import structure, map your data, and then execute the import.

If you decide to manually map your data into Assets, you will create need to create objects from your data using object type mapping.

 

Before you begin

  1. You must prepare your data for importing into Assets.

  2. You must create an import structure.

  3. For each type of object that you want to import into Assets, create an object type.

 Create objects from data using object type mapping

  1. From your service project, go to Assets > Object schemas.

  2. Select an Object schema.

  3. Select Schema configuration, then choose the Import tab.

  4. Select Edit mapping on your import structure to expand it.

  5. You must create a separate object type mapping for each object type that you wish to create from the data. Select the Create mapping button to create a new object type mapping. In the Create a new object type mapping screen, enter the following information:

    1. Object type - select what object type to create from the data. You must have already created an object type to import the data, as per step (2), above.

    2. Filter data source by AQL - An optional AQL to query the objects fetched from source. If you wish to filter the objects from data, you can accomplish that here.

    3. Identifier case matching - select either:

      1. Case sensitive - Identifiers will be compared respecting case, 'Data Value' will NOT be considered the same as 'data value'.

      2. Case insensitive - Identifiers will be compared ignoring case, 'Data Value' will be considered the same as 'data value'.

    4. Missing objects - select from:

      1. Remove - Only entries from the import will persist as Assets object/s. Any object manually created in Assets will be deleted.

      2. Update - All objects in Assets not present in the import will have an attribute edited.

      3. Ignore - Objects in Assets that are not present in the import won't be removed or updated.

    5. Threshold number - the threshold number is the number of times that missing objects from the import source will be ignored before the rule selected in the Missing objects configuration field, above, is applied. This is a safety feature to avoid deleting objects immediately when they are not discovered in the import source data.

    6. Missing objects outbound references - this setting will appear only if you have selected Update or Ignore from Missing objects, above. Select from:

      1. Remove - Remove the outbound reference(s) of the missing object(s) where all the referenced objects of the given attribute are still inside the import.

      2. Ignore - Outbound references in Assets that aren’t found in the import won't be removed or updated.

    7. Empty values - When an object is updated, choose if empty values from the external source should remove the existing value. Select from:

      1. Use default - use the value specified in the “Define import structure” screen for this object type.

      2. Remove - remove the current value. If the attribute is a status, select, or reference type attribute with more than one value, all of the values will be removed.

      3. Ignore - keep the current value for this object type. If the attribute is a status, select, or reference type attribute with more than one value, all of the values will be kept.

    8. Unknown values - When an object is updated, should unknown values from the external source be added to the Assets attribute configuration. Select from:

      1. Use default - use the default value.

      2. Add - add the two values together.

      3. Ignore - keep the current value.

  6. Select Create.

 

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.

Additional Help