ジオプロセシング サービスの例: ジオデータベースのバーションのリスト表示、作成、および削除

複雑度: 初心者データ要件: ArcGIS Tutorial Data for Desktop

このサンプルについて

フォルダー	GDBVersions
目的	ArcGIS サーバーを介してこれらのツールを使用し、エンタープライズ ジオデータベース内のバージョンをリスト表示、作成、および削除します。
サービス	GDBVersions (ジオプロセシング サービス)
ジオプロセシング タスク	ListVersions、CreateVersion、DeleteVersion
入力	エンタープライズ ジオデータベース - 作成または削除するバージョン名
出力	ListVersions は、ジオデータベース内のバージョンのテーブルを出力します。
データ	ユーザーは、エンタープライズ ジオデータベースを指定する必要があります。
拡張子	なし

対応するフォルダー

この例のデータは、ArcGIS.com からダウンロードできます。ダウンロードしたら、その zip ファイルを C:\arcgis\ArcTutor に解凍します。GP Service Examples\GDBVersions フォルダーに、完全なモデルと Python スクリプトが含まれています。

このサンプルについて

この例では、ジオデータベースのバージョンを管理するタスクを含むジオプロセシング サービスを、作成および使用する手順について詳細に示します。このサービスで使用する、ListVersions、CreateVersion、DeleteVersion の各モデル ツールは、[データ管理] ツールボックスの [バージョン] ツールセットに含まれるツールから生成されます。これらのジオプロセシング タスクによって、ジオデータベース内のバージョンのリスト表示、バージョンの新規作成、または既存バージョンの削除を行うことができます。アプリケーションは、これらのツールを使用して、マップ サービスやフィーチャ サービスに関連するバージョン対応の編集ワークフローをサポートできます。アプリケーションの要件によっては、必ずしもすべてのタスクを公開する必要がない場合があります。たとえば、アプリケーションでバージョンの切り替えのサポートのみが必要な場合は、ListVersions タスクのみが必要です。

データ

この例では、ジオプロセシング サービスを介してユーザーに公開するバージョンが存在する、既存のエンタープライズ ジオデータベースが必要です。

モデルとツールのデータ

ジオプロセシング サービスのツールボックスは、[GDBVersions.tbx] です。

モデルの概要

このモデルをよく理解するには、[GDBVersions.tbx] ツールボックスを展開してください。

ListVersions

ListVersions モデル を右クリックして、[編集] を選択し、ModelBuilder でモデルを開きます。ListVersions モデルを以下の図に示します。1 つの入力変数、Enterprise_GDB があります。モデルを実行するときに、使用するエンタープライズ ジオデータベースへの接続を指定する必要があります。

[VersionListToTable] ツールは、[GDBVersions.tbx] でも提供されているスクリプト ツールです。次のようにして、ツールが実行する Python コードを確認できます。VersionListToTable スクリプトを右クリックし、[編集] を選択して、デフォルトの Python IDE で Python コードを開きます。このスクリプトは、出力テーブルを作成し、Enterprise_GDB 接続で指定したユーザーが保有する、パブリック、プロテクト、およびプライベートの各バージョンに関する情報をそのテーブルに取り込みます。

メモ:

接続でオペレーティング システムの認証を使用している場合、それらのバージョンには、ArcGIS Server を実行するアカウントが保有する、パブリック、プロテクト、およびプライベートの各バージョンも含まれます。通常の ArcGIS のインストールでは、サーバーは、インストール時に作成されて構成された ArcGIS のアカウントによって実行されます。

アプリケーションの仕様を満たすバージョンのみを返すように、コードを変更することもできます。

出力テーブルには、各バージョンに関する以下の情報が含まれます。

フィールド	説明
name	バージョンの完全修飾名
access	バージョンが、パブリック、プライベート、またはプロテクトのいずれであるかを示します。
created	バージョンが作成された日付
description	バージョンと共に保存されている説明
isowner	接続したユーザーがバージョンを保有しているかどうかを示します。
lastmodified	バージョンを最後に変更した日付
parentversionname	親バージョンの名前

