importFieldMapping is null

Author: Riya Ray

Date: July 7, 2025

Audience: Everyone

Environmental details: Self-hosted, Replicated - KOTS and Cloud-hosted instances

Summary

When trying to do a Round-trip Excel import into Jama, you get the following error:

This happens because one of the field's defined in a custom itemType uses a reserved word as its "Unique Field Name".

Solution

It is not possible to update a Unique Field Name of an already defined custom Field. The solution would be to delete the concerned field and create a new field with a different "Unique Field Name".

For example, in this case, the Unique Field Name was defined as "action", which is a reserved word.

The custom field (Action "action") was then deleted and recreated with the Unique Field Name as "action_action".

Cause

This error is thrown if one of the fieldNames in an itemType is using a reserved word as its Unique field Name.

Prevention

When creating a new field for an itemType, make sure that the Unique Field Name is not using a reserved word.

Additional References

Please feel free to leave feedback in the comments below.

Related to