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
| Property | Description | Values | Mandatory |
|---|---|---|---|
condition | Decides whether the scope installs. See Supported condition values. | string | Yes |
targetApplicationKey | Key of the application this scope’s space and objects belong to. | string | Yes |
Supported condition values
| Value | Description |
|---|---|
always | Install unconditionally. |
targetSpaceApplicationEmpty | Install only when this scope’s space has no objects of the target application yet. See targetSpaceApplicationEmpty. |
targetApplicationEmpty | Install 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.
updatableData | Install of a newer version |
|---|---|
false or missing | Adds what is new; never changes or removes installed data. |
true | Compares 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 package | Effect on the instance |
|---|---|
| Object, relation or space added | Created. |
| Object name, parent or attribute value changed | Updated. Attributes users added and edits to properties the package did not change are kept. |
| Object, relation or space removed | Removed. |
| Removed item declared again later | Restored as the same item. |
| Object a user moved out of its declared space | Never 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 owns | Kept 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.