Skip to main content

Alter Version (Data Management Tools)

Summary

Alters the properties of a geodatabase version.

Usage

  • When the input workspace is a database connection file, the version name, access, and target owner properties of a branch version can be altered by the geodatabase administrator. The version description can only be altered by the version owner.

    License:

    When working with branch versioned data from a web feature layer data source, organization members may need the ArcGIS Advanced Editing user type extension. For more information, see License requirements for the Version Management service.

Parameters

Label Explanation Data type

Input Workspace

The database connection file to the enterprise, workgroup, or desktop geodatabase where the version to be altered is located.

For branch versioning, use a feature service URL (that is, https://mysite.mydomain/server/rest/services/ElectricNetwork/FeatureServer) or the feature layer portal item.

Workspace

Input Version

The name of the version that will be altered. If altering a branch version from a database connection connected as the geodatabase administrator, the version name must also include the service name, for example, myservice.versionowner.versionname.

String

Version Name

(Optional)

The new name of the version.

String

Version Description

(Optional)

The new description of the version.

String

Access Permission

(Optional)

Specifies the access permission for the version. If no value is specified, the access permission will not be updated.

  • PrivateOnly the owner can view the version and modify available feature classes.

  • PublicAny user can view the version and modify available feature classes.

  • ProtectedAny user can view the version, but only the owner can modify available feature classes.

String

Target Owner

(Optional)

The name of the portal user to which the version ownership will be transferred. Ensure that the target owner user exists; the tool does not check the validity of the owner name specified. This parameter is only applicable for branch versions.

String

Derived output

Label Explanation Data type

Updated Geodatabase

The updated workspace.

Workspace

Environments

Current Workspace

Licensing information

  • Basic: Limited
    Supported for branch versioning when using named user licensing.
  • Standard: Yes
  • Advanced: Yes