KB-1302 "The content <id> was not imported because a required reference is missing: Reference to entity <entity> in data store <data store> cannot be found" error thrown when importing an updated data store with new entities

Symptoms

When importing an updated data store with new entities, any object referencing the new entity in the package fails to import. The import log throws an error saying that the object failed to import due to a missing entity in the data store:

Problems (1):
content xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx "<name>": The content [id= uuid=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx] was not imported because a required reference is missing: Reference to entity [xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx] in data store [id=1074 uuid=_a-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_1101] cannot be found. (APNX-1-4070-004) (APNX-1-4071-006)

Cause

This issue has been resolved via AN-50362 in Appian 16.3.

Action

Upgrade to the latest version of Appian to take advantage of the fix.

Workaround

To work around this issue, perform one of the following:

1. Try importing the package twice.
2. Split up the package into two imports. First, import a patch that contains only the updated data store and any relevant CDTs. Publish the new version of the data store and verify mappings. Then, import the other objects in a separate package.

Affected Versions

This article applies to Appian 16.2 and earlier.