Survey123 ステップでは、ArcGIS Workflow Manager で ArcGIS Survey123 調査を収集、確認、編集できます。
Survey123 ステップでは、調査フォームから拡張プロパティ テーブルを作成し、調査データをジョブに関連付ける必要があります。 調査が送信されると、関連付けられた拡張プロパティ テーブルに、調査で収集されたデータが設定されます。 調査フォームから拡張プロパティ テーブルが作成されていない場合、調査は収集できますが、ジョブから収集されたデータにアクセスすることはできません。
ヒント:
ワークフロー以外で収集された調査のデータを表示または編集するには、調査フォームから拡張プロパティ テーブルを作成します。 ワークフロー ダイアグラムの Survey123 ステップの前にジョブ プロパティの更新ステップを追加し、拡張プロパティ テーブルの [リンク ID] を既存の調査の globalid で更新します。
Workflow Manager Web アプリでステップが実行されると、ステップで構成された調査がジョブ タイルに表示されます。 ステップが ArcGIS Pro で実行されると、[Web で開く] ボタンがジョブ タイル上に表示され、ステップで構成された調査が Workflow Manager Web アプリで開きます。ステップにステップ ヘルプが構成されている場合は、ジョブ タイルの下部に表示されます。
注意:
ステップを実行するユーザーが、ステップで構成された調査フォームを確認、編集、送信するには、Survey123 で十分な権限を持っている必要があります。
注意:
ステップで構成された調査が ArcGIS Workflow Manager Server と同じ ArcGIS Enterprise ポータルでホストされていない場合、異なる Web ブラウザーを使用して Workflow Manager Web アプリと Survey123 にサイン インすることをお勧めします。 ステップの実行時に同じ Web ブラウザーで複数のポータルにサイン インしている場合は、Workflow Manager の認証情報ではなく、Survey123 の認証情報が調査へのアクセスに使用されます。
ステップの実行時に、次のアクションを実行できます。
- 構成された調査は、送信、表示、編集することができます。
- [キャンセル] をクリックして、ステップをキャンセルできます。
- [続行] をクリックして、ステップを完了できます。
ステップの構成
ステップを構成するには、次の手順に従います。
- ワークフロー ダイアグラムを作成または編集し、[ステップ ライブラリ] パネルにアクセスします。
- [Survey123] を [ステップのライブラリ] パネルからワークフロー キャンバス上のステップの接続矢印にドラッグします。
[ステップの詳細] パネルが表示されます。
- [ステップ名] テキスト ボックスにステップの名前を入力します。
- [Survey123 フォーム] セクションで、[Survey123 フォームの追加] をクリックします。
[Survey123 フォームの追加] ダイアログ ボックスが表示されます。
- 次のオプションのいずれかを選択して、Survey123 フォームの配置先を指定します。
- [この Enterprise] - Workflow Manager と同じポータルで使用できる調査を追加します。
- [ArcGIS Online] - ArcGIS Online にあるパブリックの調査を追加します。
- [その他] - 別のポータルにあるパブリックの調査を追加します。
- [その他] を選択した場合は、[ポータル URL] テキスト ボックスに調査を含むポータルの URL を入力し、Enter キーを押します。
ArcGIS Enterprise の場合、形式 https://webadaptorhost.domain.com/webadaptorname を使用します。
- 調査のフォーム ID を [フォーム ID] テキスト ボックスに入力します。
- [参照名] テキスト ボックスに調査の名前を入力します。
- [OK] をクリックします。
調査が [ステップの詳細] パネルに表示されます。
注意:
調査を削除するには、[調査の削除] ボタン
をクリックします。 - [リレーションシップ] 切り替えボタンをクリックすると、Workflow Manager ジョブとの 1 対 1 ([1-1]) または 1 対多 ([1-M]) の調査リレーションシップを切り替えることができます。
- [1-1] - リレーションシップを 1 対 1 に設定し、1 つのジョブに 1 つの調査のみを関連付けることができるようにします。
- [1-M] - リレーションシップを 1 対多に設定し、1 つのジョブに複数の調査を関連付けることができるようにします。
- [モード] 設定に、次のオプションのいずれかを選択します。
- [新規作成] - 調査を作成および収集します。
注意:
このオプションは、1 対多 ([1-M]) のリレーションシップが含む調査にのみ使用できます。
- [編集] - 調査を編集します。
注意:
ジョブに調査が存在しない場合、調査が作成および収集されます。 調査が 1 対多 ([1-M]) のリレーションシップで構成されている場合、最後に収集された調査が編集されます。
- [表示] - 調査を表示します。
注意:
調査が 1 対多 ([1-M]) のリレーションシップで構成されている場合、最後に収集された調査が開いて表示されます。
- [新規作成] - 調査を作成および収集します。
- [オプション] タブをクリックします。
- 必要に応じて、[ステップ オプション] を構成します。
- [手動] - 手動でステップを実行します。
- [オプション] - ステップを実行しないで終了できるようにします。
- [自動] - アクティブになり次第、ステップを実行します。
注意:
ワークフロー ダイアグラムがデータ品質の評価ステップまたはジオプロセシング サービスの実行ステップを含む一連のステップを自動的に実行するように構成されている場合、一連のステップを開始したユーザー トークンの有効期限が切れた後に実行を試みるステップは、自動的に実行されません。 手動操作なしで、さらなる自動ステップの実行を継続するには、ArcGIS Workflow Manager Server Advanced ロールのライセンスが必要です。
- [スケジュールに沿って実行] - 設定したスケジュールに従ってステップを実行します。
- [手動] - 手動でステップを実行します。
- 必要に応じて、次のオプションのいずれかを選択して、ステップでヘルプを構成します。
- [なし] - ステップ ヘルプなしでステップを構成します。
- [テキスト] - [テキスト] テキストボックスで、ステップのヘルプ テキストを構成します。
ArcGIS Arcade 式を使用して、ステップ ヘルプの動的な値を入力できます。 ステップ ヘルプにプレーン テキストと Arcade 式が含まれている場合は、テキストを次のように書式設定する必要があります。
'For further assistance, please contact' + JobCreator($Job) + '.'ヒント:
[この入力は Arcade 式をサポートします]
をクリックし、ArcGIS Arcade 式を選択して関連するテキスト ボックスに追加します。 - [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 | ステップを正常に完了できませんでした。 |
出力値
ステップが完了すると、その出力値が格納され、ワークフローがたどるパスの決定に使用したり、ワークフロー全体で他のステップの入力値として使用したりできます。 次の表は、ステップの出力値を示しています。
| 出力 | 説明 |
|---|---|
<GlobalID> | 最後に作成、表示、編集された調査の globalid を返します。 |