バージョニングでは、複数のユーザーが独自バージョンの空間データの操作を実行し、[ジオプロセシング サービスの実行] ステップを使用して、デフォルトのブランチ バージョンへの編集をリコンサイルおよびポストできるようにします。 これにより、ユーザーが適切なタイミングで適切なデータにアクセスでき、編集の競合を避けることができます。
ステップが実行されると、ワークフローで定義された各フィーチャ サービス データ ソースに、既存のジョブ固有のバージョンのデータがあるかどうかをチェックします。 データ ソースにジョブ固有のバージョンが含まれていない場合、[バージョンの作成] ステップは自動的にバージョンを作成し、ジョブに関連付けます。 [バージョンの作成] ステップは、ジョブのワークフロー ダイアグラムで定義されたデータ ソースに対して、フィーチャ サービスごとに 1 つのジョブ バージョンの作成のみをサポートしています。
注意:
ジョブにデータ ソースのプライベート バージョンがすでに存在する場合、既存のプライベート バージョンの所有者でないユーザーがステップを実行すると、データ ソースの新しいバージョンが作成されます。
同じジョブ名を持つパブリック バージョンがすでに存在する場合、[バージョンの作成] ステップは失敗します。 既存のバージョンはジョブに関連付けられておらず、新しいバージョンは作成されません。
ステップの実行が終了すると、ステップの結果を示すメッセージがジョブ タイルに表示されます。
ステップにデータ ソースが定義されていない場合、またはステップがバージョンの作成に失敗した場合は、[CreateVersionFailed] メッセージが表示され、ジョブは次のステップに進まなくなります。 エラー メッセージ上にカーソルを置くと、エラーに関する追加情報が表示されます。
ステップが失敗し、リターン コードがどの構成済みパスとも一致せず、ステップがオプションでない場合、ステップは失敗状態のままで、スキップできません。
ステップの構成
ステップを構成するには、次の手順に従います。
- ワークフロー ダイアグラムを作成または編集し、[ステップ ライブラリ] パネルにアクセスします。
- [バージョンの作成] を [ステップのライブラリ] パネルからワークフロー キャンバス上のステップの接続矢印にドラッグします。
[ステップの詳細] パネルが表示されます。
- [ステップ名] テキスト ボックスにステップの名前を入力します。
- 必要に応じて、[バージョン名] テキスト ボックスにバージョンの名前を入力します。
注意:
一意の ID をバージョン名に追加するには、一意の ID をバージョン名に表示する場所に [index] と入力します。
- 必要に応じて、[アクセス権限] セクションでバージョンの権限レベルを構成します。
注意:
アクセス権限設定では、バージョンの所有者以外のユーザーによるバージョンの表示または編集を制限することができます。 デフォルトは [プライベート] です。
- [データ ソース] セクションで、次のオプションのいずれかを選択します。
- [すべて] - このオプションを選択すると、ワークフロー ダイアグラムで構成されたすべてのデータ ソースのバージョンが作成されます。
- [ソースの選択] - このオプションを選択して [ソースの追加] をクリックし、バージョンを作成するデータ ソースを選択します。
ヒント:
データ ソースを削除するには、[削除] ボタン
をクリックします。 - [Arcade 式] - ステップの実行時にバージョンが作成されるデータ ソースを動的に決定するには、このオプションを選択して、ArcGIS Arcade 式を入力します。
Arcade 式は空間データ ソース名ではなく、空間データ ソース ID を返す必要があります。 複数のデータ ソースを選択する必要がある場合、次のように式の書式を設定する必要があります。
'["' + JobExtendedProperty($Job, 'versions', 'datasource1') + '"' + ',' + '"' + JobExtendedProperty($Job, 'versions', 'datasource2') + '"]'ヒント:
[この入力は Arcade 式をサポートします] ボタン
をクリックし、ArcGIS Arcade 式を選択して関連するテキスト ボックスに追加します。
- [オプション] タブをクリックします。
- 必要に応じて、[ステップ オプション] を構成します。
- [手動] - 手動でステップを実行します。
- [オプション] - ステップを実行しないで終了できるようにします。
- [自動] - アクティブになり次第、ステップを実行します。
注意:
ワークフロー ダイアグラムがデータ品質の評価ステップまたはジオプロセシング サービスの実行ステップを含む一連のステップを自動的に実行するように構成されている場合、一連のステップを開始したユーザー トークンの有効期限が切れた後に実行を試みるステップは、自動的に実行されません。 手動操作なしで、追加の自動ステップを続行するには、ArcGIS Workflow Manager Server Advanced ロールのライセンスが必要です。
- [スケジュールに沿って実行] - 設定したスケジュールに従ってステップを実行します。
- [手動] - 手動でステップを実行します。
- 必要に応じて、[ステップ ヘルプ] テキスト ボックスにステップのヘルプ テキストを入力します。
ArcGIS Arcade 式を使用して、ステップ ヘルプの動的な値を入力することもできます。 ステップ ヘルプにプレーン テキストと Arcade 式が含まれている場合は、テキストを次のように書式設定する必要があります。
'For further assistance, please contact ' + JobCreator($Job) + '.' - 必要に応じて、[スタイル] タブをクリックし、ステップの形状と色を変更します。
- 必要に応じて、[情報] タブをクリックし、[ステップの説明] テキストボックスにステップの説明を入力します。
注意:
[情報] タブには、ステップの出力を取得するために動的なジョブ プロパティで使用できるステップ ID も含まれています。
戻り値
ステップが完了すると、その戻り値が格納され、ステップの結果を示します。 パスを使用して戻り値をすぐに評価し、ワークフロー内の次のステップを決定できます。 ArcGIS Arcade 式を使用して、ワークフロー全体を通じて完了したステップの戻り値を取得することもできます。 次の表は、ステップの戻り値を示しています。
| 戻り値 | 説明 |
|---|---|
| S000001 | ステップが正常に完了しました。 |
F000001 | ステップを正常に完了できませんでした。 |
出力値
ステップが完了すると、その出力値が格納され、ワークフローがたどるパスの決定に使用したり、ワークフロー全体で他のステップの入力値として使用したりできます。 次の表は、ステップの出力値を示しています。
| 出力 | 説明 |
|---|---|
| バージョン | 作成したすべてのバージョンの配列を返します。 |
dataSources | バージョンが正常に作成されたすべてのデータ ソースの URL の配列を返します。 |