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

サマリー

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

使用法

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

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

  • ライセンス:
    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

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/mygeodatabase@gdb.sde"
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, "")

関連トピック