デフォルトでは、versions というメモリ内テーブルが作成されます。入力ジオデータベースに書き込まれるテーブルを作成するように、モデルを変更することもできます。ListVersions ツールを実行するたびに、以前に作成されたテーブルは削除されて新しいテーブルに置き換えられます。

CreateVersion

CreateVersion モデルを右クリックして、[編集] を選択します。CreateVersion モデルを以下の図に示します。入力変数は、作成する新しいバージョンのバージョン名および Enterprise_GDB の 2 種類です。モデルを実行するときに、使用するエンタープライズ ジオデータベースへの接続を、前に ListVersions モデルに指定したとおりに、Enterprise_GDB パラメーターで指定する必要があります。このモデルを他のモデルと共に公開する予定の場合、必ずそれらと同じエンタープライズ ジオデータベース接続を参照するようにしてください。

CreateVersion ツールは、Enterprise_GDB で参照されるエンタープライズ ジオデータベースに、バージョン名パラメーターで指定された名前を使用して新しいバージョンを作成します。このモデルでは、バージョンは、デフォルトのバージョンからプライベートとして作成されます。これらのパラメーターは、アプリケーションに合わせて変更できます。タスクまたはサービスの実行時に、すでに存在するバージョンを作成しようとした場合、エラーが返されます。

DeleteVersion

DeleteVersion モデル を右クリックして、[編集] を選択し、ModelBuilder でモデルを開きます。DeleteVersion モデルを以下の図に示します。入力変数は、削除するバージョンのバージョン名および Enterprise_GDB の 2 種類です。モデルを実行するときに、エンタープライズ ジオデータベースへの接続を、Enterprise_GDB パラメーターで指定する必要があります。このモデルを他のモデルと共に公開する予定の場合、必ずそれらと同じエンタープライズ ジオデータベース接続を参照するようにしてください。

RemoveVersion ツールは、Enterprise_GDB で参照されるエンタープライズ ジオデータベースから、指定された名前を使用して既存のバージョンを削除します。ツールは、バージョンの削除に成功した場合、True の値を持つ Boolean 変数を出力します。指定される名前は、バージョンの完全修飾名である必要があります。完全修飾名の取得には、ListVersions ツールを使用できます。[RemoveVersion] ツールは、[GDBVersions.tbx] ツールボックスでも提供されているスクリプト ツールです。スクリプト ツールを右クリックして [編集] を選択することで、ツールが実行する Python コードを確認できます。スクリプト ツールは、入力バージョン名を文字列パラメーターで指定して、DeleteVersion ツールを呼び出します。バージョンの削除権限がないか、バージョンが存在しないか、このバージョンに依存する上位バージョンが存在する場合、エラーが返されます。

公開のためのサーバー管理接続の確立

サーバーを公開する権限があることを確認してください。権限がある場合、以下の手順に従って、サーバーへの接続を確立、公開、または管理します。

1. [GIS サーバー] > [ArcGIS Server の追加] に移動し、[ArcGIS Serverの追加] ダイアログ ボックスを開きます。
2. [GIS サービスを公開する] または [GIS サーバーを管理する] をオンにします。
3. [一般] パネルで [サーバー管理 URL] の値を入力し、[ユーザー名] と [パスワード] の値を指定します。
4. [完了] をクリックすると、接続が完了します。

サービスの作成

以下に、3 つのタスクを含むサービスを作成する手順を示します。サービスを作成する前に、まずモデルを実行し、タスクごとに結果を作成する必要があります。公開するタスクに対して結果を 1 つ生成するだけでよい場合は、3 つすべてのタスクを含めなくても構いません。
1. [カタログ] ウィンドウで、C:\arcgis\ArcTutor\GP Service Examples\GDBVersions に移動します。

   モデルを編集する場合があるため、GDBVersions ディレクトリ全体をコピーして、別のローカル ディレクトリに貼り付けておくことをお勧めします。そのディレクトリで、変更することができます。

