Create Version (Data Management)

Summary

Creates a new version in the specified geodatabase.

Usage

• The output version name is prefixed by the geodatabase user name—for example, USER1.arctoolbox.

• The output version's permissions are set to private by default but can be changed using the Alter Version tool.

• File geodatabases do not support versioning. Versioning tools only work with enterprise geodatabases.

• Versions are not affected by changes occurring in other versions of the database.

• A version's permission can only be changed by its owner (the user who created it).

• This tool supports branch versioning through the version service.

Parameters

Dialog

Label	Explanation	Data Type
Input Workspace	The enterprise geodatabase that contains the parent version and will contain the new version. For branch versioning, use a feature service URL (that is, https://mysite.mydomain/server/rest/services/ElectricNetwork/FeatureServer).	Workspace
Parent Version	The geodatabase, or version of a geodatabase, on which the new version will be based.	String
Version Name	The name of the version that will be created.	String
Access Permission (Optional)	Specifies the permission access level for the version to protect it from being edited or viewed by users other than the owner. Private (owner only)—Only the owner or the geodatabase administrator will be able to view and modify the version or versioned data. Public (any user)—Any user will be able to view the version. Any user who has been granted read/write (update, insert, and delete) permissions on datasets will be able to modify datasets in the version. Protected (only the owner can edit)—Any user will be able to view the version, but only the owner or the geodatabase administrator will be able to edit the version or datasets in the version.	String

Derived Output

Label	Explanation	Data Type
Updated Input Workspace	The updated input workspace.	Workspace

Python

arcpy.management.CreateVersion(in_workspace, parent_version, version_name, {access_permission})

Name	Explanation	Data Type
in_workspace	The enterprise geodatabase that contains the parent version and will contain the new version. For branch versioning, use a feature service URL (that is, https://mysite.mydomain/server/rest/services/ElectricNetwork/FeatureServer).	Workspace
parent_version	The geodatabase, or version of a geodatabase, on which the new version will be based.	String
version_name	The name of the version that will be created.	String
access_permission (Optional)	Specifies the permission access level for the version to protect it from being edited or viewed by users other than the owner. PRIVATE—Only the owner or the geodatabase administrator will be able to view and modify the version or versioned data. PUBLIC—Any user will be able to view the version. Any user who has been granted read/write (update, insert, and delete) permissions on datasets will be able to modify datasets in the version. PROTECTED—Any user will be able to view the version, but only the owner or the geodatabase administrator will be able to edit the version or datasets in the version.	String

Derived Output

Name	Explanation	Data Type
out_workspace	The updated input workspace.	Workspace

Code sample

CreateVersion example (stand-alone script)

The following stand-alone script demonstrates how to create a new version.

# Description: Creates a new version

# Import system modules
import arcpy

# Set local variables
inWorkspace = "c:/Connections/[e-mail]"
parentVersion = "dbo.DEFAULT"
versionName = "myVersion"

# Run CreateVersion
arcpy.management.CreateVersion(inWorkspace, parentVersion, versionName, "PUBLIC")

Environments

Current Workspace

Licensing information

• Basic: No
• Standard: Yes
• Advanced: Yes