バージョン プロパティの変更 (Alter Version) (データ管理)

サマリー

ジオデータベース バージョンのプロパティを変更します。

使用法

  • バージョニング ツールはエンタープライズ ジオデータベース データでのみ機能します。ファイル ジオデータベースは、バージョニングをサポートしていません。

  • 他のバージョンのジオデータベースに対する変更は、このバージョンに反映されません。

  • このツールは、バージョン サービスを通じたブランチ バージョンの変更をサポートしています。

  • 入力ワークスペースがジオデータベース管理者として接続されたデータベース接続ファイルの場合、バージョン名、アクセス、ターゲットの所有者などのブランチ バージョンのプロパティを変更できます。ただし、バージョンの説明はそのバージョンの所有者だけが変更できます。

パラメーター

ラベル説明データ タイプ
入力ワークスペース

変更対象のバージョンが存在するエンタープライズ ジオデータベース、ワークグループ ジオデータベース、またはデスクトップ ジオデータベースに接続するためのデータベース コネクション ファイル。

ブランチ バージョン対応の場合、フィーチャ サービスの URL (すなわち、https://mysite.mydomain/server/rest/services/ElectricNetwork/FeatureServer) またはフィーチャ レイヤーのポータル アイテムを使用します。

Workspace
入力バージョン

変更するバージョンの名前。ジオデータベース管理者として接続されたデータベース接続からブランチ バージョンを変更する場合、バージョン名には myservice.versionowner.versionname のようなサービス名が含まれている必要があります。

String
バージョン名
(オプション)

バージョンの新しい名前

String
バージョンの説明
(オプション)

バージョンの新しい説明

String
アクセス権
(オプション)

そのバージョンのアクセス権を指定します。この値を指定しない場合、アクセス権は更新されません。

  • プライベート所有者に限りバージョンを表示することも、利用可能なフィーチャクラスを変更することもできます。
  • パブリックすべてのユーザーがバージョンを表示することも、利用可能なフィーチャクラスを変更することもできます。
  • プロテクトすべてのユーザーがバージョンを表示できますが、利用可能なフィーチャクラスを変更できるのは所有者だけです。
String
ターゲット所有者
(オプション)

そのバージョンの所有権の移行先のポータル ユーザーの名前。ターゲット ユーザーが存在することを確認してください。ツールでは、指定された所有者名の妥当性チェックは行われません。このパラメーターは、ブランチ バージョン対応にのみ適用されます。

String

派生した出力

ラベル説明データ タイプ
更新されたジオデータベース

更新されたワークスペース。

ワークスペース

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

更新されたワークスペース。

ワークスペース

コードのサンプル

AlterVersion (バージョン プロパティの変更) の例 1 (スタンドアロン スクリプト)

次のスタンドアロン Python スクリプトでは、AlterVersion ツールを使用してバージョンを変更します。

# Description: Changes the name of a version
# Import system modules
import arcpy
# Set local variables
inWorkspace = "c:/ConnectionFiles/mygeodatabase@gdb.sde"
versionName = "myVersion"
newName = "myVersion2"
# Execute AlterVersion
arcpy.AlterVersion_management(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')
# Execute AlterVersion
arcpy.AlterVersion_management(inWorkspace, versionName, "", newDesc, "")

環境

特殊なケース

ライセンス情報

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

関連トピック