フィールドアプリの起動—ArcGIS Survey123

別のアプリ、Web マップのポップアップ、電子メールや Web サイトのハイパーリンクから Survey123 フィールドアプリを開くためのアプリリンクを作成できます。カスタム URL スキーマを使用して Web ブラウザーからアプリを起動するか、Survey123 アプリリンクを使用して Android または iOS のアプリからフィールドアプリを起動します。 URL パラメーターを使用して、フィールドアプリが開く方法をカスタマイズします。たとえば、特定の調査を読み込んだり、デフォルトのマップ位置の座標を設定したり、事前設定された値を使用するか、Web マップのポップアップからデータ属性を渡して質問への回答を設定することができます。

Windows 上の Web ブラウザーからのリンク

フィールドアプリを開くためのリンクを作成し、それを別のアプリに埋め込むことができます。同じリンクをテスト用の Web ブラウザーに入力することもできます。

注意:

リンクを作成したら、iOS または Android で使用する Survey123 リンクとして arcgis-survey123:// を https://survey123.arcgis.app に置き換えることができます。

次の手順は、カスタム URL スキーマを作成する方法と、それをデスクトップ Web ブラウザーで使用する方法について説明しています。

お使いのブラウザーで「arcgis-survey123://」と入力します。
Survey123 フィールドアプリが開きます (または開くかどうか確認されます)。
注意:
特定のポータルから調査を起動してダウンロードするには、ポータル URL パラメーターを含めます。たとえば、arcgis-survey123://?portalUrl=host.domain.com/webadaptor とします (ここで host、domain、webadaptor は実際のポータル情報で置き換えられます)。
調査に対する一意の参照を追加し、それを URL に追加します。
1. 開く必要がある調査のアイテム ID を識別します。
  注意:
  これは ArcGIS Online が調査を一意に識別するための文字列で、ArcGIS Online のフォームアイテムの URL 内にあります。たとえば、調査の URL が https://exampleurl.maps.arcgis.com/home/item.html?id=36ff9e8c13e042a58cfce4ad87f55d19 の場合、フォームのアイテム ID は 36ff9e8c13e042a58cfce4ad87f55d19 になります。
2. 「?itemID=」とフォームのアイテム ID を URL の末尾に追加して調査を URL に含めます。
URL は次のようになります。
```
arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19
```
URL をテストすると、Survey123 フィールドアプリが開き、調査がすぐに開きます。
注意:
調査がデバイス上に存在しない場合は、デバイスにダウンロードされます。
XLSForm でフィールドに割り当てられた名前 (ラベルではない) を使用して URL にそのフィールドへの参照を追加して、質問への事前設定された回答を含めます。たとえば、Surname フィールドを設定するには「&field:surname=」と入力し、値を入力します。
& はパラメーターの区切り文字として機能し、field: は設定する質問名を指します。
URL は次のようになります。
```
arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser
```
この URL を使用して調査を Survey123 フィールドアプリで開くことができるようになり、指定した質問に定義した回答が表示されます。 1 つの調査 URL に複数の質問を設定できます。フィールド名では大文字と小文字が区別されます。
座標を URL に追加して、調査でのジオポイントの質問の位置を定義します。
- 「&center=」と入力して、座標を入力します。
- 緯度と経度の座標を 10 進角度で入力します (1 つのカンマで区切ります)。
- 必要に応じて、高度を 10 進メートルで 3 番目の値として追加します (1 つのカンマで区切ります)。
最終的に、URL は次のようになります。
```
arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser&center=37.8199,-122.4783,20
```
この URL では、Survey123 フィールドアプリと選択した調査が開き、テキストの質問が設定され、ジオポイントの質問に対する新しいデフォルトの位置が提供されます。
フィールド属性を ArcGIS Web マップのポップアップから Survey123 に渡すこともできます。このため、Web マップのポップアップを使用する他の Esri アプリと連携できます。この機能を使用すると、属性の名前を中括弧で囲んで指定することで、Survey123 のフィールドに設定値ではなく、フィーチャ属性の値を設定できます。
Web マップを開き、いずれかのレイヤーの [ポップアップ] を選択します。 [コンテンツの追加] を選択し、[テキスト] を選択します。リンクに対して表示するテキストを指定し、[リンク] ボタンをクリックして [リンク URL] 値を入力します。
この URL では、surname フィールドに設定値ではなく、選択したフィーチャの name 属性の内容を設定しています。
```
arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname={name}
```
この URL では、hydrantGlobalID フィールドに、選択した給水栓の Global ID を設定しています。
```
arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:hydrantGlobalID={globalid}
```
注意:
デフォルトでは、対応する選択肢の名前とラベルが同じ場合にのみ、Web マップのポップアップから単一選択の質問と複数選択の質問に値を渡すことができます。選択肢リストの名前とラベルが異なる場合は、ポップアップの DomainCode 式で UrlEncode 関数または ArcGIS Arcade 関数を使用して、目的の値を渡すことができます。
繰り返し内の質問は設定できません。

iOS または Android の別のアプリからのリンク

