別のアプリ、Web マップのポップアップ、電子メールや Web サイトのハイパーリンクから Survey123 Mobile を開くためのリンクを作成できます。 カスタム URL スキーマを使用して Web ブラウザーからアプリを起動するか、Survey123 アプリ リンクを使用して Android または iOS のアプリからフィールド アプリを起動します。 URL パラメーターを使用して、Survey123 Mobile が開く方法をカスタマイズします。たとえば、特定の調査を読み込んだり、デフォルトのマップ位置の座標を設定したり、事前設定された値を使用するか、Web マップのポップアップからデータ属性を渡して質問への回答を設定することができます。
Windows 上の Web ブラウザーからのリンク
Survey123 Mobile を開くためのリンクを作成し、それを別のアプリに埋め込むことができます。 同じリンクをテスト用の Web ブラウザーに入力することもできます。
注意:
リンクを作成したら、arcgis-survey123-mobile:// または https://survey123-mobile.arcgis.app で使用する Survey123 リンクとして iOS を Android に置き換えることができます。
カスタム URL スキームを作成して、デスクトップ Web ブラウザーで使用するには、以下の手順を実行します。
- ブラウザーに「arcgis-survey123-mobile://」と入力します。
Survey123 Mobile が開きます (または開くかどうか確認されます)。
注意:
特定のポータルから調査を起動してダウンロードするには、ポータル URL パラメーターを含めます。たとえば、arcgis-survey123-mobile://?portalUrl=host.domain.com/webadaptor とします (ここで host、domain、webadaptor は実際のポータル情報で置き換えられます)。
- 以下を行って、調査に対する一意の参照を追加し、それを URL に追加します。
- 開く必要がある調査のアイテム ID を識別します。
注意:
これは ArcGIS Online が調査を一意に識別するための文字列で、ArcGIS Online のフォーム アイテムの URL 内にあります。 たとえば、調査の URL が https://exampleurl.maps.arcgis.com/home/item.html?id=36ff9e8c13e042a58cfce4ad87f55d19 の場合、フォームのアイテム ID は 36ff9e8c13e042a58cfce4ad87f55d19 になります。
- 「?itemID=」とフォームのアイテム ID を URL の末尾に追加して調査を URL に含めます。
URL は次のようになります。arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19URL をテストすると、Survey123 Mobile が開き、調査がすぐに開きます。
注意:
調査がデバイス上に存在しない場合は、デバイスにダウンロードされます。
- 開く必要がある調査のアイテム ID を識別します。
- XLSForm でフィールドに割り当てられた名前 (ラベルではない) を使用して URL にそのフィールドへの参照を追加して、質問への事前設定された回答を含めます。
たとえば、Surname フィールドを設定するには「&field:surname=」と入力し、値を入力します。
& はパラメーターの区切り文字として機能し、field: は設定する質問名を指します。
URL は次のようになります。arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauserこの URL を使用して Survey123 Mobile と調査を開き、指定した質問に定義した回答を記入できるようになりました。 1 つの調査 URL に複数の質問を設定できます。 フィールド名では大文字と小文字が区別されます。
- 以下のとおり座標を URL に追加して、調査でのジオポイントの質問の位置を定義します。
- 「¢er=」と入力して、座標を入力します。
- 緯度と経度の座標を 10 進角度で入力します (1 つのカンマで区切ります)。
- 必要に応じて、高度を 10 進メートルで 3 番目の値として追加します (1 つのカンマで区切ります)。
最終的に、URL は次のようになります。
arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser¢er=37.8199,-122.4783,20この URL では、Survey123 Mobile と選択した調査が開き、テキストの質問が設定され、ジオポイントの質問に対する新しいデフォルトの位置が提供されます。
フィールド属性を ArcGIS Web マップのポップアップから Survey123 Mobile に渡すこともできます。このため、Web マップのポップアップを使用する他の Esri アプリと連携できます。 この機能を使用すると、属性の名前を中括弧で囲んで指定することで、Survey123 Mobile のフィールドに設定値ではなく、フィーチャ属性の値を設定できます。
- Web マップを開き、レイヤーのうち 1 つの [ポップアップ] を選択して、[コンテンツの追加] を選択し、[テキスト] を選択して、リンク用に表示するテキストを入力し、[リンク] ボタンをクリックして、[リンク URL] 値を入力します。
iOS または Android の別のアプリからのリンク
ArcGIS アプリで Survey123 Mobile を開いて、調査のデータを取得するために使用するリンクを作成できます。 以下のステップでは、Survey123 アプリ リンクを作成し、Web マップ ポップアップで使用する方法について説明します。 このリンクは、ArcGIS 組織内で Web マップのポップアップに入力されます。 iOS または Android デバイス上の Web ブラウザーで (前述のセクションと同様の手順を使用して) リンクをテストできます。
- デバイスで表示する Web マップを開き、いずれかのレイヤーの [ポップアップ] を選択します。
- [コンテンツの追加] を選択し、[テキスト] を選択します。
- 「Launch Survey123」と入力し、このテキストをハイライト表示して [リンク] ボタンをクリックし、リンク URL タイプ「https://survey123-mobile.arcgis.app」を入力して、[OK] をクリックし、以下を行います。
- モバイル デバイスでブラウザーまたは ArcGIS アプリから Web マップを開きます。
- フィーチャを選択し、ポップアップ内の [Launch Survey123] リンクをクリックして、Survey123 を開きます。
- URL に調査を含めるには「?itemID=」とフォームのアイテム ID を URL の末尾に追加します。 URL は次のようになります。
https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19URL をテストすると、Survey123 Mobile が開き、調査がすぐに開きます。
注意:
調査がデバイス上に存在しない場合は、デバイスにダウンロードされます。
- XLSForm でフィールドに割り当てられた名前 (ラベルではない) を使用して URL にそのフィールドへの参照を追加して、質問への事前設定された回答を含めます。
たとえば、Surname フィールドを設定するには「&field:surname=」と入力し、値を入力します。
& はパラメーターの区切り文字として機能し、field: は設定する質問名を指します。
URL は次のようになります。https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauserこの URL を使用して Survey123 Mobile と調査を開き、指定した質問に定義した回答を記入できるようになりました。 1 つの調査 URL に複数の質問を設定できます。 フィールド名では大文字と小文字が区別されます。
- 以下のとおり座標を URL に追加して、調査でのジオポイントの質問の位置を定義します。
- 「¢er=」と入力して、座標を入力します。
- 緯度と経度の座標を 10 進角度で入力します (1 つのカンマで区切ります)。
- 必要に応じて、高度を 10 進メートルで 3 番目の値として追加します (1 つのカンマで区切ります)。
最終的に、URL は次のようになります。
https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser¢er=37.8199,-122.4783,20この完成した URL では、Survey123 Mobile と選択した調査が開き、テキストの質問が設定され、ジオポイントの質問に対する新しいデフォルトの位置が提供されます。
Survey123 Mobile を起動するための URL パラメーター
次のパラメーターを使用して、Survey123 Mobile の開き方をカスタマイズできます。
| パラメーター | 説明 | タイプ |
|---|---|---|
center | 既知の緯度、経度、高度 (オプション) の値を中心に、マップを配置します。 例: | String |
field:fieldname | 調査の質問にフィールド値を入力します。 例: | String |
portalUrl | 調査アイテムがホストされているポータルの URL。 例: | String |
itemID | 開くフォーム。 例: | UUID |
download | デバイスがオンラインになったときに調査を自動的にダウンロードします。 デフォルトは true です。 例: | Boolean |
callback | フォーム アクション (送信、ドラフトへの移動、キャンセル、終了など) を実行したときに戻る URL。 例: | URL |
callback:status | 例: | String |