dataInstall decides whether a data scope’s content installs. Mandatory on every scope.

Minimal JSON

{
    "condition": "",
    "targetApplicationKey": ""
}
{
    "condition": "targetSpaceApplicationEmpty",
    "targetApplicationKey": "core_data_catalog#core_data_catalog_app"
}

Nested properties

PropertyDescriptionValuesMandatory
conditionDecides whether the scope installs. See Supported condition values.stringYes
targetApplicationKeyKey of the application this scope’s space and objects belong to.stringYes

Supported condition values

ValueDescription
alwaysInstall unconditionally.
targetSpaceApplicationEmptyInstall only when this scope’s space has no objects of the target application yet. See targetSpaceApplicationEmpty.
targetApplicationEmptyInstall only when the target application holds no objects anywhere, including this scope’s own space. See targetApplicationEmpty.

targetSpaceApplicationEmpty

A space the package hasn’t created yet also counts as empty. The check runs per (space, application) pair, so the same application already holding objects in a different space doesn’t block this scope. Export object data always writes this condition.

targetApplicationEmpty

Even a brand-new space skips installation if the application already has objects elsewhere. Use this condition when a package owns the application outright: the skip reason then names only the application and object count, since no single space drives the decision.

Updating installed data with updatableData

The package header flag updatableData (boolean, default false) decides what installing a newer version does. The first install is always additive. Export object data sets the flag from its Update installed data with each new version setting.

updatableDataInstall of a newer version
false or missingAdds what is new; never changes or removes installed data.
trueCompares the new version with the last installed one and applies the difference.

With true, install applies the difference to objects, relations and spaces:

Change in the packageEffect on the instance
Object, relation or space addedCreated.
Object name, parent or attribute value changedUpdated. Attributes users added and edits to properties the package did not change are kept.
Object, relation or space removedRemoved.
Removed item declared again laterRestored as the same item.
Object a user moved out of its declared spaceNever renamed, re-parented, updated or removed. A removed one is kept, released from the package and a warning is written; a still-declared one is skipped with a warning.
Relation another package still ownsKept on install and on rollback, with a warning.

Rollback applies the difference toward the older version the same way. A run that stops half-way is finished by installing (or rolling back to) the same target version again; until then other operations on the package are refused.