ジオプロセシング サービスの実行ステップは、構成済みのジオプロセシング サービスを実行します。 ステップは、ジオプロセシング ツール、Python スクリプト ツール、ArcGIS 組織にサービスとして公開された ModelBuilder モデルの実行に使用できます。
ステップが実行されると、ジョブ タイルに [起動中] アイコン 
が表示されます。 サービスが起動すると、[実行中] アイコン が表示され、ジオプロセシング サービスが実行されていることを示します。
ステップ パラメーターに ArcGIS Arcade 式が構成されている場合は、ジオプロセシング サービスの実行が開始される前に適切な値に変換されます。
[表示] オプションが有効になっている場合、ジオプロセシング サービスが開始される前にパラメーター値を定義することができます。 パラメーターのデフォルト値が構成されている場合、ステップの実行時に表示され、オーバーライドすることができます。 必要なパラメーターが赤色でハイライト表示されます。
ステップが正常に実行されると、[ステップが完了しました] アイコン 
が表示されます。 ステップが失敗した場合、[ジオプロセシング サービスが失敗しました] アイコン 
が表示されます。
注意:
ArcGIS Arcade 式から取得したパラメーター値がジオプロセシング サービスと互換性がない場合、ステップは失敗します。
ステップの実行時に、次のアクションを実行できます。
- [表示] オプションが有効になっている場合、[続行] をクリックすることで、パラメーター値を入力し、ステップを実行することができます。
- [ステップのキャンセル]
をクリックして、ステップをキャンセルできます。注意:
このステップの実行を開始した後は、キャンセルできない場合もあります。
- ステップは、[ステップの完了]
をクリックすることで完了できます。
ステップの構成
ステップを構成するには、次の手順に従います。
- ワークフロー ダイアグラムを作成または編集し、[ステップ ライブラリ] パネルにアクセスします。
- [ジオプロセシング サービスの実行] を [ステップのライブラリ] パネルからワークフロー キャンバス上のステップの接続矢印にドラッグします。
[ステップの詳細] パネルが表示されます。
- [ステップ名] テキスト ボックスにステップの名前を入力します。
- ジオプロセシング サービスの URL を [ジオプロセシング サービスの URL] テキスト ボックスに入力します。
- 必要に応じて、ジオプロセシング サービスがセキュリティ保護されておらず、リクエストでトークンを指定する必要がない場合は、[セキュリティ保護] チェックボックスをオフにします。
- [引数] セクションの [編集] をクリックします。
[ステップの引数] ダイアログ ボックスが表示されます。
- 必要に応じて、[パラメーター値] テキスト ボックスでパラメーター値を構成します。
パラメーター値として ArcGIS Arcade 式を使用するには、[入力タイプの変更] ドロップダウン矢印をクリックし、関連する [パラメーター値] テキスト ボックスの入力タイプを選択します。 このオプションは文字列値に対しては使用できません。
ヒント:
[この入力は Arcade 式をサポートします]
をクリックし、Arcade 式を選択して関連するテキスト ボックスに追加します。 - 必要に応じて、パラメーターの横にある [表示] チェックボックスをオンにし、ArcGIS Pro でステップが実行される際に値を設定できるようにします。
- 必要に応じて、戻り値を更新します。
- [オプション] タブをクリックします。
- 必要に応じて、[ステップ オプション] を構成します。
- [手動] - 手動でステップを実行します。
- [オプション] - ステップを実行しないで終了できるようにします。
- [自動] - アクティブになり次第、ステップを実行します。
注意:
ワークフロー ダイアグラムがジオプロセシング サービスの実行ステップを含む一連のステップを自動的に実行するように構成されている場合、ユーザー トークンの有効期限が切れた後に実行を試みるステップは、自動的に実行されません。 手動操作なしで、追加の自動ステップを続行するには、ArcGIS Workflow Manager Advanced 組織エクステンションが必要です。
- [スケジュールに沿って実行] - 設定したスケジュールに従ってステップを実行します。
- [手動] - 手動でステップを実行します。
- 必要に応じて、次のオプションのいずれかを選択して、ステップでヘルプを構成します。
- [なし] - ステップ ヘルプなしでステップを構成します。
- [テキスト] - [テキスト] テキストボックスで、ステップのヘルプ テキストを構成します。
ArcGIS Arcade 式を使用して、ステップ ヘルプの動的な値を入力できます。 ステップ ヘルプにプレーン テキストと Arcade 式が含まれている場合は、テキストを次のように書式設定します。
'For further assistance, please contact' + JobCreator($Job) + '.' - [URL] - [URL] テキストボックスで、ステップにヘルプ リソースへのリンクを構成します。
注意:
Web アプリで実行されるステップでは、HTTP、HTTPS URL 形式のみがサポートされます。 ArcGIS Pro で実行されるステップでは、HTTP、HTTPS、ファイル形式がサポートされます。
Arcade 式を使用して動的な値を入力することもできます。 URL にプレーン テキストと Arcade 式が含まれている場合は、テキストを次のように書式設定します。
'https://pro.arcgis.com/en/pro-app/latest/tool-reference/' + JobExtendedProperty($Job, 'tools', 'toolbox') + '/' + jobExtendedProperty($job, 'tools', 'alias') + '.htm'[Arcade の結果を自動的にエンコード] チェックボックスを次のように構成します。
- URL に変換するときにエスケープする必要がある特殊文字 (スペースやフォワード スラッシュなど) を Arcade 式が返す場合、[Arcade の結果を自動的にエンコード] チェックボックスを必ずオンにしてください。
- ベース URL を構成するために Arcade 式が使用される場合、[Arcade の結果を自動的にエンコード] チェックボックスをオフにします。
- 必要に応じて、[スタイル] タブをクリックし、ステップの形状と色を変更します。
- 必要に応じて、[情報] タブをクリックし、[ステップの説明] テキストボックスにステップの説明を入力します。
ヒント:
[情報] タブには、ステップの出力を取得するために動的なジョブ プロパティで使用できるステップ ID も含まれています。 ステップ ID をクリップボードにコピーするには、[ステップ ID をコピー]
をクリックします。
戻り値
ステップが完了すると、その戻り値が格納され、ステップの結果を示します。 パスを使用して戻り値をすぐに評価し、ワークフロー内の次のステップを決定できます。 ArcGIS Arcade 式を使用して、ワークフロー全体を通じて完了したステップの戻り値を取得することもできます。 次の表は、ステップの戻り値を示しています。
| 戻り値 | 説明 |
|---|---|
| S000001 | ステップが正常に完了しました。 |
F000001 | ステップを正常に完了できませんでした。 |
出力値
ステップが完了すると、その出力値が格納され、ワークフローがたどるパスの決定に使用したり、ワークフロー全体で他のステップの入力値として使用したりできます。 次の表は、ステップの出力値を示しています。
| 出力値の名前 | 説明 |
|---|---|
<GeoprocessingServiceOutput> | ジオプロセシング サービスから受信したすべての出力値を返します。 |