ArcGIS アプリで Survey123 を開いて、調査のデータを取得するために使用するリンクを作成できます。以下のステップでは、Survey123 アプリリンクを作成し、Web マップポップアップで使用する方法について説明します。このリンクは、ArcGIS 組織内で Web マップのポップアップに入力されます。 iOS または Android デバイス上の Web ブラウザーで (前述のセクションと同様の手順を使用して) リンクをテストできます。

デバイスで表示する Web マップを開き、いずれかのレイヤーの [ポップアップ] を選択します。
[コンテンツの追加] を選択し、[テキスト] を選択します。
「Launch Survey123」と入力し、このテキストをハイライト表示して、[リンク] ボタンをクリックしてリンク URL を入力します。「https://survey123.arcgis.app」と入力し、[OK] をクリックします。
1. モバイルデバイスでブラウザーまたは ArcGIS アプリから Web マップを開きます。
2. フィーチャを選択し、ポップアップ内の [Launch Survey123] リンクをクリックして、Survey123 を開きます。
URL に調査を含めるには「?itemID=」とフォームのアイテム ID を URL の末尾に追加します。
URL は次のようになります。
```
https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19
```
URL をテストすると、Survey123 フィールドアプリが開き、調査がすぐに開きます。
注意:
調査がデバイス上に存在しない場合は、デバイスにダウンロードされます。
XLSForm でフィールドに割り当てられた名前 (ラベルではない) を使用して URL にそのフィールドへの参照を追加して、質問への事前設定された回答を含めます。たとえば、Surname フィールドを設定するには「&field:surname=」と入力し、値を入力します。
& はパラメーターの区切り文字として機能し、field: は設定する質問名を指します。
URL は次のようになります。
```
https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser
```
この URL を使用して調査を Survey123 フィールドアプリで開くことができるようになり、指定した質問に定義した回答が表示されます。 1 つの調査 URL に複数の質問を設定できます。フィールド名では大文字と小文字が区別されます。
座標を URL に追加して、調査でのジオポイントの質問の位置を定義します。
- 「&center=」と入力して、座標を入力します。
- 緯度と経度の座標を 10 進角度で入力します (1 つのカンマで区切ります)。
- 必要に応じて、高度を 10 進メートルで 3 番目の値として追加します (1 つのカンマで区切ります)。
最終的に、URL は次のようになります。
```
https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser&center=37.8199,-122.4783,20
```
この完成した URL では、Survey123 フィールドアプリと選択した調査が開き、テキストの質問が設定され、ジオポイントの質問に対する新しいデフォルトの位置が提供されます。

フィールドアプリを起動するための URL パラメーター

次のパラメーターを使用して、フィールドアプリの開き方をカスタマイズできます。


パラメーター	説明	タイプ
center	マップを既知の緯度、経度、高度 (オプション) を中心に配置します。例: `center=37.8199,-122.4783,20`	String
field:fieldname	調査の質問にフィールド値を入力します。例: `field:surname=Klauser`	String
portalUrl	調査アイテムがホストされているポータルの URL。例: `portalUrl=https://myorg.arcgis.com`	String
itemID	開くフォーム。例: `itemID=36ff9e8c13e042a58cfce4ad87f55d19`	UUID
download	デバイスがオンラインになったときに調査を自動的にダウンロードします。デフォルトは true です。例: `download=false`	Boolean
action	調査を開く方法を指定します。サポートされている値は、collect (デフォルト)、edit、view、copy です。例: `action=edit`	String
folder	filter パラメーターを使用する際に、検索するフォルダーを指定します。サポートされている値は、inbox、drafts、outbox、sent、* (すべてのフォルダー) です。例: `folder=drafts`	String
callback	フォームアクション (送信、ドラフトへの移動、キャンセル、終了など) を実行したときに戻る URL。例: `callback=https://quickcapture.arcgis.app`	URL
callback:status	コールバックがアクティブな場合の調査のステータスを指定します。ステータスでサポートされている値は、cancel、draft、submit、close です。 close ステータスは、action=view のときのみ使用できます。例: `callback:draft=https://quickcapture.arcgis.app`	String
filter	デバイス上の既存の調査で、特定の文字列を検索します。特定のフィールドの名前を指定すると、そのフィールドでのみ目的の文字列を検索します。例: `filter=Klauser`	String
update	[受信トレイ] のコンテンツを更新し、[送信箱] に調査を送信しようとします。デフォルトは false です。例: `update=false`	Boolean
q:queryparameter	フィーチャレイヤーで既存のレコードを検索します。デバイス上に存在しないコンテンツの取得に使用できます。例: `q:where=ws_stationnumber=5171 q:where=waterbodytype='Lake' q:globalId=1d392670-33e2-456d-8435-7fad3abd8bb9`	String

このトピックへのフィードバック

Windows 上の Web ブラウザーからのリンク

注意:

注意:

注意:

注意:

注意:

iOS または Android の別のアプリからのリンク

注意:

フィールド アプリを起動するための URL パラメーター

このトピックの内容

フィールドアプリを起動するための URL パラメーター