Alter Version (Data Management)

Summary

The Alter Version tool allows you to change the geodatabase version's name, description, and access permissions.

Usage

• Versioning tools only work with enterprise, workgroup, and desktop geodatabase data. Personal and file geodatabases do not support versioning.
• Versions are not affected by changes occurring in other versions of the geodatabase.
• A version's permission can only be changed by the version owner.
License:

Versions can only be created and edited with the ArcGIS for Desktop Standard and ArcGIS for Desktop Advanced license levels.

Syntax

AlterVersion_management (in_workspace, in_version, {name}, {description}, {access})

Parameter	Explanation	Data Type
in_workspace	The database connection file to the enterprise, workgroup, or desktop geodatabase where the version to be altered is located. The default is to use the workspace defined in the Current Workspace environment.	Workspace
in_version	The name of the version to be altered.	String
name (Optional)	If you are changing the version name, enter the new name for the version.	String
description (Optional)	If you are changing the version description, enter the new description for the version.	String
access (Optional)	Specify the access permission you want to set for the version. The following values are supported: PRIVATE —Only the owner may view the version and modify available feature classes. This is the default. PUBLIC — Any user may view the version and modify available feature classes. PROTECTED —Any user may view the version, but only the owner may modify available feature classes.	String

Code Sample

AlterVersion example:

The following stand-alone Python script uses the AlterVersion geoprocessing tool to alter a version.

# Name: AlterVersion_Example.py
# Description: Changes the name of a version

# Import system modules
import arcpy

# Set local variables
inWorkspace = "c:/ConnectionFiles/[e-mail]"
versionName = "myVersion"
newName = "myVersion2"

# Execute AlterVersion
arcpy.AlterVersion_management(inWorkspace, versionName, newName, "#", "PUBLIC")

Environments

Current Workspace

Licensing Information

ArcGIS for Desktop Basic: No

ArcGIS for Desktop Standard: Yes

ArcGIS for Desktop Advanced: Yes