2. 公開するいずれかのモデル ツールをダブルクリックし、そのダイアログ ボックスを開きます。
3. [Enterprise_GDB] パラメーターに、エンタープライズ ジオデータベースを設定します。
CreateVersion ツールまたは DeleteVersion ツールに対しても、生成または削除するバージョンを指定する必要があります。DeleteVersion に対しては、必ず完全修飾バージョン名を指定してください。
4. [OK] をクリックしてツールを実行します。

   ツールの実行が終了すると、新しい結果が [結果] ウィンドウに書き込まれます。[結果] ウィンドウを開くには、ArcMap メイン メニューで [ジオプロセシング] > [結果] の順にクリックします。

5. [結果] ウィンドウの結果を調べて、ツールが正常に実行されたことを確認します。実行が失敗した場合、結果の横にエラー アイコン が表示されます。
6. 公開するその他のモデル ツールについて、ステップ 1 から 5 までを繰り返します。

ジオプロセシング サービスを作成する手順

ジオプロセシング サービスを作成するには、結果を共有します。

1. [結果] ウィンドウで、上記で生成したいずれかの結果を右クリックし、[共有] > [ジオプロセシング サービス] の順に選択します。[サービスとして共有] ウィザードが開きます。
2. 公開先のサーバー、およびサービスを保存するフォルダーを選択します。サービスのデフォルトの名前は、ツール名と同じです。デフォルトのサービス名を適用するか、新しい名前を入力することができます。
3. [サービスとして共有] ウィザードの最後のパネルで、[続行] をクリックして [サービス エディター] を開きます。
4. 別のタスクを追加するには、[結果の追加] ボタンをクリックして、[結果の追加] ダイアログ ボックスを開きます。[結果の追加] ダイアログ ボックスで、上記の別の結果を選択し、[OK] をクリックします。別のタスクを追加するには、ステップ 4 を繰り返します。

5. [サービス エディター] の [パラメーター] ページで、サービスをすばやく実行するために、[実行モード] を [同期] に変更します。
ジオプロセシング サービスについては、残りのデフォルト値を適用します。[公開] ボタン をクリックして、サービスを公開します。
[サービス エディター] を使用してジオプロセシング サービスを公開する方法について詳しくは、「ジオプロセシング サービスの公開のクイック ツアー」をご参照ください。

ジオプロセシング サービスの使用

次の手順は、前の手順で公開したジオプロセシング サービスを使用する方法を示したものです。

1. 新しい ArcMap ドキュメントを開きます。
2. [カタログ] ウィンドウで、[GIS サーバー] の下のサーバー接続に移動し、前のセクションで公開したジオプロセシング サービスを見つけて展開します。公開済みのタスクが表示されます。
3. [ListVersions] タスクをダブルクリックして、そのタスクのダイアログ ボックスを開きます。
4. [OK] をクリックしてジオプロセシング タスクを実行します。

   出力が、GPInMemoryWorkspace のテーブルとして返されます。このテーブルを開き、エンタープライズ ジオデータベース内のバージョンのリストを表示できます。

5. [CreateVersion] タスクを公開している場合、以下を実行します。
   1. [CreateVersion] タスクをダブルクリックして、そのタスクのダイアログ ボックスを開きます。
   2. 作成するバージョンの名前を指定します。
   3. [OK] をクリックしてジオプロセシング タスクを実行します。
   4. ステップ 1 ～ 4 を繰り返します。新しいバージョンが新しい出力テーブルに表示されていることに注目してください。
6. [DeleteVersion] タスクを公開している場合、以下を実行します。
   1. [DeleteVersion] タスクをダブルクリックして、そのタスクのダイアログ ボックスを開きます。
   2. 削除するバージョン (たとえば、上記の手順で作成したバージョン) の完全修飾名を指定します。
   3. [OK] をクリックしてジオプロセシング タスクを実行します。
   4. ステップ 1 ～ 4 を繰り返します。バージョンが削除されたために、新しい出力テーブルに表示されないことに注目してください。