Create objects from data using object type mapping

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.

 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.