更改版本 (数据管理)

摘要

更改地理数据库版本属性。

使用情况

• 版本管理工具仅适用于企业级地理数据库数据。 文件地理数据库不支持版本管理。

• 当输入工作空间为数据库连接文件时，地理数据库管理员可以更改分支版本的版本名称、访问权限和目标所有者属性。 版本描述只能由版本所有者更改。

许可：

在 ArcGIS Enterprise 11.2 或更高版本的部署中使用分支版本控制时，必须为组织成员分配 ArcGIS Advanced Editing 用户类型扩展模块的许可，才能使用此工具。

参数

对话框

标注	说明	数据类型
输入工作空间	要更改的版本所在的企业级、工作组或桌面地理数据库的数据库连接文件。 对于分支版本化，请使用要素服务 URL（即 https://mysite.mydomain/server/rest/services/ElectricNetwork/FeatureServer）或要素图层门户项目。	Workspace
输入版本	要更改的版本的名称。 如果要更改作为地理数据库管理员连接的分支版本的数据库连接，则版本名称必须包括服务名称，例如myservice.versionowner.versionname。	String
版本名称 (可选)	新版本的名称。	String
版本描述 (可选)	新版本的描述。	String
访问权限 (可选)	指定版本的访问权限。 如果未指定值，则访问权限将不会更新。 私有—只有所有者可以查看该版本并修改可用的要素类。 公共—任何用户都可以查看该版本并修改可用的要素类。 受保护的—任何用户都可以查看该版本，但只有所有者才能修改可用的要素类。	String
目标所有者 (可选)	版本所有权将转移到的门户用户的名称。 确保目标所有者用户存在；工具不会检查指定的所有者名称的有效性。 此参数仅适用于分支版本。	String

派生输出

标注	说明	数据类型
更新的地理数据库	更新的工作空间。	Workspace

Python

arcpy.management.AlterVersion(in_workspace, in_version, {name}, {description}, {access}, {target_owner})

名称	说明	数据类型
in_workspace	要更改的版本所在的企业级、工作组或桌面地理数据库的数据库连接文件。 默认情况下，使用当前工作空间环境中定义的工作空间。 对于分支版本化，请使用要素服务 URL（即 https://mysite.mydomain/server/rest/services/ElectricNetwork/FeatureServer）或要素图层门户项目。	Workspace
in_version	要更改的版本的名称。 如果要更改作为地理数据库管理员连接的分支版本的数据库连接，则版本名称必须包括服务名称，例如myservice.versionowner.versionname。	String
name (可选)	新版本的名称。	String
description (可选)	新版本的描述。	String
access (可选)	指定版本的访问权限。 如果未指定值，则访问权限将不会更新。 PRIVATE—只有所有者可以查看该版本并修改可用的要素类。 PUBLIC—任何用户都可以查看该版本并修改可用的要素类。 PROTECTED—任何用户都可以查看该版本，但只有所有者才能修改可用的要素类。	String
target_owner (可选)	版本所有权将转移到的门户用户的名称。 确保目标所有者用户存在；工具不会检查指定的所有者名称的有效性。 此参数仅适用于分支版本。	String

派生输出

名称	说明	数据类型
out_workspace	更新的工作空间。	Workspace

代码示例

AlterVersion 示例 1 （独立脚本）

以下独立 Python 脚本使用 AlterVersion 工具更改版本。

# Description: Changes the name of a version

# Import system modules
import arcpy

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

# Run AlterVersion
arcpy.management.AlterVersion(inWorkspace, versionName, newName, "#", "PUBLIC")

AlterVersion 示例 2 （独立脚本）

以下独立 Python 脚本使用 AlterVersion 工具更改分支版本。

# Description: Changes the description of a version

# Import system modules
import arcpy

# Set local variables
inWorkspace = "https://myserver.mydomain.com/server/rest/services/MyService/FeatureServer"
versionName = "portaluser1.myVersion"
newDesc = "Ready for reconcile and post"

# Sign in to ArcGIS Enterprise
arcpy.SignInToPortal("https://myserver.mydomain.com/portal", 'portaluser1', 'my.password')

# Run AlterVersion
arcpy.management.AlterVersion(inWorkspace, versionName, "", newDesc, "")

环境

当前工作空间