Property :: createVersion - Create new instance version

The function creates a new version for an owner or instance scope with the next higher version number. In case of owner scope versioning, the property handle has to refer to a global instance (owned by a database extent). Database entries belonging to the versioning scope (owner or instance) automatically get a new version when being updated. Before changing version, updates will be saved. The function will reset selections in all subordinated properties. The new version for the instance will be read.

Creating new versions for synchronized versioning modes creates a new database version. Moreover, versions for all extents (global collections) are set to the last database version.

The function throws an exception when the versioning scope for the database is not owner or instance, when no instance is selected or when the instance cannot be updated (read-only). When no versioning mode had been defined so far, the versioning mode is set to owner.

In order to create a new version in case synchronized versioning modes, it is suggested to call Database::createVersion() and Property::updateInstanceVersion() afterwards.